GDDM V3R2 Base Application Programming Reference
Previous topic | Next topic | Contents | Index | Contact z/OS | Library | PDF | BOOK


Graphics functions

GDDM V3R2 Base Application Programming Reference
SC33-0868-02



Defining the elements in the hierarchy of graphics objects

GSBND
Defines a data boundary.
GSCLP
Enables or disables clipping.
GSCLR
Deletes all graphics from the graphics field.
GSFLD
Defines the graphics field. The default is the entire page.
GSPS
Defines the picture space. The default is the entire graphics field.
GSUWIN
Defines a uniform graphics window such that the aspect ratio of the current viewport is preserved.
GSVIEW
Defines the current viewport. The default is the entire picture space.
GSWIN
Defines the current graphics window. The definition is used for all later graphics operations until it is redefined.

Querying the elements in the hierarchy of graphics objects

GSQBND
Returns the current data boundary definition.
GSQCEL
Returns the default graphics cell size in current window units.
GSQCLP
Returns the current clipping state.
GSQCUR
Returns the cursor position within the current window.
GSQFLD
Returns the position and size of the graphics field.
GSQPS
Returns the current picture space definition.
GSQVIE
Returns the current viewport definition.
GSQWIN
Returns the current window definition.

Specifying attributes of graphics primitives

GSAM
Sets the attribute mode. If attributes are preserved, they may be restored by a call to GSPOP.
GSBMIX
Controls the way that the background color of a primitive is combined with the color of any primitive that it overlaps (background color-mix mode).
GSCA
Specifies a direction angle for the baseline of character strings. Ignored for mode-1 characters.
GSCB
Specifies the character-box size. Ignored for mode 1; controls spacing for mode 2; controls character size and spacing for mode 3.
GSCBS
Specifies the character-box spacing.
GSCD
Specifies the direction at which characters in a string are to be drawn, relative to the baseline direction specified by GSCA.
GSCH
Specifies the current character shear angle. Ignored for mode 1. Only affects positioning for mode 2.
GSCM
Specifies the character mode (mode-1, -2, or -3) to be used for graphics text.
GSCOL
Specifies the current color.
GSCS
Specifies the identifier of the symbol set to be used for graphics text.
GSDEFE
Ends the definition of drawing defaults.
GSDEFS
Starts the definition of drawing defaults.
GSFLW
Sets the current line width as a fractional value.
GSLT
Sets the current line type.
GSLW
Sets the current line width.
GSMB
Sets the size of the marker box.
GSMIX
Controls the way that the color of a primitive is combined with any underlying color (foreground color-mix mode).
GSMS
Specifies the current marker symbol to be used.
GSPAT
Specifies the current shading pattern.
GSPOP
Restores attributes to their previous values if preserved by a prior call to GSAM.
GSSCT
Specifies the current transform for scaling, shear, rotation, and displacement of graphics primitives.
GSSEN
Sets the mixed string attribute to enable double-byte (DBCS) and single-byte (SBCS) character sets to be mixed in the same string in graphics text.
GSSVL
Specifies the segment viewing limits.
GSTA
Specifies the graphics text alignment. This determines the positioning of the character box relative to the character baseline and start point.

Querying graphics primitives attributes and characteristics

GSQAM
Returns the current attribute mode.
GSQBMX
Returns the current background color-mixing mode.
GSQCA
Returns the direction angle for the baseline of character strings.
GSQCB
Returns the character-box size.
GSQCBS
Returns the character-box spacing.
GSQCD
Returns the direction at which characters in a string are drawn, relative to the baseline.
GSQCH
Returns the current character shear angle.
GSQCM
Returns the current character mode.
GSQCOL
Returns the current color.
GSQCP
Returns the current position.
GSQCS
Returns the identifier of the symbol set used for graphics text.
GSQFLW
Returns the current fractional line width.
GSQLT
Returns the current line type.
GSQLW
Returns the current line width.
GSQMB
Returns the size of the marker box.
GSQMIX
Returns the foreground color-mix mode.
GSQMS
Returns the current marker symbol.
GSQPAT
Returns the current shading pattern.
GSQSEN
Returns the graphics text mixed string attribute.
GSQSVL
Returns the segment viewing limits.
GSQTA
Returns the current graphics text alignment.
GSQTB
Queries details of the graphics text box occupied by a specified character string.

Drawing graphics primitives

GSARC
Draws a circular arc about a specified point, starting at the current position and subtending a specified angle.
GSAREA
Starts the construction of a shaded area defined by subsequent line-drawing calls.
GSCHAP
Draws a specified character string starting at the current position.
GSCHAR
Draws a specified character string starting at a specified point. It is equivalent to a call to GSMOVE followed by a call to GSCHAP.
GSCP
Sets the current position to the specified point.
GSELPS
Draws an elliptical arc from the current position to a specified point.
GSENDA
Ends the construction of a shaded area.
GSLINE
Draws a straight line from the current position to a specified point.
GSMARK
Draws a single marker symbol at a specified point.
GSMRKS
Draws a series of marker symbols at specified points.
GSMOVE
Moves the current position to a specified point, without drawing.
GSPFLT
Draws a curved fillet defined by lines joining several points.
GSPLNE
Draws a sequence of lines, starting at the current position and passing through a specified set of points.
GSVECM
Combines moves and lines in any order, for a specified set of points. It is equivalent to a series of GSMOVE and GSLINE calls.

Drawing images

GSIMG
Draws an image at the current position. An image is a dot pattern stored as ones and zeros.
GSIMGS
Draws a scaled image.

Note: Do not confuse these calls with the image calls (see topic 2.7), whose names begin with the letter "I."

Saving and loading the picture

CGSAVE
Saves segments or all the graphics data in the current GDDM page, into a Computer Graphics Metafile (CGM) on auxiliary storage.
CGLOAD
Retrieves a copy of a Computer Graphics Metafile (CGM) from auxiliary storage and loads it into the graphics field on the current GDDM page.
GSGET
Gets one record of graphics data from the current page.
GSGETE
Ends the retrieval of graphics data.
GSGETS
Starts the retrieval of graphics data.
GSLOAD
Retrieves a copy of a graphics data format (GDF) object from the segment library on auxiliary storage and loads it into the current GDDM page.
GSPUT
Puts graphics data into the current graphics viewport.
GSSAVE
Saves segments or all the graphics data from the current GDDM page and puts them into the segment library, as a GDF object, on auxiliary storage.

Subtopics:

Go to the previous page Go to the next page



Copyright IBM Corporation 1990, 2012