1SFSETP(3NCARG) NCAR GRAPHICS SFSETP(3NCARG)
2
6 SFSETP - Defines a new dot pattern.
7
9 CALL SFSETP (IDP)
10
12 #include <ncarg/ncargC.h>
13 void c_sfsetp (int idp[8][8])
15
17 IDP (an input array of type INTEGER, dimensioned 8x8) contains
18 0s and 1s specifying the dot pattern to be transferred to
19 the internal array LDP for use by SFWRLD and SFNORM. When
20 dot fill is selected, each fill line is drawn using dots
21 the same distance apart along the line as the lines are
22 from each other. The dots thus fall at the intersection
23 points of a square grid. Each dot is associated with a
24 particular element of LDP. If that element is a 1, the dot
25 is drawn; if it is a 0, the dot is not drawn. The
26 association is done in such a way as to replicate the
27 pattern specified by LDP across the entire filled area.
28 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 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 creates the letter "R", with the correct orientation.
50 The contents of the array IDP are transferred to the
52 internal array LDP. The new dot pattern is used until a
53 subsequent call to SFSETP changes the contents of LDP
54 again.
55 The default dot pattern consists of all 1s.
57
59 The C-binding argument description is the same as the FORTRAN argument
60 description.
61
63 This routine allows you to set the current value of Softfill's dot
64 pattern. For a description of Softfill's dot pattern parameter, see the
65 softfill_params man page.
66
68 Use the ncargex command to see the following relevant examples: sfex01,
69 tsoftf.
70
72 To use SFSETP or c_sfsetp, load the NCAR Graphics libraries ncarg,
73 ncarg_gks, and ncarg_c, preferably in that order.
74
76 Online: softfill, softfill_params, sfgetc, sfgeti, sfgetp, sfgetr,
77 sfsetc, sfseti, sfsetr, sfsgfa, sfwrld, ncarg_cbind
78 Hardcopy: NCAR Graphics Fundamentals, UNIX Version
80
82 Copyright (C) 1987-2007
83 University Corporation for Atmospheric Research
84 This documentation is free software; you can redistribute it and/or
86 modify it under the terms of the GNU General Public License as
87 published by the Free Software Foundation; either version 2 of the
88 License, or (at your option) any later version.
89 This software is distributed in the hope that it will be useful, but
91 WITHOUT ANY WARRANTY; without even the implied warranty of
92 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
93 General Public License for more details.
94 You should have received a copy of the GNU General Public License along
96 with this software; if not, write to the Free Software Foundation,
97 Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
98UNIX March 1993 SFSETP(3NCARG)