GINO Graphics Suite - GINOGRAF v9.5  

ggSetAxesScaling

Syntax

[C/C++:]
void ggSetAxesScaling(int scale, int nints, float vbeg, float vend,int xory);
[F90:]
subroutine ggSetAxesScaling(scale, nints, vbeg, vend, xory)

integer, intent(in) :: scale, nints, xory
real, intent(in) :: vbeg, vend

Arguments

scale
The type of scaling to be used

= GLINEARTYPE1 Linear scaling automatically calculated from the available axis length. Results in a range which includes vbeg and vend as closely as possible, divided into approximately nints intervals
= GLINEARTYPE2 Linear scaling automatically calculated to
produce precisely nints intervals in a range
including vbeg and vend
= GLINEARTYPE3 Linear scaling selected by the user with precisely nints intervals, vbeg on the first interval and vend on the last interval
= GLOG10 Log10 scaling
= GDISCRETE Discrete axis with nints columns or rows
and tick marks at the column or row centres
nints
The number of intervals on a linear axis, or the number of columns or rows on a discrete axis. The value of nints is irrelevant when used with logarithmic scaling

vbeg
Value specifying the beginning of the range to be included on the axis

vend
Value specifying the end of the range to be included on the axis

xory
Specified axis

= GXAXIS The X axis is defined
= GYAXIS The Y axis is defined

Description

The routine ggSetAxesScaling() defines the scaling characteristics of the last xory axis defined by ggSetAxesPos(), or the default axis if ggSetAxesPos() has not been called. If graphical drawing begins before ggSetAxesScaling() is called, the following defaults are used:

scale  =   GLINEARTYPE3
nints    =   9
vbeg     =   1.0
vend     =   10.0

If, for scale = GLINEARTYPE1, GLINEARTYPE2, GLINEARTYPE3, or GDISCRETE, vbeg = vend, the following defaults are used:

new vbeg = vbeg - 0.5 * (exponent of vbeg)
new vend = vend + 0.5 * (exponent of vend)

If, for scale = GLOG10, vbeg = vend, the following default is used:

vbeg = vbeg/10
vend = 10 * vend

The actual number of intervals and ranges calculated by ggSetAxesScaling() may be enquired through the routine ggEnqAxesScaling().

Successive calls to ggSetAxesScaling() for a particular axis override previous calls for that axis. Coordinates defined in terms of axes set up by ggSetAxesScaling() and ggSetAxesPos() are referred to as graphical axes coordinates.

The effects of ggSetAxesScaling() may be overridden using ggRestoreAxesSettings(), allowing parameters set by ggSetAxesScaling() to be restored to their default values.

See Also

ggSetAxesScaling Usage
ggSetAxesPos
ggRestoreAxesSettings
ggEnqAxesScaling