Controls

control是以关键帧形式控制note各项参数的一个rpe特性。

Alpha Control

字段名类型描述默认值加入版本
easingint到下一个关键帧数值的缓动类型,详见对照表
alphaintnote不透明度255-
xfloatnote与判定线的纵向距离
  • alpha control 可以控制 note 的不透明度。
  • 可以与note的alpha字段结合使用,不冲突,混合公式为 noteAlpha = noteAlpha * nowAlpha(先从0255转换为01后再计算)。

行为

  • alpha control 如下所示时:
{
  "alphaControl": [
    {
      "alpha": 1.0,
      "easing": 1,
      "x": 0.0
    },
    {
      "alpha": 0.5,
      "easing": 2,
      "x": 100.0
    },
    {
      "alpha": 1.0,
      "easing": 1,
      "x": 9999999.0
    }
  ]
}
  • note 在距离判定线 100 个y坐标单位前不透明度为 0.5,在 100 个y坐标单位后以 Out Sine 缓动函数缓动到 1.0 不透明度到与判定线重合。

Size Control

字段名类型描述默认值加入版本
easingint到下一个关键帧数值的缓动类型,详见对照表1-
sizefloatnote大小倍率1.0-
xfloatnote与判定线的纵向距离--
  • size control 可以真正的控制 note 的大小,而不是仅仅控制宽度。
  • 可以与note的宽度字段结合使用,不冲突。
  • 无法影响 Hold 类型的note大小。

行为

  • size control 如下所示时:
{
  "sizeControl": [
    {
      "easing": 1,
      "size": 1.0,
      "x": 0.0
    },
    {
      "easing": 2,
      "size": 1.5,
      "x": 200.0
    },
    {
      "easing": 1,
      "size": 1.0,
      "x": 9999999.0
    }
  ]
}
  • note 在距离判定线 200 个y坐标前大小为原先的 1.5 倍,在200个y坐标单位后以 Out Sine 缓动函数缓动到 1.0 倍大小到与判定线重合。

pos Control(X Control)

字段名类型描述默认值加入版本
easingint到下一个关键帧数值的缓动类型,详见对照表1-
posfloatnote的positionX参数倍率--
xfloatnote与判定线的纵向距离--
  • pos control 可以动态控制 note 的 positionX 倍率。

行为

  • pos control 如下所示时:
{
  "posControl": [
    {
      "easing": 1,
      "pos": 2.0,
      "x": 0.0
    },
    {
      "easing": 2,
      "pos": 1.0,
      "x": 100.0
    },
    {
      "easing": 1,
      "pos": 1.0,
      "x": 9999999.0
    }
  ]
}
  • note 在距离判定线 100 个y坐标单位前note的 positionX 为原先的 2.0 倍,在 100 个y坐标单位后以 Out Sine 缓动函数缓动note的 positionX1.0 倍到与判定线重合。

y Control

字段名类型描述默认值加入版本
easingint到下一个关键帧数值的缓动类型,详见对照表1-
yfloat(待补充)-
xfloatnote与判定线的纵向距离-
  • 行为描述待补充

Skew Control

字段名类型描述默认值加入版本
easingint到下一个关键帧数值的缓动类型,详见对照表1-
skewfloat(待补充)--
xfloatnote与判定线的纵向距离--
  • Hold 类型的note无效。
  • 行为描述待补充