Command: box

Syntax

box { <window> }

Description

Define the orthogonal box for a window.

Parameters

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

Switches

• -cu
  Make the box a cube. The default is not a cube.

• -draw
  Redraw the window contents using the new box value. The default behavior is not to.

• -ma=<num>
  A margin by which to extend the box on all sides.

• -mf=<num>
  A percentage by which to extend the box on all sides. The percentage is applied to all three box dimensions.

• -wb=<points>
  Two 3-D points defining opposite corners of the new box. If these are omitted, the box will be computed from the extremities of the current model.

Notes

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

The -ma option takes precedence over the -mf option.

If no points are defined and no margin specification is given, the values of the system numerics box_margin or box_factor are used to add a margin. At system startup, box_margin has the value of 0 (no margin), but box_factor has a value of 5 (percentage factor of 5%).

When determining which entities are used to compute the box, entities on a window's overlay group are excluded, unless they are also members of the window's display group(s).

Examples

Compute the box from the current model extremities and repaint.

box win1, -draw

Compute from model extremities without margin.

box ww, -mf=0, -cu

Define a precise box.

box my_window, -wb=<(50,50,50),(950,950,950)>

See Also