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

NAME

6       SFSETP - Defines a new dot pattern.
7

SYNOPSIS

9       CALL SFSETP (IDP)
10

C-BINDING SYNOPSIS

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

DESCRIPTION

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
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 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
56                   The default dot pattern consists of all 1s.
57

C-BINDING DESCRIPTION

59       The C-binding argument description is the same as the FORTRAN argument
60       description.
61

USAGE

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

EXAMPLES

68       Use the ncargex command to see the following relevant examples: sfex01,
69       tsoftf.
70

ACCESS

72       To use SFSETP or c_sfsetp, load the NCAR Graphics libraries ncarg,
73       ncarg_gks, and ncarg_c, preferably in that order.
74

SEE ALSO

76       Online: softfill, softfill_params, sfgetc, sfgeti, sfgetp, sfgetr,
77       sfsetc, sfseti, sfsetr, sfsgfa, sfwrld, ncarg_cbind
78
79       Hardcopy: NCAR Graphics Fundamentals, UNIX Version
80
82       Copyright (C) 1987-2009
83       University Corporation for Atmospheric Research
84       The use of this Software is governed by a License Agreement.
85
86
87
88UNIX                              March 1993                    SFSETP(3NCARG)
Impressum