Predefined iTool Manipulators
The iTool system distributed with IDL includes a number of predefined manipulators. You can include these manipulators in an iTool directly by registering the class with your iTool (as described in Registering a Manipulator). You can also create a new manipulator class based on one of the predefined classes.
Predefined manipulators include those which are containers (subclassing from IDLitManipulatorContainer), and those which are visualization manipulators (subclassing from IDLitManipulator). The manipulators themselves allow the user to select and interact with the visualization through mouse movements and keyboard events.
General Manipulators
The following manipulators are available to any tool that subclasses from IDLitToolbase unless otherwise noted.
IDLitManipArrow
The arrow manipulator (IDLitManipArrow) is used to select a visualization object in the iTool window. It is also a container for the following manipulators:
- IDLitManipTranslate — repositions the visualization
- IDLitManipScale — resizes the visualization
- IDLitManipLine — moves the endpoint vertices of a selected line segment
- IDLitManipView — translates and scales views, enabling functionality based on cursor position within the iTool window
- IDLitManipImagePlane — moves an image plane in an iVolume tool window or in a window of a tool that subclasses from IDLitToolVolume.
IDLitManipAnnotation
The annotation manipulator (IDLitManipAnnotation) is used to add text, lines, or shapes to an iTool window. The following annotation manipulators subclass from IDLitManipAnnotation:
- IDLitAnnotateText — adds text to the iTool window
- IDLitAnnotateLine — adds a line to the iTool window
- IDLitAnnotateRectangle — adds a rectangle to the iTool window
- IDLitAnnotateOval — adds an oval to the iTool window
- IDLitAnnotatePolygon — adds a polygon to the iTool window
- IDLitAnnotateFreehand — adds a freehand shape to the iTool window
IDLitManipLineProfile
The profile line manipulator creates a profile plot for a line drawn on a surface or image.
IDLitManipRotate
The rotation manipulator rotates a visualization in the iTool window. It is a container for the following manipulators:
- IDLitManipRotate3D — repositions a visualization in three dimensions when the visualization is three-dimensional, or in two dimensions when the visualization is two-dimensional
- IDLitManipRotateX — rotates a visualization about the x-axis
- IDLitManipRotateY — rotates a visualization about the y-axis
- IDLitManipRotateZ — rotates a visualization about the z-axis
IDLitManipViewPan
The view pan manipulator, initiated by clicking on the hand tool, pans the view in the iTool window. The hand tool is available only when the zoom level of the view is greater than 100 percent or when the window has been resized and has scroll bars.
IDLitManipViewZoom
The view zoom manipulator changes the scaling of the view in the iTool window. This is not to be confused with IDLitManipScale, which resizes the visualization.
Image Manipulators
The following manipulators are available in the iImage iTool and any tools that subclass from IDLitToolImage.
IDLitManipCropBox
The crop box manipulator defines a crop region for an image.
IDLitManipROIFree
The freehand ROI manipulator draws a freehand ROI on the image.
IDLitManipROIOval
The oval ROI manipulator draws an oval ROI on the image.
IDLitManipROIPoly
The polygon ROI manipulator draws a polygonal ROI on the image.
IDLitManipROIRect
The rectangle ROI manipulator draws a rectangular ROI on the image.
Plot and Contour Manipulators
The following manipulators are available in the iPlot and iContour iTools, and any tools that subclass from IDLitToolPlot or IDLitToolContour.
IDLitManipRange
The range manipulator is available with a plot or contour visualization. The IDLitManipRange manipulator is a container for the following manipulators:
- IDLitManipRangeBox — changes the displayed range of the plot data to that which exists in the range box
- IDLitManipRangePan — scrolls the displayed data range using arrows displayed along the axes
- IDLitManipRangeZoom — zooms in or out on the y-data range, x-data range, or both x- and y-data ranges simultaneously through plus and minus symbols positioned along the plot axes and at the origin
Surface Manipulators
The following manipulator is available in the iSurface iTool and any tools that subclass from IDLitToolSurface.
IDLitManipSurfContour
The surface contour manipulator draws a contour line at the indicated elevation on a surface.
Note
This manipulator is not to be confused with the Operations → Contour selection, which draws a specified number of contour levels, projected onto the XY plane at Z=0.
Volume Manipulators
The following manipulator is available in the iVolume iTool and any tools that subclass from IDLitToolVolume.
IDLitManipImagePlane
When an image plane has been created using the Operations → Volume → Image Plane selection, clicking on the arrow manipulator tool initiates the image plane manipulator. This manipulator repositions the image plane.
