PvDisplay ("JavaView Reference Manual")

java.lang.Object
- java.awt.Component
- - java.awt.Canvas
  - - jv.viewer.PvDisplay

All Implemented Interfaces:

java.awt.event.ActionListener, java.awt.event.KeyListener, java.awt.event.MouseListener, java.awt.event.MouseMotionListener, java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, java.lang.Runnable, java.util.EventListener, javax.accessibility.Accessible, PsUpdateIf, PvDisplayIf
```
public final class PvDisplay
extends java.awt.Canvas
implements PvDisplayIf, java.lang.Runnable, java.awt.event.KeyListener, java.awt.event.MouseListener, java.awt.event.MouseMotionListener, java.awt.event.ActionListener, java.io.Serializable
```
Display of JavaView for viewing and interaction with 3d geometries. The display is subclass of an AWT canvas and fulfills the interface PvDisplayIf. It may be included inside any Java container with any layout manager.
A display may be obtained by three different ways:
1. Simple applets may directly create a display, add a geometry, and call the instance methods of the display to configure it.
2. A slightly advanced applet should obtain the default display from the central PvViewer instance using PvViewer#getDisplay(). This mechanism avoids any need to connect the geometry of the current project or viewer to the display.
3. In some cases an applet or project may need additional displays.
Simple applets may directly create a display and call its instance methods.
Each class fulfilling the interface PvDisplayIf can serve as a display in JavaView.
If the display is not added to an AWT container yet then external rendering does not work since this display has no Graphics yet.
See Also:
Serialized Form

Nested Class Summary
- Nested classes/interfaces inherited from class java.awt.Component
  java.awt.Component.BaselineResizeBehavior

Field Summary

Fields
Modifier and Type	Field and Description
`java.lang.String`	`m_backgroundImageFile` Background image for display.
`boolean`	`m_bInsecureKeyRelease` A flag checking if a keyReleased event still has to be checked.
`java.lang.String`	`m_defBackgroundImageFile` Default background image for display.
`java.lang.String`	`m_defForegroundImageFile` Default foreground image for display.
`java.lang.String`	`m_foregroundImageFile` Background image for display.
`static int`	`m_renderType` Determines render engine and choice of display canvas.
`static int`	`RENDER_AWT` AWT type of render engine.
`static int`	`RENDER_GL` GL type of render engine.
`static int`	`RENDER_LWJGL` GL type of render engine.
`static int`	`RENDER_PS` PostScript type of render engine, not interactive but for PS output.

Fields inherited from class java.awt.Component
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface jv.project.PvDisplayIf
CAMERA_MODEL, CAMERA_NAME, CAMERA_ORTHO_XY, CAMERA_ORTHO_XZ, CAMERA_ORTHO_YZ, CAMERA_PERSPECTIVE, GRID_XY, GRID_XZ, GRID_YZ, IMAGE_CENTER, IMAGE_FIT, IMAGE_RESIZE, IMAGE_TESSELATE, MATRIX_AMBIENT, MATRIX_INV_AMBIENT, MATRIX_INV_MODEL, MATRIX_INV_PROJECT, MATRIX_INV_PROJECT_NON, MATRIX_INV_PROJVIEW, MATRIX_INV_PROJVIEW_NON, MATRIX_INV_TRANS, MATRIX_INV_TRANS_NON, MATRIX_INV_VIEW, MATRIX_MODEL, MATRIX_PROJECT, MATRIX_PROJECT_NON, MATRIX_PROJVIEW, MATRIX_PROJVIEW_NON, MATRIX_TRANS, MATRIX_TRANS_NON, MATRIX_VIEW, MODE_ADD, MODE_ADD_ELEMENT, MODE_BOUNDARY_PICK, MODE_DELETE, MODE_DETAIL, MODE_DISPLAY_PICK, MODE_DRAWING, MODE_DUPLICATE, MODE_FLY, MODE_HIGHLIGHT, MODE_INITIAL_PICK, MODE_MARK, MODE_MARK_ELEMENTS, MODE_ORBIT, MODE_PICK, MODE_SCALE, MODE_SCALE_RECT, MODE_TRANS, MODE_TRANS_Z, MODE_UNMARK, MODE_UNMARK_ELEMENTS, MODE_URL, MODE_VERTICAL, PAINT_BACKIMAGE, PICK_ALL, PICK_BACKGROUND, PICK_SELECTED, PICK_UNSELECTED, TRANSFORM_AMBIENT, TRANSFORM_CAMERA, TRANSFORM_MODEL

Fields inherited from interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors
Constructor and Description
`PvDisplay()` Constructor of display without viewer as parent.
`PvDisplay(java.applet.Applet applet, java.awt.Frame frame)` Constructor of display inside applet, or inside frame if applet is null.
`PvDisplay(PvViewerIf viewer)` Constructor of display with given argument viewer as parent.

Method Summary

Methods
Modifier and Type	Method and Description
`void`	`actionPerformed(java.awt.event.ActionEvent event)` Perform action events, currently used for popup menu events only.
`int`	`addCamera(java.lang.String aName, PvCamera aCamera)` Add new camera and make it accessible under the given name.
`void`	`addCameraListener(PvCameraListenerIf listener)` Add camera listener to receive camera events `PvCameraEvent`.
`boolean`	`addGeometry(PgGeometryIf aGeom)` Add geometry to display.
`void`	`addGeometryListener(PvGeometryListenerIf listener)` Add geometry listener to receive geometry events.
`void`	`addKeyListener(java.awt.event.KeyListener listener)` Add key listener to receive key events from display canvas.
`boolean`	`addLight(PvLightIf light)` Add a light to the current scene.
`void`	`addPickListener(PvPickListenerIf listener)` Add pick listener to receive pick events `PvPickEvent`.
`void`	`addPopupItem(int menuID)` Add a menu item to the right-mouse popup menu.
`void`	`burn()` Burn the current status as texture on each surface.
`void`	`center()` Center geometry in window, do no scaling
`void`	`clearPopupMenu()` Removes all added menu items from right-mouse popup menu, except some standard JavaView items such as "exit".
`void`	`configure(PvDisplayIf disp)` Configure an empty given display with all settings and geometries of this display.
`boolean`	`containsGeometry(PgGeometryIf aGeom)` Check whether geometry is registered in display.
`void`	`enableClip(boolean aFlag)` Deprecated. use `#setEnabledClip`
`boolean`	`fit()` Center and scale camera such that geometry fits exactly into window.
`boolean`	`fit(PvCamera camera)` Center and scale camera such that geometry fits exactly into window.
`int`	`getAmbientProjection()` Get projection mode of ambient space used in model camera.
`int`	`getAmbientSpace()` Get ambient space used in model transformations.
`PgAxes`	`getAxes()` Get axes geometry with individual rulers for each coordinate axis.
`PsPanel`	`getAxisPanel()` Get info panel of axes object to control all rulers uniformly.
`PsPanel`	`getAxisPanel(int ind)` Get info panel of individual ruler.
`java.awt.Color`	`getBackgroundColor()` Get color of background of display.
`java.awt.Image`	`getBackgroundImage()` Make background image of display available to outside world.
`java.lang.String`	`getBackgroundImageFile()` Get filename of background image of display canvas.
`int`	`getBackgroundImageFit()` Get the mode determining how a background image is scaled w.r.t. the display canvas.
`java.awt.Color`	`getBndBoxColor()` Get color of bounding box.
`double`	`getBndBoxSize()` Get thickness of edges of bounding box.
`PdVector`	`getBoxRatio()` Get individual scaling factors of coordinate axes.
`PvCameraIf`	`getCamera()` Get current camera object.
`PvCameraIf`	`getCamera(int type)` Get a camera object by type.
`PsPanel`	`getCameraPanel()` Get info panel of current camera.
`PvCameraIf[]`	`getCameras()` Get current camera object.
`java.awt.Canvas`	`getCanvas()` Get canvas of this display.
`double[]`	`getClipBounds(int ind)` Get minimum and maximum in one dimension of the clipping box.
`int`	`getClipBoundsType()` Get index of axis which is selected when scene clip bounds is active of becomes active.
`double`	`getFarClip()` Get far clip distance of current camera.
`PsUpdateIf`	`getFather()` Get father of display.
`java.awt.Color`	`getForegroundColor()` Get foreground color.
`java.awt.Image`	`getForegroundImage()` Get foreground image of display canvas.
`java.lang.String`	`getForegroundImageFile()` Get filename of foreground image of display canvas.
`int`	`getForegroundImageFit()` Get the mode determining how a foreground image is scaled w.r.t. the display canvas.
`java.awt.Frame`	`getFrame()` Get reference to container frame of display, e.g. to allow display to hide/show frame.
`java.lang.String`	`getFrameLabel(int index)` Get one of the labels of the coordinate frame.
`PgGeometryIf[]`	`getGeometries()` Get array with registered geometries.
`PdVector`	`getGridIncrements(int gridOrient)` Get spacing between grid lines in both coordinate directions.
`int`	`getGridOrientation()` Get orientation of grid which determines the plane in which the grid lies.
`java.awt.Image`	`getImage()` Make image of display available to outside world.
`int`	`getImageFitMode()` Deprecated. use getBackgroundImageFit()
`PsPanel`	`getInfoPanel()` Get info panel of display.
`PvLightIf`	`getLight()` Get current light object.
`int`	`getLightingModel()` Get currently active lighting model.
`PsPanel`	`getLightPanel()` Get info panel of lights.
`PvLightIf[]`	`getLights()` Get registered lights as array.
`int`	`getMajorMode()` Get the current interaction mode.
`java.awt.Dimension`	`getMinimumSize()` Assure correct horizontal size of all project panels.
`java.lang.String`	`getName()` Get name of this display.
`double`	`getNearClip()` Get near clip distance of current camera.
`int`	`getNumGeometries()` Get number of all registered geometry in display.
`int`	`getNumLights()` Get number of light objects.
`PvPickEvent`	`getPickEvent(int x, int y)` Find intersection of ray through pick locus on visible geometries and background.
`PvPickEvent`	`getPickEvent(int x, int y, int pickType)` Find intersection of ray through pick locus on visible geometries and background.
`int`	`getPickType()` Get pick type which determines the class of pickable geometries in pick and initialPick mode.
`java.awt.Point`	`getPosition(int xPos, int yPos)` Get upper left corner of frame, or null if no parent frame available.
`java.awt.Dimension`	`getPreferredSize()` Assure correct horizontal size of all project panels.
`java.lang.String`	`getSceneTitle()` Get title of scene.
`java.lang.String[]`	`getSearchPaths()` Get image search paths.
`PgGeometryIf`	`getSelectedGeometry()` Get currently selected geometry.
`PvLightIf`	`getSelectedLight()` Select light from the list of registered lights in this scene.
`java.awt.Dimension`	`getSize()` Get height of drawing canvas.
`int`	`getTransformationMode()` Check whether transformation of current model is active, i.e. of model matrix.
`PdMatrix`	`getTransMatrix(int type)` Get 4*4 transformation matrix or components from current camera and display.
`PvViewerIf`	`getViewer()` Get the viewer manager of display, which manages multiple displays and is key listener.
`PgGeometryIf[]`	`getVisibleGeometries()` Get array with registered and visible geometries.
`boolean`	`hasAxes()` Check existence of axes geometry.
`boolean`	`hasCamera(int type)` Determine whether a camera object of given type is registered in display.
`boolean`	`hasCameraListener(PvCameraListenerIf listener)` Check for a registered listener.
`boolean`	`hasGeometryListener(PvGeometryListenerIf listener)` Check for a registered geometry listener.
`boolean`	`hasLight(PvLightIf light)` Determine whether a light is registered in display.
`boolean`	`hasPaintTag(long flags)` Check whether either if the bits in parameter has been set.
`boolean`	`hasPickListener(PvPickListenerIf listener)` Check for a registered listener.
`boolean`	`incrementAutoRotation()` Do a single increment of auto-rotation animation.
`void`	`init()` Initialize and reset display.
`boolean`	`isClip()` Deprecated. use `#isEnabledClip`
`boolean`	`isEnabled3DLook()` Check whether thick vertices and edges are drawn as 3d shapes in z-buffer mode.
`boolean`	`isEnabledAdaptiveSize()` Check whether adaptive thickness of vertices and edges is enabled.
`boolean`	`isEnabledAnimation()` Check whether auto-rotation is enabled.
`boolean`	`isEnabledAntiAlias()` Check if antialiased drawing is enabled.
`boolean`	`isEnabledBoxRatio()` Check whether individual scaling factors of coordinate axes is enabled.
`boolean`	`isEnabledClearScreen()` Check whether screen is cleared after each repaint.
`boolean`	`isEnabledClip()` Check whether clipping with front and back plane is enabled.
`boolean`	`isEnabledClipAutoBounds()` Check whether automatic recalculation of clip range is enabled when clipRange is switched on.
`boolean`	`isEnabledClipBounds()` Check whether clipping with scene in direction of coordinate axis is enabled.
`boolean`	`isEnabledDirectSelect()` Check whether selecting is enabled during mouse pick.
`boolean`	`isEnabledDoubleBuffer()` Check if double buffered drawing is enabled.
`boolean`	`isEnabledExternalRendering()` Check if rendering into an external image is enabled.
`static boolean`	`isEnabledFastClipping()` Check whether fast clipping of geometry items is enabled.
`static boolean`	`isEnabledFastZBuffer()` Check whether z-buffered is disabled during drawing.
`boolean`	`isEnabledFillDisplay()` Check if scaling of scene to fill display is enabled.
`boolean`	`isEnabledInspection()` Check whether display and selected geometry can be inspected in control window.
`boolean`	`isEnabledIntegerPick()` Check whether picking is constrained to an integer grid.
`boolean`	`isEnabledLocalTransform()` Get flag whether local coordinate system is used in camera transformations.
`boolean`	`isEnabledPainters()` Check whether painter's algorithm during drawing is enabled.
`boolean`	`isEnabledRepaint()` Determine whether painting is enabled.
`boolean`	`isEnabledTags()` Determine whether tag mode is enabled to move marked elements.
`boolean`	`isEnabledUpdate()` Determine whether update mechanism is enabled.
`boolean`	`isEnabledZBuffer()` Check whether z-buffered drawing is enabled.
`boolean`	`isShowingAllViews()` Check drawing of copyright information in the display window.
`boolean`	`isShowingAxes()` Check whether axes of active geometry is currently showing.
`boolean`	`isShowingBackgroundImage()` Check drawing of background image of display window.
`boolean`	`isShowingBackImage()` Deprecated. use isShowingBackgroundImage()
`boolean`	`isShowingBndBox()` Check whether bounding box of active geometry is currently showing.
`boolean`	`isShowingCamera()` Check whether active camera of this display is visible.
`boolean`	`isShowingCopyright()` Check drawing of copyright information in the display window.
`boolean`	`isShowingDepthcue()` `True` if depthcue is enabled.
`boolean`	`isShowingEdgeAura()` Check flag of drawing of edges by one or both elements adjacent to an edge.
`boolean`	`isShowingEdgesOnce()` Check flag of drawing of edges by one or both elements adjacent to an edge.
`boolean`	`isShowingForegroundImage()` Check drawing of foreground image of display window.
`boolean`	`isShowingFrame()` Check whether coordinate frame is currently showing.
`boolean`	`isShowingGrid()` Check whether grid is currently showing.
`boolean`	`isShowingInterest()` Check whether interest of active camera is visible.
`boolean`	`isShowingMagnet()` Check whether cursor attached to vertices if nearby.
`boolean`	`isShowingTitle()` Check drawing of title north in the display window.
`void`	`keyPressed(java.awt.event.KeyEvent event)`
`void`	`keyReleased(java.awt.event.KeyEvent event)`
`void`	`keyTyped(java.awt.event.KeyEvent event)`
`void`	`mouseClicked(java.awt.event.MouseEvent event)` Shows popup menu if event is a popup trigger.
`void`	`mouseDragged(java.awt.event.MouseEvent event)`
`void`	`mouseEntered(java.awt.event.MouseEvent event)` This display requests the focus when the mouse enters the canvas unless request of focus is disabled by external calls.
`void`	`mouseExited(java.awt.event.MouseEvent event)` Sets a flag that mouse is outside.
`void`	`mouseMoved(java.awt.event.MouseEvent event)` Updates mouse position and invokes temporary information like magnet and info.
`void`	`mousePressed(java.awt.event.MouseEvent event)` Do not react on popup events or other than left mouse clicks.
`void`	`mouseReleased(java.awt.event.MouseEvent event)` Handle mouse key release events.
`void`	`paint(java.awt.Graphics g)` Override `Canvas.paint(g)` to initiate redrawing of geometries.
`void`	`recomputeAxes()` Recalculate length of axes depending on bounding box of scene or current geometry depending on current transformation mode.
`void`	`releasePickFocus()` Release pick focus, i.e. to be the unique listener who receives pick events.
`boolean`	`removeCamera(int type)` Remove camera from list of registered cameras.
`boolean`	`removeCameraListener(PvCameraListenerIf listener)` Remove a registered listener from list of registered listeners.
`void`	`removeGeometries()` Remove all geometries from list of registered geometries.
`boolean`	`removeGeometry(PgGeometryIf aGeom)` Remove geometry from list of registered geometries.
`boolean`	`removeGeometryListener(PvGeometryListenerIf listener)` Remove a registered geometry listener from list of registered listeners.
`void`	`removeKeyListener(java.awt.event.KeyListener listener)` Remove key listener to receive key events from display canvas.
`boolean`	`removeLight(PvLightIf light)` Remove light from list of registered lights in this scene.
`void`	`removeLights()` Remove all lights from list of registered lights in this scene.
`boolean`	`removePickListener(PvPickListenerIf listener)` Remove a registered listener from list of registered listeners.
`void`	`render()` Initiate the rendering process when using this display as a batch renderer.
`void`	`repaint()` For debug only.
`void`	`requestPickFocus(PvPickListenerIf listener)` Request pick focus, i.e. to be the unique listener who receives pick events.
`void`	`reset()` Reset this display to state determined by m_sceneDefaults.
`void`	`resetTransformModel()` Reset ambient and model matrix of current model and modelCamera.
`boolean`	`resizeImage()` Resize the target screen image if user has changed the canvas size.
`void`	`run()` Do the animation by incrementing the transformation matrix with the last action.
`void`	`saveCameraDefaults()` Save settings of current camera as default.
`boolean`	`selectCamera(int type)` Select current camera used in dispay by id.
`boolean`	`selectGeometry(PgGeometryIf aGeom)` Select geometry to be active and receive pick events.
`boolean`	`selectLight(PvLightIf light)` Select light from the list of registered lights in this scene.
`void`	`setAmbientProjection(int mode)` Set projection mode of ambient space used in model camera.
`void`	`setAmbientSpace(int mode)` Set ambient space used in model transformations.
`void`	`setAutoCenter(boolean flag)` Set flag which determines whether camera will automatically center on geometry.
`void`	`setAutoRotation(PdVector axis, double angle)` Set axis and angle for auto-rotation.
`void`	`setAxes(PgAxes axes)` Register axes geometry in this display.
`void`	`setBackgroundColor(java.awt.Color color)` Set color of background of display.
`void`	`setBackgroundImage(java.awt.Image anImage)` Set background image of display canvas.
`void`	`setBackgroundImage(java.lang.String fileName)` Deprecated. use setBackgroundImageFile(String)
`void`	`setBackgroundImageFile(java.lang.String fileName)` Set filename of background image of display canvas.
`void`	`setBackgroundImageFit(int mode)` Set the mode determining how a background image is scaled w.r.t. the display canvas.
`void`	`setBndBoxColor(java.awt.Color color)` Set color of bounding box.
`void`	`setBndBoxSize(double size)` Set thickness of edges of bounding box.
`void`	`setBoxRatio(PdVector ratio)` Set individual scaling factors of coordinate axes.
`void`	`setClipBounds(int ind, double[] range)` Set minimum and maximum in one dimension of the clipping box.
`void`	`setClipBoundsType(int type)` Set index of axis which is selected when scene clip bounds is active of becomes active.
`static void`	`setDefaultSize(java.awt.Dimension size)` Set default dimension of drawing canvas from outside.
`void`	`setDrawingOrder(int order, PgGeometryIf aGeom)` Choose z-order of geometry when drawn in display.
`void`	`setEnabled3DLook(boolean flag)` Enable drawing of thick vertices and edges as 3d shapes in z-buffer mode.
`void`	`setEnabledAdaptiveSize(boolean flag)` Enabled adaptive thickness of vertices and edges.
`void`	`setEnabledAnimation(boolean flag)` Enable and disable auto-rotation of scene.
`void`	`setEnabledAntiAlias(boolean flag)` Enable antialiased drawing.
`void`	`setEnabledBoxRatio(boolean flag)` Enable and disable individual scaling factors of coordinate axes.
`void`	`setEnabledClearScreen(boolean aFlag)` Enable clearing of screen after each repaint.
`void`	`setEnabledClip(boolean flag)` Enable and disable clipping with front and back plane in camera viewing direction.
`void`	`setEnabledClipAutoBounds(boolean flag)` Enable automatic recalculation of clip range when clipRange is switched on.
`void`	`setEnabledClipBounds(boolean flag)` Enable and disable clipping of scene along coordinate axes.
`void`	`setEnabledDirectSelect(boolean flag)` Enable and disable clipping with front and back plane.
`void`	`setEnabledDoubleBuffer(boolean flag)` Enable double buffered drawing.
`void`	`setEnabledExternalRendering(boolean flag)` Enable rendering into an external image.
`static void`	`setEnabledFastClipping(boolean aFlag)` Enable and disable fast clipping of geometry items during rendering.
`static void`	`setEnabledFastZBuffer(boolean aFlag)` Enable and disable z-buffered drawing of scene.
`void`	`setEnabledFillDisplay(boolean flag)` Determine if scaling of scene to fill display is enabled.
`void`	`setEnabledInspection(boolean flag)` Enable whether display and selected geometry can be inspected in control window.
`void`	`setEnabledIntegerPick(boolean flag)` Restrict picking to an integer grid.
`void`	`setEnabledLocalTransform(boolean flag)` Set flag whether local coordinate system is used in camera transformations.
`void`	`setEnabledPainters(boolean flag)` Enable and disable painter's algorithm during drawing, i.e. a z-sort of drawing items.
`void`	`setEnabledRepaint(boolean flag)` Set flag which determines whether painting is enabled.
`void`	`setEnabledTags(boolean flag)` Enable and disable tag mode to move marked elements.
`void`	`setEnabledUpdate(boolean flag)` Set flag which determines whether update mechanism is enabled.
`void`	`setEnabledZBuffer(boolean flag)` Enable and disable z-buffered drawing of scene.
`void`	`setExternalRenderSize(int width, int height)` Set dimension of the external render image.
`void`	`setFarClip(double dist)` Set far clip distance of current camera, works even if clipping is disabled.
`void`	`setForegroundColor(java.awt.Color color)` Set foreground color of display.
`void`	`setForegroundImage(java.awt.Image image)` Set foreground image of display canvas.
`void`	`setForegroundImageFile(java.lang.String fileName)` Load an image from file and set it as foreground image of display canvas.
`void`	`setForegroundImageFit(int mode)` Set the mode determining how a background image is scaled w.r.t. the display canvas.
`void`	`setFrame(java.awt.Frame frame)` Set reference to container frame of display, e.g. to allow display to hide/show frame.
`void`	`setFrameLabel(int index, java.lang.String label)` Sets one of the labels of the coordinate frame.
`void`	`setGridIncrements(int gridOrient, PdVector gridIncrements)` Set spacing between grid lines in both coordinate directions.
`void`	`setGridOrientation(int gridOrient)` Set orientation of grid which determines the plane in which the grid lies.
`void`	`setImageFitMode(int mode)` Deprecated. use setBackgroundImageFit(int)
`void`	`setLightingModel(int model)` Set current lighting model, and thereby enable or disable usage of light.
`void`	`setMajorMode(int mode)` Switch between interaction modes like rotating or scaling, usually done interactively.
`void`	`setName(java.lang.String aName)` Set name of this display.
`void`	`setNearClip(double dist)` Set near clip distance of current camera, works even if clipping is disabled.
`void`	`setPaintTag(long flags, boolean val)` Set all bits which are set in parameter.
`void`	`setParent(PsUpdateIf father)` Set father of display which receives update events when current class has changed.
`void`	`setPickType(int type)` Set pick type which determines the class of pickable geometries in pick and initialPick mode.
`void`	`setPosition(int xPos, int yPos)` Set position of upper left corner of frame from outside.
`void`	`setPreferredSize(java.awt.Dimension size)` Set default dimension of drawing canvas from outside.
`void`	`setSceneTitle(java.lang.String title)` Set title of scene.
`void`	`setSearchPaths(java.lang.String[] searchPath)` Set image search paths.
`void`	`setSizeWithinFrame(int width, int height)` Set dimension of display which is included in a parent frame.
`void`	`setTransformationMode(int mode)` Enable transformation of modeling matrix M of single geometry rather than transforming the whole scene by modifying project P and view V matrices.
`void`	`setTransMatrix(int type, PdMatrix mat)` Set transformation matrices PV, P, V and their inverses in current camera and display.
`void`	`setViewer(PvViewerIf viewer)` Set the viewer manager of display, which manages multiple displays and is key listener.
`void`	`showAllViews(boolean flag)` Enable and disable drawing of copyright information in the display window.
`void`	`showAxes(boolean aFlag)` Set visibility of axes active geometry, and create axes if not available.
`void`	`showBackgroundImage(boolean aFlag)` Enable and disable drawing of background image of display window.
`void`	`showBackImage(boolean aFlag)` Deprecated. use showBackgroundImage(boolean)
`void`	`showBndBox(boolean aFlag)` Set visibility of bounding box of active geometry, and create bounding box if not available.
`void`	`showCamera(boolean aFlag)` Set visibility of active camera in this display, and create camera geometry if not available.
`void`	`showCopyright(boolean aFlag)` Enable and disable drawing of copyright information in the display window.
`void`	`showDepthcue(boolean aFlag)` Enable and disable depthcue drawing.
`void`	`showEdgeAura(boolean aFlag)` Enable and disable drawing of edges by one or both elements adjacent to an edge.
`void`	`showEdgesOnce(boolean aFlag)` Enable and disable drawing of edges by one or both elements adjacent to an edge.
`void`	`showForegroundImage(boolean aFlag)` Enable and disable drawing of foreground image of display window.
`void`	`showFrame(boolean aFlag)` Set visibility of coordinate frame is shown, and create frame if not available.
`void`	`showGrid(boolean flag)` Set visibility of grid, and create grid if not available.
`void`	`showInterest(boolean aFlag)` Set visibility of interest of active camera, and create interest geometry if not available.
`void`	`showMagnet(boolean aFlag)` Attach cursor to vertices if nearby.
`void`	`showTitle(boolean aFlag)` Enable and disable drawing of title north in the display window.
`void`	`start()` Start animation by creating a new thread
`void`	`stop()` Stop animation by stopping the thread.
`void`	`update(java.awt.Graphics g)` Override `Component.update(g)` to initiate redrawing of geometries.
`boolean`	`update(java.lang.Object event)` Handle update events sent to display by JavaView.

Methods inherited from class java.awt.Canvas
addNotify, createBufferStrategy, createBufferStrategy, getAccessibleContext, getBufferStrategy

Methods inherited from class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, bounds, checkImage, checkImage, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, deliverEvent, disable, dispatchEvent, doLayout, enable, enable, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAlignmentX, getAlignmentY, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentAt, getComponentAt, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeys, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMaximumSize, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, invalidate, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusCycleRoot, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, layout, list, list, list, list, list, locate, location, lostFocus, minimumSize, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, preferredSize, prepareImage, prepareImage, print, printAll, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocusInWindow, reshape, resize, resize, revalidate, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeys, setFocusTraversalKeysEnabled, setFont, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle, validate

Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - RENDER_AWT
```
public static final int RENDER_AWT
```
    AWT type of render engine.
    
    See Also:
    Constant Field Values
  - RENDER_PS
```
public static final int RENDER_PS
```
    PostScript type of render engine, not interactive but for PS output.
    
    See Also:
    Constant Field Values
  - RENDER_GL
```
public static final int RENDER_GL
```
    GL type of render engine.
    
    See Also:
    Constant Field Values
  - RENDER_LWJGL
```
public static final int RENDER_LWJGL
```
    GL type of render engine.
    
    See Also:
    Constant Field Values
  - m_renderType
```
public static int m_renderType
```
    Determines render engine and choice of display canvas.
  - m_defBackgroundImageFile
```
public java.lang.String m_defBackgroundImageFile
```
    Default background image for display.
  - m_backgroundImageFile
```
public java.lang.String m_backgroundImageFile
```
    Background image for display.
  - m_defForegroundImageFile
```
public java.lang.String m_defForegroundImageFile
```
    Default foreground image for display.
  - m_foregroundImageFile
```
public java.lang.String m_foregroundImageFile
```
    Background image for display.
  - m_bInsecureKeyRelease
```
public boolean m_bInsecureKeyRelease
```
    A flag checking if a keyReleased event still has to be checked. If the timer method called and the flag is still "false", the keyReleased event is considered "real".
- Constructor Detail
  - PvDisplay
```
public PvDisplay()
```
    Constructor of display without viewer as parent. Allows display to act as bean.
  - PvDisplay
```
public PvDisplay(PvViewerIf viewer)
```
    Constructor of display with given argument viewer as parent.
    
    Parameters:
    viewer - parent of display to handle certain events like export.
  - PvDisplay
```
public PvDisplay(java.applet.Applet applet,
         java.awt.Frame frame)
```
    Constructor of display inside applet, or inside frame if applet is null. Frame is used to allow modification of size of display if no viewer available.
    
    Parameters:
    applet - which is container of display
    frame - which contains applet, or is container of display
- Method Detail
  - init
```
public void init()
```
    Description copied from interface: PvDisplayIf
    
    Initialize and reset display.
    
    Specified by:
    
    init in interface PvDisplayIf
  - reset
```
public void reset()
```
    Reset this display to state determined by m_sceneDefaults.
  - getName
```
public java.lang.String getName()
```
    Get name of this display.
    
    Specified by:
    
    getName in interface PsUpdateIf
    
    Specified by:
    
    getName in interface PvDisplayIf
    
    Overrides:
    
    getName in class java.awt.Component
  - setName
```
public void setName(java.lang.String aName)
```
    Set name of this display.
    
    Specified by:
    
    setName in interface PvDisplayIf
    
    Overrides:
    
    setName in class java.awt.Component
  - getSceneTitle
```
public java.lang.String getSceneTitle()
```
    Get title of scene.
    
    Specified by:
    
    getSceneTitle in interface PvDisplayIf
  - setSceneTitle
```
public void setSceneTitle(java.lang.String title)
```
    Set title of scene.
    
    Specified by:
    
    setSceneTitle in interface PvDisplayIf
  - getCanvas
```
public java.awt.Canvas getCanvas()
```
    Get canvas of this display. Before GL implementation the display was the canvas, not we return a special instance variable. For some time, display still derives from canvas and will in fact be returned.
    
    Specified by:
    
    getCanvas in interface PvDisplayIf
    
    Since:
    
    JavaView 3.99.010
  - getFrame
```
public java.awt.Frame getFrame()
```
    Get reference to container frame of display, e.g. to allow display to hide/show frame.
    
    Specified by:
    
    getFrame in interface PvDisplayIf
  - setFrame
```
public void setFrame(java.awt.Frame frame)
```
    Set reference to container frame of display, e.g. to allow display to hide/show frame.
    
    Specified by:
    
    setFrame in interface PvDisplayIf
  - getViewer
```
public PvViewerIf getViewer()
```
    Get the viewer manager of display, which manages multiple displays and is key listener.
    
    Specified by:
    
    getViewer in interface PvDisplayIf
    
    Since:
    
    JavaView 2.30
  - setViewer
```
public void setViewer(PvViewerIf viewer)
```
    Set the viewer manager of display, which manages multiple displays and is key listener.
    
    Specified by:
    
    setViewer in interface PvDisplayIf
    
    Since:
    
    JavaView 2.30
  - addKeyListener
```
public void addKeyListener(java.awt.event.KeyListener listener)
```
    Add key listener to receive key events from display canvas.
    
    Specified by:
    
    addKeyListener in interface PvDisplayIf
    
    Overrides:
    
    addKeyListener in class java.awt.Component
    
    Parameters:
    listener - which is added
    See Also:
    removeKeyListener(KeyListener)
  - removeKeyListener
```
public void removeKeyListener(java.awt.event.KeyListener listener)
```
    Remove key listener to receive key events from display canvas.
    
    Specified by:
    
    removeKeyListener in interface PvDisplayIf
    
    Overrides:
    
    removeKeyListener in class java.awt.Component
    
    Parameters:
    listener - which is added
    See Also:
    addKeyListener(KeyListener)
  - addPickListener
```
public void addPickListener(PvPickListenerIf listener)
```
    Add pick listener to receive pick events PvPickEvent.
    
    Specified by:
    
    addPickListener in interface PvDisplayIf
    
    Parameters:
    listener - which is added
    See Also:
    hasPickListener(PvPickListenerIf), removePickListener(PvPickListenerIf)
  - hasPickListener
```
public boolean hasPickListener(PvPickListenerIf listener)
```
    Check for a registered listener.
    
    Specified by:
    
    hasPickListener in interface PvDisplayIf
    
    Parameters:
    listener - which is queried
    
    Returns:
    true if registered listener found.
    See Also:
    addPickListener(PvPickListenerIf), removePickListener(PvPickListenerIf)
  - removePickListener
```
public boolean removePickListener(PvPickListenerIf listener)
```
    Remove a registered listener from list of registered listeners.
    
    Specified by:
    
    removePickListener in interface PvDisplayIf
    
    Parameters:
    listener - which is removed
    
    Returns:
    false if listener does not exists.
    See Also:
    addPickListener(PvPickListenerIf), hasPickListener(PvPickListenerIf)
  - addGeometryListener
```
public void addGeometryListener(PvGeometryListenerIf listener)
```
    Add geometry listener to receive geometry events.
    Listener is not informed about changes of special geometries of the display like bndbox, frame, or axis.
    
    Specified by:
    
    addGeometryListener in interface PvDisplayIf
    
    Parameters:
    listener - which is added
    Since:
    
    JavaView 2.48
    
    See Also:
    hasGeometryListener(PvGeometryListenerIf), removeGeometryListener(PvGeometryListenerIf)
  - hasGeometryListener
```
public boolean hasGeometryListener(PvGeometryListenerIf listener)
```
    Check for a registered geometry listener.
    
    Specified by:
    
    hasGeometryListener in interface PvDisplayIf
    
    Parameters:
    listener - which is queried
    
    Returns:
    true if registered listener found.
    Since:
    
    JavaView 2.48
    
    See Also:
    addGeometryListener(PvGeometryListenerIf), removeGeometryListener(PvGeometryListenerIf)
  - removeGeometryListener
```
public boolean removeGeometryListener(PvGeometryListenerIf listener)
```
    Remove a registered geometry listener from list of registered listeners.
    
    Specified by:
    
    removeGeometryListener in interface PvDisplayIf
    
    Parameters:
    listener - which is removed
    
    Returns:
    false if listener does not exists.
    Since:
    
    JavaView 2.48
    
    See Also:
    addGeometryListener(PvGeometryListenerIf), hasGeometryListener(PvGeometryListenerIf)
  - addCameraListener
```
public void addCameraListener(PvCameraListenerIf listener)
```
    Add camera listener to receive camera events PvCameraEvent.
    
    Specified by:
    
    addCameraListener in interface PvDisplayIf
    
    Parameters:
    listener - which is added
    See Also:
    hasCameraListener(PvCameraListenerIf), removeCameraListener(PvCameraListenerIf)
  - hasCameraListener
```
public boolean hasCameraListener(PvCameraListenerIf listener)
```
    Check for a registered listener.
    
    Specified by:
    
    hasCameraListener in interface PvDisplayIf
    
    Parameters:
    listener - which is queried
    
    Returns:
    true if registered listener found.
    See Also:
    addCameraListener(PvCameraListenerIf), removeCameraListener(PvCameraListenerIf)
  - removeCameraListener
```
public boolean removeCameraListener(PvCameraListenerIf listener)
```
    Remove a registered listener from list of registered listeners.
    
    Specified by:
    
    removeCameraListener in interface PvDisplayIf
    
    Parameters:
    listener - which is removed
    
    Returns:
    false if listener does not exists.
    See Also:
    addCameraListener(PvCameraListenerIf), hasCameraListener(PvCameraListenerIf)
  - requestPickFocus
```
public void requestPickFocus(PvPickListenerIf listener)
```
    Request pick focus, i.e. to be the unique listener who receives pick events. The focus should only be requested temporarily, and must be released after use.
    
    Specified by:
    
    requestPickFocus in interface PvDisplayIf
    
    Parameters:
    listener - which will receives pick events
    See Also:
    releasePickFocus()
  - releasePickFocus
```
public void releasePickFocus()
```
    Release pick focus, i.e. to be the unique listener who receives pick events. The focus should only be requested temporarily, and must be released after use.
    
    Specified by:
    
    releasePickFocus in interface PvDisplayIf
    
    See Also:
    requestPickFocus(PvPickListenerIf)
  - addGeometry
```
public boolean addGeometry(PgGeometryIf aGeom)
```
    Add geometry to display. Display may show several geometries among one of them is the currently active geometry. The active geometry is the target for picking.
    After the first geometry is added, the display performs a fit() operation to center and scale the camera such that the geometry is completely visible in the display.
    The first geometry added to a display automatically becomes the active geometry. After having added several geometries the active geometry may be selected with selectGeometry().
    Note, default drawing order is PvGeometryIf#DRAW_ORDER_STANDARD which means, that z-depth of geometry elements are orderer in comparison with all other geometries. Except, if drawing order is PvGeometryIf#DRAW_ORDER_FRONT or PvGeometryIf.DRAW_ORDER_BACK then no comparison is done during display. Use method #setDrawingOrder(int, jv.project.PgGeometryIf) to modify the drawing order of a geometry after it has been added to the display.
    
    Specified by:
    
    addGeometry in interface PvDisplayIf
  - removeGeometries
```
public void removeGeometries()
```
    Remove all geometries from list of registered geometries. The current geometry is null after this call.
    This method does not remove any special geometry like bounding box, axis frame etc. The special geometries must be removed individually using methods like showBndBox(false).
    
    Specified by:
    
    removeGeometries in interface PvDisplayIf
  - removeGeometry
```
public boolean removeGeometry(PgGeometryIf aGeom)
```
    Remove geometry from list of registered geometries. The current geometry changes if it was the removed geometry.
    If the currently active geometry is removed, then the first geometry becomes active.
    
    Specified by:
    
    removeGeometry in interface PvDisplayIf
  - selectGeometry
```
public boolean selectGeometry(PgGeometryIf aGeom)
```
    Select geometry to be active and receive pick events.
    
    Specified by:
    
    selectGeometry in interface PvDisplayIf
  - containsGeometry
```
public boolean containsGeometry(PgGeometryIf aGeom)
```
    Check whether geometry is registered in display.
    
    Specified by:
    
    containsGeometry in interface PvDisplayIf
  - getNumGeometries
```
public int getNumGeometries()
```
    Get number of all registered geometry in display. Method does not return any special geometries like bounding box, coordinate frames etc.
    
    Specified by:
    
    getNumGeometries in interface PvDisplayIf
  - getGeometries
```
public PgGeometryIf[] getGeometries()
```
    Get array with registered geometries. The currently active geometry can be obtained using getSelectedGeometry. Method does not return any special geometries like bounding box which are for internal use only.
    
    Specified by:
    
    getGeometries in interface PvDisplayIf
    
    Returns:
    array with registered geometries
  - getVisibleGeometries
```
public PgGeometryIf[] getVisibleGeometries()
```
    Get array with registered and visible geometries. Method does not return any special geometries like bounding box which are for internal use only.
    
    Specified by:
    
    getVisibleGeometries in interface PvDisplayIf
    
    Returns:
    array with visible geometries
    Since:
    
    JavaView 2.68.000
  - getSelectedGeometry
```
public PgGeometryIf getSelectedGeometry()
```
    Get currently selected geometry.
    
    Specified by:
    
    getSelectedGeometry in interface PvDisplayIf
  - center
```
public void center()
```
    Center geometry in window, do no scaling
    
    Specified by:
    
    center in interface PvDisplayIf
  - saveCameraDefaults
```
public void saveCameraDefaults()
```
    Save settings of current camera as default. Default values can be reactivated with the reset button or key.
    
    Since:
    
    JavaView 2.47
  - fit
```
public boolean fit()
```
    Center and scale camera such that geometry fits exactly into window. If display was not laid out yet or no geometry available then fit() does nothing and returns false.
    
    Specified by:
    
    fit in interface PvDisplayIf
    
    Returns:
    true if fitting was successful.
  - fit
```
public boolean fit(PvCamera camera)
```
    Center and scale camera such that geometry fits exactly into window. If display was not laid out yet or no geometry available then fit() does nothing and returns false. The fitting will be written to the given camera object.
    
    Parameters:
    camera - Output parameter for writing the camera after fitting.
    
    Returns:
    true if fitting was successful.
  - getBackgroundColor
```
public java.awt.Color getBackgroundColor()
```
    Get color of background of display. If background image is set, then color is visible in transparent regions of the image.
    
    Specified by:
    
    getBackgroundColor in interface PvDisplayIf
  - setBackgroundColor
```
public void setBackgroundColor(java.awt.Color color)
```
    Set color of background of display. If background image is set, then color is visible in transparent regions of the image.
    
    Specified by:
    
    setBackgroundColor in interface PvDisplayIf
  - getForegroundColor
```
public java.awt.Color getForegroundColor()
```
    Get foreground color. Currently neither defined nor used.
    
    Specified by:
    
    getForegroundColor in interface PvDisplayIf
  - setForegroundColor
```
public void setForegroundColor(java.awt.Color color)
```
    Set foreground color of display. Currently neither defined nor used.
    
    Specified by:
    
    setForegroundColor in interface PvDisplayIf
  - isEnabledInspection
```
public boolean isEnabledInspection()
```
    Check whether display and selected geometry can be inspected in control window.
    
    Specified by:
    
    isEnabledInspection in interface PvDisplayIf
    
    Since:
    
    JavaView 3.96.022
  - setEnabledInspection
```
public void setEnabledInspection(boolean flag)
```
    Enable whether display and selected geometry can be inspected in control window.
    
    Specified by:
    
    setEnabledInspection in interface PvDisplayIf
    
    Since:
    
    JavaView 3.96.022
  - isEnabledAnimation
```
public boolean isEnabledAnimation()
```
    Check whether auto-rotation is enabled.
    
    Specified by:
    
    isEnabledAnimation in interface PvDisplayIf
  - setEnabledAnimation
```
public void setEnabledAnimation(boolean flag)
```
    Enable and disable auto-rotation of scene.
    
    Specified by:
    
    setEnabledAnimation in interface PvDisplayIf
  - getAmbientSpace
```
public int getAmbientSpace()
```
    Get ambient space used in model transformations.
  - setAmbientSpace
```
public void setAmbientSpace(int mode)
```
    Set ambient space used in model transformations.
  - getAmbientProjection
```
public int getAmbientProjection()
```
    Get projection mode of ambient space used in model camera.
  - setAmbientProjection
```
public void setAmbientProjection(int mode)
```
    Set projection mode of ambient space used in model camera.
  - isEnabledLocalTransform
```
public boolean isEnabledLocalTransform()
```
    Get flag whether local coordinate system is used in camera transformations.
    
    Specified by:
    
    isEnabledLocalTransform in interface PvDisplayIf
  - setEnabledLocalTransform
```
public void setEnabledLocalTransform(boolean flag)
```
    Set flag whether local coordinate system is used in camera transformations.
    
    Specified by:
    
    setEnabledLocalTransform in interface PvDisplayIf
  - getTransformationMode
```
public int getTransformationMode()
```
    Check whether transformation of current model is active, i.e. of model matrix. Otherwise, whole scene is transformed, i.e. project and view matrix.
    
    Specified by:
    
    getTransformationMode in interface PvDisplayIf
  - setTransformationMode
```
public void setTransformationMode(int mode)
```
    Enable transformation of modeling matrix M of single geometry rather than transforming the whole scene by modifying project P and view V matrices.
    
    Specified by:
    
    setTransformationMode in interface PvDisplayIf
  - resetTransformModel
```
public void resetTransformModel()
```
    Reset ambient and model matrix of current model and modelCamera.
  - getSearchPaths
```
public java.lang.String[] getSearchPaths()
```
    Get image search paths.
    
    Returns:
    array of search paths
    Since:
    
    JavaView 3.61.003
  - setSearchPaths
```
public void setSearchPaths(java.lang.String[] searchPath)
```
    Set image search paths.
    
    Parameters:
    searchPath - array of search paths
    Since:
    
    JavaView 3.61.003
  - isEnabledFillDisplay
```
public boolean isEnabledFillDisplay()
```
    Check if scaling of scene to fill display is enabled.
    
    Specified by:
    
    isEnabledFillDisplay in interface PvDisplayIf
    
    Since:
    
    JavaView v3.94.003.
  - setEnabledFillDisplay
```
public void setEnabledFillDisplay(boolean flag)
```
    Determine if scaling of scene to fill display is enabled.
    
    Specified by:
    
    setEnabledFillDisplay in interface PvDisplayIf
    
    Since:
    
    JavaView v3.94.003.
  - getImageFitMode
```
public int getImageFitMode()
```
    Deprecated. use getBackgroundImageFit()
    
    Get the mode determining how a background image is scaled w.r.t. the display canvas.
    
    Specified by:
    
    getImageFitMode in interface PvDisplayIf
  - setImageFitMode
```
public void setImageFitMode(int mode)
```
    Deprecated. use setBackgroundImageFit(int)
    
    Set the mode determining how a background image is scaled w.r.t. the display canvas.
    
    Specified by:
    
    setImageFitMode in interface PvDisplayIf
  - getBackgroundImageFit
```
public int getBackgroundImageFit()
```
    Get the mode determining how a background image is scaled w.r.t. the display canvas.
    
    Specified by:
    
    getBackgroundImageFit in interface PvDisplayIf
    
    Since:
    
    JavaView 2.36
  - setBackgroundImageFit
```
public void setBackgroundImageFit(int mode)
```
    Set the mode determining how a background image is scaled w.r.t. the display canvas.
    
    Specified by:
    
    setBackgroundImageFit in interface PvDisplayIf
    
    Since:
    
    JavaView 2.36
  - getForegroundImageFit
```
public int getForegroundImageFit()
```
    Get the mode determining how a foreground image is scaled w.r.t. the display canvas.
    
    Specified by:
    
    getForegroundImageFit in interface PvDisplayIf
    
    Since:
    
    JavaView 2.36
  - setForegroundImageFit
```
public void setForegroundImageFit(int mode)
```
    Set the mode determining how a background image is scaled w.r.t. the display canvas.
    
    Specified by:
    
    setForegroundImageFit in interface PvDisplayIf
    
    Since:
    
    JavaView 2.36
  - isShowingBackImage
```
public boolean isShowingBackImage()
```
    Deprecated. use isShowingBackgroundImage()
    
    Check drawing of background image of display window.
    
    Specified by:
    
    isShowingBackImage in interface PvDisplayIf
  - isShowingBackgroundImage
```
public boolean isShowingBackgroundImage()
```
    Check drawing of background image of display window.
    
    Specified by:
    
    isShowingBackgroundImage in interface PvDisplayIf
    
    Since:
    
    JavaView 2.31
  - showBackImage
```
public void showBackImage(boolean aFlag)
```
    Deprecated. use showBackgroundImage(boolean)
    
    Enable and disable drawing of background image of display window.
  - showBackgroundImage
```
public void showBackgroundImage(boolean aFlag)
```
    Enable and disable drawing of background image of display window. Image is loaded from file if file name exists and showing of image is enabled.
    
    Specified by:
    
    showBackgroundImage in interface PvDisplayIf
    
    Since:
    
    JavaView 2.31
  - isShowingForegroundImage
```
public boolean isShowingForegroundImage()
```
    Check drawing of foreground image of display window.
    
    Specified by:
    
    isShowingForegroundImage in interface PvDisplayIf
    
    Since:
    
    JavaView 2.31
  - showForegroundImage
```
public void showForegroundImage(boolean aFlag)
```
    Enable and disable drawing of foreground image of display window. Image is loaded from file if file name exists and showing of image is enabled.
    
    Specified by:
    
    showForegroundImage in interface PvDisplayIf
    
    Since:
    
    JavaView 2.31
  - isShowingCopyright
```
public boolean isShowingCopyright()
```
    Check drawing of copyright information in the display window.
    
    Specified by:
    
    isShowingCopyright in interface PvDisplayIf
  - showCopyright
```
public void showCopyright(boolean aFlag)
```
    Enable and disable drawing of copyright information in the display window.
    
    Specified by:
    
    showCopyright in interface PvDisplayIf
  - isShowingTitle
```
public boolean isShowingTitle()
```
    Check drawing of title north in the display window.
    
    Specified by:
    
    isShowingTitle in interface PvDisplayIf
    
    Since:
    
    JavaView 2.49.004
  - showTitle
```
public void showTitle(boolean aFlag)
```
    Enable and disable drawing of title north in the display window.
    
    Specified by:
    
    showTitle in interface PvDisplayIf
    
    Since:
    
    JavaView 2.49.004
  - isShowingDepthcue
```
public boolean isShowingDepthcue()
```
    True if depthcue is enabled. No depthcue for non-perspective projections. Depthcue is always switched off for non-perspective projections since they usually show planar geometries where depthcue makes not too much sense.
    
    Specified by:
    
    isShowingDepthcue in interface PvDisplayIf
  - showDepthcue
```
public void showDepthcue(boolean aFlag)
```
    Enable and disable depthcue drawing.
    
    Specified by:
    
    showDepthcue in interface PvDisplayIf
  - getLightingModel
```
public int getLightingModel()
```
    Get currently active lighting model.
    
    Specified by:
    
    getLightingModel in interface PvDisplayIf
    
    Returns:
    lighting model as determined by PvLightIf.MODEL_LIGHT etc.
  - setLightingModel
```
public void setLightingModel(int model)
```
    Set current lighting model, and thereby enable or disable usage of light. If lighting model is PvLightIf.MODEL_SURFACE then the surface color is used and explicit lighting is disabled. Lighting model must be set after the lights are known to the display.
    
    Specified by:
    
    setLightingModel in interface PvDisplayIf
    
    Parameters:
    model - lighting model as determined by PvLightIf.MODEL_LIGHT etc.
  - isShowingEdgesOnce
```
public boolean isShowingEdgesOnce()
```
    Check flag of drawing of edges by one or both elements adjacent to an edge.
    
    Specified by:
    
    isShowingEdgesOnce in interface PvDisplayIf
  - showEdgesOnce
```
public void showEdgesOnce(boolean aFlag)
```
    Enable and disable drawing of edges by one or both elements adjacent to an edge.
    
    Specified by:
    
    showEdgesOnce in interface PvDisplayIf
  - isShowingEdgeAura
```
public boolean isShowingEdgeAura()
```
    Check flag of drawing of edges by one or both elements adjacent to an edge.
    
    Specified by:
    
    isShowingEdgeAura in interface PvDisplayIf
  - showEdgeAura
```
public void showEdgeAura(boolean aFlag)
```
    Enable and disable drawing of edges by one or both elements adjacent to an edge.
    
    Specified by:
    
    showEdgeAura in interface PvDisplayIf
  - setDrawingOrder
```
public void setDrawingOrder(int order,
                   PgGeometryIf aGeom)
```
    Choose z-order of geometry when drawn in display. For possible values see e.g. PvGeometryIf#DRAW_ORDER_STANDARD.
    
    Specified by:
    
    setDrawingOrder in interface PvDisplayIf
    
    See Also:
    PvGeometryIf
  - isShowingGrid
```
public boolean isShowingGrid()
```
    Check whether grid is currently showing.
    
    Specified by:
    
    isShowingGrid in interface PvDisplayIf
  - showGrid
```
public void showGrid(boolean flag)
```
    Set visibility of grid, and create grid if not available.
    
    Specified by:
    
    showGrid in interface PvDisplayIf
  - getGridIncrements
```
public PdVector getGridIncrements(int gridOrient)
```
    Get spacing between grid lines in both coordinate directions.
    
    Specified by:
    
    getGridIncrements in interface PvDisplayIf
    
    Returns:
    Increments determine the spacing for both gridlines.
    Since:
    
    JavaView 3.96.014
  - setGridIncrements
```
public void setGridIncrements(int gridOrient,
                     PdVector gridIncrements)
```
    Set spacing between grid lines in both coordinate directions. Must invoke #compute() after orientation has changed.
    
    Specified by:
    
    setGridIncrements in interface PvDisplayIf
    
    Parameters:
    gridOrient - Determines the xy, yz, or xz plane, see PvDisplayIf#GRID_XY.
    gridIncrements - Determine the spacing for both gridlines.
    Since:
    
    JavaView 3.96.014
  - getGridOrientation
```
public int getGridOrientation()
```
    Get orientation of grid which determines the plane in which the grid lies.
    
    Returns:
    Orientation identified as PvGrid#GRID_XY etc.
    Since:
    
    JavaView 3.96.014
  - setGridOrientation
```
public void setGridOrientation(int gridOrient)
```
    Set orientation of grid which determines the plane in which the grid lies. Orientation is identified using PvGrid#GRID_XY etc. Must invoke #compute() after orientation has changed.
    
    Parameters:
    gridOrient - Orientation identified as PvGrid#GRID_XY etc.
    Since:
    
    JavaView 3.96.014
  - getFrameLabel
```
public java.lang.String getFrameLabel(int index)
```
    Get one of the labels of the coordinate frame.
    
    Parameters:
    index - 0 for x-Axis, 1 for y-Axis and so on
    Since:
    
    JavaView 2.48.005
    
    See Also:
    showFrame(boolean)
  - setFrameLabel
```
public void setFrameLabel(int index,
                 java.lang.String label)
```
    Sets one of the labels of the coordinate frame.
    
    Parameters:
    index - 0 for x-Axis, 1 for y-Axis and so on
    Since:
    
    JavaView 2.48.005
    
    See Also:
    showFrame(boolean)
  - isShowingFrame
```
public boolean isShowingFrame()
```
    Check whether coordinate frame is currently showing.
    
    Specified by:
    
    isShowingFrame in interface PvDisplayIf
  - showFrame
```
public void showFrame(boolean aFlag)
```
    Set visibility of coordinate frame is shown, and create frame if not available.
    
    Specified by:
    
    showFrame in interface PvDisplayIf
  - isShowingBndBox
```
public boolean isShowingBndBox()
```
    Check whether bounding box of active geometry is currently showing.
    
    Specified by:
    
    isShowingBndBox in interface PvDisplayIf
  - showBndBox
```
public void showBndBox(boolean aFlag)
```
    Set visibility of bounding box of active geometry, and create bounding box if not available.
    
    Specified by:
    
    showBndBox in interface PvDisplayIf
  - getBndBoxColor
```
public java.awt.Color getBndBoxColor()
```
    Get color of bounding box.
    
    Specified by:
    
    getBndBoxColor in interface PvDisplayIf
    
    Returns:
    color of bounding box
    Since:
    
    JavaView 2.49.005
  - setBndBoxColor
```
public void setBndBoxColor(java.awt.Color color)
```
    Set color of bounding box.
    
    Specified by:
    
    setBndBoxColor in interface PvDisplayIf
    
    Parameters:
    color - color of bounding box
    Since:
    
    JavaView 2.49.005
  - getBndBoxSize
```
public double getBndBoxSize()
```
    Get thickness of edges of bounding box.
    
    Specified by:
    
    getBndBoxSize in interface PvDisplayIf
    
    Returns:
    thickness of edges bounding box
    Since:
    
    JavaView 2.49.005
  - setBndBoxSize
```
public void setBndBoxSize(double size)
```
    Set thickness of edges of bounding box.
    
    Specified by:
    
    setBndBoxSize in interface PvDisplayIf
    
    Parameters:
    size - thickness of edges bounding box
    Since:
    
    JavaView 2.49.005
  - isShowingInterest
```
public boolean isShowingInterest()
```
    Check whether interest of active camera is visible.
  - showInterest
```
public void showInterest(boolean aFlag)
```
    Set visibility of interest of active camera, and create interest geometry if not available.
    BETA: Currently only used in fly mode.
  - isShowingCamera
```
public boolean isShowingCamera()
```
    Check whether active camera of this display is visible.
  - showCamera
```
public void showCamera(boolean aFlag)
```
    Set visibility of active camera in this display, and create camera geometry if not available.
  - isEnabledClearScreen
```
public boolean isEnabledClearScreen()
```
    Check whether screen is cleared after each repaint.
  - setEnabledClearScreen
```
public void setEnabledClearScreen(boolean aFlag)
```
    Enable clearing of screen after each repaint.
  - addLight
```
public boolean addLight(PvLightIf light)
```
    Add a light to the current scene. Light is internally registered using a unique name in an additional hashtable m_light.
    
    Specified by:
    
    addLight in interface PvDisplayIf
    
    Parameters:
    light - new light added to scene
  - getNumLights
```
public int getNumLights()
```
    Get number of light objects.
    
    Specified by:
    
    getNumLights in interface PvDisplayIf
    
    Returns:
    number of light objects
  - getLight
```
public PvLightIf getLight()
```
    Get current light object.
    
    Specified by:
    
    getLight in interface PvDisplayIf
    
    Returns:
    current light object
  - getLights
```
public PvLightIf[] getLights()
```
    Get registered lights as array.
    
    Specified by:
    
    getLights in interface PvDisplayIf
    
    Returns:
    array of registered lights
  - hasLight
```
public boolean hasLight(PvLightIf light)
```
    Determine whether a light is registered in display.
    
    Specified by:
    
    hasLight in interface PvDisplayIf
    
    Parameters:
    light - a light object
    
    Returns:
    true if light is registered.
  - removeLights
```
public void removeLights()
```
    Remove all lights from list of registered lights in this scene.
    
    Specified by:
    
    removeLights in interface PvDisplayIf
  - removeLight
```
public boolean removeLight(PvLightIf light)
```
    Remove light from list of registered lights in this scene.
    
    Specified by:
    
    removeLight in interface PvDisplayIf
    
    Parameters:
    light - a registered light object to be removed
    
    Returns:
    true if light was found and successfully removed.
  - getSelectedLight
```
public PvLightIf getSelectedLight()
```
    Select light from the list of registered lights in this scene.
    
    Specified by:
    
    getSelectedLight in interface PvDisplayIf
    
    Returns:
    light object if it was found and successfully selected, else null.
  - hasAxes
```
public boolean hasAxes()
```
    Check existence of axes geometry.
  - recomputeAxes
```
public void recomputeAxes()
```
    Recalculate length of axes depending on bounding box of scene or current geometry depending on current transformation mode.
  - getAxes
```
public PgAxes getAxes()
```
    Get axes geometry with individual rulers for each coordinate axis. If axes were never visible and never assigned from outside then no axes exist and null is returned.
    Before v2.00 of this method, axes were created if they did not exist.
  - setAxes
```
public void setAxes(PgAxes axes)
```
    Register axes geometry in this display. By default, the axes is not visible. Switching off the visibility.
  - isShowingAxes
```
public boolean isShowingAxes()
```
    Check whether axes of active geometry is currently showing.
    
    Specified by:
    
    isShowingAxes in interface PvDisplayIf
  - showAxes
```
public void showAxes(boolean aFlag)
```
    Set visibility of axes active geometry, and create axes if not available. If visibility is set to false, then axes are removed from the display but not deleted.
    
    Specified by:
    
    showAxes in interface PvDisplayIf
  - getPickType
```
public int getPickType()
```
    Get pick type which determines the class of pickable geometries in pick and initialPick mode.
    A set of geometry classes may be determined using or'ed combinations of other PICK_yyy types.
    
    Since:
    
    JavaView 3.96.037
    
    See Also:
    PvDisplayIf.PICK_ALL
  - setPickType
```
public void setPickType(int type)
```
    Set pick type which determines the class of pickable geometries in pick and initialPick mode.
    A set of geometry classes may be determined using or'ed combinations of other PICK_yyy types.
    
    Since:
    
    JavaView 3.96.037
    
    See Also:
    PvDisplayIf.PICK_ALL
  - isEnabledIntegerPick
```
public boolean isEnabledIntegerPick()
```
    Check whether picking is constrained to an integer grid.
    
    Specified by:
    
    isEnabledIntegerPick in interface PvDisplayIf
    
    Since:
    
    JavaView 3.63.002
  - setEnabledIntegerPick
```
public void setEnabledIntegerPick(boolean flag)
```
    Restrict picking to an integer grid.
    
    Specified by:
    
    setEnabledIntegerPick in interface PvDisplayIf
    
    Since:
    
    JavaView 3.63.002
  - isShowingMagnet
```
public boolean isShowingMagnet()
```
    Check whether cursor attached to vertices if nearby.
    
    Specified by:
    
    isShowingMagnet in interface PvDisplayIf
  - showMagnet
```
public void showMagnet(boolean aFlag)
```
    Attach cursor to vertices if nearby.
    
    Specified by:
    
    showMagnet in interface PvDisplayIf
  - isEnabledDirectSelect
```
public boolean isEnabledDirectSelect()
```
    Check whether selecting is enabled during mouse pick.
    
    Specified by:
    
    isEnabledDirectSelect in interface PvDisplayIf
  - setEnabledDirectSelect
```
public void setEnabledDirectSelect(boolean flag)
```
    Enable and disable clipping with front and back plane.
    
    Specified by:
    
    setEnabledDirectSelect in interface PvDisplayIf
  - isEnabledFastClipping
```
public static boolean isEnabledFastClipping()
```
    Check whether fast clipping of geometry items is enabled.
  - setEnabledFastClipping
```
public static void setEnabledFastClipping(boolean aFlag)
```
    Enable and disable fast clipping of geometry items during rendering.
    
    See Also:
    isEnabledFastClipping()
  - isEnabledFastZBuffer
```
public static boolean isEnabledFastZBuffer()
```
    Check whether z-buffered is disabled during drawing. Note, z-buffered drawing must be enabled using method setEnabledZBuffer.
    
    See Also:
    setEnabledZBuffer(boolean), setEnabledFastZBuffer(boolean)
  - setEnabledFastZBuffer
```
public static void setEnabledFastZBuffer(boolean aFlag)
```
    Enable and disable z-buffered drawing of scene. Note, z-buffered drawing must be enabled using method setEnabledZBuffer..
    
    See Also:
    setEnabledZBuffer(boolean), isEnabledFastZBuffer()
  - isEnabledZBuffer
```
public boolean isEnabledZBuffer()
```
    Check whether z-buffered drawing is enabled.
    
    Specified by:
    
    isEnabledZBuffer in interface PvDisplayIf
  - setEnabledZBuffer
```
public void setEnabledZBuffer(boolean flag)
```
    Enable and disable z-buffered drawing of scene. Note, z-buffered drawing may be automatically disabled during dragging of mouse using setEnabledFastZBuffer.
    
    Specified by:
    
    setEnabledZBuffer in interface PvDisplayIf
    
    See Also:
    isEnabledZBuffer(), setEnabledFastZBuffer(boolean)
  - isEnabledTags
```
public boolean isEnabledTags()
```
    Determine whether tag mode is enabled to move marked elements.
  - setEnabledTags
```
public void setEnabledTags(boolean flag)
```
    Enable and disable tag mode to move marked elements.
  - isEnabledPainters
```
public boolean isEnabledPainters()
```
    Check whether painter's algorithm during drawing is enabled.
    
    Specified by:
    
    isEnabledPainters in interface PvDisplayIf
  - setEnabledPainters
```
public void setEnabledPainters(boolean flag)
```
    Enable and disable painter's algorithm during drawing, i.e. a z-sort of drawing items.
    
    Specified by:
    
    setEnabledPainters in interface PvDisplayIf
  - isEnabledClip
```
public boolean isEnabledClip()
```
    Check whether clipping with front and back plane is enabled.
    
    Specified by:
    
    isEnabledClip in interface PvDisplayIf
  - setEnabledClip
```
public void setEnabledClip(boolean flag)
```
    Enable and disable clipping with front and back plane in camera viewing direction.
    
    Specified by:
    
    setEnabledClip in interface PvDisplayIf
  - isEnabledClipAutoBounds
```
public boolean isEnabledClipAutoBounds()
```
    Check whether automatic recalculation of clip range is enabled when clipRange is switched on.
    
    Specified by:
    
    isEnabledClipAutoBounds in interface PvDisplayIf
  - setEnabledClipAutoBounds
```
public void setEnabledClipAutoBounds(boolean flag)
```
    Enable automatic recalculation of clip range when clipRange is switched on.
    
    Specified by:
    
    setEnabledClipAutoBounds in interface PvDisplayIf
  - isEnabledClipBounds
```
public boolean isEnabledClipBounds()
```
    Check whether clipping with scene in direction of coordinate axis is enabled.
    
    Specified by:
    
    isEnabledClipBounds in interface PvDisplayIf
  - setEnabledClipBounds
```
public void setEnabledClipBounds(boolean flag)
```
    Enable and disable clipping of scene along coordinate axes.
    
    Specified by:
    
    setEnabledClipBounds in interface PvDisplayIf
  - isEnabledBoxRatio
```
public boolean isEnabledBoxRatio()
```
    Check whether individual scaling factors of coordinate axes is enabled.
    
    Specified by:
    
    isEnabledBoxRatio in interface PvDisplayIf
  - setEnabledBoxRatio
```
public void setEnabledBoxRatio(boolean flag)
```
    Enable and disable individual scaling factors of coordinate axes.
    
    Specified by:
    
    setEnabledBoxRatio in interface PvDisplayIf
  - getBoxRatio
```
public PdVector getBoxRatio()
```
    Get individual scaling factors of coordinate axes.
    
    Specified by:
    
    getBoxRatio in interface PvDisplayIf
    
    Returns:
    scaling factors of coordinate axes
    Since:
    
    JavaView 2.60.002
  - setBoxRatio
```
public void setBoxRatio(PdVector ratio)
```
    Set individual scaling factors of coordinate axes.
    
    Specified by:
    
    setBoxRatio in interface PvDisplayIf
    
    Parameters:
    ratio - scaling factors of coordinate axes
    Since:
    
    JavaView 2.60.002
  - isClip
```
public boolean isClip()
```
    Deprecated. use #isEnabledClip
    
    Check whether clipping with front and back plane is enabled.
    
    Specified by:
    
    isClip in interface PvDisplayIf
  - enableClip
```
public void enableClip(boolean aFlag)
```
    Deprecated. use #setEnabledClip
    
    Enable and disable clipping with front and back plane.
    
    Specified by:
    
    enableClip in interface PvDisplayIf
  - getNearClip
```
public double getNearClip()
```
    Get near clip distance of current camera. Returns a value even if clipping is disabled.
    
    Specified by:
    
    getNearClip in interface PvDisplayIf
  - setNearClip
```
public void setNearClip(double dist)
```
    Set near clip distance of current camera, works even if clipping is disabled.
    
    Specified by:
    
    setNearClip in interface PvDisplayIf
  - getFarClip
```
public double getFarClip()
```
    Get far clip distance of current camera. Returns a value even if clipping is disabled.
    
    Specified by:
    
    getFarClip in interface PvDisplayIf
  - setFarClip
```
public void setFarClip(double dist)
```
    Set far clip distance of current camera, works even if clipping is disabled.
    
    Specified by:
    
    setFarClip in interface PvDisplayIf
  - getClipBoundsType
```
public int getClipBoundsType()
```
    Get index of axis which is selected when scene clip bounds is active of becomes active.
    
    Specified by:
    
    getClipBoundsType in interface PvDisplayIf
    
    Since:
    
    JavaView 2.99.012
  - setClipBoundsType
```
public void setClipBoundsType(int type)
```
    Set index of axis which is selected when scene clip bounds is active of becomes active.
    
    Specified by:
    
    setClipBoundsType in interface PvDisplayIf
    
    Since:
    
    JavaView 2.99.012
  - getClipBounds
```
public double[] getClipBounds(int ind)
```
    Get minimum and maximum in one dimension of the clipping box.
    
    Specified by:
    
    getClipBounds in interface PvDisplayIf
    
    Parameters:
    ind - index of ruler of axes in which direction is clipped
    
    Returns:
    range minimum and maximum of visible range in axis direction
    Since:
    
    JavaView 2.49.005
  - setClipBounds
```
public void setClipBounds(int ind,
                 double[] range)
```
    Set minimum and maximum in one dimension of the clipping box.
    
    Specified by:
    
    setClipBounds in interface PvDisplayIf
    
    Parameters:
    ind - index of ruler of axes in which direction is clipped
    range - minimum and maximum of visible range in axis direction
    Since:
    
    JavaView 2.49.005
  - isEnabled3DLook
```
public boolean isEnabled3DLook()
```
    Check whether thick vertices and edges are drawn as 3d shapes in z-buffer mode.
    
    Specified by:
    
    isEnabled3DLook in interface PvDisplayIf
    
    Since:
    
    JavaView 3.20.004
  - setEnabled3DLook
```
public void setEnabled3DLook(boolean flag)
```
    Enable drawing of thick vertices and edges as 3d shapes in z-buffer mode.
    
    Specified by:
    
    setEnabled3DLook in interface PvDisplayIf
    
    Since:
    
    JavaView 3.20.004
  - isEnabledAdaptiveSize
```
public boolean isEnabledAdaptiveSize()
```
    Check whether adaptive thickness of vertices and edges is enabled.
    
    Specified by:
    
    isEnabledAdaptiveSize in interface PvDisplayIf
    
    Since:
    
    JavaView 3.22.000
  - setEnabledAdaptiveSize
```
public void setEnabledAdaptiveSize(boolean flag)
```
    Enabled adaptive thickness of vertices and edges.
    
    Specified by:
    
    setEnabledAdaptiveSize in interface PvDisplayIf
    
    Since:
    
    JavaView 3.22.000
  - getTransMatrix
```
public PdMatrix getTransMatrix(int type)
```
    Get 4*4 transformation matrix or components from current camera and display. Allows to transform world coordinates into screen coordinates [0,0]*[width-1,height-1] of display.
    
    Specified by:
    
    getTransMatrix in interface PvDisplayIf
    
    Parameters:
    type - Any matrix type jv.project.PvDisplayIf#MATRIX_...
  - setTransMatrix
```
public void setTransMatrix(int type,
                  PdMatrix mat)
```
    Set transformation matrices PV, P, V and their inverses in current camera and display. Allows to transform world coordinates into screen coordinates [0,0]*[width-1,height-1] of display.
    Modeling matrix should be set in original geometry model.
    
    Specified by:
    
    setTransMatrix in interface PvDisplayIf
    
    Parameters:
    type - Any matrix type jv.project.PvDisplayIf#MATRIX_...
  - isShowingAllViews
```
public boolean isShowingAllViews()
```
    Check drawing of copyright information in the display window.
  - addCamera
```
public int addCamera(java.lang.String aName,
            PvCamera aCamera)
```
    Add new camera and make it accessible under the given name. Most applications use the built-in cameras. TODO: Method currently does not allow to add user defined cameras.
    
    Returns:
    unique key of camera which allows to select camera, or -1 if error.
  - getCamera
```
public PvCameraIf getCamera()
```
    Get current camera object.
    
    Specified by:
    
    getCamera in interface PvDisplayIf
    
    Returns:
    current camera object
  - getCameras
```
public PvCameraIf[] getCameras()
```
    Get current camera object.
    
    Specified by:
    
    getCameras in interface PvDisplayIf
    
    Returns:
    current camera object
  - getCamera
```
public PvCameraIf getCamera(int type)
```
    Get a camera object by type. Type is among PvCameraIf#CAMERA_PERSPECTIVE, PvCameraIf#CAMERA_ORTHO_XY, PvCameraIf#CAMERA_ORTHO_XZ, PvCameraIf#CAMERA_ORTHO_YZ, For a list of possible types see PvDisplayIf.
    
    Specified by:
    
    getCamera in interface PvDisplayIf
    
    Parameters:
    type - of camera
    
    Returns:
    null if argument out of bounds or camera not found.
  - hasCamera
```
public boolean hasCamera(int type)
```
    Determine whether a camera object of given type is registered in display. Type is among PvCameraIf#CAMERA_PERSPECTIVE, PvCameraIf#CAMERA_ORTHO_XY, PvCameraIf#CAMERA_ORTHO_XZ, PvCameraIf#CAMERA_ORTHO_YZ, For a list of possible types see PvDisplayIf.
    
    Specified by:
    
    hasCamera in interface PvDisplayIf
    
    Parameters:
    type - of camera
    
    Returns:
    null if argument out of bounds or camera not found.
    See Also:
    selectCamera(int)
  - removeCamera
```
public boolean removeCamera(int type)
```
    Remove camera from list of registered cameras. Type is among PvCameraIf#CAMERA_PERSPECTIVE, PvCameraIf#CAMERA_ORTHO_XY, PvCameraIf#CAMERA_ORTHO_XZ, PvCameraIf#CAMERA_ORTHO_YZ, For a list of possible types see PvDisplayIf.
    
    Specified by:
    
    removeCamera in interface PvDisplayIf
    
    Parameters:
    type - of camera
    
    Returns:
    true if camera was found and successfully removed.
  - getPosition
```
public java.awt.Point getPosition(int xPos,
                         int yPos)
```
    Get upper left corner of frame, or null if no parent frame available.
  - setPosition
```
public void setPosition(int xPos,
               int yPos)
```
    Set position of upper left corner of frame from outside.
  - getSize
```
public java.awt.Dimension getSize()
```
    Get height of drawing canvas.
    
    Specified by:
    
    getSize in interface PvDisplayIf
    
    Overrides:
    
    getSize in class java.awt.Component
  - setSizeWithinFrame
```
public void setSizeWithinFrame(int width,
                      int height)
```
    Set dimension of display which is included in a parent frame. This call should be used instead of a direct call of setSize(Dimension) resp. setSize(int, int). Size of parent frame is the size of the display plus the its border margins.
    
    Specified by:
    
    setSizeWithinFrame in interface PvDisplayIf
    
    Parameters:
    width - width of display area, not of parent frame
    height - height of display area, not of parent frame
  - setDefaultSize
```
public static void setDefaultSize(java.awt.Dimension size)
```
    Set default dimension of drawing canvas from outside. TODO: since v3.63.002, should use setPreferredSize(Dimension) but problem with static/non-static.
  - setPreferredSize
```
public void setPreferredSize(java.awt.Dimension size)
```
    Set default dimension of drawing canvas from outside.
    
    Overrides:
    
    setPreferredSize in class java.awt.Component
    
    Since:
    
    since JavaView v3.63.002.
  - setExternalRenderSize
```
public void setExternalRenderSize(int width,
                         int height)
```
    Set dimension of the external render image. Currently this modifies the size of the offscreen image. When external rendering is switched off in setEnabledExternalRendering(boolean) then the offscreen image is automatically resized to the required size of this display canvas.
    
    Parameters:
    width - width of external render image
    height - height of external render image
  - isEnabledExternalRendering
```
public boolean isEnabledExternalRendering()
```
    Check if rendering into an external image is enabled.
  - setEnabledExternalRendering
```
public void setEnabledExternalRendering(boolean flag)
```
    Enable rendering into an external image.
    Drawing into an external image currently blocks rendering into the AWT drawing canvas of this display. Currently, the external image is the offscreen image which may be obtained from this display using getImage() but future versions will allow to set the external image into which rendering is done.
  - getFather
```
public PsUpdateIf getFather()
```
    Get father of display. Method must be defined since PvDisplay does not derive from PsObject.
    
    Specified by:
    
    getFather in interface PsUpdateIf
    
    See Also:
    PsUpdateIf.setParent(PsUpdateIf), PsUpdateIf.update(Object)
  - setParent
```
public void setParent(PsUpdateIf father)
```
    Set father of display which receives update events when current class has changed. Method must be defined since PvDisplay does not derive from PsObject.
    
    Specified by:
    
    setParent in interface PsUpdateIf
    
    Parameters:
    father - will receive events which this does not handle
    See Also:
    PsUpdateIf.getFather(), PsUpdateIf.update(Object)
  - isEnabledRepaint
```
public boolean isEnabledRepaint()
```
    Determine whether painting is enabled.
    
    Specified by:
    
    isEnabledRepaint in interface PvDisplayIf
    
    Since:
    
    JavaView 3.62.000
  - setEnabledRepaint
```
public void setEnabledRepaint(boolean flag)
```
    Set flag which determines whether painting is enabled. Switch off repaint when updating a larger number of geometries at the same time.
    
    Specified by:
    
    setEnabledRepaint in interface PvDisplayIf
    
    Since:
    
    JavaView 3.62.000
  - isEnabledUpdate
```
public boolean isEnabledUpdate()
```
    Determine whether update mechanism is enabled.
    
    Specified by:
    
    isEnabledUpdate in interface PvDisplayIf
  - setEnabledUpdate
```
public void setEnabledUpdate(boolean flag)
```
    Set flag which determines whether update mechanism is enabled.
    
    Specified by:
    
    setEnabledUpdate in interface PvDisplayIf
  - update
```
public boolean update(java.lang.Object event)
```
    Handle update events sent to display by JavaView. Notice, Java itself sends update(Graphics) calls to display too.
    
    Specified by:
    
    update in interface PsUpdateIf
    
    Specified by:
    
    update in interface PvDisplayIf
    
    Parameters:
    event - carries a lot of information
    
    Returns:
    true if event has been handled, otherwise false
    See Also:
    PsObject, PsUpdateIf.getFather(), PsUpdateIf.setParent(PsUpdateIf)
  - hasPaintTag
```
public boolean hasPaintTag(long flags)
```
    Check whether either if the bits in parameter has been set.
    
    Specified by:
    
    hasPaintTag in interface PvDisplayIf
    
    See Also:
    setPaintTag(long, boolean)
  - setPaintTag
```
public void setPaintTag(long flags,
               boolean val)
```
    Set all bits which are set in parameter. See jv.project.PvDisplayIf for a list of possible flags.
    Special flag for internal purpose is PAINT_ZOOM: Scale transformation matrix to simulate floating point accuracy in pixel integers. Required for PostScript printing to increase pixel accuracy.
    HACK: This PostScript Driver temporarily scales all integer valued quantities during display by a factor of PS_ZOOM to increase accuracy. The variable PS_ZOOM is set to allow to adjust all 'thickness' sizes as well. The thickness sizes are not scaled by PostScript, so we must do it in PvThickGraphics by hand. This procedure is very error prune.
    Setting flag PvDisplayIf#PAINT_ALL invokes a repaint() of the display, just for convenience.
    
    Specified by:
    
    setPaintTag in interface PvDisplayIf
    
    See Also:
    hasPaintTag(long)
  - isEnabledAntiAlias
```
public boolean isEnabledAntiAlias()
```
    Check if antialiased drawing is enabled.
    
    Specified by:
    
    isEnabledAntiAlias in interface PvDisplayIf
  - setEnabledAntiAlias
```
public void setEnabledAntiAlias(boolean flag)
```
    Enable antialiased drawing. Antialiased drawing will slow down the rendering speed.
    
    Specified by:
    
    setEnabledAntiAlias in interface PvDisplayIf
  - isEnabledDoubleBuffer
```
public boolean isEnabledDoubleBuffer()
```
    Check if double buffered drawing is enabled.
    
    Specified by:
    
    isEnabledDoubleBuffer in interface PvDisplayIf
  - setEnabledDoubleBuffer
```
public void setEnabledDoubleBuffer(boolean flag)
```
    Enable double buffered drawing.
    
    Specified by:
    
    setEnabledDoubleBuffer in interface PvDisplayIf
  - paint
```
public void paint(java.awt.Graphics g)
```
    Override Canvas.paint(g) to initiate redrawing of geometries.
    
    Overrides:
    
    paint in class java.awt.Canvas
  - update
```
public void update(java.awt.Graphics g)
```
    Override Component.update(g) to initiate redrawing of geometries.
    
    Overrides:
    
    update in class java.awt.Canvas
  - repaint
```
public void repaint()
```
    For debug only.
    
    Overrides:
    
    repaint in class java.awt.Component
  - render
```
public void render()
```
    Initiate the rendering process when using this display as a batch renderer.
  - resizeImage
```
public boolean resizeImage()
```
    Resize the target screen image if user has changed the canvas size. Scale background image to fit the whole canvas. Disable width and height slider if container is not a frame.
    
    Returns:
    false if size of display still 0.
  - setAutoCenter
```
public void setAutoCenter(boolean flag)
```
    Set flag which determines whether camera will automatically center on geometry. An argument false will prevent automatic centering.
    
    Specified by:
    
    setAutoCenter in interface PvDisplayIf
  - getImage
```
public java.awt.Image getImage()
```
    Make image of display available to outside world.
    
    Specified by:
    
    getImage in interface PvDisplayIf
  - getBackgroundImage
```
public java.awt.Image getBackgroundImage()
```
    Make background image of display available to outside world.
    
    Specified by:
    
    getBackgroundImage in interface PvDisplayIf
  - setBackgroundImage
```
public void setBackgroundImage(java.awt.Image anImage)
```
    Set background image of display canvas. Use showForegroundImage(boolean) to set visibility of foreground image.
    
    Specified by:
    
    setBackgroundImage in interface PvDisplayIf
  - getBackgroundImageFile
```
public java.lang.String getBackgroundImageFile()
```
    Get filename of background image of display canvas.
    
    Specified by:
    
    getBackgroundImageFile in interface PvDisplayIf
    
    Returns:
    relative file name of image.
  - setBackgroundImageFile
```
public void setBackgroundImageFile(java.lang.String fileName)
```
    Set filename of background image of display canvas. Method tries to load file immediately if showing of image is enabled.
    
    Specified by:
    
    setBackgroundImageFile in interface PvDisplayIf
    
    Parameters:
    fileName - relative file name of image.
    Since:
    
    JavaView 2.31
  - setBackgroundImage
```
public void setBackgroundImage(java.lang.String fileName)
```
    Deprecated. use setBackgroundImageFile(String)
    
    Load an image from file and set it as background image of display canvas. Method tries to load the image from file immediately.
    
    Parameters:
    fileName - relative file name of image.
  - getForegroundImage
```
public java.awt.Image getForegroundImage()
```
    Get foreground image of display canvas.
    
    Specified by:
    
    getForegroundImage in interface PvDisplayIf
    
    Since:
    
    JavaView 2.31
  - setForegroundImage
```
public void setForegroundImage(java.awt.Image image)
```
    Set foreground image of display canvas. Use showForegroundImage(boolean) to set visibility of foreground image.
    
    Specified by:
    
    setForegroundImage in interface PvDisplayIf
    
    Since:
    
    JavaView 2.31
  - getForegroundImageFile
```
public java.lang.String getForegroundImageFile()
```
    Get filename of foreground image of display canvas.
    
    Specified by:
    
    getForegroundImageFile in interface PvDisplayIf
    
    Returns:
    relative file name of image.
    Since:
    
    JavaView 2.31
  - setForegroundImageFile
```
public void setForegroundImageFile(java.lang.String fileName)
```
    Load an image from file and set it as foreground image of display canvas. Method tries to load file immediately if showing of image is enabled.
    
    Specified by:
    
    setForegroundImageFile in interface PvDisplayIf
    
    Parameters:
    fileName - relative file name of image.
    Since:
    
    JavaView 2.31
  - mousePressed
```
public void mousePressed(java.awt.event.MouseEvent event)
```
    Do not react on popup events or other than left mouse clicks.
    
    Specified by:
    
    mousePressed in interface java.awt.event.MouseListener
  - mouseDragged
```
public void mouseDragged(java.awt.event.MouseEvent event)
```
    Specified by:
    
    mouseDragged in interface java.awt.event.MouseMotionListener
  - mouseReleased
```
public void mouseReleased(java.awt.event.MouseEvent event)
```
    Handle mouse key release events.
    
    Specified by:
    
    mouseReleased in interface java.awt.event.MouseListener
  - getPickEvent
```
public PvPickEvent getPickEvent(int x,
                       int y)
```
    Find intersection of ray through pick locus on visible geometries and background. The hit point with the nearest geometry of the set of tested geometries is returned. The type of tested geometries can be configured using the parameter pickType.
    The set of tested geometries is determined by the method getPickType().
    
    Parameters:
    x - x coordinate of mouse pick in pixel coordinates of display.
    y - y coordinate of mouse pick in pixel coordinates of display.
    
    Returns:
    Hit point on the nearest tested geometry is returned.
    See Also:
    getPickEvent(int, int, int), getPickType()
  - getPickEvent
```
public PvPickEvent getPickEvent(int x,
                       int y,
                       int pickType)
```
    Find intersection of ray through pick locus on visible geometries and background. The hit point with the nearest geometry of the set of tested geometries is returned. The type of tested geometries can be configured using the parameter pickType.
    The parameter pickType determines the set of tested geometries. The different types are given, for example, by: PvDisplay.PICK_SELECTED|PvDisplay.PICK_UNSELECTED.
    
    Parameters:
    x - x coordinate of mouse pick in pixel coordinates of display.
    y - y coordinate of mouse pick in pixel coordinates of display.
    pickType - Determines the set of tested geometries.
    
    Returns:
    Hit point on the nearest tested geometry is returned.
    See Also:
    getPickEvent(int, int)
  - mouseMoved
```
public void mouseMoved(java.awt.event.MouseEvent event)
```
    Updates mouse position and invokes temporary information like magnet and info.
    
    Specified by:
    
    mouseMoved in interface java.awt.event.MouseMotionListener
  - mouseEntered
```
public void mouseEntered(java.awt.event.MouseEvent event)
```
    This display requests the focus when the mouse enters the canvas unless request of focus is disabled by external calls. Disable the requestFocus since this would bring the display to front.
    
    Specified by:
    
    mouseEntered in interface java.awt.event.MouseListener
  - mouseExited
```
public void mouseExited(java.awt.event.MouseEvent event)
```
    Sets a flag that mouse is outside.
    
    Specified by:
    
    mouseExited in interface java.awt.event.MouseListener
  - mouseClicked
```
public void mouseClicked(java.awt.event.MouseEvent event)
```
    Shows popup menu if event is a popup trigger.
    
    Specified by:
    
    mouseClicked in interface java.awt.event.MouseListener
  - getMajorMode
```
public int getMajorMode()
```
    Get the current interaction mode. Modes may be changed either interactively using a keyboard shortcuts, or via the display panel or using via method. Modes are available in in jv.project.PvDisplayIf, for example, PvDisplayIf.MODE_SCALE
    
    Specified by:
    
    getMajorMode in interface PvDisplayIf
    
    Returns:
    aMode any of the modes available in PvDisplayIf.
    See Also:
    setMajorMode(int)
  - setMajorMode
```
public void setMajorMode(int mode)
```
    Switch between interaction modes like rotating or scaling, usually done interactively. Modes may be changed either interactively using a keyboard shortcuts, or via the display panel or using via method. Modes are available in in jv.project.PvDisplayIf, for example, PvDisplayIf.MODE_SCALE
    
    Specified by:
    
    setMajorMode in interface PvDisplayIf
    
    Parameters:
    mode - any of the modes available in PvDisplayIf.
    See Also:
    getMajorMode()
  - keyTyped
```
public void keyTyped(java.awt.event.KeyEvent event)
```
    Specified by:
    
    keyTyped in interface java.awt.event.KeyListener
  - keyReleased
```
public void keyReleased(java.awt.event.KeyEvent event)
```
    Specified by:
    
    keyReleased in interface java.awt.event.KeyListener
  - keyPressed
```
public void keyPressed(java.awt.event.KeyEvent event)
```
    Specified by:
    
    keyPressed in interface java.awt.event.KeyListener
  - configure
```
public void configure(PvDisplayIf disp)
```
    Configure an empty given display with all settings and geometries of this display. The only exception is the name of the argument display which is not changed during configuration if not empty before.
    
    Parameters:
    disp - target display which will be configured
    Since:
    
    JavaView 2.46
  - actionPerformed
```
public void actionPerformed(java.awt.event.ActionEvent event)
```
    Perform action events, currently used for popup menu events only.
    
    Specified by:
    
    actionPerformed in interface java.awt.event.ActionListener
  - clearPopupMenu
```
public void clearPopupMenu()
```
    Removes all added menu items from right-mouse popup menu, except some standard JavaView items such as "exit". Use addPopupItem(int) to fill popup menu with own selection of menu items.
    
    Specified by:
    
    clearPopupMenu in interface PvDisplayIf
    
    Since:
    
    JavaView 3.97.044
    
    See Also:
    addPopupItem(int)
  - addPopupItem
```
public void addPopupItem(int menuID)
```
    Add a menu item to the right-mouse popup menu. Menu items appear in the same order in which they where added.
    Possible menu items are all major modes of PvDisplay specified in PsViewerIf#MENU_DISPLAY_XXX plus MENU_FILE_NEW_DISPLAY, MENU_WINDOW_CONSOLE, MENU_INSPECTOR and MENU_SEPARATOR.
    
    Specified by:
    
    addPopupItem in interface PvDisplayIf
    
    Since:
    
    JavaView 3.97.044
    
    See Also:
    clearPopupMenu()
  - getInfoPanel
```
public PsPanel getInfoPanel()
```
    Get info panel of display. Display allocates panel if it does not exist.
    
    Specified by:
    
    getInfoPanel in interface PvDisplayIf
  - getCameraPanel
```
public PsPanel getCameraPanel()
```
    Get info panel of current camera. Camera allocates panel if it does not exist.
    
    Specified by:
    
    getCameraPanel in interface PvDisplayIf
  - getAxisPanel
```
public PsPanel getAxisPanel()
```
    Get info panel of axes object to control all rulers uniformly. If axis object is null then an axis object is created.
  - getAxisPanel
```
public PsPanel getAxisPanel(int ind)
```
    Get info panel of individual ruler.
    
    Parameters:
    ind - identifies requested ruler, for example, PsViewerIf.AXIS_X.
    Since:
    
    JavaView 3.62.011
  - getLightPanel
```
public PsPanel getLightPanel()
```
    Get info panel of lights.
    
    Specified by:
    
    getLightPanel in interface PvDisplayIf
  - getMinimumSize
```
public java.awt.Dimension getMinimumSize()
```
    Assure correct horizontal size of all project panels. TODO: locate preferred horizontal size in PsConfig. This method was necessary since especially PaParmSurface_IP tends to shrink.
    
    Overrides:
    
    getMinimumSize in class java.awt.Component
  - getPreferredSize
```
public java.awt.Dimension getPreferredSize()
```
    Assure correct horizontal size of all project panels. TODO: locate preferred horizontal size in PsConfig. This method was necessary since especially PaParmSurface_IP tends to shrink.
    
    Overrides:
    
    getPreferredSize in class java.awt.Component
  - start
```
public void start()
```
    Start animation by creating a new thread
    
    Specified by:
    
    start in interface PvDisplayIf
  - stop
```
public void stop()
```
    Stop animation by stopping the thread. Netscape does not like to suspend a thread.
    
    Specified by:
    
    stop in interface PvDisplayIf
  - setAutoRotation
```
public void setAutoRotation(PdVector axis,
                   double angle)
```
    Set axis and angle for auto-rotation.
    
    Specified by:
    
    setAutoRotation in interface PvDisplayIf
  - incrementAutoRotation
```
public boolean incrementAutoRotation()
```
    Do a single increment of auto-rotation animation. Method is invoked from PvViewer to generate GIF animations.
    
    Specified by:
    
    incrementAutoRotation in interface PvDisplayIf
  - run
```
public void run()
```
    Do the animation by incrementing the transformation matrix with the last action.
    
    Specified by:
    
    run in interface java.lang.Runnable
  - burn
```
public void burn()
```
    Burn the current status as texture on each surface.
  - selectLight
```
public boolean selectLight(PvLightIf light)
```
    Select light from the list of registered lights in this scene.
    
    Specified by:
    
    selectLight in interface PvDisplayIf
    
    Parameters:
    light - a registered light object
    
    Returns:
    true if light was found and successfully selected.
  - showAllViews
```
public void showAllViews(boolean flag)
```
    Enable and disable drawing of copyright information in the display window.
    
    Parameters:
    flag - enable or disable 4-camera-view
    Since:
    
    JavaView 2.46
  - selectCamera
```
public boolean selectCamera(int type)
```
    Select current camera used in dispay by id. If a requested system camera has not been instantiated yet, then it is created now. Type is among PvCameraIf#CAMERA_PERSPECTIVE, PvCameraIf#CAMERA_ORTHO_XY, PvCameraIf#CAMERA_ORTHO_XZ, PvCameraIf#CAMERA_ORTHO_YZ, For a list of possible types see PvDisplayIf.
    
    Specified by:
    
    selectCamera in interface PvDisplayIf
    
    Parameters:
    type - of camera
    
    Returns:
    false if type is outOfBounds.

Class PvDisplay

Nested Class Summary

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

Field Summary

Fields inherited from class java.awt.Component

Fields inherited from interface jv.project.PvDisplayIf

Fields inherited from interface java.awt.image.ImageObserver

Constructor Summary

Method Summary

Methods inherited from class java.awt.Canvas

Methods inherited from class java.awt.Component

Methods inherited from class java.lang.Object

Field Detail

RENDER_AWT

RENDER_PS

RENDER_GL

RENDER_LWJGL

m_renderType

m_defBackgroundImageFile

m_backgroundImageFile

m_defForegroundImageFile

m_foregroundImageFile

m_bInsecureKeyRelease

Constructor Detail

PvDisplay

PvDisplay

PvDisplay

Method Detail

init

reset

getName

setName

getSceneTitle

setSceneTitle

getCanvas

getFrame

setFrame

getViewer

setViewer

addKeyListener

removeKeyListener

addPickListener

hasPickListener

removePickListener

addGeometryListener

hasGeometryListener

removeGeometryListener

addCameraListener

hasCameraListener

removeCameraListener

requestPickFocus

releasePickFocus

addGeometry

removeGeometries

removeGeometry

selectGeometry

containsGeometry

getNumGeometries

getGeometries

getVisibleGeometries

getSelectedGeometry

center

saveCameraDefaults

fit

fit

getBackgroundColor

setBackgroundColor

getForegroundColor

setForegroundColor

isEnabledInspection

setEnabledInspection

isEnabledAnimation

setEnabledAnimation

getAmbientSpace

setAmbientSpace

getAmbientProjection

setAmbientProjection

isEnabledLocalTransform

setEnabledLocalTransform

getTransformationMode