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

dialgraph

Description

The "dialgraph" tag is one of the other types of top level tag (the others are "axesgraph" and "piegraph"). It's used to create Dial graphs, a very simple type of graph that can contain colored "segment" and zero or more "needle" objects.

Valid Children

segment* needle* tick* labels* label* marker* image*

Examples

Example: A simple Dial Graph
<dialgraph width="300" height="300">
  <segment startangle="-120" endangle="-80" inner="30" outer="100" color="red" />
  <segment startangle="-80" endangle="-20" inner="30" outer="100" color="yellow" />
  <segment startangle="-20" endangle="120" inner="30" outer="100" color="green" />
  <segment startangle="0" endangle="360" inner="0" outer="10" color="black" />
  <needle angle="90" waist="50" waistwidth="8" end="80" color="black" />
  <tick startangle="-120" endangle="120" step="12" inner="100" outer="105" color="black" />
  <labels startangle="-120" endangle="120" step="12" distance="110" startvalue="0" endvalue="100" />
</dialgraph>

See Also

Attributes

slicesize Real from 0.5 to 5 optional XML / Tag Library

Description

Sets the number of degrees each straight line makes up in a DialGraph. Smaller values give rounder pies and smoother shading, but will a) take longer to render and b) for vector files like PDF or SVG, result in larger files (although this may be minimized by compression in PDF). The default value is 2 (giving 2° steps).
debug null optional XML / Tag Library

Description

null
xrotation Real optional XML / Tag Library

Description

How much to rotate the image around the X axis
yrotation Real optional XML / Tag Library

Description

How much to rotate the image around the Y axis
zrotation Real optional XML / Tag Library

Description

How much to rotate the image around the Z axis
defaultcolors Paint[n] optional XML / Tag Library

Description

Defines a list of colors that should be used to paint the data objects (series or pie slices) in the graph. The list of colors should be at least one long and separated by commas. See the Colors section for more information on colors.

Examples

Example: To use bright primary colors to display the graph
<axesgraph defaultcolors="#FF0000, #00FF00, #0000FF, #FFFF00"> ... </axesgraph>
Example: To use a color and a texture as paints
<axesgraph defaultcolors="#FF0000, http://localhost/mytexture.png"> ... </axesgraph>

See Also

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.
backgroundcolor Paint optional Tag Library Only

Description

The background paint to give to the image. The default is "white", but "transparent" or another color can be used.

Examples

Example: To use a color and a texture as paints
<axesgraph backgroundcolor="transparent(red)"> ... </axesgraph>
numcolors Integer - 0 or a power of 2 optional Tag Library Only

Description

For bitmap image formats like PNG, the number of colors that the image should be reduced to. If the default of "0" is used, the returned PNG is a 24-bit truecolor image. Other values will cause the image to be "quantized" to a smaller number of colors, which takes longer but results in smaller images. Valid values are any power of 2 between 2 and 256
lightlevel Real from 0 to 100 optional XML / Tag Library

Description

How much shading to apply to the image when displayed in 3D
lightvector Real[3] optional XML / Tag Library

Description

The vector that the light is coming from. The three parameters represent the X, Y and Z components of a vector where (0,0,0) is in the center of the graph.

Examples

Example: To display the light coming from the right hand side of the graph
<axesgraph lightvector="1,0,0"> ... </axesgraph>
format png | flash | svg | rg1pdf optional Tag Library Only

Description

The format to create the image in. Currently allowed values include "svg", "flash" or "png" (the default). The value "rg1pdf" was added in 2.2.3 and can be used to embed a vector image graph into a PDF created with the Report Generator version 1.x.
fixedzoom Real optional XML / Tag Library

Description

A real number determining the zoom level to fix the image at. Normally the graph is sized to fit the image as best as possible, but where several identical images are to be produced (eg. for rollovers) then this value, along with "fixedx" and "fixedy" can be set to control the location of the image. The default value of "0" causes the image to be sized to fit as normal.

Examples

Example: an example of the fixedzoom attribute
<piegraph fixedzoom="100" fixedx="150" fixedy="150"> ... </piegraph>

See Also

fixedx Real optional XML / Tag Library

Description

A real number determining the X offset to add to the (0,0) position on the graph. See the "fixedzoom" tag for more info.

See Also

fixedy Real optional XML / Tag Library

Description

A real number determining the Y offset to add to the (0,0) position on the graph. See the "fixedzoom" tag for more info.

See Also

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
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
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
dpi integer optional Tag Library Only

Description

The DPI that should be used to embed a PNG graph image into the Report Generator. Should not be used in other circumstances. The default value is 72, and a typical value for a PDF intended for printing would be 200.
urlprefix String optional Tag Library Only

Description

The prefix that should be applied to the URL used to retrieve the image. This will obly be required when the XML created is not parsed on the client browser but on the server (as in when a graph is embedded in the Report Generator). An example value would be "https://user:password@localhost", which will be prefixed to any requests.
autocolors Paint[2] optional XML / Tag Library

Description

Can specify two colors which are used to auto-color the Graph. The series or pie slices have colors chosen for them in the range from the first to the second color.

Examples

Example: To use shades of blue to color the graph
<axesgraph autocolors="#0000A0, #D0D0FF"> ... </axesgraph>

See Also

colorordering null optional XML / Tag Library

Description

null
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.
alt Text optional Tag Library Only

Description

The "alt" attribute of the image
border Pixels optional Tag Library Only

Description

The "border" attribute of the image
height Integer mandatory Tag Library Only

Description

The "height" attribute of the image. Since graphs do not have an implied width or height, these parameters are mandatory and must be absolute values - ie width="50" not width="50%".

See Also

hspace Pixels optional Tag Library Only

Description

The "hspace" attribute of the image
longdesc URI optional Tag Library Only

Description

The "longdesc" attribute of the image
vspace Pixels optional Tag Library Only

Description

The "vspace" attribute of the image
width Integer mandatory Tag Library Only

Description

The "width" attribute of the image. Since graphs do not have an implied width or height, these parameters are mandatory and must be absolute values - ie width="50" not width="50%".

See Also

wmode window | opaque | transparent optional Tag Library Only

Description

The "wmode" attribute of the flash movie, which sets the flash movie to run in an opaque or transparent window
id Name optional Tag Library Only

Description

The "id" attribute of the graph image

See Also

htmlclass null optional XML / Tag Library

Description

null
title Text optional Tag Library Only

Description

The "title" attribute of the image
style Style optional Tag Library Only

Description

The "style" attribute of the image
lang Language-code optional Tag Library Only

Description

The "lang" attribute of the image
onclick script optional Tag Library Only

Description

Used in interactive graphs to set what happens when the click event occurs on a region of the graph
ondblclick script optional Tag Library Only

Description

Used in interactive graphs to set what happens when the dblclick event occurs on a region of the graph
onkeydown script optional Tag Library Only

Description

Used in interactive graphs to set what happens when the keydown event occurs on a region of the graph
onkeypress script optional Tag Library Only

Description

Used in interactive graphs to set what happens when the keypress event occurs on a region of the graph
onkeyup script optional Tag Library Only

Description

Used in interactive graphs to set what happens when the keyup event occurs on a region of the graph
onmousedown script optional Tag Library Only

Description

Used in interactive graphs to set what happens when the mousedown event occurs on a region of the graph
onmousemove script optional Tag Library Only

Description

Used in interactive graphs to set what happens when the mousemove event occurs on a region of the graph
onmouseout script optional Tag Library Only

Description

Used in interactive graphs to set what happens when the mouseout event occurs on a region of the graph
onmouseover script optional Tag Library Only

Description

Used in interactive graphs to set what happens when the mouseover event occurs on a region of the graph
onmouseup script optional Tag Library Only

Description

Used in interactive graphs to set what happens when the mouseup event occurs on a region of the graph
Big Faceless Graph Library 2.3 Tag Documentation - Copyright © 2006 Big Faceless Organization