Map Grid

Figure D-28: Visualization Browser with
Map Grid Object Properties Displayed

VizBrowserMapGrid.gif

These properties control map grid 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-58: Property Settings for Map Grid 

Interface:
Property Name
Description
API:
Property Identifier
API:
Allowed Values

Automatic grid

Boolean: Automatically compute the grid range and spacing. Choose True or False. Default = True

Note - If a SAVE file is restored from an IDL version prior to 6.2, this property is set to False.

AUTO_GRID

0 (Do not automatically compute the grid range and spacing)

1 (Automatically compute the grid range and spacing)

Longitude minimum (deg)

Number: Minimum longitude, in degrees, to include in the grid

LONGITUDE_MIN

Floating point

Longitude maximum (deg)

Number: Maximum longitude, in degrees, to include in the grid

LONGITUDE_MAX

Floating point

Latitude minimum (deg)

Number: Minimum latitude, in degrees, to include in the grid

LATITUDE_MIN

Floating point

Latitude maximum (deg)

Number: Maximum latitude, in degrees, to include in the grid

LATITUDE_MAX

Floating point

Longitude spacing

Number: Longitude grid spacing, in degrees

GRID_LONGITUDE

Floating point

Latitude spacing

Number: Latitude grid spacing, in degrees

GRID_LATITUDE

Floating point

Longitude lines

User Defined: Click to edit individual or all longitude line properties. Click drop_down.gif and Edit... to display the Map Grid Lines dialog.

map_grid_lines_long.gif

Various

The map gridline property names and values are the same as those in the rest of this (Map Grid) table.

Latitude lines

User Defined: Click to edit individual or all latitude line properties. Click drop_down.gif and Edit... to display the Map Grid Lines dialog.

map_grid_lines_lat.gif

Various

The map gridline property names and values are the same as those in the rest of this (Map Grid) table.

Color

Color: Color for the grid lines. 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.

Line style

Line Style: Style of the map grid line. Select a line style from the list. Default = Map_Grid-56.jpg(solid 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: Thickness for the grid lines. Select a thickness from the list. Default = 1

THICK

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

Transparency

Number: Transparency of the grid lines from 0% to 100%. Move the slider to change the value. Default = 0

TRANSPARENCY

Integer from 0 to 100.

Label

Boolean: Use labels on the grid lines. Choose True or False. Default = True

LABEL_SHOW

0 (Do not use labels on the grid lines)

1 (Use labels on the grid lines)

Label position

Number: Normalized label position. Default = 0.5

LABEL_POSITION

Floating point

Use label color

Boolean: Use default color instead of Label color. Choose True or False. Default = False

LABEL_USE_COLOR

0 (Use label color)

1 (Use default color instead of label color)

Label color

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

LABEL_COLOR

3D integer array of the form:

[R, G, B]

Each color value may range from 0 to 255.

Label fill background

String List: Choose the kind of fill background for the label. Choose from these values:

  • None
  • View color
  • Fill color

LABEL_FILL_BACKGROUND

Integer value from 0 to 2.

Label fill color

Color: Color for the label background's fill. Click to choose from the default color palette, or specify RGB values. Default = [255, 255, 255] (white)

LABEL_FILL_COLOR

3D integer array of the form:

[R, G, B]

Each color value may range from 0 to 255.

Z value

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

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

Default = 0

ZVALUE

Floating point

Text font

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

  • Helvetica
  • Courier
  • Times
  • Symbol
  • Hershey 3 Simplex

In addition to the above standard fonts, you will also have available all of the other Hershey fonts as well as any TrueType fonts available to IDL.

Default = Helvetica

FONT_INDEX

The following values are valid for all platforms:

0 (Helvetica--default)

1 (Courier)

2 (Times)

3 (Symbol)

4 (Hershey 3 Simplex)

There may be other Hershey and TrueType fonts available, but the list values are system-dependent.

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 = 12

FONT_SIZE

Integer

The Map Grid Lines dialog displays a property sheet for the longitude or latitude lines, depending on which set you want to edit. This sheet includes the same properties as the overall Map Grid object, from Color to Text font size.