Scale

java.lang.Object
- javafx.scene.transform.Transform
- - javafx.scene.transform.Scale

All Implemented Interfaces:

java.lang.Cloneable, EventTarget
```
public class Scale
extends Transform
```
This class represents an Affine object that scales coordinates by the specified factors. The matrix representing the scaling transformation is as follows:
```
              [ x   0   0   (1-x)*pivotX ]
              [ 0   y   0   (1-y)*pivotY ]
              [ 0   0   z   (1-z)*pivotZ ]
 
```
Since:

JavaFX 2.0

Field Summary

Fields
Modifier and Type	Field and Description
`private DoubleProperty`	`pivotX` Defines the X coordinate about which point the scale occurs.
`private DoubleProperty`	`pivotY` Defines the Y coordinate about which point the scale occurs.
`private DoubleProperty`	`pivotZ` Defines the Z coordinate about which point the scale occurs.
`private DoubleProperty`	`x` Defines the factor by which coordinates are scaled along the X axis direction.
`private DoubleProperty`	`y` Defines the factor by which coordinates are scaled along the Y axis direction.
`private DoubleProperty`	`z` Defines the factor by which coordinates are scaled along the Z axis direction.

Constructor Summary

Constructors
Constructor and Description
`Scale()` Creates a default Scale (identity).
`Scale(double x, double y)` Creates a two-dimensional Scale.
`Scale(double x, double y, double z)` Creates a three-dimensional Scale.
`Scale(double x, double y, double pivotX, double pivotY)` Creates a two-dimensional Scale with pivot.
`Scale(double x, double y, double z, double pivotX, double pivotY, double pivotZ)` Creates a three-dimensional Scale with pivot.

Method Summary

All Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`(package private) void`	`appendTo(Affine a)` Visitor from `Affine` class which provides an efficient `append` operation for the subclasses.
`Scale`	`clone()` Returns a deep copy of this transform.
`(package private) boolean`	`computeIs2D()` Computes if this transform is currently a 2D transform (has no effect in the direction of Z axis).
`(package private) boolean`	`computeIsIdentity()` Computes if this transform is currently an identity (has no effect in any direction).
`Transform`	`createConcatenation(Transform transform)` Returns the concatenation of this transform and the specified transform.
`Scale`	`createInverse()` Returns the inverse transform of this transform.
`Point2D`	`deltaTransform(double x, double y)` Transforms the relative magnitude vector by this transform.
`Point3D`	`deltaTransform(double x, double y, double z)` Transforms the relative magnitude vector by this transform.
`(package private) void`	`fill2DArray(double[] array)` Core of the toArray implementation for the 2D case.
`(package private) void`	`fill3DArray(double[] array)` Core of the toArray implementation for the 3D case.
`double`	`getMxx()` Gets the X coordinate scaling element of the 3x4 matrix.
`double`	`getMyy()` Gets the Y coordinate scaling element of the 3x4 matrix.
`double`	`getMzz()` Gets the Z coordinate scaling element of the 3x4 matrix.
`double`	`getPivotX()`
`double`	`getPivotY()`
`double`	`getPivotZ()`
`double`	`getTx()` Gets the X coordinate translation element of the 3x4 matrix.
`double`	`getTy()` Gets the Y coordinate translation element of the 3x4 matrix.
`double`	`getTz()` Gets the Z coordinate translation element of the 3x4 matrix.
`double`	`getX()`
`double`	`getY()`
`double`	`getZ()`
`void`	`impl_apply(Affine3D trans)` Deprecated. This is an internal API that is not intended for use and will be removed in the next version
`BaseTransform`	`impl_derive(BaseTransform trans)` Deprecated. This is an internal API that is not intended for use and will be removed in the next version
`Point2D`	`inverseDeltaTransform(double x, double y)` Transforms the relative magnitude vector by the inverse of this transform.
`Point3D`	`inverseDeltaTransform(double x, double y, double z)` Transforms the relative magnitude vector by the inverse of this transform.
`Point2D`	`inverseTransform(double x, double y)` Transforms the specified point by the inverse of this transform.
`Point3D`	`inverseTransform(double x, double y, double z)` Transforms the specified point by the inverse of this transform.
`(package private) void`	`inverseTransform2DPointsImpl(double[] srcPts, int srcOff, double[] dstPts, int dstOff, int numPts)` Core of the inverseTransform2DPoints method.
`(package private) void`	`inverseTransform3DPointsImpl(double[] srcPts, int srcOff, double[] dstPts, int dstOff, int numPts)` Core of the inverseTransform3DPoints method.
`DoubleProperty`	`pivotXProperty()`
`DoubleProperty`	`pivotYProperty()`
`DoubleProperty`	`pivotZProperty()`
`(package private) void`	`prependTo(Affine a)` Visitor from `Affine` class which provides an efficient `prepend` operation for the subclasses.
`void`	`setPivotX(double value)`
`void`	`setPivotY(double value)`
`void`	`setPivotZ(double value)`
`void`	`setX(double value)`
`void`	`setY(double value)`
`void`	`setZ(double value)`
`java.lang.String`	`toString()` Returns a string representation of this `Scale` object.
`Point2D`	`transform(double x, double y)` Transforms the specified point by this transform.
`Point3D`	`transform(double x, double y, double z)` Transforms the specified point by this transform.
`(package private) void`	`transform2DPointsImpl(double[] srcPts, int srcOff, double[] dstPts, int dstOff, int numPts)` Core of the transform2DPoints method.
`(package private) void`	`transform3DPointsImpl(double[] srcPts, int srcOff, double[] dstPts, int dstOff, int numPts)` Core of the transform3DPoints method.
`(package private) void`	`validate()` Needed for the proper delivery of the TransformChangedEvent.
`DoubleProperty`	`xProperty()`
`DoubleProperty`	`yProperty()`
`DoubleProperty`	`zProperty()`

Methods inherited from class javafx.scene.transform.Transform
addEventFilter, addEventHandler, affine, affine, buildEventDispatchChain, checkRequestedMAT, clearInverseCache, column, column, deltaTransform, deltaTransform, determinant, ensureCanTransform2DPoint, getElement, getMxy, getMxz, getMyx, getMyz, getMzx, getMzy, getOnTransformChanged, identityProperty, impl_add, impl_remove, inverseDeltaTransform, inverseDeltaTransform, inverseTransform, inverseTransform, inverseTransform, inverseTransform2DPoints, inverseTransform3DPoints, isIdentity, isType2D, onTransformChangedProperty, removeEventFilter, removeEventHandler, rotate, row, row, scale, scale, setOnTransformChanged, shear, shear, similarTo, toArray, toArray, transform, transform, transform, transform2DPoints, transform3DPoints, transformChanged, translate, type2DProperty

Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - x
```
private DoubleProperty x
```
    Defines the factor by which coordinates are scaled along the X axis direction. The default value is 1.0.
  - y
```
private DoubleProperty y
```
    Defines the factor by which coordinates are scaled along the Y axis direction. The default value is 1.0.
  - z
```
private DoubleProperty z
```
    Defines the factor by which coordinates are scaled along the Z axis direction. The default value is 1.0.
  - pivotX
```
private DoubleProperty pivotX
```
    Defines the X coordinate about which point the scale occurs.
  - pivotY
```
private DoubleProperty pivotY
```
    Defines the Y coordinate about which point the scale occurs.
  - pivotZ
```
private DoubleProperty pivotZ
```
    Defines the Z coordinate about which point the scale occurs.
- Constructor Detail
  - Scale
```
public Scale()
```
    Creates a default Scale (identity).
  - Scale
```
public Scale(double x,
             double y)
```
    Creates a two-dimensional Scale. The pivot point is set to (0,0)
    
    Parameters:
    
    x - the factor by which coordinates are scaled along the X axis
    
    y - the factor by which coordinates are scaled along the Y axis
  - Scale
```
public Scale(double x,
             double y,
             double pivotX,
             double pivotY)
```
    Creates a two-dimensional Scale with pivot.
    
    Parameters:
    
    x - the factor by which coordinates are scaled along the X axis
    
    y - the factor by which coordinates are scaled along the Y axis
    
    pivotX - the X coordinate about which point the scale occurs
    
    pivotY - the Y coordinate about which point the scale occurs
  - Scale
```
public Scale(double x,
             double y,
             double z)
```
    Creates a three-dimensional Scale. The pivot point is set to (0,0,0)
    
    Parameters:
    
    x - the factor by which coordinates are scaled along the X axis
    
    y - the factor by which coordinates are scaled along the Y axis
    
    z - the factor by which coordinates are scaled along the Z axis
  - Scale
```
public Scale(double x,
             double y,
             double z,
             double pivotX,
             double pivotY,
             double pivotZ)
```
    Creates a three-dimensional Scale with pivot.
    
    Parameters:
    
    x - the factor by which coordinates are scaled along the X axis
    
    y - the factor by which coordinates are scaled along the Y axis
    
    z - the factor by which coordinates are scaled along the Z axis
    
    pivotX - the X coordinate about which point the scale occurs
    
    pivotY - the Y coordinate about which point the scale occurs
    
    pivotZ - the Z coordinate about which point the scale occurs
- Method Detail
  - setX
```
public final void setX(double value)
```
  - getX
```
public final double getX()
```
  - xProperty
```
public final DoubleProperty xProperty()
```
  - setY
```
public final void setY(double value)
```
  - getY
```
public final double getY()
```
  - yProperty
```
public final DoubleProperty yProperty()
```
  - setZ
```
public final void setZ(double value)
```
  - getZ
```
public final double getZ()
```
  - zProperty
```
public final DoubleProperty zProperty()
```
  - setPivotX
```
public final void setPivotX(double value)
```
  - getPivotX
```
public final double getPivotX()
```
  - pivotXProperty
```
public final DoubleProperty pivotXProperty()
```
  - setPivotY
```
public final void setPivotY(double value)
```
  - getPivotY
```
public final double getPivotY()
```
  - pivotYProperty
```
public final DoubleProperty pivotYProperty()
```
  - setPivotZ
```
public final void setPivotZ(double value)
```
  - getPivotZ
```
public final double getPivotZ()
```
  - pivotZProperty
```
public final DoubleProperty pivotZProperty()
```
  - getMxx
```
public double getMxx()
```
    Description copied from class: Transform
    
    Gets the X coordinate scaling element of the 3x4 matrix.
    
    Overrides:
    
    getMxx in class Transform
  - getMyy
```
public double getMyy()
```
    Description copied from class: Transform
    
    Gets the Y coordinate scaling element of the 3x4 matrix.
    
    Overrides:
    
    getMyy in class Transform
  - getMzz
```
public double getMzz()
```
    Description copied from class: Transform
    
    Gets the Z coordinate scaling element of the 3x4 matrix.
    
    Overrides:
    
    getMzz in class Transform
  - getTx
```
public double getTx()
```
    Description copied from class: Transform
    
    Gets the X coordinate translation element of the 3x4 matrix.
    
    Overrides:
    
    getTx in class Transform
  - getTy
```
public double getTy()
```
    Description copied from class: Transform
    
    Gets the Y coordinate translation element of the 3x4 matrix.
    
    Overrides:
    
    getTy in class Transform
  - getTz
```
public double getTz()
```
    Description copied from class: Transform
    
    Gets the Z coordinate translation element of the 3x4 matrix.
    
    Overrides:
    
    getTz in class Transform
  - computeIs2D
```
boolean computeIs2D()
```
    Description copied from class: Transform
    
    Computes if this transform is currently a 2D transform (has no effect in the direction of Z axis). Used by the subclasses to effectively provide value of the type2D property.
    
    Overrides:
    
    computeIs2D in class Transform
    
    Returns:
    
    true if this transform is currently 2D-only
  - computeIsIdentity
```
boolean computeIsIdentity()
```
    Description copied from class: Transform
    
    Computes if this transform is currently an identity (has no effect in any direction). Used by the subclasses to effectively provide value of the identity property.
    
    Overrides:
    
    computeIsIdentity in class Transform
    
    Returns:
    
    true if this transform is currently an identity transform
  - fill2DArray
```
void fill2DArray(double[] array)
```
    Description copied from class: Transform
    
    Core of the toArray implementation for the 2D case. All of the checks has been made by the enclosing method as well as the constant elements filled, this method only fills the varying elements to the array. Used by subclasses to fill the elements efficiently.
    
    Overrides:
    
    fill2DArray in class Transform
    
    Parameters:
    
    array - array to be filled with the 6 2D elements
  - fill3DArray
```
void fill3DArray(double[] array)
```
    Description copied from class: Transform
    
    Core of the toArray implementation for the 3D case. All of the checks has been made by the enclosing method as well as the constant elements filled, this method only fills the varying elements to the array. Used by subclasses to fill the elements efficiently.
    
    Overrides:
    
    fill3DArray in class Transform
    
    Parameters:
    
    array - array to be filled with the 12 3D elements
  - createConcatenation
```
public Transform createConcatenation(Transform transform)
```
    Description copied from class: Transform
    
    Returns the concatenation of this transform and the specified transform. Applying the resulting transform to a node has the same effect as adding the two transforms to its getTransforms() list, this transform first and the specified transform second.
    
    Overrides:
    
    createConcatenation in class Transform
    
    Parameters:
    
    transform - transform to be concatenated with this transform
    
    Returns:
    
    The concatenated transform
  - createInverse
```
public Scale createInverse()
                    throws NonInvertibleTransformException
```
    Description copied from class: Transform
    
    Returns the inverse transform of this transform.
    
    Overrides:
    
    createInverse in class Transform
    
    Returns:
    
    the inverse transform
    
    Throws:
    
    NonInvertibleTransformException - if this transform cannot be inverted
  - clone
```
public Scale clone()
```
    Description copied from class: Transform
    
    Returns a deep copy of this transform.
    
    Overrides:
    
    clone in class Transform
    
    Returns:
    
    a copy of this transform
  - transform
```
public Point2D transform(double x,
                         double y)
```
    Description copied from class: Transform
    
    Transforms the specified point by this transform. This method can be used only for 2D transforms.
    
    Overrides:
    
    transform in class Transform
    
    Parameters:
    
    x - the X coordinate of the point
    
    y - the Y coordinate of the point
    
    Returns:
    
    the transformed point
  - transform
```
public Point3D transform(double x,
                         double y,
                         double z)
```
    Description copied from class: Transform
    
    Transforms the specified point by this transform.
    
    Overrides:
    
    transform in class Transform
    
    Parameters:
    
    x - the X coordinate of the point
    
    y - the Y coordinate of the point
    
    z - the Z coordinate of the point
    
    Returns:
    
    the transformed point
  - transform2DPointsImpl
```
void transform2DPointsImpl(double[] srcPts,
                           int srcOff,
                           double[] dstPts,
                           int dstOff,
                           int numPts)
```
    Description copied from class: Transform
    
    Core of the transform2DPoints method. All the checks has been performed and the care of the overlaps has been taken by the enclosing method, this method only transforms the points and fills them to the array. Used by the subclasses to perform the transform efficiently.
    
    Overrides:
    
    transform2DPointsImpl in class Transform
  - transform3DPointsImpl
```
void transform3DPointsImpl(double[] srcPts,
                           int srcOff,
                           double[] dstPts,
                           int dstOff,
                           int numPts)
```
    Description copied from class: Transform
    
    Core of the transform3DPoints method. All the checks has been performed and the care of the overlaps has been taken by the enclosing method, this method only transforms the points and fills them to the array. Used by the subclasses to perform the transform efficiently.
    
    Overrides:
    
    transform3DPointsImpl in class Transform
  - deltaTransform
```
public Point2D deltaTransform(double x,
                              double y)
```
    Description copied from class: Transform
    
    Transforms the relative magnitude vector by this transform. The vector is transformed without applying the translation components of the affine transformation matrix. This method can be used only for a 2D transform.
    
    Overrides:
    
    deltaTransform in class Transform
    
    Parameters:
    
    x - vector magnitude in the direction of the X axis
    
    y - vector magnitude in the direction of the Y axis
    
    Returns:
    
    the transformed relative magnitude vector represented by a Point2D instance
  - deltaTransform
```
public Point3D deltaTransform(double x,
                              double y,
                              double z)
```
    Description copied from class: Transform
    
    Transforms the relative magnitude vector by this transform. The vector is transformed without applying the translation components of the affine transformation matrix.
    
    Overrides:
    
    deltaTransform in class Transform
    
    Parameters:
    
    x - vector magnitude in the direction of the X axis
    
    y - vector magnitude in the direction of the Y axis
    
    Returns:
    
    the transformed relative magnitude vector represented by a Point3D instance
  - inverseTransform
```
public Point2D inverseTransform(double x,
                                double y)
                         throws NonInvertibleTransformException
```
    Description copied from class: Transform
    
    Transforms the specified point by the inverse of this transform. This method can be used only for 2D transforms.
    
    Overrides:
    
    inverseTransform in class Transform
    
    Parameters:
    
    x - the X coordinate of the point
    
    y - the Y coordinate of the point
    
    Returns:
    
    the inversely transformed point
    
    Throws:
    
    NonInvertibleTransformException - if this transform cannot be inverted
  - inverseTransform
```
public Point3D inverseTransform(double x,
                                double y,
                                double z)
                         throws NonInvertibleTransformException
```
    Description copied from class: Transform
    
    Transforms the specified point by the inverse of this transform.
    
    Overrides:
    
    inverseTransform in class Transform
    
    Parameters:
    
    x - the X coordinate of the point
    
    y - the Y coordinate of the point
    
    z - the Z coordinate of the point
    
    Returns:
    
    the inversely transformed point
    
    Throws:
    
    NonInvertibleTransformException - if this transform cannot be inverted
  - inverseTransform2DPointsImpl
```
void inverseTransform2DPointsImpl(double[] srcPts,
                                  int srcOff,
                                  double[] dstPts,
                                  int dstOff,
                                  int numPts)
                           throws NonInvertibleTransformException
```
    Description copied from class: Transform
    
    Core of the inverseTransform2DPoints method. All the checks has been performed and the care of the overlaps has been taken by the enclosing method, this method only transforms the points and fills them to the array. Used by the subclasses to perform the transform efficiently.
    
    Overrides:
    
    inverseTransform2DPointsImpl in class Transform
    
    Throws:
    
    NonInvertibleTransformException
  - inverseTransform3DPointsImpl
```
void inverseTransform3DPointsImpl(double[] srcPts,
                                  int srcOff,
                                  double[] dstPts,
                                  int dstOff,
                                  int numPts)
                           throws NonInvertibleTransformException
```
    Description copied from class: Transform
    
    Core of the inverseTransform3DPoints method. All the checks has been performed and the care of the overlaps has been taken by the enclosing method, this method only transforms the points and fills them to the array. Used by the subclasses to perform the transform efficiently.
    
    Overrides:
    
    inverseTransform3DPointsImpl in class Transform
    
    Throws:
    
    NonInvertibleTransformException
  - inverseDeltaTransform
```
public Point2D inverseDeltaTransform(double x,
                                     double y)
                              throws NonInvertibleTransformException
```
    Description copied from class: Transform
    
    Transforms the relative magnitude vector by the inverse of this transform. The vector is transformed without applying the translation components of the affine transformation matrix. This method can be used only for a 2D transform.
    
    Overrides:
    
    inverseDeltaTransform in class Transform
    
    Parameters:
    
    x - vector magnitude in the direction of the X axis
    
    y - vector magnitude in the direction of the Y axis
    
    Returns:
    
    the inversely transformed relative magnitude vector represented by a Point2D instance
    
    Throws:
    
    NonInvertibleTransformException - if this transform cannot be inverted
  - inverseDeltaTransform
```
public Point3D inverseDeltaTransform(double x,
                                     double y,
                                     double z)
                              throws NonInvertibleTransformException
```
    Description copied from class: Transform
    
    Transforms the relative magnitude vector by the inverse of this transform. The vector is transformed without applying the translation components of the affine transformation matrix.
    
    Overrides:
    
    inverseDeltaTransform in class Transform
    
    Parameters:
    
    x - vector magnitude in the direction of the X axis
    
    y - vector magnitude in the direction of the Y axis
    
    Returns:
    
    the inversely transformed relative magnitude vector represented by a Point3D instance
    
    Throws:
    
    NonInvertibleTransformException - if this transform cannot be inverted
  - toString
```
public java.lang.String toString()
```
    Returns a string representation of this Scale object.
    
    Overrides:
    
    toString in class java.lang.Object
    
    Returns:
    
    a string representation of this Scale object.
  - impl_apply
```
@Deprecated
public void impl_apply(Affine3D trans)
```
    Deprecated. This is an internal API that is not intended for use and will be removed in the next version
    
    Specified by:
    
    impl_apply in class Transform
  - impl_derive
```
@Deprecated
public BaseTransform impl_derive(BaseTransform trans)
```
    Deprecated. This is an internal API that is not intended for use and will be removed in the next version
    
    Specified by:
    
    impl_derive in class Transform
  - validate
```
void validate()
```
    Description copied from class: Transform
    
    Needed for the proper delivery of the TransformChangedEvent. If the members are invalid, the transformChanged() notification is not called and the event is not delivered. To avoid that we need to manually validate all properties. Subclasses validate their specific properties.
    
    Overrides:
    
    validate in class Transform
  - appendTo
```
void appendTo(Affine a)
```
    Description copied from class: Transform
    
    Visitor from Affine class which provides an efficient append operation for the subclasses.
    
    Overrides:
    
    appendTo in class Transform
    
    Parameters:
    
    a - Affine instance to append to
  - prependTo
```
void prependTo(Affine a)
```
    Description copied from class: Transform
    
    Visitor from Affine class which provides an efficient prepend operation for the subclasses.
    
    Overrides:
    
    prependTo in class Transform
    
    Parameters:
    
    a - Affine instance to prepend to

Class Scale

Field Summary

Constructor Summary

Method Summary

Methods inherited from class javafx.scene.transform.Transform

Methods inherited from class java.lang.Object

Field Detail

x

y

z

pivotX

pivotY

pivotZ

Constructor Detail

Scale

Scale

Scale

Scale

Scale

Method Detail

setX

getX

xProperty

setY

getY

yProperty

setZ

getZ

zProperty

setPivotX

getPivotX

pivotXProperty

setPivotY

getPivotY

pivotYProperty

setPivotZ

getPivotZ

pivotZProperty

getMxx

getMyy

getMzz

getTx

getTy

getTz

computeIs2D

computeIsIdentity

fill2DArray

fill3DArray

createConcatenation

createInverse

clone

transform

transform

transform2DPointsImpl

transform3DPointsImpl

deltaTransform

deltaTransform

inverseTransform

inverseTransform

inverseTransform2DPointsImpl

inverseTransform3DPointsImpl

inverseDeltaTransform

inverseDeltaTransform

toString

impl_apply

impl_derive

validate

appendTo

prependTo