Data Space Properties

The data space contains the data type(s) displayed within the visualization, plus the axes associated with the data. It is a transparent-walled bounding box by default. When the data space walls are not transparent, some display artifacts may be visible in certain situations. See Rendering Objects at Data Space Depth for more information.

Figure D-10: Visualization Browser with Data Space Properties Displayed

DataSpace.gif

These properties control the visualization of the data space. For each property, the type of control and the values that can be assigned are listed, along with the property identifier and allowed values for use by the iTools Procedural Interface. For a description of how a particular control is used, refer to Property Controls.

Table D-40: Data Space Properties 

Interface:
Property Name
Control Type: Values
API:
Property Identifier
API:
Allowed Values

Isotropic scaling

Scaling method. Select a method from the list. Choose between these values:

  • Automatic: automatic scaling
  • Isotropic: isotropic scaling
  • Anistropic: anistropic scaling

Default = Automatic

Note - If this property is set to Automatic, then:

1. If any visualization within the dataspace has its Isotropic scaling property set to True, the dataspace will be automatically set to isotropic, and the Anisotropic 2D/3D scale properties will be desensitized.

2. If none of the visualizations are isotropic, the dataspace will be automatically set to anisotropic, and the appropriate Anisotropic scale property will be sensitized for either 2D or 3D data.

SCALE_ISOTROPIC

0 (Automatic--default)

1 (Isotropic)

2 (Anistropic)

Anistropic 2D scale

Presentation scale factor applied along Y axis

ANISOTROPIC_SCALE_2D

Floating point

Anistropic 3D scale

Presentation scale factor applied along Z axis

ANISOTROPIC_SCALE_3D

Floating point

Map projection

Default = No projection (click to edit)

None

None

X Minimum

Number: Minimum value for X coordinate of data set.

X_MINIMUM

Floating point

X Maximum

Number: Maximum value for X coordinate of data set.

X_MAXIMUM

Floating point

Y Minimum

Number: Minimum value for Y coordinate of data set.

Y_MINIMUM

Floating point

Y Maximum

Number: Maximum value for Y coordinate of data set.

Y_MAXIMUM

Floating point

Z Minimum

Number: Minimum value for Z coordinate of 3-D data set.

Z_MINIMUM

Floating point

Z Maximum

Number: Maximum value for Z coordinate of 3-D data set.

Z_MAXIMUM

Floating point

Automatic X range

Boolean: Automatically updates the range of X values. Choose True or False. Default = True

X_AUTO_UPDATE

0 (Do not automatically update)

1 (Automatically update--default)

Automatic Y range

Boolean: Automatically updates the range of Y values. Choose True or False. Default = True

Y_AUTO_UPDATE

0 (Do not automatically update)

1 (Automatically update--default)

Automatic Z range

Boolean: Automatically updates the range of Z values. Choose True or False. Default = True

Z_AUTO_UPDATE

0 (Do not automatically update)

1 (Automatically update--default)

X log

Boolean: Determines X axis type. Choose True (logarithmic) or False (linear). Default = False.

XLOG

0 (Linear--default)

1 (Logarithmic)

Y log

Boolean: Determines Y axis type. Choose True (logarithmic) or False (linear). Default = False.

YLOG

0 (Linear--default)

1 (Logarithmic)

Z log

Boolean: Determines Z axis type. Choose True (logarithmic) or False (linear). Default = False.

ZLOG

0 (Linear--default)

1 (Logarithmic)

Color

Color: Data space bounding box border color. Border Style must not be No line. Click to choose from the default color palette, or specify RGB values. Default = [0,0,0] (black)

COLOR

3D integer array of the form:

[R, G, B]

Each color value may range from 0 to 255.

Linestyle

Line Style: Data set bounding box border line style. Select a line style from the list. Default = No line

LINESTYLE

An integer value specifying a predefined line style, or a two-element vector specifying a stippling pattern.

The predefined line styles are:

0 (Solid line--the default)

1 (Dotted)

2 (Dashed)

3 (Dash dot)

4 (Dash dot dot dot)

5 (Long dash)

6 (No line drawn)

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, the line 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).

Thickness

Line Thickness: Data set bounding box border line thickness. Select a thickness from the list. Default = 1.

THICK

A floating-point value between 1.0 (the default) and 10.0.

Fill Background

Boolean: Fills data space background with background color. Choose True or False. Default = True

FILL_BACKGROUND

0 (Do not fill background)

1 (Fill background--default)

Fill Color

Color: Data space background color. Fill Background must be set to True. Click to choose from the default color palette, or specify RGB values. Default = [255, 255, 200] (cream)

FILL_COLOR

3D integer array of the form:

[R, G, B]

Each color value may range from 0 to 255.

Transparency

Number: Transparency of data space background from 0% to 100%. Fill Background must be set to True. Move slider to select a new percentage. Default = 100

TRANSPARENCY

Integer from 0 to 100.

Z value

Number: Z value of plane on which to project. Edit the number to change the value.

ZVALUE

Floating point value

Rendering Objects at Data Space Depth

The depth buffer is a record of the depth at which each pixel of a graphic primitive is rendered on a graphics device. This is typically used to control the visual positioning of objects in front or behind other objects. (See Controlling the Depth of Objects in a View (Object Programming) for more information on depth buffers.)

Data space walls are polygon objects that are transparent by default. In unusual circumstances when the walls are not transparent, and when another object is drawn in the same plane, display artifacts may be visible when the objects are transformed. This results from the normal competition between z-buffer and polygon rasterization operations. To avoid any display artifacts, reposition the object so that it is not in the same plane as the data space wall, or make the wall completely transparent.