java.lang.Object
javafx.scene.transform.Transform
javafx.scene.transform.Scale
- All Implemented Interfaces:
Cloneable
,EventTarget
This class represents an
Affine
object that scales coordinates
by the specified factors. The matrix representing the scaling transformation
around a pivot point (pivotX, pivotY, pivotZ)
with scaling factors
x
, y
and z
is as follows:
[ x 0 0 (1-x)*pivotX ] [ 0 y 0 (1-y)*pivotY ] [ 0 0 z (1-z)*pivotZ ]
- Since:
- JavaFX 2.0
-
Property Summary
TypePropertyDescriptionfinal DoubleProperty
Defines the X coordinate about which point the scale occurs.final DoubleProperty
Defines the Y coordinate about which point the scale occurs.final DoubleProperty
Defines the Z coordinate about which point the scale occurs.final DoubleProperty
Defines the factor by which coordinates are scaled along the X axis direction.final DoubleProperty
Defines the factor by which coordinates are scaled along the Y axis direction.final DoubleProperty
Defines the factor by which coordinates are scaled along the Z axis direction.Properties declared in class javafx.scene.transform.Transform
identity, onTransformChanged, type2D
-
Constructor Summary
ConstructorDescriptionScale()
Creates a default Scale (identity).Scale
(double x, double y) Creates a two-dimensional Scale.Scale
(double x, double y, double z) Creates a three-dimensional Scale.Scale
(double x, double y, double pivotX, double pivotY) Creates a two-dimensional Scale with pivot.Scale
(double x, double y, double z, double pivotX, double pivotY, double pivotZ) Creates a three-dimensional Scale with pivot. -
Method Summary
Modifier and TypeMethodDescriptionclone()
Returns a deep copy of this transform.Returns the inverse transform of this transform.final double
Gets the value of thepivotX
property.final double
Gets the value of thepivotY
property.final double
Gets the value of thepivotZ
property.final double
getX()
Gets the value of thex
property.final double
getY()
Gets the value of they
property.final double
getZ()
Gets the value of thez
property.final DoubleProperty
Defines the X coordinate about which point the scale occurs.final DoubleProperty
Defines the Y coordinate about which point the scale occurs.final DoubleProperty
Defines the Z coordinate about which point the scale occurs.final void
setPivotX
(double value) Sets the value of thepivotX
property.final void
setPivotY
(double value) Sets the value of thepivotY
property.final void
setPivotZ
(double value) Sets the value of thepivotZ
property.final void
setX
(double value) Sets the value of thex
property.final void
setY
(double value) Sets the value of they
property.final void
setZ
(double value) Sets the value of thez
property.toString()
Returns a string representation of thisScale
object.final DoubleProperty
Defines the factor by which coordinates are scaled along the X axis direction.final DoubleProperty
Defines the factor by which coordinates are scaled along the Y axis direction.final DoubleProperty
Defines the factor by which coordinates are scaled along the Z axis direction.Methods declared in class javafx.scene.transform.Transform
addEventFilter, addEventHandler, affine, affine, buildEventDispatchChain, column, column, createConcatenation, deltaTransform, deltaTransform, deltaTransform, deltaTransform, determinant, getElement, getMxx, getMxy, getMxz, getMyx, getMyy, getMyz, getMzx, getMzy, getMzz, getOnTransformChanged, getTx, getTy, getTz, 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
-
Property Details
-
x
Defines the factor by which coordinates are scaled along the X axis direction. The default value is1.0
.- See Also:
-
y
Defines the factor by which coordinates are scaled along the Y axis direction. The default value is1.0
.- See Also:
-
z
Defines the factor by which coordinates are scaled along the Z axis direction. The default value is1.0
.- See Also:
-
pivotX
Defines the X coordinate about which point the scale occurs.- Default value:
- 0.0
- See Also:
-
pivotY
Defines the Y coordinate about which point the scale occurs.- Default value:
- 0.0
- See Also:
-
pivotZ
Defines the Z coordinate about which point the scale occurs.- Default value:
- 0.0
- See Also:
-
-
Constructor Details
-
Scale
public Scale()Creates a default Scale (identity). -
Scale
public Scale(double x, double y) Creates a two-dimensional Scale. The pivot point is set to (0,0)- Parameters:
x
- the factor by which coordinates are scaled along the X axisy
- the factor by which coordinates are scaled along the Y axis
-
Scale
public Scale(double x, double y, double pivotX, double pivotY) Creates a two-dimensional Scale with pivot.- Parameters:
x
- the factor by which coordinates are scaled along the X axisy
- the factor by which coordinates are scaled along the Y axispivotX
- the X coordinate about which point the scale occurspivotY
- the Y coordinate about which point the scale occurs
-
Scale
public Scale(double x, double y, double z) Creates a three-dimensional Scale. The pivot point is set to (0,0,0)- Parameters:
x
- the factor by which coordinates are scaled along the X axisy
- the factor by which coordinates are scaled along the Y axisz
- the factor by which coordinates are scaled along the Z axis
-
Scale
public Scale(double x, double y, double z, double pivotX, double pivotY, double pivotZ) Creates a three-dimensional Scale with pivot.- Parameters:
x
- the factor by which coordinates are scaled along the X axisy
- the factor by which coordinates are scaled along the Y axisz
- the factor by which coordinates are scaled along the Z axispivotX
- the X coordinate about which point the scale occurspivotY
- the Y coordinate about which point the scale occurspivotZ
- the Z coordinate about which point the scale occurs
-
-
Method Details
-
setX
public final void setX(double value) Sets the value of thex
property.- Property description:
- Defines the factor by which coordinates are scaled
along the X axis direction. The default value is
1.0
. - Parameters:
value
- the value for thex
property- See Also:
-
getX
public final double getX()Gets the value of thex
property.- Property description:
- Defines the factor by which coordinates are scaled
along the X axis direction. The default value is
1.0
. - Returns:
- the value of the
x
property - See Also:
-
xProperty
Defines the factor by which coordinates are scaled along the X axis direction. The default value is1.0
.- Returns:
- the
x
property - See Also:
-
setY
public final void setY(double value) Sets the value of they
property.- Property description:
- Defines the factor by which coordinates are scaled
along the Y axis direction. The default value is
1.0
. - Parameters:
value
- the value for they
property- See Also:
-
getY
public final double getY()Gets the value of they
property.- Property description:
- Defines the factor by which coordinates are scaled
along the Y axis direction. The default value is
1.0
. - Returns:
- the value of the
y
property - See Also:
-
yProperty
Defines the factor by which coordinates are scaled along the Y axis direction. The default value is1.0
.- Returns:
- the
y
property - See Also:
-
setZ
public final void setZ(double value) Sets the value of thez
property.- Property description:
- Defines the factor by which coordinates are scaled
along the Z axis direction. The default value is
1.0
. - Parameters:
value
- the value for thez
property- See Also:
-
getZ
public final double getZ()Gets the value of thez
property.- Property description:
- Defines the factor by which coordinates are scaled
along the Z axis direction. The default value is
1.0
. - Returns:
- the value of the
z
property - See Also:
-
zProperty
Defines the factor by which coordinates are scaled along the Z axis direction. The default value is1.0
.- Returns:
- the
z
property - See Also:
-
setPivotX
public final void setPivotX(double value) Sets the value of thepivotX
property.- Property description:
- Defines the X coordinate about which point the scale occurs.
- Default value:
- 0.0
- Parameters:
value
- the value for thepivotX
property- See Also:
-
getPivotX
public final double getPivotX()Gets the value of thepivotX
property.- Property description:
- Defines the X coordinate about which point the scale occurs.
- Default value:
- 0.0
- Returns:
- the value of the
pivotX
property - See Also:
-
pivotXProperty
Defines the X coordinate about which point the scale occurs.- Default value:
- 0.0
- Returns:
- the
pivotX
property - See Also:
-
setPivotY
public final void setPivotY(double value) Sets the value of thepivotY
property.- Property description:
- Defines the Y coordinate about which point the scale occurs.
- Default value:
- 0.0
- Parameters:
value
- the value for thepivotY
property- See Also:
-
getPivotY
public final double getPivotY()Gets the value of thepivotY
property.- Property description:
- Defines the Y coordinate about which point the scale occurs.
- Default value:
- 0.0
- Returns:
- the value of the
pivotY
property - See Also:
-
pivotYProperty
Defines the Y coordinate about which point the scale occurs.- Default value:
- 0.0
- Returns:
- the
pivotY
property - See Also:
-
setPivotZ
public final void setPivotZ(double value) Sets the value of thepivotZ
property.- Property description:
- Defines the Z coordinate about which point the scale occurs.
- Default value:
- 0.0
- Parameters:
value
- the value for thepivotZ
property- See Also:
-
getPivotZ
public final double getPivotZ()Gets the value of thepivotZ
property.- Property description:
- Defines the Z coordinate about which point the scale occurs.
- Default value:
- 0.0
- Returns:
- the value of the
pivotZ
property - See Also:
-
pivotZProperty
Defines the Z coordinate about which point the scale occurs.- Default value:
- 0.0
- Returns:
- the
pivotZ
property - See Also:
-
createInverse
Description copied from class:Transform
Returns the inverse transform of this transform.- Overrides:
createInverse
in classTransform
- Returns:
- the inverse transform
- Throws:
NonInvertibleTransformException
- if this transform cannot be inverted
-
clone
Description copied from class:Transform
Returns a deep copy of this transform. -
toString
Returns a string representation of thisScale
object.
-