/*
* Copyright (c) 2010, 2016, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
*
* This code is free software; you can redistribute it and/or modify it
* under the terms of the GNU General Public License version 2 only, as
* published by the Free Software Foundation. Oracle designates this
* particular file as subject to the "Classpath" exception as provided
* by Oracle in the LICENSE file that accompanied this code.
*
* This code is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
* version 2 for more details (a copy is included in the LICENSE file that
* accompanied this code).
*
* You should have received a copy of the GNU General Public License version
* 2 along with this work; if not, write to the Free Software Foundation,
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
*
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
* or visit www.oracle.com if you need additional information or have any
* questions.
*/
package javafx.scene.shape;
import com.sun.javafx.geom.BaseBounds;
import com.sun.javafx.geom.Ellipse2D;
import com.sun.javafx.geom.transform.BaseTransform;
import com.sun.javafx.scene.DirtyBits;
import com.sun.javafx.scene.NodeHelper;
import com.sun.javafx.scene.shape.EllipseHelper;
import com.sun.javafx.scene.shape.ShapeHelper;
import com.sun.javafx.sg.prism.NGEllipse;
import com.sun.javafx.sg.prism.NGNode;
import com.sun.javafx.sg.prism.NGShape;
import javafx.beans.property.DoubleProperty;
import javafx.beans.property.DoublePropertyBase;
import javafx.scene.Node;
import javafx.scene.paint.Paint;
The Ellipse
class creates a new ellipse with the specified size and location in pixels import javafx.scene.shape.*;
Ellipse ellipse = new Ellipse(); {
ellipse.setCenterX(50.0f);
ellipse.setCenterY(50.0f);
ellipse.setRadiusX(50.0f);
ellipse.setRadiusY(25.0f);
Since: JavaFX 2.0
/**
* The {@code Ellipse} class creates a new ellipse
* with the specified size and location in pixels
*
<PRE>
import javafx.scene.shape.*;
Ellipse ellipse = new Ellipse(); {
ellipse.setCenterX(50.0f);
ellipse.setCenterY(50.0f);
ellipse.setRadiusX(50.0f);
ellipse.setRadiusY(25.0f);
</PRE>
* @since JavaFX 2.0
*/
public class Ellipse extends Shape {
static {
EllipseHelper.setEllipseAccessor(new EllipseHelper.EllipseAccessor() {
@Override
public NGNode doCreatePeer(Node node) {
return ((Ellipse) node).doCreatePeer();
}
@Override
public void doUpdatePeer(Node node) {
((Ellipse) node).doUpdatePeer();
}
@Override
public BaseBounds doComputeGeomBounds(Node node,
BaseBounds bounds, BaseTransform tx) {
return ((Ellipse) node).doComputeGeomBounds(bounds, tx);
}
@Override
public com.sun.javafx.geom.Shape doConfigShape(Shape shape) {
return ((Ellipse) shape).doConfigShape();
}
});
}
private final Ellipse2D shape = new Ellipse2D();
private static final int NON_RECTILINEAR_TYPE_MASK = ~(
BaseTransform.TYPE_TRANSLATION |
BaseTransform.TYPE_QUADRANT_ROTATION |
BaseTransform.TYPE_MASK_SCALE |
BaseTransform.TYPE_FLIP);
{
// To initialize the class helper at the begining each constructor of this class
EllipseHelper.initHelper(this);
}
Creates an empty instance of Ellipse.
/**
* Creates an empty instance of Ellipse.
*/
public Ellipse() {
}
Creates an instance of Ellipse of the given size.
Params: - radiusX – the horizontal radius of the ellipse in pixels
- radiusY – the vertical radius of the ellipse in pixels
/**
* Creates an instance of Ellipse of the given size.
* @param radiusX the horizontal radius of the ellipse in pixels
* @param radiusY the vertical radius of the ellipse in pixels
*/
public Ellipse(double radiusX, double radiusY) {
setRadiusX(radiusX);
setRadiusY(radiusY);
}
Creates an instance of Ellipse of the given position and size.
Params: - centerX – the horizontal position of the center of the ellipse in pixels
- centerY – the vertical position of the center of the ellipse in pixels
- radiusX – the horizontal radius of the ellipse in pixels
- radiusY – the vertical radius of the ellipse in pixels
/**
* Creates an instance of Ellipse of the given position and size.
* @param centerX the horizontal position of the center of the ellipse in pixels
* @param centerY the vertical position of the center of the ellipse in pixels
* @param radiusX the horizontal radius of the ellipse in pixels
* @param radiusY the vertical radius of the ellipse in pixels
*/
public Ellipse(double centerX, double centerY, double radiusX, double radiusY) {
this(radiusX, radiusY);
setCenterX(centerX);
setCenterY(centerY);
}
Defines the horizontal position of the center of the ellipse in pixels.
@defaultValue 0.0
/**
* Defines the horizontal position of the center of the ellipse in pixels.
*
* @defaultValue 0.0
*/
private DoubleProperty centerX;
public final void setCenterX(double value) {
if (centerX != null || value != 0.0) {
centerXProperty().set(value);
}
}
public final double getCenterX() {
return centerX == null ? 0.0 : centerX.get();
}
public final DoubleProperty centerXProperty() {
if (centerX == null) {
centerX = new DoublePropertyBase() {
@Override
public void invalidated() {
NodeHelper.markDirty(Ellipse.this, DirtyBits.NODE_GEOMETRY);
NodeHelper.geomChanged(Ellipse.this);
}
@Override
public Object getBean() {
return Ellipse.this;
}
@Override
public String getName() {
return "centerX";
}
};
}
return centerX;
}
Defines the vertical position of the center of the ellipse in pixels.
@defaultValue 0.0
/**
* Defines the vertical position of the center of the ellipse in pixels.
*
* @defaultValue 0.0
*/
private DoubleProperty centerY;
public final void setCenterY(double value) {
if (centerY != null || value != 0.0) {
centerYProperty().set(value);
}
}
public final double getCenterY() {
return centerY == null ? 0.0 : centerY.get();
}
public final DoubleProperty centerYProperty() {
if (centerY == null) {
centerY = new DoublePropertyBase() {
@Override
public void invalidated() {
NodeHelper.markDirty(Ellipse.this, DirtyBits.NODE_GEOMETRY);
NodeHelper.geomChanged(Ellipse.this);
}
@Override
public Object getBean() {
return Ellipse.this;
}
@Override
public String getName() {
return "centerY";
}
};
}
return centerY;
}
Defines the width of the ellipse in pixels.
@defaultValue 0.0
/**
* Defines the width of the ellipse in pixels.
*
* @defaultValue 0.0
*/
private final DoubleProperty radiusX = new DoublePropertyBase() {
@Override
public void invalidated() {
NodeHelper.markDirty(Ellipse.this, DirtyBits.NODE_GEOMETRY);
NodeHelper.geomChanged(Ellipse.this);
}
@Override
public Object getBean() {
return Ellipse.this;
}
@Override
public String getName() {
return "radiusX";
}
};
public final void setRadiusX(double value) {
radiusX.set(value);
}
public final double getRadiusX() {
return radiusX.get();
}
public final DoubleProperty radiusXProperty() {
return radiusX;
}
Defines the height of the ellipse in pixels.
@defaultValue 0.0
/**
* Defines the height of the ellipse in pixels.
*
* @defaultValue 0.0
*/
private final DoubleProperty radiusY = new DoublePropertyBase() {
@Override
public void invalidated() {
NodeHelper.markDirty(Ellipse.this, DirtyBits.NODE_GEOMETRY);
NodeHelper.geomChanged(Ellipse.this);
}
@Override
public Object getBean() {
return Ellipse.this;
}
@Override
public String getName() {
return "radiusY";
}
};
public final void setRadiusY(double value) {
radiusY.set(value);
}
public final double getRadiusY() {
return radiusY.get();
}
public final DoubleProperty radiusYProperty() {
return radiusY;
}
/*
* Note: This method MUST only be called via its accessor method.
*/
private NGNode doCreatePeer() {
return new NGEllipse();
}
/**
*/
@Override StrokeLineJoin convertLineJoin(StrokeLineJoin t) {
// The MITER join style can produce anomalous results for very thin or
// very wide ellipses when the bezier curves that approximate the arcs
// become so distorted that they shoot out MITER-like extensions. This
// effect complicates matters because it makes the ellipses very non-round,
// and also because it means we might have to pad the bounds to account
// for this rare and unpredictable circumstance.
// To avoid the problem, we set the Join style to BEVEL for any
// ellipse. The BEVEL join style is more predictable for
// anomalous angles and is the simplest join style to compute in
// the stroking code.
return StrokeLineJoin.BEVEL;
}
/*
* Note: This method MUST only be called via its accessor method.
*/
private BaseBounds doComputeGeomBounds(BaseBounds bounds, BaseTransform tx) {
// if there is no fill or stroke, then there are no bounds. The bounds
// must be marked empty in this case to distinguish it from 0,0,0,0
// which would actually contribute to the bounds of a group.
if (getMode() == NGShape.Mode.EMPTY) {
return bounds.makeEmpty();
}
if ((tx.getType() & NON_RECTILINEAR_TYPE_MASK) != 0) {
return computeShapeBounds(bounds, tx, ShapeHelper.configShape(this));
}
// compute the x, y, width and height of the ellipse
final double x = getCenterX() - getRadiusX();
final double y = getCenterY() - getRadiusY();
final double width = 2.0f * getRadiusX();
final double height = 2.0f * getRadiusY();
double upad;
double dpad;
if (getMode() == NGShape.Mode.FILL || getStrokeType() == StrokeType.INSIDE) {
upad = dpad = 0.0f;
} else {
upad = getStrokeWidth();
if (getStrokeType() == StrokeType.CENTERED) {
upad /= 2.0f;
}
dpad = 0.0f;
}
return computeBounds(bounds, tx, upad, dpad, x, y, width, height);
}
/*
* Note: This method MUST only be called via its accessor method.
*/
private Ellipse2D doConfigShape() {
shape.setFrame(
(float)(getCenterX() - getRadiusX()), // x
(float)(getCenterY() - getRadiusY()), // y
(float)(getRadiusX() * 2.0), // w
(float)(getRadiusY() * 2.0)); // h
return shape;
}
/*
* Note: This method MUST only be called via its accessor method.
*/
private void doUpdatePeer() {
if (NodeHelper.isDirty(this, DirtyBits.NODE_GEOMETRY)) {
NGEllipse peer = NodeHelper.getPeer(this);
peer.updateEllipse((float)getCenterX(),
(float)getCenterY(),
(float)getRadiusX(),
(float)getRadiusY());
}
}
Returns a string representation of this Ellipse
object. Returns: a string representation of this Ellipse
object.
/**
* Returns a string representation of this {@code Ellipse} object.
* @return a string representation of this {@code Ellipse} object.
*/
@Override
public String toString() {
final StringBuilder sb = new StringBuilder("Ellipse[");
String id = getId();
if (id != null) {
sb.append("id=").append(id).append(", ");
}
sb.append("centerX=").append(getCenterX());
sb.append(", centerY=").append(getCenterY());
sb.append(", radiusX=").append(getRadiusX());
sb.append(", radiusY=").append(getRadiusY());
sb.append(", fill=").append(getFill());
Paint stroke = getStroke();
if (stroke != null) {
sb.append(", stroke=").append(stroke);
sb.append(", strokeWidth=").append(getStrokeWidth());
}
return sb.append("]").toString();
}
}