Please enable JavaScript to view this site.

A-Shell Reference

Note: SETPEN has been succeeded by SETPENEX, which offers a greater range of options. Although SETPEN is supported, SETPENEX should be used unless there is a good reason for not doing so.

//SETPEN, style, thickness {,r, g, b}

SETPEN selects a "pen" (line thickness and style) for subsequent line drawing operations—e.g. LINETO and RECTANGLE

Parameters

style

Select one of the following:

Value

Description

0

Solid (default)

1

Dash (only valid when pen thickness is 1)

2

Dot (only valid when pen thickness is 1)

3

Dash-Dot (only valid when pen thickness is 1)

4

Dash-Dot-Dot (only valid when pen thickness is 1)

5

NULL

6

Inside frame

 

thickness

Thickness of the pen in pixels. (0 is treated the same as 1.) Note that previous versions of this documentation incorrectly indicated that the units for thickness were based on the current map mode. See SETPENEX for an enhanced version of SETPEN which does use the current map mode units.

r, g, b

The r, g, and b parameters are optional, but if specified, must all be specified. See the SETTEXTCOLOR directive for notes.