java.lang.Object
javafx.scene.transform.Transform
javafx.scene.transform.Translate
- All Implemented Interfaces:
Cloneable
,EventTarget
public class Translate extends Transform
This class represents an
Affine
object that translates coordinates
by the specified factors. The matrix representing the translating
transformation by distances x
, y
and z
is as follows:
[ 1 0 0 x ] [ 0 1 0 y ] [ 0 0 1 z ]
- Since:
- JavaFX 2.0
-
Property Summary
Properties Type Property Description DoubleProperty
x
Defines the distance by which coordinates are translated in the X axis directionDoubleProperty
y
Defines the distance by which coordinates are translated in the Y axis directionDoubleProperty
z
Defines the distance by which coordinates are translated in the Z axis directionProperties inherited from class javafx.scene.transform.Transform
identity, onTransformChanged, type2D
-
Constructor Summary
-
Method Summary
Modifier and Type Method Description Translate
clone()
Returns a deep copy of this transform.Transform
createConcatenation(Transform transform)
Returns the concatenation of this transform and the specified transform.Translate
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.Point2D
deltaTransform(Point2D point)
Transforms the relative magnitude vector represented by the specifiedPoint2D
instance by this transform.Point3D
deltaTransform(Point3D point)
Transforms the relative magnitude vector represented by the specifiedPoint3D
instance by this transform.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()
Gets the value of the property x.double
getY()
Gets the value of the property y.double
getZ()
Gets the value of the property z.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
inverseDeltaTransform(Point2D point)
Transforms the relative magnitude vector represented by the specifiedPoint2D
instance by the inverse of this transform.Point3D
inverseDeltaTransform(Point3D point)
Transforms the relative magnitude vector represented by the specifiedPoint3D
instance 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.void
setX(double value)
Sets the value of the property x.void
setY(double value)
Sets the value of the property y.void
setZ(double value)
Sets the value of the property z.String
toString()
Returns a string representation of thisTranslate
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.DoubleProperty
xProperty()
Defines the distance by which coordinates are translated in the X axis directionDoubleProperty
yProperty()
Defines the distance by which coordinates are translated in the Y axis directionDoubleProperty
zProperty()
Defines the distance by which coordinates are translated in the Z axis directionMethods inherited from class javafx.scene.transform.Transform
addEventFilter, addEventHandler, affine, affine, buildEventDispatchChain, column, column, determinant, getElement, getMxx, getMxy, getMxz, getMyx, getMyy, getMyz, getMzx, getMzy, getMzz, getOnTransformChanged, identityProperty, 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
-
Property Details
-
x
Defines the distance by which coordinates are translated in the X axis direction- See Also:
getX()
,setX(double)
-
y
Defines the distance by which coordinates are translated in the Y axis direction- See Also:
getY()
,setY(double)
-
z
Defines the distance by which coordinates are translated in the Z axis direction- See Also:
getZ()
,setZ(double)
-
-
Constructor Details
-
Translate
public Translate()Creates a default Translate (identity). -
Translate
public Translate(double x, double y)Creates a two-dimensional Translate.- Parameters:
x
- the distance by which coordinates are translated in the X axis directiony
- the distance by which coordinates are translated in the Y axis direction
-
Translate
public Translate(double x, double y, double z)Creates a three-dimensional Translate.- Parameters:
x
- the distance by which coordinates are translated in the X axis directiony
- the distance by which coordinates are translated in the Y axis directionz
- the distance by which coordinates are translated in the Z axis direction
-
-
Method Details
-
setX
public final void setX(double value)Sets the value of the property x.- Property description:
- Defines the distance by which coordinates are translated in the X axis direction
-
getX
public final double getX()Gets the value of the property x.- Property description:
- Defines the distance by which coordinates are translated in the X axis direction
-
xProperty
Defines the distance by which coordinates are translated in the X axis direction- See Also:
getX()
,setX(double)
-
setY
public final void setY(double value)Sets the value of the property y.- Property description:
- Defines the distance by which coordinates are translated in the Y axis direction
-
getY
public final double getY()Gets the value of the property y.- Property description:
- Defines the distance by which coordinates are translated in the Y axis direction
-
yProperty
Defines the distance by which coordinates are translated in the Y axis direction- See Also:
getY()
,setY(double)
-
setZ
public final void setZ(double value)Sets the value of the property z.- Property description:
- Defines the distance by which coordinates are translated in the Z axis direction
-
getZ
public final double getZ()Gets the value of the property z.- Property description:
- Defines the distance by which coordinates are translated in the Z axis direction
-
zProperty
Defines the distance by which coordinates are translated in the Z axis direction- See Also:
getZ()
,setZ(double)
-
getTx
public double getTx()Description copied from class:Transform
Gets the X coordinate translation element of the 3x4 matrix. -
getTy
public double getTy()Description copied from class:Transform
Gets the Y coordinate translation element of the 3x4 matrix. -
getTz
public double getTz()Description copied from class:Transform
Gets the Z coordinate translation element of the 3x4 matrix. -
createConcatenation
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 itsgetTransforms()
list,this
transform first and the specifiedtransform
second.- Overrides:
createConcatenation
in classTransform
- Parameters:
transform
- transform to be concatenated with this transform- Returns:
- The concatenated transform
-
createInverse
Description copied from class:Transform
Returns the inverse transform of this transform.- Overrides:
createInverse
in classTransform
- Returns:
- the inverse transform
-
clone
Description copied from class:Transform
Returns a deep copy of this transform. -
transform
Description copied from class:Transform
Transforms the specified point by this transform. This method can be used only for 2D transforms. -
transform
Description copied from class:Transform
Transforms the specified point by this transform. -
deltaTransform
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 classTransform
- Parameters:
x
- vector magnitude in the direction of the X axisy
- vector magnitude in the direction of the Y axis- Returns:
- the transformed relative magnitude vector represented
by a
Point2D
instance
-
deltaTransform
Description copied from class:Transform
Transforms the relative magnitude vector represented by the specifiedPoint2D
instance 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 classTransform
- Parameters:
point
- the relative magnitude vector- Returns:
- the transformed relative magnitude vector represented
by a
Point2D
instance
-
deltaTransform
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 classTransform
- Parameters:
x
- vector magnitude in the direction of the X axisy
- vector magnitude in the direction of the Y axisz
- vector magnitude in the direction of the Z axis- Returns:
- the transformed relative magnitude vector represented
by a
Point3D
instance
-
deltaTransform
Description copied from class:Transform
Transforms the relative magnitude vector represented by the specifiedPoint3D
instance by this transform. The vector is transformed without applying the translation components of the affine transformation matrix.- Overrides:
deltaTransform
in classTransform
- Parameters:
point
- the relative magnitude vector- Returns:
- the transformed relative magnitude vector represented
by a
Point3D
instance
-
inverseTransform
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 classTransform
- Parameters:
x
- the X coordinate of the pointy
- the Y coordinate of the point- Returns:
- the inversely transformed point
-
inverseTransform
Description copied from class:Transform
Transforms the specified point by the inverse of this transform.- Overrides:
inverseTransform
in classTransform
- Parameters:
x
- the X coordinate of the pointy
- the Y coordinate of the pointz
- the Z coordinate of the point- Returns:
- the inversely transformed point
-
inverseDeltaTransform
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 classTransform
- Parameters:
x
- vector magnitude in the direction of the X axisy
- vector magnitude in the direction of the Y axis- Returns:
- the inversely transformed relative magnitude vector represented
by a
Point2D
instance
-
inverseDeltaTransform
Description copied from class:Transform
Transforms the relative magnitude vector represented by the specifiedPoint2D
instance 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 classTransform
- Parameters:
point
- the relative magnitude vector- Returns:
- the inversely transformed relative magnitude vector represented
by a
Point2D
instance
-
inverseDeltaTransform
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 classTransform
- Parameters:
x
- vector magnitude in the direction of the X axisy
- vector magnitude in the direction of the Y axisz
- vector magnitude in the direction of the Z axis- Returns:
- the inversely transformed relative magnitude vector represented
by a
Point3D
instance
-
inverseDeltaTransform
Description copied from class:Transform
Transforms the relative magnitude vector represented by the specifiedPoint3D
instance by the inverse of this transform. The vector is transformed without applying the translation components of the affine transformation matrix.- Overrides:
inverseDeltaTransform
in classTransform
- Parameters:
point
- the relative magnitude vector- Returns:
- the inversely transformed relative magnitude vector represented
by a
Point3D
instance
-
toString
Returns a string representation of thisTranslate
object.
-