NAME

       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

COPYRIGHT

       Copyright (C) 1987-2009
       University Corporation for Atmospheric Research

       The use of this Software is governed by a License Agreement.

UNIX                                               March 1993                                     SFGETP(3NCARG)