Big Faceless Graph Library 2.3 Tag Documentation - Copyright © 2006 Big Faceless Organization

needle

Description

The "needle" tag is used inside a "dialseries" to add a needle to the dial. Each needle has a start (the inside), end (the outside) and an optional "waist", to create a bump in the middle of a needle like a clock hand.

Examples

Example: A simple needle with an arrow on the end
<dialgraph width="300" height="300">
  <segment startangle="-90" endangle="90" inner="0" outer="100" color="green" />
  <needle angle="30" arrow="medium" />
</dialgraph>
Example: A simple clock
<dialgraph height="400" width="400">
  <segment startangle="0" endangle="360" inner="0" outer="100" color="#FEE" />
  <tick startangle="0" endangle="360" step="30" inner="95" outer="100" color="black" />
  <needle angle="0" waist="30" waistwidth="10" end="100" color="black" />
  <needle angle="60" waist="30" waistwidth="10" end="60" color="black" />
</dialgraph>

Attributes

angle Real mandatory XML / Tag Library

Description

The angle of the needle, in degrees clockwise from 12 o'clock
start Real >= 0 optional XML / Tag Library

Description

The distance from the center of the dial to the start of the needle. A value of 0 has the needle start from the center
startwidth Real >= 0 optional XML / Tag Library

Description

The width of the needle at the start. Typically a value in the region of 0 to 10 is used. The default is 5.
waist Real >= 0 or NaN optional XML / Tag Library

Description

The distance from the center of the dial to the "waist" of the needle. If specified, this value must be greater than "start" and less than "end". If not specified or set to NaN there is no waist on the needle.
waistwidth Real >= 0 or NaN optional XML / Tag Library

Description

The width of the needle at the "waist". If not specified or set to NaN there is no waist on the needle.
end Real > 0 optional XML / Tag Library

Description

The distance from the center of the dial to the end of the needle. This value must be greater than "start".
endwidth Real >= 0 optional XML / Tag Library

Description

The width of the needle at the end. Typically a value in the region of 0 to 10 is used. The default is 0.
arrow "none", "small", "medium", "large" optional XML / Tag Library

Description

The style of arrow to place at the end of the needle. The default is "none"
color Paint optional XML / Tag Library

Description

The paint to use as the fill color for the specified object
bordercolor Color optional XML / Tag Library

Description

The color to use as the border color for the specified object. May be "none" to not draw a border for this object.
linethickness Real > 0 optional XML / Tag Library

Description

The thickness to draw the borders for this object, except for lineseries and functionseries objects when the graph is being drawn in 2D, in which case this attribute, as you would expect, sets the thickness of the lines.
dash Real[] optional XML / Tag Library

Description

The dashing pattern to use to draw the borders for this object (for 2D lineseries this functions the same as the linethickness attribute). An even number of parameters that are > 0 must be specified, where the first in each pair is the length of the dash, the second is the length of the space. Examples would be dash="5,5" to create a regular dash pattern, or dash="6,2,2,2" to create a dash/dot type pattern.
Big Faceless Graph Library 2.3 Tag Documentation - Copyright © 2006 Big Faceless Organization