ploticus: symboldetails attribute type

## symboldetails attribute type | Welcome Gallery Handbook |
| Manual page for symboldetails_attribute_type(PL)

## DESCRIPTION

A symboldetails attribute is used to select a geometric symbol for marking data points.`` An external GIF image file may also be used as the symbol.``

A symbol detail specification occupies one line in a script file, and contains one or more sub-attribute settings.`` A sub-attribute setting has the form subattribute=value with no embedded spaces.`` Multiple sub-attribute settings on the line are separated by white-space.`` Many of the keywords may be abbreviated to two or three characters.``

## EXAMPLES

symbols2

Here is the script that generated the above example:

      #proc symbol
      location: 1 1
      symbol: style=outline fillcolor=blue linecolor=red radius=0.1

      #proc symbol
      location: 2 1
      symbol: style=outline fillcolor=blue radius=0.1

      #proc symbol
      location: 3 1
      symbol: style=fill fillcolor=blue radius=0.1

      #proc symbol
      location: 4 1
      symbol: style=outline linecolor=red radius=0.1

      #proc symbol
      location: 5 1
      symbol: style=spokes linecolor=green radius=0.1

A Gallery example that uses symbol details specifications (symbol:) is scatterplot1

## SUB-ATTRIBUTES

shape=s

  where s may be one of: `triangle, downtriangle, diamond, square, pentagon, circle, lefttriangle, righttriangle, nicecircle`. A triangle points up; a downtriangle points down, etc. A circle has 12 points; a nicecircle has 20.``

style=s

  where s may be one of: `outline` (draw outline; fill if `fillcolor` specified), `spokes` (draw spokes), and `fill` (fill with color but don't draw outline).``

radius=r

  where r is the radius of the symbol in absolute units

fillcolor= color

  the color to use for filling in the symbol.

linecolor= color

  the color to use for the lines of the symbol.``

linewidth=linewidth

  the linewidth to use for the lines of the symbol.`` See linedetails

imgfile=name

  the name of an image file to use as the symbol.`` Image file format must be the same as the ploticus result.`` Formerly called `pngfile`.``

imgscale=sx[,sy]

  scale factor to apply to symbol imgfile. If only sx is given, equal amount of scaling is applied in both X and Y directions.`` Otherwise sx is the scale factor in X, and sy the scale factor in Y. A scale factor of `1.0` uses the original size; a smaller value shrinks the image; a larger value enlarges it.`` Formerly called `pngscale`.``

symcode

  a graphcore symcode may be specified directly if desired.`` This is a compact specification for selecting a geometric symbol for marking data points.`` The symbol code is a string representation of the form: `sym`NS[C], where N is an integer 1-8 selecting the shape: (1=triangle pointing up; 2=triangle pointing down; 3=diamond; 4=square; 5=pentagon; 6=circle; 7=triangle pointing left; 8=triangle pointing right).`` S is either 's' for spokes, 'a' for outline, or 'n' for no outline.`` C is a fill color which may be different from current line color (if omitted, no filling takes place).``
  Here is an example:
  `sym6agreen`
  data display engine
  Copyright Steve Grubb

Markup created by unroff 1.0, `` `` December 10, 2002.