symboldetails


Version 2.30


Manual page for symboldetails(PL)

Virtually every ploticus attribute that produces data points has an accompanying symboldetails specification for controlling the details of data point appearance.

Syntax: settings are separated from each other by space, but settings themselves contain no embedded whitespace. Also, the entire specification must be on one line.


Examples

A prefab example: pointsym="shape=diamond style=filled fillcolor=blue"
A script example: 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



Settings

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. The only types of images that will work are PNG and JPEG. Further, the image type must be the same type as your resulting image. GIF import is not supported due to possible legal issues. If your ploticus build does not support PNG or JPEG, you cannot use this feature.

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: symNS[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


Illustration




data display engine  
Copyright Steve Grubb


Markup created by unroff 1.0,    August 25, 2004.