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.