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

labels

Description

The "labels" tag is used inside a "dialseries" to add a series of evenly positioned numeric labels around the face of the dial. This is usually more convenient than using the "label" tag several times, although internally that's all it does.

Examples

Example: Adding the numbers 1 to 12 on a clock face
<dialgraph height="400" width="400">
  <segment startangle="0" endangle="360" inner="0" outer="100" color="#FEE" />
  <tick startangle="0" endangle="360" step="30" inner="100" outer="105" color="black" />
  <needle angle="0" waist="30" waistwidth="10" end="100" color="black" />
  <needle angle="60" waist="30" waistwidth="10" end="60" color="black" />
  <labels startangle="30" endangle="360" step="30" distance="80" startvalue="1" endvalue="12" color="black" />
</dialgraph>

Attributes

startangle Real mandatory XML / Tag Library

Description

The angle of the first label to draw
endangle Real mandatory XML / Tag Library

Description

The angle of the last label to draw
step Real > 0 mandatory XML / Tag Library

Description

The number of degrees between each successive label
distance Real mandatory XML / Tag Library

Description

The distance from the center of the dial to place each label
rotate Boolean optional XML / Tag Library

Description

Whether to rotate the labels to match the angle of the label
labelformat String optional XML / Tag Library

Description

How to format the values placed at each label. The format can be any valid DecimalFormat value.
startvalue Real mandatory XML / Tag Library

Description

The value of the first label at "startangle"
endvalue Real mandatory XML / Tag Library

Description

The value of the last label at "endangle"
textcolor Paint optional XML / Tag Library

Description

Set the color of the text
padding Integer[1..4] optional XML / Tag Library

Description

  • (for text) How much spacing to put around the text
  • (when used on an "axesgraph" or "piegraph" tag in the Tag Library only) how much spacing to put arund the graph as a whole
  • (when used on a "key") how much spacing to put inside the key around the interior items.
Padding is specified as in CSS - a single value can be used to specify the padding on all sides; two values specify top/bottom and left/right, three values specify top, bottom and left/right, and four values specify top, right, bottom and left.
paddingleft Integer optional XML / Tag Library

Description

Specify left padding only.
paddingright Integer optional XML / Tag Library

Description

Specify right padding only.
paddingbottom Integer optional XML / Tag Library

Description

Specify bottom padding only.
paddingtop Integer optional XML / Tag Library

Description

Specify top padding only.
fontsize Real > 0 optional XML / Tag Library

Description

The size of the text in points

See Also

font String optional XML / Tag Library

Description

The font to use. This attribute is combination of the "fontsize", "fontweight", "fontstyle" and "fontfamily" attributes, in the same vein as the CSS2 "font" attribute. For instance, font="12pt bold Times" is the same as fontfamily="Times" fontweight="bold" fontsize="12pt".

See Also

fontfamily String optional XML / Tag Library

Description

The family (face) of the text to use. The exact meaning of this depends on the type of format used. For SVG graphs, where fonts are not embedded, this can be any string at all - it is the SVG viewers responsibility to choose an appropriate font. For PNG graphs created from the Tag library, the font name may either match a name specified by a font tag, or it will be passed in to the Font constructor. The default value is "Default", which maps to a sans-serif font.

Examples

Example: Using a system font
<bfg:axesgraph>
  <label fontfamily="serif">My Label</label>
  ...
</bfg:axesgraph>
Example: Embedding a truetype font using the Tag library
<bfg:font name="myfont" src="http://localhost/myfont.ttf" />
<bfg:axesgraph>
  <label fontfamily="myfont">My Label</label>
  ...
</bfg:axesgraph>

See Also

fontweight normal | bold optional XML / Tag Library

Description

The weight of the text. If not specified the default is "normal"

See Also

fontstyle normal | italic optional XML / Tag Library

Description

The style of the text. If not specified the default is "normal"

See Also

align box? (top | middle | bottom) (left | center | right) optional XML / Tag Library

Description

How to align the text relative to its "control point". The "align" value is one or two words, specifying a horizontal alignment, vertical alignment or both. For example, to specify just a horizontal alignment do align="center" (the vertical alignment is undefined). To align horizontally and vertically, do align="center middle". As in HTML, "middle" refers to vertical alignment and "center" refers to horizontal. The special value "box" can be used in an <axes> to require all the items in the axis are aligned as a group, rather than individually.
rotate Boolean optional XML / Tag Library

Description

Whether to rotate the labels to match the angle of the label
Big Faceless Graph Library 2.3 Tag Documentation - Copyright © 2006 Big Faceless Organization