数字拼图参考 - Soft8Soft
Description: 数字拼图提供了各种在场景中操作数字的方法。

# 数字 | Numbers

数字拼图提供了各种在场景中操作数字的方法。

## 内容

- 拼图参考
  - number
  - angle
  - arithmetic operation (with two inputs)
  - arithmetic operation (with single input)
  - round (to integer)
  - round with precision
  - check
  - clamp
  - map range
  - random integer
  - random fraction
  - remainder
  - operations on list
  - trigonometric functions
  - constants
  - create vector
  - set vector value
  - get vector value
  - vector math

#

## 拼图参考

#

### number

这个常用拼图可用于向拼图场景提供一些数字的方法。

数字可以不含小数（整数）或含小数（浮点数）。超大或超小的数字可用科学计数法（指数符号）表示。

#

### angle

此拼图用于直观地定义角度（度数）。

#

### arithmetic operation (with two inputs)

此拼图允许您进行基本的算术运算：加法（+），减法（-），乘法（×）和除法（÷），以及指数运算（^）。

请注意，浮点运算并不总是100%的精确，在比较数值时可能会产生不可预知的结果。为了避免出现精度问题，您可以使用按精度取整。

#

### arithmetic operation (with single input)

此拼图允许您进行以下数学运算：平方根（√），绝对值又称模数（|x|），符号变化又称取反（-），自然对数（ln），常用对数（log10），自然指数函数（e^），以及10的幂（10^）。

示例：

请注意，浮点运算并不总是100%的精确，在比较数值时可能会产生不可预知的结果。为了避免精度问题，您可以使用按精度取整。

#

### round (to integer)

此拼图将指定数值取整。round 变体将一个数字四舍五入到最接近的整数：2.49将被向下舍入（为2），而2.5将被向上舍入（为3）。round up 变体将一个数字向上舍入到最接近的整数：2.1将被向上舍入（为3）。round down 变体将一个数字向下舍入到最接近的整数：2.9将被向下舍入（为2）。

示例：

#

### round with precision

此拼图使用指定的精度对一个给定的数字进行舍入。

示例：

浮点运算并不总是100%准确的，在比较数值时可能会产生不可预知的结果。为了摆脱这些精度问题，您可以使用按精度取整，如下所示：

#

### check

此拼图检查一个指定的数字是否为偶数、奇数、素数、整数、正数、负数或能否被其他数字整除。如果是返回 true，如果否返回 false。与逻辑拼图一起使用。

示例：

#

### clamp

此拼图限制一个数字必须在指定的极限值之间（包括极限值）。

示例：

#

### map range

此拼图将一个给定的值从一个范围映射到另一个范围。

示例：将沿X轴从-10到10单位移动的滑块位置转换为0%到100%的百分比值。

#

### random integer

此拼图返回一个介于指定数字（包括两个极限）之间的随机整数。

注意：尽管可以提供非整数的限制，但这样会扩大范围，因为此拼图在引擎中执行一些额外的四舍五入。

示例：

#

### random fraction

此拼图返回一个大于等于0、小于1的随机浮点数。

下方示例中，此拼图用于为材质生成一个随机的颜色：

#

### remainder

此拼图用于获取一个数字除以另一个数字后的余数（又称模运算）。

示例：

#

### operations on list

对指定列表中的数字执行运算。

- sum — 计算列表中所有数字的总和。
- min — 找到最小的数字。
- max — 找到最大的数字。
- average — 求算术平均值（所有数字求和后除以列表的长度）。
- median — 找到中位数（当所有数字从最小到最大排序时，最中间的数字）。
- modes — 找到众数（在列表中出现频率最高的数字列表）。
- standard deviation — 计算标准差（与算术平均值的偏差平方的平均值的平方根）。
- random item — 返回一个随机选择的项目。

示例：

#

### trigonometric functions

此拼图用于计算三角函数 sine（sin）、cosine（cos）和 tangent（tan）的值，以及它们的逆函数 arcsine（asin）、arccosine（acos）和 arctangent（atan）的值。该拼图期望（或返回）以度数表示的数值。

示例：

请注意，浮点运算并不总是100%的精确，在比较数值时可能会产生不可预知的结果。为了避免精度问题，您可以使用按精度取整。

#

### constants

此拼图返回以下数学常数：圆周率（π），欧拉数 e，黄金分割率（φ），2的平方根，½的平方根，以及无穷大值（∞）。

示例：

#

### create vector

此拼图返回一个新的三维向量，它由给定的X、Y、Z坐标组成。

#

### set vector value

此拼图为给定的向量设置数值（x、y、z 坐标或 length）。

#

### get vector value

此拼图返回从给定向量中获取或计算的数值。

返回值：

- x — X坐标。
- y — Y坐标。
- z — Z坐标。
- is zero — 如果向量的长度为零返回 true，否则返回 false。
- length — 向量的长度。
- negated — 一个新的向量，指向相反的方向。
- normalized — 一个长度为1的新向量。

#

### vector math

此拼图在两个向量之间进行数学运算并返回一个新的向量。

操作：

- + — 向量相加。
- - — 向量相减。
- × — 向量相乘（逐分量）。
- / — 向量相除（逐分量）。
- dot — 计算并返回向量之间的点积。
- cross — 计算并返回向量间的叉积。
- rotate — 按第二个参数给出的欧拉角旋转一个向量。欧拉角的单位是度。

## 在使用拼图时遇到困难？

欢迎您随时在 论坛上提问！您还可以加入中文用户社区QQ群(171678760)，在线寻求帮助。