org.opensourcephysics.frames
Class Display3DFrame

java.lang.Object
  java.awt.Component
      java.awt.Container
          java.awt.Window
              java.awt.Frame
                  javax.swing.JFrame
                      org.opensourcephysics.display.OSPFrame
                          org.opensourcephysics.display3d.simple3d.DrawingFrame3D
                              org.opensourcephysics.frames.Display3DFrame

All Implemented Interfaces:

javax.accessibility.Accessible, java.awt.datatransfer.ClipboardOwner, DrawingFrame3D, java.awt.image.ImageObserver, java.awt.MenuContainer, java.awt.print.Printable, javax.swing.RootPaneContainer, java.io.Serializable, javax.swing.WindowConstants

public class Display3DFrame

extends DrawingFrame3D

See Also:

Serialized Form

Nested Class Summary

Nested classes inherited from class javax.swing.JFrame

javax.swing.JFrame.AccessibleJFrame

Nested classes inherited from class java.awt.Frame

java.awt.Frame.AccessibleAWTFrame

Nested classes inherited from class java.awt.Window

java.awt.Window.AccessibleAWTWindow

Nested classes inherited from class java.awt.Container

java.awt.Container.AccessibleAWTContainer

Nested classes inherited from class java.awt.Component

java.awt.Component.AccessibleAWTComponent, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy

Nested classes inherited from class org.opensourcephysics.display3d.core.DrawingFrame3D

DrawingFrame3D.Loader

Field Summary

Fields inherited from class org.opensourcephysics.display3d.simple3d.DrawingFrame3D

cameraInspectorFrame, cameraItem, copyItem, cursorCrosshairItem, cursorCubeItem, cursorMenu, cursorNoneItem, cursorXYZItem, decorationAxesItem, decorationCubeItem, decorationMenu, decorationNoneItem, displayMenu, displayNoPerspectiveItem, displayPerspectiveItem, displayXYItem, displayXZItem, displayYZItem, drawingPanel, editMenu, fileMenu, MENU_SHORTCUT_KEY_MASK, menuBar, pasteItem, replaceItem, resetCameraItem, visualMenu, zoomToFitItem

Fields inherited from class org.opensourcephysics.display.OSPFrame

animated, applet, appletMode, authorMode, autoclear, buttonPanel, chooserDir, constructorThreadGroup, customButtons, DEFAULT_LOOK_AND_FEEL, defaultLocales, keepHidden, launcherMode, osp_icon_file, strategy

Fields inherited from class javax.swing.JFrame

accessibleContext, EXIT_ON_CLOSE, 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.print.Printable

NO_SUCH_PAGE, PAGE_EXISTS

Fields inherited from interface javax.swing.WindowConstants

DISPOSE_ON_CLOSE, DO_NOTHING_ON_CLOSE, HIDE_ON_CLOSE

Fields inherited from interface java.awt.image.ImageObserver

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

Constructor Summary

Display3DFrame(java.lang.String title)

Method Summary

void	addElement(Element element) Adds an Element to this DrawingPanel3D.
void	addInteractionListener(org.opensourcephysics.display3d.core.interaction.InteractionListener listener) Adds in interaction listener to the 3D drawing panel.
void	enableInteraction(boolean enable) Enables/Disables interaction with the DrawingPanel3D.
Camera	getCamera() Provides the Camera object used to project the scene in 3D modes.
void	setAllowQuickRedraw(boolean allow) Whether the scene can be drawn quickly when it is dragged for a new view point.
void	setAltitude(double phi) Sets the angle phi in spherical polar coordiantes (in radians) to rotate the camera away from the z axis before projecting.
void	setAzimuth(double theta) Sets the angle theta angle in spherical polar coordinates (in radians) to rotate the camera about the z axis before projecting.
void	setDecorationType(int value) Types of decoration displayed.
void	setIgnoreRepaint(boolean ignoreRepaint) Sets whether or not paint messages received from the operating system should be ignored.
void	setPreferredMinMax(double xmin, double xmax, double ymin, double ymax, double zmin, double zmax) Set the extrema in the X, Y and Z coordinates at once
void	setProjectionMode(int mode) Sets the projection mode for the camera.
void	setSquareAspect(boolean square) Whether the panel should try to keep a square aspect.

Methods inherited from class org.opensourcephysics.display3d.simple3d.DrawingFrame3D

copyAction, getDrawingPanel3D, getJFrame, getLoader, getMenuItem, inspectXML, lostOwnership, pasteAction, removeMenuItem, render, replaceAction, saveXML, setDrawingPanel3D, setEnabledCopy, setEnabledPaste, setEnabledReplace, setMessage, setMessage

Methods inherited from class org.opensourcephysics.display.OSPFrame

addButton, bufferStrategyShow, clearData, clearDataAndRepaint, createBufferStrategy, dispose, getChooser, getConstructorThreadGroup, getDefaultLocales, getMenu, invalidateImage, isAnimated, isAuthorMode, isAutoclear, isIconified, isKeepHidden, isLauncherMode, loadDisplayMenu, loadToolsMenu, parseXMLMenu, parseXMLMenu, print, refreshGUI, removeMenu, removeMenuItem, setAnimated, setAuthorMode, setAutoclear, setDefaultCloseOperation, setFontLevel, setKeepHidden, setLauncherMode, setSize, setTitle, setVisible, show, wishesToExit

Methods inherited from class javax.swing.JFrame

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

Methods inherited from class java.awt.Frame

addNotify, finalize, getCursorType, getExtendedState, getFrames, getIconImage, getMaximizedBounds, getMenuBar, getState, getTitle, isResizable, isUndecorated, remove, removeNotify, setCursor, setExtendedState, setIconImage, setMaximizedBounds, setMenuBar, setResizable, setState, setUndecorated

Methods inherited from class java.awt.Window

addPropertyChangeListener, addPropertyChangeListener, addWindowFocusListener, addWindowListener, addWindowStateListener, applyResourceBundle, applyResourceBundle, createBufferStrategy, createBufferStrategy, getBufferStrategy, getFocusableWindowState, getFocusCycleRootAncestor, getFocusOwner, getFocusTraversalKeys, getGraphicsConfiguration, getInputContext, getListeners, getLocale, getMostRecentFocusOwner, getOwnedWindows, getOwner, getToolkit, getWarningString, getWindowFocusListeners, getWindowListeners, getWindowStateListeners, hide, isActive, isFocusableWindow, isFocusCycleRoot, isFocused, isShowing, pack, postEvent, processEvent, processWindowFocusEvent, processWindowStateEvent, removeWindowFocusListener, removeWindowListener, removeWindowStateListener, setCursor, setFocusableWindowState, setFocusCycleRoot, 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, getContainerListeners, getFocusTraversalPolicy, getInsets, getLayout, getMaximumSize, getMinimumSize, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paint, paintComponents, preferredSize, print, printComponents, processContainerEvent, remove, removeAll, removeContainerListener, setFocusTraversalKeys, setFocusTraversalPolicy, 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, 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, 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, isOpaque, 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, repaint, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, setBackground, setBounds, setBounds, setComponentOrientation, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setLocale, setLocation, setLocation, setName, setSize, show, size, toString, transferFocus, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.opensourcephysics.display3d.core.DrawingFrame3D

setVisible

Methods inherited from interface java.awt.MenuContainer

getFont, postEvent

Constructor Detail

Display3DFrame

public Display3DFrame(java.lang.String title)

Method Detail

addInteractionListener

public void addInteractionListener(org.opensourcephysics.display3d.core.interaction.InteractionListener listener)

Adds in interaction listener to the 3D drawing panel. InteractionListeners respond to mouse events.

Parameters:

listener - InteractionListener

enableInteraction

public void enableInteraction(boolean enable)

Enables/Disables interaction with the DrawingPanel3D.

Parameters:

enable - boolean

setPreferredMinMax

public void setPreferredMinMax(double xmin,
                               double xmax,
                               double ymin,
                               double ymax,
                               double zmin,
                               double zmax)

Set the extrema in the X, Y and Z coordinates at once

Parameters:

xmin - double

xmax - double

ymin - double

ymax - double

zmin - double

zmax - double

getCamera

public Camera getCamera()

Provides the Camera object used to project the scene in 3D modes.

Returns:

Camera

See Also:

Camera

addElement

public void addElement(Element element)

Adds an Element to this DrawingPanel3D.

Parameters:

element - Element

See Also:

Element

setSquareAspect

public void setSquareAspect(boolean square)

Whether the panel should try to keep a square aspect. Default value is true.

Parameters:

square - boolean

setAllowQuickRedraw

public void setAllowQuickRedraw(boolean allow)

Whether the scene can be drawn quickly when it is dragged for a new view point.

Parameters:

allow - the desired value

setIgnoreRepaint

public void setIgnoreRepaint(boolean ignoreRepaint)

Sets whether or not paint messages received from the operating system should be ignored. This does not affect paint events generated in software by the AWT, unless they are an immediate response to an OS-level paint message.

setDecorationType

public void setDecorationType(int value)

Types of decoration displayed. One of the following

• VisualizationHints.DECORATION_NONE: No decoration
• VisualizationHints.DECORATION_AXES: Display labelled axes
• VisualizationHints.DECORATION_CUBE: Display the bounding box

Parameters:

value - the desired value

setAzimuth

public void setAzimuth(double theta)

Sets the angle theta angle in spherical polar coordinates (in radians) to rotate the camera about the z axis before projecting. Default is 0.0.

Parameters:

theta - the desired angle

setAltitude

public void setAltitude(double phi)

Sets the angle phi in spherical polar coordiantes (in radians) to rotate the camera away from the z axis before projecting. Default is 0.0.

Parameters:

phi - the desired angle

setProjectionMode

public void setProjectionMode(int mode)

Sets the projection mode for the camera. Possible values are:

• Camera.MODE_PERSPECTIVE: 3D mode in which objects far away look smaller.
• Camera.MODE_NO_PERSPECTIVE: 3D mode in which distance doesn't affect the size of the objects
• Camera.MODE_PLANAR_XY: 2D mode in which only the X and Y coordinates are displayed.
• Camera.MODE_PLANAR_XZ: 2D mode in which only the X and Z coordinates are displayed.
• Camera.MODE_PLANAR_YZ: 2D mode in which only the Y and Z coordinates are displayed.

Parameters:

mode - the desired value