# SETPEN

> [HTML Version](setpen.htm)

Note: SETPEN has been succeeded by [SETPENEX](setpenex_pd.htm.md), which offers a greater range of options. Although SETPEN is supported, [SETPENEX](setpenex_pd.htm.md) 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](lineto_pd.htm.md) and [RECTANGLE](rectangle_pd.htm.md) 

**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](settextcolor_pd.htm.md) directive for notes.