How to Specify Animation Effects for Graphs

Using ADF Gauge Components 25-3 Gauges are displayed in a default size of 200 X 200 pixels. You can customize the size of a gauge or specify dynamic resizing to fit an area across different browser window sizes. When gauges are displayed in a horizontally or vertically restricted area, for example in a web page sidebar, the gauge is displayed in a small image size. Although fully featured, the smaller image is a simplified display. By default, gauges are displayed using a Flash player as specified in the gauge component imageFormat attribute. Alternatively, gauges can be displayed using a Portable Network Graphics PNG output format, as in the case when plug-ins are not allowed on client machines, or in bidirectional locales. Although static rendering is fully supported when using a PNG output format, certain interactive features are not available including: ■ Animation ■ Context menus ■ Drag and drop gestures ■ Interactive pie slice behavior ■ Reference object hover behavior ■ Popup support ■ Selection ■ Series rollover behavior ■ Time selector ■ Zoom and scroll live client-side scrolling

25.1.1 Types of Gauges

The following types of gauges are supported by the gauge component: ■ Dial: Indicates its metric along a 220 degree arc. This is the default gauge type. Figure 25–2 shows a dial gauge indicating a Plasma HD TV stock level within an acceptable range. Figure 25–2 Dial Gauge with Thresholds ■ Status Meter: Indicates the progress of a task or the level of some measurement along a rectangular bar. An inner rectangle shows the current level of a measurement against the ranges marked on an outer rectangle. Figure 25–3 shows the Plasma HD TV stock level using a status meter gauge. 25-4 Web User Interface Developers Guide for Oracle Application Development Framework Figure 25–3 Status Meter Gauge with Thresholds ■ Status Meter vertical: Indicates the progress of a task or the level of some measurement along a vertical rectangular bar. Figure 25–4 shows the Plasma HD TV stock level using a vertical status meter gauge. Figure 25–4 Vertical Status Meter Gauge with Thresholds ■ LED light-emitting diode: Graphically depicts a measurement, such as a key performance indicator KPI. Several styles of graphics are available for LED gauges, such as arrows that indicate good up arrow, fair left- or right-pointing arrow, or poor down arrow. Figure 25–5 shows the Plasma HD TV stock level using a LED bulb indicator. Figure 25–5 LED Bulb Gauge Figure 25–6 shows the same stock level using a LED arrow. Using ADF Gauge Components 25-5 Figure 25–6 LED Arrow Gauge For dial and status meter gauges, a tooltip of contextual information automatically displays when a users moves a mouse over the plot area, indicator, or threshold region. Figure 25–7 shows the indicator tooltip for a dial gauge. Figure 25–7 Indicator Tooltip for Dial Gauge

25.1.2 Gauge Terminology

Gauge terms identify the many aspects of a gauge and gauge set that you can customize. The gauge component includes approximately 20 child tags that provide options for this customization. The parts of a gauge that can be customized are: ■ Overall gauge customization: Each item in this group is represented by a gauge child tag: – Gauge Background: Controls border color and fill color for the background of a gauge. – Gauge Set Background: Controls border color and fill color for the background of a gauge set. – Gauge Frame: Refers to the frame behind the dial gauge. – Plot Area: Represents the area inside the gauge itself. – Indicator: Points to the value that is plotted in a dial gauge. It is typically in the form of a line or an arrow. – Indicator Bar: The inner rectangle in a status meter gauge. – Indicator Base: The circular base of a line or needle style indicator in a dial gauge. – Threshold Set: Specifies the threshold sections for the metrics of a gauge. You can create an infinite number of thresholds for a gauge. ■ Data values: These include the metric which is the actual value that the gauge is plotting, minimum value, maximum value, and threshold values. Section 25.2, Understanding Data Requirements for Gauges describes these values.