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
paddingleft Integer optional XML / Tag Library

Description

How much spacing to put to the left of the text, or (when used on an "axesgraph" or "piegraph" tag in the Tag Library only) to the left of the graph as a whole
paddingright Integer optional XML / Tag Library

Description

How much spacing to put to the right of the text, or (when used on an "axesgraph" or "piegraph" tag in the Tag Library only) to the right of the graph as a whole
paddingbottom Integer optional XML / Tag Library

Description

How much spacing to put below the text, or (when used on an "axesgraph" or "piegraph" tag in the Tag Library only) below the graph as a whole
paddingtop Integer optional XML / Tag Library

Description

How much spacing to put above the text, or (when used on an "axesgraph" or "piegraph" tag in the Tag Library only) above the graph as a whole
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 (top | middle | bottom) (left | center | right) optional XML / Tag Library

Description

How to align the text relative to it's "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.
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