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

NAME

6       NGRITD - Given the coordinates of a point, this routine performs a
7       rotation of that point about a specified axis by a specified angle.
8

SYNOPSIS

10       CALL NGRITD (IAXS,ANGL,UCRD,VCRD,WCRD)
11

C-BINDING SYNOPSIS

13       #include <ncarg/ncargC.h>
14
15       void c_ngritd(int iaxs, float angl, float *ucrd, float *ycrd,
16       float *wcrd)
17

DESCRIPTION

19       IAXS        (an input expression of type INTEGER) specifies the axis
20                   about which rotation is to be done (1 for the U axis, 2 for
21                   the V axis, and 3 for the W axis).
22
23       ANGL        (an input expression of type REAL) specifies the magnitude,
24                   in degrees, of the rotation angle.
25
26       UCRD        (an input/output variable of type REAL) specifies the U
27                   coordinate of the point being rotated.
28
29       VCRD        (an input/output variable of type REAL) specifies the V
30                   coordinate of the point being rotated.
31
32       WCRD        (an input/output variable of type REAL) specifies the W
33                   coordinate of the point being rotated.
34

C-BINDING DESCRIPTION

36       The C binding argument descriptions are the same as the FORTRAN
37       argument descriptions.
38

USAGE

40       This routine is used by NGGCOG and NGGSOG to effect the rotations that
41       are used to generate an object of a specified shape at a specified
42       point on the surface of the globe.
43
44       NGRITD assumes that the UVW coordinate system is right-handed.
45       Positive values of ANGL give counter-clockwise rotations and negative
46       values of ANGL give clockwise rotations.  (When IAXS = 1, ANGL = 90
47       carries the positive V axis into the positive W axis; when IAXS = 2,
48       ANGL = 90 carries the positive W axis into the positive U axis; when
49       IAXS = 3, ANGL = 90 carries the positive U axis into the positive V
50       axis.)
51

EXAMPLES

53       Use the ncargex command to see the following relevant example: cpex10.
54

ACCESS

56       To use NGRITD or c_ngritd, load the NCAR Graphics libraries ncarg,
57       ncarg_gks, and ncarg_c, preferably in that order.
58

MESSAGES

60       None.
61

SEE ALSO

63       Online: nggcog(3NCARG), nggsog(3NCARG).
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                    NGRITD(3NCARG)
Impressum