Package gov.nih.mipav.view.renderer.J3D.surfaceview

Class JFrameSurfaceMaterialProperties

java.lang.Object

java.awt.Component

java.awt.Container

java.awt.Window

java.awt.Frame

javax.swing.JFrame

gov.nih.mipav.view.renderer.J3D.surfaceview.JFrameSurfaceMaterialProperties

All Implemented Interfaces:

ActionListener, WindowListener, ImageObserver, MenuContainer, Serializable, EventListener, Accessible, ChangeListener, RootPaneContainer, WindowConstants

public class JFrameSurfaceMaterialProperties
extends JFrame
implements WindowListener, ActionListener, ChangeListener

Window for setting the surface material properties. The window displays two sample spheres: a "before" and "after" sphere. Both are initialized to the current material properties and transparency of the surface. The user can change the ambient, diffuse, specular, and emmissive colors with a color control dialog. The user can also change the specular coefficient, or "shininess" through a slider interface.

Pressing the "apply" button the user can see the changes applied to sthe surface. Pressing the "reset" button resets the surface and material properties interface to the original surface parameters. Pressing "OK" applies the changes to the surface and closes the window, Pressing "cancel" resets the changes and closes the window.

Author:

Alexandra Bokinsky

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.JFrame

JFrame.AccessibleJFrame

Nested classes/interfaces inherited from class java.awt.Frame

Frame.AccessibleAWTFrame

Nested classes/interfaces inherited from class java.awt.Window

Window.AccessibleAWTWindow, Window.Type

Nested classes/interfaces inherited from class java.awt.Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields

Modifier and Type	Field	Description
private int	AFTER	Before/After index values for the two displayed spheres, canvases, and display panels:.
private int	BEFORE	Before/After index values for the two displayed spheres, canvases, and display panels:.
private javax.media.j3d.Material[]	m_akMaterialPreset	Pre-defined materials
private boolean	m_bColorApplied	keeps track of whether or not color has been applied to surface (for backup on cancel)
private float	m_fShininess	specular coefficient
private int	m_iNumPreset	Preset Material's examples:.
private int	m_iSurfaceIndex	the index of the surface that is being changed in the JPanelSurface
private int	m_iWhichButton	Which button is pressed to activate the JColorChooser:.
private javax.vecmath.Color3f	m_kAmbient	Current color values:.
private JButton	m_kAmbientColorButton	Material Properties color buttons:.
private JColorChooser	m_kColorChooser	Color Chooser dialog:.
private javax.vecmath.Color3f	m_kDiffuse	diffuse color
private JButton	m_kDiffuseColorButton	diffuse color button
private javax.vecmath.Color3f	m_kEmissive	emissive color
private JButton	m_kEmissiveColorButton	emissive color button
private JSplitPane	m_kImagePane	Split pane for displaying the canvases side-by-side:.
private JPanel[]	m_kImagePanel	Canvas display panels:.
private JSplitPane	m_kMainPane	Split pane for displaying the rendered spheres above the interface:.
private javax.media.j3d.Material	m_kMaterialNew	Materials for new vales and backup:.
private JPanel	m_kMaterialPanel	Window display panels: Material properties buttons/slider panel:.
private javax.media.j3d.Material	m_kMaterialSave	Saved Material for backup
private JPanelSurface	m_kParent	Parent class:.
private JSlider	m_kShininessSlider	Shininess slider.
private javax.vecmath.Color3f	m_kSpecular	Specular color component
private JButton	m_kSpecularColorButton	Specular color button
private static final long	serialVersionUID	Use serialVersionUID for interoperability.

Fields inherited from class javax.swing.JFrame

accessibleContext, rootPane, rootPaneCheckingEnabled

Fields inherited from class java.awt.Frame

CROSSHAIR_CURSOR, DEFAULT_CURSOR, E_RESIZE_CURSOR, HAND_CURSOR, ICONIFIED, MAXIMIZED_BOTH, MAXIMIZED_HORIZ, MAXIMIZED_VERT, MOVE_CURSOR, N_RESIZE_CURSOR, NE_RESIZE_CURSOR, NORMAL, NW_RESIZE_CURSOR, S_RESIZE_CURSOR, SE_RESIZE_CURSOR, SW_RESIZE_CURSOR, TEXT_CURSOR, W_RESIZE_CURSOR, WAIT_CURSOR

Fields inherited from class java.awt.Component

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Fields inherited from interface javax.swing.WindowConstants

DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, EXIT_ON_CLOSE, HIDE_ON_CLOSE

Constructor Summary

Constructors

Constructor	Description
JFrameSurfaceMaterialProperties(JPanelSurface kParent, int iSurface, GeneralLight[] akGeneralLights, float fOpacity, javax.media.j3d.Material kMaterial)	Creates the Surface Material Editor window.

Method Summary

Modifier and Type	Method	Description
void	actionPerformed(ActionEvent kEvent)	Called when a button is pressed:
private void	applyColorChange()	Update the color changes to the Before sphere and the original surface.
private JPanel	buildPresetPanel()	Builds the preset panel to display the preset images and buttons.
private javax.media.j3d.Canvas3D	createCanvas3D()	Creates the canvas.
private javax.media.j3d.BranchGroup	createSceneGraph(float fOpacity, javax.media.j3d.Material kMaterial)	Creates the rendered spheres, setting the apprearance, material properties, and transparency.
void	dispose()	Deletes all local data members.
private void	initMaterialPreset()	Up to 6 preset materials can be defined.
private void	resetColorChange()	Reset the color changes for the Before sphere and the original surface, based on the original surface material properties, also update the user-interface buttons to the original values.
private void	setupInterface()	Sets up the user interface.
private void	setupMaterials(javax.media.j3d.Material kMaterial)	Reads the current color values from the Material and sets the values for the two spheres displayed in the interface.
private void	setupScene(float fOpacity, GeneralLight[] akGeneralLights)	Sets up the rendered scenes.
void	stateChanged(ChangeEvent event)	Called when the slider values have changed.
void	windowActivated(WindowEvent e)	windowActivated.
void	windowClosed(WindowEvent e)	windowClosed.
void	windowClosing(WindowEvent e)	windowClosing Catch the windowClosing event so that the local data memebrs can be destroyed.
void	windowDeactivated(WindowEvent e)	windowDeactivated.
void	windowDeiconified(WindowEvent e)	windowDeiconified.
void	windowIconified(WindowEvent e)	windowIconified.
void	windowOpened(WindowEvent e)	windowOpened.

Methods inherited from class javax.swing.JFrame

addImpl, createRootPane, frameInit, getAccessibleContext, getContentPane, getDefaultCloseOperation, getGlassPane, getGraphics, getJMenuBar, getLayeredPane, getRootPane, getTransferHandler, isDefaultLookAndFeelDecorated, isRootPaneCheckingEnabled, paramString, processWindowEvent, remove, repaint, setContentPane, setDefaultCloseOperation, setDefaultLookAndFeelDecorated, setGlassPane, setIconImage, setJMenuBar, setLayeredPane, setLayout, setRootPane, setRootPaneCheckingEnabled, setTransferHandler, update

Methods inherited from class java.awt.Frame

addNotify, getCursorType, getExtendedState, getFrames, getIconImage, getMaximizedBounds, getMenuBar, getState, getTitle, isResizable, isUndecorated, remove, removeNotify, setBackground, setCursor, setExtendedState, setMaximizedBounds, setMenuBar, setOpacity, setResizable, setShape, setState, setTitle, setUndecorated

Methods inherited from class java.awt.Window

addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, getBackground, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getIconImages, getInputContext, getListeners, getLocale, getModalExclusionType, getMostRecentFocusOwner, getOpacity, getOwnedWindows, getOwner, getOwnerlessWindows, getShape, getToolkit, getType, getWarningString, getWindowFocusListeners, getWindowListeners, getWindows, getWindowStateListeners, hide, isActive, isAlwaysOnTop, isAlwaysOnTopSupported, isAutoRequestFocus, isFocusableWindow, isFocusCycleRoot, isFocused, isLocationByPlatform, isOpaque, isShowing, isValidateRoot, pack, paint, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, reshape, setAlwaysOnTop, setAutoRequestFocus, setBounds, setBounds, setCursor, setFocusableWindowState, setFocusCycleRoot, setIconImages, setLocation, setLocation, setLocationByPlatform, setLocationRelativeTo, setMinimumSize, setModalExclusionType, setSize, setSize, setType, setVisible, show, 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, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, 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, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, 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, 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, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, resize, resize, revalidate, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setMaximumSize, setMixingCutoutShape, setName, setPreferredSize, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.awt.MenuContainer

getFont, postEvent

Field Details

serialVersionUID

private static final long serialVersionUID

Use serialVersionUID for interoperability.

See Also:

• Constant Field Values

AFTER

private int AFTER

Before/After index values for the two displayed spheres, canvases, and display panels:.

BEFORE

private int BEFORE

Before/After index values for the two displayed spheres, canvases, and display panels:.

m_akMaterialPreset

private javax.media.j3d.Material[] m_akMaterialPreset

Pre-defined materials

m_fShininess

private float m_fShininess

specular coefficient

m_iNumPreset

private int m_iNumPreset

Preset Material's examples:.

m_iSurfaceIndex

private int m_iSurfaceIndex

the index of the surface that is being changed in the JPanelSurface

m_iWhichButton

private int m_iWhichButton

Which button is pressed to activate the JColorChooser:.

m_kAmbient

private javax.vecmath.Color3f m_kAmbient

Current color values:.

m_kAmbientColorButton

private JButton m_kAmbientColorButton

Material Properties color buttons:.

m_kColorChooser

private JColorChooser m_kColorChooser

Color Chooser dialog:.

m_kDiffuse

private javax.vecmath.Color3f m_kDiffuse

diffuse color

m_kDiffuseColorButton

private JButton m_kDiffuseColorButton

diffuse color button

m_kEmissive

private javax.vecmath.Color3f m_kEmissive

emissive color

m_kEmissiveColorButton

private JButton m_kEmissiveColorButton

emissive color button

m_kImagePane

private JSplitPane m_kImagePane

Split pane for displaying the canvases side-by-side:.

m_kImagePanel

private JPanel[] m_kImagePanel

Canvas display panels:.

m_kMainPane

private JSplitPane m_kMainPane

Split pane for displaying the rendered spheres above the interface:.

m_kMaterialNew

private javax.media.j3d.Material m_kMaterialNew

Materials for new vales and backup:.

m_kMaterialPanel

private JPanel m_kMaterialPanel

Window display panels: Material properties buttons/slider panel:.

m_kMaterialSave

private javax.media.j3d.Material m_kMaterialSave

Saved Material for backup

m_kParent

private JPanelSurface m_kParent

Parent class:.

m_kShininessSlider

private JSlider m_kShininessSlider

Shininess slider.

m_kSpecular

private javax.vecmath.Color3f m_kSpecular

Specular color component

m_kSpecularColorButton

private JButton m_kSpecularColorButton

Specular color button

m_bColorApplied

private boolean m_bColorApplied

keeps track of whether or not color has been applied to surface (for backup on cancel)

Constructor Details

JFrameSurfaceMaterialProperties

public JFrameSurfaceMaterialProperties(JPanelSurface kParent,
 int iSurface,
 GeneralLight[] akGeneralLights,
 float fOpacity,
 javax.media.j3d.Material kMaterial)

Creates the Surface Material Editor window. The two example spheres are displayed with the same lights, opacity, and material properties as the surface.

Parameters:

kParent - the array of lights that are used to light the surface

iSurface - the opacity of the surface

akGeneralLights - DOCUMENT ME!

fOpacity - DOCUMENT ME!

kMaterial - the original material properties.

Method Details

actionPerformed

public void actionPerformed(ActionEvent kEvent)

Called when a button is pressed:

Specified by:

actionPerformed in interface ActionListener

Parameters:

kEvent - action event

dispose

public void dispose()

Deletes all local data members.

Overrides:

dispose in class Window

stateChanged

public void stateChanged(ChangeEvent event)

Called when the slider values have changed. Reads the new shininess values and sets the Material Properties.

Specified by:

stateChanged in interface ChangeListener

Parameters:

event - ChangeEvent state change event.

windowActivated

public void windowActivated(WindowEvent e)

windowActivated.

Specified by:

windowActivated in interface WindowListener

Parameters:

e - WindowEvent

windowClosed

public void windowClosed(WindowEvent e)

windowClosed.

Specified by:

windowClosed in interface WindowListener

Parameters:

e - WindowEvent

windowClosing

public void windowClosing(WindowEvent e)

windowClosing Catch the windowClosing event so that the local data memebrs can be destroyed.

Specified by:

windowClosing in interface WindowListener

Parameters:

e - WindowEvent

windowDeactivated

public void windowDeactivated(WindowEvent e)

windowDeactivated.

Specified by:

windowDeactivated in interface WindowListener

Parameters:

e - WindowEvent

windowDeiconified

public void windowDeiconified(WindowEvent e)

windowDeiconified.

Specified by:

windowDeiconified in interface WindowListener

Parameters:

e - WindowEvent

windowIconified

public void windowIconified(WindowEvent e)

windowIconified.

Specified by:

windowIconified in interface WindowListener

Parameters:

e - WindowEvent

windowOpened

public void windowOpened(WindowEvent e)

windowOpened.

Specified by:

windowOpened in interface WindowListener

Parameters:

e - WindowEvent

applyColorChange

private void applyColorChange()

Update the color changes to the Before sphere and the original surface.

buildPresetPanel

private JPanel buildPresetPanel()

Builds the preset panel to display the preset images and buttons.

Returns:

the preset panel to display the preset images and buttons.

createCanvas3D

private javax.media.j3d.Canvas3D createCanvas3D()

Creates the canvas.

Returns:

Canvas3D

createSceneGraph

private javax.media.j3d.BranchGroup createSceneGraph(float fOpacity,
 javax.media.j3d.Material kMaterial)

Creates the rendered spheres, setting the apprearance, material properties, and transparency.

Parameters:

fOpacity - default opacity

kMaterial - initial Material

Returns:

BranchGroup

initMaterialPreset

private void initMaterialPreset()

Up to 6 preset materials can be defined.

resetColorChange

private void resetColorChange()

Reset the color changes for the Before sphere and the original surface, based on the original surface material properties, also update the user-interface buttons to the original values.

setupInterface

private void setupInterface()

Sets up the user interface. Button and slider.

setupMaterials

private void setupMaterials(javax.media.j3d.Material kMaterial)

Reads the current color values from the Material and sets the values for the two spheres displayed in the interface. Saves the original values in case the Reset button is pressed.

Parameters:

kMaterial - material reference.

setupScene

private void setupScene(float fOpacity,
 GeneralLight[] akGeneralLights)

Sets up the rendered scenes. Two spheres, each displayed in a separate canvas window with the same lighting, material, and transparency parameters as the original surface. The "Before" sphere only changes when the "Apply" button is presesd, the "After" sphere changes each time one of the color buttons or the shininess slider is changed

Parameters:

fOpacity - float opacity value

akGeneralLights - GeneralLight[] light array