AST_CLIP

Set up or remove clipping for a Plot

Description:

This routine defines regions of a Plot which are to be clipped. Any subsequent graphical output created using the Plot will then be visible only within the unclipped regions of the plotting area. See also the Clip attribute.

Invocation

CALL AST_CLIP( THIS, IFRAME, LBND, UBND, STATUS )

Arguments

THIS = INTEGER (Given)
Pointer to the Plot.
IFRAME = INTEGER (Given)
The index of the Frame within the Plot to which the clipping limits supplied in LBND and UBND (below) refer. Clipping may be applied to any of the coordinate systems associated with a Plot (as defined by the Frames it contains), so this index may take any value from 1 to the number of Frames in the Plot (Nframe attribute). In addition, the values AST__BASE and AST__CURRENT may be used to specify the base and current Frames respectively.

For example, a value of AST__CURRENT causes clipping to be performed in physical coordinates, while a value of AST__BASE would clip in graphical coordinates. Clipping may also be removed completely by giving a value of AST__NOFRAME. In this case any clipping bounds supplied (below) are ignored.

LBND( ) = DOUBLE PRECISION (Given)
An array with one element for each axis of the clipping Frame (identified by the index IFRAME). This should contain the lower bound, on each axis, of the region which is to remain visible (unclipped).
UBND( ) = DOUBLE PRECISION (Given)
An array with one element for each axis of the clipping Frame (identified by the index IFRAME). This should contain the upper bound, on each axis, of the region which is to remain visible (unclipped).
STATUS = INTEGER (Given and Returned)
The global status.

Notes: