提交 64c4d9ab 编写于 作者: Y yamila

Specification synchronization2

Signed-off-by: Nyamila <tianyu55@huawei.com>
上级 87db10a3
......@@ -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, +∞)。<br/>**说明:** <br/>设置小于0的值时,按值为0处理。 |
| end | boolean | 是 | 在每个间隔的起点或是终点发生阶跃变化。<br>-true:在终点发生阶跃变化。<br>-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]。<br/>**说明:** <br/>设置的值小于0时,按0处理;设置的值大于1时,按1处理。 |
| y1 | number | 是 | 确定贝塞尔曲线第一点纵坐标,取值范围(-∞, +∞)。 |
| x2 | number | 是 | 确定贝塞尔曲线第二点横坐标。,取值范围[0, 1]。<br/>**说明:** <br/>设置的值小于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, +∞)。<br/>**说明:** <br/>设置的值小于0时,按1处理。 |
| stiffness | number | 是 | 刚度。是物体抵抗施加的力而形变的程度。在弹性系统中,刚度越大,抵抗变形的能力越强,恢复到平衡位置的速度就越快,取值范围(0, +∞)。<br/>**说明:** <br/>设置的值小于0时,按1处理。。 |
| damping | number | 是 | 阻尼。是一个纯数,无真实的物理意义,用于描述系统在受到扰动后震荡及衰减的情形。阻尼越大,弹性运动的震荡次数越少、震荡幅度越小,取值范围(0, +∞)。<br/>**说明:** <br/>设置的值小于0时,按1处理。。 |
**返回值:**
......@@ -149,11 +148,12 @@ springMotion(response?: number, dampingFraction?: number, overlapDuration?: numb
**系统能力:** SystemCapability.ArkUI.ArkUI.Full
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| --------- | ------ | ---- | ----- |
| response | number | 否 | 弹簧自然振动周期,决定弹簧复位的速度。单位:秒,默认值:0.55。 |
| dampingFraction | number | 否 | 阻尼系数。<br>0表示无阻尼,一直处于震荡状态;<br>大于0小于1的值为欠阻尼,运动过程中会超出目标值;<br>等于1为临界阻尼;<br>大于1为过阻尼,运动过程中逐渐趋于目标值。<br>默认值:0.825。 |
| overlapDuration | number | 否 | 弹性动画衔接时长。发生动画继承时,如果前后两个弹性动画response不一致,response参数会在overlapDuration时间内平滑过渡。单位:秒,默认值:0。 |
| response | number | 否 | 弹簧自然振动周期,决定弹簧复位的速度。<br>默认值:0.55,单位:秒;取值范围[0, +∞)。<br/>**说明:** <br/>设置小于0的值时,按默认值0.55处理。 |
| dampingFraction | number | 否 | 阻尼系数。<br>0表示无阻尼,一直处于震荡状态;<br>大于0小于1的值为欠阻尼,运动过程中会超出目标值;<br>等于1为临界阻尼;<br>大于1为过阻尼,运动过程中逐渐趋于目标值。<br>默认值:0.825,单位:秒;取值范围[0, +∞)。<br/>**说明:** <br/>设置小于0的值时,按默认值0.55处理。 |
| overlapDuration | number | 否 | 弹性动画衔接时长。发生动画继承时,如果前后两个弹性动画response不一致,response参数会在overlapDuration时间内平滑过渡。<br/>默认值:0,单位:秒;取值范围[0, +∞)。<br/>**说明:** <br/>设置小于0的值时,按默认值0处理。<br>弹性动画曲线为物理曲线,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。<br/>默认值:0.15,单位:秒;取值范围[0, +∞)。<br/>**说明:** <br/>设置小于0的值时,按默认值0.15处理。 |
| dampingFraction | number | 否 | 解释同springMotion中的dampingFraction。<br/>默认值:0.86,单位:秒;取值范围[0, +∞)。<br/>**说明:** <br/>设置小于0的值时,按默认值0.86处理。 |
| overlapDuration | number | 否 | 解释同springMotion中的overlapDuration。<br/>默认值:0.25,单位:秒;取值范围[0, +∞)。<br/>**说明:** <br/>设置小于0的值时,按默认值0.25处理。<br/>弹性跟手动画曲线为springMotion的一种特例,仅默认值不同。如果使用自定义参数的弹性曲线,推荐使用springMotion构造曲线;如果使用跟手动画,推荐使用默认参数的弹性跟手动画曲线。<br/>animation、animateTo中的duration参数不生效,动画持续时间取决于responsiveSpringMotion动画曲线参数和之前的速度,也不能通过该曲线的interpolate函数获得插值。 |
**返回值:**
......@@ -217,9 +218,9 @@ interpolate(fraction:&nbsp;number): number
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------ | ---- | -------------------------------------------- |
| fraction | number | 是 | &nbsp;当前的归一化时间参数,有效值范围0到1。 |
| 参数名 | 类型 | 必填 | 说明 |
| -------- | ------ | ---- | ------------------------------------------------------------ |
| fraction | number | 是 | &nbsp;当前的归一化时间参数,有效值范围0到1。<br/>**说明:** <br/>设置的值小于0时,按0处理;设置的值大于1时,按1处理。 |
**返回值:**
......
......@@ -281,11 +281,11 @@ Matrix的平移函数,可以为当前矩阵增加x轴/Y轴/Z轴平移效果。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ------------------------------------- |
| x | number | 否 | x轴的平移距离,单位px。<br/>默认值:0 |
| y | number | 否 | y轴的平移距离,单位px。<br/>默认值:0 |
| z | number | 否 | z轴的平移距离,单位px。<br/>默认值:0 |
| 参数名 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | -------------------------------------------------------- |
| x | number | 否 | x轴的平移距离,单位px。<br/>默认值:0,取值范围 (-∞, +∞) |
| y | number | 否 | y轴的平移距离,单位px。<br/>默认值:0,取值范围 (-∞, +∞) |
| z | number | 否 | z轴的平移距离,单位px。<br/>默认值:0,取值范围 (-∞, +∞) |
**返回值:**
......@@ -328,13 +328,13 @@ Matrix的缩放函数,可以为当前矩阵增加x轴/Y轴/Z轴缩放效果。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ------ | ---- | --------------------------------- |
| x | number | 否 | x轴的缩放倍数。<br/>默认值:1 |
| y | number | 否 | y轴的缩放倍数。<br/>默认值:1 |
| z | number | 否 | z轴的缩放倍数。<br/>默认值:1 |
| centerX | number | 否 | 变换中心点x轴坐标。<br/>默认值:0 |
| centerY | number | 否 | 变换中心点y轴坐标。<br/>默认值:0 |
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ------ | ---- | ------------------------------------------------------------ |
| x | number | 否 | x轴的缩放倍数。<br/>默认值:1,取值范围 [0, +∞)。x>1放大,x<1缩小。<br/>**说明:** <br/>设置小于0的值时,按照默认值处理。 |
| y | number | 否 | y轴的缩放倍数。<br/>默认值:1,取值范围 [0, +∞)。y>1放大,y<1缩小。<br/>**说明:** <br/>设置小于0的值时,按照默认值处理。 |
| z | number | 否 | z轴的缩放倍数。<br/>默认值:1,取值范围 [0, +∞)。z>1放大,z<1缩小。<br/>**说明:** <br/>设置小于0的值时,按照默认值处理。 |
| centerX | number | 否 | 变换中心点x轴坐标。<br/>默认值:0,取值范围 (-∞, +∞) |
| centerY | number | 否 | 变换中心点y轴坐标。<br/>默认值:0,取值范围 (-∞, +∞) |
**返回值:**
......@@ -376,14 +376,14 @@ Matrix的旋转函数,可以为当前矩阵增加x轴/Y轴/Z轴旋转效果。
**参数:**
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ------ | ---- | --------------------------------- |
| x | number | 否 | 旋转轴向量x坐标。<br/>默认值:1 |
| y | number | 否 | 旋转轴向量y坐标。<br/>默认值:1 |
| z | number | 否 | 旋转轴向量z坐标。<br/>默认值:1 |
| angle | number | 否 | 旋转角度。<br/>默认值:0 |
| centerX | number | 否 | 变换中心点x轴坐标。<br/>默认值:0 |
| centerY | number | 否 | 变换中心点y轴坐标。<br/>默认值:0 |
| 参数名 | 类型 | 必填 | 说明 |
| ------- | ------ | ---- | -------------------------------------------------- |
| x | number | 否 | 旋转轴向量x坐标。<br/>默认值:1,取值范围 (-∞, +∞) |
| y | number | 否 | 旋转轴向量y坐标。<br/>默认值:1,取值范围 (-∞, +∞) |
| z | number | 否 | 旋转轴向量z坐标。<br/>默认值:1,取值范围 (-∞, +∞) |
| angle | number | 否 | 旋转角度。<br/>默认值:0 |
| centerX | number | 否 | 变换中心点x轴坐标。<br/>默认值:0 |
| centerY | number | 否 | 变换中心点y轴坐标。<br/>默认值:0 |
**返回值:**
......
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册