ncl_sfgetp man page

SFGETP — Used to retrieve the current dot pattern.

Synopsis

CALL SFGETP (IDP)

C-Binding Synopsis

#include <ncarg/ncargC.h>

void c_sfgetp (int idp[8][8])

Description

IDP

(an output array of type INTEGER, dimensioned 8x8) contains 0s and 1s specifying the dot pattern currently contained in the internal array LDP. When dot fill is selected, each fill line is drawn using dots the same distance apart along the line as the lines are from each other. The dots thus fall at the intersection points of a square grid. Each dot is associated with a particular element of LDP. If that element is a 1, the dot is drawn; if it is a 0, the dot is not drawn. The association is done in such a way as to replicate the pattern specified by LDP across the entire filled area.

If the fill angle is 0 (the default), then incrementing the first subscript of LDP corresponds to a horizontal motion across the plot from left to right and incrementing the second subscript of LDP corresponds to a vertical motion across the plot from top to bottom. This allows the contents of IDP to be declared in a DATA statement which creates a "picture" of the pattern. For example, the FORTRAN statements

DIMENSION IDP(8,8)
...
DATA IDP / 0,0,0,0,0,0,0,0,
+ 0,1,1,1,1,1,1,0,
+ 0,1,0,0,0,0,0,1,
+ 0,1,0,0,0,0,0,1,
+ 0,1,1,1,1,1,1,0,
+ 0,1,0,0,0,1,0,0,
+ 0,1,0,0,0,0,1,0,
+ 0,1,0,0,0,0,0,1/

creates the letter "R", with the correct orientation.

The default dot pattern consists of all 1s.

Usage

This routine allows you to retrieve the current value of Softfill's dot pattern. For a description of Softfill's dot pattern parameter, see the softfill_params man page.

Access

To use SFGETP or c_sfgetp, load the NCAR Graphics libraries ncarg, ncarg_gks, and ncarg_c, preferably in that order.

See Also

Online: softfill, softfill_params, sfgetc, sfgeti, sfgetr, sfsetc, sfseti, sfsetp, sfsetr, sfsgfa, sfwrld, ncarg_cbind

Hardcopy: NCAR Graphics Fundamentals, UNIX Version

Info

March 1993 UNIX NCAR GRAPHICS