jwo.landserf.gui
Class ShadeReliefBox

java.lang.Object
  extended by java.awt.Component
      extended by java.awt.Container
          extended by java.awt.Window
              extended by java.awt.Dialog
                  extended by javax.swing.JDialog
                      extended by jwo.utils.gui.JWDialogue
                          extended by jwo.landserf.gui.ShadeReliefBox
All Implemented Interfaces:
ActionListener, ImageObserver, MenuContainer, Serializable, EventListener, Accessible, ChangeListener, RootPaneContainer, WindowConstants

public class ShadeReliefBox
extends JWDialogue
implements ChangeListener, ActionListener

Creates a dialogue box for setting shaded relief parameters.

Version:
2.3, 6th October, 2007.
Author:
Jo Wood
See Also:
Serialized Form

Nested Class Summary
 
Nested classes/interfaces inherited from class javax.swing.JDialog
JDialog.AccessibleJDialog
 
Nested classes/interfaces inherited from class java.awt.Dialog
Dialog.AccessibleAWTDialog
 
Nested classes/interfaces inherited from class java.awt.Window
Window.AccessibleAWTWindow
 
Nested classes/interfaces inherited from class java.awt.Container
Container.AccessibleAWTContainer
 
Nested classes/interfaces inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy
 
Field Summary
 
Fields inherited from class jwo.utils.gui.JWDialogue
DIALOGUE, MONOLOGUE
 
Fields inherited from class javax.swing.JDialog
accessibleContext, rootPane, rootPaneCheckingEnabled
 
Fields inherited from class java.awt.Component
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
 
Fields inherited from interface javax.swing.WindowConstants
DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, EXIT_ON_CLOSE, HIDE_ON_CLOSE
 
Fields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
 
Constructor Summary
ShadeReliefBox(GISFrame gisFrame, float azim, float alt, float pShade, float zScale, float aspectWeight, float ambient, float diffuse, float specular, float shine)
          Creates the dialogue box for parameter entry.
 
Method Summary
 void actionPerformed(ActionEvent e)
          Responds to a button press by showing or removing advanced options.
 float getAlt()
          Returns the currently selected sun elevation angle (radians).
 float getAmbient()
          Returns the ambient light component.
 float getAspectWeight()
          Returns the currently selected aspect bias.
 float getAzim()
          Returns the currently selected sun azimuth angle (radians).
 float getDiffuse()
          Returns the diffuse light component.
 float getPShade()
          Returns the currently selected proportion of shaded relief scaled between 0 (no shading) and 1 (monochrome shaded relief).
 float getShadeExaggeration()
          Returns the currently vertical exaggeration used for calculating relief.
 float getShine()
          Returns the currently selected shine value.
 float getSpecular()
          Returns the specular light component.
 void stateChanged(ChangeEvent e)
          Responds to a change in a slider by updating thumbnail.
 
Methods inherited from class jwo.utils.gui.JWDialogue
addDialogueListener, checkInput, closedown, getContentPane, isChanged, removeDialogueListener, setFullBackground
 
Methods inherited from class javax.swing.JDialog
addImpl, createRootPane, dialogInit, getAccessibleContext, getDefaultCloseOperation, getGlassPane, getJMenuBar, getLayeredPane, getRootPane, isDefaultLookAndFeelDecorated, isRootPaneCheckingEnabled, paramString, processWindowEvent, remove, setContentPane, setDefaultCloseOperation, setDefaultLookAndFeelDecorated, setGlassPane, setJMenuBar, setLayeredPane, setLayout, setRootPane, setRootPaneCheckingEnabled, update
 
Methods inherited from class java.awt.Dialog
addNotify, getTitle, hide, isModal, isResizable, isUndecorated, setModal, setResizable, setTitle, setUndecorated, show
 
Methods inherited from class java.awt.Window
addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, dispose, finalize, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getGraphicsConfiguration, getInputContext, getListeners, getLocale, getMostRecentFocusOwner, getOwnedWindows, getOwner, getToolkit, getWarningString, getWindowFocusListeners, getWindowListeners, getWindowStateListeners, isActive, isAlwaysOnTop, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isShowing, pack, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, setAlwaysOnTop, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setLocationByPlatform, setLocationRelativeTo, toBack, toFront
 
Methods inherited from class java.awt.Container
add, add, add, add, add, addContainerListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paint, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, removeAll, removeContainerListener, removeNotify, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, transferFocusBackward, transferFocusDownCycle, validate, validateTree
 
Methods inherited from class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, setBackground, setBounds, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setName, setPreferredSize, setSize, setSize, setVisible, show, size, toString, transferFocus, transferFocusUpCycle
 
Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

ShadeReliefBox

public ShadeReliefBox(GISFrame gisFrame,
                      float azim,
                      float alt,
                      float pShade,
                      float zScale,
                      float aspectWeight,
                      float ambient,
                      float diffuse,
                      float specular,
                      float shine)
Creates the dialogue box for parameter entry.

Parameters:
gisFrame - GUI that requested this dialogue.
azim - Initial sun azimuth angle (radians).
alt - Initial sun elevation angle (radians).
pShade - Initial proportion shaded relief scaled between 0 and 1.
zScale - Initial vertical exaggeration factor.
aspectWeight - Extra weighting to give to aspect (used to highlight local detail).
ambient - Ambient light component scaled between 0 and 1.
diffuse - Diffuse light component scaled between 0 and 1.
specular - Specular light component scaled between 0 and 1.
shine - Shininess value scaled between 0 (matt) and 1 (polished metal).
Method Detail

getAzim

public float getAzim()
Returns the currently selected sun azimuth angle (radians).

Returns:
Sun azimuth in radians.

getAlt

public float getAlt()
Returns the currently selected sun elevation angle (radians).

Returns:
Sun elevation in radians.

getPShade

public float getPShade()
Returns the currently selected proportion of shaded relief scaled between 0 (no shading) and 1 (monochrome shaded relief).

Returns:
Proportion shaded relief scaled between 0 and 1.

getShadeExaggeration

public float getShadeExaggeration()
Returns the currently vertical exaggeration used for calculating relief. Values greater than 1 will increase shadow, values between 0.1 and less than 1 will decrease shadowing effect. Note this has no impact on the actual elevation attribute used for analysis.

Returns:
Vertical exaggeration used for shaded relief.

getAspectWeight

public float getAspectWeight()
Returns the currently selected aspect bias. If zero, normal shaded relief will be calculated. As it approaches 1, aspect takes greater importance than slope in calculating shading. High aspect bias highlights local detail.

Returns:
Aspect weighting.

getShine

public float getShine()
Returns the currently selected shine value. This is only used in calculation of shaded relief when selected as a 'surface parameter'. A shine of 0 indicates a matt surface, values towards 1 increase the shininess of the surface.

Returns:
Aspect weighting.

getDiffuse

public float getDiffuse()
Returns the diffuse light component. This is only used in calculation of shaded relief when selected as a 'surface parameter'.

Returns:
Diffuse light component (0 - 1).

getSpecular

public float getSpecular()
Returns the specular light component. This is only used in calculation of shaded relief when selected as a 'surface parameter'.

Returns:
Specular light component (0 - 1).

getAmbient

public float getAmbient()
Returns the ambient light component. This is only used in calculation of shaded relief when selected as a 'surface parameter'.

Returns:
Ambient light component (0 - 1).

actionPerformed

public void actionPerformed(ActionEvent e)
Responds to a button press by showing or removing advanced options.

Specified by:
actionPerformed in interface ActionListener
Parameters:
e - Action event representing button press.

stateChanged

public void stateChanged(ChangeEvent e)
Responds to a change in a slider by updating thumbnail.

Specified by:
stateChanged in interface ChangeListener
Parameters:
e - Slider change event.


Copyright Jo Wood, 1996-2009, last modified, 17th April, 2009