/*

   Licensed to the Apache Software Foundation (ASF) under one or more
   contributor license agreements.  See the NOTICE file distributed with
   this work for additional information regarding copyright ownership.
   The ASF licenses this file to You under the Apache License, Version 2.0
   (the "License"); you may not use this file except in compliance with
   the License.  You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.

 */
package org.apache.batik.gvt;

import java.awt.Graphics2D;
import java.awt.Shape;
import java.awt.geom.Point2D;
import java.awt.geom.Rectangle2D;

import org.apache.batik.util.HaltingThread;

A graphics node that represents a shape.
Author:Thierry Kormann
Version:$Id: ShapeNode.java 1733416 2016-03-03 07:07:13Z gadams $
/** * A graphics node that represents a shape. * * @author <a href="mailto:Thierry.Kormann@sophia.inria.fr">Thierry Kormann</a> * @version $Id: ShapeNode.java 1733416 2016-03-03 07:07:13Z gadams $ */
public class ShapeNode extends AbstractGraphicsNode {
The shape that describes this ShapeNode.
/** * The shape that describes this <code>ShapeNode</code>. */
protected Shape shape;
The shape painter used to paint the shape of this shape node.
/** * The shape painter used to paint the shape of this shape node. */
protected ShapePainter shapePainter;
Internal Cache: Primitive bounds
/** * Internal Cache: Primitive bounds */
private Rectangle2D primitiveBounds;
Internal Cache: Geometry bounds
/** * Internal Cache: Geometry bounds */
private Rectangle2D geometryBounds;
Internal Cache: Sensitive bounds
/** * Internal Cache: Sensitive bounds */
private Rectangle2D sensitiveBounds;
Internal Cache: The painted area.
/** * Internal Cache: The painted area. */
private Shape paintedArea;
Internal Cache: The sensitive area.
/** * Internal Cache: The sensitive area. */
private Shape sensitiveArea;
Constructs a new empty ShapeNode.
/** * Constructs a new empty <code>ShapeNode</code>. */
public ShapeNode() {} // // Properties methods //
Sets the shape of this ShapeNode.
Params:
  • newShape – the new shape of this shape node
/** * Sets the shape of this <code>ShapeNode</code>. * * @param newShape the new shape of this shape node */
public void setShape(Shape newShape) { fireGraphicsNodeChangeStarted(); invalidateGeometryCache(); this.shape = newShape; if(this.shapePainter != null){ if (newShape != null) { this.shapePainter.setShape(newShape); } else { this.shapePainter = null; } } fireGraphicsNodeChangeCompleted(); }
Returns the shape of this ShapeNode.
/** * Returns the shape of this <code>ShapeNode</code>. */
public Shape getShape() { return shape; }
Sets the ShapePainter used by this shape node to render its shape.
Params:
  • newShapePainter – the new ShapePainter to use
/** * Sets the <code>ShapePainter</code> used by this shape node to render its * shape. * * @param newShapePainter the new ShapePainter to use */
public void setShapePainter(ShapePainter newShapePainter) { if (shape == null) // Doesn't matter if we don't have a shape. return; fireGraphicsNodeChangeStarted(); invalidateGeometryCache(); this.shapePainter = newShapePainter; if(shapePainter != null && shape != this.shapePainter.getShape()){ shapePainter.setShape(shape); } fireGraphicsNodeChangeCompleted(); }
Returns the ShapePainter used by this shape node to render its shape.
/** * Returns the <code>ShapePainter</code> used by this shape node to render its * shape. */
public ShapePainter getShapePainter() { return shapePainter; } // // Drawing methods //
Paints this node.
Params:
  • g2d – the Graphics2D to use
/** * Paints this node. * * @param g2d the Graphics2D to use */
public void paint(Graphics2D g2d) { if (isVisible) super.paint(g2d); }
Paints this node without applying Filter, Mask, Composite, and clip.
Params:
  • g2d – the Graphics2D to use
/** * Paints this node without applying Filter, Mask, Composite, and clip. * * @param g2d the Graphics2D to use */
public void primitivePaint(Graphics2D g2d) { if (shapePainter != null) { shapePainter.paint(g2d); } } // // Geometric methods //
Invalidates this ShapeNode. This node and all its ancestors have been informed that all its cached values related to its bounds must be recomputed.
/** * Invalidates this <code>ShapeNode</code>. This node and all its ancestors have * been informed that all its cached values related to its bounds must be * recomputed. */
protected void invalidateGeometryCache() { super.invalidateGeometryCache(); primitiveBounds = null; geometryBounds = null; sensitiveBounds = null; paintedArea = null; sensitiveArea = null; } public void setPointerEventType(int pointerEventType) { super.setPointerEventType(pointerEventType); sensitiveBounds = null; sensitiveArea = null; }
Returns true if the specified Point2D is inside the boundary of this node, false otherwise.
Params:
  • p – the specified Point2D in the user space
/** * Returns true if the specified Point2D is inside the boundary of this * node, false otherwise. * * @param p the specified Point2D in the user space */
public boolean contains(Point2D p) { switch(pointerEventType) { case VISIBLE_PAINTED: case VISIBLE_FILL: case VISIBLE_STROKE: case VISIBLE: if (!isVisible) return false; // Fall Through case PAINTED: case FILL: case STROKE: case ALL: { Rectangle2D b = getSensitiveBounds(); if (b == null || !b.contains(p)) return false; return inSensitiveArea(p); } case NONE: default: return false; } }
Returns true if the interior of this node intersects the interior of a specified Rectangle2D, false otherwise.
Params:
  • r – the specified Rectangle2D in the user node space
/** * Returns true if the interior of this node intersects the interior of a * specified Rectangle2D, false otherwise. * * @param r the specified Rectangle2D in the user node space */
public boolean intersects(Rectangle2D r) { Rectangle2D b = getBounds(); if (b != null) { return (b.intersects(r) && paintedArea != null && paintedArea.intersects(r)); } return false; }
Returns the bounds of the area covered by this node's primitive paint.
/** * Returns the bounds of the area covered by this node's primitive paint. */
public Rectangle2D getPrimitiveBounds() { if (!isVisible) return null; if (shape == null) return null; if (primitiveBounds != null) return primitiveBounds; if (shapePainter == null) primitiveBounds = shape.getBounds2D(); else primitiveBounds = shapePainter.getPaintedBounds2D(); // Check If we should halt early. if (HaltingThread.hasBeenHalted()) { // The Thread has been halted. // Invalidate any cached values and proceed (this // sets primitiveBounds to null). invalidateGeometryCache(); } return primitiveBounds; } public boolean inSensitiveArea(Point2D pt) { if (shapePainter == null) return false; // <!> NOT REALLY NICE CODE BUT NO OTHER WAY ShapePainter strokeShapePainter = null; ShapePainter fillShapePainter = null; if (shapePainter instanceof StrokeShapePainter) { strokeShapePainter = shapePainter; } else if (shapePainter instanceof FillShapePainter) { fillShapePainter = shapePainter; } else if (shapePainter instanceof CompositeShapePainter) { CompositeShapePainter cp = (CompositeShapePainter)shapePainter; for (int i=0; i < cp.getShapePainterCount(); ++i) { ShapePainter sp = cp.getShapePainter(i); if (sp instanceof StrokeShapePainter) { strokeShapePainter = sp; } else if (sp instanceof FillShapePainter) { fillShapePainter = sp; } } } else { return false; // Don't know what we have... } switch(pointerEventType) { case VISIBLE_PAINTED: case PAINTED: return shapePainter.inPaintedArea(pt); case VISIBLE: case ALL: return shapePainter.inSensitiveArea(pt); case VISIBLE_FILL: case FILL: if (fillShapePainter != null) return fillShapePainter.inSensitiveArea(pt); break; case VISIBLE_STROKE: case STROKE: if (strokeShapePainter != null) return strokeShapePainter.inSensitiveArea(pt); break; case NONE: default: // nothing to tdo } return false; }
Returns the bounds of the sensitive area covered by this node, This includes the stroked area but does not include the effects of clipping, masking or filtering.
/** * Returns the bounds of the sensitive area covered by this node, * This includes the stroked area but does not include the effects * of clipping, masking or filtering. */
public Rectangle2D getSensitiveBounds() { if (sensitiveBounds != null) return sensitiveBounds; if (shapePainter == null) return null; // <!> NOT REALLY NICE CODE BUT NO OTHER WAY ShapePainter strokeShapePainter = null; ShapePainter fillShapePainter = null; if (shapePainter instanceof StrokeShapePainter) { strokeShapePainter = shapePainter; } else if (shapePainter instanceof FillShapePainter) { fillShapePainter = shapePainter; } else if (shapePainter instanceof CompositeShapePainter) { CompositeShapePainter cp = (CompositeShapePainter)shapePainter; for (int i=0; i < cp.getShapePainterCount(); ++i) { ShapePainter sp = cp.getShapePainter(i); if (sp instanceof StrokeShapePainter) { strokeShapePainter = sp; } else if (sp instanceof FillShapePainter) { fillShapePainter = sp; } } } else return null; // Don't know what we have... switch(pointerEventType) { case VISIBLE_PAINTED: case PAINTED: sensitiveBounds = shapePainter.getPaintedBounds2D(); break; case VISIBLE_FILL: case FILL: if (fillShapePainter != null) { sensitiveBounds = fillShapePainter.getSensitiveBounds2D(); } break; case VISIBLE_STROKE: case STROKE: if (strokeShapePainter != null) { sensitiveBounds = strokeShapePainter.getSensitiveBounds2D(); } break; case VISIBLE: case ALL: sensitiveBounds = shapePainter.getSensitiveBounds2D(); break; case NONE: default: // nothing to tdo } return sensitiveBounds; }
Returns the shape that represents the sensitive area of this graphics node.
/** * Returns the shape that represents the sensitive area of this graphics * node. */
public Shape getSensitiveArea() { if (sensitiveArea != null) return sensitiveArea; if (shapePainter == null) return null; // <!> NOT REALLY NICE CODE BUT NO OTHER WAY ShapePainter strokeShapePainter = null; ShapePainter fillShapePainter = null; if (shapePainter instanceof StrokeShapePainter) { strokeShapePainter = shapePainter; } else if (shapePainter instanceof FillShapePainter) { fillShapePainter = shapePainter; } else if (shapePainter instanceof CompositeShapePainter) { CompositeShapePainter cp = (CompositeShapePainter)shapePainter; for (int i=0; i < cp.getShapePainterCount(); ++i) { ShapePainter sp = cp.getShapePainter(i); if (sp instanceof StrokeShapePainter) { strokeShapePainter = sp; } else if (sp instanceof FillShapePainter) { fillShapePainter = sp; } } } else return null; // Don't know what we have... switch(pointerEventType) { case VISIBLE_PAINTED: case PAINTED: sensitiveArea = shapePainter.getPaintedArea(); break; case VISIBLE_FILL: case FILL: if (fillShapePainter != null) { sensitiveArea = fillShapePainter.getSensitiveArea(); } break; case VISIBLE_STROKE: case STROKE: if (strokeShapePainter != null) { sensitiveArea = strokeShapePainter.getSensitiveArea(); } break; case VISIBLE: case ALL: sensitiveArea = shapePainter.getSensitiveArea(); break; case NONE: default: // nothing to tdo } return sensitiveArea; }
Returns the bounds of the area covered by this node, without taking any of its rendering attribute into account. That is, exclusive of any clipping, masking, filtering or stroking, for example.
/** * Returns the bounds of the area covered by this node, without * taking any of its rendering attribute into account. That is, * exclusive of any clipping, masking, filtering or stroking, for * example. */
public Rectangle2D getGeometryBounds(){ if (geometryBounds == null) { if (shape == null) { return null; } geometryBounds = normalizeRectangle(shape.getBounds2D()); } return geometryBounds; }
Returns the outline of this node.
/** * Returns the outline of this node. */
public Shape getOutline() { return shape; } }