节点函数 - ReiKohaku/Sonolus-wiki-zh_cn GitHub Wiki

节点函数

如果调用一个未被定义的函数,将会返回0。

Execute

执行表达式。

参数 说明
expr... 若干个表达式

返回最后一个表达式的结果。

Execute0

执行表达式并返回0。

这仅用于优化系统。

参数 说明
expr 表达式

If

参数 说明
cond 条件
true 如果条件为真
false 如果条件为假

Switch

参数 说明
cond 条件
case_1 分支1成立的值
expr_1 如果分支1成立执行的表达式
... 其余分支

SwitchWithDefault

参数 说明
cond 条件
case_1 分支1成立的值
expr_1 如果分支1成立执行的表达式
... 其余分支
expr_def 默认分支的表达式

SwitchInteger

参数 说明
cond 条件
expr_1 如果条件值等于1执行的表达式
... 其余分支

SwitchIntegerWithDefault

参数 说明
cond 条件
expr_1 如果条件值等于1执行的表达式
... 其余分支
expr_def 默认分支的表达式

While

直到条件为假之前重复执行。

参数 说明
cond 条件
expr... 表达式

Add

参数 说明
expr... 表达式

Subtract

参数 说明
expr... 表达式

Multiply

参数 说明
expr... 表达式

Divide

参数 说明
expr... 表达式

Mod

参数 说明
expr... 表达式

Power

参数 说明
expr... 表达式

Log

参数 说明
expr 表达式

返回表达式的自然对数。

Equal

参数 说明
a 要比较的表达式
b 要比较的表达式

NotEqual

参数 说明
a 要比较的表达式
b 要比较的表达式

Greater

参数 说明
a 要比较的表达式
b 要比较的表达式

GreaterOr

参数 说明
a 要比较的表达式
b 要比较的表达式

Less

参数 说明
a 要比较的表达式
b 要比较的表达式

LessOr

参数 说明
a 要比较的表达式
b 要比较的表达式

And

参数 说明
expr... 表达式

Or

参数 说明
expr... 表达式

Not

参数 说明
expr 表达式

若为真返回0,为假返回1。

Min

参数 说明
a 要取较小值的表达式
b 要取较小值的表达式

Max

参数 说明
a 要取较大值的表达式
b 要取较大值的表达式

Abs

参数 说明
expr 表达式

Sign

参数 说明
expr 表达式

Ceil

参数 说明
expr 表达式

Floor

参数 说明
expr 表达式

Round

参数 说明
expr 表达式

Frac

参数 说明
expr 表达式

Trunc

参数 说明
expr 表达式

Degree

参数 说明
expr 表达式

Radian

参数 说明
expr 表达式

Sin

参数 说明
expr 表达式

Cos

参数 说明
expr 表达式

Tan

参数 说明
expr 表达式

Sinh

参数 说明
expr 表达式

Cosh

参数 说明
expr 表达式

Tanh

参数 说明
expr 表达式

Arcsin

参数 说明
expr 表达式

Arccos

参数 说明
expr 表达式

Arctan

参数 说明
expr 表达式

Arctan2

参数 说明
y y
x x

Clamp

参数 说明
x
a 最小值
b 最大值

Lerp

参数 说明
a 最小值
b 最大值
x

LerpClamped

参数 说明
a 最小值
b 最大值
x

Unlerp

参数 说明
a 最小值
b 最大值
x

UnlerpClamped

参数 说明
a 最小值
b 最大值
x

Remap

参数 说明
a 起始最小值
b 起始最大值
c 目标最小值
d 目标最大值
x

RemapClamped

参数 说明
a 起始最小值
b 起始最大值
c 目标最小值
d 目标最大值
x

Smoothstep

参数 说明
a 最小值
b 最大值
x

Random

参数 说明
min 最小值
max 最大值

返回[min, max]区间内的一个随机数值。

RandomInteger

参数 说明
min 最小值
max 最大值

返回[min, max)区间内的一个随机整数值。

Get

参数 说明
id 模块标识符
i 序号

GetShifted

参数 说明
id 模块标识符
i 序号
d 偏移

相当于Get(id, i + d)

Set

参数 说明
id 模块标识符
i 序号
value

SetShifted

参数 说明
id 模块标识符
i 序号
d 偏移
value

相当于Set(id, i + d, value)

Draw

参数 说明
id 精灵标识符
x1 x1
y1 y1
x2 x2
y2 y2
x3 x3
y3 y3
x4 x4
y4 y4
z z
a 透明度

DrawCurvedL

参数 说明
id 精灵标识符
x1 x1
y1 y1
x2 x2
y2 y2
x3 x3
y3 y3
x4 x4
y4 y4
z z
a 透明度
n 分段数
cxL cxL
cyL cyL

DrawCurvedR

参数 说明
id 精灵标识符
x1 x1
y1 y1
x2 x2
y2 y2
x3 x3
y3 y3
x4 x4
y4 y4
z z
a 透明度
n 分段数
cxR cxR
cyR cyR

DrawCurvedLR

参数 说明
id 精灵标识符
x1 x1
y1 y1
x2 x2
y2 y2
x3 x3
y3 y3
x4 x4
y4 y4
z z
a 透明度
n 分段数
cxL cxL
cyL cyL
cxR cxR
cyR cyR

DrawCurvedB

参数 说明
id 精灵标识符
x1 x1
y1 y1
x2 x2
y2 y2
x3 x3
y3 y3
x4 x4
y4 y4
z z
a 透明度
n 分段数
cxB cxB
cyB cyB

DrawCurvedT

参数 说明
id 精灵标识符
x1 x1
y1 y1
x2 x2
y2 y2
x3 x3
y3 y3
x4 x4
y4 y4
z z
a 透明度
n 分段数
cxT cxT
cyT cyT

DrawCurvedBT

参数 说明
id 精灵标识符
x1 x1
y1 y1
x2 x2
y2 y2
x3 x3
y3 y3
x4 x4
y4 y4
z z
a 透明度
n 分段数
cxB cxB
cyB cyB
cxT cxT
cyT cyT

Play

播放一个低延迟的音效片段。

查看音效获取更多信息。

参数 说明
id 音效片段标识符
dist 上一次到这次播放这个音效的最短时间间隔

PlayScheduled

预设未来的一个时间精确地播放一个音效片段。

查看音效获取更多信息。

参数 说明
id 音效片段标识符
t 时间
dist 上一次到这次播放这个音效的最短时间间隔

Spawn

生成一个脚本,将其中的数据注入到索引为0的实体存储模块中。

参数 说明
id 脚本标识符
data... 要注入的数据

SpawnParticleEffect

参数 说明
id 粒子效果标识符
x1 x1
y1 y1
x2 x2
y2 y2
x3 x3
y3 y3
x4 x4
y4 y4
t 持续时间
loop 粒子效果是否循环

返回生成的粒子效果的唯一标识符,可用于移动或销毁它。

MoveParticleEffect

参数 说明
id 生成的粒子效果标识符
x1 x1
y1 y1
x2 x2
y2 y2
x3 x3
y3 y3
x4 x4
y4 y4

DestroyParticleEffect

参数 说明
id 生成的粒子效果标识符

Judge

参数 说明
src 资源位置
dst 目标位置
min1 Perfect的最小偏移距离
max1 Perfect的最大偏移距离
min2 Great的最小偏移距离
max2 Great的最大偏移距离
min3 Good的最小偏移距离
max3 Good的最大偏移距离

如果是Perfect返回1,Great返回2,Good返回3,其它返回0。

JudgeSimple

用于判定区间对称的情况。

参数 说明
src 资源位置
dst 目标位置
max1 Perfect的最大偏移距离
max2 Great的最大偏移距离
max3 Good的最大偏移距离

如果是Perfect返回1,Great返回2,Good返回3,其它返回0。

Easing函数

支持Sine、Quad、Cubic、Quart、Quint、Expo、Circ、Back和Elastic的In/Out/InOut效果。

示例:EaseInQuad

访问https://easings.net/获取更多信息。

参数 说明
x x

IsDebug

检查是否处于调试模式。

返回1为真,0为假。

DebugPause

触发暂停。

DebugLog

输出一个值到日志。

参数 说明
value 要输出到日志的值