Abstract class for control points items. More...

#include <vtkControlPointsItem.h>

Inheritance diagram for vtkControlPointsItem:

Collaboration diagram for vtkControlPointsItem:

Public Types
enum	{ CurrentPointChangedEvent = vtkCommand::UserEvent , CurrentPointEditEvent }

typedef vtkPlot	Superclass

Public Types inherited from vtkPlot
typedef vtkContextItem	Superclass

Public Types inherited from vtkContextItem
typedef vtkAbstractContextItem	Superclass

Public Types inherited from vtkAbstractContextItem
typedef vtkObject	Superclass

Public Member Functions
virtual vtkTypeBool	IsA (const char *type)
	Return 1 if this class is the same type of (or a subclass of) the named class.

vtkControlPointsItem *	NewInstance () const

void	PrintSelf (ostream &os, vtkIndent indent) override
	Methods invoked by print to print information about the object including superclasses.

void	GetBounds (double bounds[4]) override
	Bounds of the item, typically the bound of all the control points except if custom bounds have been set.

bool	Paint (vtkContext2D *painter) override
	Paint the points with a fixed size (cosmetic) which doesn't depend on the scene zoom factor.

void	SelectPoint (vtkIdType pointId)
	Select a point by its ID.

void	SelectPoint (double *currentPoint)
	Utility function that selects a point providing its coordinates.

void	SelectAllPoints ()
	Select all the points.

void	DeselectPoint (vtkIdType pointId)
	Unselect a point by its ID.

void	DeselectPoint (double *currentPoint)
	Utility function that unselects a point providing its coordinates.

void	DeselectAllPoints ()
	Unselect all the previously selected points.

void	ToggleSelectPoint (vtkIdType pointId)
	Toggle the selection of a point by its ID.

void	ToggleSelectPoint (double *currentPoint)
	Utility function that toggles the selection a point providing its coordinates.

bool	SelectPoints (const vtkVector2f &min, const vtkVector2f &max) override
	Select all points in the specified rectangle.

vtkIdType	GetNumberOfSelectedPoints () const
	Return the number of selected points.

vtkIdType	FindPoint (double *pos)
	Returns the vtkIdType of the point given its coordinates and a tolerance based on the screen point size.

bool	IsOverPoint (double *pos, vtkIdType pointId)
	Returns true if pos is above the pointId point, false otherwise.

vtkIdType	GetControlPointId (double *pos)
	Returns the id of the control point exactly matching pos, -1 if not found.

void	GetControlPointsIds (vtkIdTypeArray *ids, bool excludeFirstAndLast=false) const
	Utility function that returns an array of all the control points IDs Typically: [0, 1, 2, ... n -1] where n is the point count Can exclude the first and last point ids from the array.

virtual vtkIdType	AddPoint (double *newPos)=0
	Add a point to the function.

virtual vtkIdType	RemovePoint (double *pos)=0
	Remove a point of the function.

vtkIdType	RemovePoint (vtkIdType pointId)
	Remove a point give its id.

void	RemoveCurrentPoint ()
	Remove the current point.

virtual vtkIdType	GetNumberOfPoints () const =0
	Returns the total number of points.

virtual void	GetControlPoint (vtkIdType index, double *point) const =0
	Returns the x and y coordinates as well as the midpoint and sharpness of the control point corresponding to the index.

virtual void	SetControlPoint (vtkIdType index, double *point)=0
	Sets the x and y coordinates as well as the midpoint and sharpness of the control point corresponding to the index.

void	MovePoints (const vtkVector2f &translation, vtkIdTypeArray *pointIds)
	Move the points referred by pointIds by a given translation.

void	MovePoints (const vtkVector2f &translation, bool dontMoveFirstAndLast=false)
	Utility function to move all the control points of the given translation If dontMoveFirstAndLast is true, then the first and last points won't be moved.

void	SpreadPoints (float factor, vtkIdTypeArray *pointIds)
	Spread the points referred by pointIds If factor > 0, points are moved away from each other.

void	SpreadPoints (float factor, bool dontSpreadFirstAndLast=false)
	Utility function to spread all the control points of a given factor If dontSpreadFirstAndLast is true, then the first and last points won't be spread.

vtkIdType	GetCurrentPoint () const
	Returns the current point ID selected or -1 if there is no point current.

void	SetCurrentPoint (vtkIdType index)
	Sets the current point selected.

vtkPlot *	GetAddPointItem ()
	Item dedicated to add point, to be added below all other items.

void	ResetBounds ()
	Recompute the bounds next time they are requested.


virtual void	SetUserBounds (double, double, double, double)
	Set custom bounds, except if bounds are invalid, bounds will be automatically computed based on the range of the control points Invalid bounds by default.

virtual void	SetUserBounds (double[4])
	Set custom bounds, except if bounds are invalid, bounds will be automatically computed based on the range of the control points Invalid bounds by default.

virtual double *	GetUserBounds ()
	Set custom bounds, except if bounds are invalid, bounds will be automatically computed based on the range of the control points Invalid bounds by default.

virtual void	GetUserBounds (double &, double &, double &, double &)
	Set custom bounds, except if bounds are invalid, bounds will be automatically computed based on the range of the control points Invalid bounds by default.

virtual void	GetUserBounds (double[4])
	Set custom bounds, except if bounds are invalid, bounds will be automatically computed based on the range of the control points Invalid bounds by default.


virtual void	SetValidBounds (double, double, double, double)
	Controls the valid range for the values.

virtual void	SetValidBounds (double[4])
	Controls the valid range for the values.

virtual double *	GetValidBounds ()
	Controls the valid range for the values.

virtual void	GetValidBounds (double &, double &, double &, double &)
	Controls the valid range for the values.

virtual void	GetValidBounds (double[4])
	Controls the valid range for the values.


virtual float	GetScreenPointRadius ()
	Get/set the radius for screen points.

virtual void	SetScreenPointRadius (float)
	Get/set the radius for screen points.


virtual bool	GetDrawPoints ()
	Get/Set the flag to draw points.

virtual void	SetDrawPoints (bool)
	Get/Set the flag to draw points.

virtual void	DrawPointsOn ()
	Get/Set the flag to draw points.

virtual void	DrawPointsOff ()
	Get/Set the flag to draw points.


virtual void	SetStrokeMode (bool)
	Controls whether or not control points are drawn (true) or clicked and moved (false).

virtual bool	GetStrokeMode ()
	Controls whether or not control points are drawn (true) or clicked and moved (false).


virtual void	SetSwitchPointsMode (bool)
	If DrawPoints is false, SwitchPoints controls the behavior when a control point is dragged past another point.

virtual bool	GetSwitchPointsMode ()
	If DrawPoints is false, SwitchPoints controls the behavior when a control point is dragged past another point.


virtual void	SetEndPointsXMovable (bool)
	If EndPointsMovable is false, the two end points will not be moved.

virtual bool	GetEndPointsXMovable ()
	If EndPointsMovable is false, the two end points will not be moved.

virtual void	SetEndPointsYMovable (bool)
	If EndPointsMovable is false, the two end points will not be moved.

virtual bool	GetEndPointsYMovable ()
	If EndPointsMovable is false, the two end points will not be moved.

virtual bool	GetEndPointsMovable ()
	If EndPointsMovable is false, the two end points will not be moved.


virtual void	SetEndPointsRemovable (bool)
	If EndPointsRemovable is false, the two end points will not be removed.

virtual bool	GetEndPointsRemovable ()
	If EndPointsRemovable is false, the two end points will not be removed.


virtual void	SetShowLabels (bool)
	When set to true, labels are shown on the current control point and the end points.

virtual bool	GetShowLabels ()
	When set to true, labels are shown on the current control point and the end points.


virtual void	SetLabelFormat (const char *)
	Get/Set the label format.

virtual char *	GetLabelFormat ()
	Get/Set the label format.


virtual vtkPen *	GetSelectedPointPen ()
	Gets the selected point pen and brush.


virtual vtkBrush *	GetSelectedPointBrush ()
	Depending on the control points item, the brush might not be taken into account.


virtual bool	GetUseAddPointItem ()
	When enabled, a dedicated item is used to determine if a point should be added when clicking anywhere.

virtual void	SetUseAddPointItem (bool)
	When enabled, a dedicated item is used to determine if a point should be added when clicking anywhere.

virtual void	UseAddPointItemOn ()
	When enabled, a dedicated item is used to determine if a point should be added when clicking anywhere.

virtual void	UseAddPointItemOff ()
	When enabled, a dedicated item is used to determine if a point should be added when clicking anywhere.


bool	MouseButtonPressEvent (const vtkContextMouseEvent &mouse) override
	Mouse and key events.

bool	MouseDoubleClickEvent (const vtkContextMouseEvent &mouse) override
	Mouse and key events.

bool	MouseButtonReleaseEvent (const vtkContextMouseEvent &mouse) override
	Mouse and key events.

bool	MouseMoveEvent (const vtkContextMouseEvent &mouse) override
	Mouse and key events.

bool	KeyPressEvent (const vtkContextKeyEvent &key) override
	Mouse and key events.

bool	KeyReleaseEvent (const vtkContextKeyEvent &key) override
	Mouse and key events.

Public Member Functions inherited from vtkPlot
virtual vtkTypeBool	IsA (const char *type)
	Return 1 if this class is the same type of (or a subclass of) the named class.

vtkPlot *	NewInstance () const

void	PrintSelf (ostream &os, vtkIndent indent) override
	Methods invoked by print to print information about the object including superclasses.

void	Update () override
	Perform any updates to the item that may be necessary before rendering.

virtual bool	PaintLegend (vtkContext2D *painter, const vtkRectf &rect, int legendIndex)
	Paint legend event for the plot, called whenever the legend needs the plot items symbol/mark/line drawn.

virtual vtkStdString	GetTooltipLabel (const vtkVector2d &plotPos, vtkIdType seriesIndex, vtkIdType segmentIndex)
	Generate and return the tooltip label string for this plot The segmentIndex parameter is ignored, except for vtkPlotBar.

virtual vtkIdType	GetNearestPoint (const vtkVector2f &point, const vtkVector2f &tolerance, vtkVector2f location, vtkIdType segmentId)
	Function to query a plot for the nearest point to the specified coordinate.

virtual bool	SelectPoints (const vtkVector2f &min, const vtkVector2f &max)
	Select all points in the specified rectangle.

virtual bool	SelectPointsInPolygon (const vtkContextPolygon &polygon)
	Select all points in the specified polygon.

virtual void	SetLabel (const vtkStdString &label)
	Set the label of this plot.

virtual vtkStdString	GetLabel ()
	Get the label of this plot.

virtual void	SetLabels (vtkStringArray *labels)
	Set the plot labels, these are used for stacked chart variants, with the index referring to the stacking index.

virtual vtkStringArray *	GetLabels ()
	Get the plot labels.

virtual int	GetNumberOfLabels ()
	Get the number of labels associated with this plot.

vtkStdString	GetLabel (vtkIdType index)
	Get the label at the specified index.

void	SetIndexedLabels (vtkStringArray *labels)
	Set indexed labels for the plot.

virtual vtkStringArray *	GetIndexedLabels ()
	Get the indexed labels array.

vtkContextMapper2D *	GetData ()
	Get the data object that the plot will draw.

virtual vtkTable *	GetInput ()
	Get the input table used by the plot.

vtkAlgorithmOutput *	GetInputConnection ()
	Get the input connection used by the plot.

virtual void	SetInputArray (int index, const vtkStdString &name)
	Convenience function to set the input arrays.

virtual void	GetBounds (double bounds[4])
	Get the bounds for this plot as (Xmin, Xmax, Ymin, Ymax).

virtual void	GetUnscaledInputBounds (double bounds[4])
	Provide un-log-scaled bounds for the plot inputs.

bool	Hit (const vtkContextMouseEvent &mouse) override
	Returns true if the supplied x, y coordinate is inside the item.

virtual bool	UpdateCache ()
	Update the internal cache.

virtual void	SetLegendVisibility (bool)
	Set whether the plot renders an entry in the legend.

virtual bool	GetLegendVisibility ()
	Set whether the plot renders an entry in the legend.

virtual void	LegendVisibilityOn ()
	Set whether the plot renders an entry in the legend.

virtual void	LegendVisibilityOff ()
	Set whether the plot renders an entry in the legend.

virtual void	SetTooltipLabelFormat (const vtkStdString &label)
	Sets/gets a printf-style string to build custom tooltip labels from.

virtual vtkStdString	GetTooltipLabelFormat ()
	Sets/gets a printf-style string to build custom tooltip labels from.

virtual void	SetTooltipNotation (int notation)
	Sets/gets the tooltip notation style.

virtual int	GetTooltipNotation ()
	Sets/gets the tooltip notation style.

virtual void	SetTooltipPrecision (int precision)
	Sets/gets the tooltip precision.

virtual int	GetTooltipPrecision ()
	Sets/gets the tooltip precision.

virtual void	SetColor (unsigned char r, unsigned char g, unsigned char b, unsigned char a)
	Set the plot color with integer values (comprised between 0 and 255)

virtual void	SetColor (unsigned char r, unsigned char g, unsigned char b)
	Set the plot color with integer values (comprised between 0 and 255)

virtual void	SetColorF (double r, double g, double b, double a)
	Set the plot color with floating values (comprised between 0.0 and 1.0)

virtual void	SetColorF (double r, double g, double b)
	Set the plot color with floating values (comprised between 0.0 and 1.0)

virtual void	GetColor (unsigned char rgb[3])
	Get the plot color as integer rgb values (comprised between 0 and 255)

void	GetColorRGBA (unsigned char rgba[4])
	Get the plot color as integer rgb values (comprised between 0 and 255)

virtual void	GetColorF (double rgb[3])
	Get the plot color as floating rgb values (comprised between 0.0 and 1.0)

virtual void	SetWidth (float width)
	@

virtual float	GetWidth ()
	Get the width of the line.

void	SetPen (vtkPen *pen)
	Set/get the vtkPen object that controls how this plot draws (out)lines.

vtkPen *	GetPen ()
	Get the plot color as floating rgb values (comprised between 0.0 and 1.0)

void	SetBrush (vtkBrush *brush)
	Set/get the vtkBrush object that controls how this plot fills shapes.

vtkBrush *	GetBrush ()
	Set/get the vtkBrush object that controls how this plot fills shapes.

void	SetSelectionPen (vtkPen *pen)
	Set/get the vtkBrush object that controls how this plot fills selected shapes.

vtkPen *	GetSelectionPen ()
	Set/get the vtkBrush object that controls how this plot fills selected shapes.

void	SetSelectionBrush (vtkBrush *brush)
	Set/get the vtkBrush object that controls how this plot fills selected shapes.

vtkBrush *	GetSelectionBrush ()
	Set/get the vtkBrush object that controls how this plot fills selected shapes.

virtual bool	GetUseIndexForXSeries ()
	Use the Y array index for the X value.

virtual void	SetUseIndexForXSeries (bool)
	Use the Y array index for the X value.

virtual void	SetInputData (vtkTable *table)
	This is a convenience function to set the input table and the x, y column for the plot.

virtual void	SetInputData (vtkTable *table, const vtkStdString &xColumn, const vtkStdString &yColumn)
	This is a convenience function to set the input table and the x, y column for the plot.

void	SetInputData (vtkTable *table, vtkIdType xColumn, vtkIdType yColumn)
	This is a convenience function to set the input table and the x, y column for the plot.

virtual void	SetInputConnection (vtkAlgorithmOutput *input)
	This is a convenience function to set the input connection for the plot.

void	SetXAxisInputArrayToProcess (const std::string &name)
	Convenient function to directly set/get the names of columns used for X and Y axis respectively.

std::string	GetXAxisInputArrayToProcess ()
	Convenient function to directly set/get the names of columns used for X and Y axis respectively.

void	SetYAxisInputArrayToProcess (const std::string &name)
	Convenient function to directly set/get the names of columns used for X and Y axis respectively.

std::string	GetYAxisInputArrayToProcess ()
	Convenient function to directly set/get the names of columns used for X and Y axis respectively.

virtual void	SetSelectable (bool)
	Set whether the plot can be selected.

virtual bool	GetSelectable ()
	Set whether the plot can be selected.

virtual void	SelectableOn ()
	Set whether the plot can be selected.

virtual void	SelectableOff ()
	Set whether the plot can be selected.

virtual void	SetSelection (vtkIdTypeArray *id)
	Sets the list of points that must be selected.

virtual vtkIdTypeArray *	GetSelection ()
	Sets the list of points that must be selected.

virtual vtkAxis *	GetXAxis ()
	Get/set the X axis associated with this plot.

virtual void	SetXAxis (vtkAxis *axis)
	Get/set the X axis associated with this plot.

virtual vtkAxis *	GetYAxis ()
	Get/set the Y axis associated with this plot.

virtual void	SetYAxis (vtkAxis *axis)
	Get/set the Y axis associated with this plot.

void	SetShiftScale (const vtkRectd &shiftScale)
	Get/set the origin shift and scaling factor used by the plot, this is normally 0.0 offset and 1.0 scaling, but can be used to render data outside of the single precision range.

vtkRectd	GetShiftScale ()
	Get/set the origin shift and scaling factor used by the plot, this is normally 0.0 offset and 1.0 scaling, but can be used to render data outside of the single precision range.

virtual void	SetProperty (const vtkStdString &property, const vtkVariant &var)
	A General setter/getter that should be overridden.

virtual vtkVariant	GetProperty (const vtkStdString &property)
	A General setter/getter that should be overridden.

virtual bool	ClampPos (double pos[2])
	Clamp the given 2D pos into the provided bounds Return true if the pos has been clamped, false otherwise.

Public Member Functions inherited from vtkContextItem
virtual vtkTypeBool	IsA (const char *type)
	Return 1 if this class is the same type of (or a subclass of) the named class.

vtkContextItem *	NewInstance () const

void	PrintSelf (ostream &os, vtkIndent indent) override
	Methods invoked by print to print information about the object including superclasses.

virtual void	SetTransform (vtkContextTransform *)
	Set the transform of the item.

virtual double	GetOpacity ()
	Get the opacity of the item.

virtual void	SetOpacity (double)
	Set the opacity of the item.

Public Member Functions inherited from vtkAbstractContextItem
virtual vtkTypeBool	IsA (const char *type)
	Return 1 if this class is the same type of (or a subclass of) the named class.

vtkAbstractContextItem *	NewInstance () const

void	PrintSelf (ostream &os, vtkIndent indent) override
	Methods invoked by print to print information about the object including superclasses.

virtual void	Update ()
	Perform any updates to the item that may be necessary before rendering.

virtual bool	Paint (vtkContext2D *painter)
	Paint event for the item, called whenever the item needs to be drawn.

virtual bool	PaintChildren (vtkContext2D *painter)
	Paint the children of the item, should be called whenever the children need to be rendered.

virtual void	ReleaseGraphicsResources ()
	Release graphics resources hold by the item.

vtkIdType	AddItem (vtkAbstractContextItem *item)
	Add child items to this item.

bool	RemoveItem (vtkAbstractContextItem *item)
	Remove child item from this item.

bool	RemoveItem (vtkIdType index)
	Remove child item from this item.

vtkAbstractContextItem *	GetItem (vtkIdType index)
	Get the item at the specified index.

vtkIdType	GetItemIndex (vtkAbstractContextItem *item)
	Get the index of the specified item in itemIndex.

vtkIdType	GetNumberOfItems ()
	Get the number of child items.

void	ClearItems ()
	Remove all child items from this item.

vtkIdType	Raise (vtkIdType index)
	Raises the child to the top of the item's stack.

virtual vtkIdType	StackAbove (vtkIdType index, vtkIdType under)
	Raises the child above the under sibling.

vtkIdType	Lower (vtkIdType index)
	Lowers the child to the bottom of the item's stack.

virtual vtkIdType	StackUnder (vtkIdType child, vtkIdType above)
	Lowers the child under the above sibling.

virtual bool	Hit (const vtkContextMouseEvent &mouse)
	Return true if the supplied x, y coordinate is inside the item.

virtual vtkAbstractContextItem *	GetPickedItem (const vtkContextMouseEvent &mouse)
	Return the item under the mouse.

virtual bool	MouseEnterEvent (const vtkContextMouseEvent &mouse)
	Mouse enter event.

virtual bool	MouseMoveEvent (const vtkContextMouseEvent &mouse)
	Mouse move event.

virtual bool	MouseLeaveEvent (const vtkContextMouseEvent &mouse)
	Mouse leave event.

virtual bool	MouseButtonPressEvent (const vtkContextMouseEvent &mouse)
	Mouse button down event Return true if the item holds the event, false if the event can be propagated to other items.

virtual bool	MouseButtonReleaseEvent (const vtkContextMouseEvent &mouse)
	Mouse button release event.

virtual bool	MouseDoubleClickEvent (const vtkContextMouseEvent &mouse)
	Mouse button double click event.

virtual bool	MouseWheelEvent (const vtkContextMouseEvent &mouse, int delta)
	Mouse wheel event, positive delta indicates forward movement of the wheel.

virtual bool	KeyPressEvent (const vtkContextKeyEvent &key)
	Key press event.

virtual bool	KeyReleaseEvent (const vtkContextKeyEvent &key)
	Key release event.

virtual void	SetScene (vtkContextScene *scene)
	Set the vtkContextScene for the item, always set for an item in a scene.

vtkContextScene *	GetScene ()
	Get the vtkContextScene for the item, always set for an item in a scene.

virtual void	SetParent (vtkAbstractContextItem *parent)
	Set the parent item.

vtkAbstractContextItem *	GetParent ()
	Get the parent item.

virtual vtkVector2f	MapToParent (const vtkVector2f &point)
	Maps the point to the parent coordinate system.

virtual vtkVector2f	MapFromParent (const vtkVector2f &point)
	Maps the point from the parent coordinate system.

virtual vtkVector2f	MapToScene (const vtkVector2f &point)
	Maps the point to the scene coordinate system.

virtual vtkVector2f	MapFromScene (const vtkVector2f &point)
	Maps the point from the scene coordinate system.

virtual bool	GetVisible ()
	Get the visibility of the item (should it be drawn).

virtual void	SetVisible (bool)
	Set the visibility of the item (should it be drawn).

virtual bool	GetInteractive ()
	Get if the item is interactive (should respond to mouse events).

virtual void	SetInteractive (bool)
	Set if the item is interactive (should respond to mouse events).

Public Member Functions inherited from vtkObject
	vtkBaseTypeMacro (vtkObject, vtkObjectBase)

virtual void	DebugOn ()
	Turn debugging output on.

virtual void	DebugOff ()
	Turn debugging output off.

bool	GetDebug ()
	Get the value of the debug flag.

void	SetDebug (bool debugFlag)
	Set the value of the debug flag.

virtual void	Modified ()
	Update the modification time for this object.

virtual vtkMTimeType	GetMTime ()
	Return this object's modified time.

void	PrintSelf (ostream &os, vtkIndent indent) override
	Methods invoked by print to print information about the object including superclasses.

void	RemoveObserver (unsigned long tag)

void	RemoveObservers (unsigned long event)

void	RemoveObservers (const char *event)

void	RemoveAllObservers ()

vtkTypeBool	HasObserver (unsigned long event)

vtkTypeBool	HasObserver (const char *event)

vtkTypeBool	InvokeEvent (unsigned long event)

vtkTypeBool	InvokeEvent (const char *event)

std::string	GetObjectDescription () const override
	The object description printed in messages and PrintSelf output.

unsigned long	AddObserver (unsigned long event, vtkCommand *, float priority=0.0f)
	Allow people to add/remove/invoke observers (callbacks) to any VTK object.

unsigned long	AddObserver (const char event, vtkCommand , float priority=0.0f)
	Allow people to add/remove/invoke observers (callbacks) to any VTK object.

vtkCommand *	GetCommand (unsigned long tag)
	Allow people to add/remove/invoke observers (callbacks) to any VTK object.

void	RemoveObserver (vtkCommand *)
	Allow people to add/remove/invoke observers (callbacks) to any VTK object.

void	RemoveObservers (unsigned long event, vtkCommand *)
	Allow people to add/remove/invoke observers (callbacks) to any VTK object.

void	RemoveObservers (const char event, vtkCommand )
	Allow people to add/remove/invoke observers (callbacks) to any VTK object.

vtkTypeBool	HasObserver (unsigned long event, vtkCommand *)
	Allow people to add/remove/invoke observers (callbacks) to any VTK object.

vtkTypeBool	HasObserver (const char event, vtkCommand )
	Allow people to add/remove/invoke observers (callbacks) to any VTK object.

template<class U , class T >
unsigned long	AddObserver (unsigned long event, U observer, void(T::*callback)(), float priority=0.0f)
	Overloads to AddObserver that allow developers to add class member functions as callbacks for events.

template<class U , class T >
unsigned long	AddObserver (unsigned long event, U observer, void(T::callback)(vtkObject , unsigned long, void *), float priority=0.0f)
	Overloads to AddObserver that allow developers to add class member functions as callbacks for events.

template<class U , class T >
unsigned long	AddObserver (unsigned long event, U observer, bool(T::callback)(vtkObject , unsigned long, void *), float priority=0.0f)
	Allow user to set the AbortFlagOn() with the return value of the callback method.

vtkTypeBool	InvokeEvent (unsigned long event, void *callData)
	This method invokes an event and return whether the event was aborted or not.

vtkTypeBool	InvokeEvent (const char event, void callData)
	This method invokes an event and return whether the event was aborted or not.

virtual void	SetObjectName (const std::string &objectName)
	Set/get the name of this object for reporting purposes.

virtual std::string	GetObjectName () const
	Set/get the name of this object for reporting purposes.

Public Member Functions inherited from vtkObjectBase
const char *	GetClassName () const
	Return the class name as a string.

virtual std::string	GetObjectDescription () const
	The object description printed in messages and PrintSelf output.

virtual vtkTypeBool	IsA (const char *name)
	Return 1 if this class is the same type of (or a subclass of) the named class.

virtual vtkIdType	GetNumberOfGenerationsFromBase (const char *name)
	Given the name of a base class of this class type, return the distance of inheritance between this class type and the named class (how many generations of inheritance are there between this class and the named class).

virtual void	Delete ()
	Delete a VTK object.

virtual void	FastDelete ()
	Delete a reference to this object.

void	InitializeObjectBase ()

void	Print (ostream &os)
	Print an object to an ostream.

void	Register (vtkObjectBase *o)
	Increase the reference count (mark as used by another object).

virtual void	UnRegister (vtkObjectBase *o)
	Decrease the reference count (release by another object).

int	GetReferenceCount ()
	Return the current reference count of this object.

void	SetReferenceCount (int)
	Sets the reference count.

bool	GetIsInMemkind () const
	A local state flag that remembers whether this object lives in the normal or extended memory space.

virtual void	PrintHeader (ostream &os, vtkIndent indent)
	Methods invoked by print to print information about the object including superclasses.

virtual void	PrintTrailer (ostream &os, vtkIndent indent)
	Methods invoked by print to print information about the object including superclasses.

virtual bool	UsesGarbageCollector () const
	Indicate whether the class uses `vtkGarbageCollector` or not.

Static Public Member Functions
static vtkTypeBool	IsTypeOf (const char *type)

static vtkControlPointsItem *	SafeDownCast (vtkObjectBase *o)

Static Public Member Functions inherited from vtkPlot
static vtkTypeBool	IsTypeOf (const char *type)

static vtkPlot *	SafeDownCast (vtkObjectBase *o)

static void	FilterSelectedPoints (vtkDataArray points, vtkDataArray selectedPoints, vtkIdTypeArray *selectedIds)
	Utility function that fills up `selectedPoints` with tuples from `points`.

static bool	ClampPos (double pos[2], double bounds[4])
	Clamp the given 2D pos into the provided bounds Return true if the pos has been clamped, false otherwise.

Static Public Member Functions inherited from vtkContextItem
static vtkTypeBool	IsTypeOf (const char *type)

static vtkContextItem *	SafeDownCast (vtkObjectBase *o)

Static Public Member Functions inherited from vtkAbstractContextItem
static vtkTypeBool	IsTypeOf (const char *type)

static vtkAbstractContextItem *	SafeDownCast (vtkObjectBase *o)

Static Public Member Functions inherited from vtkObject
static vtkObject *	New ()
	Create an object with Debug turned off, modified time initialized to zero, and reference counting on.

static void	BreakOnError ()
	This method is called when vtkErrorMacro executes.

static void	SetGlobalWarningDisplay (vtkTypeBool val)
	This is a global flag that controls whether any debug, warning or error messages are displayed.

static void	GlobalWarningDisplayOn ()
	This is a global flag that controls whether any debug, warning or error messages are displayed.

static void	GlobalWarningDisplayOff ()
	This is a global flag that controls whether any debug, warning or error messages are displayed.

static vtkTypeBool	GetGlobalWarningDisplay ()
	This is a global flag that controls whether any debug, warning or error messages are displayed.

Static Public Member Functions inherited from vtkObjectBase
static vtkTypeBool	IsTypeOf (const char *name)
	Return 1 if this class type is the same type of (or a subclass of) the named class.

static vtkIdType	GetNumberOfGenerationsFromBaseType (const char *name)
	Given a the name of a base class of this class type, return the distance of inheritance between this class type and the named class (how many generations of inheritance are there between this class and the named class).

static vtkObjectBase *	New ()
	Create an object with Debug turned off, modified time initialized to zero, and reference counting on.

static void	SetMemkindDirectory (const char *directoryname)
	The name of a directory, ideally mounted -o dax, to memory map an extended memory space within.

static bool	GetUsingMemkind ()
	A global state flag that controls whether vtkObjects are constructed in the usual way (the default) or within the extended memory space.

Protected Member Functions
virtual vtkObjectBase *	NewInstanceInternal () const

	vtkControlPointsItem ()

	~vtkControlPointsItem () override

void	StartChanges ()

void	EndChanges ()

void	StartInteraction ()

void	StartInteractionIfNotStarted ()

void	Interaction ()

void	EndInteraction ()

int	GetInteractionsCount () const

virtual void	emitEvent (unsigned long event, void *params=nullptr)=0

bool	Hit (const vtkContextMouseEvent &mouse) override
	Returns true if the supplied x, y are within the bounds or on a control point.

void	SetCurrentPointPos (const vtkVector2f &newPos)

vtkIdType	SetPointPos (vtkIdType point, const vtkVector2f &newPos)

void	MoveCurrentPoint (const vtkVector2f &translation)

vtkIdType	MovePoint (vtkIdType point, const vtkVector2f &translation)

vtkVector2f	GetSelectionCenterOfMass () const

vtkVector2f	GetCenterOfMass (vtkIdTypeArray *pointIDs) const

void	Stroke (const vtkVector2f &newPos)

virtual void	EditPoint (float vtkNotUsed(tX), float vtkNotUsed(tY))

virtual std::string	GetControlPointLabel (vtkIdType index)
	Generate label for a control point.

void	AddPointId (vtkIdType addedPointId)

bool	IsEndPointPicked ()
	Return true if any of the end points is current point or part of the selection.

bool	IsPointRemovable (vtkIdType pointId)
	Return true if the point is removable.

virtual void	ComputeBounds (double *bounds)
	Compute the bounds for this item.


virtual void	ComputePoints ()
	Must be reimplemented by subclasses to calculate the points to draw.

virtual vtkMTimeType	GetControlPointsMTime ()=0
	Must be reimplemented by subclasses to calculate the points to draw.


bool	ClampValidDataPos (double pos[2])
	Clamp the given 2D pos into the bounds of the function.

bool	ClampValidScreenPos (double pos[2])
	Clamp the given 2D pos into the bounds of the function.


void	DrawUnselectedPoints (vtkContext2D *painter)
	Internal function that paints a collection of points and optionally excludes some.

void	DrawSelectedPoints (vtkContext2D *painter)
	Internal function that paints a collection of points and optionally excludes some.

virtual void	DrawPoint (vtkContext2D *painter, vtkIdType index)
	Internal function that paints a collection of points and optionally excludes some.

Protected Member Functions inherited from vtkPlot
virtual vtkObjectBase *	NewInstanceInternal () const

	vtkPlot ()

	~vtkPlot () override

vtkStdString	GetNumber (double position, vtkAxis *axis)
	Get the properly formatted number for the supplied position and axis.

virtual bool	CacheRequiresUpdate ()
	Test if the internal cache requires an update.

virtual void	TransformScreenToData (const vtkVector2f &in, vtkVector2f &out)
	Transform the mouse event in the control-points space.

virtual void	TransformDataToScreen (const vtkVector2f &in, vtkVector2f &out)
	Transform the mouse event in the control-points space.

virtual void	TransformScreenToData (double inX, double inY, double &outX, double &outY)
	Transform the mouse event in the control-points space.

virtual void	TransformDataToScreen (double inX, double inY, double &outX, double &outY)
	Transform the mouse event in the control-points space.

Protected Member Functions inherited from vtkContextItem
virtual vtkObjectBase *	NewInstanceInternal () const

	vtkContextItem ()=default

	~vtkContextItem () override

Protected Member Functions inherited from vtkAbstractContextItem
virtual vtkObjectBase *	NewInstanceInternal () const

	vtkAbstractContextItem ()

	~vtkAbstractContextItem () override

virtual void	ReleaseGraphicsCache ()
	Release cache entries created by this context item.

Protected Member Functions inherited from vtkObject
	vtkObject ()

	~vtkObject () override

void	RegisterInternal (vtkObjectBase *, vtkTypeBool check) override

void	UnRegisterInternal (vtkObjectBase *, vtkTypeBool check) override

void	InternalGrabFocus (vtkCommand mouseEvents, vtkCommand keypressEvents=nullptr)
	These methods allow a command to exclusively grab all events.

void	InternalReleaseFocus ()
	These methods allow a command to exclusively grab all events.

Protected Member Functions inherited from vtkObjectBase
	vtkObjectBase ()

virtual	~vtkObjectBase ()

virtual void	RegisterInternal (vtkObjectBase *, vtkTypeBool check)

virtual void	UnRegisterInternal (vtkObjectBase *, vtkTypeBool check)

virtual void	ReportReferences (vtkGarbageCollector *)

virtual void	ObjectFinalize ()

	vtkObjectBase (const vtkObjectBase &)

void	operator= (const vtkObjectBase &)

Static Protected Member Functions
static void	CallComputePoints (vtkObject sender, unsigned long event, void receiver, void *params)

Static Protected Member Functions inherited from vtkObjectBase
static vtkMallocingFunction	GetCurrentMallocFunction ()

static vtkReallocingFunction	GetCurrentReallocFunction ()

static vtkFreeingFunction	GetCurrentFreeFunction ()

static vtkFreeingFunction	GetAlternateFreeFunction ()

Protected Attributes
vtkNew< vtkCallbackCommand >	Callback

vtkNew< vtkPen >	SelectedPointPen

vtkNew< vtkBrush >	SelectedPointBrush

int	BlockUpdates = 0

int	StartedInteractions = 0

int	StartedChanges = 0

vtkIdType	CurrentPoint = -1

double	Bounds [4] = { 0., -1., 0., -1. }

double	UserBounds [4] = { 0., -1., 0., -1. }

double	ValidBounds [4] = { 0., -1., 0., -1. }

vtkNew< vtkTransform2D >	ControlPointsTransform

float	ScreenPointRadius = 6.f

bool	DrawPoints = true

bool	StrokeMode = false

bool	SwitchPointsMode = false

bool	MouseMoved = false

bool	EnforceValidFunction = true

vtkIdType	PointToDelete = -1

bool	PointAboutToBeDeleted = false

vtkIdType	PointToToggle = -1

bool	PointAboutToBeToggled = false

bool	InvertShadow = false

bool	EndPointsXMovable = true

bool	EndPointsYMovable = true

bool	EndPointsRemovable = true

bool	ShowLabels = false

char *	LabelFormat = nullptr

Protected Attributes inherited from vtkPlot
vtkTimeStamp	BuildTime
	The point cache is marked dirty until it has been initialized.

vtkSmartPointer< vtkPen >	Pen
	This object stores the vtkPen that controls how the plot is drawn.

vtkSmartPointer< vtkBrush >	Brush
	This object stores the vtkBrush that controls how the plot is drawn.

vtkSmartPointer< vtkPen >	SelectionPen
	This object stores the vtkPen that controls how the selected elements of the plot are drawn.

vtkSmartPointer< vtkBrush >	SelectionBrush
	This object stores the vtkBrush that controls how the selected elements of the plot are drawn.

vtkSmartPointer< vtkStringArray >	Labels
	Plot labels, used by legend.

vtkSmartPointer< vtkStringArray >	AutoLabels
	Holds Labels when they're auto-created.

vtkSmartPointer< vtkStringArray >	IndexedLabels
	Holds Labels when they're auto-created.

bool	UseIndexForXSeries
	Use the Y array index for the X value.

vtkSmartPointer< vtkContextMapper2D >	Data
	This data member contains the data that will be plotted, it inherits from vtkAlgorithm.

bool	Selectable
	Whether plot points can be selected or not.

vtkIdTypeArray *	Selection
	Selected indices for the table the plot is rendering.

vtkAxis *	XAxis
	The X axis associated with this plot.

vtkAxis *	YAxis
	The X axis associated with this plot.

vtkStdString	TooltipLabelFormat
	A printf-style string to build custom tooltip labels from.

vtkStdString	TooltipDefaultLabelFormat
	The default printf-style string to build custom tooltip labels from.

int	TooltipNotation

int	TooltipPrecision

vtkRectd	ShiftScale
	The current shift in origin and scaling factor applied to the plot.

bool	LegendVisibility

Protected Attributes inherited from vtkContextItem
double	Opacity = 1.0

vtkContextTransform *	Transform = nullptr

Protected Attributes inherited from vtkAbstractContextItem
vtkContextScene *	Scene
	Point to the scene the item is on - can be null.

vtkAbstractContextItem *	Parent
	Point to the parent item - can be null.

vtkContextScenePrivate *	Children
	This structure provides a list of children, along with convenience functions to paint the children etc.

bool	Visible
	Store the visibility of the item (default is true).

bool	Interactive
	Store whether the item should respond to interactions (default is true).

Protected Attributes inherited from vtkObject
bool	Debug

vtkTimeStamp	MTime

vtkSubjectHelper *	SubjectHelper

std::string	ObjectName

Protected Attributes inherited from vtkObjectBase
std::atomic< int32_t >	ReferenceCount

vtkWeakPointerBase **	WeakPointers

Friends
class	vtkPiecewisePointHandleItem

Detailed Description

Abstract class for control points items.

vtkControlPointsItem provides control point painting and management for subclasses that provide points (typically control points of a transfer function)

See also: vtkScalarsToColorsItem vtkPiecewiseControlPointsItem

Tests:: vtkControlPointsItem (Tests)

Definition at line 39 of file vtkControlPointsItem.h.

Member Typedef Documentation

◆ Superclass

typedef vtkPlot vtkControlPointsItem::Superclass

Definition at line 42 of file vtkControlPointsItem.h.

Member Enumeration Documentation

◆ anonymous enum

anonymous enum

Enumerator
CurrentPointChangedEvent
CurrentPointEditEvent

Definition at line 51 of file vtkControlPointsItem.h.

Constructor & Destructor Documentation

◆ vtkControlPointsItem()

vtkControlPointsItem::vtkControlPointsItem ( )

protected

◆ ~vtkControlPointsItem()

vtkControlPointsItem::~vtkControlPointsItem ( )

overrideprotected

Member Function Documentation

◆ IsTypeOf()

static vtkTypeBool vtkControlPointsItem::IsTypeOf ( const char * type )

static

◆ IsA()

virtual vtkTypeBool vtkControlPointsItem::IsA ( const char * name )

virtual

Return 1 if this class is the same type of (or a subclass of) the named class.

Returns 0 otherwise. This method works in combination with vtkTypeMacro found in vtkSetGet.h.

Reimplemented from vtkPlot.

Reimplemented in vtkColorTransferControlPointsItem, vtkCompositeControlPointsItem, and vtkPiecewiseControlPointsItem.

◆ SafeDownCast()

static vtkControlPointsItem * vtkControlPointsItem::SafeDownCast ( vtkObjectBase * o )

static

◆ NewInstanceInternal()

virtual vtkObjectBase * vtkControlPointsItem::NewInstanceInternal ( ) const

protectedvirtual

Reimplemented from vtkPlot.

Reimplemented in vtkColorTransferControlPointsItem, vtkCompositeControlPointsItem, and vtkPiecewiseControlPointsItem.

◆ NewInstance()

vtkControlPointsItem * vtkControlPointsItem::NewInstance ( ) const

◆ PrintSelf()

void vtkControlPointsItem::PrintSelf	(	ostream &	os,
		vtkIndent	indent
	)

overridevirtual

Methods invoked by print to print information about the object including superclasses.

Typically not called by the user (use Print() instead) but used in the hierarchical print process to combine the output of several classes.

Reimplemented from vtkContextItem.

Reimplemented in vtkPiecewiseControlPointsItem.

◆ GetBounds()

void vtkControlPointsItem::GetBounds ( double bounds[4] )

overridevirtual

Bounds of the item, typically the bound of all the control points except if custom bounds have been set.

See also: SetUserBounds.

Reimplemented from vtkPlot.