Module javafx.graphics

软件包 javafx.scene.transform

Class Scale

java.lang.Object

javafx.scene.transform.Transform

javafx.scene.transform.Scale

All Implemented Interfaces:

Cloneable ， EventTarget

public class Scale
extends Transform

此类表示一个Affine对象，可根据指定的因素缩放坐标。 表示缩放变换的矩阵如下：

  [ x   0   0   (1-x)*pivotX ]
              [ 0   y   0   (1-y)*pivotY ]
              [ 0   0   z   (1-z)*pivotZ ] 

从以下版本开始：

JavaFX 2.0

Property Summary

Properties

Type	Property	描述
DoubleProperty	pivotX	定义刻度出现点的X坐标。
DoubleProperty	pivotY	定义关于刻度出现点的Y坐标。
DoubleProperty	pivotZ	定义刻度出现点的Z坐标。
DoubleProperty	x	定义坐标沿X轴方向缩放的因子。
DoubleProperty	y	定义坐标沿Y轴方向缩放的因子。
DoubleProperty	z	定义坐标沿Z轴方向缩放的因子。

Properties inherited from class javafx.scene.transform.Transform

identity, onTransformChanged, type2D

构造方法摘要

构造方法

Constructor	描述
Scale()	创建一个默认的Scale（标识）。
Scale(double x, double y)	创建二维刻度。
Scale(double x, double y, double z)	创建一个三维刻度。
Scale(double x, double y, double pivotX, double pivotY)	用枢轴创建二维刻度。
Scale(double x, double y, double z, double pivotX, double pivotY, double pivotZ)	用枢轴创建三维刻度。

方法摘要

Modifier and Type	方法	描述
Scale	clone()	返回此转换的深层副本。
Transform	createConcatenation(Transform transform)	返回此变换和指定变换的并置。
Scale	createInverse()	返回此变换的逆变换。
Point2D	deltaTransform(double x, double y)	通过该变换来变换相对幅度矢量。
Point3D	deltaTransform(double x, double y, double z)	通过该变换来变换相对幅度矢量。
double	getMxx()	获取3x4矩阵的X坐标缩放元素。
double	getMyy()	获取3x4矩阵的Y坐标缩放元素。
double	getMzz()	获取3x4矩阵的Z坐标缩放元素。
double	getPivotX()	获取属性pivotX的值。
double	getPivotY()	获取属性pivotY的值。
double	getPivotZ()	获取属性pivotZ的值。
double	getTx()	获取3x4矩阵的X坐标转换元素。
double	getTy()	获取3x4矩阵的Y坐标转换元素。
double	getTz()	获取3x4矩阵的Z坐标转换元素。
double	getX()	获取属性x的值。
double	getY()	获取属性y的值。
double	getZ()	获取属性z的值。
Point2D	inverseDeltaTransform(double x, double y)	通过该变换的逆变换相对幅度矢量。
Point3D	inverseDeltaTransform(double x, double y, double z)	通过该变换的逆变换相对幅度矢量。
Point2D	inverseTransform(double x, double y)	通过该变换的逆变换指定点。
Point3D	inverseTransform(double x, double y, double z)	通过该变换的逆变换指定点。
DoubleProperty	pivotXProperty()	定义刻度出现点的X坐标。
DoubleProperty	pivotYProperty()	定义关于刻度出现点的Y坐标。
DoubleProperty	pivotZProperty()	定义刻度出现点的Z坐标。
void	setPivotX(double value)	设置属性pivotX的值。
void	setPivotY(double value)	设置属性pivotY的值。
void	setPivotZ(double value)	设置属性pivotZ的值。
void	setX(double value)	设置属性x的值。
void	setY(double value)	设置属性y的值。
void	setZ(double value)	设置属性z的值。
String	toString()	返回此 Scale对象的字符串表示形式。
Point2D	transform(double x, double y)	通过此转换来转换指定的点。
Point3D	transform(double x, double y, double z)	通过此转换来转换指定的点。
DoubleProperty	xProperty()	定义坐标沿X轴方向缩放的因子。
DoubleProperty	yProperty()	定义坐标沿Y轴方向缩放的因子。
DoubleProperty	zProperty()	定义坐标沿Z轴方向缩放的因子。

Methods inherited from class java.lang.Object

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

Methods inherited from class javafx.scene.transform.Transform

addEventFilter, addEventHandler, affine, affine, buildEventDispatchChain, column, column, deltaTransform, deltaTransform, determinant, getElement, getMxy, getMxz, getMyx, getMyz, getMzx, getMzy, getOnTransformChanged, identityProperty, inverseDeltaTransform, inverseDeltaTransform, 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 Detail

x

public final DoubleProperty xProperty

定义坐标沿X轴方向缩放的因子。 默认值为1.0 。

另请参见：

getX() ， setX(double)

y

public final DoubleProperty yProperty

定义坐标沿Y轴方向缩放的因子。 默认值为1.0 。

另请参见：

getY() ， setY(double)

z

public final DoubleProperty zProperty

定义坐标沿Z轴方向缩放的因子。 默认值为1.0 。

另请参见：

getZ() ， setZ(double)

pivotX

public final DoubleProperty pivotXProperty

定义刻度出现点的X坐标。

Default value:

0.0

另请参见：

getPivotX() ， setPivotX(double)

pivotY

public final DoubleProperty pivotYProperty

定义关于刻度出现点的Y坐标。

Default value:

0.0

另请参见：

getPivotY() ， setPivotY(double)

pivotZ

public final DoubleProperty pivotZProperty

定义刻度出现点的Z坐标。

Default value:

0.0

另请参见：

getPivotZ() ， setPivotZ(double)

构造方法详细信息

Scale

public Scale()

创建一个默认的Scale（标识）。

Scale

public Scale(double x,
             double y)

创建二维刻度。 枢轴点设置为（0,0）

参数

x - 坐标沿X轴缩放的因子

y - 坐标沿Y轴缩放的因子

Scale

public Scale(double x,
             double y,
             double pivotX,
             double pivotY)

用枢轴创建二维刻度。

参数

x - 坐标沿X轴缩放的因子

y - 坐标沿Y轴缩放的因子

pivotX - 刻度出现点的X坐标

pivotY - 关于刻度 pivotY的Y坐标

Scale

public Scale(double x,
             double y,
             double z)

创建一个三维刻度。 枢轴点设置为（0,0,0）

参数

x - 坐标沿X轴缩放的因子

y - 坐标沿Y轴缩放的因子

z - 坐标沿Z轴缩放的因子

Scale

public Scale(double x,
             double y,
             double z,
             double pivotX,
             double pivotY,
             double pivotZ)

用枢轴创建三维刻度。

参数

x - 坐标沿X轴缩放的因子

y - 坐标沿着Y轴缩放的因子

z - 坐标沿Z轴缩放的因子

pivotX - 刻度出现点的X坐标

pivotY - 关于刻度 pivotY的Y坐标

pivotZ - 刻度出现点的Z坐标

方法详细信息

setX

public final void setX(double value)

设置属性x的值。

Property description:

定义坐标沿X轴方向缩放的因子。 默认值为1.0 。

getX

public final double getX()

获取属性x的值。

Property description:

定义坐标沿X轴方向缩放的因子。 默认值为1.0 。

xProperty

public final DoubleProperty xProperty()

定义坐标沿X轴方向缩放的因子。 默认值为1.0 。

另请参见：

getX() ， setX(double)

setY

public final void setY(double value)

设置属性y的值。

Property description:

定义坐标沿Y轴方向缩放的因子。 默认值为1.0 。

getY

public final double getY()

获取属性y的值。

Property description:

定义坐标沿Y轴方向缩放的因子。 默认值为1.0 。

yProperty

public final DoubleProperty yProperty()

定义坐标沿Y轴方向缩放的因子。 默认值为1.0 。

另请参见：

getY() ， setY(double)

setZ

public final void setZ(double value)

设置属性z的值。

Property description:

定义坐标沿Z轴方向缩放的因子。 默认值为1.0 。

getZ

public final double getZ()

获取属性z的值。

Property description:

定义坐标沿Z轴方向缩放的因子。 默认值为1.0 。

zProperty

public final DoubleProperty zProperty()

定义坐标沿Z轴方向缩放的因子。 默认值为1.0 。

另请参见：

getZ() ， setZ(double)

setPivotX

public final void setPivotX(double value)

设置属性pivotX的值。

Property description:

定义刻度出现点的X坐标。

Default value:

0.0

getPivotX

public final double getPivotX()

获取属性pivotX的值。

Property description:

定义刻度出现点的X坐标。

Default value:

0.0

pivotXProperty

public final DoubleProperty pivotXProperty()

定义刻度出现点的X坐标。

Default value:

0.0

另请参见：

getPivotX() ， setPivotX(double)

setPivotY

public final void setPivotY(double value)

设置属性pivotY的值。

Property description:

定义关于刻度出现点的Y坐标。

Default value:

0.0

getPivotY

public final double getPivotY()

获取属性pivotY的值。

Property description:

定义关于刻度出现点的Y坐标。

Default value:

0.0

pivotYProperty

public final DoubleProperty pivotYProperty()

定义关于刻度出现点的Y坐标。

Default value:

0.0

另请参见：

getPivotY() ， setPivotY(double)

setPivotZ

public final void setPivotZ(double value)

设置属性pivotZ的值。

Property description:

定义刻度出现点的Z坐标。

Default value:

0.0

getPivotZ

public final double getPivotZ()

获取属性pivotZ的值。

Property description:

定义刻度出现点的Z坐标。

Default value:

0.0

pivotZProperty

public final DoubleProperty pivotZProperty()

定义刻度出现点的Z坐标。

Default value:

0.0

另请参见：

getPivotZ() ， setPivotZ(double)

getMxx

public double getMxx()

描述从类复制： Transform

获取3x4矩阵的X坐标缩放元素。

重写：

getMxx在 Transform

结果

3x4矩阵的X坐标缩放元素

getMyy

public double getMyy()

描述从类复制： Transform

获取3x4矩阵的Y坐标缩放元素。

重写：

getMyy在 Transform

结果

3×4矩阵的Y坐标缩放元素

getMzz

public double getMzz()

描述从类复制： Transform

获取3x4矩阵的Z坐标缩放元素。

重写：

getMzz在 Transform

结果

3x4矩阵的Z坐标缩放元素

getTx

public double getTx()

描述从类复制： Transform

获取3x4矩阵的X坐标转换元素。

重写：

getTx在 Transform

结果

3x4矩阵的X坐标转换元素

getTy

public double getTy()

描述从类复制： Transform

获取3x4矩阵的Y坐标转换元素。

重写：

getTy在 Transform

结果

3×4矩阵的Y坐标转换元素

getTz

public double getTz()

描述从类复制： Transform

获取3x4矩阵的Z坐标转换元素。

重写：

getTz在 Transform

结果

3×4矩阵的Z坐标转换元素

createConcatenation

public Transform createConcatenation(Transform transform)

描述从类复制： Transform

返回此变换和指定变换的并置。 将结果变换应用到一个节点具有相同的效果，将两个变换添加到其getTransforms()列表中， this第一次转换和指定的transform秒。

重写：

createConcatenation在 Transform

参数

transform - 转换为与此变换连接

结果

连接变换

createInverse

public Scale createInverse()
                    throws NonInvertibleTransformException

描述从类复制： Transform

返回此变换的逆变换。

重写：

createInverse在 Transform

结果

逆变换

异常

NonInvertibleTransformException - 如果这个变换不能被反转

clone

public Scale clone()

描述从类别复制： Transform

返回此转换的深层副本。

重写：

clone在 Transform

结果

这个转换的副本

另请参见：

Cloneable

transform

public Point2D transform(double x,
                         double y)

描述从类复制： Transform

通过此转换来转换指定的点。 该方法只能用于2D变换。

重写：

transform在 Transform

参数

x - 点的X坐标

y - 点的Y坐标

结果

转化点

transform

public Point3D transform(double x,
                         double y,
                         double z)

说明从类别复制： Transform

通过此转换来转换指定的点。

重写：

transform在 Transform

参数

x - 点的X坐标

y - 点的Y坐标

z - 点的Z坐标

结果

转化点

deltaTransform

public Point2D deltaTransform(double x,
                              double y)

描述从类复制： Transform

通过该变换来变换相对幅度矢量。 在不应用仿射变换矩阵的平移分量的情况下变换矢量。 该方法只能用于2D变换。

重写：

deltaTransform在 Transform

参数

x - 在X轴方向的向量幅度

y - 矢量在Y轴方向的幅度

结果

由 Point2D实例表示的变换后的相对幅度向量

deltaTransform

public Point3D deltaTransform(double x,
                              double y,
                              double z)

描述从类复制： Transform

通过该变换来变换相对幅度矢量。 在不应用仿射变换矩阵的平移分量的情况下变换矢量。

重写：

deltaTransform在 Transform

参数

x - 矢量在X轴方向的幅度

y - 矢量在Y轴方向的幅度

z - 矢量在Z轴方向的幅度

结果

由 Point3D实例表示的变换后的相对幅度向量

inverseTransform

public Point2D inverseTransform(double x,
                                double y)
                         throws NonInvertibleTransformException

描述从类复制： Transform

通过该变换的逆变换指定点。 该方法只能用于2D变换。

重写：

inverseTransform在 Transform

参数

x - 点的X坐标

y - 点的Y坐标

结果

逆转点

异常

NonInvertibleTransformException - 如果这个变换不能被反转

inverseTransform

public Point3D inverseTransform(double x,
                                double y,
                                double z)
                         throws NonInvertibleTransformException

描述从类复制： Transform

通过该变换的逆变换指定点。

重写：

inverseTransform在 Transform

参数

x - 点的X坐标

y - 点的Y坐标

z - 点的Z坐标

结果

逆转点

异常

NonInvertibleTransformException - 如果这个变换不能被反转

inverseDeltaTransform

public Point2D inverseDeltaTransform(double x,
                                     double y)
                              throws NonInvertibleTransformException

描述从类复制： Transform

通过该变换的逆变换相对幅度矢量。 在不应用仿射变换矩阵的平移分量的情况下变换矢量。 该方法只能用于2D变换。

重写：

inverseDeltaTransform在 Transform

参数

x - 在X轴方向的向量幅度

y - 矢量在Y轴方向的幅度

结果

由 Point2D实例表示的逆变换相对幅度向量

异常

NonInvertibleTransformException - 如果这个变换不能被反转

inverseDeltaTransform

public Point3D inverseDeltaTransform(double x,
                                     double y,
                                     double z)
                              throws NonInvertibleTransformException

描述从类复制： Transform

通过该变换的逆变换相对幅度矢量。 在不应用仿射变换矩阵的平移分量的情况下变换矢量。

重写：

inverseDeltaTransform在 Transform

参数

x - 在X轴方向的向量幅度

y - 矢量在Y轴方向的幅度

z - 矢量在Z轴方向的幅度

结果

由 Point3D实例表示的逆变换相对幅度向量

异常

NonInvertibleTransformException - 如果这个变换不能被反转

toString

public String toString()

返回此 Scale对象的字符串表示形式。

重写：

toString在 Object

结果

这个 Scale对象的字符串表示形式。