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, 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:
Value Display Printer or Plotter
-1 No change No Change
0 User-defined (by width, Not available
height, pattern, 0x, 0y)
1 Dot (filled circle) Point
2 Plus (+) Plus (+)
Value Display Printer or Plotter
3 Asterisk (*) Asterisk (*)
4 Circular shape Square shape
5 Cross (S) Cross (S)
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(width / 32)) S 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 unpredict-
able 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.
Related Information
In this book: "gsplym."