 |
Diagram
The class Diagram in package jcontrol.ui.vole.graph permits the continuous display of values in form of a two dimensional diagram. The rate of updating can freely be adjusted by the application. Range of values, scaling and caption can be adjusted by invoking one of the methods listed in table 1.
|
| Method | Description |
Diagram(int x, int y, int width, int height, int min, int max, int resolution) | Creates a Diagram object at the coordinates (x, y) with the desired range of values (min, max). The parameter resolution specifies the amount of simultaneously displayed values (scaling of the time axis). |
setCaption(String captionMin, String captionMax, int captionAlign) | Adds a caption to the Diagram. Both passed Strings will be displayed at the left or right edge, according to the value of captionAlign (ALIGN_LEFT or ALIGN_RIGHT). |
setValue(int value) | Passes a new value to the Diagram, that will be inserted at the rigth edge. The already displayed graph will be pushed one step to the left. |
Table 1: Methods of class jcontrol.ui.vole.graph.Diagram
The program example VoleDiagramExample is listed below and a screenshot is shown in Figure 1. The application creates a screen size Diagram instance, that is continuously provided with random values.
Download the archive VoleDiagramExample.zip to obtain the sources of the homonymous JControl/IDE project. Use the simulator to try the VoleDiagramExample yourself.
Figure 1: The VoleDiagramExample
| 1 | import jcontrol.lang.Math; |
| 2 | import jcontrol.lang.ThreadExt; |
| 3 | import jcontrol.ui.vole.Frame; |
| 4 | import jcontrol.ui.vole.Label; |
| 5 | import jcontrol.ui.vole.graph.Diagram; |
| 6 | |
| 7 | /** |
| 8 | * <p>This example demonstrates how to use the |
| 9 | * component Diagram within the GUI framework |
| 10 | * JControl/Vole.</p> |
| 11 | * |
| 12 | * <p>(C) DOMOLOGIC Home Automation GmbH 2003-2005</p> |
| 13 | */ |
| 14 | public class VoleDiagramExample extends Frame { |
| 15 | |
| 16 | /** |
| 17 | * Create a Diagram and fill it with some random values. |
| 18 | */ |
| 19 | public VoleDiagramExample() { |
| 20 | |
| 21 | // create the Diagram |
| 22 | Diagram dia = new Diagram(0, 10, 128, 40, 0, 20, 30); |
| 23 | dia.setCaption("0", "20", Diagram.ALIGN_LEFT); |
| 24 | add(dia); |
| 25 | |
| 26 | // add a Label |
| 27 | add(new Label("Diagram", 0, 52, 128, 10, Label.ALIGN_CENTER)); |
| 28 | |
| 29 | // show the frame |
| 30 | show(); |
| 31 | |
| 32 | // generate random values and pass them to the Diagram |
| 33 | for (;;) { |
| 34 | dia.setValue(Math.rnd(20)); |
| 35 | // sleep |
| 36 | try { |
| 37 | ThreadExt.sleep(500); |
| 38 | } catch (InterruptedException e) {} |
| 39 | } |
| 40 | } |
| 41 | |
| 42 | /** |
| 43 | * Create an instance of the VoleDiagramExample |
| 44 | */ |
| 45 | public static void main(String[] args) { |
| 46 | new VoleDiagramExample(); |
| 47 | } |
| 48 | } |
Listing 1: VoleDiagramExample.java
Diagram
