1MXMY(3NCARG)                     NCAR GRAPHICS                    MXMY(3NCARG)
2
3
4

NAME

6       MXMY - Retrieves the current pen position in the Plotter Address Unit
7       (PAU) coordinate system.
8

STATUS

10       Plotter Address Units (PAUs) are not being used in new NCAR Graphics
11       routines; thus, MXMY is considered an obsolete routine.
12
13       The current recognized coordinate systems are GKS world coordinates,
14       GKS normalized device coordinates, NCAR Graphics fractional
15       coordinates, and NCAR Graphics user coordinates.  See the NCAR Graphics
16       document "NCAR Graphics Fundamentals, UNIX Version" for a description
17       of these coordinate systems.
18
19       MXMY continues to be provided for compatibility of early NCAR Graphics
20       codes.  Frequently, consecutive calls to FRSTPT and MXMY were used to
21       effectively convert from user coordinates to plotter coordinates; for
22       this purpose, the functions KUPX and KUPY may be used instead.  If you
23       are writing new code, you could keep track of the pen location through
24       internal bookkeeping.  Better, though, would be to use fractional
25       coordinates for the purposes to which plotter coordinates were put; the
26       functions CFUX, CFUY, CUFX, and CUFY allow for conversions between user
27       coordinates and fractional coordinates.
28
29       The following definition of the PAU Coordinate System is included for
30       the purpose of interpreting and converting PAU codes:
31
32       The plotter coordinates of a point are integers IPX and IPY, where IPX
33       is between 1 and 2**MX and IPY is between 1 and 2**MY.  MX and MY are
34       internal parameters of SPPS; each has the default value 10.  Values of
35       MX and MY can be set by routine SETI and retrieved by routine GETSI.
36

SYNOPSIS

38       CALL MXMY (IX,IY)
39

DESCRIPTION

41       IX          (an output variable of type INTEGER) is the X coordinate of
42                   the pen position in PAUs.
43
44       IY          (an output variable of type INTEGER) is the Y coordinate of
45                   the pen position in PAUs.
46

USAGE

48       The routines CURVE, FRSTPT, LINE, PLOTIF, PLOTIT, POINT, POINTS, and
49       VECTOR update the pen position for subsequent MXMY retrieval.  ALso,
50       the routines PWRIT and WTSTR leave the pen position at the location
51       specified by their first two arguments.
52

ACCESS

54       To use MXMY, load the NCAR Graphics libraries ncarg, ncarg_gks, and
55       ncarg_c, preferably in that order.
56

SEE ALSO

58       Online: curve, frstpt, line, plotit, point, points, pwrit, vector,
59       seti, getsi, cpfx, cpfy, cpux, cpuy, kfpx, kfpy, kpmx, kpmy, kmpx,
60       kmpy, kupx, kupy, spps, spps_converters
61
62       Hardcopy: NCAR Graphics Fundamentals, UNIX Version; User's Guide for
63       NCAR GKS-0A Graphics
64

66       Copyright (C) 1987-2007
67       University Corporation for Atmospheric Research
68
69       This documentation is free software; you can redistribute it and/or
70       modify it under the terms of the GNU General Public License as
71       published by the Free Software Foundation; either version 2 of the
72       License, or (at your option) any later version.
73
74       This software is distributed in the hope that it will be useful, but
75       WITHOUT ANY WARRANTY; without even the implied warranty of
76       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
77       General Public License for more details.
78
79       You should have received a copy of the GNU General Public License along
80       with this software; if not, write to the Free Software Foundation,
81       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
82
83
84
85UNIX                              March 1993                      MXMY(3NCARG)
Impressum