ncl_getsi (3) - Linux Manuals

ncl_getsi: returns the exponents which define the plotting range

NAME

GETSI - returns the exponents which define the plotting range in the plotter address unit coordinate system.

STATUS

Plotter Address Units (PAUs) are no longer used in NCAR Graphics; thus, GETSI is considered an obsolete routine.

The current recognized coordinate systems are GKS world coordinates, GKS normalized device coordinates, NCAR Graphics fractional coordinates, and NCAR Graphics user coordinates. See the NCAR Graphics document "The Use of X/Y Coordinates in NCAR Graphics" for a description of these coordinate systems.

GETSI continues to be provided for compatibility of early NCAR Graphics codes.

The following definition of the PAU Coordinate System is included for the purpose of interpreting and converting PAU codes:

The plotter coordinates of a point are integers IPX and IPY, where IPX is between 1 and 2**MX and IPY is between 1 and 2**MY. MX and MY are internal parameters of SPPS; each has the default value 10. Values of MX and MY can be set by routine SETI and retrieved by routine GETSI.

SYNOPSIS

CALL GETSI (IX,IY)

DESCRIPTION

IX

(an output variable of type INTEGER) is the X axis exponent for plotter coordinates defining a range of 1 to 2**IX - 1. IX has a default value of 10.

IY

(an output variable of type INTEGER) is the Y axis exponent for plotter coordinates defining a range of 1 to 2**IY - 1. IY has a default value of 10.

ACCESS

To use GETSI, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order.

COPYRIGHT

Copyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.