IDLgrView objects have the following properties in addition to properties inherited from any superclasses. Properties with the word "Yes" in the "Get" column of the property table can be retrieved via IDLgrView::GetProperty. Properties with the word "Yes" in the "Init" column of the property table can be set via IDLgrView::Init. Properties with the word "Yes" in the "Set" column in the property table can be set via IDLgrView::SetProperty.
| Note |
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.
| Note |
The color for the view. This is the color to which the view area will be erased before its contents are drawn. The color may be specified as a color lookup table index or as a three-element vector [red, green, blue]. The default is [255, 255, 255] (white).
In a property sheet, this property appears as a color property.
A two-element floating-point array [zbright, zdim] specifying the near and far Z planes between which depth cueing is in effect. Depth cueing is only honored when drawing to a destination object that uses the RGB color model.
Depth cueing causes an object to appear to fade into the background color of the view object with changes in depth. If the depth of an object is further than zdim (that is, if the object's location in the Z direction is farther from the origin than the value specified by zdim), the object will be painted in the background color. Similarly, if the object is closer than the value of zbright, the object will appear in its "normal" color. Anywhere in-between, the object will be a blend of the background color and the object color. For example, if the DEPTH_CUE property is set to [-1,1], an object at the depth of 0.0 will appear as a 50% blend of the object color and the view color.
The relationship between Zbright and Zdim determines the result of the rendering:
You can disable depth cueing by setting zbright = zdim. The default is [0.0, 0.0].
This property is registered as a user-defined property, but it is hidden by default.
A two-element integer vector of the form [width, height] specifying the dimensions of the viewport (the rectangle in which models are displayed on a graphics destination). By default, the viewport dimensions are set to [0, 0], which indicates that it will match the dimensions of the graphics destination to which it is drawn. The dimensions are measured in the units specified by the UNITS property.
A Boolean value that controls the precision used for rendering the entire contents of the view. If set, IDL calculates the transformations used for the modeling and view transforms using double-precision floating-point arithmetic. This allows the values specified for the VIEWPLANE_RECT, modeling transforms in IDLgrModel objects, and coordinate data in atomic graphic objects to be used as double-precision before mapping to device coordinates.
| Note |
A floating-point value that specifies the distance from the eyepoint to the viewplane (Z=0). The default is 4.0. The eyepoint is always centered within the viewplane rectangle. (That is, if the VIEWPLANE_RECT property is set equal to [0,0,1,1], the eyepoint will be at X=0.5, Y=0.5.) IDL converts, maintains, and returns this data as double-precision floating-point.
A Boolean value indicating whether this object should be drawn:
In a property sheet, this property appears as an enumerated list with the following options:
A two-element floating-point vector of the form [x, y] specifying the position of the lower left corner of the view. The default is [0, 0], measured in device units.
This property is registered as a user-defined property, but it is hidden by default.
An object reference to the object that contains this object.
An integer value indicating the type of projection to use within this view. All models displayed within this view will be projected using this type of projection. Valid values are described below.
In a property sheet, this property appears as an enumerated list with the following options:
A Boolean value that determines whether to register properties available for this object. Set this property to automatically register the following properties of the object for display in a property sheet. This property is useful mainly when creating iTools. By default, no properties are registered.
A Boolean value that determines whether to disable the viewport erase, making the viewport transparent. If this value is false, the viewport is erased and the depth buffer initialized. If this value is true the depth buffer is not intialized.
An integer value that specifies the units of measure for this view. Valid values are:
| Note |
In a property sheet, this property appears as an enumerated list with the following options:
A four-element floating-point vector of the form [x, y, width, height] to describe the bounds in x and y of the view volume. Objects within the view volume are projected into the viewport. These values are measured in normalized space. The default is [-1.0, -1.0, 2.0, 2.0] IDL converts, maintains, and returns this data as double-precision floating-point.
| Note |
This property is registered as a user-defined property, but it is hidden by default.
A two element floating-point vector representing the near and far clipping planes to be applied to the objects in this view. The vector should take the form [near, far]. By default, these values are [1, -1]. IDL converts, maintains, and returns this data as double-precision floating-point.
This property is registered as a user-defined property, but it is hidden by default.