/**
* Copyright (C) 1998-2000 by University of Maryland, College Park, MD 20742, USA
* All rights reserved.
*/
package edu.umd.cs.piccolox.pswing;
import java.awt.BasicStroke;
import java.awt.Color;
import java.awt.Component;
import java.awt.Container;
import java.awt.Dimension;
import java.awt.Font;
import java.awt.Graphics2D;
import java.awt.RenderingHints;
import java.awt.Shape;
import java.awt.Stroke;
import java.awt.geom.AffineTransform;
import java.awt.geom.Rectangle2D;
import java.awt.image.BufferedImage;
import java.beans.PropertyChangeEvent;
import java.beans.PropertyChangeListener;
import java.io.IOException;
import java.io.ObjectInputStream;
import java.io.Serializable;
import javax.swing.JComponent;
import javax.swing.RepaintManager;
import edu.umd.cs.piccolo.PNode;
import edu.umd.cs.piccolo.util.PBounds;
import edu.umd.cs.piccolo.util.PPaintContext;
/*
This message was sent to Sun on August 27, 1999
-----------------------------------------------
We are currently developing Piccolo, a "scenegraph" for use in 2D graphics.
One of our ultimate goals is to support Swing lightweight components
within Piccolo, whose graphical space supports arbitray affine transforms.
The challenge in this pursuit is getting the components to respond and
render properly though not actually displayed in a standard Java component
hierarchy.
The first issues involved making the Swing components focusable and
showing. This was accomplished by adding the Swing components to a 0x0
JComponent which was in turn added to our main Piccolo application component.
To our good fortune, a Java component is showing merely if it and its
ancestors are showing and not based on whether it is ACTUALLY visible.
Likewise, focus in a JComponent depends merely on the component's
containing window having focus.
The second issue involved capturing the repaint calls on a Swing
component. Normally, for a repaint and the consequent call to
paintImmediately, a Swing component obtains the Graphics object necessary
to render itself through the Java component heirarchy. However, for Piccolo
we would like the component to render using a Graphics object that Piccolo
may have arbitrarily transformed in some way. By capturing in the
RepaintManager the repaint calls made on our special Swing components, we
are able to redirect the repaint requests through the Piccolo architecture to
put the Graphics in its proper context. Unfortunately, this means that
if the Swing component contains other Swing components, then any repaint
requests made by one of these nested components must go through
the Piccolo architecture then through the top level Swing component
down to the nested Swing component. This normally doesn't cause a
problem. However, if calling paint on one of these nested
children causes a call to repaint then an infinite loop ensues. This does
in fact happen in the Swing components that use cell renderers. Before
the cell renderer is painted, it is invalidated and consequently
repainted. We solved this problem by putting a lock on repaint calls for
a component while that component is painting. (A similar problem faced
the Swing team over this same issue. They solved it by inserting a
CellRendererPane to capture the renderer's invalidate calls.)
Another issue arose over the forwarding of mouse events to the Swing
components. Since our Swing components are not actually displayed on
screen in the standard manner, we must manually dispatch any MouseEvents
we want the component to receive. Hence, we needed to find the deepest
visible component at a particular location that accepts MouseEvents.
Finding the deepest visible component at a point was achieved with the
"findComponentAt" method in java.awt.Container. With the
"getListeners(Class listenerType)" method added in JDK1.3 Beta we are able
to determine if the component has any Mouse Listeners. However, we haven't
yet found a way to determine if MouseEvents have been specifically enabled
for a component. The package private method "eventEnabled" in
java.awt.Component does exactly what we want but is, of course,
inaccessible. In order to dispatch events correctly we would need a
public accessor to the method "boolean eventEnabled(AWTEvent)" in
java.awt.Component.
Still another issue involves the management of cursors when the mouse is
over a Swing component in our application. To the Java mechanisms, the
mouse never appears to enter the bounds of the Swing components since they
are contained by a 0x0 JComponent. Hence, we must manually change the
cursor when the mouse enters one of the Swing components in our
application. This generally works but becomes a problem if the Swing
component's cursor changes while we are over that Swing component (for
instance, if you resize a Table Column). In order to manage cursors
properly, we would need setCursor to fire property change events.
With the above fixes, most Swing components work. The only Swing
components that are definitely broken are ToolTips and those that rely on
JPopupMenu. In order to implement ToolTips properly, we would need to have
a method in ToolTipManager that allows us to set the current manager, as
is possible with RepaintManager. In order to implement JPopupMenu, we
will likely need to reimplement JPopupMenu to function in Piccolo with
a transformed Graphics and to insert itself in the proper place in the
Piccolo scenegraph.
*/
/**
* <b>PSwing</b> is used to add Swing Components to a Piccolo canvas.
* <p/>
* Example: adding a swing JButton to a PCanvas:
* <pre>
* PSwingCanvas canvas = new PSwingCanvas();
* JButton button = new JButton("Button");
* swing = new PSwing(canvas, button);
* canvas.getLayer().addChild(swing);
* <pre>
* <p/>
* NOTE: PSwing has the current limitation that it does not listen for
* Container events. This is only an issue if you create a PSwing
* and later add Swing components to the PSwing's component hierarchy
* that do not have double buffering turned off or have a smaller font
* size than the minimum font size of the original PSwing's component
* hierarchy.
* <p/>
* For instance, the following bit of code will give unexpected
* results:
* <pre>
* JPanel panel = new JPanel();
* PSwing swing = new PSwing(panel);
* JPanel newChild = new JPanel();
* newChild.setDoubleBuffered(true);
* panel.add(newChild);
* </pre>
* <p/>
* NOTE: PSwing cannot be correctly interacted with through multiple cameras.
* There is no support for it yet.
* <p/>
* NOTE: PSwing is java.io.Serializable.
* <p/>
* <b>Warning:</b> Serialized objects of this class will not be
* compatible with future Piccolo releases. The current serialization support is
* appropriate for short term storage or RMI between applications running the
* same version of Piccolo. A future release of Piccolo will provide support for long
* term persistence.
*
* @author Sam R. Reid
* @author Benjamin B. Bederson
* @author Lance E. Good
*/
public class PSwing extends PNode implements Serializable, PropertyChangeListener {
/**
* Used as a hashtable key for this object in the Swing component's
* client properties.
*/
public static final String PSWING_PROPERTY = "PSwing";
private static final AffineTransform IDENTITY_TRANSFORM = new AffineTransform();
private static PBounds TEMP_REPAINT_BOUNDS2 = new PBounds();
private static boolean highQualityRender = false;
/**
* The cutoff at which the Swing component is rendered greek
*/
private double renderCutoff = 0.3;
private JComponent component = null;
private double minFontSize = Double.MAX_VALUE;
private Stroke defaultStroke = new BasicStroke();
private Font defaultFont = new Font( "Serif", Font.PLAIN, 12 );
private BufferedImage buffer;
private PSwingCanvas pSwingCanvas;
/**
* Constructs a new visual component wrapper for the Swing component
* and adds the Swing component to the SwingWrapper component of
* the PCanvas
*
* @param canvas The PSwingCanvas to which the Swing component will
* be added
* @param component The swing component to be wrapped
*/
public PSwing( PSwingCanvas canvas, JComponent component ) {
this.pSwingCanvas = canvas;
this.component = component;
component.putClientProperty( PSWING_PROPERTY, this );
init( component );
this.pSwingCanvas.getSwingWrapper().add( component );
component.revalidate();
reshape();
}
/**
* Ensures the bounds of the underlying component are accurate, and sets the bounds of this PNode.
*/
void reshape() {
component.setBounds( 0, 0, component.getPreferredSize().width, component.getPreferredSize().height );
setBounds( 0, 0, component.getPreferredSize().width, component.getPreferredSize().height );
}
/**
* Determines if the Swing component should be rendered normally or
* as a filled rectangle.
* <p/>
* The transform, clip, and composite will be set appropriately when this object
* is rendered. It is up to this object to restore the transform, clip, and composite of
* the Graphics2D if this node changes any of them. However, the color, font, and stroke are
* unspecified by Piccolo. This object should set those things if they are used, but
* they do not need to be restored.
*
* @param renderContext Contains information about current render.
*/
public void paint( PPaintContext renderContext ) {
Graphics2D g2 = renderContext.getGraphics();
if( defaultStroke == null ) {
defaultStroke = new BasicStroke();
}
g2.setStroke( defaultStroke );
if( defaultFont == null ) {
defaultFont = new Font( "Serif", Font.PLAIN, 12 );
}
g2.setFont( defaultFont );
if( component.getParent() == null ) {
pSwingCanvas.getSwingWrapper().add( component );
component.revalidate();
}
if( shouldRenderGreek( renderContext ) ) {
paintAsGreek( g2 );
}
else {
paint( g2 );
}
}
protected boolean shouldRenderGreek( PPaintContext renderContext ) {
return ( renderContext.getScale() < renderCutoff && pSwingCanvas.getInteracting() ) ||
minFontSize * renderContext.getScale() < 0.5;
}
/**
* Paints the Swing component as greek.
*
* @param g2 The graphics used to render the filled rectangle
*/
public void paintAsGreek( Graphics2D g2 ) {
Color background = component.getBackground();
Color foreground = component.getForeground();
Rectangle2D rect = getBounds();
if( background != null ) {
g2.setColor( background );
}
g2.fill( rect );
if( foreground != null ) {
g2.setColor( foreground );
}
g2.draw( rect );
}
/**
* Renders to a buffered image, then draws that to the screen.
*
* @param g2 The graphics on which to render the JComponent.
*/
public void paint( Graphics2D g2 ) {
if( component.getBounds().isEmpty() ) {
// The component has not been initialized yet.
return;
}
PSwingRepaintManager manager = (PSwingRepaintManager)RepaintManager.currentManager( component );
manager.lockRepaint( component );
if( buffer == null || buffer.getWidth() != component.getWidth() || buffer.getHeight() != component.getHeight() )
{
buffer = new BufferedImage( component.getWidth(), component.getHeight(), BufferedImage.TYPE_INT_ARGB );
}
else {
Graphics2D bufferedGraphics = buffer.createGraphics();
bufferedGraphics.setBackground( Color.black );
bufferedGraphics.clipRect( 0, 0, component.getWidth(), component.getHeight() );
}
Graphics2D bufferedGraphics = buffer.createGraphics();
//optionally prepare buffered graphics for better rendering.
if( highQualityRender ) {
bufferedGraphics.setRenderingHint( RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON );
bufferedGraphics.setRenderingHint( RenderingHints.KEY_INTERPOLATION, RenderingHints.VALUE_INTERPOLATION_BICUBIC );
}
component.paint( bufferedGraphics );
Object origHint = g2.getRenderingHint( RenderingHints.KEY_INTERPOLATION );
g2.setRenderingHint( RenderingHints.KEY_INTERPOLATION, RenderingHints.VALUE_INTERPOLATION_BICUBIC );
g2.drawRenderedImage( buffer, IDENTITY_TRANSFORM );
if( origHint != null ) {
g2.setRenderingHint( RenderingHints.KEY_INTERPOLATION, origHint );
}
else {
g2.setRenderingHint( RenderingHints.KEY_INTERPOLATION, RenderingHints.VALUE_INTERPOLATION_NEAREST_NEIGHBOR );
}
manager.unlockRepaint( component );
}
/**
* Repaints the specified portion of this visual component
* Note that the input parameter may be modified as a result of this call.
*
* @param repaintBounds
*/
public void repaint( PBounds repaintBounds ) {
Shape sh = getTransform().createTransformedShape( repaintBounds );
TEMP_REPAINT_BOUNDS2.setRect( sh.getBounds2D() );
repaintFrom( TEMP_REPAINT_BOUNDS2, this );
}
/**
* Sets the Swing component's bounds to its preferred bounds
* unless it already is set to its preferred size. Also
* updates the visual components copy of these bounds
*/
public void computeBounds() {
if( !component.getBounds().isEmpty() ) {
Dimension d = component.getPreferredSize();
getBoundsReference().setRect( 0, 0, d.getWidth(), d.getHeight() );
if( !component.getSize().equals( d ) ) {
component.setBounds( 0, 0, (int)d.getWidth(), (int)d.getHeight() );
}
}
}
/**
* Returns the Swing component that this visual component wraps
*
* @return The Swing component that this visual component wraps
*/
public JComponent getComponent() {
return component;
}
/**
* We need to turn off double buffering of Swing components within
* Piccolo since all components contained within a native container
* use the same buffer for double buffering. With normal Swing
* widgets this is fine, but for Swing components within Piccolo this
* causes problems. This function recurses the component tree
* rooted at c, and turns off any double buffering in use. It also
* updates the minimum font size based on the font size of c and adds
* a property change listener to listen for changes to the font.
*
* @param c The Component to be recursively unDoubleBuffered
*/
void init( Component c ) {
Component[] children = null;
if( c instanceof Container ) {
children = ( (Container)c ).getComponents();
}
if( c.getFont() != null ) {
minFontSize = Math.min( minFontSize, c.getFont().getSize() );
}
if( children != null ) {
for( int j = 0; j < children.length; j++ ) {
init( children[j] );
}
}
if( c instanceof JComponent ) {
( (JComponent)c ).setDoubleBuffered( false );
c.addPropertyChangeListener( "font", this );
}
}
/**
* Listens for changes in font on components rooted at this PSwing
*/
public void propertyChange( PropertyChangeEvent evt ) {
if( component.isAncestorOf( (Component)evt.getSource() ) &&
( (Component)evt.getSource() ).getFont() != null ) {
minFontSize = Math.min( minFontSize, ( (Component)evt.getSource() ).getFont().getSize() );
}
}
private void readObject( ObjectInputStream in ) throws IOException, ClassNotFoundException {
in.defaultReadObject();
init( component );
}
/**
* Set high quality buffer rendering.
*
* @param highQuality
*/
public static void setHighQualityRender( boolean highQuality ) {
highQualityRender = highQuality;
}
}
