diff --git a/modules/javafx.graphics/src/main/java/javafx/scene/Node.java b/modules/javafx.graphics/src/main/java/javafx/scene/Node.java index f1b7839e3e7..a6dbb22ad1c 100644 --- a/modules/javafx.graphics/src/main/java/javafx/scene/Node.java +++ b/modules/javafx.graphics/src/main/java/javafx/scene/Node.java @@ -225,7 +225,7 @@ * an UnsupportedOperationException being thrown. *
* - ** Each node in the scene graph can be given a unique {@link #idProperty id}. This id is * much like the "id" attribute of an HTML tag in that it is up to the designer @@ -235,7 +235,7 @@ * scene graph. The id can also be used identify nodes for applying styles; see * the CSS section below. * - *
* The {@code Node} class defines a traditional computer graphics "local" * coordinate system in which the {@code x} axis increases to the right and the @@ -268,7 +268,7 @@ * important context-specific information about coordinate mapping and how * it can affect rendering. * - *
* Any {@code Node} can have transformations applied to it. These include * translation, rotation, scaling, or shearing. @@ -321,11 +321,22 @@ * A shearing transformation, sometimes called a skew, effectively * rotates one axis so that the x and y axes are no longer perpendicular. *
- * Multiple transformations may be applied to a node by specifying an ordered - * chain of transforms. The order in which the transforms are applied is - * defined by the ObservableList specified in the {@link #getTransforms transforms} variable. + * Multiple transformations may be applied to a node. Custom transforms are applied using the + * {@link #getTransforms transforms} list. Predefined transforms are applied using the properties specified below. + * The matrices that represent the transforms are multiplied in this order: + *
* Since every {@code Node} has transformations, every Node's geometric * bounding rectangle can be described differently depending on whether @@ -340,9 +351,7 @@ *
* Each {@code Node} also has a read-only {@link #boundsInParentProperty boundsInParent} variable which * specifies the bounding rectangle of the {@code Node} after all transformations - * have been applied, including those set in {@link #getTransforms transforms}, - * {@link #scaleXProperty scaleX}/{@link #scaleYProperty scaleY}, {@link #rotateProperty rotate}, - * {@link #translateXProperty translateX}/{@link #translateYProperty translateY}, and {@link #layoutXProperty layoutX}/{@link #layoutYProperty layoutY}. + * have been applied as specified in the Transformations section. * It is called "boundsInParent" because the rectangle will be relative to the * parent's coordinate system. This is the 'visual' bounds of the node. *
@@ -380,8 +389,7 @@ *
* - * - *
* The {@code Node} class contains {@code id}, {@code styleClass}, and * {@code style} variables that are used in styling this node from @@ -393,6 +401,7 @@ * For further information about CSS and how to apply CSS styles * to nodes, see the CSS Reference * Guide. + * * @since JavaFX 2.0 */ @IDProperty("id") @@ -3388,21 +3397,12 @@ public final Bounds getBoundsInParent() { } /** - * The rectangular bounds of this {@code Node} which include its transforms. - * {@code boundsInParent} is calculated by - * taking the local bounds (defined by {@link #boundsInLocalProperty boundsInLocal}) and applying - * the transform created by setting the following additional variables - *
* The resulting bounds will be conceptually in the coordinate space of the - * {@code Node}'s parent, however the node need not have a parent to calculate + * {@code Node}'s parent, however, the node need not have a parent to calculate * these bounds. *
* Note that this method does not take the node's visibility into account; @@ -3418,7 +3418,10 @@ public final Bounds getBoundsInParent() { * this variable. For example, the x or y variables of a shape, or * {@code translateX}, {@code translateY} should never be bound to * {@code boundsInParent} for the purpose of positioning the node. - * @return the boundsInParent for this {@code Node} + *
+ * See also the Bounding Rectangles section.
+ *
+ * @return the {@code boundsInParent} property for this {@code Node}
*/
public final ReadOnlyObjectProperty
+ * See also the Transformations section.
*
* @return the transforms for this {@code Node}
* @defaultValue empty