VTK  9.0.1
vtkDataRepresentation.h
Go to the documentation of this file.
1 /*=========================================================================
2 
3  Program: Visualization Toolkit
4  Module: vtkDataRepresentation.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 =========================================================================*/
15 /*-------------------------------------------------------------------------
16  Copyright 2008 Sandia Corporation.
17  Under the terms of Contract DE-AC04-94AL85000 with Sandia Corporation,
18  the U.S. Government retains certain rights in this software.
19 -------------------------------------------------------------------------*/
50 #ifndef vtkDataRepresentation_h
51 #define vtkDataRepresentation_h
52 
54 #include "vtkViewsCoreModule.h" // For export macro
55 
56 class vtkAlgorithmOutput;
58 class vtkAnnotationLink;
59 class vtkDataObject;
60 class vtkSelection;
61 class vtkStringArray;
62 class vtkTrivialProducer;
63 class vtkView;
64 class vtkViewTheme;
65 
66 class VTKVIEWSCORE_EXPORT vtkDataRepresentation : public vtkPassInputTypeAlgorithm
67 {
68 public:
69  static vtkDataRepresentation* New();
71  void PrintSelf(ostream& os, vtkIndent indent) override;
72 
78  {
80  }
81 
87  vtkAnnotationLink* GetAnnotationLink() { return this->AnnotationLinkInternal; }
88  void SetAnnotationLink(vtkAnnotationLink* link);
89 
94  virtual void ApplyViewTheme(vtkViewTheme* vtkNotUsed(theme)) {}
95 
106  void Select(vtkView* view, vtkSelection* selection) { this->Select(view, selection, false); }
107  void Select(vtkView* view, vtkSelection* selection, bool extend);
108 
120  void Annotate(vtkView* view, vtkAnnotationLayers* annotations)
121  {
122  this->Annotate(view, annotations, false);
123  }
124  void Annotate(vtkView* view, vtkAnnotationLayers* annotations, bool extend);
125 
127 
131  vtkSetMacro(Selectable, bool);
132  vtkGetMacro(Selectable, bool);
133  vtkBooleanMacro(Selectable, bool);
135 
143  void UpdateSelection(vtkSelection* selection) { this->UpdateSelection(selection, false); }
144  void UpdateSelection(vtkSelection* selection, bool extend);
145 
154  {
155  this->UpdateAnnotations(annotations, false);
156  }
157  void UpdateAnnotations(vtkAnnotationLayers* annotations, bool extend);
158 
165  {
166  return this->GetInternalAnnotationOutputPort(0);
167  }
169  {
170  return this->GetInternalAnnotationOutputPort(port, 0);
171  }
172  virtual vtkAlgorithmOutput* GetInternalAnnotationOutputPort(int port, int conn);
173 
180  {
181  return this->GetInternalSelectionOutputPort(0);
182  }
184  {
185  return this->GetInternalSelectionOutputPort(port, 0);
186  }
187  virtual vtkAlgorithmOutput* GetInternalSelectionOutputPort(int port, int conn);
188 
196  {
197  return this->GetInternalOutputPort(port, 0);
198  }
199  virtual vtkAlgorithmOutput* GetInternalOutputPort(int port, int conn);
200 
202 
210  vtkSetMacro(SelectionType, int);
211  vtkGetMacro(SelectionType, int);
213 
215 
218  virtual void SetSelectionArrayNames(vtkStringArray* names);
219  vtkGetObjectMacro(SelectionArrayNames, vtkStringArray);
221 
223 
226  virtual void SetSelectionArrayName(const char* name);
227  virtual const char* GetSelectionArrayName();
229 
238  virtual vtkSelection* ConvertSelection(vtkView* view, vtkSelection* selection);
239 
240 protected:
242  ~vtkDataRepresentation() override;
243 
255  {
256  return 1;
257  }
258 
262  virtual void ProcessEvents(vtkObject* caller, unsigned long eventId, void* callData);
263 
265 
268  virtual void SetAnnotationLinkInternal(vtkAnnotationLink* link);
271 
272  // Whether its representation can handle a selection.
274 
279 
284 
285  friend class vtkView;
286  friend class vtkRenderView;
287  class Command;
288  friend class Command;
289  Command* Observer;
290 
291  // ------------------------------------------------------------------------
292  // Methods to override in subclasses
293  // ------------------------------------------------------------------------
294 
300  virtual bool AddToView(vtkView* vtkNotUsed(view)) { return true; }
301 
307  virtual bool RemoveFromView(vtkView* vtkNotUsed(view)) { return true; }
308 
314  virtual vtkAnnotationLayers* ConvertAnnotations(vtkView* view, vtkAnnotationLayers* annotations);
315 
316  vtkTrivialProducer* GetInternalInput(int port, int conn);
317  void SetInternalInput(int port, int conn, vtkTrivialProducer* producer);
318 
319 private:
321  void operator=(const vtkDataRepresentation&) = delete;
322 
323  class Internals;
324  Internals* Implementation;
325 };
326 
327 #endif
virtual vtkAlgorithmOutput * GetInternalOutputPort()
Retrieves an output port for the input data object at the specified port and connection index...
int SelectionType
The selection type created by the view.
virtual void ApplyViewTheme(vtkViewTheme *vtkNotUsed(theme))
Apply a theme to this representation.
abstract base class for most VTK objects
Definition: vtkObject.h:53
Superclass for algorithms that produce output of the same type as input.
Store vtkAlgorithm input/output information.
virtual vtkAlgorithmOutput * GetInternalAnnotationOutputPort(int port)
virtual vtkAlgorithmOutput * GetInternalOutputPort(int port)
virtual vtkAlgorithmOutput * GetInternalAnnotationOutputPort()
The output port that contains the annotations whose selections are localized for a particular input d...
void Select(vtkView *view, vtkSelection *selection)
The view calls this method when a selection occurs.
virtual vtkAlgorithmOutput * GetInternalSelectionOutputPort(int port)
int RequestData(vtkInformation *, vtkInformationVector **, vtkInformationVector *) override
Subclasses should override this to connect inputs to the internal pipeline as necessary.
a vtkAbstractArray subclass for strings
data object that represents a "selection" in VTK.
Definition: vtkSelection.h:57
virtual bool AddToView(vtkView *vtkNotUsed(view))
Adds the representation to the view.
Proxy object to connect input/output ports.
Sets theme colors for a graphical view.
Definition: vtkViewTheme.h:42
Producer for stand-alone data objects.
The superclass for all views.
Definition: vtkView.h:54
vtkAlgorithmOutput * GetInputConnection(int port=0, int index=0)
Convenience override method for obtaining the input connection without specifying the port or index...
vtkStringArray * SelectionArrayNames
If a VALUES selection, the array names used in the selection.
a simple class to control print indentation
Definition: vtkIndent.h:33
virtual bool RemoveFromView(vtkView *vtkNotUsed(view))
Removes the representation to the view.
The superclass for all representations.
vtkAnnotationLink * GetAnnotationLink()
The annotation link for this representation.
void Annotate(vtkView *view, vtkAnnotationLayers *annotations)
Analogous to Select().
void PrintSelf(ostream &os, vtkIndent indent) override
Methods invoked by print to print information about the object including superclasses.
A view containing a renderer.
Definition: vtkRenderView.h:58
Stores a ordered collection of annotation sets.
virtual vtkAlgorithmOutput * GetInternalSelectionOutputPort()
The output port that contains the selection associated with the current annotation (normally the inte...
vtkAnnotationLink * AnnotationLinkInternal
The annotation link for this representation.
Store zero or more vtkInformation instances.
void UpdateAnnotations(vtkAnnotationLayers *annotations)
Updates the selection in the selection link and fires a selection change event.
vtkAlgorithmOutput * GetInputConnection(int port, int index)
Get the algorithm output port connected to an input port.
general representation of visualization data
Definition: vtkDataObject.h:59
void UpdateSelection(vtkSelection *selection)
Updates the selection in the selection link and fires a selection change event.
static vtkPassInputTypeAlgorithm * New()