de.javagl.viewer

Class SimpleObjectPainter<T>

java.lang.Object

de.javagl.viewer.SimpleObjectPainter<T>

Type Parameters:

T - The type of the painted object

All Implemented Interfaces:

Painter

public final class SimpleObjectPainter<T>
extends java.lang.Object
implements Painter

Implementation of a Painter that allows setting an object that should be painted with a delegate ObjectPainter

Constructor Summary

Constructors

Constructor and Description
SimpleObjectPainter(ObjectPainter<? super T> objectPainter) Creates a new simple object painter using the given delegate

Method Summary

Modifier and Type	Method and Description
T	getObject() Returns the object that should be painted.
void	paint(java.awt.Graphics2D g, java.awt.geom.AffineTransform worldToScreen, double w, double h) Perform the painting operations on the given Graphics.
void	setObject(T object) Set the object that should be painted.

Methods inherited from class java.lang.Object

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

Constructor Detail

SimpleObjectPainter

public SimpleObjectPainter(ObjectPainter<? super T> objectPainter)

Creates a new simple object painter using the given delegate

Parameters:

objectPainter - The delegate ObjectPainter

Method Detail

setObject

public void setObject(T object)

Set the object that should be painted. This object may be null, usually to indicate that nothing should be painted.

Parameters:

object - The object

getObject

public T getObject()

Returns the object that should be painted. This object may be null.

Returns:

The object that should be painted.

paint

public void paint(java.awt.Graphics2D g,
                  java.awt.geom.AffineTransform worldToScreen,
                  double w,
                  double h)

Description copied from interface: Painter

Perform the painting operations on the given Graphics.

Note that the same Graphics instance will be passed to all painters. No painter should make any assumptions about the state of the Graphics object. Changes in the given Graphics object will affect painters that are called subsequently. This refers to configuration settings, like the rendering hints, but also to the transform of the Graphics.

Settings like the rendering hints will usually be done globally by the Viewer. If a painter modifies these settings, then it should either restore the original settings afterwards, or create a local copy of the Graphics object in order to avoid interferences with other painters.

If the painter needs to transform the Graphics, then it should either use a local copy of the graphics object, or restore the original transform after it finished painting:

 public void paint(
     Graphics2D g, AffineTransform worldToScreen, double w, double h)
 {
     // Store the original transform
     AffineTransform oldAT = g.getTransform();
     
     // Perform custom transforms and painting
     g.translate(100,100);
     g.drawLine(10,20,30,40);
     ...
     
     // Restore the original transform
     g.setTransform(oldAT);
 }
 

The AffineTransform that is passed to this method may also be the same for multiple painters. Usually, the caller should make sure that modifications of this transform do not affect painters that are called subsequently, but in general, it is not recommended to internally store or modify the given affine transform object.

Specified by:

paint in interface Painter

Parameters:

g - The Graphics used for painting

worldToScreen - The world-to-screen transform. This transform encapsulates the translation, rotation and scaling of the viewer to which this painter belongs.

w - The width of the area, in screen coordinates, in which this painter operates. This is the screen size of the viewer to which this painter belongs.

h - The height of the area, in screen coordinates, in which this painter operates. This is the screen size of the viewer to which this painter belongs.