DashDial

Synopsis

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

Parameters

Name Type Description

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

Description

This project provides a colorful user interface module to output a float value. It displays a changing float value in the way of a traditional meter. It shows the needle 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.

This module only provides the User Interface module. It does not contain a UImod_panel.

DashDial UI element

Parameters

visible

This integer value swiches the DashDial 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 DashDial 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 -2 and 2, the needle will move in a range from 0 to 180 degrees.

title

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

Utility Modules

The DashDial project provides the modules DashDial User Interface macro. This macro uses the utility modules dash_camera, mk_dashtic and mk_dashtext.

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

mk_dashtext and mk_dashtext provide the functionality to draw the DashDial background.

Example

An example application DashDialArrayEg is provided, which demonstrates the display of output values in the different ways.

Files

iac_proj/dh_dial/dhd_macs.v contains the V definitions of the low level macros dash_camera, mk_dashtic and mk_dashtext as well as the high level User Interface Macro DashDial.

iac_proj/dh_dial/dhd_apps.v contains the V definition of the example application DashDialArrayEg.

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, DashGauge.