ncl_softfill - Man Page
Fills a polygonal subset of the plotter frame.
Synopsis
SFSGFA - Can be made to fill polygons by calling the GKS routine GFA or by calling the lower-level Softfill routines SFWRLD and SFNORM.
SFWRLD - Fills polygons with parallel lines or with dots, polymarkers, or selected characters arrayed in a regular rectangular pattern.
SFNORM - Fills polygons with parallel lines or with dots, polymarkers, or selected characters arrayed in a regular rectangular pattern.
SFGETC - Retrieves the current character value of a specified internal parameter.
SFGETI - Retrieves the current integer value of a specified internal parameter.
SFGETP - Retrieves the current value of the dot pattern.
SFGETR - Retrieves the current real value of a specified internal parameter.
SFSETC - Sets the new character value of a specified internal parameter.
SFSETI - Sets the new integer value of a specified internal parameter.
SFSETP - Sets the new value of the dot pattern.
SFSETR - Sets the new real value of a specified internal parameter.
C-Binding Synopsis
c_sfsgfa
c_sfwrld
c_sfnorm
c_sfgetc
c_sfgeti
c_sfgetp
c_sfgetr
c_sfsetc
c_sfseti
c_sfsetp
c_sfsetr
User-Modifiable Internal Routines
None
Messages
Various error conditions can occur in Softfill. Each of these results in a call to the error-handling routine SETER, with a final argument indicating that the error is recoverable; by default, an error message is printed and execution is terminated, but, if you turn on error recovery (as described in the "man" page for "error_handling"), you can get control back.
The error messages are as follows; all should be more or less self-explanatory.
SFGETC - PARAMETER NAME NOT KNOWN - X
SFGETC - PARAMETER NAME TOO SHORT - X
SFGETC - UNCLEARED PRIOR ERROR
SFGETI - UNCLEARED PRIOR ERROR
SFGETP - UNCLEARED PRIOR ERROR
SFGETR - PARAMETER NAME NOT KNOWN - X
SFGETR - PARAMETER NAME TOO SHORT - X
SFGETR - UNCLEARED PRIOR ERROR
SFNORM - ARRAY DST IS TOO SMALL
SFNORM - ARRAY IND IS TOO SMALL
SFNORM - COORDINATE ARRAYS TOO SMALL
SFNORM - LOGIC ERROR - SEE SPECIALIST
SFNORM - UNCLEARED PRIOR ERROR
SFSETC - PARAMETER NAME NOT KNOWN - X
SFSETC - PARAMETER NAME TOO SHORT - X
SFSETC - UNCLEARED PRIOR ERROR
SFSETI - UNCLEARED PRIOR ERROR
SFSETP - UNCLEARED PRIOR ERROR
SFSETR - PARAMETER NAME NOT KNOWN - X
SFSETR - PARAMETER NAME TOO SHORT - X
SFSETR - UNCLEARED PRIOR ERROR
SFSGFA - ERROR EXIT FROM GQFACI
SFSGFA - ERROR EXIT FROM GQPLCI
SFSGFA - UNCLEARED PRIOR ERROR
SFWRLD - UNCLEARED PRIOR ERROR
The "LOGIC ERROR" in SFNORM should never occur; if it does, it indicates a compiler problem or some sort of tampering with the code of the package. Error messages that complain of an error exit from a GKS routine probably imply that GKS has somehow been put in the wrong state. In the messages that result from using an incorrect internal-parameter name in a call to one of the parameter-access routines, the "X" will be replaced by the offending name.
See Also
Online: softfill_params, sfgetc, sfgeti, sfgetp, sfgetr, sfsetc, sfseti, sfsetp, sfsetr, sfsgfa, sfwrld, ncarg_cbind
Hardcopy: NCAR Graphics Fundamentals, UNIX Version
Copyright
Copyright (C) 1987-2009
University Corporation for Atmospheric Research
The use of this Software is governed by a License Agreement.