Contour

Figure D-15: Visualization Browser with Contour Properties Displayed

VizBrowserContour.gif

These properties control contour object visualizations. 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-45: Contour Properties 

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

Grid units

String List: Select a unit from the list. Choose between these values:

  • Not applicable
  • Meters
  • Degrees

GRID_UNITS

0 (Not applicable)

1 (Meters)

2 (Degrees)

Contour level properties

User Defined: Click to edit individual or all contour level properties. Click drop_down.gif and Edit... to display the Contour Levels window. See Contour Levels Window for details.

None

None

Use palette color

Boolean: Use palette color? Choose True or False. Default = False

PAL_COLOR

0 (Do not use palette color)

1 (Use palette color)

Transparency

Number: Percent transparency. Move slider to change value.

Default = 0

TRANSPARENCY

Integer between 0 and 100.

Planar Z Value

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

Note - If the Z value is zero, and the Projection is Planar, then the contour visualization is considered to be 2D. If the Z value is nonzero, then the contour visualization is considered to be 3D, and the dataspace associated with this contour will be automatically switched to 3D.

Default = 0

ZVALUE

Floating point

Number of levels

Number: Number of contour levels to display. Edit the number to change the value. Default = 5

N_LEVELS

Integer

Projection

String List: Method of projection. Select a method from the list. Choose from these values:

  • Three-D: Project in three dimensions
  • Planar: Project onto a plane

Default = Planar

PLANAR

0 (Three-D)

1 (Planar--default)

Fill contours

Boolean: Fill space between contours? Choose True or False. Default = False

FILL

0 (Do not fill space between contours--default)

1 (Fill space between contours)

Shading

String List: Shading method. Select a method from the list. Choose between these values:

  • Flat: Flat shading
  • Gouraud: Gouraud shading

Default = Flat

SHADING

0 (Flat--default)

1 (Gouraud)

Minimum value

Number: Minimum value to display in the contour. Edit number to change value. No default value.

MIN_VALUE

Floating point value

Maximum value

Number: Maximum value to display in the contour. Edit number to change value. No default value.

MAX_VALUE

Floating point value

Downhill ticks

Boolean: Show downhill ticks? Choose Hide or Show. Default = Hide

DOWNHILL

0 (Hide downhill ticks--default)

1 (Show downhill ticks)

Downhill tick interval

Number: Distance between downhill tick marks. Edit number to change value. Default = 0.2

TICKINTERVAL

Floating point

Downhill tick length

Number: Length of downhill tick marks. Edit number to change value. Default = 0.2

TICKLEN

Floating point

Contour Levels Window

Figure D-16: Contour Levels Window

contour_levels.gif

The Contour Levels window contains properties that control the contour levels.

Table D-46: Contour Levels Properties 

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

Value

Number: Value of the contour level. Edit the number to change the value. Default comes from contour data.

MY_VALUE

Floating point value

Color

Color: Color for the contour level. Click to choose from the default color palette, or specify RGB values. Default = [0,0,0] (black)

MY_COLOR

3D integer array of the form:

[R, G, B]

Each color value may range from 0 to 255.

Line style

Line Style: Style for the contour level. Select a style from the list. Default = Contour-50.jpg(solid line)

MY_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).

Line thickness

Line Thickness: Thickness for the contour level. Select a thickness from the list. Default = 1

MY_THICK

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

Label

String List: Choose the kind of label to use for each contour level. Choose from these values:

  • None
  • Value
  • Text
  • Symbol

MY_LABELLING

0 (None)

1 (Value)

2 (Text)

3 (Symbol)

Label interval

Number: Distance between labels on the contour level. Edit number to change value. Default = 0.4

MY_LABEL_INTERVAL

Floating point

No label gaps

Boolean: Interrupt the contour level for the label. Choose True or False. Default = False

MY_LABEL_NOGAPS

0 (False)

1 (True)

Use label color

Boolean: Display a color for the contour level's label. Choose True or False. Default = False

MY_USE_LABEL_COLOR

0 (False)

1 (True)

Label color

Color: Color for the contour level label. Click to choose from the default color palette, or specify RGB values. Default = [0,0,0] (black)

MY_LABEL_COLOR

3D integer array of the form:

[R, G, B]

Each color value may range from 0 to 255.

Symbol label

Symbol: Symbol to appear at regular intervals on the contour level. Choose a symbol from the list. Default = No symbol

MY_LABEL_SYMBOL

0 (No symbol)

1 (Plus sign)

2 (Asterisk)

3 (Period)

4 (Diamond)

5 (Triangle)

6 (Square)

7 (X)

8 (Arrowhead)

Symbol size

Number: Factor from 0 - 1 determining the size of the selected symbol. Move slider to change the size. Default = 0.2

MY_SYMBOL_SIZE

Floating point value from 0 to 1.

Text label

String: Text that labels the contour object in the legend. Edit string to change value. Default = none

MY_LABEL_TEXT

String

Tick format code

String: Text that defines the tick format. Edit string to change format. You can edit this value only if Tick Format is set to Use Tick Format Code. Default = none

TICKFORMAT

String

Tick format

String List: Choose a format code or time interval to use for each tick interval. Choose from these values:

  • None
  • Use Tick Format Code
  • Filled Fixed Width Integer
  • Freeform Integer or Float
  • Float with 2 or 4 decimal places
  • Exponential with 2 or 4 decimal places
  • Date (13 formats)
  • Time (11 formats)

Default = None

TICK_DEFINEDFORMAT

0 (None)

1 (Use tick format code)

2 (Filled fixed-width integer)

3 (Freeform integer or float)

4 (Float with two or four decimal places)

5 (Exponential with two or four decimal places)

6 (Date)

7 (Time)

Text font

String List: Font used for label text. Select a font from the list. Choose from these values:

  • Helvetica
  • Courier
  • Times
  • Symbol
  • Hershey

Default = Helvetica

FONT_INDEX

0 (Helvetica--default)

1 (Courier)

2 (Times)

3 (Symbol)

4 (Hershey)

Text style

String List: Style used for label text. Select a style from the list. Choose from these values:

  • Normal
  • Bold
  • Italic
  • Bold italic

Default = Normal

FONT_STYLE

0 (Normal--default)

1 (Bold)

2 (Italic)

3 (Bold italic)

Text font size

Number: Font size in points for the label text. Edit the number to change the size. Default = 9

FONT_SIZE

Integer