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

NAME

6       LINE - draws a line from the point (X1,Y1) to the point (X2,Y2).  The
7       "pen" (for subsequent calls to FRSTPT, VECTOR, PLOTIF, and PLOTIT) is
8       left at (X2,Y2).
9

SYNOPSIS

11       CALL LINE (X1,Y1,X2,Y2)
12

C-BINDING SYNOPSIS

14       #include <ncarg/ncargC.h>
15
16       void c_line (float x1, float y1, float x2, float y2)
17

DESCRIPTION

19       X1          (an input expression of type REAL) defines the X user
20                   coordinate of the starting point of a line segment.
21
22       Y1          (an input expression of type REAL) defines the Y user
23                   coordinate of the starting point of a line segment.
24
25       X2          (an input expression of type REAL) defines the X user
26                   coordinate of the ending point of a line segment.
27
28       Y2          (an input expression of type REAL) defines the Y user
29                   coordinate of the ending point of a line segment.
30

C-BINDING DESCRIPTION

32       The C-binding argument descriptions are the same as the FORTRAN
33       argument descriptions.
34

USAGE

36       Polyline type, line width, and color can be set by calling the GKS
37       routines GSLN, GSLWSC, GSCR, and GSPLCI before calling LINE.
38
39       This routine flushes the SPPS polyline buffer at each line draw.  Thus,
40       polyline attributes can be safely changed between successive calls.
41

EXAMPLES

43       Use the ncargex command to see the following relevant examples: mpex07,
44       mpex09, cbex01, coex01, coex03, epltch, srex01, and tgflas.
45

ACCESS

47       To use LINE or c_line, load the NCAR Graphics libraries ncarg,
48       ncarg_gks, and ncarg_c, preferably in that order.
49

SEE ALSO

51       Online: gpl, gsln, gslwsc, gscr, gsplci, spps, spps_params, frstpt,
52       vector, plotif, curve, ncarg_cbind
53
54       Hardcopy: NCAR Graphics Fundamentals, UNIX Version; User's Guide for
55       NCAR GKS-0A Graphics
56

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