DashGauge

Synopsis

A colorful User Interface gauge module to output a float value.

Parameters

Name Type Description

visible int Toggles the visibility of the DashGauge UIpanel.
parent UIconnection The User interface parent object.
step_value float The float value data to be shown by DashGauge.
title string The title of the DashGauge in the UI.

Description

This provides three colorful User Interface modules to display float values. These modules display a changing float value like a traditional gauge. It shows the needle, dial and text in a 2D viewer (dash_camera). The needle and text display is implemented using the "mk_needle" and "mk_dashtext" modules similar to the ones released with the GlyphLibrary. GlyphLibrary.

This modules only provide the User Interface modules. They do not contain a UImod_panel.

DashGauge UI element

Parameters

visible

This integer value swiches the DashGauge User Interface element on or off. The elements themself are not disabled. They are just hidden with the UIpanel.

parent

This UIconnection value contains the User Interface element which provides the parent frame or panel for the DashGauge element.

step_value

This parameter contains the float value which is to be shown by the gauge. This value is not constrained. If this value is in the range between 0 and 100, the needle will move in a range from 0 to 180 degrees.

title

The title string is displayed at the bottom of the DashGauge User Interface element. It is by default the name of the Module in the Network editor.

Utility Modules

The DashGauge project provides three modules DashGaugeA, DashGaugeB and DashGaugeC. These modules use the common utility modules dash_camera, mk_dashtext, mk_needle, transform_needle, arc_grid and arc_solid.

dash_camera defines a very simple camera system to display the 2D dashboard widget. This camera does not contain picking functions.

mk_needle and transform_needle provide the fuctionality to draw and rotate the needle to show the value given by step_value.

mk_dashtext, arc_grid and arc_solid provide the functionality to draw the DashGauge backgrounds.

Example

An example application DashGaugeArrayEg is provided, which demonstrates displaying output values in the different ways.

Files

iac_proj/dh_gauge/dhg_macs.v contains the V definitions of the low level macros dash_camera, mk_dashtext, mk_needle, transform_needle, arc_grid and arc_solid as well as the User Interface Macros DashGaugeA, DashGaugeB and DashGaugeC.

iac_proj/dh_gauge/dhg_apps.v contains the V definition of the example application DashGaugeArrayEg.

Author

Ian Curington
Advanced Visual Systems, Inc.

Modifications

MA YingLiang
Manchester Visualization Centre

Tobias Schiebeck
International AVS Centre

Contact

International AVS Centre
Manchester Computing
University of Manchester
Oxford Road
Manchester
United Kingdom
M13 9PL

See Also

GlyphLibrary, DashDial