VTK
vtkCaptionActor2D.h
Go to the documentation of this file.
1 /*=========================================================================
2 
3  Program: Visualization Toolkit
4  Module: vtkCaptionActor2D.h
5 
6  Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
7  All rights reserved.
8  See Copyright.txt or http://www.kitware.com/Copyright.htm for details.
9 
10  This software is distributed WITHOUT ANY WARRANTY; without even
11  the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
12  PURPOSE. See the above copyright notice for more information.
13 
14 =========================================================================*/
58 #ifndef vtkCaptionActor2D_h
59 #define vtkCaptionActor2D_h
60 
61 #include "vtkRenderingAnnotationModule.h" // For export macro
62 #include "vtkActor2D.h"
63 
64 class vtkActor;
65 class vtkAlgorithmOutput;
66 class vtkAppendPolyData;
67 class vtkCaptionActor2DConnection;
68 class vtkGlyph2D;
69 class vtkGlyph3D;
70 class vtkPolyData;
72 class vtkPolyDataMapper;
73 class vtkTextActor;
74 class vtkTextMapper;
75 class vtkTextProperty;
76 
77 class VTKRENDERINGANNOTATION_EXPORT vtkCaptionActor2D : public vtkActor2D
78 {
79 public:
81  void PrintSelf(ostream& os, vtkIndent indent) override;
82 
83  static vtkCaptionActor2D *New();
84 
86 
90  virtual void SetCaption(const char* caption);
91  virtual char* GetCaption();
93 
95 
100  vtkWorldCoordinateMacro(AttachmentPoint);
102 
104 
107  vtkSetMacro(Border,vtkTypeBool);
108  vtkGetMacro(Border,vtkTypeBool);
109  vtkBooleanMacro(Border,vtkTypeBool);
111 
113 
117  vtkSetMacro(Leader,vtkTypeBool);
118  vtkGetMacro(Leader,vtkTypeBool);
119  vtkBooleanMacro(Leader,vtkTypeBool);
121 
123 
126  vtkSetMacro(ThreeDimensionalLeader,vtkTypeBool);
127  vtkGetMacro(ThreeDimensionalLeader,vtkTypeBool);
128  vtkBooleanMacro(ThreeDimensionalLeader,vtkTypeBool);
130 
132 
140  virtual void SetLeaderGlyphData(vtkPolyData*);
141  virtual void SetLeaderGlyphConnection(vtkAlgorithmOutput*);
142  virtual vtkPolyData* GetLeaderGlyph();
144 
146 
153  vtkSetClampMacro(LeaderGlyphSize,double,0.0,0.1);
154  vtkGetMacro(LeaderGlyphSize,double);
156 
158 
163  vtkSetClampMacro(MaximumLeaderGlyphSize,int,1,1000);
164  vtkGetMacro(MaximumLeaderGlyphSize,int);
166 
168 
172  vtkSetClampMacro(Padding, int, 0, 50);
173  vtkGetMacro(Padding, int);
175 
177 
181  vtkGetObjectMacro(TextActor,vtkTextActor);
183 
185 
188  virtual void SetCaptionTextProperty(vtkTextProperty *p);
189  vtkGetObjectMacro(CaptionTextProperty,vtkTextProperty);
191 
196  void ShallowCopy(vtkProp *prop) override;
197 
199 
203  vtkSetMacro(AttachEdgeOnly,vtkTypeBool);
204  vtkGetMacro(AttachEdgeOnly,vtkTypeBool);
205  vtkBooleanMacro(AttachEdgeOnly,vtkTypeBool);
207 
215  void ReleaseGraphicsResources(vtkWindow *) override;
216 
218 
223  int RenderOpaqueGeometry(vtkViewport* viewport) override;
225  int RenderOverlay(vtkViewport* viewport) override;
227 
232 
233 protected:
235  ~vtkCaptionActor2D() override;
236 
238 
244 
245  int Padding;
247 
248 
249 private:
250  vtkTextActor *TextActor;
251  vtkTextProperty *CaptionTextProperty;
252 
253  vtkPolyData *BorderPolyData;
254  vtkPolyDataMapper2D *BorderMapper;
255  vtkActor2D *BorderActor;
256 
257  vtkPolyData *HeadPolyData; // single attachment point for glyphing
258  vtkGlyph3D *HeadGlyph; // for 3D leader
259  vtkPolyData *LeaderPolyData; // line represents the leader
260  vtkAppendPolyData *AppendLeader; // append head and leader
261 
262  // for 2D leader
263  vtkCoordinate *MapperCoordinate2D;
264  vtkPolyDataMapper2D *LeaderMapper2D;
265  vtkActor2D *LeaderActor2D;
266 
267  // for 3D leader
268  vtkPolyDataMapper *LeaderMapper3D;
269  vtkActor *LeaderActor3D;
270 
271  vtkCaptionActor2DConnection* LeaderGlyphConnectionHolder;
272 
273 private:
274  vtkCaptionActor2D(const vtkCaptionActor2D&) = delete;
275  void operator=(const vtkCaptionActor2D&) = delete;
276 };
277 
278 
279 #endif
280 
281 
282 
vtkPolyDataMapper
map vtkPolyData to graphics primitives
Definition: vtkPolyDataMapper.h:42
vtkActor2D::RenderOpaqueGeometry
int RenderOpaqueGeometry(vtkViewport *viewport) override
WARNING: INTERNAL METHOD - NOT INTENDED FOR GENERAL USE DO NOT USE THESE METHODS OUTSIDE OF THE RENDE...
vtkPolyDataMapper2D
draw vtkPolyData onto the image plane
Definition: vtkPolyDataMapper2D.h:51
vtkCaptionActor2D::LeaderGlyphSize
double LeaderGlyphSize
Definition: vtkCaptionActor2D.h:242
vtkActor2D::ShallowCopy
void ShallowCopy(vtkProp *prop) override
Shallow copy of this vtkActor2D.
vtkCaptionActor2D::Padding
int Padding
Definition: vtkCaptionActor2D.h:245
vtkActor2D::PrintSelf
void PrintSelf(ostream &os, vtkIndent indent) override
Methods invoked by print to print information about the object including superclasses.
vtkGlyph2D
copy oriented and scaled glyph geometry to every input point (2D specialization)
Definition: vtkGlyph2D.h:39
vtkWindow
window superclass for vtkRenderWindow
Definition: vtkWindow.h:37
vtkAppendPolyData
appends one or more polygonal datasets together
Definition: vtkAppendPolyData.h:48
vtkCaptionActor2D::Leader
vtkTypeBool Leader
Definition: vtkCaptionActor2D.h:240
vtkActor2D::ReleaseGraphicsResources
void ReleaseGraphicsResources(vtkWindow *) override
Release any graphics resources that are being consumed by this actor.
vtkTextMapper
2D text annotation
Definition: vtkTextMapper.h:53
vtkCaptionActor2D::MaximumLeaderGlyphSize
int MaximumLeaderGlyphSize
Definition: vtkCaptionActor2D.h:243
vtkActor2D::RenderOverlay
int RenderOverlay(vtkViewport *viewport) override
Support the standard render methods.
vtkActor
represents an object (geometry & properties) in a rendered scene
Definition: vtkActor.h:51
vtkTextActor
An actor that displays text. Scaled or unscaled.
Definition: vtkTextActor.h:56
vtkIndent
a simple class to control print indentation
Definition: vtkIndent.h:39
vtkCoordinate
perform coordinate transformation, and represent position, in a variety of vtk coordinate systems
Definition: vtkCoordinate.h:81
vtkCaptionActor2D::AttachmentPointCoordinate
vtkCoordinate * AttachmentPointCoordinate
Definition: vtkCaptionActor2D.h:237
vtkViewport
abstract specification for Viewports
Definition: vtkViewport.h:47
vtkCaptionActor2D::ThreeDimensionalLeader
vtkTypeBool ThreeDimensionalLeader
Definition: vtkCaptionActor2D.h:241
vtkGlyph3D
copy oriented and scaled glyph geometry to every input point
Definition: vtkGlyph3D.h:111
vtkTextProperty
represent text properties.
Definition: vtkTextProperty.h:39
vtkProp
abstract superclass for all actors, volumes and annotations
Definition: vtkProp.h:52
vtkCaptionActor2D
draw text label associated with a point
Definition: vtkCaptionActor2D.h:77
vtkActor2D
a actor that draws 2D data
Definition: vtkActor2D.h:45
vtkActor2D.h
vtkActor2D::New
static vtkActor2D * New()
Creates an actor2D with the following defaults: position (0,0) (coordinate system is viewport); at la...
vtkCaptionActor2D::Border
vtkTypeBool Border
Definition: vtkCaptionActor2D.h:239
vtkAlgorithmOutput
Proxy object to connect input/output ports.
Definition: vtkAlgorithmOutput.h:39
vtkPolyData
concrete dataset represents vertices, lines, polygons, and triangle strips
Definition: vtkPolyData.h:85
vtkCaptionActor2D::RenderTranslucentPolygonalGeometry
int RenderTranslucentPolygonalGeometry(vtkViewport *) override
Definition: vtkCaptionActor2D.h:224
vtkActor2D::HasTranslucentPolygonalGeometry
vtkTypeBool HasTranslucentPolygonalGeometry() override
Does this prop have some translucent polygonal geometry?
vtkCaptionActor2D::AttachEdgeOnly
vtkTypeBool AttachEdgeOnly
Definition: vtkCaptionActor2D.h:246
vtkTypeBool
int vtkTypeBool
Definition: vtkABI.h:69