 |
| |
A plot object creates a set of polylines connecting data points in two-dimensional space.
An IDLgrPlot object is an atomic graphic object ; it is one of the basic drawable elements of the IDL Object Graphics system, and it is not a container for other objects.
See IDLgrPlot::Init
IDLgrPlot::Cleanup
The IDLgrPlot::
Cleanup procedure method performs all cleanup on the object.
NOTE:
Cleanup methods are special
lifecycle methods
, and as such cannot be called outside the context of object destruction. This means that in most cases, you cannot call the Cleanup method directly. There is one exception to this rule: If you write your own subclass of this class, you can call the Cleanup method from within the Cleanup method of the subclass.
IDLgrPlot::GetCTMThe IDLgrPlot:: GetCTM function method returns the 4 x 4 graphics transform matrix from the current object upward through the graphics tree. IDLgrPlot is described above.
Set this keyword to the object reference of a destination object to specify that the projection matrix for the View object in the current tree be included in the returned transformation matrix. The resulting matrix will transform a point in the data space of the object on which the GetCTM method is called into a normalized coordinate system (-1 to +1 in X, Y, and Z), relative to the View object that contains the plot object.
Set this keyword equal to the object reference to an IDLgrModel object to specify that the returned matrix accumulate from the object on which the GetCTM method is called up to and including the specified model object.
IDLgrPlot::GetPropertyThe IDLgrPlot:: GetProperty procedure method retrieves the value of the property or group of properties for the plot. IDLgrPlot is described above.
Any keyword to IDLgrPlot::Init
Set this keyword to a named variable that will contain an anonymous structure containing the values of all of the properties associated with the state of this object. State information about the object includes things like color, range, tick direction, etc., but not image, vertex, or connectivity data, or user values.
Set this keyword equal to a named variable that will contain an object reference to the object that contains this object.
IDLgrPlot::InitThe IDLgrPlot:: Init function method initializes the plot object. IDLgrPlot is described above.
NOTE: Init methods are special lifecycle methods , and as such cannot be called outside the context of object creation. This means that in most cases, you cannot call the Init method directly. There is one exception to this rule: If you write your own subclass of this class, you can call the Init method from within the Init method of the subclass.
Obj = OBJ_NEW('IDLgrPlot' [, [X,] Y] )
Result =
Obj
->
[IDLgrPlot::]
Init(
[[X], Y]
) (
In a subclass' Init method only
.)
A vector representing the abscissa values to be plotted. If X is provided, Y is plotted as a function of X . This argument is converted to single-precision floating-point values. X and Y are measured in units specified by the UNITS keyword.
Either a vector of two-element arrays [ x , y ] representing the points to be plotted, or a vector representing the ordinate values to be plotted. If Y is a vector of ordinate values and X is not specified, Y is plotted as a function of the vector index of Y . This argument is converted to single-precision floating point.
Properties retrievable via IDLgrPlot::GetProperty
Set this keyword to the color to be used as the foreground color for this plot. The color may be specified as a color lookup table index or as an RGB vector. The default is [255, 255, 255].
Set this keyword to a vector specifying the X values to be plotted. This keyword is the same as the X argument.
Set this keyword to a vector specifying the Yvalues to be plotted. This keyword is the same as the Y argument.
Set this keyword to force only horizontal and vertical lines to be used to connect the plotted points. By default, the points are connected using a single straight line.
Set this keyword to indicate the line style that should be used to draw the plot lines. The value can be either an integer value specifying a pre-defined line style, or a two-element vector specifying a stippling pattern.
To use a pre-defined line style, set the LINESTYLE property equal to one of the following integer values:
To define your own stippling pattern, specify a two-element vector [ repeat , bitmask ], where repeat indicates the number of times consecutive runs of 1's or 0's in the bitmask should be repeated. (That is, if three consecutive 0's appear in the bitmask and the value of repeat is 2, then the line that is drawn will have six consecutive bits turned off.) The value of repeat must be in the range 1 £ repeat £ 255.
The bitmask indicates which pixels are drawn and which are not along the length of the line. Bitmask is most conveniently specified as a 16-bit hexadecimal value.
For example,
LINESTYLE = [2, 'F0F0'X]
describes a dashed line (8 bits on, 8 bits off, 8 bits on, 8 bits off).
The maximum value to be plotted. If this keyword is present, data values greater than the value of MAX_VALUE are treated as missing data and are not plotted. Note that the IEEE floating-point value NaN is also treated as missing data.
The minimum value to be plotted. If this keyword is present, data values less than the value of MIN_VALUE are treated as missing data and are not plotted. Note that the IEEE floating-point value NaN is also treated as missing data.
Set this keyword equal to a string containing the name associated with this object. The default is the null string, ' '.
Set this keyword to the number of data points to average when plotting. If NSUM is larger than 1, every group of NSUM points is averaged to produce one plotted point. If there are M data points, then M/NSUM points are plotted.
Set this keyword to create a polar plot. The X and Y arguments must both be present. The X argument represents the radius, and the Y argument represents the angle expressed in radians.
Set this keyword to treat the data provided via one of the DATA[XY] properties as a new data set unique to this object, rather than overwriting data that is shared by other objects. There is no reason to use this keyword if the object on which the property is being set does not currently share data with another object (that is, if the SHARE_DATA property is not in use). This keyword has no effect if no new data is provided via a DATA property.
Set this keyword to an object with which data is to be shared by this plot. A plot may only share data with another plot. The SHARE_DATA property is intended for use when data values are not set via an argument to the object's Init method or by setting the object's DATA property.
Set this keyword to a vector containing instances of the IDLgrSymbol object class. Each symbol in the vector will be drawn at the corresponding plotted point. If there are more points than elements in SYMBOL, the elements of the SYMBOL vector are cyclically repeated. By default, no symbols are drawn. To remove symbols from a plot, set the SYMBOL property equal to a null object reference.
Set this keyword to an integer value between 1 and 10, specifying the line thickness to be used to draw the plotted lines, in pixels. The default is one pixel.
Set this keyword to use the current ZVALUE. The plot is considered three-dimensional if this keyword is set.
Set this keyword to a value of any type. You can use this "user value" to contain any information you wish. Remember that if you set the user value equal to a pointer or object reference, you should destroy the pointer or object reference explicitly when destroying the object it is a user value of.
Set this keyword to a vector of colors to be used to draw at each vertex. Color is interpolated between vertices. If there are more plot points than elements in VERT_COLORS, the elements of VERT_COLORS are cyclically repeated. By default, the plot is all drawn in the single color provided by the COLOR keyword. If the VERT_COLORS is provided, the COLOR keyword is ignored.
Set this keyword to a vector, [ s 0 , s 1 ], of scaling factors used to convert X coordinates from data units to normalized units. The formula for the conversion is as follows:
Normalized X = s 0 + s 1 * Data X
Set this keyword equal to a two-element vector of the form [ xmin , xmax ] specifying the range of x data coordinates covered by the graphic object. If this property is not specified, the minimum and maximum data values are used.
Set this keyword to a vector, [ s 0 , s 1 ], of scaling factors used to convert Y coordinates from data units to normalized units. The formula for the conversion is as follows:
Normalized Y = s 0 + s 1 * Data Y
Set this keyword equal to a two-element vector of the form [ ymin , ymax ] specifying the range of y data values covered by the graphic object. If this property is not specified, the minimum and maximum data values are used.
IDLgrPlot::SetPropertyThe IDLgrPlot:: SetProperty procedure method sets the value of the property or group of properties for the plot. IDLgrPlot is described above.
Any keyword to IDLgrPlot::Init