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

NAME

6       Softfill - Fills a polygonal subset of the plotter frame.
7

SYNOPSIS

9       SFSGFA - Can be made to fill polygons by calling the GKS routine GFA or
10       by calling the lower-level Softfill routines SFWRLD and SFNORM.
11
12       SFWRLD - Fills polygons with parallel lines or with dots, polymarkers,
13       or selected characters arrayed in a regular rectangular pattern.
14
15       SFNORM - Fills polygons with parallel lines or with dots, polymarkers,
16       or selected characters arrayed in a regular rectangular pattern.
17
18       SFGETC - Retrieves the current character value of a specified internal
19       parameter.
20
21       SFGETI - Retrieves the current integer value of a specified internal
22       parameter.
23
24       SFGETP - Retrieves the current value of the dot pattern.
25
26       SFGETR - Retrieves the current real value of a specified internal
27       parameter.
28
29       SFSETC - Sets the new character value of a specified internal
30       parameter.
31
32       SFSETI - Sets the new integer value of a specified internal parameter.
33
34       SFSETP - Sets the new value of the dot pattern.
35
36       SFSETR - Sets the new real value of a specified internal parameter.
37

C-BINDING SYNOPSIS

39       c_sfsgfa
40       c_sfwrld
41       c_sfnorm
42       c_sfgetc
43       c_sfgeti
44       c_sfgetp
45       c_sfgetr
46       c_sfsetc
47       c_sfseti
48       c_sfsetp
49       c_sfsetr
50

USER-MODIFIABLE INTERNAL ROUTINES

52       None
53

MESSAGES

55       Various error conditions can occur in Softfill.  Each of these results
56       in a call to the error-handling routine SETER, with a final argument
57       indicating that the error is recoverable; by default, an error message
58       is printed and execution is terminated, but, if you turn on error
59       recovery (as described in the "man" page for "error_handling"), you can
60       get control back.
61
62       The error messages are as follows; all should be more or less self-
63       explanatory.
64
65            SFGETC - PARAMETER NAME NOT KNOWN - X
66            SFGETC - PARAMETER NAME TOO SHORT - X
67            SFGETC - UNCLEARED PRIOR ERROR
68            SFGETI - UNCLEARED PRIOR ERROR
69            SFGETP - UNCLEARED PRIOR ERROR
70            SFGETR - PARAMETER NAME NOT KNOWN - X
71            SFGETR - PARAMETER NAME TOO SHORT - X
72            SFGETR - UNCLEARED PRIOR ERROR
73            SFNORM - ARRAY DST IS TOO SMALL
74            SFNORM - ARRAY IND IS TOO SMALL
75            SFNORM - COORDINATE ARRAYS TOO SMALL
76            SFNORM - LOGIC ERROR - SEE SPECIALIST
77            SFNORM - UNCLEARED PRIOR ERROR
78            SFSETC - PARAMETER NAME NOT KNOWN - X
79            SFSETC - PARAMETER NAME TOO SHORT - X
80            SFSETC - UNCLEARED PRIOR ERROR
81            SFSETI - UNCLEARED PRIOR ERROR
82            SFSETP - UNCLEARED PRIOR ERROR
83            SFSETR - PARAMETER NAME NOT KNOWN - X
84            SFSETR - PARAMETER NAME TOO SHORT - X
85            SFSETR - UNCLEARED PRIOR ERROR
86            SFSGFA - ERROR EXIT FROM GQFACI
87            SFSGFA - ERROR EXIT FROM GQPLCI
88            SFSGFA - UNCLEARED PRIOR ERROR
89            SFWRLD - UNCLEARED PRIOR ERROR
90
91       The "LOGIC ERROR" in SFNORM should never occur; if it does, it
92       indicates a compiler problem or some sort of tampering with the code of
93       the package.  Error messages that complain of an error exit from a GKS
94       routine probably imply that GKS has somehow been put in the wrong
95       state.  In the messages that result from using an incorrect internal-
96       parameter name in a call to one of the parameter-access routines, the
97       "X" will be replaced by the offending name.
98

SEE ALSO

100       Online: softfill_params, sfgetc, sfgeti, sfgetp, sfgetr, sfsetc,
101       sfseti, sfsetp, sfsetr, sfsgfa, sfwrld, ncarg_cbind
102
103       Hardcopy: NCAR Graphics Fundamentals, UNIX Version
104

106       Copyright (C) 1987-2007
107       University Corporation for Atmospheric Research
108
109       This documentation is free software; you can redistribute it and/or
110       modify it under the terms of the GNU General Public License as
111       published by the Free Software Foundation; either version 2 of the
112       License, or (at your option) any later version.
113
114       This software is distributed in the hope that it will be useful, but
115       WITHOUT ANY WARRANTY; without even the implied warranty of
116       MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
117       General Public License for more details.
118
119       You should have received a copy of the GNU General Public License along
120       with this software; if not, write to the Free Software Foundation,
121       Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
122
123
124
125UNIX                              March 1993                  Softfill(3NCARG)
Impressum