diff --git a/zh-cn/application-dev/reference/apis/js-apis-curve.md b/zh-cn/application-dev/reference/apis/js-apis-curve.md index f3892ab6da6ca22906ad5e02042b358c7cb2d179..7192a34192bf3f136a9043e7837e848eb06c754e 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-curve.md +++ b/zh-cn/application-dev/reference/apis/js-apis-curve.md @@ -35,7 +35,6 @@ initCurve(curve?: Curve)：ICurve | ---------------------------------- | ---------------- | | [ICurve](#icurve) | 曲线的插值对象。 | - **示例：** ```ts @@ -57,7 +56,7 @@ stepsCurve(count: number, end: boolean)：ICurve | 参数名 | 类型 | 必填 | 说明 | | ------ | ------- | ----| ------------------------------------------------------------ | -| count | number | 是 | 阶梯的数量，需要为正整数。 | +| count | number | 是 | 阶梯的数量，需要为正整数，取值范围为[0, +∞)。
**说明：**
设置小于0的值时，按值为0处理。 | | end | boolean | 是 | 在每个间隔的起点或是终点发生阶跃变化。
-true：在终点发生阶跃变化。
-false：在起点发生阶跃变化。 | **返回值：** @@ -66,7 +65,6 @@ stepsCurve(count: number, end: boolean)：ICurve | ---------------------------------- | ---------------- | | [ICurve](#icurve) | 曲线的插值对象。 | - **示例：** ```ts @@ -85,12 +83,13 @@ cubicBezierCurve(x1: number, y1: number, x2: number, y2: number)：ICurve **系统能力：** SystemCapability.ArkUI.ArkUI.Full **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| ---- | ------ | ---- | -------------- | -| x1 | number | 是 | 确定贝塞尔曲线第一点横坐标。 | -| y1 | number | 是 | 确定贝塞尔曲线第一点纵坐标。 | -| x2 | number | 是 | 确定贝塞尔曲线第二点横坐标。 | -| y2 | number | 是 | 确定贝塞尔曲线第二点纵坐标。 | + +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | ------------------------------------------------------------ | +| x1 | number | 是 | 确定贝塞尔曲线第一点横坐标，取值范围[0, 1]。
**说明：**
设置的值小于0时，按0处理；设置的值大于1时，按1处理。 | +| y1 | number | 是 | 确定贝塞尔曲线第一点纵坐标，取值范围(-∞, +∞)。 | +| x2 | number | 是 | 确定贝塞尔曲线第二点横坐标。，取值范围[0, 1]。
**说明：**
设置的值小于0时，按0处理；设置的值大于1时，按1处理。 | +| y2 | number | 是 | 确定贝塞尔曲线第二点纵坐标，取值范围(-∞, +∞)。 | **返回值：** @@ -117,12 +116,12 @@ springCurve(velocity: number, mass: number, stiffness: number, damping: number) **系统能力：** SystemCapability.ArkUI.ArkUI.Full **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| --------- | ------ | ---- | ----- | -| velocity | number | 是 | 初始速度。是由外部因素对弹性动效产生的影响参数，其目的是保证对象从之前的运动状态平滑的过渡到弹性动效。 | -| mass | number | 是 | 质量。弹性系统的受力对象，会对弹性系统产生惯性影响。质量越大，震荡的幅度越大，恢复到平衡位置的速度越慢。 | -| stiffness | number | 是 | 刚度。是物体抵抗施加的力而形变的程度。在弹性系统中，刚度越大，抵抗变形的能力越强，恢复到平衡位置的速度就越快。 | -| damping | number | 是 | 阻尼。是一个纯数，无真实的物理意义，用于描述系统在受到扰动后震荡及衰减的情形。阻尼越大，弹性运动的震荡次数越少、震荡幅度越小。 | +| 参数名 | 类型 | 必填 | 说明 | +| --------- | ------ | ---- | ------------------------------------------------------------ | +| velocity | number | 是 | 初始速度。是由外部因素对弹性动效产生的影响参数，其目的是保证对象从之前的运动状态平滑的过渡到弹性动效，取值范围(-∞, +∞)。 | +| mass | number | 是 | 质量。弹性系统的受力对象，会对弹性系统产生惯性影响。质量越大，震荡的幅度越大，恢复到平衡位置的速度越慢，取值范围(0, +∞)。
**说明：**
设置的值小于0时，按1处理。 | +| stiffness | number | 是 | 刚度。是物体抵抗施加的力而形变的程度。在弹性系统中，刚度越大，抵抗变形的能力越强，恢复到平衡位置的速度就越快，取值范围(0, +∞)。
**说明：**
设置的值小于0时，按1处理。。 | +| damping | number | 是 | 阻尼。是一个纯数，无真实的物理意义，用于描述系统在受到扰动后震荡及衰减的情形。阻尼越大，弹性运动的震荡次数越少、震荡幅度越小，取值范围(0, +∞)。
**说明：**
设置的值小于0时，按1处理。。 | **返回值：** @@ -149,11 +148,12 @@ springMotion(response?: number, dampingFraction?: number, overlapDuration?: numb **系统能力：** SystemCapability.ArkUI.ArkUI.Full **参数：** + | 参数名 | 类型 | 必填 | 说明 | | --------- | ------ | ---- | ----- | -| response | number | 否 | 弹簧自然振动周期，决定弹簧复位的速度。单位：秒，默认值：0.55。 | -| dampingFraction | number | 否 | 阻尼系数。
0表示无阻尼，一直处于震荡状态；
大于0小于1的值为欠阻尼，运动过程中会超出目标值；
等于1为临界阻尼；
大于1为过阻尼，运动过程中逐渐趋于目标值。
默认值：0.825。 | -| overlapDuration | number | 否 | 弹性动画衔接时长。发生动画继承时，如果前后两个弹性动画response不一致，response参数会在overlapDuration时间内平滑过渡。单位：秒，默认值：0。 | +| response | number | 否 | 弹簧自然振动周期，决定弹簧复位的速度。
默认值：0.55，单位：秒；取值范围[0, +∞)。
**说明：**
设置小于0的值时，按默认值0.55处理。 | +| dampingFraction | number | 否 | 阻尼系数。
0表示无阻尼，一直处于震荡状态；
大于0小于1的值为欠阻尼，运动过程中会超出目标值；
等于1为临界阻尼；
大于1为过阻尼，运动过程中逐渐趋于目标值。
默认值：0.825，单位：秒；取值范围[0, +∞)。
**说明：**
设置小于0的值时，按默认值0.55处理。 | +| overlapDuration | number | 否 | 弹性动画衔接时长。发生动画继承时，如果前后两个弹性动画response不一致，response参数会在overlapDuration时间内平滑过渡。
默认值：0，单位：秒；取值范围[0, +∞)。
**说明：**
设置小于0的值时，按默认值0处理。
弹性动画曲线为物理曲线，animation、animateTo中的duration参数不生效，动画持续时间取决于springMotion动画曲线参数和之前的速度。时间不能归一，故不能通过该曲线的interpolate函数获得插值。 | **返回值：** @@ -182,11 +182,12 @@ responsiveSpringMotion(response?: number, dampingFraction?: number, overlapDurat **系统能力：** SystemCapability.ArkUI.ArkUI.Full **参数：** + | 参数名 | 类型 | 必填 | 说明 | | --------- | ------ | ---- | ----- | -| response | number | 否 | 解释同springMotion中的response。单位：秒，默认值：0.15。 | -| dampingFraction | number | 否 | 解释同springMotion中的dampingFraction。默认值：0.86。 | -| overlapDuration | number | 否 | 解释同springMotion中的overlapDuration。单位：秒，默认值：0.25。 | +| response | number | 否 | 解释同springMotion中的response。
默认值：0.15，单位：秒；取值范围[0, +∞)。
**说明：**
设置小于0的值时，按默认值0.15处理。 | +| dampingFraction | number | 否 | 解释同springMotion中的dampingFraction。
默认值：0.86，单位：秒；取值范围[0, +∞)。
**说明：**
设置小于0的值时，按默认值0.86处理。 | +| overlapDuration | number | 否 | 解释同springMotion中的overlapDuration。
默认值：0.25，单位：秒；取值范围[0, +∞)。
**说明：**
设置小于0的值时，按默认值0.25处理。
弹性跟手动画曲线为springMotion的一种特例，仅默认值不同。如果使用自定义参数的弹性曲线，推荐使用springMotion构造曲线；如果使用跟手动画，推荐使用默认参数的弹性跟手动画曲线。
animation、animateTo中的duration参数不生效，动画持续时间取决于responsiveSpringMotion动画曲线参数和之前的速度，也不能通过该曲线的interpolate函数获得插值。 | **返回值：** @@ -217,9 +218,9 @@ interpolate(fraction: number): number **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| -------- | ------ | ---- | -------------------------------------------- | -| fraction | number | 是 |  当前的归一化时间参数，有效值范围0到1。 | +| 参数名 | 类型 | 必填 | 说明 | +| -------- | ------ | ---- | ------------------------------------------------------------ | +| fraction | number | 是 |  当前的归一化时间参数，有效值范围0到1。
**说明：**
设置的值小于0时，按0处理；设置的值大于1时，按1处理。 | **返回值：** diff --git a/zh-cn/application-dev/reference/apis/js-apis-matrix4.md b/zh-cn/application-dev/reference/apis/js-apis-matrix4.md index 424e3d5b4cddc2ffbd92f00a3e76ed8e7a660d2a..eea607e6dfe2342406bf1d810dff37ad543cd1bd 100644 --- a/zh-cn/application-dev/reference/apis/js-apis-matrix4.md +++ b/zh-cn/application-dev/reference/apis/js-apis-matrix4.md @@ -281,11 +281,11 @@ Matrix的平移函数，可以为当前矩阵增加x轴/Y轴/Z轴平移效果。 **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| ------ | ------ | ---- | ------------------------------------- | -| x | number | 否 | x轴的平移距离，单位px。
默认值：0 | -| y | number | 否 | y轴的平移距离，单位px。
默认值：0 | -| z | number | 否 | z轴的平移距离，单位px。
默认值：0 | +| 参数名 | 类型 | 必填 | 说明 | +| ------ | ------ | ---- | -------------------------------------------------------- | +| x | number | 否 | x轴的平移距离，单位px。
默认值：0，取值范围 (-∞, +∞) | +| y | number | 否 | y轴的平移距离，单位px。
默认值：0，取值范围 (-∞, +∞) | +| z | number | 否 | z轴的平移距离，单位px。
默认值：0，取值范围 (-∞, +∞) | **返回值：** @@ -328,13 +328,13 @@ Matrix的缩放函数，可以为当前矩阵增加x轴/Y轴/Z轴缩放效果。 **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| ------- | ------ | ---- | --------------------------------- | -| x | number | 否 | x轴的缩放倍数。
默认值：1 | -| y | number | 否 | y轴的缩放倍数。
默认值：1 | -| z | number | 否 | z轴的缩放倍数。
默认值：1 | -| centerX | number | 否 | 变换中心点x轴坐标。
默认值：0 | -| centerY | number | 否 | 变换中心点y轴坐标。
默认值：0 | +| 参数名 | 类型 | 必填 | 说明 | +| ------- | ------ | ---- | ------------------------------------------------------------ | +| x | number | 否 | x轴的缩放倍数。
默认值：1，取值范围 [0, +∞)。x>1放大，x<1缩小。
**说明：**
设置小于0的值时，按照默认值处理。 | +| y | number | 否 | y轴的缩放倍数。
默认值：1，取值范围 [0, +∞)。y>1放大，y<1缩小。
**说明：**
设置小于0的值时，按照默认值处理。 | +| z | number | 否 | z轴的缩放倍数。
默认值：1，取值范围 [0, +∞)。z>1放大，z<1缩小。
**说明：**
设置小于0的值时，按照默认值处理。 | +| centerX | number | 否 | 变换中心点x轴坐标。
默认值：0，取值范围 (-∞, +∞) | +| centerY | number | 否 | 变换中心点y轴坐标。
默认值：0，取值范围 (-∞, +∞) | **返回值：** @@ -376,14 +376,14 @@ Matrix的旋转函数，可以为当前矩阵增加x轴/Y轴/Z轴旋转效果。 **参数：** -| 参数名 | 类型 | 必填 | 说明 | -| ------- | ------ | ---- | --------------------------------- | -| x | number | 否 | 旋转轴向量x坐标。
默认值：1 | -| y | number | 否 | 旋转轴向量y坐标。
默认值：1 | -| z | number | 否 | 旋转轴向量z坐标。
默认值：1 | -| angle | number | 否 | 旋转角度。
默认值：0 | -| centerX | number | 否 | 变换中心点x轴坐标。
默认值：0 | -| centerY | number | 否 | 变换中心点y轴坐标。
默认值：0 | +| 参数名 | 类型 | 必填 | 说明 | +| ------- | ------ | ---- | -------------------------------------------------- | +| x | number | 否 | 旋转轴向量x坐标。
默认值：1，取值范围 (-∞, +∞) | +| y | number | 否 | 旋转轴向量y坐标。
默认值：1，取值范围 (-∞, +∞) | +| z | number | 否 | 旋转轴向量z坐标。
默认值：1，取值范围 (-∞, +∞) | +| angle | number | 否 | 旋转角度。
默认值：0 | +| centerX | number | 否 | 变换中心点x轴坐标。
默认值：0 | +| centerY | number | 否 | 变换中心点y轴坐标。
默认值：0 | **返回值：**