GINO Graphics Suite - GINOGRAF v9.5  

ggAddGraphMarkers

Syntax

[C/C++:]
void ggAddGraphMarkers(int npts, GPOINT *points, int sym, int nspace);
[F90:]
subroutine ggAddGraphMarkers(npts, points, sym, nspace)

integer, intent(in) :: npts, sym, nspace
type(GPOINT), intent(in) :: points(*)

Arguments

npts
The number of points to be plotted

points
Array of dimension npts, giving the X and Y axis values of the points to be defined on the graph

sym
Symbol number to be drawn

= GSPOT }
= GUP }
= GDOWN }
= GPLUS }
= GCROSS } Standard GINO symbols
= GBOX }
= GDIAMOND }
= GCIRCLE }
= GSTAR }
= 9 to 23 Optional hardware symbol
> 23 Character from GINO font table
nspace
Integer, positive or zero, giving the number of points to be left unmarked between each point at which a symbol is drawn

Description

The routine ggAddGraphMarkers() plots a symbol at some or all of the points on a graph within the defined axes. ggAddGraphMarkers() can be used to superimpose symbols on straight line or smooth curve graphs.

The npts points defined in array points are considered, and the symbol sym is drawn at the first point. Each successive symbol is then drawn after an interval of nspace points, eg: if nspace = 3, symbols are drawn at points 1,5,9,13 etc. If nspace is negative, a default of 0 is assumed.

sym is the symbol number that will be drawn at each requested point. The standard nine symbols (0-8) that are available are shown in Appendix A (see Defaults). However, other symbols are available through access to hardware symbols or the GINO font file. Details of this is found in the GINO Manual, Appendix C and the routine gDrawMarker() in the Subroutine Specification chapter. The symbol size is subject to the current GINO character size. If sym is negative a default of GUP is assumed.

Graphs drawn by the routine ggAddGraphMarkers() can be affected by the current missing value mode as set by the routine ggDefineMissingValues().

See Also

ggAddGraphMarkers Usage
ggDefineMissingValues