跳转至

浮点运算

本文对应 2026-09-12 本地开发候选,不表示已部署版本具备相同能力。

用途与端口

Shift+A → 运算 → 浮点运算。无执行端口,下游读取时计算。 左右输入未连接时使用填写值(默认 0);接线后隐藏对应默认输入。 当前新建节点提供相加、相减、相乘、相除,输出元素类型为 Float。

元素类型与数据域独立:两侧都是单值则输出单值;有图像输入则逐像素计算,常量广播到每个像素,输出浮点通道图像,不会隐式取左上角像素。

颜色输入逐像素转亮度;向量转浮点取分量平均。因此彩色图直接接 Float Math 不会分别保留 RGB。保留颜色应分离 RGB、分别运算,再合并。

数值与空间规则

  • 相减、相除按左值减/除右值。除零、非有限结果明确报错,不返回原输入冒充成功。
  • 计算数据为浮点值,负值和大于 1 的结果不默认截断;PNG 仅为可显示预览,不作为下一次运算的权威数据。
  • 多图按第一个图像输入确定计算域;当前支持整数像素偏移及 clip/tile/mirror/extend 采样。复杂映射必须先显式应用,不能静默忽略。
  • 颜色计算使用 scene-linear、straight Alpha;普通数值和向量数据不做 Gamma。颜色预览转回 sRGB。
  • 延时、循环次数和转整数等单值专用输入不接受整张通道图像,需要明确采样或统计,不能靠类型兼容隐式降维。

例:8 ÷ 2 输出 4.0;R 通道图像乘 0.5 输出同尺寸浮点图像。

已有旧版浮点“除余”文档保留历史单值商/余数行为;新建整数除余使用整数运算。不要由旧菜单或旧安全除法说明推断当前普通相除会把除零当作成功。

参考边界

数据域与元素类型的分层参考 Blender Result 和 转换实现。这不是逐项数值复刻:本项目保留除零报错等自动化错误策略,Alpha 使用 straight,而非 Blender 的预乘颜色结果。

参见多维运算与分量拆合。