ucar.unidata.idv

Interface DisplayControl

All Superinterfaces:

Sharable

All Known Implementing Classes:

ADTControl, AerologicalSoundingControl, AnimationTextControl, AudioControl, BaseImageControl, CappiControl, ChatLogControl, ColorCrossSectionControl, ColorPlanViewControl, ColorRadarVolumeControl, ColorRhiControl, ContourCrossSectionControl, ContourPlanViewControl, CrossSectionControl, DataTransectControl, DisplayControlImpl, DrawingControl, FlowCrossSectionControl, FlowPlanViewControl, FlowTimeHeightControl, FrontDrawingControl, Grid2DReadoutProbe, GriddedSkewTControl, GriddedSoundingControl, GridDisplayControl, GridTableControl, GridTrajectoryControl, GridTrajectoryControl.MyTrackControl, GridTrajectoryControlNew, GridTrajectoryControlNew.MyTrajectoryControl, HovmollerControl, HydraControl, ImageControl, ImageMovieControl, ImagePlanViewControl, ImageSequenceControl, JythonControl, Level2ColorCrossSectionControl, Level2TimeHeightControl, LineProbeControl, LocationIndicatorControl, MapDisplayControl, MovieDisplayControl, MultiDisplayHolder, NoteControl, ObsDisplayControl, ObsListControl, OmniControl, PlanViewControl, PointCloudControl, ProbeControl, ProfileControl, ProfilerControl, ProfilerMultiStationControl, ProfilerTimeHeightControl, RadarCrossSectionControl, RadarEditor, RadarEditor.MyRadarSweepControl, RadarGridControl, RadarRhiControl, RadarSweepControl, RadarVWPControl, RangeAndBearingControl, RaobSkewTControl, RaobSoundingControl, RGBCompositeControl, ScatterDisplay, ShapefileControl, SkewTControl, StationLocationControl, StationModelControl, TemplateControl, TextDisplayControl, TextProductControl, ThreeDSurfaceControl, TimeHeightControl, TimeSeriesControl, TopographyControl, TrackControl, TrackSkewTControl, TrackSoundingControl, TrajectoryFeatureTypeSoundingControl, TransectDrawingControl, ValuePlanViewControl, VerticalProfileControl, VolumeRenderControl, VolumeVectorControl, WindTimeHeightControl, WMSControl, WorldWindControl, YahooLocationControl

public interface DisplayControl
extends Sharable

A class to support controling the aspects of a display.

Author:

IDV Development Team

Field Summary

Fields

Modifier and Type	Field and Description
static int	BOTTOM_LEGEND Bottom type legend
static java.lang.String	DEFAULT_PROBEFORMAT Default format for probe format
static java.lang.String	PREF_PREFIX Preference prefix for preferences of this class.
static java.lang.String	PREF_PROBEFORMAT Preference for probe format
static java.lang.String	PREF_REMOVEONWINDOWCLOSE Preference for whether the control should be removed when the window is closed
static java.lang.String	PREF_SAMPLING_MODE Preference for sampling mode
static java.lang.String	PREF_STANDALONE_REMOVEONCLOSE Should we remove stand alone display controls when their window is closed
static java.lang.String	PREF_STANDALONE_REMOVEONCLOSE_ASK Should we ask the user if they want to remove stand alone display controls
static java.lang.String	PROP_LEGENDICON The property name of the String path or url of the icon this display control should show in its legend.
static int	RASTERMODE_SHOWALL Show all flag
static int	RASTERMODE_SHOWNONRASTER Show no raster flag
static int	RASTERMODE_SHOWRASTER Show raster flag
static int	SIDE_LEGEND Side type legend

Method Summary

Modifier and Type	Method and Description
void	applyPreferences() Apply preferences to this control.
boolean	canBeDocked() Can this be docked
javax.swing.JCheckBox	doMakeVisibilityControl(java.lang.String label) Make a visibility control as a JCheckbox.
void	doRemove() Called when the DisplayControl is removed from the display
void	firstFrameDone() Method to call when the first frame has been rendered.
boolean	getActive() Is this control active or has it been removed
boolean	getCanDoRemoveAll() See if this DisplayControl can remove all controls.
java.util.List	getCategories() Get the list of DataCategorys
boolean	getCollapseLegend() Get the collapsed state of the legend.
java.util.List	getControlMenus(javax.swing.JComponent comp) Get the menus for this control.
java.util.List	getCursorReadout(visad.georef.EarthLocation el, visad.Real animationValue, int animationStep, java.util.List<ReadoutInfo> samples) Get the cursor readout
DataChoice	getDataChoice() Get the DataChoice associated with this control.
java.util.List	getDataChoices() Get the list of DataChoices associated with this control.
visad.Data	getDataForDisplayList() Get the data for the display list
visad.georef.MapProjection	getDataProjection() Get the MapProjection associated with the data in this DisplayControl.
ViewManager	getDefaultViewManager() Get the default view manager for this control
java.lang.String	getDisplayCategory() Get the display category for this DisplayControl.
java.lang.String	getDisplayId() Get the display id for this control.
DisplayableData	getDisplayListDisplayable(ViewManager view) Get the displayable for the display list for the particular view
boolean	getDisplayVisibility() Get the display's visibility.
boolean	getExpandedInTabs() Is this control expanded when it is shown in the main tabs
boolean	getIsTimeDriver() is this display the one that drives time selection for other displays
java.lang.String	getLabel() Get a label describing control
javax.swing.JComponent	getLegendButtons(int legendType) Get the legend component for the type of legend
javax.swing.JComponent	getLegendComponent(int legendType) Get the legend component for the type of legend
javax.swing.JComponent	getLegendLabel(int legendType) Get the legend lable for the type of legend
boolean	getLockVisibilityToggle() Get whether the visibility of this display control is locked (could be on or off)
java.lang.String	getMenuLabel() Get the text that should show up in a menu listing this control.
boolean	getShowInDisplayList() Should this display be shown in the display list
boolean	getShowInLegend() Should the display control be shown in a legend
boolean	getShowInTabs() Should we show this control in the main tabs
visad.Set	getTimeSet() get the time set of the data
java.lang.Object	getTmpProperty(java.lang.Object key) Get the tmp property.
java.lang.Object	getTransientProperty(java.lang.Object key) Find a property on the display control.
ViewManager	getViewManager() Get the view manager for this control
int	getVisbilityAnimationPause() How long should this display be shown when in visibility animation mode
javax.swing.JFrame	getWindow() Get the control window for this DisplayControl.
void	init(java.lang.String displayId, java.util.List dataCategories, java.util.List choices, ControlContext viewer, java.util.Hashtable properties, DataSelection dataSelection) Initialize the DisplayControl.
void	init(java.lang.String displayId, java.util.List dataCategories, java.util.List choices, ControlContext viewer, java.lang.String properties, DataSelection dataSelection) Deprecated. Use init that that takes a properties Hashtable
void	initAfterUnPersistence(ControlContext vc, java.util.Hashtable properties) Method to call after unpersisting from XML.
void	initAfterUnPersistence(ControlContext vc, java.util.Hashtable properties, java.util.List dataChoices) Initialize after unpersistance
void	initAsTemplate() Intialize the display control when it is created from a template
void	initBasic(java.lang.String displayId, java.util.List categories, java.util.Hashtable properties) Do basic initialization.
boolean	isInitDone() Are we fully initialized
javax.swing.JLabel	makeLegendLabel() Make a label like the one in the legend
void	moveTo(ViewManager viewManager) Move this control to a different ViewManager.
void	projectionChanged() Method called when a map projection changes.
void	putTmpProperty(java.lang.Object key, java.lang.Object value) put the tmp property.
void	putTransientProperty(java.lang.Object key, java.lang.Object value) Put a property on the display control.
java.lang.Object	removeTmpProperty(java.lang.Object key) remove the tmp property
void	saveImage(java.lang.String filename) Save an image of this control to a file.
void	setCollapseLegend(boolean collapse) Set the collapsed state of the legend.
void	setDisplayCategory(java.lang.String category) Set the display category
void	setDisplayVisibility(boolean b) Set the display's visibility.
void	setExpandedInTabs(boolean value) Set whether this control expanded when it is shown in the main tabs
void	setLegendBackground(java.awt.Color bg) Set the background color on the legend component
void	setLegendForeground(java.awt.Color fg) Set the foreground color on the legend component
void	setLockVisibilityToggle(boolean value) Set whether the visibility of this display control is locked (could be on or off)
void	setShowInTabs(boolean value) Set whether to show this control in the main tabs
boolean	shouldBeDocked() Should this be docked?
void	show() Show this control's component
void	showHelp() Show help
void	toFront() Bring this control's component to the front
void	toggleVisibilityForVectorGraphicsRendering(int rasterMode) Toggle the visibility for vector graphics rendering based on mode
void	toggleWindow() Hide or show the main window
void	transectChanged() Method called when a transect changes.
void	viewManagerChanged(java.lang.String property) Method called when a view manager changes.
void	viewManagerDestroyed(ViewManager viewManager) Called when a ViewManager which holds the display is destoryed
void	writeTestArchive(java.lang.String archivePath) This is called when we are generating a test archive of images from all components

Methods inherited from interface ucar.unidata.collab.Sharable

getReceiveShareTime, getShareGroup, getSharing, getUniqueId, receiveShareData, setReceiveShareTime

Field Detail

PREF_PREFIX

static final java.lang.String PREF_PREFIX

Preference prefix for preferences of this class.

See Also:

Constant Field Values

PROP_LEGENDICON

static final java.lang.String PROP_LEGENDICON

The property name of the String path or url of the icon this display control should show in its legend.

See Also:

Constant Field Values

PREF_SAMPLING_MODE

static final java.lang.String PREF_SAMPLING_MODE

Preference for sampling mode

See Also:

Constant Field Values

PREF_PROBEFORMAT

static final java.lang.String PREF_PROBEFORMAT

Preference for probe format

See Also:

Constant Field Values

DEFAULT_PROBEFORMAT

static final java.lang.String DEFAULT_PROBEFORMAT

Default format for probe format

See Also:

Constant Field Values

PREF_REMOVEONWINDOWCLOSE

static final java.lang.String PREF_REMOVEONWINDOWCLOSE

Preference for whether the control should be removed when the window is closed

See Also:

Constant Field Values

PREF_STANDALONE_REMOVEONCLOSE

static final java.lang.String PREF_STANDALONE_REMOVEONCLOSE

Should we remove stand alone display controls when their window is closed

See Also:

Constant Field Values

PREF_STANDALONE_REMOVEONCLOSE_ASK

static final java.lang.String PREF_STANDALONE_REMOVEONCLOSE_ASK

Should we ask the user if they want to remove stand alone display controls

See Also:

Constant Field Values

BOTTOM_LEGEND

static final int BOTTOM_LEGEND

Bottom type legend

See Also:

Constant Field Values

SIDE_LEGEND

static final int SIDE_LEGEND

Side type legend

See Also:

Constant Field Values

RASTERMODE_SHOWRASTER

static final int RASTERMODE_SHOWRASTER

Show raster flag

See Also:

Constant Field Values

RASTERMODE_SHOWNONRASTER

static final int RASTERMODE_SHOWNONRASTER

Show no raster flag

See Also:

Constant Field Values

RASTERMODE_SHOWALL

static final int RASTERMODE_SHOWALL

Show all flag

See Also:

Constant Field Values

Method Detail

init

void init(java.lang.String displayId,
          java.util.List dataCategories,
          java.util.List choices,
          ControlContext viewer,
          java.lang.String properties,
          DataSelection dataSelection)
   throws visad.VisADException,
          java.rmi.RemoteException

Deprecated. Use init that that takes a properties Hashtable

Initialize the DisplayControl.

Parameters:

displayId - the display id

dataCategories - the DisplayControl's data categories

choices - a list of DataChoices

viewer - the control context in which this is viewed

properties - properties

dataSelection - specific data selection properties

Throws:

java.rmi.RemoteException - Java RMI error

visad.VisADException - VisAD error

init

void init(java.lang.String displayId,
          java.util.List dataCategories,
          java.util.List choices,
          ControlContext viewer,
          java.util.Hashtable properties,
          DataSelection dataSelection)
   throws visad.VisADException,
          java.rmi.RemoteException

Initialize the DisplayControl.

Parameters:

displayId - the display id

dataCategories - the DisplayControl's data categories

choices - a list of DataChoices

viewer - the control context in which this is viewed

properties - extra properties

dataSelection - specific data selection properties

Throws:

java.rmi.RemoteException - Java RMI error

visad.VisADException - VisAD error

isInitDone

boolean isInitDone()

Are we fully initialized

Returns:

is init done

getWindow

javax.swing.JFrame getWindow()

Get the control window for this DisplayControl.

Returns:

The window that this display control is shown in

getLockVisibilityToggle

boolean getLockVisibilityToggle()

Get whether the visibility of this display control is locked (could be on or off)

Returns:

true if locked.

getShowInDisplayList

boolean getShowInDisplayList()

Should this display be shown in the display list

Returns:

Show in the display list

getDisplayListDisplayable

DisplayableData getDisplayListDisplayable(ViewManager view)

Get the displayable for the display list for the particular view

Parameters:

view - The view manager

Returns:

Displayable to show

getDataForDisplayList

visad.Data getDataForDisplayList()

Get the data for the display list

Returns:

the data

setLockVisibilityToggle

void setLockVisibilityToggle(boolean value)

Set whether the visibility of this display control is locked (could be on or off)

Parameters:

value - true to lock to current state

getLegendComponent

javax.swing.JComponent getLegendComponent(int legendType)

Get the legend component for the type of legend

Parameters:

legendType - type of legend (BOTTOM, SIDE)

Returns:

component for that legend

getLegendButtons

javax.swing.JComponent getLegendButtons(int legendType)

Get the legend component for the type of legend

Parameters:

legendType - type of legend (BOTTOM, SIDE)

Returns:

component for that legend

setCollapseLegend

void setCollapseLegend(boolean collapse)

Set the collapsed state of the legend.

Parameters:

collapse - true to collapse the legend.

getCollapseLegend

boolean getCollapseLegend()

Get the collapsed state of the legend.

Returns:

true if legend collapsed

getLegendLabel

javax.swing.JComponent getLegendLabel(int legendType)

Get the legend lable for the type of legend

Parameters:

legendType - type of legend (BOTTOM, SIDE)

Returns:

the legend label

doRemove

void doRemove()
       throws visad.VisADException,
              java.rmi.RemoteException

Called when the DisplayControl is removed from the display

Throws:

java.rmi.RemoteException - Java RMI error

visad.VisADException - VisAD error

viewManagerDestroyed

void viewManagerDestroyed(ViewManager viewManager)
                   throws visad.VisADException,
                          java.rmi.RemoteException

Called when a ViewManager which holds the display is destoryed

Parameters:

viewManager - The view manager that has been destroyed

Throws:

java.rmi.RemoteException - Java RMI error

visad.VisADException - VisAD error

getCanDoRemoveAll

boolean getCanDoRemoveAll()

See if this DisplayControl can remove all controls.

Returns:

true if it can remove all

getActive

boolean getActive()

Is this control active or has it been removed

Returns:

is active

getDataChoice

DataChoice getDataChoice()

Get the DataChoice associated with this control.

Returns:

the DataChoice (can be null)

getDataChoices

java.util.List getDataChoices()

Get the list of DataChoices associated with this control.

Returns:

the list of DataChoice-s

getDisplayId

java.lang.String getDisplayId()

Get the display id for this control.

Returns:

the display id

getMenuLabel

java.lang.String getMenuLabel()

Get the text that should show up in a menu listing this control.

Returns:

text for menu

getControlMenus

java.util.List getControlMenus(javax.swing.JComponent comp)

Get the menus for this control.

Parameters:

comp - component for placement of window (can be null)

Returns:

list of menus

getLabel

java.lang.String getLabel()

Get a label describing control

Returns:

a descriptive label

moveTo

void moveTo(ViewManager viewManager)

Move this control to a different ViewManager.

Parameters:

viewManager - ViewManager to move to.

getViewManager

ViewManager getViewManager()

Get the view manager for this control

Returns:

the ViewManager

getDefaultViewManager

ViewManager getDefaultViewManager()

Get the default view manager for this control

Returns:

the default view manager for this control

saveImage

void saveImage(java.lang.String filename)

Save an image of this control to a file.

Parameters:

filename - filename to save to

toFront

void toFront()

Bring this control's component to the front

makeLegendLabel

javax.swing.JLabel makeLegendLabel()

Make a label like the one in the legend

Returns:

label

show

void show()

Show this control's component

toggleWindow

void toggleWindow()

Hide or show the main window

setDisplayVisibility

void setDisplayVisibility(boolean b)

Set the display's visibility.

Parameters:

b - true to set it visible

getDisplayVisibility

boolean getDisplayVisibility()

Get the display's visibility.

Returns:

true if visible

toggleVisibilityForVectorGraphicsRendering

void toggleVisibilityForVectorGraphicsRendering(int rasterMode)
                                         throws java.lang.Exception

Toggle the visibility for vector graphics rendering based on mode

Parameters:

rasterMode - mode to use

Throws:

java.lang.Exception - problem toggling

doMakeVisibilityControl

javax.swing.JCheckBox doMakeVisibilityControl(java.lang.String label)

Make a visibility control as a JCheckbox.

Parameters:

label - label for the visibility checkbox

Returns:

checkbox for toggling visibility

setLegendForeground

void setLegendForeground(java.awt.Color fg)

Set the foreground color on the legend component

Parameters:

fg - foreground color

setLegendBackground

void setLegendBackground(java.awt.Color bg)

Set the background color on the legend component

Parameters:

bg - background color

initAfterUnPersistence

void initAfterUnPersistence(ControlContext vc,
                            java.util.Hashtable properties)

Method to call after unpersisting from XML.

Parameters:

vc - control context for this DisplayControl.

properties - A place to put properties

initAfterUnPersistence

void initAfterUnPersistence(ControlContext vc,
                            java.util.Hashtable properties,
                            java.util.List dataChoices)

Initialize after unpersistance

Parameters:

vc - the control context

properties - the properties

dataChoices - the list of data choices

initAsTemplate

void initAsTemplate()

Intialize the display control when it is created from a template

initBasic

void initBasic(java.lang.String displayId,
               java.util.List categories,
               java.util.Hashtable properties)

Do basic initialization. This is for display controls that server as prototype objects

Parameters:

displayId - id

categories - display categories

properties - properties

firstFrameDone

void firstFrameDone()

Method to call when the first frame has been rendered.

writeTestArchive

void writeTestArchive(java.lang.String archivePath)

This is called when we are generating a test archive of images from all components

Parameters:

archivePath - Where to write the images

getDataProjection

visad.georef.MapProjection getDataProjection()

Get the MapProjection associated with the data in this DisplayControl.

Returns:

data projection

projectionChanged

void projectionChanged()

Method called when a map projection changes.

transectChanged

void transectChanged()

Method called when a transect changes.

viewManagerChanged

void viewManagerChanged(java.lang.String property)

Method called when a view manager changes.

Parameters:

property - the property that changed

getDisplayCategory

java.lang.String getDisplayCategory()

Get the display category for this DisplayControl.

Returns:

category for this control.

setDisplayCategory

void setDisplayCategory(java.lang.String category)

Set the display category

Parameters:

category - the display category

getCategories

java.util.List getCategories()

Get the list of DataCategorys

Returns:

List of data categories

getTransientProperty

java.lang.Object getTransientProperty(java.lang.Object key)

Find a property on the display control. These properties are not saved.

Parameters:

key - The key

Returns:

The value

putTransientProperty

void putTransientProperty(java.lang.Object key,
                          java.lang.Object value)

Put a property on the display control. These properties are not saved.

Parameters:

key - The key

value - The value

applyPreferences

void applyPreferences()

Apply preferences to this control.

getShowInLegend

boolean getShowInLegend()

Should the display control be shown in a legend

Returns:

Should this display control be shown in a legend

showHelp

void showHelp()

Show help

getExpandedInTabs

boolean getExpandedInTabs()

Is this control expanded when it is shown in the main tabs

Returns:

expanded in tabs

setExpandedInTabs

void setExpandedInTabs(boolean value)

Set whether this control expanded when it is shown in the main tabs

Parameters:

value - value

getShowInTabs

boolean getShowInTabs()

Should we show this control in the main tabs

Returns:

show in main tabs

shouldBeDocked

boolean shouldBeDocked()

Should this be docked?

Returns:

true if docked

canBeDocked

boolean canBeDocked()

Can this be docked

Returns:

true if can be docked

setShowInTabs

void setShowInTabs(boolean value)

Set whether to show this control in the main tabs

Parameters:

value - value

getTimeSet

visad.Set getTimeSet()
              throws java.rmi.RemoteException,
                     visad.VisADException

get the time set of the data

Returns:

date times

Throws:

java.rmi.RemoteException - on badness

visad.VisADException - on badness

getCursorReadout

java.util.List getCursorReadout(visad.georef.EarthLocation el,
                                visad.Real animationValue,
                                int animationStep,
                                java.util.List<ReadoutInfo> samples)
                         throws java.lang.Exception

Get the cursor readout

Parameters:

el - position

animationValue - animation value

animationStep - animation index

samples - the list of samples to add to

Returns:

List of values

Throws:

java.lang.Exception - problem getting the cursor readout

getTmpProperty

java.lang.Object getTmpProperty(java.lang.Object key)

Get the tmp property.

Parameters:

key - key

Returns:

property

putTmpProperty

void putTmpProperty(java.lang.Object key,
                    java.lang.Object value)

put the tmp property. These are not persisted off

Parameters:

key - key

value - value

removeTmpProperty

java.lang.Object removeTmpProperty(java.lang.Object key)

remove the tmp property

Parameters:

key - key

Returns:

the value or null if not found

getVisbilityAnimationPause

int getVisbilityAnimationPause()

How long should this display be shown when in visibility animation mode

Returns:

-1 if it is undefined. 0 if this one should not be used. else treat the value as seconds

getIsTimeDriver

boolean getIsTimeDriver()

is this display the one that drives time selection for other displays

Returns:

true if this is the time driver