java.lang.Object

org.eclipse.nebula.widgets.oscilloscope.OscilloscopeDispatcher

public abstract class OscilloscopeDispatcher
extends java.lang.Object

Deprecated.

use OscilloscopeDispatcher

This class keeps the oscilloscope animation running and is used to set various attributes of the scope.

You need to provide an Oscilloscope widget by overriding the getOscilloscope() method. The Control.redraw() method will be called every getDelayLoop() milliseconds. The higher the value, the slower the animation will run.

Just before the redraw and just after the redraw the hook..Draw methods are called. Don't do any expensive calculations there because this will slow down the animation.

Then a counter is incremented and if the counter reaches the getPulse() value, then the hookSetValues(int) method is called. This is you opportunity to provide a value to the scope by calling its setValue or setValues method. The hookSetValues method is only called if the getPulse() value is greater than NO_PULSE

You can also be called back by the widget if it runs out of values by setting a listener in the Oscilloscope.addStackListener(OscilloscopeStackAdapter) method.

If you want to speed up the scope, try overriding the getProgression() method. This will draw the scope this number of times before actually painting.

Nested Class Summary

Nested Classes

Modifier and Type Class Description

class OscilloscopeDispatcher.PlayClip
Deprecated.

Plays a sound clip.

Field Summary

Fields
Modifier and Type	Field	Description
`static int[]`	`BACKGROUND_MONITOR`	Deprecated. Contains a small image that can serve as the background of the scope.
`static int[]`	`BACKGROUND_MONITOR_SMALL`	Deprecated. Contains a small image that can serve as the background of the scope.
`static int`	`NO_PULSE`	Deprecated. This is a special value indicating there is no pulse which means that `hookPulse(Oscilloscope, int)` will never be called.

Constructor Summary

Constructors

Constructor Description

OscilloscopeDispatcher()
Deprecated.

Method Summary

Modifier and Type	Method	Description
`void`	`dispatch()`	Deprecated. This method will get the animation going.
`protected void`	`finalize()`	Deprecated.
`org.eclipse.swt.graphics.Color`	`getActiveForegoundColor()`	Deprecated. Is used to get the color of the foreground when the thing that the scope is measuring is still alive.
`java.io.File`	`getActiveSoundfile()`	Deprecated. Override this to return a soundfile that will be played by the dispatcher in the `hookPulse(Oscilloscope, int)` method if the `isSoundRequired()` method returns true.
`org.eclipse.swt.graphics.Image`	`getBackgroundImage()`	Deprecated. Override this to return the background image for the scope.
`int`	`getBaseOffset()`	Deprecated. Override this to set the offset of the scope line in percentages where 100 is the top of the widget and 0 is the bottom.
`OscilloscopeDispatcher.PlayClip`	`getClipper()`	Deprecated. Override this to return the Clip player.
`int`	`getDelayLoop()`	Deprecated. Override this to return a draw delay in milliseconds.
`boolean`	`getFade()`	Deprecated.
`org.eclipse.swt.graphics.Color`	`getInactiveForegoundColor()`	Deprecated. Is used to get the color of the foreground when the thing that the scope is measuring is not active.
`java.io.File`	`getInactiveSoundfile()`	Deprecated.
`int`	`getLineWidth()`	Deprecated.
`abstract Oscilloscope`	`getOscilloscope()`	Deprecated. This method returns the `Oscilloscope`.
`int`	`getProgression()`	Deprecated. Override this to set the number of steps that is calculated before it is actually drawn on the display.
`int`	`getPulse()`	Deprecated.
`int`	`getSteadyPosition()`	Deprecated.
`int`	`getTailFade()`	Deprecated.
`int`	`getTailSize()`	Deprecated.
`void`	`hookAfterDraw(Oscilloscope oscilloscope, int counter)`	Deprecated. Is called just after the widget is redrawn every `getDelayLoop()` milliseconds.
`void`	`hookBeforeDraw(Oscilloscope oscilloscope, int counter)`	Deprecated. Is called just before the widget is redrawn every `getDelayLoop()` milliseconds.
`void`	`hookChangeAttributes()`	Deprecated. This method sets the values in the scope by calling the individual value methods in the dispatcher.
`void`	`hookPulse(Oscilloscope oscilloscope, int pulse)`	Deprecated. This method is called every time the dispatcher reaches the getPulse() counter.
`abstract void`	`hookSetValues(int pulse)`	Deprecated. This method will be called every `getPulse()` times the scope is redrawn which will occur every `getDelayLoop()` milliseconds (if your hardware is capable of doing so).
`void`	`init()`	Deprecated. Will be called only once.
`boolean`	`isPercentage()`	Deprecated.
`boolean`	`isServiceActive()`	Deprecated.
`boolean`	`isSoundRequired()`	Deprecated.
`boolean`	`isSteady()`	Deprecated.
`boolean`	`isTailSizeMax()`	Deprecated.
`boolean`	`mustConnect()`	Deprecated.

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details
- BACKGROUND_MONITOR
  
  public static final int[] BACKGROUND_MONITOR
  
  Deprecated.
  
  Contains a small image that can serve as the background of the scope.
- BACKGROUND_MONITOR_SMALL
  
  public static final int[] BACKGROUND_MONITOR_SMALL
  
  Deprecated.
  
  Contains a small image that can serve as the background of the scope.
- NO_PULSE
  
  public static final int NO_PULSE
  
  Deprecated.
  
  This is a special value indicating there is no pulse which means that hookPulse(Oscilloscope, int) will never be called.
  
  See Also:
  
  getPulse(), Constant Field Values
Constructor Details
- OscilloscopeDispatcher
  
  public OscilloscopeDispatcher()
  
  Deprecated.
Method Details
- dispatch
  
  public void dispatch()
  
  Deprecated.
  
  This method will get the animation going. It will create a runnable that will be dispatched to the user interface thread. The runnable increments a counter that leads to the getPulse() value and if this is reached then the counter is reset. The counter is passed to the hook methods so that they can prepare for the next pulse.
  After the hook methods are called, the runnable is placed in the user interface thread with a timer of getDelayLoop() milliseconds. However, if the delay loop is set to 1, it will dispatch using Display.asyncExec(Runnable) for maximum speed.
  This method is not meant to be overridden, override hookBeforeDraw(Oscilloscope, int), hookAfterDraw(Oscilloscope, int) and hookPulse(Oscilloscope, int).
- finalize
  
  protected void finalize() throws java.lang.Throwable
  
  Deprecated.
  
  Overrides:
  
  finalize in class java.lang.Object
  
  Throws:
  
  java.lang.Throwable
- getActiveForegoundColor
  
  public org.eclipse.swt.graphics.Color getActiveForegoundColor()
  
  Deprecated.
  
  Is used to get the color of the foreground when the thing that the scope is measuring is still alive. The aliveness of the thing that is being measured is returned by the isServiceActive() method. The result of this method will be used in the Control.setForeground(Color) method.
  
  Returns:
  
  the system color green. Override if you want to control the foreground color.
  
  See Also:
  
  getInactiveForegoundColor(), Control.setForeground(Color)
- getActiveSoundfile
  
  public java.io.File getActiveSoundfile()
  
  Deprecated.
  
  Override this to return a soundfile that will be played by the dispatcher in the hookPulse(Oscilloscope, int) method if the isSoundRequired() method returns true.
  
  Returns:
  
  null. Override to return a file that can be played by your sound hardware.
- getBackgroundImage
  
  public org.eclipse.swt.graphics.Image getBackgroundImage()
  
  Deprecated.
  
  Override this to return the background image for the scope.
  
  Returns:
  
  the image stored in BACKGROUND_MONITOR. Override to supply your own Image.
- getBaseOffset
  
  public int getBaseOffset()
  
  Deprecated.
  
  Override this to set the offset of the scope line in percentages where 100 is the top of the widget and 0 is the bottom.
  
  Returns:
  
  Oscilloscope.BASE_CENTER which positions in the center. Override for other values.
- getClipper
  
  public OscilloscopeDispatcher.PlayClip getClipper()
  
  Deprecated.
  
  Override this to return the Clip player.
  Overriding this method is not expected.
  
  Returns:
  
  the PlayClip object
- getDelayLoop
  
  public int getDelayLoop()
  
  Deprecated.
  
  Override this to return a draw delay in milliseconds. The scope will progress getProgression() steps.
  
  Returns:
  
  30 milliseconds. Override with a smaller value for more speed.
- getFade
  
  public boolean getFade()
  
  Deprecated.
- getInactiveForegoundColor
  
  public org.eclipse.swt.graphics.Color getInactiveForegoundColor()
  
  Deprecated.
  
  Is used to get the color of the foreground when the thing that the scope is measuring is not active. The aliveness of the thing that is being measured is returned by the isServiceActive() method. The result of this method will be used in the Control.setForeground(Color) method.
  
  Returns:
  
  the system color red, override if you want to control the inactive foreground color
  
  See Also:
  
  getActiveForegoundColor(), Control.setForeground(Color)
- getInactiveSoundfile
  
  public java.io.File getInactiveSoundfile()
  
  Deprecated.
- getLineWidth
  
  public int getLineWidth()
  
  Deprecated.
- getOscilloscope
  
  public abstract Oscilloscope getOscilloscope()
  
  Deprecated.
  
  This method returns the Oscilloscope.
  
  Returns:
  
  the oscilloscope
- getProgression
  
  public int getProgression()
  
  Deprecated.
  
  Override this to set the number of steps that is calculated before it is actually drawn on the display. This will make the graphic look more jumpy for slower/higher delay rates but you can win speed at faster/lower delay rates. There will be getProgression() values consumed so make sure that the value stack contains enough entries.
  If the getDelayLoop() is 10 and the getPulse() is 1 and the getProgression() is 5 then every 10 milliseconds the graph will have progressed 5 pixels. If you want to avoid gaps in your graph, you need to input 5 values every time you reach hookSetValues(int). If the getPulse() is 3, you need to input 15 values for a gapless graph. Alternatively, you can implement a stack listener in the scope to let it call you in case it runs out of values.
  
  Returns:
  
  1. Override and increment for more speed. Must be higher then zero.
- getPulse
  
  public int getPulse()
  
  Deprecated.
- getSteadyPosition
  
  public int getSteadyPosition()
  
  Deprecated.
- getTailFade
  
  public int getTailFade()
  
  Deprecated.
- getTailSize
  
  public int getTailSize()
  
  Deprecated.
- hookAfterDraw
  
  public void hookAfterDraw(Oscilloscope oscilloscope, int counter)
  
  Deprecated.
  
  Is called just after the widget is redrawn every getDelayLoop() milliseconds. The pulse counter will be set to zero when it reaches getPulse().
  
  Parameters:
  
  oscilloscope -
  
  counter -
- hookBeforeDraw
  
  public void hookBeforeDraw(Oscilloscope oscilloscope, int counter)
  
  Deprecated.
  
  Is called just before the widget is redrawn every getDelayLoop() milliseconds. It will also call the hookChangeAttributes() method if the number of times this method is called matches the getPulse() value. The pulse counter will be set to zero when it reaches getPulse().
  If you override this method, don't forget to call hookChangeAttributes() every now and then.
  
  Parameters:
  
  oscilloscope -
  
  counter -
- hookChangeAttributes
  
  public void hookChangeAttributes()
  
  Deprecated.
  
  This method sets the values in the scope by calling the individual value methods in the dispatcher. Be aware that this method actually calls some candy so you might want to call super.
- hookPulse
  
  public void hookPulse(Oscilloscope oscilloscope, int pulse)
  
  Deprecated.
  
  This method is called every time the dispatcher reaches the getPulse() counter. This method plays the active or inactive sound if so required. If you do not want the sounds to play, either disable sounds by not overriding the isSoundRequired() method or override this method.
  
  Parameters:
  
  oscilloscope -
  
  pulse -
- hookSetValues
  
  public abstract void hookSetValues(int pulse)
  
  Deprecated.
  
  This method will be called every getPulse() times the scope is redrawn which will occur every getDelayLoop() milliseconds (if your hardware is capable of doing so). The scope will progress one pixel every getDelayLoop() milliseconds and will draw the next value from the queue of the scope. If the scope is out of values it will progress one pixel without a value (draw a pixel at his center).
  If the delay loop is 10 and the pulse is 20, you have an opportunity to set a value in the scope every 200 milliseconds. In this time the scope will have progressed 20 pixels. If you supply 10 values by calling the setValue(int) 10 times or if you call the setValues(int[]) with 10 ints then you will see 10 pixels of movement and a straight line of 10 pixels.
  If the setPulse method is not overridden or if you supply NO_PULSE then this method will not be called unless you override the dispatch method (not recommended). To still set values in the scope you can set a stack listener in the widget that will be called when there are no more values in the stack. Alternatively you can set the return value of getPulse() to 1 so you have the opportunity to provide a value every cycle.
  
  Parameters:
  
  pulse -
  
  See Also:
  
  Oscilloscope.setValue(int), Oscilloscope.setValues(int[]), Oscilloscope.addStackListener(OscilloscopeStackAdapter)
- init
  
  public void init()
  
  Deprecated.
  
  Will be called only once.
- isPercentage
  
  public boolean isPercentage()
  
  Deprecated.
- isServiceActive
  
  public boolean isServiceActive()
  
  Deprecated.
- isSoundRequired
  
  public boolean isSoundRequired()
  
  Deprecated.
- isSteady
  
  public boolean isSteady()
  
  Deprecated.
- isTailSizeMax
  
  public boolean isTailSizeMax()
  
  Deprecated.
- mustConnect
  
  public boolean mustConnect()
  
  Deprecated.

Class OscilloscopeDispatcher

Nested Class Summary

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Details

Constructor Details

Method Details