TransformUtils.ImmutableTransform

java.lang.Object
- javafx.scene.transform.Transform
- - com.sun.javafx.scene.transform.TransformUtils.ImmutableTransform

All Implemented Interfaces:

java.lang.Cloneable, EventTarget

Enclosing class:

TransformUtils
```
static class TransformUtils.ImmutableTransform
extends Transform
```
Immutable transformation with performance optimizations based on Affine. From user's perspective, this transform is immutable. However, we can modify it internally. This allows for reusing instances that were not handed to users. The caller is responsible for not modifying user-visible instances. Note: can't override Transform's package private methods so they cannot be optimized. Currently not a big deal.

Field Summary

Fields
Modifier and Type	Field and Description
`private static int`	`APPLY_3D_COMPLEX`
`private static int`	`APPLY_IDENTITY`
`private static int`	`APPLY_NON_3D`
`private static int`	`APPLY_SCALE`
`private static int`	`APPLY_SHEAR`
`private static int`	`APPLY_TRANSLATE`
`private int`	`state2d`
`private int`	`state3d`
`private double`	`xt`
`private double`	`xx`
`private double`	`xy`
`private double`	`xz`
`private double`	`yt`
`private double`	`yx`
`private double`	`yy`
`private double`	`yz`
`private double`	`zt`
`private double`	`zx`
`private double`	`zy`
`private double`	`zz`

Constructor Summary

Constructors
Constructor and Description
`ImmutableTransform()`
`ImmutableTransform(double mxx, double mxy, double mxz, double tx, double myx, double myy, double myz, double ty, double mzx, double mzy, double mzz, double tz)`
`ImmutableTransform(Transform transform)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`Transform`	`clone()` Returns a deep copy of this transform.
`Transform`	`createConcatenation(Transform transform)` Returns the concatenation of this transform and the specified transform.
`Affine`	`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.
`double`	`determinant()` Computes determinant of the transformation matrix.
`(package private) void`	`ensureCanTransform2DPoint()`
`double`	`getMxx()` Gets the X coordinate scaling element of the 3x4 matrix.
`double`	`getMxy()` Gets the XY coordinate element of the 3x4 matrix.
`double`	`getMxz()` Gets the XZ coordinate element of the 3x4 matrix.
`double`	`getMyx()` Gets the YX coordinate element of the 3x4 matrix.
`double`	`getMyy()` Gets the Y coordinate scaling element of the 3x4 matrix.
`double`	`getMyz()` Gets the YZ coordinate element of the 3x4 matrix.
`double`	`getMzx()` Gets the ZX coordinate element of the 3x4 matrix.
`double`	`getMzy()` Gets the ZY coordinate element of the 3x4 matrix.
`double`	`getMzz()` Gets the Z coordinate scaling element of the 3x4 matrix.
`(package private) int`	`getState2d()` Used only by tests to check the 2d matrix state
`(package private) int`	`getState3d()` Used only by tests to check the 3d matrix state
`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.
`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.
`private void`	`setToConcatenation(TransformUtils.ImmutableTransform left, TransformUtils.ImmutableTransform right)`
`private void`	`setToTransform(double mxx, double mxy, double mxz, double tx, double myx, double myy, double myz, double ty, double mzx, double mzy, double mzz, double tz)`
`private static void`	`stateError()`
`java.lang.String`	`toString()`
`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.
`private void`	`updateState()`
`private void`	`updateState2D()`

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

- Field Detail
  - APPLY_IDENTITY
```
private static final int APPLY_IDENTITY
```
    See Also:
    
    Constant Field Values
  - APPLY_TRANSLATE
```
private static final int APPLY_TRANSLATE
```
    See Also:
    
    Constant Field Values
  - APPLY_SCALE
```
private static final int APPLY_SCALE
```
    See Also:
    
    Constant Field Values
  - APPLY_SHEAR
```
private static final int APPLY_SHEAR
```
    See Also:
    
    Constant Field Values
  - APPLY_NON_3D
```
private static final int APPLY_NON_3D
```
    See Also:
    
    Constant Field Values
  - APPLY_3D_COMPLEX
```
private static final int APPLY_3D_COMPLEX
```
    See Also:
    
    Constant Field Values
  - state2d
```
private transient int state2d
```
  - state3d
```
private transient int state3d
```
  - xx
```
private double xx
```
  - xy
```
private double xy
```
  - xz
```
private double xz
```
  - yx
```
private double yx
```
  - yy
```
private double yy
```
  - yz
```
private double yz
```
  - zx
```
private double zx
```
  - zy
```
private double zy
```
  - zz
```
private double zz
```
  - xt
```
private double xt
```
  - yt
```
private double yt
```
  - zt
```
private double zt
```
- Constructor Detail
  - ImmutableTransform
```
public ImmutableTransform()
```
  - ImmutableTransform
```
public ImmutableTransform(Transform transform)
```
  - ImmutableTransform
```
public ImmutableTransform(double mxx,
                          double mxy,
                          double mxz,
                          double tx,
                          double myx,
                          double myy,
                          double myz,
                          double ty,
                          double mzx,
                          double mzy,
                          double mzz,
                          double tz)
```
- Method Detail
  - setToTransform
```
private void setToTransform(double mxx,
                            double mxy,
                            double mxz,
                            double tx,
                            double myx,
                            double myy,
                            double myz,
                            double ty,
                            double mzx,
                            double mzy,
                            double mzz,
                            double tz)
```
  - setToConcatenation
```
private void setToConcatenation(TransformUtils.ImmutableTransform left,
                                TransformUtils.ImmutableTransform right)
```
  - getMxx
```
public double getMxx()
```
    Description copied from class: Transform
    
    Gets the X coordinate scaling element of the 3x4 matrix.
    
    Overrides:
    
    getMxx in class Transform
  - getMxy
```
public double getMxy()
```
    Description copied from class: Transform
    
    Gets the XY coordinate element of the 3x4 matrix.
    
    Overrides:
    
    getMxy in class Transform
  - getMxz
```
public double getMxz()
```
    Description copied from class: Transform
    
    Gets the XZ coordinate element of the 3x4 matrix.
    
    Overrides:
    
    getMxz 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
  - getMyx
```
public double getMyx()
```
    Description copied from class: Transform
    
    Gets the YX coordinate element of the 3x4 matrix.
    
    Overrides:
    
    getMyx 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
  - getMyz
```
public double getMyz()
```
    Description copied from class: Transform
    
    Gets the YZ coordinate element of the 3x4 matrix.
    
    Overrides:
    
    getMyz 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
  - getMzx
```
public double getMzx()
```
    Description copied from class: Transform
    
    Gets the ZX coordinate element of the 3x4 matrix.
    
    Overrides:
    
    getMzx in class Transform
  - getMzy
```
public double getMzy()
```
    Description copied from class: Transform
    
    Gets the ZY coordinate element of the 3x4 matrix.
    
    Overrides:
    
    getMzy 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
  - getTz
```
public double getTz()
```
    Description copied from class: Transform
    
    Gets the Z coordinate translation element of the 3x4 matrix.
    
    Overrides:
    
    getTz in class Transform
  - determinant
```
public double determinant()
```
    Description copied from class: Transform
    
    Computes determinant of the transformation matrix. Among other things, determinant can be used for testing this transform's invertibility - it is invertible if determinant is not equal to zero.
    
    Overrides:
    
    determinant in class Transform
    
    Returns:
    
    Determinant of the transformation matrix
  - 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 Affine 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 Transform 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
  - 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
  - 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()
```
    Overrides:
    
    toString in class java.lang.Object
  - updateState
```
private void updateState()
```
  - updateState2D
```
private void updateState2D()
```
  - ensureCanTransform2DPoint
```
void ensureCanTransform2DPoint()
                        throws java.lang.IllegalStateException
```
    Throws:
    
    java.lang.IllegalStateException
  - stateError
```
private static void stateError()
```
  - 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
  - getState2d
```
int getState2d()
```
    Used only by tests to check the 2d matrix state
  - getState3d
```
int getState3d()
```
    Used only by tests to check the 3d matrix state

Class TransformUtils.ImmutableTransform

Field Summary

Constructor Summary

Method Summary

Methods inherited from class javafx.scene.transform.Transform

Methods inherited from class java.lang.Object

Field Detail

APPLY_IDENTITY

APPLY_TRANSLATE

APPLY_SCALE

APPLY_SHEAR

APPLY_NON_3D

APPLY_3D_COMPLEX

state2d

state3d

xx

xy

xz

yx

yy

yz

zx

zy

zz

xt

yt

zt

Constructor Detail

ImmutableTransform

ImmutableTransform

ImmutableTransform

Method Detail

setToTransform

setToConcatenation

getMxx

getMxy

getMxz

getTx

getMyx

getMyy

getMyz

getTy

getMzx

getMzy

getMzz

getTz

determinant

createConcatenation

createInverse

clone

transform

transform

deltaTransform

deltaTransform

inverseTransform

inverseTransform

inverseDeltaTransform

inverseDeltaTransform

toString

updateState

updateState2D

ensureCanTransform2DPoint

stateError

impl_apply

impl_derive

getState2d

getState3d