Transform.ImmutableTransform

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

All Implemented Interfaces:

java.lang.Cloneable

Enclosing class:

Transform
```
static class Transform.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.

Property Summary
- Properties inherited from class javafx.scene.transform.Transform
  identityProperty, onTransformChangedProperty, type2DProperty

Nested Class Summary
- Nested classes/interfaces inherited from class javafx.scene.transform.Transform
  Transform.ImmutableTransform

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
Modifier and Type	Method and Description
`(package private) void`	`apply(Affine3D trans)`
`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.
`(package private) BaseTransform`	`derive(BaseTransform trans)`
`double`	`determinant()` Computes determinant of the transformation matrix.
`(package private) void`	`ensureCanTransform2DPoint()` Makes sure this is a 2D transform.
`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.
`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(Transform.ImmutableTransform left, Transform.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 javafx.scene.transform.Transform
add, addEventFilter, addEventHandler, affine, affine, appendTo, buildEventDispatchChain, checkRequestedMAT, clearInverseCache, column, column, computeIs2D, computeIsIdentity, createImmutableTransform, createImmutableTransform, createImmutableTransform, createImmutableTransform, deltaTransform, deltaTransform, fill2DArray, fill3DArray, getElement, getOnTransformChanged, identityProperty, inverseDeltaTransform, inverseDeltaTransform, inverseTransform, inverseTransform, inverseTransform, inverseTransform2DPoints, inverseTransform2DPointsImpl, inverseTransform3DPoints, inverseTransform3DPointsImpl, isIdentity, isType2D, onTransformChangedProperty, prependTo, remove, removeEventFilter, removeEventHandler, rotate, row, row, scale, scale, setOnTransformChanged, shear, shear, similarTo, toArray, toArray, transform, transform, transform, transform2DPoints, transform2DPointsImpl, transform3DPoints, transform3DPointsImpl, transformChanged, translate, type2DProperty, validate

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
```
ImmutableTransform()
```
  - ImmutableTransform
```
ImmutableTransform(Transform transform)
```
  - 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)
```
- 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(Transform.ImmutableTransform left,
                                Transform.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
    
    Returns:
    
    the X coordinate scaling element of the 3x4 matrix
  - getMxy
```
public double getMxy()
```
    Description copied from class: Transform
    
    Gets the XY coordinate element of the 3x4 matrix.
    
    Overrides:
    
    getMxy in class Transform
    
    Returns:
    
    the XY coordinate element of the 3x4 matrix
  - getMxz
```
public double getMxz()
```
    Description copied from class: Transform
    
    Gets the XZ coordinate element of the 3x4 matrix.
    
    Overrides:
    
    getMxz in class Transform
    
    Returns:
    
    the XZ coordinate element of the 3x4 matrix
  - getTx
```
public double getTx()
```
    Description copied from class: Transform
    
    Gets the X coordinate translation element of the 3x4 matrix.
    
    Overrides:
    
    getTx in class Transform
    
    Returns:
    
    the X coordinate translation element of the 3x4 matrix
  - getMyx
```
public double getMyx()
```
    Description copied from class: Transform
    
    Gets the YX coordinate element of the 3x4 matrix.
    
    Overrides:
    
    getMyx in class Transform
    
    Returns:
    
    the YX coordinate element of the 3x4 matrix
  - getMyy
```
public double getMyy()
```
    Description copied from class: Transform
    
    Gets the Y coordinate scaling element of the 3x4 matrix.
    
    Overrides:
    
    getMyy in class Transform
    
    Returns:
    
    the Y coordinate scaling element of the 3x4 matrix
  - getMyz
```
public double getMyz()
```
    Description copied from class: Transform
    
    Gets the YZ coordinate element of the 3x4 matrix.
    
    Overrides:
    
    getMyz in class Transform
    
    Returns:
    
    the YZ coordinate element of the 3x4 matrix
  - getTy
```
public double getTy()
```
    Description copied from class: Transform
    
    Gets the Y coordinate translation element of the 3x4 matrix.
    
    Overrides:
    
    getTy in class Transform
    
    Returns:
    
    the Y coordinate translation element of the 3x4 matrix
  - getMzx
```
public double getMzx()
```
    Description copied from class: Transform
    
    Gets the ZX coordinate element of the 3x4 matrix.
    
    Overrides:
    
    getMzx in class Transform
    
    Returns:
    
    the ZX coordinate element of the 3x4 matrix
  - getMzy
```
public double getMzy()
```
    Description copied from class: Transform
    
    Gets the ZY coordinate element of the 3x4 matrix.
    
    Overrides:
    
    getMzy in class Transform
    
    Returns:
    
    the ZY coordinate element of the 3x4 matrix
  - getMzz
```
public double getMzz()
```
    Description copied from class: Transform
    
    Gets the Z coordinate scaling element of the 3x4 matrix.
    
    Overrides:
    
    getMzz in class Transform
    
    Returns:
    
    the Z coordinate scaling element of the 3x4 matrix
  - getTz
```
public double getTz()
```
    Description copied from class: Transform
    
    Gets the Z coordinate translation element of the 3x4 matrix.
    
    Overrides:
    
    getTz in class Transform
    
    Returns:
    
    the Z coordinate translation element of the 3x4 matrix
  - 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
    
    z - vector magnitude in the direction of the Z 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
    
    z - vector magnitude in the direction of the Z 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
```
    Description copied from class: Transform
    
    Makes sure this is a 2D transform. Is used for convenience in various 2D point transformation methods.
    
    Overrides:
    
    ensureCanTransform2DPoint in class Transform
    
    Throws:
    
    java.lang.IllegalStateException - if this is a 2D transform
  - stateError
```
private static void stateError()
```
  - apply
```
void apply(Affine3D trans)
```
    Specified by:
    
    apply in class Transform
  - derive
```
BaseTransform derive(BaseTransform trans)
```
    Specified by:
    
    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 Transform.ImmutableTransform

Property Summary

Properties inherited from class javafx.scene.transform.Transform

Nested Class Summary

Nested classes/interfaces inherited from class javafx.scene.transform.Transform

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

apply

derive

getState2d

getState3d