KPG1_MKPOS

Marks a position on a graphics device

Description:

This routine marks a position on a graphics device in various ways.

Invocation

CALL KPG1_MKPOS( NAX, POS, IPLOT, CURR, MODE, MARKER, GEO, DONE, CLOSE, TEXT, JUST, REGION, STATUS )

Arguments

NAX = INTEGER (Given)
The number of co-ordinate values supplied in POS. This should be equal to the number of axes in the Frame specified by CURR.
POS( NAX ) = DOUBLE PRECISION (Given)
The co-ordinates of the position, in the Frame specified by CURR. No marker is drawn if a AST__BAD or VAL__BADD value is supplied Ignored if DONE is .TRUE., and MODE is " POLY" , " CHAIN" or " BOX" .
IPLOT = INTEGER (Given)
An AST pointer to a Plot. The same Plot should be supplied for all points in a polygon, chain, or set of boxes.
CURR = LOGICAL (Given)
If .TRUE., then position supplied in POS refers to the Current Frame in IPLOT. Otherwise it refers to the Base Frame (which should be the GRAPHICS Frame).
MODE = CHARACTER ( ) (Given)
The type of marker to produce (case sensitive, no abbreviations):
  • " NONE" – An immediate return is made without any graphics being drawn.

  • " MARK" – Each position is marked by the symbol specified by argument MARKER.

  • " POLY" – Causes each position to be joined by a line to the previous position marked. These lines may be geodesic (in the Current Frame of the Plot) or straight (on the screen), as specified by argument GEO.

  • " CHAIN" – This is a combination of " Mark" and " Poly" . Each position is marked by a symbol and joined by a line to the previous position. Arguments MARKER, GEO, and CLOSE are used to specify the symbols and lines to use.

  • " BOX" – An empty rectangle with edges parallel to the axes is drawn extending between the supplied position and the previous position.

  • " VLINE" – A vertical line is drawn through the position covering the entire height of the Plot.

  • " HLINE" – A horizontal line is drawn through the position covering the entire height of the Plot.

  • " CROSS" – A full-screen cross-hair is drawn at the position, i.e. a combination of Vline and Hline.

  • " TEXT" – The text string specified by argument TEXT is displayed, horizontally, and centred on the supplied position.

  • " BLANK" – Nothing is drawn.

  • " REGION" – The AST Region given by REGION is outlined.

MARKER = INTEGER (Given)
The PGPLOT marker type to use if MODE is " MARKER" or " CHAIN" .
GEO = LOGICAL (Given)
Should polygon and chain line segments be drawn as geodesic curves within the Current Frame of the Plot? If not they are drawn as simple straight lines within the Base Frame (GRAPHICS). The same value should be supplied for all points in a polygon or chain.
DONE = LOGICAL (Given)
Should be supplied .TRUE. when a polygon, chain or set of boxes has been completed. The contents of POS will be ignored in this case. DONE is ignored if MODE is not " PLOT" , " CHAIN" or " BOX" .
CLOSE = LOGICAL (Given)
If .TRUE., polygons and chains are closed by joining the first position to the last position (when DONE is supplied .TRUE.).
TEXT = CHARACTER ( ) (Given)
The text to display if MODE is " TEXT" . Trailing spaces are ignored.
JUST = CHARACTER ( ) (Given)
A string specifying the justification to be used when displaying the text supplied in TEXT (ignored if MODE is not " Text" ). This should be a string of two characters; the first should be " B" , " C" or " T" , meaning bottom, centre or top. The second should be " L" , " C" or " R" , meaning left, centre or right. The text is displayed so that the position supplied in POS is at the specified point within the displayed text string.
REGION = INTEGER (Given)
A two-dimensional AST Region pointer. Only used if PLOT is " REGION" . In order to save time calling AST_CONVERT for every Region, the first Region to be plotted using this routine defines the co-ordinate frame for all subsequent Regions draw by later invocations of this routine. If in fact, later Regions may have a different co-ordinate frame, then this routine should be called with MODE=REGION and REGION=AST__NULL. This will cause the current Region co-ordinate frame to be forgotten so that the next non-NULL Region to be draw will define a new current co-ordinate frame for subsequent Regions.
STATUS = INTEGER (Given and Returned)
The global status.