Class Affine

java.lang.Object

javafx.scene.transform.Transform

javafx.scene.transform.Affine

All Implemented Interfaces:: Cloneable, EventTarget

public class Affine extends Transform

The Affine class represents a general affine transform. An affine transform performs a linear mapping from 2D/3D coordinates to other 2D/3D coordinates while preserving the "straightness" and "parallelness" of lines. Affine transformations can be constructed using sequence rotations, translations, scales, and shears.

For simple transformations application developers should use the specific Translate, Scale, Rotate, or Shear transforms, which are more lightweight and thus more optimal for this simple purpose. The Affine class, on the other hand, has the advantage of being able to represent a general affine transform and perform matrix operations on it in place, so it fits better for more complex transformation usages.

Such a coordinate transformation can be represented by a 3 row by 4 column matrix. This matrix transforms source coordinates (x,y,z) into destination coordinates (x',y',z') by considering them to be a column vector and multiplying the coordinate vector by the matrix according to the following process:

      [ x']   [  mxx  mxy  mxz  tx  ] [ x ]   [ mxx * x + mxy * y + mxz * z + tx ]
      [ y'] = [  myx  myy  myz  ty  ] [ y ] = [ myx * x + myy * y + myz * z + ty ]
      [ z']   [  mzx  mzy  mzz  tz  ] [ z ]   [ mzx * x + mzy * y + mzz * z + tz ]
                                      [ 1 ]

Since:: JavaFX 2.0

Property Summary

Type	Property	Description
`final DoubleProperty`	`mxx`	Defines the X coordinate scaling element of the 3x4 matrix.
`final DoubleProperty`	`mxy`	Defines the XY coordinate element of the 3x4 matrix.
`final DoubleProperty`	`mxz`	Defines the XZ coordinate element of the 3x4 matrix.
`final DoubleProperty`	`myx`	Defines the YX coordinate element of the 3x4 matrix.
`final DoubleProperty`	`myy`	Defines the Y coordinate scaling element of the 3x4 matrix.
`final DoubleProperty`	`myz`	Defines the YZ coordinate element of the 3x4 matrix.
`final DoubleProperty`	`mzx`	Defines the ZX coordinate element of the 3x4 matrix.
`final DoubleProperty`	`mzy`	Defines the ZY coordinate element of the 3x4 matrix.
`final DoubleProperty`	`mzz`	Defines the Z coordinate scaling element of the 3x4 matrix.
`final DoubleProperty`	`tx`	Defines the X coordinate translation element of the 3x4 matrix.
`final DoubleProperty`	`ty`	Defines the Y coordinate translation element of the 3x4 matrix.
`final DoubleProperty`	`tz`	Defines the Z coordinate translation element of the 3x4 matrix.

Properties declared in class javafx.scene.transform.Transform

identity, onTransformChanged, type2D

Constructor Summary

Constructor	Description
`Affine()`	Creates a new instance of `Affine` containing an identity transform.
`Affine(double[] matrix, MatrixType type, int offset)`	Creates a new instance of `Affine` with a transformation matrix specified by an array.
`Affine(double mxx, double mxy, double tx, double myx, double myy, double ty)`	Creates a new instance of `Affine` with a 2D transform specified by the element values.
`Affine(double mxx, double mxy, double mxz, double tx, double myx, double myy, double myz, double ty, double mzx, double mzy, double mzz, double tz)`	Creates a new instance of `Affine` with a transform specified by the element values.
`Affine(Transform transform)`	Creates a new instance of `Affine` filled with the values from the specified transform.

Method Summary

Modifier and Type	Method	Description
`void`	`append(double[] matrix, MatrixType type, int offset)`	Appends the transform specified by the array to this instance.
`void`	`append(double mxx, double mxy, double tx, double myx, double myy, double ty)`	Appends the 2D transform specified by the element values to this instance.
`void`	`append(double mxx, double mxy, double mxz, double tx, double myx, double myy, double myz, double ty, double mzx, double mzy, double mzz, double tz)`	Appends the transform specified by the element values to this instance.
`void`	`append(Transform transform)`	Appends the specified transform to this instance.
`void`	`appendRotation(double angle)`	Appends the 2D rotation to this instance.
`void`	`appendRotation(double angle, double pivotX, double pivotY)`	Appends the 2D rotation with pivot to this instance.
`void`	`appendRotation(double angle, double pivotX, double pivotY, double pivotZ, double axisX, double axisY, double axisZ)`	Appends the rotation to this instance.
`void`	`appendRotation(double angle, double pivotX, double pivotY, double pivotZ, Point3D axis)`	Appends the rotation to this instance.
`void`	`appendRotation(double angle, Point2D pivot)`	Appends the 2D rotation with pivot to this instance.
`void`	`appendRotation(double angle, Point3D pivot, Point3D axis)`	Appends the rotation to this instance.
`void`	`appendScale(double sx, double sy)`	Appends the 2D scale to this instance.
`void`	`appendScale(double sx, double sy, double sz)`	Appends the scale to this instance.
`void`	`appendScale(double sx, double sy, double pivotX, double pivotY)`	Appends the 2D scale with pivot to this instance.
`void`	`appendScale(double sx, double sy, double sz, double pivotX, double pivotY, double pivotZ)`	Appends the scale with pivot to this instance.
`void`	`appendScale(double sx, double sy, double sz, Point3D pivot)`	Appends the scale with pivot to this instance.
`void`	`appendScale(double sx, double sy, Point2D pivot)`	Appends the 2D scale with pivot to this instance.
`void`	`appendShear(double shx, double shy)`	Appends the shear to this instance.
`void`	`appendShear(double shx, double shy, double pivotX, double pivotY)`	Appends the shear with pivot to this instance.
`void`	`appendShear(double shx, double shy, Point2D pivot)`	Appends the shear with pivot to this instance.
`void`	`appendTranslation(double tx, double ty)`	Appends the 2D translation to this instance.
`void`	`appendTranslation(double tx, double ty, double tz)`	Appends the translation to this instance.
`Affine`	`clone()`	Returns a deep copy of this transform.
`Affine`	`createInverse()`	Returns the inverse transform of this transform.
`final double`	`getMxx()`	Gets the value of the `mxx` property.
`final double`	`getMxy()`	Gets the value of the `mxy` property.
`final double`	`getMxz()`	Gets the value of the `mxz` property.
`final double`	`getMyx()`	Gets the value of the `myx` property.
`final double`	`getMyy()`	Gets the value of the `myy` property.
`final double`	`getMyz()`	Gets the value of the `myz` property.
`final double`	`getMzx()`	Gets the value of the `mzx` property.
`final double`	`getMzy()`	Gets the value of the `mzy` property.
`final double`	`getMzz()`	Gets the value of the `mzz` property.
`final double`	`getTx()`	Gets the value of the `tx` property.
`final double`	`getTy()`	Gets the value of the `ty` property.
`final double`	`getTz()`	Gets the value of the `tz` property.
`void`	`invert()`	Inverts this transform in place.
`final DoubleProperty`	`mxxProperty()`	Defines the X coordinate scaling element of the 3x4 matrix.
`final DoubleProperty`	`mxyProperty()`	Defines the XY coordinate element of the 3x4 matrix.
`final DoubleProperty`	`mxzProperty()`	Defines the XZ coordinate element of the 3x4 matrix.
`final DoubleProperty`	`myxProperty()`	Defines the YX coordinate element of the 3x4 matrix.
`final DoubleProperty`	`myyProperty()`	Defines the Y coordinate scaling element of the 3x4 matrix.
`final DoubleProperty`	`myzProperty()`	Defines the YZ coordinate element of the 3x4 matrix.
`final DoubleProperty`	`mzxProperty()`	Defines the ZX coordinate element of the 3x4 matrix.
`final DoubleProperty`	`mzyProperty()`	Defines the ZY coordinate element of the 3x4 matrix.
`final DoubleProperty`	`mzzProperty()`	Defines the Z coordinate scaling element of the 3x4 matrix.
`void`	`prepend(double[] matrix, MatrixType type, int offset)`	Prepends the transform specified by the array to this instance.
`void`	`prepend(double mxx, double mxy, double tx, double myx, double myy, double ty)`	Prepends the 2D transform specified by the element values to this instance.
`void`	`prepend(double mxx, double mxy, double mxz, double tx, double myx, double myy, double myz, double ty, double mzx, double mzy, double mzz, double tz)`	Prepends the transform specified by the element values to this instance.
`void`	`prepend(Transform transform)`	Prepends the specified transform to this instance.
`void`	`prependRotation(double angle)`	Prepends the 2D rotation to this instance.
`void`	`prependRotation(double angle, double pivotX, double pivotY)`	Prepends the 2D rotation with pivot to this instance.
`void`	`prependRotation(double angle, double pivotX, double pivotY, double pivotZ, double axisX, double axisY, double axisZ)`	Prepends the rotation to this instance.
`void`	`prependRotation(double angle, double pivotX, double pivotY, double pivotZ, Point3D axis)`	Prepends the rotation to this instance.
`void`	`prependRotation(double angle, Point2D pivot)`	Prepends the 2D rotation with pivot to this instance.
`void`	`prependRotation(double angle, Point3D pivot, Point3D axis)`	Prepends the rotation to this instance.
`void`	`prependScale(double sx, double sy)`	Prepends the 2D scale to this instance.
`void`	`prependScale(double sx, double sy, double sz)`	Prepends the scale to this instance.
`void`	`prependScale(double sx, double sy, double pivotX, double pivotY)`	Prepends the 2D scale with pivot to this instance.
`void`	`prependScale(double sx, double sy, double sz, double pivotX, double pivotY, double pivotZ)`	Prepends the scale with pivot to this instance.
`void`	`prependScale(double sx, double sy, double sz, Point3D pivot)`	Prepends the scale with pivot to this instance.
`void`	`prependScale(double sx, double sy, Point2D pivot)`	Prepends the 2D scale with pivot to this instance.
`void`	`prependShear(double shx, double shy)`	Prepends the shear to this instance.
`void`	`prependShear(double shx, double shy, double pivotX, double pivotY)`	Prepends the shear with pivot to this instance.
`void`	`prependShear(double shx, double shy, Point2D pivot)`	Prepends the shear with pivot to this instance.
`void`	`prependTranslation(double tx, double ty)`	Prepends the 2D translation to this instance.
`void`	`prependTranslation(double tx, double ty, double tz)`	Prepends the translation to this instance.
`void`	`setElement(MatrixType type, int row, int column, double value)`	Sets the specified element of the transformation matrix.
`final void`	`setMxx(double value)`	Sets the value of the `mxx` property.
`final void`	`setMxy(double value)`	Sets the value of the `mxy` property.
`final void`	`setMxz(double value)`	Sets the value of the `mxz` property.
`final void`	`setMyx(double value)`	Sets the value of the `myx` property.
`final void`	`setMyy(double value)`	Sets the value of the `myy` property.
`final void`	`setMyz(double value)`	Sets the value of the `myz` property.
`final void`	`setMzx(double value)`	Sets the value of the `mzx` property.
`final void`	`setMzy(double value)`	Sets the value of the `mzy` property.
`final void`	`setMzz(double value)`	Sets the value of the `mzz` property.
`void`	`setToIdentity()`	Resets this transform to the identity transform.
`void`	`setToTransform(double[] matrix, MatrixType type, int offset)`	Sets the values of this instance to the transformation matrix specified by an array.
`void`	`setToTransform(double mxx, double mxy, double tx, double myx, double myy, double ty)`	Sets the values of this instance to the 2D transform specified by the element values.
`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)`	Sets the values of this instance to the transform specified by the element values.
`void`	`setToTransform(Transform transform)`	Sets the values of this instance to the values provided by the specified transform.
`final void`	`setTx(double value)`	Sets the value of the `tx` property.
`final void`	`setTy(double value)`	Sets the value of the `ty` property.
`final void`	`setTz(double value)`	Sets the value of the `tz` property.
`String`	`toString()`	Returns a string representation of this `Affine` object.
`final DoubleProperty`	`txProperty()`	Defines the X coordinate translation element of the 3x4 matrix.
`final DoubleProperty`	`tyProperty()`	Defines the Y coordinate translation element of the 3x4 matrix.
`final DoubleProperty`	`tzProperty()`	Defines the Z coordinate translation element of the 3x4 matrix.

Methods declared in class javafx.scene.transform.Transform

addEventFilter, addEventHandler, affine, affine, buildEventDispatchChain, column, column, createConcatenation, deltaTransform, deltaTransform, deltaTransform, deltaTransform, determinant, getElement, getOnTransformChanged, identityProperty, inverseDeltaTransform, inverseDeltaTransform, inverseDeltaTransform, inverseDeltaTransform, inverseTransform, inverseTransform, inverseTransform, inverseTransform, inverseTransform, inverseTransform2DPoints, inverseTransform3DPoints, isIdentity, isType2D, onTransformChangedProperty, removeEventFilter, removeEventHandler, rotate, row, row, scale, scale, setOnTransformChanged, shear, shear, similarTo, toArray, toArray, transform, transform, transform, transform, transform, transform2DPoints, transform3DPoints, transformChanged, translate, type2DProperty

Methods declared in class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Property Details

mxx

public final DoubleProperty mxxProperty

Defines the X coordinate scaling element of the 3x4 matrix.

See Also:

mxy

public final DoubleProperty mxyProperty

Defines the XY coordinate element of the 3x4 matrix.

See Also:

mxz

public final DoubleProperty mxzProperty

Defines the XZ coordinate element of the 3x4 matrix.

See Also:

tx

public final DoubleProperty txProperty

Defines the X coordinate translation element of the 3x4 matrix.

See Also:

myx

public final DoubleProperty myxProperty

Defines the YX coordinate element of the 3x4 matrix.

See Also:

myy

public final DoubleProperty myyProperty

Defines the Y coordinate scaling element of the 3x4 matrix.

See Also:

myz

public final DoubleProperty myzProperty

Defines the YZ coordinate element of the 3x4 matrix.

See Also:

ty

public final DoubleProperty tyProperty

Defines the Y coordinate translation element of the 3x4 matrix.

See Also:

mzx

public final DoubleProperty mzxProperty

Defines the ZX coordinate element of the 3x4 matrix.

See Also:

mzy

public final DoubleProperty mzyProperty

Defines the ZY coordinate element of the 3x4 matrix.

See Also:

mzz

public final DoubleProperty mzzProperty

Defines the Z coordinate scaling element of the 3x4 matrix.

See Also:

tz

public final DoubleProperty tzProperty

Defines the Z coordinate translation element of the 3x4 matrix.

See Also:

Constructor Details

Affine

public Affine()

Creates a new instance of Affine containing an identity transform.

Affine

public Affine(Transform transform)

Creates a new instance of Affine filled with the values from the specified transform.

Parameters:: transform - transform whose matrix is to be filled to the new instance
Throws:: NullPointerException - if the specified transform is null
Since:: JavaFX 8.0

Affine

public Affine(double mxx, double mxy, double tx, double myx, double myy, double ty)

Creates a new instance of Affine with a 2D transform specified by the element values.

Parameters:: mxx - the X coordinate scaling element; mxy - the XY coordinate element; tx - the X coordinate translation element; myx - the YX coordinate element; myy - the Y coordinate scaling element; ty - the Y coordinate translation element
Since:: JavaFX 8.0

Affine

public Affine(double mxx, double mxy, double mxz, double tx, double myx, double myy, double myz, double ty, double mzx, double mzy, double mzz, double tz)

Creates a new instance of Affine with a transform specified by the element values.

Parameters:: mxx - the X coordinate scaling element; mxy - the XY coordinate element; mxz - the XZ coordinate element; tx - the X coordinate translation element; myx - the YX coordinate element; myy - the Y coordinate scaling element; myz - the YZ coordinate element; ty - the Y coordinate translation element; mzx - the ZX coordinate element; mzy - the ZY coordinate element; mzz - the Z coordinate scaling element; tz - the Z coordinate translation element
Since:: JavaFX 8.0

Affine

public Affine(double[] matrix, MatrixType type, int offset)

Creates a new instance of Affine with a transformation matrix specified by an array.

Parameters:: matrix - array containing the flattened transformation matrix; type - type of matrix contained in the array; offset - offset of the first element in the array
Throws:: IndexOutOfBoundsException - if the array is too short for the specified type and offset; IllegalArgumentException - if the specified matrix is not affine (the last line of a 2D 3x3 matrix is not [0, 0, 1] or the last line of a 3D 4x4 matrix is not [0, 0, 0, 1].; NullPointerException - if the specified matrix or type is null
Since:: JavaFX 8.0

Method Details

setMxx

public final void setMxx(double value)

Sets the value of the mxx property.

Property description:

Defines the X coordinate scaling element of the 3x4 matrix.

Parameters:

value - the value for the mxx property

See Also:

getMxx

public final double getMxx()

Gets the value of the mxx property.

Overrides:

getMxx in class Transform

Property description:

Defines the X coordinate scaling element of the 3x4 matrix.

Returns:

the value of the mxx property

See Also:

mxxProperty

public final DoubleProperty mxxProperty()

Defines the X coordinate scaling element of the 3x4 matrix.

Returns:

the mxx property

See Also:

setMxy

public final void setMxy(double value)

Sets the value of the mxy property.

Property description:

Defines the XY coordinate element of the 3x4 matrix.

Parameters:

value - the value for the mxy property

See Also:

getMxy

public final double getMxy()

Gets the value of the mxy property.

Overrides:

getMxy in class Transform

Property description:

Defines the XY coordinate element of the 3x4 matrix.

Returns:

the value of the mxy property

See Also:

mxyProperty

public final DoubleProperty mxyProperty()

Defines the XY coordinate element of the 3x4 matrix.

Returns:

the mxy property

See Also:

setMxz

public final void setMxz(double value)

Sets the value of the mxz property.

Property description:

Defines the XZ coordinate element of the 3x4 matrix.

Parameters:

value - the value for the mxz property

See Also:

getMxz

public final double getMxz()

Gets the value of the mxz property.

Overrides:

getMxz in class Transform

Property description:

Defines the XZ coordinate element of the 3x4 matrix.

Returns:

the value of the mxz property

See Also:

mxzProperty

public final DoubleProperty mxzProperty()

Defines the XZ coordinate element of the 3x4 matrix.

Returns:

the mxz property

See Also:

setTx

public final void setTx(double value)

Sets the value of the tx property.

Property description:

Defines the X coordinate translation element of the 3x4 matrix.

Parameters:

value - the value for the tx property

See Also:

getTx

public final double getTx()

Gets the value of the tx property.

Overrides:

getTx in class Transform

Property description:

Defines the X coordinate translation element of the 3x4 matrix.

Returns:

the value of the tx property

See Also:

txProperty

public final DoubleProperty txProperty()

Defines the X coordinate translation element of the 3x4 matrix.

Returns:

the tx property

See Also:

setMyx

public final void setMyx(double value)

Sets the value of the myx property.

Property description:

Defines the YX coordinate element of the 3x4 matrix.

Parameters:

value - the value for the myx property

See Also:

getMyx

public final double getMyx()

Gets the value of the myx property.

Overrides:

getMyx in class Transform

Property description:

Defines the YX coordinate element of the 3x4 matrix.

Returns:

the value of the myx property

See Also:

myxProperty

public final DoubleProperty myxProperty()

Defines the YX coordinate element of the 3x4 matrix.

Returns:

the myx property

See Also:

setMyy

public final void setMyy(double value)

Sets the value of the myy property.

Property description:

Defines the Y coordinate scaling element of the 3x4 matrix.

Parameters:

value - the value for the myy property

See Also:

getMyy

public final double getMyy()

Gets the value of the myy property.

Overrides:

getMyy in class Transform

Property description:

Defines the Y coordinate scaling element of the 3x4 matrix.

Returns:

the value of the myy property

See Also:

myyProperty

public final DoubleProperty myyProperty()

Defines the Y coordinate scaling element of the 3x4 matrix.

Returns:

the myy property

See Also:

setMyz

public final void setMyz(double value)

Sets the value of the myz property.

Property description:

Defines the YZ coordinate element of the 3x4 matrix.

Parameters:

value - the value for the myz property

See Also:

getMyz

public final double getMyz()

Gets the value of the myz property.

Overrides:

getMyz in class Transform

Property description:

Defines the YZ coordinate element of the 3x4 matrix.

Returns:

the value of the myz property

See Also:

myzProperty

public final DoubleProperty myzProperty()

Defines the YZ coordinate element of the 3x4 matrix.

Returns:

the myz property

See Also:

setTy

public final void setTy(double value)

Sets the value of the ty property.

Property description:

Defines the Y coordinate translation element of the 3x4 matrix.

Parameters:

value - the value for the ty property

See Also:

getTy

public final double getTy()

Gets the value of the ty property.

Overrides:

getTy in class Transform

Property description:

Defines the Y coordinate translation element of the 3x4 matrix.

Returns:

the value of the ty property

See Also:

tyProperty

public final DoubleProperty tyProperty()

Defines the Y coordinate translation element of the 3x4 matrix.

Returns:

the ty property

See Also:

setMzx

public final void setMzx(double value)

Sets the value of the mzx property.

Property description:

Defines the ZX coordinate element of the 3x4 matrix.

Parameters:

value - the value for the mzx property

See Also:

getMzx

public final double getMzx()

Gets the value of the mzx property.

Overrides:

getMzx in class Transform

Property description:

Defines the ZX coordinate element of the 3x4 matrix.

Returns:

the value of the mzx property

See Also:

mzxProperty

public final DoubleProperty mzxProperty()

Defines the ZX coordinate element of the 3x4 matrix.

Returns:

the mzx property

See Also:

setMzy

public final void setMzy(double value)

Sets the value of the mzy property.

Property description:

Defines the ZY coordinate element of the 3x4 matrix.

Parameters:

value - the value for the mzy property

See Also:

getMzy

public final double getMzy()

Gets the value of the mzy property.

Overrides:

getMzy in class Transform

Property description:

Defines the ZY coordinate element of the 3x4 matrix.

Returns:

the value of the mzy property

See Also:

mzyProperty

public final DoubleProperty mzyProperty()

Defines the ZY coordinate element of the 3x4 matrix.

Returns:

the mzy property

See Also:

setMzz

public final void setMzz(double value)

Sets the value of the mzz property.

Property description:

Defines the Z coordinate scaling element of the 3x4 matrix.

Parameters:

value - the value for the mzz property

See Also:

getMzz

public final double getMzz()

Gets the value of the mzz property.

Overrides:

getMzz in class Transform

Property description:

Defines the Z coordinate scaling element of the 3x4 matrix.

Returns:

the value of the mzz property

See Also:

mzzProperty

public final DoubleProperty mzzProperty()

Defines the Z coordinate scaling element of the 3x4 matrix.

Returns:

the mzz property

See Also:

setTz

public final void setTz(double value)

Sets the value of the tz property.

Property description:

Defines the Z coordinate translation element of the 3x4 matrix.

Parameters:

value - the value for the tz property

See Also:

getTz

public final double getTz()

Gets the value of the tz property.

Overrides:

getTz in class Transform

Property description:

Defines the Z coordinate translation element of the 3x4 matrix.

Returns:

the value of the tz property

See Also:

tzProperty

public final DoubleProperty tzProperty()

Defines the Z coordinate translation element of the 3x4 matrix.

Returns:

the tz property

See Also:

setElement

public void setElement(MatrixType type, int row, int column, double value)

Sets the specified element of the transformation matrix.

Parameters:: type - type of matrix to work with; row - zero-based row number; column - zero-based column number; value - new value of the specified transformation matrix element
Throws:: IndexOutOfBoundsException - if the indices are not within the specified matrix type; IllegalArgumentException - if setting the value would break transform's affinity (for convenience the method allows to set the elements of the last line of a 2D 3x3 matrix to [0, 0, 1] and the elements of the last line of a 3D 4x4 matrix to [0, 0, 0, 1]).; NullPointerException - if the specified type is null
Since:: JavaFX 8.0

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 Affine clone()

Description copied from class: Transform

Returns a deep copy of this transform.

Overrides:: clone in class Transform
Returns:: a copy of this transform

setToTransform

public void setToTransform(Transform transform)

Sets the values of this instance to the values provided by the specified transform.

Parameters:: transform - transform whose matrix is to be filled to this instance
Throws:: NullPointerException - if the specified transform is null
Since:: JavaFX 8.0

setToTransform

public void setToTransform(double mxx, double mxy, double tx, double myx, double myy, double ty)

Sets the values of this instance to the 2D transform specified by the element values.

Parameters:: mxx - the X coordinate scaling element; mxy - the XY coordinate element; tx - the X coordinate translation element; myx - the YX coordinate element; myy - the Y coordinate scaling element; ty - the Y coordinate translation element
Since:: JavaFX 8.0

setToTransform

public 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)

Sets the values of this instance to the transform specified by the element values.

Parameters:: mxx - the X coordinate scaling element; mxy - the XY coordinate element; mxz - the XZ coordinate element; tx - the X coordinate translation element; myx - the YX coordinate element; myy - the Y coordinate scaling element; myz - the YZ coordinate element; ty - the Y coordinate translation element; mzx - the ZX coordinate element; mzy - the ZY coordinate element; mzz - the Z coordinate scaling element; tz - the Z coordinate translation element
Since:: JavaFX 8.0

setToTransform

public void setToTransform(double[] matrix, MatrixType type, int offset)

Sets the values of this instance to the transformation matrix specified by an array.

Parameters:: matrix - array containing the flattened transformation matrix; type - type of matrix contained in the array; offset - offset of the first element in the array
Throws:: IndexOutOfBoundsException - if the array is too short for the specified type and offset; IllegalArgumentException - if the specified matrix is not affine (the last line of a 2D 3x3 matrix is not [0, 0, 1] or the last line of a 3D 4x4 matrix is not [0, 0, 0, 1].; NullPointerException - if the specified matrix or type is null
Since:: JavaFX 8.0

setToIdentity

public void setToIdentity()

Resets this transform to the identity transform.

Since:: JavaFX 8.0

invert

public void invert() throws NonInvertibleTransformException

Inverts this transform in place.

Throws:: NonInvertibleTransformException - if this transform cannot be inverted
Since:: JavaFX 8.0

append

public void append(Transform transform)

Appends the specified transform to this instance. The operation modifies this transform in a way that applying it to a node has the same effect as adding the two transforms to its getTransforms() list, this transform first and the specified transform second.

From the matrix point of view, the transformation matrix of this transform is multiplied on the right by the transformation matrix of the specified transform.

Parameters:: transform - transform to be appended to this instance
Throws:: NullPointerException - if the specified transform is null
Since:: JavaFX 8.0

append

public void append(double mxx, double mxy, double tx, double myx, double myy, double ty)

Appends the 2D transform specified by the element values to this instance. The operation modifies this transform in a way that applying it to a node has the same effect as adding the two transforms to its getTransforms() list, this transform first and the specified transform second.

From the matrix point of view, the transformation matrix of this transform is multiplied on the right by the transformation matrix of the specified transform.

Parameters:: mxx - the X coordinate scaling element of the transform to be appended; mxy - the XY coordinate element of the transform to be appended; tx - the X coordinate translation element of the transform to be appended; myx - the YX coordinate element of the transform to be appended; myy - the Y coordinate scaling element of the transform to be appended; ty - the Y coordinate translation element of the transform to be appended
Since:: JavaFX 8.0

append

public void append(double mxx, double mxy, double mxz, double tx, double myx, double myy, double myz, double ty, double mzx, double mzy, double mzz, double tz)

Appends the transform specified by the element values to this instance. The operation modifies this transform in a way that applying it to a node has the same effect as adding the two transforms to its getTransforms() list, this transform first and the specified transform second.

From the matrix point of view, the transformation matrix of this transform is multiplied on the right by the transformation matrix of the specified transform.

Parameters:: mxx - the X coordinate scaling element of the transform to be appended; mxy - the XY coordinate element of the transform to be appended; mxz - the XZ coordinate element of the transform to be appended; tx - the X coordinate translation element of the transform to be appended; myx - the YX coordinate element of the transform to be appended; myy - the Y coordinate scaling element of the transform to be appended; myz - the YZ coordinate element of the transform to be appended; ty - the Y coordinate translation element of the transform to be appended; mzx - the ZX coordinate element of the transform to be appended; mzy - the ZY coordinate element of the transform to be appended; mzz - the Z coordinate scaling element of the transform to be appended; tz - the Z coordinate translation element of the transform to be appended
Since:: JavaFX 8.0

append

public void append(double[] matrix, MatrixType type, int offset)

Appends the transform specified by the array to this instance. The operation modifies this transform in a way that applying it to a node has the same effect as adding the two transforms to its getTransforms() list, this transform first and the specified transform second.

From the matrix point of view, the transformation matrix of this transform is multiplied on the right by the transformation matrix of the specified transform.

Parameters:: matrix - array containing the flattened transformation matrix to be appended; type - type of matrix contained in the array; offset - offset of the first matrix element in the array
Throws:: IndexOutOfBoundsException - if the array is too short for the specified type and offset; IllegalArgumentException - if the specified matrix is not affine (the last line of a 2D 3x3 matrix is not [0, 0, 1] or the last line of a 3D 4x4 matrix is not [0, 0, 0, 1].; NullPointerException - if the specified matrix or type is null
Since:: JavaFX 8.0

prepend

public void prepend(Transform transform)

Prepends the specified transform to this instance. The operation modifies this transform in a way that applying it to a node has the same effect as adding the two transforms to its getTransforms() list, the specified transform first and this transform second.

From the matrix point of view, the transformation matrix of this transform is multiplied on the left by the transformation matrix of the specified transform.

Parameters:: transform - transform to be prepended to this instance
Throws:: NullPointerException - if the specified transform is null
Since:: JavaFX 8.0

prepend

public void prepend(double mxx, double mxy, double tx, double myx, double myy, double ty)

Prepends the 2D transform specified by the element values to this instance. The operation modifies this transform in a way that applying it to a node has the same effect as adding the two transforms to its getTransforms() list, the specified transform first and this transform second.

From the matrix point of view, the transformation matrix of this transform is multiplied on the left by the transformation matrix of the specified transform.

Parameters:: mxx - the X coordinate scaling element of the transform to be prepended; mxy - the XY coordinate element of the transform to be prepended; tx - the X coordinate translation element of the transform to be prepended; myx - the YX coordinate element of the transform to be prepended; myy - the Y coordinate scaling element of the transform to be prepended; ty - the Y coordinate translation element of the transform to be prepended
Since:: JavaFX 8.0

prepend

public void prepend(double mxx, double mxy, double mxz, double tx, double myx, double myy, double myz, double ty, double mzx, double mzy, double mzz, double tz)

Prepends the transform specified by the element values to this instance. The operation modifies this transform in a way that applying it to a node has the same effect as adding the two transforms to its getTransforms() list, the specified transform first and this transform second.

From the matrix point of view, the transformation matrix of this transform is multiplied on the left by the transformation matrix of the specified transform.

Parameters:: mxx - the X coordinate scaling element of the transform to be prepended; mxy - the XY coordinate element of the transform to be prepended; mxz - the XZ coordinate element of the transform to be prepended; tx - the X coordinate translation element of the transform to be prepended; myx - the YX coordinate element of the transform to be prepended; myy - the Y coordinate scaling element of the transform to be prepended; myz - the YZ coordinate element of the transform to be prepended; ty - the Y coordinate translation element of the transform to be prepended; mzx - the ZX coordinate element of the transform to be prepended; mzy - the ZY coordinate element of the transform to be prepended; mzz - the Z coordinate scaling element of the transform to be prepended; tz - the Z coordinate translation element of the transform to be prepended
Since:: JavaFX 8.0

prepend

public void prepend(double[] matrix, MatrixType type, int offset)

Prepends the transform specified by the array to this instance. The operation modifies this transform in a way that applying it to a node has the same effect as adding the two transforms to its getTransforms() list, the specified transform first and this transform second.

From the matrix point of view, the transformation matrix of this transform is multiplied on the left by the transformation matrix of the specified transform.

Parameters:: matrix - array containing the flattened transformation matrix to be prepended; type - type of matrix contained in the array; offset - offset of the first matrix element in the array
Throws:: IndexOutOfBoundsException - if the array is too short for the specified type and offset; IllegalArgumentException - if the specified matrix is not affine (the last line of a 2D 3x3 matrix is not [0, 0, 1] or the last line of a 3D 4x4 matrix is not [0, 0, 0, 1].; NullPointerException - if the specified matrix or type is null
Since:: JavaFX 8.0

appendTranslation

public void appendTranslation(double tx, double ty)

Appends the 2D translation to this instance. It is equivalent to append(new Translate(tx, ty)).

The operation modifies this transform in a way that applying it to a node has the same effect as adding two transforms to its getTransforms() list, this transform first and the specified translation second.

From the matrix point of view, the transformation matrix of this transform is multiplied on the right by the transformation matrix of the specified translation.

Parameters:: tx - the X coordinate translation; ty - the Y coordinate translation
Since:: JavaFX 8.0

appendTranslation

public void appendTranslation(double tx, double ty, double tz)

Appends the translation to this instance. It is equivalent to append(new Translate(tx, ty, tz)).

From the matrix point of view, the transformation matrix of this transform is multiplied on the right by the transformation matrix of the specified translation.

Parameters:: tx - the X coordinate translation; ty - the Y coordinate translation; tz - the Z coordinate translation
Since:: JavaFX 8.0

prependTranslation

public void prependTranslation(double tx, double ty, double tz)

Prepends the translation to this instance. It is equivalent to prepend(new Translate(tx, ty, tz)).

The operation modifies this transform in a way that applying it to a node has the same effect as adding two transforms to its getTransforms() list, the specified translation first and this transform second.

From the matrix point of view, the transformation matrix of this transform is multiplied on the left by the transformation matrix of the specified translation.

Parameters:: tx - the X coordinate translation; ty - the Y coordinate translation; tz - the Z coordinate translation
Since:: JavaFX 8.0

prependTranslation

public void prependTranslation(double tx, double ty)

Prepends the 2D translation to this instance. It is equivalent to prepend(new Translate(tx, ty)).

From the matrix point of view, the transformation matrix of this transform is multiplied on the left by the transformation matrix of the specified translation.

Parameters:: tx - the X coordinate translation; ty - the Y coordinate translation
Since:: JavaFX 8.0