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

NAME

6       GFA (Fill area) - output primitive for filling polygonal areas.
7

SYNOPSIS

9       CALL GFA (N, X, Y)
10

C-BINDING SYNOPSIS

12       #include <ncarg/gks.h>
13
14       void gfill_area(const Gpoint_list *point_list);
15

DESCRIPTION

17       N           (Integer,  Input)  - The number of points in the polygon to
18                   be filled.  N must be greater than two.
19
20       X (N)       (Real Array, Integer) - The  X  world  coordinates  of  the
21                   polygon.
22
23       Y (N)       (Real  Array,  Integer)  -  The  Y world coordinates of the
24                   polygon.
25

USAGE

27       The area to be filled is delimited by the  sequence  of  straight  line
28       segments  connecting the successive points  (X(1), Y(1)), (X(2), Y(2)),
29       ..., (X(N), Y(N)). The last point in the polygon is  connected  to  the
30       first  point with a straight line segment in the case that (X(N), Y(N))
31       does not equal (X(l), Y(l)).
32
33       Given a polygon whose edges cross each other, it becomes  ambiguous  as
34       to what constitutes the "inside" of the polygon.  The algorithm used in
35       GKS is as follows: for a given point, draw a ray starting at that point
36       and  going to infinity in any direction; if the number of intersections
37       between the ray and the polygon is odd, the point is within  the  poly‐
38       gon,  otherwise  it  is outside.  If the straight line passes through a
39       polygon vertex tangentially, the intersection count  is  not  affected.
40       If  a  point  is  within  the polygon, it is included in the area to be
41       filled.
42
43       Several interior styles (hollow, solid, and various hatch patterns) can
44       be selected.  See the man pages for gsfais and gsfasi for these.
45
46       Note  well: By default in GKS, the interior fill style is hollow, or no
47       fill. If you call GFA and do not get a filled interior as you expected,
48       you  will  probably  need to call GSFAIS to set the fill style to some‐
49       thing other than "hollow".
50

ACCESS

52       To use GKS routines, load the NCAR GKS-0A library ncarg_gks.
53

SEE ALSO

55       Online: gsfais, gsfasi, gscr, gsfaci, gqfais, gqfasi, gfill_area
56
57       Hardcopy: User's Guide for NCAR GKS-0A Graphics; NCAR  Graphics  Funda‐
58       mentals, UNIX Version
59

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