Command: fillstyle

Syntax

fillstyle <name>

or

fillstyle <name> = <ident>

Description

Create or redefine a fillstyle identifier.

Parameters

• <name>
  The name of the fillstyle identifier.

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

Switches

• -alph=<num>
  The alpha transparency factor between 0 and 1. A value 1 implies fully opaque, 0 means fully transparent (therefore invisible). The default is 1.

• -col=<color>
  The color component of the fillstyle. If this is omitted, no color fill is performed on graphic primitives with this fillstyle.

• -gr=<graduation>
  The graduation component of the fillstyle. If this is omitted no graduated solid fill is performed on graphic primitives with this fillstyle.

• -hat=<hatchstyle>
  The hatching component of the fillstyle. If this is omitted no hatching is performed on graphic primitives with this fillstyle.

• -im=<file>
  The tile pattern component of the fillstyle. <file> should be an image file. If this is omitted, and there is no -tile switch, no tiling is applied to graphic primitives with this fillstyle.

• -til=<tile>
  The tile pattern component of the fillstyle. <tile> should be a tile identifier. If this is omitted, and there is no -im switch, no tiling is applied to graphic primitives with this fillstyle.

• -tcol=<color>
  The color component of the tile pattern. This is only used in conjunction with the -til option and defines the color of on bits in the tile pattern. If this is omitted, a default foreground color (usually black) is used. The off bits in the tile pattern are displayed using the fill color (-col), or is considered transparent if -col is not defined. This color component is ignored when the tile pattern is full-color.

• -trans
  Specifies that the image indicated by the -im switch is to be displayed transparent where possible. This is the default behavior. Use -no_trans to make the image opaque.

Notes

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

The -im and -tile switches are mutually exclusive.

Examples

fillstyle grassfill, -col=pale_green, -til=grass, -tcol=green

fillstyle newgrass = grassfill

See Also