IDLgrWindow 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 IDLgrWindow::GetProperty. Properties with the word "Yes" in the "Init" column of the property table can be set via IDLgrWindow::Init. Properties with the word "Yes" in the "Set" column in the property table can be set via IDLgrWindow::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 |
An integer value that determines whether to use indexed color as the color model for the window:
| Note |
In a property sheet, this property appears as an enumerated list with the following options:
A floating-point value that represents the current zoom factor associated with this window.
A two-element integer vector of the form [width, height] to specify the dimensions of the window in units specified by the UNITS property. By default, if no value is specified for DIMENSIONS, IDL uses the value of the "Default Window Width" and "Default Window Height" preferences set in the IDL Development Environment's (IDLDE) Preferences dialog. If there is no preference file for the IDLDE, the DIMENSIONS property is set equal to one quarter of the screen size. There are limits on the maximum size of an IDLgrWindow object; see Note on Window Size Limits for details.
| Note |
This property is registered as a user-defined property, but it is hidden by default.
A string that specifies the name of the X Windows display on which the window is to appear.
An object reference of type IDLgrScene, IDLgrViewgroup, or IDLgrView describing the graphics tree of this window object. If this property is set to a valid object reference, calling the Draw method on the destination object with no arguments will cause the object reference associated with this property to be drawn. If this object is valid and the destination object is destroyed, this object reference will be destroyed as well. By default the GRAPHICS_TREE property is set equal to the null-object.
A byte array representing the image that is currently displayed in the window. If the window object uses an RGB color model, the returned array will have dimensions (3, winXSize, winYSize), or (4, winXSize, winYSize) if an alpha channel is included. If the window object uses an Indexed color model, the returned array will have dimensions (winXSize, winYSize). See IDLgrWindow::Read for more information.
A two-element floating-point vector of the form [x, y] to specify the location of the upper lefthand corner of the window relative to the display screen, in units specified by the UNITS property. By default, the window is positioned at one of four quadrants on the display screen, and the location is measured in device units.
| Note |
This property is registered as a user-defined property, but it is hidden by default.
A two-element vector, [width, height], specifying the minimum dimensions allowed for the virtual canvas of this window. The unit of measure is specified by the UNITS property. In a scrolling window, the virtual canvas represents the full canvas, of which only a smaller visible portion is displayed at any given time. The default value of this property is [0, 0], a value indicating that the minimum virtual dimensions should match the current virtual dimensions.
An integer value that specifies the number of colors (between 2 and 256) to be used if COLOR_MODEL is set to Indexed (1). This property is ignored if COLOR_MODEL is set to RGB (0).
| Note |
An object reference to a palette object (an instance of the IDLgrPalette object class) to specify the red, green, and blue values that are to be loaded into the graphics destination's color lookup table, applicable if the Indexed color model is used.
This property is registered as a user-defined property, but it is hidden by default.
An integer indicating the rendering quality at which graphics are to be drawn to this destination. Valid values are:
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.
An integer value indicating which graphics renderer to use when drawing objects within the window. Valid values are:
By default, IDL uses the value specified in the Graphics tab of the IDLDE Preferences dialog. If the preference is not explicitly set in the IDLDE and your platform has a native OpenGL implementation, IDL uses that implementation as the default. If your platform does not have a native OpenGL implementation, IDL uses its own software implementation regardless of the value of this property. See Hardware vs. Software Rendering for details. Your choice of renderer may also affect the maximum size of an IDLgrWindow object; see Note on Window Size Limits for details.
In a property sheet, this property appears as an enumerated list with the following options:
A floating-point vector of the form [xres, yres] reporting the pixel resolution, measured in centimeters per pixel. This value is stored in double precision.
An integer value that specifies how backing store should be handled for the window. By default, if no value is specified for RETAIN, IDL uses the value of the "Backing Store" preference set in the IDL Development Environment's (IDLDE) Preferences dialog. If there is no preference file for the IDLDE (that is, if you always use IDL in plain tty mode), the RETAIN property is set equal to 0 by default.
In IDL Object Graphics, it is almost always best to disable backing store (that is, set the RETAIN property equal to zero). This is because drawing to an off-screen pixmap (which is what happens when backing store is enabled) almost always bypasses any hardware graphics acceleration that may be available, causing all rendering to be done in software. To ensure that windows are redrawn properly, enable the generation of expose events on the WIDGET_DRAW window and redraw the window explicitly when an expose event is received.
| Note |
In a property sheet, this property appears as an enumerated list with the following options:
A two-element floating-point vector of the form [width, height] specifying the dimensions of the overall screen dimensions for the screen with which this window is associated. The screen dimensions are measured in device units.
| Note |
|
Property Type
|
Floating-point vector
|
||
|
Name String
|
not displayed
|
||
|
Get: Yes
|
Set: No
|
Init: No
|
Registered: No
|
A string that represents the title of the window.
An integer value that indicates the units of measure for the LOCATION and DIMENSIONS properties. Valid values are:
| Note |
In a property sheet, this property appears as an enumerated list with the following options:
A two-element integer vector, [width, height], specifying the dimensions of the virtual canvas for this window. In a scrolling window, the virtual canvas represents the full canvas, of which only a smaller visible portion is displayed at any given time. The default is [0,0], indicating that the virtual canvas dimensions should match the visible dimensions (as specified via the DIMENSIONS property).
This property is registered as a user-defined property, but it is hidden by default.
A two-element integer vector, [x,y], specifying the lower left location of the visible portion of the canvas (relative to the virtual canvas). In a scrolling window, the virtual canvas represents the full canvas, of which only a smaller visible portion is displayed at any given time.
This property is registered as a user-defined property, but it is hidden by default.
A floating-point array representing the zbuffer that is currently within the buffer. The returned array will have dimensions (xdim, ydim).
|
Property Type
|
Floating-point array
|
||
|
Name String
|
not displayed
|
||
|
Get: Yes
|
Set: No
|
Init: No
|
Registered: No
|
A floating point value representing the base value by which the window's current zoom factor will be multiplied or divided for zooming in or zooming out. Allowable values are those greater than 1.0. The default is 2.0.
A named variable that, upon return, will contain an integer that indicates the number of times this window's ZOOM_BASE property has been applied to achieve the current zoom factor. A positive value indicates that the current zoom factor represents the result of zooming in ZOOM_NSTEP times. A negative value indicates that the current zoom factor represents the result of zooming out ZOOM_NSTEP times.
MINIMUM_VIRTUAL_DIMENSIONS, ZOOM_BASE, and ZOOM_NSTEP added: 6.1