PREV NEXT

Generic Logic, Inc. www.genlogic.com


2 The GLG Widget Library

This chapter contains descriptions of each of the widgets in the GLG Widget Library. The description of each widget contains information about how to use that widget. You may also want to consult Using the GLG Widgets at the beginning of this manual.

The Process Control Objects are not listed in this chapter. Refer to the Process Control Symbols section of Using the GLG Widgets for the list of common resources of the process control objects.

To test each widget, you can use the GLG Graphics Builder to animate the widget. The resource path of an entry point for animating each graph is listed in the graph's resources. As an example, a graph widget might contain the following entry points:

Data Values Entry Point
$Widget/DataGroup/EntryPoint
Time Labels Entry Point
$Widget/XLabelGroup/EntryPoint

If the listed default data range is between 0 and 1, then the widget can be animated using the following animation command:

$datagen			d 0 1 "$Widget/DataGroup/EntryPoint"
			s 0 0 "$Widget/XLabelGroup/EntryPoint"

All graph widgets contain default animation commands for prototyping them in the Graphics Builder. Refer to the Prototyping Graph Widgets with Custom Animation Commands section on page 19 of this manual for information on using the default animation command.

Refer to the The datagen utility is embedded into the GLG Builder, which invokes the utility to generate data for prototyping the drawing in the Run mode using the $datagen command in the Run dialog. $datagen instructs the Builder to use an internal version of the datagen utility. on page 386 of the GLG Programming Reference Manual for a complete list of the prototyping command options.

The rest of this chapter describes the resources of each widget. Because there is a lot of duplication between the widgets, the resources are grouped into "sets", and the descriptions below just list the resource sets used by each widget. For lists of the resources that make up the resource sets, see GLG Widget Resource Sets on page 101 of this manual.

Bar Graph
Signed Bar Graph
Histogram Graph

The Bar Graph is used to display one set of data as an arrangement of vertical bars. The height of a bar corresponds to the value of the data it represents. The Signed Bar Graph is similar to the bar graph, but data samples may have negative values as well as positive. The Histogram Graph is similar to the Bar Graph, but with no gaps between the bars.

Animation Data

The entry points for these graphs are as follows:

Data Entry
$Widget/DataGroup/EntryPoint
Label Entry
$Widget/XLabelGroup/EntryPoint

The default data range is between 0 and 1. The default range for the Signed Bar Graph is between -1 and 1.

Files

Bar Graph: bar1.g
Signed Bar Graph: bar4.g
Histogram Graph: bar7.g

Resource Sets

These widgets use resources from the following sets:

Horizontal Bar Graph

The Horizontal Bar Graph displays one set of data in 2D as horizontal bars. This graph is the same as the Bar Graph, except that the bars are horizontal. The graph resources are the same too, with the only distinction that X and Y prefixes are swapped.

Animation Data

The graph's entry points are as follows:

Data Entry
$Widget/DataGroup/EntryPoint
Label Entry
$Widget/YLabelGroup/EntryPoint

The default data range is between 0 and 1.

Files

bar2.g

Resource Sets

This widget uses resources from the following sets:

Symmetrical Bar Graph

The Symmetrical Bar Graph displays one set of data in 2D as vertical bars centered around X axis. The height of a bar corresponds to the value of the data it represents. This is not the same as a Signed Bar Graph. The height of a bar above the X axis is the same as it's depth below it; it is symmetrical.

Animation Data

The graph's entry points are as follows:

Data Entry
$Widget/DataGroup/EntryPoint
Label Entry
$Widget/XLabelGroup/EntryPoint

The default data range is between 0 and 1.

Files

bar3.g

Resource Sets

This widget uses resources from the following sets:

Packed Bar Graph

The Packed Bar Graph displays several sets of data in 2D in clusters or "packs" of vertical bars. One pack of bars contains one sample of data that includes several datasamples. The height of each bar corresponds to the value of its data sample.

Animation Data

The graph's entry points are as follows:

Data Entry
$Widget/DataGroup/EntryPoint
Label Entry
$Widget/XLabelGroup/EntryPoint

The default data range is between 0 and 1. There are three bars in each pack in the default graph.

Files

bar8.g

Resource Sets

This widget uses resources from the following sets:

Stacked Bar Graph

The Stacked Bar Graph displays several sets of data in 2D as stacked vertical bars. This is comparable to a packed bar graph except that the bars that make up each cluster are placed on top of each other. Each bar, composed of a pack of several smaller bars, contains one iteration of data from each data set. The height of every component of a stack corresponds to the value of its data sample. The total height of a stack is equal to the sum of the heights of the individual components. The range of the graph is equal to the range of the sum of the individual components. This means that the sum of all values corresponding to one stack should be less than or equal to the range of the graph.

Animation Data

The graph's entry points are as follows:

Data Entry
$Widget/DataGroup/EntryPoint
Label Entry
$Widget/XLabelGroup/EntryPoint

The default data range is between 0 and 0.2, and there are, by default, 5 bars in each stack.

Files

bar9.g

Resource Sets

This widget uses resources from the following sets:

Step Graph

The Step Graph displays one set of data in 2D as a step line. The height of a step corresponds to the value of a data sample.

Animation Data

The graph's entry points are as follows:

Data Entry
$Widget/DataGroup/EntryPoint
Label Entry
$Widget/XLabelGroup/EntryPoint

The default data range is between 0 and 1.

Files

step1.g

Resource Sets

This widget uses resources from the following sets:

Filled Step Graph

The Filled Step Graph is the same as the Step Graph (see page 54), but with a filled line.

Animation Data

The graph's entry points are as follows:

Data Entry
$Widget/DataGroup/EntryPoint
Label Entry
$Widget/XLabelGroup/EntryPoint

The default data range is between 0 and 1.

Files

step4.g

Resource Sets

This widget uses resources from the following sets:

Horizontal Step Graph

The Horizontal Step Graph displays one set of data in 2D as a step line. The horizontal position of a step corresponds to the value of a data sample. This graph is the same as the Step Graph (see page 54), but is rotated on its side.

Animation Data

The graph's entry points are as follows:

Data Entry
$Widget/DataGroup/EntryPoint
Label Entry
$Widget/YLabelGroup/EntryPoint

The default data range is between 0 and 1.

Files

step2.g

Resource Sets

This widget uses resources from the following sets:

Horizontal Filled Step Graph

The Horizontal Filled Step Graph displays one set of data in 2D as a vertical step line. The horizontal position of a step corresponds to the value of a data sample. This graph is the same as the Filled Step Graph (see page 55), but is rotated on its side.

Animation Data

The graph's entry points are as follows:

Data Entry
$Widget/DataGroup/EntryPoint
Label Entry
$Widget/YLabelGroup/EntryPoint

The default data range is between 0 and 1.

Files

step5.g

Resource Sets

This widget uses resources from the following sets:

Multiline Step Graph

The Multiline Step Graph displays multiple sets of data in 2D as step lines. The height of a step corresponds to the value of a data sample.

Animation Data

The graph's entry points are as follows:

Data Entry for All Lines
$Widget/DataGroupOne/EntryPoint
Label Entry
$Widget/XLabelGroup/EntryPoint

The default data range is between 0 and 1. The default number of data groups is two.

Data Entry for One Line

To animate just one of the data groups, use this resource in place of the above data entry point:

$Widget/DataGroupOne/DataGroup<N>/EntryPoint

Use the number of the desired data group in place of <N>, as in $Widget/DataGroupOne/DataGroup3/EntryPoint.

Files

step3.g

Resource Sets

This widget uses resources from the following sets:

Filled Multiline Step Graph

The Filled Multiline Step Graph is the same as the Multiline Step Graph (see page 57), but with a filled step line.

Animation Data

The graph's entry points are as follows:

Data Entry for All Lines
$Widget/DataGroupOne/EntryPoint
Label Entry
$Widget/XLabelGroup/EntryPoint

The default data range is between 0 and 1. The default number of data groups is two.

Data Entry for One Line

To animate just one of the data groups, use this resource in place of the above data entry point:

$Widget/DataGroupOne/DataGroup<N>/EntryPoint

Use the number of the desired data group in place of <N>, as in $Widget/DataGroupOne/DataGroup3/EntryPoint.

Files

step6.g

Resource Sets

This widget uses resources from the following sets:

Line Graph
Filled Line Graph
Line Segment Graph
Point Graph

The Line Graph displays one set of data in 2D as a polyline with marker objects identifying each data value. The Y coordinate of a polyline point corresponds to the value of a data sample. Markers may be switched off if desired.

The Filled Line Graph is the same as the Line Graph, but with a filled line. The Line Segment Graph is also similar, but the segments of the polyline may have different colors, widths and line types.

A Point Graph is simply a Line Graph without the lines. Only the markers are displayed.

Animation Data

The entry points for these graphs are as follows:

Data Entry
$Widget/DataGroup/EntryPoint
Label Entry
$Widget/XLabelGroup/EntryPoint

The default data range is between 0 and 1.

Files

Line Graph: line1.g
Filled Line graph: line3.g
Line Segment Graph: line5.g
Point Graph: point1.g

Resource Sets

These widgets use resources from the following sets:

Multiline Graph
Filled Multiline Graph
Multiset Line Segment Graph
Multiset Point Graph

These four graphs are versions of the graphs on page 59 equipped to display data from multiple data sets. They have multiple lines and multiple Y axes with which to chart them.

Animation Data

These graphs' entry points are as follows:

Data Entry for All Lines
$Widget/DataGroupOne/EntryPoint
Label Entry
$Widget/XLabelGroup/EntryPoint

The default data range is between 0 and 1. The default number of data groups is two.

Data Entry for One Line

To animate just one of the data groups, use this resource in place of the above data entry point:

$Widget/DataGroupOne/DataGroup<N>/EntryPoint

Use the number of the desired data group in place of <N>, as in $Widget/DataGroupOne/DataGroup3/EntryPoint.

Files

Multiline Graph: line2.g
Filled Multiline Graph: line4.g
Multiset Line Segment Graph: line6.g
Multiset Point Graph: point2.g

Resource Sets

These widgets use resources from the following sets:

XY Line Graph
XY Point Graph

The XY Line Graph displays one set of (X,Y) data pairs in 2D as a polyline with markers identifying each data pair. The markers may be switched off if desired. The X and Y coordinates of the polyline's points correspond to X and Y values of the input data pairs. The XY Point Graph is the same as the XY Line Graph, but only the markers are displayed. The XY Graph is also known as a scatter graph.

Animation Data

The entry points for these graphs are as follows:

Data Entry
$Widget/DataGroup/XEntryPoint
$Widget/DataGroup/YEntryPoint

The default data range is between -1 and 1.

Files

XY Line Graph: scatt1.g
XY Point Graph: scatt3.g

Resource Sets

These widgets use resources from the following sets:

Multiline XY Graph
Multiset Point XY Graph

These two graphs are versions of the graphs on page 61 equipped to display data from multiple data sets. There is only one set of axes with this graph, so the various data sets should have the same data range. For different data ranges, see page 63.

Animation Data

The entry points for these graphs are as follows:

Data Entry for All Lines
$Widget/DataGroupOne/XEntryPoint
$Widget/DataGroupOne/YEntryPoint

The default data range is between -1 and 1. The default number of data groups is two.

Data Entry for One Line

To animate just one of the data groups, use these resource in place of the above data entry points:

$Widget/DataGroupOne/DataGroup<N>/XEntryPoint
$Widget/DataGroupOne/DataGroup<N>/YEntryPoint

Use the number of the desired data group in place of <N>, as in $Widget/DataGroupOne/DataGroup3/EntryPoint.

Files

Multiline XY Graph: scatt2.g
Multiset Point XY Graph: scatt4.g

Resource Sets

These widgets use resources from the following sets:

Multiaxis Multiline XY Graph

The Multiaxis Multiline XY Graph displays several sets of (X,Y) data pairs in 2D as polylines with markers identifying each data pair. Markers may be switched off if desired. The X and Y coordinates of the polyline's points correspond to X and Y values of data pairs. The graph has several axes to display different sets of data in different ranges. See page 61 for the single data set version of this graph.

The Special widgets set contain additional axes objects that may be added to any graph.

Animation Data

The graph's entry points are as follows:

Data Entry for All Graphs
$Widget/DataGroupOne/XEntryPoint
$Widget/DataGroupOne/YEntryPoint

The default data range is between -1 and 1. The default number of data groups is two.

Data Entry for One Line

To animate just one of the data groups, use these resource in place of the above data entry points:

$Widget/DataGroupOne/DataGroup<N>/XEntryPoint
$Widget/DataGroupOne/DataGroup<N>/YEntryPoint

Use the number of the desired data group in place of <N>, as in $Widget/DataGroupOne/DataGroup3/EntryPoint.

Files

scatt5.g

Resource Sets

This widget uses resources from the following sets:

Polar Line Graph
Polar Filled Line Graph
Polar Line Segment Graph
Polar Point Graph

The Polar Line Graph displays one set of data in polar coordinates as a polyline with markers at each data value. The value of the data sample controls the radial distance of the polyline's point from the center of the graph. Markers may be switched off if desired.

The Polar Filled Line Graph is the same as the Polar Line Graph, but with a filled line. The Polar Line Segment Graph is also similar, but the segments of the polyline may have different colors, widths and line types.

The Polar Point Graph is the same as the Polar Line Graph, but displays just the markers.

Animation Data

The entry points for these graphs are as follows:

Data Entry
$Widget/DataGroup/EntryPoint

The default data range is between 0 and 1.

Files

Polar Line Graph: polar1.g
Polar Filled Line Graph: polar2.g
Polar Line Segment Graph: polar6.g
Polar Point Graph: polar7.g

Resource Sets

These widgets use resources from the following sets:

Multiline Polar Graph

The Multiline Polar Graph displays several sets of data in polar coordinates as polylines with markers at each data value. The value of the data sample controls the radial distance of the polyline's point from the center of the graph. Markers may be switched off if desired. This is a multiline version of the graph on page 64.

Animation Data

The entry points for these graphs are as follows:

Data Entry for All Lines
$Widget/DataGroupOne/EntryPoint

The default data range is between -1 and 1. The default number of data groups is two.

Data Entry for One Line

To animate just one of the data groups, use these resource in place of the above data entry points:

$Widget/DataGroupOne/DataGroup<N>/EntryPoint

Use the number of the desired data group in place of <N>, as in $Widget/DataGroupOne/DataGroup3/EntryPoint.

Files

polar4.g

Resource Sets

This widget uses resources from the following sets:

XY Polar Line Graph

XY Polar Line Graph: Displays one set of data pairs in 2D in polar coordinates as a polyline with markers identifying each data value. One value of a pair controls the angle and the other controls the radial distance of the polyline's point from the center of the graph. Markers may be switched off if desired.

Animation Data

The graph's entry points are as follows:

Data Entry
$Widget/DataGroup/AngleEntryPoint
$Widget/DataGroup/RadiusEntryPoint

The default radius range is between 0 and 1. The default angle range is between 0 and 360.

Files

polar3.g

Resource Sets

This widget uses resources from the following sets:

Multiline Polar XY Graph

The Multiline Polar XY Graph is a multiple data set version of the Polar XY Graph described on page 66.

Animation Data

The graph's entry points are as follows:

Data Entry for All Lines
$Widget/DataGroupOne/AngleEntryPoint
$Widget/DataGroupOne/RadiusEntryPoint

The default radius data range is between 0 and 1, while the angle spans between 0 and 360. The default number of data groups is two.

Data Entry for One Line

To animate just one of the data groups, use these resources in place of the above data entry points:

$Widget/DataGroupOne/DataGroup<N>/AngleEntryPoint
$Widget/DataGroupOne/DataGroup<N>/RadiusEntryPoint

Use the number of the desired data group in place of <N>, as in $Widget/DataGroupOne/DataGroup3/AngleEntryPoint.

Files

polar5.g

Resource Sets

This widget uses resources from the following sets:

Pie Chart

The Pie Chart displays one set of data as arc segments. A pie segment selection may be indicated by shifting the segment outside of the pie chart.

Animation Data

The entry points for these graphs are as follows:

Data Entry
$Widget/DataGroup/EntryPoint

The default data range is between 0 and any positive number.

Files

Pie Chart: pie1.g

Resource Sets

These widgets use resources from the following sets:

Combination Graph

The Combination Graph is a Bar Graph Widget with a Multiset Line Graph overlaid on top of the bars.

Animation Data

The entry points for the bar graph part of the combination are as follows:

Data Entry
$Widget/DataGroup/EntryPoint
Label Entry
$Widget/XLabelGroup/EntryPoint

The default data range is between 0 and 1.

The entry point for the Multiset Line Graph component of the Combination Graph is as follows:

$Widget/DataGroupOne/EntryPoint

The default number of data sets is two.

Files

comb1.g

Resource Sets

This widgets use resources from the following sets:

Stock Graphs

The Stock Graphs are used to show current and past values of a data series. In addition to displaying current data with a line or marker, a stock graph can show the range of data over one or two given time periods. There are two stock graphs. The simpler graph, stock2.g, displays a marker at some "current" value, and can display a high and low limit with a vertical line behind that marker. The more complex stock graph, stock1.g, displays a multiset line graph with bars and lines to display two different sets of limit information in the background.

Animation Data

The entry points for the stock2.g graphs are as follows:

Data Entry
$Widget/DataGroup/MarkEntryPoint
$Widget/DataGroup/HighEntryPoint
$Widget/DataGroup/LowEntryPoint
Label Entry
$Widget/XLabelGroup/EntryPoint

The default data range is between 20000 and 100000.

The entry points for the stock1.g graph are as follows:

Data Entry
$Widget/DataGroupOne/EntryPoint
$Widget/DataGroup/OpenEntryPoint
$Widget/DataGroup/CloseEntryPoint
$Widget/DataGroup/HighEntryPoint
$Widget/DataGroup/LowEntryPoint
$Widget/DataGroup/MarkEntryPoint

The label entry point is the same as for the stock2.g graph.

Files

stock1.g
stock2.g

Resource Sets

These widgets use resources from the following sets:

Axes Widget

The Axes Widget is a set of graph axes that may be added to any other widget.

Files

axes1.g

Resource Sets

These widgets use resources from the following sets:

3D Bar Graph
3D Signed Bar Graph
3D Histogram Graph
Pyramid Graph
Prism Graph
Cylinder Graph

All the graphs in this group display one set of data as an array of 3D objects. The height of an object corresponds to the value of its data sample. The 3D Signed Bar displays negative values as well as positive. The difference between the other graphs is only the shape of the objects representing the data. The Pyramid Graph uses little pyramids, and the Cylinder Graph uses cylinders and so on.

Animation Data

The entry points for these graphs are as follows:

Data Entry
$Widget/DataGroup/EntryPoint
Label Entry
$Widget/XLabelGroup/EntryPoint

The default data range is between 0 and 1.

Files

3D Bar Graph: bar101.g
3D Signed Bar Graph: bar109.g
3D Histogram Graph: bar119.g
Pyramid Graph: bar107.g
Prism Graph: bar103.g
Cylinder Graph: bar105.g

Resource Sets

These widgets use resources from the following sets:

Multiset 3D Bar Graph
Multiset 3D Signed Bar Graph
Multiset Pyramid Graph
Multiset Prism Graph
Multiset Cylinder Graph

These graphs are multiset variations of that graphs described on page 71.

Animation Data

The entry points for these graphs are as follows:

Data Entry for All DataGroups
$Widget/DataGroupOne/EntryPoint
Label Entry
$Widget/XLabelGroup/EntryPoint

The default data range is between 0 and 1. The default number of data groups is two.

Data Entry for One DataGroup

To animate just one of the data groups, use this resource in place of the above data entry point:

$Widget/DataGroupOne/DataGroup<N>/EntryPoint

Use the number of the desired data group in place of <N>, as in $Widget/DataGroupOne/DataGroup3/EntryPoint.

Files

Multiset 3D Bar Graph: bar102.g
Multiset 3D Signed Bar Graph: bar112.g
Multiset Pyramid Graph: bar108.g
Multiset Prism Graph: bar104.g
Multiset Cylinder Graph: bar106.g

Resource Sets

These widgets use resources from the following sets:

3D Packed Bar Graph
3D Packed Signed Bar Graph

The 3D Packed Bar Graph displays several sets of data as packs of vertical 3D bars. One pack contains one iteration of data from each of the data sets. The height of a bar corresponds to the value of its data sample. The signed version accepts negative values as well as positive.

Animation Data

The entry points for these graphs are as follows:

Data Entry
$Widget/DataGroup/EntryPoint
Label Entry
$Widget/XLabelGroup/EntryPoint

The default data range is between 0 and 1, and the default number of bars in a pack is three.

Files

3D Packed Bar Graph: bar115.g
3D Packed Signed Bar Graph: bar117.g

Resource Sets

These widgets use resources from the following sets:

Multiset 3D Packed Bar Graph
Multiset 3D Packed Signed Bar Graph

Displays several sets of data as several series of packs of vertical 3D bars. One pack of bars keeps corresponding samples of one set. The height of a bar corresponds to the value of a data sample.

The signed version accepts negative values as well as positive.

Animation Data

The entry points for these graphs are as follows:

Data Entry for All DataGroups
$Widget/DataGroupOne/EntryPoint
Label Entry
$Widget/XLabelGroup/EntryPoint

The default data range is between 0 and 1. The default number of data groups is two, with three bars in each pack.

Data Entry for One DataGroup

To animate just one of the data groups, use this resource in place of the above data entry point:

$Widget/DataGroupOne/DataGroup<N>/EntryPoint

Use the number of the desired data group in place of <N>, as in $Widget/DataGroupOne/DataGroup3/EntryPoint.

To animate just one of the data packs, you might use a resource that looks like this:

$Widget/DataGroupOne/DataGroup1/Pack2/EntryPoint

Files

Multiset 3D Packed Bar Graph: bar116.g
Multiset 3D Packed Signed Bar Graph: bar118.g

Resource Sets

These widgets use resources from the following sets:

3D Stacked Bar Graph

The 3D Stacked Bar Graph displays several sets of data as packs of stacked vertical 3D bars. The corresponding samples of each set are placed on top of one another to form one pack of stacked bars. Each stack contains one iteration of data from each data set. The height of every component of a stack corresponds to the value of its data sample, and the total height of the stack equals the sum of the heights of its individual components.

The range of the graph should accommodate the range of the sum of the individual component data sets. This means that the sum of all values corresponding to one stack should be less than or equal to the total graph range.

Animation Data

The graph's entry points are as follows:

Data Entry
$Widget/DataGroup/EntryPoint
Label Entry
$Widget/XLabelGroup/EntryPoint

The default data range is between 0 and 0.2, and there are five bars in a stack, by default.

Files

bar113.g

Resource Sets

This widget uses resources from the following sets:

Multiset 3D Stacked Bar Graph

The Multiset 3D Stacked Bar Graph is a multiset version of the Stacked Bar Graph described on page 75.

Animation Data

The graph's entry points are as follows:

Data Entry for All DataGroups
$Widget/DataGroupOne/EntryPoint
Label Entry
$Widget/XLabelGroup/EntryPoint

The default data range is between 0 and 0.2. The default number of bars in a stack is 5 and the number of data groups is 2.

Data Entry for One DataGroup

To animate just one of the data groups, use this resource in place of the above data entry point:

$Widget/DataGroupOne/DataGroup<N>/EntryPoint

Use the number of the desired data group in place of <N>, as in $Widget/DataGroupOne/DataGroup3/EntryPoint.

Files

bar114.g

Resource Sets

This widget uses resources from the following sets:

3D Step Graph

The 3D Step Graph displays one set of data in 3D as a step line. The height of a step corresponds to the value of a data sample.

Animation Data

The graph's entry points are as follows:

Data Entry
$Widget/DataGroup/EntryPoint
Label Entry
$Widget/XLabelGroup/EntryPoint

The default data range is between 0 and 1.

Files

step101.g

Resource Sets

This widget uses resources from the following sets:

Multiset 3D Step Graph

The Multiset 3D Step Graph displays several sets of data in 3D as step lines. The height of a step corresponds to the value of a data sample.

Animation Data

The graph's entry points are as follows:

Data Entry for All DataGroups
$Widget/DataGroupOne/EntryPoint
Label Entry
$Widget/XLabelGroup/EntryPoint

The default data range is between 0 and 1. The default number of data groups is two.

Data Entry for One DataGroup

To animate just one of the data groups, use this resource in place of the above data entry point:

$Widget/DataGroupOne/DataGroup<N>/EntryPoint

Use the number of the desired data group in place of <N>, as in $Widget/DataGroupOne/DataGroup3/EntryPoint.

Files

step102.g

Resource Sets

This widget uses resources from the following sets:

Ribbon Graph

The Ribbon Graph displays one set of data in 3D as a set of points connected by a ribbon. The height of a point corresponds to the value of a data sample. You can adjust the width of the ribbon by editing the polygon that is its series template .

Animation Data

The graph's entry points are as follows:

Data Entry
$Widget/DataGroup/EntryPoint
Label Entry
$Widget/XLabelGroup/EntryPoint

The default data range is between 0 and 1.

Files

ribbon101.g

Resource Sets

This widget uses resources from the following sets:

Multiset Ribbon Graph

The Multiset Ribbon Graph displays several sets of data in 3D as data points connected by a ribbon. The height of a point corresponds to the value of a data sample.

Animation Data

The graph's entry points are as follows:

Data Entry for All DataGroups
$Widget/DataGroupOne/EntryPoint
Label Entry
$Widget/XLabelGroup/EntryPoint

The default data range is between 0 and 1. The default number of data groups is two.

Data Entry for One DataGroup

To animate just one of the data groups, use this resource in place of the above data entry point:

$Widget/DataGroupOne/DataGroup<N>/EntryPoint

Use the number of the desired data group in place of <N>, as in $Widget/DataGroupOne/DataGroup3/EntryPoint.

Files

ribbon102.g

Resource Sets

This widget uses resources from the following sets:

Framed Surface Graph
Unframed Surface Graph

These graphs display one set of data in 3D as a surface. The surface area is defined by a parallelogram. The parallelogram is then divided into number of nodes by the grid lines parallel to its sides. Every node is elevated by the amount corresponding to the value of a data sample. Drawing markers can be drawn on the graph. Markers are always drawn on the top of the surface.

To form a surface graph, every set of four nodes is connected by a line, creating a parallelogram. This parallelogram is close to a planar one only if the number of data samples is big and the value changes from one data sample to the next is small in both X and Y directions.

The difference between two graphs is in the number of context objects. The Unframed Surface Graph has only the axes, ticks and labels in addition to the surface. The Framed Surface Graph also has a frame made from the polygons and horizontal grids.

Animation Data

The entry points for these graphs are as follows:

Data Entry
$Widget/DataGroup/EntryPoint

The default data range is between 0 and 1. The default graph has 11 column and row nodes, giving 121 total nodes. Use these parameters to control the datagen test program.

Files

Framed Surface Graph: surf101.g
Unframed Surface Graph: surf102.g

Resource Sets

These widgets use resources from the following sets:

Gantt Chart

Displays constrained time intervals as horizontal bars. The beginning of the next interval is constrained to coincide with the end of the previous interval.

The sum of all time interval values of the graph should be less than or equal to the total range of the graph.

Animation Data

The graph's entry points are as follows:

Data Entry
$Widget/DataGroup/EntryPoint
Label Entry
$Widget/XLabelGroup/EntryPoint

The default data range is between 0 and 1. However, the default graph has 10 time intervals in it, so you should test the program with a data range between 0 and 0.1 so that the sum of all the time intervals is less than 1.

Files

gantt1.g

Resource Sets

This widget uses resources from the following sets:

Horizontal Slider Graph

The Horizontal Slider Graph displays one data value in 2D as a horizontal bar. The horizontal dimension of the bar corresponds to the value of the data sample.

Animation Data

The graph's entry points are as follows:

Data Entry
$Widget/DataGroup/ValueX

The default data range is between 0 and 1.

The Slider Graph may also be used as a control widget, and animated without any data by using its reaction to mouse movement.

Files

bar5.g

Resource Sets

This widget uses resources from the following sets:

Vertical Slider Graph

The Vertical Slider Graph displays one data value in 2D as a vertical bar. The height of the bar corresponds to the value of a data sample.

Animation Data

The graph's entry points are as follows:

Data Entry
$Widget/DataGroup/ValueY

The default data range is between 0 and 1.

The Slider Graph may also be used as a control widget, in which case it may be animated without any data by using its reaction to mouse movement.

Files

bar6.g

Resource Sets

This widget uses resources from the following sets:

Horizontal 3D Slider Graph

The Horizontal 3D Slider Graph is identical to the Horizontal Slider Graph described on page 82, except that the active element is a 3D bar. It displays one data value at a time, and the horizontal dimension of the bar corresponds to the value of the data.

Animation Data

The graph's entry points are as follows:

Data Entry
$Widget/DataSample/ValueX

The default data range is between 0 and 1.

The 3D Slider Graph may also be used as a control widget, in which case it can be animated without any data by using its reaction to mouse movement.

Files

bar110.g

Resources

ActiveElementGroup (GROUP): data sample
ActiveElement (POLYGON): one polygon of a data sample bar
ValueX (DDATA): the value defining a position of a data sample
Low (DDATA): low range of graph values
High (DDATA): high range of graph values
StartColor (GDATA): color for the minimum value
EndColor (GDATA): color for the maximum value

Resource Sets

This widget uses resources from the following sets:

Vertical 3D Slider Graph

The Vertical 3D Slider Graph is identical to the Vertical Slider Graph described on page 83, except that the active element is a 3D bar. It displays one data value at a time, and the horizontal dimension of the bar corresponds to the value of the data.

Animation Data

The graph's entry points are as follows:

Data Entry
$Widget/DataSample/ValueY

The default data range is between 0 and 1.The widget may also be used as a control widget, in which case it can be animated without any data by using its reaction to mouse movement.

Files

bar111.g

Resources

ActiveElementGroup (GROUP): data sample
ActiveElement (POLYGON): one polygon of a data sample bar
ValueY (DDATA): the value defining a position of a data sample
Low (DDATA): low range of graph values
High (DDATA): high range of graph values
StartColor (GDATA): color for the minimum value
EndColor (GDATA): color for the maximum value

Resource Sets

This widget uses resources from the following sets:

Legend

The Legend Widget is an optional legend that may be pasted into any other graph widget.

Files

legend1.g

Resource Sets

This widget uses resources from the Legend Resource Set.

Bevels

The Bevel Widget is an optional beveled area to use for decoration. You can use it to add a border to another widget by placing that widget inside the Bevel Widget. You can constrain resources of the contained widget to the bevel lighting or color to provide a status indicator, as for a toggle button.

The Bevel Widget comes with a text object already inside it for ease of editing. You can use the text object to change the bevel colors easily. Delete or move the text object before inserting the next widget.

Files

bevel1.g

Resource Sets

This widget uses resources from the Bevel Resource Set

Gauge Widgets

The Gauge Widgets provide several graphical dials and gauges with different look and feel. They can all be used to display a value or to enter one using the mouse. Several gauges may be combined together with other widgets to create custom control panels.

Files

meter1.g
meter2.g
meter3.g
meter4.g
Left Quadrant Meter: meter5.g
Right Quadrant Meter: meter6.g
Left Quadrant Meter with Bevels: meter7.g
meter8.g
Semicircle Meter: meter9.g

Resource Sets

These widgets use resources from the following sets:

Clock Widgets

The Clock Widgets are used to tell time. A clock widget may be used for output only, in which case you can delete the input handler, then use the ValueHour, ValueMin and ValueSec resources for moving the corresponding clock hands. Use the Hour, Min and Sec resources for supplying data to be displayed as numbers.

Files

time2.g
time3.g

Resource Sets

These widgets use resources from the following sets:

Stopwatch Widget

The Stopwatch Widget measures the time elapsed between pressing its Start and Stop button. The widget does not reset the time count until its Reset button is pressed. This allows the total time for several time intervals to be measured. The time is measured with the precision of one second.

The stopwatch widget displays the elapsed time in the following format:

    <hours>:<minutes>:<seconds>

If the strings corresponding to the hours or minutes are deleted, the display shows the total number of expired minutes or seconds, without going back to zero at 59. That is, if the hour string is deleted, the clock will read "61:00" when 61 minutes have elapsed.

Files

time1.g

Resources

Meter (VIEWPORT): stopwatch viewport
Buttons (VIEWPORT): button panel

Resource Sets

This widget uses resources from the following sets:

Thermometer Widget

The Thermometer Widget displays a temperature value in both Co and Fo; allows the value to be changed using the mouse.

Files

gauge1.g

Resources

The Thermometer Widget has its own resource set, as follows:

FAxis (POLYGON, optional): Fo axis
FAxisLabel (TEXT, optional): Fo axis title
FMajorGroup (SERIES): Fo axis major ticks
FMajorTick (POLYGON): template major tick
Factor (DDATA): number of major ticks
FMinorGroupOne (SERIES): Fo axis minor ticks
FMinorGroup (SERIES): template for one set of minor ticks
FMinorTick (POLYGON): template minor tick
Factor (DDATA): number of minor ticks
LogType (DDATA): controls logarithmic positioning of minor ticks
Factor (DDATA, CONSTR): number of major ticks
FLabelGroup (SERIES): Fo axis major tick labels
FLabel (TEXT): template major tick label
Format (SDATA): format to use for displaying label values
Low (DDATA): low range of Fo values
High (DDATA): high range of Fo values
Factor (DDATA, CONSTR): number of major ticks
CAxis (POLYGON, optional): Co axis
CAxisLabel (TEXT, optional): Co axis title
CMajorGroup (SERIES): Co major ticks
CMajorTick (POLYGON): template major tick
Factor (DDATA): number of Co major ticks
CMinorGroupOne (SERIES): Co minor ticks
CMinorGroup (SERIES): template for one set of minor ticks
CMinorTick (POLYGON): template minor tick
Factor (DDATA): number of Co minor ticks
LogType (DDATA): controls logarithmic positioning of minor ticks
Factor (DDATA, CONSTR): number of Co major ticks
CLabelGroup (SERIES): Co major tick labels
CLabel (TEXT): template major tick label
Format (SDATA): format to use for displaying Co label values
Low (DDATA, CONSTR): low range of Co values
High (DDATA, CONSTR): high range of Co values
Factor (DDATA, CONSTR): number of Co major ticks

Resource Sets

This widget uses resources from the following sets:

Joystick Widgets

The Joystick Widgets provide several joystick controls to enter pairs of X and Y values using the mouse. The joysticks also provide a visual feedback displaying the current values.

Files

joystick1.g
joystick2.g
joystick3.g
joystick4.g
joystick5.g
joystick6.g

Resources

X1Label (TEXT, optional): X value title
Y1Label (TEXT, optional): Y value title

Resource Sets

These widgets use resources from the following sets:

Indicator Widgets

The Indicator Widget is a bevelled area displaying a numerical value. The Color Indicator is rendered as an alarm light that changes its color.

Files

Numerical Indicator: indicator1.g, indicator3.g, indicator4.g
Color Indicator: indicator2.g, indicator7.g, indicator8.g
Vertical Equalizer Indicator: indicator3.g
Horizontal Equalizer Indicator: indicator4.g

Resources

Element (POLYGON, optional): label highlight element

Resource Sets

These widgets use resources from the following sets:

Button Widgets

The Push Button Widget is a button with a visual feedback on press. It may be added to any other widget to provide an interface for triggering some action.

The GLG Widget Library also includes a set of directional buttons. This is a set of four buttons indicating up, down, left and right movements. These buttons are intended for use with the joystick widgets, GIS maps, etc. Simply paste the whole set into the joystick's viewport. To disable dithering, set the patterns factor of the button's viewport colortable to 0.

Files

Push Button: button1.g, button4.g, etc.
Set of Directional Buttons: button5.g, button6.g, button7.g, button8.g, etc.
Round Button: button3.g, etc.

Resource Sets

These widgets use resources from the following sets:

Two-Position Switch Widgets

These widgets compose a set of discrete-position switches with various appearances. A switch toggles between two discrete positions on a mouse click, providing visual feedback. Several switches may be combined together with other widgets to create custom control panels.

Files

switch1.g
switch2.g
switch3.g
switch4.g
switch5.g
switch6.g

Resources

OnLabel (TEXT): On State label
OffLabel (TEXT): Off State label
OnTick (POLYGON, optional): On tick
OffTick (POLYGON, optional): Off tick

Resource Sets

These widgets use resources from the following sets:

Multipositional Knob Widgets

These widgets compose a set of multipositional rotational switches with varying appearances. A switch reacts to the mouse clicks by moving its active element to indicate the discrete position closest to the mouse pick. Several switches may be combined together with other widgets to create custom control panels.

Files

switch7.g
switch8.g
knob9.g
knob10.g

Resources

LabelGroup (SERIES): position labels
Label (TEXT): template label
Factor (DDATA): number of labels
TickGroup (SERIES): position ticks
Tick (MARKER): template tick
Factor (DDATA, CONSTR): number of labels

Resource Sets

These widgets use resources from the following sets:

Multipositional Slider Widgets

These widgets compose a set of multipositional linear switches with varying appearances. A switch reacts to the mouse clicks by moving its active element to the discrete position closest to the mouse pick. Several switches may be combined together with other widgets to create custom control panels.

Files

switch9.g
switch10.g

Resources

LabelGroup (SERIES): position labels
Label (TEXT): template label
Factor (DDATA): number of labels
TickGroup (SERIES): position ticks
Tick (MARKER): template tick
Factor (DDATA, CONSTR): number of labels

Resource Sets

These widgets use resources from the following sets:

Knob Widgets

The Knob Widgets provide a set of knobs for entering a value using the mouse. The knobs can also provide a visual feedback for the current value. Several knobs may be combined together with other widgets to create custom control panels.

Files

knob1.g
knob2.g
knob3.g
knob4.g
knob5.g
knob6.g
knob7.g
knob8.g

Resources

MaxValueLabel (TEXT): maximum value label
MinValueLabel (TEXT): minimum value label

Resource Sets

These widgets use resources from the following sets:

Slider Widgets

The Slider Widgets provide a set of one-dimensional linear sliders for entering a value using the mouse. The sliders can also provide a visual feedback for the current value. Several sliders may be combined together with other widgets to create custom control panels.

Files

slider1.g
slider2.g
slider3.g
slider4.g
slider5.g
slider6.g
slider7.g
slider8.g
slider9.g
slider10.g
slider11.g
slider12.g
slider13.g
slider14.g

Resources

MaxValueLabel (TEXT): maximum value label
MinValueLabel (TEXT): minimum value label

Resource Sets

These widgets use resources from the following sets:

Palette Widgets

There are several Palette Widgets in the Library. The Color Palette displays a palette of colors, allowing the RGB color values to be selected with the mouse. To change the set of colors displayed in the palette, change the colortable of the Palette Widget's viewport and adjust the RowFactor and ColumnFactor attributes of the palette to match the NumColors and NumGrades attributes of the viewport's colortable. The palette's drawing contains two palettes for both the horizontal and the vertical layouts. The RowFactor attribute should correspond to the NumColors for the vertical color palette and to the NumGrades for the horizontal one.

The other palette widgets include the Line Width, Line Type, Font Size and Font Type Palettes. The number of palette entries may be changed using the Factor attribute of the palette's series object.

Files

Color Palette: palette1.g
Line Width Palette: palette2.g

Resource Sets

These widgets use resources from the Palette Resource Set.

Menu Widget

The Menu Widget displays a graphical menu object, presenting rows and columns of buttons and allowing a selection to be made with the mouse. The number of buttons may be changed by changing the values of the RowFactor and ColumnFactor attributes of the menu's square series object.

Any attribute of the graphical appearance as well as the layout of buttons may be customized using the GLG Graphics Builder. Once the button layout is established, the menu manages it by changing the buttons' positions and dimensions when the menu is resized.

The buttons of the menu can be made inactive by setting the DisableInput attribute of the button's viewport.

As with all the other GLG objects, buttons and menus may be made visible or invisible by simply changing the Visibility attribute of their viewports. This may be used to pop up and then erase a menu. Use the menu viewport control points to define the menu geometry. The control points may be given a name in order to access them programmatically.

Files

menu1.g

Resource Sets

This widget uses resources from the Menu Resource Set

Text Widget

The Text Widget provides a viewport into which a user can enter a one line text string. There are text widgets for both the string and numerical text entries.

Files

String text entry: text1.g
Integer number text entry: text2.g
Floating number text entry: text3.g

Resource Sets

This widget uses resources from the Text Resource Set

Font Browser Widget

The Font Browser Widget allows a user to choose from the variety of fonts on a given X server. A "filter" for using wildcard characters as well as a menu of possible choices for every field of the X font specification are provided, simplifying the font selection. This widget is not available on the Windows platform where a standard font browser is available.

Any attribute of the graphical appearance as well as the layout of the Font Browser Widget may be customized using the GLG Graphics Builder.

Files

menu2.g

Resource Sets

This widget uses resources from the Font Browser Resource Set.


Generic Logic, Inc.
www.genlogic.com
PREV NEXT