sd-pixel-processor

SD Pixel Processor 使用指南

Pixel Processor 是 SD 的"像素着色器"——对每个像素执行自定义函数图。 适合 AI 使用：本质是数学表达式图，AI 擅长构建数学逻辑。

核心概念

Pixel Processor 节点
├── 输入: input, input:1, ... (最多 N 个图像输入)
├── perpixel: Function Graph (核心! 对每个像素执行的逻辑)
│   ├── 系统变量: $pos(像素UV坐标), $size(图像尺寸), $tiling, $randomseed
│   ├── 函数节点: 数学运算(add/mul/sin/cos...)、采样(samplelum/samplecol)、逻辑(ifelse)
│   └── 输出: 一个 float/float2/float3/float4 值 → 该像素的颜色
└── 输出: unique_filter_output (处理后的图像)

创建 Pixel Processor

步骤 1: 创建节点

pp = graph.newNode("sbs::compositing::pixelprocessor")
pp.setPosition(float2(x, y))

步骤 2: 获取/创建 perpixel 函数图

pp_prop = pp.getPropertyFromId("perpixel", SDPropertyCategory.Input)
fg = pp.newPropertyGraph(pp_prop, "SDSBSFunctionGraph")

步骤 3: 在函数图中添加节点

# 获取当前像素 UV 坐标
pos = fg.newNode("sbs::function::get_float2")
pos.setPosition(float2(-300, 0))
cp = pos.getPropertyFromId("__constant__", SDPropertyCategory.Input)
pos.setPropertyValue(cp, SDValueString.sNew("$pos"))

# 创建常量
c = fg.newNode("sbs::function::const_float1")
c.setPosition(float2(-300, 50))
cp = c.getPropertyFromId("__constant__", SDPropertyCategory.Input)
c.setPropertyValue(cp, SDValueFloat.sNew(0.5))

# 数学运算
mul = fg.newNode("sbs::function::mul")
mul.setPosition(float2(-100, 0))

# 连接
pos.newPropertyConnectionFromId("unique_filter_output", mul, "a")
c.newPropertyConnectionFromId("unique_filter_output", mul, "b")

# 设置输出
fg.setOutputNode(mul, False)

系统变量（get_*节点的 constant 值）

变量	类型	节点	说明
$pos	float2	get_float2	当前像素 UV 坐标 (0~1)
$size	float2	get_float2	图像尺寸（像素）
$tiling	int	get_integer1	平铺模式
$randomseed	int	get_integer1	随机种子
$number	int	get_integer1	迭代索引（FX-Map 中）
$depth	int	get_integer1	FX-Map 深度
自定义参数名	各种	get_float1/int1/bool	图输入参数

函数节点完整参考

算术运算

节点 ID	输入	输出	说明
add	a, b	float*	a + b
sub	a, b	float*	a - b
mul	a, b	float*	a * b（同类型）
mulscalar	a, b(float1)	float*	向量 × 标量
div	a, b	float*	a / b
mod	a, b	float*	a % b（取模）
neg	a	float*	-a
abs	a	float*
sqrt	a	float1	√a
pow	a, b	float1	a^b
min	a, b	float*	min(a,b)
max	a, b	float*	max(a,b)
floor	a	float*	向下取整
ceil	a	float*	向上取整
lerp	a, b, t	float*	线性插值 a+(b-a)*t