Command: textstyle

Syntax

textstyle <name>

or

textstyle <name> = <ident>

Description

Declare or redefine a textstyle identifier.

Parameters

• <name>
  The name of the textstyle identifier.

• <ident>
  Copy the attributes of an existing textstyle identifier into the new textstyle identifier. All command switches are ignored.

Switches

• -abs
  Adjustments (-x and -y) are to be measured in the text size units (-su). If this is omitted, the default behavior assumes that the adjustments are factors of the text character height.

• -al=<text>
  The alignment. This attribute is aligning multi-line text. The default is B. The values are:

• B - Beginning

• M - Middle

• E - End

• -col=<color>
  The color component of the textstyle. If this is omitted, then a default foreground color (usually black) is used at display time.

• -fo=<font>
  The font associated with the textstyle. A scalable or fixed font may be specified (see font). If this is omitted, then a default fixed font is used.

• -gap=<num>
  The inter-line spacing. This is a factor to be multiplied by the text height at display time to arrive at the actual gap size.

• -out=<num>
  Whether text is to be drawn in outline. This switch only has relevance for textstyles which utilize system fonts, i.e. TrueType on Windows systems, X fonts on Unix systems. A non-zero value will draw the text outlined in one of the following ways:

• 1 - draw text in white outlined by the text color

• 2 - draw text in black outlined by the text color

• 3 - draw text in its color outlined in white

• 4 - draw text in its color outlined in black

• 5 - draw the outline in the text color with a transparent interior

• -rat=<num>
  The character aspect ratio. This is the ratio of width/height. If omitted, a value 1 is used. The maximum ratio value is 100. Only scalable fonts can have variable aspect ratios.

• -sl=<angle>
  The character slant angle. This is an angle measured from the vertical, a positive angle producing a slant forward. If omitted, a value 0 is used. Only scalable fonts can be slanted.

• -su=<text>
  The units in which the height of text using this textstyle is measured. Possible values can be found here. If omitted, the default is m.

• -tp=<string>
  The text path or direction. Possible values are:

• LtoR - draw text left to right (default)

• RtoL - draw text right to left

• TtoB - draw text top to bottom

• BtoT - draw text bottom to top

• -x=<num>
  An x adjustment factor. When this is non-zero the text is offset from its control point in the same direction as the text. See -abs for the units.

• -y=<num>
  A y adjustment factor. When this is non-zero the text is offset from its control point in a direction corresponding to the text height. See -abs for the units.

Notes

Textstyle identifiers can have global or application scope, but cannot have local scope. When local textstyle identifiers are required, string identifiers should be used to reference the textstyles by name.

Examples

textstyle italic_text, -sl=10*degs, -fo=stdfont, -rat=0.75, -gap=0.8

See Also