Package org.jzy3d.plot3d.rendering.canvas

Class CanvasNewtAwt

java.lang.Object

java.awt.Component

java.awt.Container

java.awt.Panel

org.jzy3d.plot3d.rendering.canvas.CanvasNewtAwt

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable, Accessible, ICanvas, INativeCanvas, IScreenCanvas

public class CanvasNewtAwt
extends Panel
implements IScreenCanvas, INativeCanvas

A Newt canvas wrapped in an AWT Panel. Newt is supposed to be faster than any other canvas, either for AWT or Swing. If a non AWT panel where required, follow the guidelines given in IScreenCanvas documentation.

See Also:

Serialized Form

Nested Class Summary

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

Panel.AccessibleAWTPanel

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

Container.AccessibleAWTContainer

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

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

Field Summary

Fields

Modifier and Type	Field	Description
protected IAnimator	animator
protected com.jogamp.newt.awt.NewtCanvasAWT	canvas
protected List<ICanvasListener>	canvasListeners
protected ScheduledExecutorService	exec
protected Renderer3d	renderer
protected View	view
protected com.jogamp.newt.opengl.GLWindow	window

Fields inherited from class java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface org.jzy3d.plot3d.rendering.canvas.ICanvas

ALLOW_WATCH_PIXEL_SCALE, LAST_RENDER_TIME_UNDEFINED

Fields inherited from interface java.awt.image.ImageObserver

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

Constructor Summary

Constructors

Constructor	Description
CanvasNewtAwt(IChartFactory factory, Scene scene, Quality quality, com.jogamp.opengl.GLCapabilitiesImmutable glci)
CanvasNewtAwt(IChartFactory factory, Scene scene, Quality quality, com.jogamp.opengl.GLCapabilitiesImmutable glci, boolean traceGL, boolean debugGL)

Method Summary

Modifier and Type	Method	Description
void	addCanvasListener(ICanvasListener listener)
void	addKeyController(Object o)	A generic interface for mouse listener to remain Windowing toolkit independant.
void	addKeyListener(com.jogamp.newt.event.KeyListener l)
void	addMouseController(Object o)	A generic interface for mouse listener to remain Windowing toolkit independant.
void	addMouseListener(com.jogamp.newt.event.MouseListener l)
void	display()
void	dispose()	Performs all required cleanup when destroying a Canvas.
protected void	firePixelScaleChanged(double pixelScaleX, double pixelScaleY)
void	forceRepaint()	Invoked when a user requires the Canvas to be repainted (e.g. a non 3d layer has changed).
IAnimator	getAnimation()
com.jogamp.newt.awt.NewtCanvasAWT	getCanvas()
List<ICanvasListener>	getCanvasListeners()
String	getDebugInfo()
com.jogamp.opengl.GLAutoDrawable	getDrawable()	Returns the GLDrawable associated with the canvas
double	getLastRenderingTimeMs()
Coord2d	getPixelScale()	Pixel scale is used to model the pixel ratio thay may be introduced by HiDPI or Retina displays.
double	getPixelScaleX()
double	getPixelScaleY()
Renderer3d	getRenderer()
int	getRendererHeight()	Provide the actual renderer height for the open gl camera settings, which is obtained after a resize event.
int	getRendererWidth()	Provide the actual renderer width for the open gl camera settings, which is obtained after a resize event.
View	getView()	Provide a reference to the View that renders into this canvas.
com.jogamp.newt.opengl.GLWindow	getWindow()
void	removeCanvasListener(ICanvasListener listener)
void	removeKeyController(Object o)	A generic interface for key listener to remain Windowing toolkit independant. * Implementation of this method should simply cast the input assuming it will correspond to canvas-compatible key listener.
void	removeKeyListener(com.jogamp.newt.event.KeyListener l)
void	removeMouseController(Object o)	A generic interface for key listener to remain Windowing toolkit independant.
void	removeMouseListener(com.jogamp.newt.event.MouseListener l)
com.jogamp.opengl.util.texture.TextureData	screenshot()	Returns an image with the current renderer's size
void	screenshot(File file)
void	setPixelScale(float[] scale)	Defines pixel scale.
protected void	watchPixelScale()

Methods inherited from class java.awt.Panel

addNotify, getAccessibleContext

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getInsets, getLayout, getListeners, getMaximumSize, getMinimumSize, getMousePosition, getPreferredSize, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, isValidateRoot, layout, list, list, locate, minimumSize, paint, paintComponents, paramString, preferredSize, print, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, removeNotify, setComponentZOrder, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusDownCycle, update, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setEnabled, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setMixingCutoutShape, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Field Detail

view

protected View view

renderer

protected Renderer3d renderer

animator

protected IAnimator animator

window

protected com.jogamp.newt.opengl.GLWindow window

canvas

protected com.jogamp.newt.awt.NewtCanvasAWT canvas

canvasListeners

protected List<ICanvasListener> canvasListeners

exec

protected ScheduledExecutorService exec

Constructor Detail

CanvasNewtAwt

public CanvasNewtAwt(IChartFactory factory,
                     Scene scene,
                     Quality quality,
                     com.jogamp.opengl.GLCapabilitiesImmutable glci)

CanvasNewtAwt

public CanvasNewtAwt(IChartFactory factory,
                     Scene scene,
                     Quality quality,
                     com.jogamp.opengl.GLCapabilitiesImmutable glci,
                     boolean traceGL,
                     boolean debugGL)

Method Detail

watchPixelScale

protected void watchPixelScale()

getLastRenderingTimeMs

public double getLastRenderingTimeMs()

Specified by:

getLastRenderingTimeMs in interface ICanvas

getAnimation

public IAnimator getAnimation()

Specified by:

getAnimation in interface IScreenCanvas

setPixelScale

public void setPixelScale(float[] scale)

Description copied from interface: ICanvas

Defines pixel scale. On MacOS Retina displays, a X*Y chart uses a (X*2)*(Y*2) viewport. This makes some calculation based on viewport (such as Camera.screenToModel(IPainter, org.jzy3d.maths.Coord3d) output wrong result. When running on Retina display, those two options fixed buggy mouse selections on Retina:

• setPixelScale(new float[]{0.5f,0.5f})
• setPixelScale(new float[] { ScalableSurface.IDENTITY_PIXELSCALE, ScalableSurface.IDENTITY_PIXELSCALE })

Specified by:

setPixelScale in interface ICanvas

getPixelScale

public Coord2d getPixelScale()

Pixel scale is used to model the pixel ratio thay may be introduced by HiDPI or Retina displays.

Specified by:

getPixelScale in interface ICanvas

getPixelScaleX

public double getPixelScaleX()

getPixelScaleY

public double getPixelScaleY()

getWindow

public com.jogamp.newt.opengl.GLWindow getWindow()

getCanvas

public com.jogamp.newt.awt.NewtCanvasAWT getCanvas()

getDrawable

public com.jogamp.opengl.GLAutoDrawable getDrawable()

Description copied from interface: INativeCanvas

Returns the GLDrawable associated with the canvas

Specified by:

getDrawable in interface INativeCanvas

dispose

public void dispose()

Description copied from interface: ICanvas

Performs all required cleanup when destroying a Canvas.

Specified by:

dispose in interface ICanvas

display

public void display()

Specified by:

display in interface IScreenCanvas

forceRepaint

public void forceRepaint()

Description copied from interface: ICanvas

Invoked when a user requires the Canvas to be repainted (e.g. a non 3d layer has changed).

Specified by:

forceRepaint in interface ICanvas

screenshot

public com.jogamp.opengl.util.texture.TextureData screenshot()

Description copied from interface: INativeCanvas

Returns an image with the current renderer's size

Specified by:

screenshot in interface ICanvas

Specified by:

screenshot in interface INativeCanvas

screenshot

public void screenshot(File file)
                throws IOException

Specified by:

screenshot in interface ICanvas

Throws:

IOException

getDebugInfo

public String getDebugInfo()

Specified by:

getDebugInfo in interface ICanvas

getRendererWidth

public int getRendererWidth()

Provide the actual renderer width for the open gl camera settings, which is obtained after a resize event.

Specified by:

getRendererWidth in interface ICanvas

getRendererHeight

public int getRendererHeight()

Provide the actual renderer height for the open gl camera settings, which is obtained after a resize event.

Specified by:

getRendererHeight in interface ICanvas

getRenderer

public Renderer3d getRenderer()

Specified by:

getRenderer in interface INativeCanvas

getView

public View getView()

Provide a reference to the View that renders into this canvas.

Specified by:

getView in interface ICanvas

addKeyListener

public void addKeyListener(com.jogamp.newt.event.KeyListener l)

addMouseListener

public void addMouseListener(com.jogamp.newt.event.MouseListener l)

removeMouseListener

public void removeMouseListener(com.jogamp.newt.event.MouseListener l)

removeKeyListener

public void removeKeyListener(com.jogamp.newt.event.KeyListener l)

addMouseController

public void addMouseController(Object o)

Description copied from interface: ICanvas

A generic interface for mouse listener to remain Windowing toolkit independant. Implementation of this method should simply cast the input assuming it will correspond to canvas-compatible mouse listener.

Specified by:

addMouseController in interface ICanvas

addKeyController

public void addKeyController(Object o)

Description copied from interface: ICanvas

A generic interface for mouse listener to remain Windowing toolkit independant. Implementation of this method should simply cast the input assuming it will correspond to canvas-compatible mouse listener.

Specified by:

addKeyController in interface ICanvas

removeMouseController

public void removeMouseController(Object o)

Description copied from interface: ICanvas

A generic interface for key listener to remain Windowing toolkit independant. Implementation of this method should simply cast the input assuming it will correspond to canvas-compatible key listener.

Specified by:

removeMouseController in interface ICanvas

removeKeyController

public void removeKeyController(Object o)

Description copied from interface: ICanvas

A generic interface for key listener to remain Windowing toolkit independant. * Implementation of this method should simply cast the input assuming it will correspond to canvas-compatible key listener.

Specified by:

removeKeyController in interface ICanvas

addCanvasListener

public void addCanvasListener(ICanvasListener listener)

Specified by:

addCanvasListener in interface ICanvas

removeCanvasListener

public void removeCanvasListener(ICanvasListener listener)

Specified by:

removeCanvasListener in interface ICanvas

getCanvasListeners

public List<ICanvasListener> getCanvasListeners()

Specified by:

getCanvasListeners in interface ICanvas

firePixelScaleChanged

protected void firePixelScaleChanged(double pixelScaleX,
                                     double pixelScaleY)