Command: grid

Syntax

grid { <window> }

Description

Draw a grid, or turn the auto-grid feature on or off.

Parameters

• <window>
  A window identifier. The window must be a graphic window. If omitted, the current graphic window is used.

Switches

• -col=<color>
  The color of the grid. If not defined, a default foreground color, usually black, is used, unless the -ls option indicates a color.

• -cr
  Display the grid by a mesh of crosses (markers). The default behavior is to display the grid as lines.

• -def
  Compute the grid intervals from the currently viewed model extents. Values are used such that approximately 10 intervals are displayed. This is the default situation for new grids when none of the -x, -y or -z switches are present.

• -dr
  Draw the grid. This is sometimes necessary when the options used do not display it automatically.

• -fo=<font>
  The font to be used for grid ordinate numbers. It must be a scalable font. If not defined, a default scalable font is used.

• -h=<num>
  The height of the grid ordinate numbers. If not defined (or a value of 0), the height is calculated from the window dimensions.

• -lev=<num>
  A Z ordinate indicating the height at which XY plan grids are displayed. For new grids, the default value is zero.

• -ls=<linestyle | color>
  The linestyle of the grid lines. This can be a linestyle or a color. If omitted, continuous lines are displayed. When the -cr option is present, this option is ignored.

• -mh=<num>
  The height of grid markers when the grid style is crosses (-cr).

• -ms=<markerstyle>
  The markerstyle displayed at grid intersections when the grid style is crosses (-cr).

• -oc=<occ>
  An indication of the views on which the grid is to be displayed. For new grids, an occurrence of all plans and elevations is used.

• -off
  Turn the auto-grid off for the window. This also removes the grid layer from the window's layer array.

• -on
  Turn the auto-grid on for the window. This also ensures the presence of a grid layer in the window's layer array.

• -ord
  Display ordinate numbers with the grid. For new grids, the default is not to show them.

• -p1=<point>
  One corner of the grid in 3-D space.

• -p2=<point>
  Another corner of the grid in 3-D space.

If switches -p1 and -p2 are not present, the grid fills the window on orthographic views, or fills a side of the orthogonal box on other views. Use the same values for p1 and p2 if it is a requirement to turn this "partial grid" facility off.

• -tcol=<color>
  The color of the grid ordinate numbers. If not defined, the grid color (-col) is used.

• -th=<num>
  The thickness of the grid lines. If included this will override any thickness defined in the linestyle (-ls). If not defined, no line thickening is done.

• -x=<num>
  The grid interval along the X axis. For new grids the default value is 100.

• -y=<num>
  The grid interval along the Y axis. For new grids the default value is 100.

• -z=<num>
  The grid interval along the Z axis. For new grids the default value is 100.

Notes

If the window is not currently in use, or is not a graphic window, no action is taken.

The grid is drawn automatically if the -on switch is present or if there are no switches present.

Using specific options will change only those particular settings, but when accompanied by the -on switch, all other settings will revert to their default values for a new grid.

Examples

Draw a default grid in window 1.

grid win1

Turn the auto-grid on for all views.

grid my_win,-on,-x=10,-y=20,-ord,-oc=all,-col=green

Just change one setting.

grid my_win, -y=10

See Also