Overview

SAS/IML Studio enables you to annotate the high-level statistical graphics with lines, curves, markers, polygons, text, and other planar objects. You can draw these graphical objects in the plot background, in the plot foreground, or in the graph foreground. You can control the color of these objects, and you can set other graphical attributes such as the width and style of pens or the typeface and style of fonts. These objects are drawn by methods of the Plot class.

The drawing methods are composed of two types: those that alter or manipulate the graphical state, and those that draw using the current graphical state. Each method name begins with the prefix "Draw". Methods that draw an object on the screen are named DrawObject. For example, DrawArc draws an arc and DrawPolygon draws a polygon. Methods that change the graphical state are named DrawVerbAttribute where Attribute refers to a portion of the graphical state and Verb describes how it is changing. For example, DrawResetState returns the entire state to its default values and DrawSetPenColor sets the color of the pen.

The available Draw methods are as follows:

DrawArc
Draws an arc, ellipse, or circle.

DrawAxis
Draws an axis with arbitrary ticks and labels.

DrawBeginBlock
Delimits the beginning of a block of drawing commands.

DrawEnableAutoUpdate
Controls automatic window updating.

DrawEndBlock
Delimits the end of a block of drawing commands.

DrawGrid
Draws a set of vertical and horizontal lines.

DrawLine
Draws a series of line segments.

DrawMarker
Draws markers.

DrawNumericAxis
Draws an axis with uniform ticks for a numeric variable.

DrawPath
Draws a series of connected line segments of varying widths and colors.

DrawPolygon
Draws a polygon.

DrawPolygons
Draws multiple polygons.

DrawPopState
Restores a previous graphical state from a stack.

DrawPushState
Saves the current graphical state to a stack.

DrawRectangle
Draws a rectangle.

DrawRemoveCommands
Clears all previous commands.

DrawResetState
Restores the graphical state to its default values.

DrawSetBrushColor
Sets the color of the brush.

DrawSetBrushStyle
Sets the hatching style of the brush.

DrawSetPenColor
Sets the color of the pen.

DrawSetPenStyle
Sets the style (solid, dashed, dotted, etc.) of the pen.

DrawSetPenWidth
Sets the width of the pen.

DrawSetRegion
Sets the current drawing region.

DrawSetTextAlignment
Sets the way that text is positioned about its anchor point.

DrawSetTextAngle
Sets the angle at which text is displayed.

DrawSetTextColor
Sets the color of the text.

DrawSetTextSize
Sets the size of the text.

DrawSetTextStyle
Sets the style (bold, italic, etc.) of the text.

DrawSetTextTypeface
Sets the typeface of the text.

DrawText
Draws text.

DrawUseDataCoordinates
Uses the coordinate system defined by the data.

DrawUseNormalizedCoordinates
Uses a user-defined coordinate system.