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

NAME

6       SFGETP - Used to retrieve the current dot pattern.
7

SYNOPSIS

9       CALL SFGETP (IDP)
10

C-BINDING SYNOPSIS

12       #include <ncarg/ncargC.h>
13
14       void c_sfgetp (int idp[8][8])
15

DESCRIPTION

17       IDP         (an output array of type INTEGER, dimensioned 8x8) contains
18                   0s and 1s specifying the dot pattern currently contained in
19                   the internal array LDP. When dot fill is selected, each
20                   fill line is drawn using dots the same distance apart along
21                   the line as the lines are from each other. The dots thus
22                   fall at the intersection points of a square grid. Each dot
23                   is associated with a particular element of LDP. If that
24                   element is a 1, the dot is drawn; if it is a 0, the dot is
25                   not drawn. The association is done in such a way as to
26                   replicate the pattern specified by LDP across the entire
27                   filled area.
28
29                   If the fill angle is 0 (the default), then incrementing the
30                   first subscript of LDP corresponds to a horizontal motion
31                   across the plot from left to right and incrementing the
32                   second subscript of LDP corresponds to a vertical motion
33                   across the plot from top to bottom. This allows the
34                   contents of IDP to be declared in a DATA statement which
35                   creates a "picture" of the pattern. For example, the
36                   FORTRAN statements
37
38                        DIMENSION IDP(8,8)
39                        ...
40                        DATA IDP / 0,0,0,0,0,0,0,0,
41                       +           0,1,1,1,1,1,1,0,
42                       +           0,1,0,0,0,0,0,1,
43                       +           0,1,0,0,0,0,0,1,
44                       +           0,1,1,1,1,1,1,0,
45                       +           0,1,0,0,0,1,0,0,
46                       +           0,1,0,0,0,0,1,0,
47                       +           0,1,0,0,0,0,0,1/
48
49                   creates the letter "R", with the correct orientation.
50
51                   The default dot pattern consists of all 1s.
52

USAGE

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

ACCESS

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

SEE ALSO

63       Online: softfill, softfill_params, sfgetc, sfgeti, sfgetr, sfsetc,
64       sfseti, sfsetp, sfsetr, sfsgfa, sfwrld, ncarg_cbind
65
66       Hardcopy: NCAR Graphics Fundamentals, UNIX Version
67

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