GSMATT(3g,L)                AIX Technical Reference                GSMATT(3g,L)



-------------------------------------------------------------------------------
gsmatt



PURPOSE

Sets the polymarker attribute.

C SYNTAX

int gsmatt_ (color, style, width, height, pattern, 0x, 0y)

int *color, *style, *width, *height, *pattern, *0x, *0y;

FORTRAN SYNTAX

INTEGER function gsmatt (color, style, width, height, pattern, 0x, 0y)

INTEGER color, style, width, height, pattern, 0x, 0y

PASCAL SYNTAX

FUNCTION gsmatt_ (

VAR color, style, width, height: INTEGER;
pattern: ARRAY [1..k] of INTEGER;
0x, 0y: INTEGER
): INTEGER [PUBLIC];

DESCRIPTION

The gsmatt subroutine defines the marker for the GSL.

Parameters

color             Refers to a marker color entry in the color map.  If it is
                  -1, the attribute is unchanged.  The default value for color
                  is "7", white.

style             Defines the polymarker style as one of the following:














Processed November 7, 1990       GSMATT(3g,L)                                 1






GSMATT(3g,L)                AIX Technical Reference                GSMATT(3g,L)



                  Value       Display                  Printer or Plotter

                    -1        No change                No Change
                     0        User-defined (by         Not available
                              width,
                              height, pattern, 0x,
                              0y)
                     1        Dot (filled circle)      Point
                     2        Plus (+)                 Plus (+)
                     3        Asterisk (*)             Asterisk (*)
                     4        Circular shape           Square shape
                     5        Cross (*)                Cross (*)
                     6        Unfilled box             Diamond

width, height     Define in pixels the width and the height of the bit pattern
                  to be used as the marker.  If width or height equals -1, then
                  the pattern remains unchanged.

pattern           Defines the image used as a marker.  The ceiling of
                  (width / 32) indicates the number of words per row and height
                  indicates the number of rows.  The marker data must be
                  supplied in row (scan line) major order.  If width implies
                  partial use of a word, the rest of the word is unused.  To
                  fully define the marker pattern, pattern should be
                  (ceiling * height) words in length.

0x, 0y            Indicate the coordinates of the origin of the marker relative
                  to the lower leftmost corner (0, 0) of the marker pattern.
                  The origin must be placed inside the marker pattern, so that
                  0x < width and 0y < height.  The origin of the marker is
                  placed at the position indicated when the application places
                  a marker with the gsplym subroutine.  (See "gsplym.") If 0x
                  equals -1, then the origin remains unchanged.

The maximum size of the marker is device dependent.  It equals the height and
width of the display, which may be determined by calling the gsqdsp subroutine.

Note:  The GSL subroutines do not make a copy of a user-defined polymarker.
       Changes or reuse of the storage where a user-defined shape is in use can
       cause unpredictable results.

For Pascal, the application must declare the arrays passed as being fixed
length and declare the routine as accepting arrays of that length.  The k in
the routine declaration must be a constant.

RETURN VALUE

GS_SUCC  Successful.
GS_COLI  Invalid color index.
GS_PMSZ  Marker size invalid.
GS_PMOR  Marker origin invalid.
GS_PMSY  Marker style invalid.



Processed November 7, 1990       GSMATT(3g,L)                                 2






GSMATT(3g,L)                AIX Technical Reference                GSMATT(3g,L)




RELATED INFORMATION

In this book:  "gsplym."



















































Processed November 7, 1990       GSMATT(3g,L)                                 3