BIKINI 用户手册BIKINI User Manual
严格对照 E:\Achieve List.txt。只收录清单内的 BIKINI 项。
官方节点（如 Evaluate Closure、Grid Gradient / Divergence / Laplacian）
不在清单里、不写节点页。清单里的 gradient/divergence 指
GeometryNodeMeshGradient / GeometryNodeMeshDivergence，不是官方 Grid*。
CompositorNodeImageProcess 是合成器节点（接通 GTE 组），不是 GTE 编辑器内节点。
Strictly from Achieve List. Official nodes excluded.
CompositorNodeImageProcess is a Compositor node, not a GTE-editor node.
Coverage（清单白名单）
节点页：几何 30 · GTE 17 · 合成器 1 · 着色器 4；
界面/快捷 10（侧栏独立分类）。共节点 52。
清单 miss：无。
Nodes: geo 30 · GTE 17 · compositor 1 · shader 4;
UI/shortcuts 10 (sidebar category). Miss: none.
每页仅 Inputs / Outputs + Menu 全部模式/默认 + 显示条件。无「属性」章节。
Inputs/Outputs only; menus list all modes + defaults + visibility.
Achieve List 对照统计
逐行对照清单。状态：ok 本 EXE 可实例化并已写 IO 页；
miss 清单有但本 EXE 不能 nodes.new；
wf 工作流/UI；off 清单注释禁用。
ok = in this EXE + IO page; miss = on list but not instantiable; wf = workflow; off = commented out.
几何节点（Achieve List）Geometry Nodes (Achieve List)
| Achieve List 项 | Status | 映射 / 说明 |
|---|
| String属性 | wf | 工作流 / UI（非独立节点） |
| 几何节点Portal | ok | GeometryNodeNamedPortal, GeometryNodeStoreNamedPortal |
| 几何Clip | ok | GeometryNodeGeometryClip |
| 设置默认闭包 | ok | GeometryNodeSetClosureDefault |
| loop细分 | ok | GeometryNodeLoopSubdivision |
| nearest neighbours | ok | GeometryNodeKNearest |
| //viewport camera | off | 清单已注释禁用 // |
| 模拟区Cache Limit | wf | 工作流 / UI（非独立节点） |
| debug节点 | ok | GeometryNodeDebug |
| enable input/output优化 | ok | NodeEnableInput, NodeEnableOutput |
| timeshift | ok | GeometryNodeTimeShift |
| Sparse Matrix Math | ok | GeometryNodeSparseMatrixMath |
| Linear Solver | ok | GeometryNodeLinearSolver |
| Mesh Laplace | ok | GeometryNodeMeshLaplacian |
| Object info Seed | ok | GeometryNodeObjectInfo |
| Repeat Zone的break | wf | 工作流 / UI（非独立节点） |
| select element | ok | GeometryNodeSelectElements |
| edit element | ok | GeometryNodeEditElements |
| heat geodesic | ok | GeometryNodeHeatGeodesic |
| instant mesh | ok | GeometryNodeInstantMeshes |
| quadwild | ok | GeometryNodeQuadWild |
| tri remesh | ok | GeometryNodeTriangleRemesh |
| voronoi破碎 | ok | GeometryNodeVoronoiFracture |
| Delaunay 3D | ok | GeometryNodeDelaunay3D |
| Write at Index | ok | GeometryNodeWriteAtIndex |
| rbf interpolate | ok | GeometryNodeRBFInterpolate |
| 图染色 | ok | GeometryNodeMeshGraphColoring |
| tangent field | ok | GeometryNodeTangentField |
| gradient（Mesh） | ok | GeometryNodeMeshGradient（勿与官方 Grid* / Evaluate Closure 混淆） |
| divergence（Mesh） | ok | GeometryNodeMeshDivergence（勿与官方 Grid* / Evaluate Closure 混淆） |
| curve intersection | ok | GeometryNodeCurveIntersections |
| expression（几何） | ok | NodeExpression |
界面 UI 与便捷操作UI & Shortcuts
着色器Shaders
| Achieve List 项 | Status | 映射 / 说明 |
|---|
| image socket | ok | NodeSocketImage / GeometryNodeImageTexture（着色器树；inline → ShaderNodeTexImage） |
| sdf shape（着色器） | ok | ShaderNodeSDFShape |
| fractal（着色器） | ok | ShaderNodeFractalPrimitive |
| expression（着色器） | ok | NodeExpression |
| HLSL | ok | ShaderNodeHLSL |
合成器Compositor
| Achieve List 项 | Status | 映射 / 说明 |
|---|
| 接通合成器 | ok | CompositorNodeImageProcess · 合成器节点Compositor node |
Data Block GraphData Block Graph
| Achieve List 项 | Status | 映射 / 说明 |
|---|
| data block reference graph | wf | 新编辑器editor |
GPU Texture EditorGPU Texture Editor
| Achieve List 项 | Status | 映射 / 说明 |
|---|
| Import Points | ok | ImageNodeImportPoints |
| Point Stamp | ok | ImageNodePointStamp |
| Normal to height | ok | ImageNodeNormalToHeight |
| Height to normal | ok | ImageNodeHeightToNormal |
| Bake Image | ok | ImageNodeBakeImage |
| Image Output / File Output | ok | ImageNodeFileOutput |
| Gradient（图像） | ok | ImageNodeGradient |
| Divergence（图像） | ok | ImageNodeDivergence |
| Fluid Sim | ok | ImageNodeFluidSimInput, ImageNodeFluidSimOutput |
| Rasterize Geo | ok | ImageNodeRasterizeGeometry |
| sample at pixel | ok | ImageNodeSampleAtPixel |
| write at pixel | ok | ImageNodeWriteAtPixel |
| paint | ok | ImageNodePaint |
| histogram | ok | ImageNodeHistogram |
| sdf shape（GTE） | ok | ImageNodeSDFShape |
| fractal（GTE） | ok | ImageNodeFractalPrimitive |
GeometryNodeNamedPortal · GeometryNodeTree
Named Portal
功能Function
按 Portal 名称读取同一节点树内唯一的 Store Named Portal 发布的几何。名称为空、不存在或不唯一时输出空 Geometry 并报错。不跨组、不跨物体。
Reads geometry published by the unique Store Named Portal with the same Portal name in the same node tree. Empty/missing/duplicate names yield empty Geometry + error.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| PortalString (Portal ID) | Portal 名称（字符串）。须与同树内某个 Store Named Portal 的 Portal 完全一致。RNA：portal_name。Portal name (string). Must match a Store Named Portal in the same tree. RNA: portal_name. 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| GeometryGeometry | 读到的几何；名称无效时为空。Fetched geometry; empty if name invalid. |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
GeometryNodeStoreNamedPortal · GeometryNodeTree
Store Named Portal
功能Function
把输入 Geometry 以 Portal 名称发布到当前节点树，供同名 Named Portal 读取。Geometry 输出为透传。Store 名称在树内必须唯一（重名会自动加 .001 后缀）。
Publishes Geometry under Portal name for Named Portal readers. Geometry output is pass-through. Store names must be unique in the tree.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| PortalString (Portal ID) | 发布用的 Portal 名称（字符串，默认 Portal）。树内唯一。RNA：portal_name。Publish name (string, default Portal). Unique in tree. RNA: portal_name. default=Portal 显示条件Shown when: 始终显示 / always |
|---|
| GeometryGeometry | 要发布并透传的几何。Geometry to publish and pass through. 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| GeometryGeometry | 要发布并透传的几何。Geometry to publish and pass through. |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
GeometryNodeGeometryClip · GeometryNodeTree
Geometry Clip
功能Function
用平面裁切几何：按 Mode 保留上方/下方/两侧，并输出裁切后的几何与两侧选择。
Clips geometry with a plane; Mode keeps above/below/both; outputs geometry and side selections.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| ModeMenu | 保留哪一侧：Above / Below / Both。Which side to keep: Above / Below / Both. 显示条件Shown when: 始终显示 / always |
|---|
| GeometryGeometry | 待裁切几何。Geometry to clip. 显示条件Shown when: 始终显示 / always |
|---|
| Plane PositionVector | 平面上一点（世界/物体空间随图）。A point on the plane. default=[0.0, 0.0, 0.0] 显示条件Shown when: 始终显示 / always |
|---|
| Plane NormalVector | 平面法线方向。Plane normal. default=[0.0, 0.0, 1.0] 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| GeometryGeometry | 待裁切几何。Geometry to clip. |
|---|
| AboveGeometry | 平面上方元素选择/结果侧。Above-plane selection/side. |
|---|
| BelowGeometry | 平面下方元素选择/结果侧。Below-plane selection/side. |
|---|
菜单模式与接口显隐Menus & input visibility
Mode Menu
默认Default: Both · 全部All: Above, Below, Both
| 模式Mode | 此时显示的 InputsInputs shown |
|---|
Above | Mode, Geometry, Plane Position, Plane Normal |
|---|
Below | Mode, Geometry, Plane Position, Plane Normal |
|---|
Both | Mode, Geometry, Plane Position, Plane Normal |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
GeometryNodeSetClosureDefault · GeometryNodeTree
Set Default Closure
功能Function
输出 = 主 Closure 有值则用之，否则用 Default Closure。Default 也可作为新建 Closure Zone 的模板来源。
output = Closure if set else Default Closure. Default can template new Closure Zones.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| ClosureClosure | 主闭包；有值时优先输出。Main closure; preferred when set. 显示条件Shown when: 始终显示 / always |
|---|
| Default ClosureClosure | 回退闭包；也可作新 Zone 模板。Fallback closure / zone template. 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| ClosureClosure | 主闭包；有值时优先输出。Main closure; preferred when set. |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
GeometryNodeLoopSubdivision · GeometryNodeTree
Loop Subdivision
功能Function
对 Mesh 做 Loop 细分，Level 控制迭代次数。
Loop-subdivides Mesh; Level is iteration count.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| MeshGeometry | 输入三角/四边网格。Input mesh. 显示条件Shown when: 始终显示 / always |
|---|
| LevelInt | 细分次数（≥0）。Subdivision levels. default=1 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| MeshGeometry | 输入三角/四边网格。Input mesh. |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
GeometryNodeKNearest · GeometryNodeTree
Nearest Neighbors
功能Function
在 Target 点集上为 Source 的每个点查询近邻：K Nearest 固定 K 个，Radius 球内全部邻居。邻居按距离排序；Source=Target 时包含自身。
Nearest-neighbor query: K nearest or all within Radius. Sorted by distance; includes self when Source=Target.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| ModeMenu | K Nearest 或 Radius。K Nearest or Radius. 显示条件Shown when: 始终显示always |
|---|
| Source GeometryGeometry | 查询点来源。Query points. 显示条件Shown when: 始终显示 / always |
|---|
| Target GeometryGeometry | 被搜索点集。Search target points. 显示条件Shown when: 始终显示 / always |
|---|
| KInt | 近邻个数（仅 K Nearest）。Neighbor count (K mode). default=1 显示条件Shown when: Mode = K Nearest |
|---|
| RadiusFloatDistance | 搜索半径（仅 Radius）。Search radius (Radius mode). default=1.0 显示条件Shown when: Mode = Radius |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| IndicesInt | 邻居目标点索引（按距离升序）。Neighbor target indices (distance order). |
|---|
| Source IndicesInt | Radius 模式：每条邻居对应的源点索引。Radius mode: source index per neighbor. |
|---|
菜单模式与接口显隐Menus & input visibility
Mode Menu
默认Default: K_NEAREST · 全部All: K Nearest, Radius
| Mode | 显示的 InputsInputs shown |
|---|
K Nearest | Source Geometry, Target Geometry, K |
|---|
Radius | Source Geometry, Target Geometry, Radius |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
GeometryNodeDebug · GeometryNodeTree
Debug
功能Function
在视口叠加层显示字段 Value（及可选文字），便于调试属性/场；Geometry 透传。
Viewport overlay of field Value (optional text) for debugging; Geometry is pass-through.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| Data TypeMenu | Value 的数据类型。Data type of Value. 显示条件Shown when: 始终显示always |
|---|
| GeometryGeometry | 透传几何。Pass-through geometry. 显示条件Shown when: Data Type ∈ {Float, Integer, Boolean, Vector, Color, Quaternion, 4x4 Matrix, String} |
|---|
| SelectionBool | 仅在选中元素上显示。Show only on selected elements. default=True 显示条件Shown when: Data Type ∈ {Float, Integer, Boolean, Vector, Color, Quaternion, 4x4 Matrix, String} |
|---|
| ValueFloat | 要叠加显示的场值。Field value to overlay. default=0.0 显示条件Shown when: Data Type ∈ {Float, Integer, Boolean, Vector, Color, Quaternion, 4x4 Matrix, String} |
|---|
| Text SizeFloatPixel | 叠加文字大小。Overlay text size. default=11.0 显示条件Shown when: Data Type ∈ {Float, Integer, Boolean, Color, Quaternion, 4x4 Matrix, String} |
|---|
| OpacityFloatFactor | 叠加不透明度。Overlay opacity. default=1.0 显示条件Shown when: Data Type ∈ {Float, Integer, Boolean, Color} |
|---|
| Exclude BackfacesBool | 是否排除背向面。Exclude backfaces. default=True 显示条件Shown when: Data Type ∈ {Float, Integer, Boolean, Vector, Color, Quaternion, 4x4 Matrix, String} |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| GeometryGeometry | 透传几何。Pass-through geometry. 显示条件Shown when: Data Type ∈ {Float, Integer, Boolean, Vector, Color, Quaternion, 4x4 Matrix, String} |
|---|
菜单模式与接口显隐Menus & input visibility
Data Type Menu
默认Default: FLOAT · 全部All: Float, Integer, Boolean, Vector, Color, Quaternion, 4x4 Matrix, String, 8-Bit Integer, 2D 16-Bit Integer Vector, 2D Integer Vector, 2D Vector, 4D Vector, Byte Color
| Mode | 显示的 InputsInputs shown |
|---|
Float | Geometry, Selection, Value, Text Size, Opacity, Exclude Backfaces |
|---|
Integer | Geometry, Selection, Value, Text Size, Opacity, Exclude Backfaces |
|---|
Boolean | Geometry, Selection, Value, Text Size, Opacity, Exclude Backfaces |
|---|
Vector | Geometry, Selection, Value, Normalize Length, Arrow Scale, Arrow Color, Exclude Backfaces |
|---|
Color | Geometry, Selection, Value, Text Size, Opacity, Exclude Backfaces |
|---|
Quaternion | Geometry, Selection, Value, Text Size, Exclude Backfaces |
|---|
4x4 Matrix | Geometry, Selection, Value, Text Size, Exclude Backfaces |
|---|
String | Geometry, Selection, Value, Text Size, Exclude Backfaces |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
NodeEnableInput · GeometryNodeTree
Enable Input
功能Function
控制组接口是否显示与求值：Enable=true 时 Value 透传且外部接口可见；Enable=false 时隐藏被控组接口（非灰显）、忽略外部 wire，输出组接口静态默认值或 Default Input（Position / Normal / Index / Scene Frame 等）。Value 接 Group Input 时绑定该接口。
Gates a group-interface input: Enable=true passes Value and shows the interface; Enable=false hides the controlled group socket (not merely grey), ignores external wires, and outputs the interface static default or Default Input (Position / Normal / Index / Scene Frame, …). Wire Value from Group Input to bind that interface.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| Data TypeMenu | Value 的 socket 数据类型（节点头）。Value socket data type (node header). 显示条件Shown when: 始终显示always |
|---|
| EnableBool | 为 true 时透传 Value 并显示组接口；false 时隐藏接口并改用默认路径。true: pass Value + show interface; false: hide interface and use defaults. default=False 显示条件Shown when: 始终显示 / always |
|---|
| ValueDynamic | 被控值；通常接 Group Input。Enable=false 时不 request（不读外部 wire）。Controlled value (usually Group Input). Not requested when Enable=false. 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| ValueDynamic | Enable=true 时为透传；false 时为组接口默认 / Default Input。Pass-through when enabled; interface default / Default Input when disabled. |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
NodeEnableOutput · GeometryNodeTree
Enable Output
功能Function
Enable=true 时 Value 透传；Enable=false 时输出类型回退默认（不 request Value）。用于按条件启用组输出路径；与 Enable Input（隐藏接口 + 接口默认值）语义不同。
Enable=true passes Value; Enable=false falls back to type default (Value not requested). Conditional group-output gating; differs from Enable Input (hide interface + interface defaults).
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| Data TypeMenu | Value 的 socket 数据类型（节点头）。Value socket data type (node header). 显示条件Shown when: 始终显示always |
|---|
| EnableBool | 为 true 时透传 Value；false 时输出类型默认。true: pass Value; false: type fallback default. default=False 显示条件Shown when: 始终显示 / always |
|---|
| ValueDynamic | 被控值。Enable=false 时不 request。Controlled value. Not requested when Enable=false. 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| ValueDynamic | Enable=true 时透传；false 时为类型默认回退。Pass-through when enabled; type default when disabled. |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
GeometryNodeTimeShift · GeometryNodeTree
Time Shift
功能Function
把几何求值时间偏移到指定 Frame（常用于模拟区采样其它帧）。
Evaluates geometry at a shifted Frame (useful for sim sampling other frames).
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| GeometryGeometry | 要偏移时间求值的几何。Geometry evaluated at shifted time. 显示条件Shown when: 始终显示 / always |
|---|
| FrameInt | 目标帧。Target frame. default=1 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| GeometryGeometry | 要偏移时间求值的几何。Geometry evaluated at shifted time. |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
GeometryNodeSparseMatrixMath · GeometryNodeTree
Sparse Matrix Math
功能Function
稀疏矩阵二元运算（加/减/乘等 Operation），A/B 为稀疏矩阵 Bundle。
Sparse matrix binary ops (Add/Sub/Mul…) on matrix Bundles A/B.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| OperationMenu | 矩阵运算类型。Matrix operation. 显示条件Shown when: 始终显示always |
|---|
| ABundle | 左操作数稀疏矩阵。Left sparse matrix. 显示条件Shown when: 始终显示 / always |
|---|
| BBundle | 右操作数稀疏矩阵。Right sparse matrix. 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| ResultBundle | 结果矩阵。Result matrix. |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
GeometryNodeLinearSolver · GeometryNodeTree
Linear Solver
功能Function
稀疏线性代数：解 Ax=b、分解、带分解回代、矩阵-向量乘、特征对等。Mode / Data Type 控制可见接口。
Sparse linear algebra: solve Ax=b, factor, solve-with-factor, multiply, eigenpairs. Mode gates IO.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| ModeMenu | 主模式：解方程 / 分解 / 带分解回代 / 矩阵向量乘。Main mode: solve / factor / solve-with-factor / multiply. 显示条件Shown when: 始终显示 / always |
|---|
| Data TypeMenu | 未知量类型。Decompose 模式下节点会隐藏此菜单。Unknown type. Hidden in Decompose mode. 显示条件Shown when: Mode ≠ Decompose（Decompose 时隐藏） |
|---|
| Solver ClassMenu | 仅 Mode=Linear System Solve 时显示。Only when Mode = Linear System Solve. 显示条件Shown when: Mode = Linear System Solve |
|---|
| Direct MethodMenu | 仅 Mode=Solve 且 Solver Class=Direct（或 Decompose→Matrix Factor）。Solve+Direct, or Decompose→Matrix Factor. 显示条件Shown when: Mode=Solve 且 Solver Class=Direct；或 Mode=Decompose 且 Decompose Mode=Matrix Factor |
|---|
| Iterative MethodMenu | 仅 Mode=Solve 且 Solver Class=Iterative。Only Solve + Iterative. 显示条件Shown when: Mode=Solve 且 Solver Class=Iterative |
|---|
| PreconditionerMenu | 仅 Iterative 求解时显示。Only with Iterative solver. 显示条件Shown when: Mode=Solve 且 Solver Class=Iterative |
|---|
| Decompose ModeMenu | 仅 Mode=Decompose：矩阵因式 或 特征分解。Only Mode=Decompose: matrix factor or eigen. 显示条件Shown when: Mode = Decompose |
|---|
| Eigen SolverMenu | 仅 Mode=Decompose 且 Decompose Mode=Eigen。带 Shift 的求解器才会显示 Shift 输入。Only Decompose→Eigen. *Shift* solvers show Shift input. 显示条件Shown when: Mode = Decompose 且 Decompose Mode = Eigen |
|---|
| ABundle | 系数稀疏矩阵 Bundle。Coefficient sparse matrix. 显示条件Shown when: 始终显示 / always |
|---|
| bFloat | 右端项 list。RHS vector list. default=0.0 显示条件Shown when: Mode = Linear System Solve 或 Solve with Decomposition |
|---|
| xFloat | 未知量/乘子向量；输出亦为解 x。Unknown / multiply vector; output is solution x. default=0.0 显示条件Shown when: Mode = Multiply（输入向量；输出 x 见 Outputs） |
|---|
| PinBool | Dirichlet 钉扎布尔 list（值取自 b）。Dirichlet pin mask (values from b). default=False 显示条件Shown when: Mode = Linear System Solve / Solve with Decomposition；或 Mode=Decompose 且 Decompose Mode=Eigen |
|---|
| DecompositionBundle | 分解 Bundle 输入/输出。Factorization Bundle in/out. 显示条件Shown when: Mode = Solve with Decomposition（输入已有分解） |
|---|
| Num EigenpairsInt | 特征对个数 k。Number of eigenpairs k. default=0 显示条件Shown when: Mode = Decompose 且 Decompose Mode = Eigen |
|---|
| ShiftFloat | Shift-invert 位移 σ。Shift-invert σ. default=0.0 显示条件Shown when: Mode = Decompose 且 Decompose Mode = Eigen 且 Eigen Solver 为 *Shift*（GenEigsRealShift / SymEigsShift） |
|---|
| Max IterationsInt | 迭代法最大迭代。Iterative max iterations. default=1000 显示条件Shown when: Mode = Linear System Solve 且 Solver Class = Iterative |
|---|
| ToleranceFloat | 迭代收敛容差。Iterative tolerance. default=1.000000013351432e-10 显示条件Shown when: Mode = Linear System Solve 且 Solver Class = Iterative |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| xFloat | 未知量/乘子向量；输出亦为解 x。Unknown / multiply vector; output is solution x. 显示条件Shown when: Mode ∈ {Linear System Solve, Solve with Decomposition, Multiply} |
|---|
| DecompositionBundle | 分解 Bundle 输入/输出。Factorization Bundle in/out. 显示条件Shown when: Mode = Decompose 且 Decompose Mode = Matrix Factor |
|---|
| EigenvectorsFloat | 嵌套 list：k 个长度 n 的向量。Nested list: k vectors of length n. 显示条件Shown when: Mode = Decompose 且 Decompose Mode = Eigen |
|---|
| EigenvaluesFloat | 长度 k 的特征值 list。Eigenvalue list length k. 显示条件Shown when: Mode = Decompose 且 Decompose Mode = Eigen |
|---|
菜单模式与接口显隐Menus & input visibility
Mode Menu
主模式：解方程 / 分解 / 带分解回代 / 矩阵向量乘。Main mode: solve / factor / solve-with-factor / multiply.
默认Default: SOLVE → Linear System Solve · 全部All: Linear System Solve, Decompose, Solve with Decomposition, Multiply
Data Type Menu
未知量类型。Decompose 模式下节点会隐藏此菜单。Unknown type. Hidden in Decompose mode.
默认Default: FLOAT · 全部All: Float, Vector
Solver Class Menu
仅 Mode=Linear System Solve 时显示。Only when Mode = Linear System Solve.
默认Default: DIRECT · 全部All: Direct, Iterative
Direct Method Menu
仅 Mode=Solve 且 Solver Class=Direct（或 Decompose→Matrix Factor）。Solve+Direct, or Decompose→Matrix Factor.
默认Default: LLT · 全部All: LLT, LDLT, LU, QR
Iterative Method Menu
仅 Mode=Solve 且 Solver Class=Iterative。Only Solve + Iterative.
默认Default: CG · 全部All: GMRES, DGMRES, MINRES, CG, LSCG, BiCGSTAB, IDRS
Preconditioner Menu
仅 Iterative 求解时显示。Only with Iterative solver.
默认Default: DIAGONAL · 全部All: Identity, Diagonal, IncompleteLUT, IncompleteCholesky
Decompose Mode Menu
仅 Mode=Decompose：矩阵因式 或 特征分解。Only Mode=Decompose: matrix factor or eigen.
默认Default: MATRIX_FACTOR · 全部All: Matrix Factor, Eigen
Eigen Solver Menu
仅 Mode=Decompose 且 Decompose Mode=Eigen。带 Shift 的求解器才会显示 Shift 输入。Only Decompose→Eigen. *Shift* solvers show Shift input.
默认Default: SYM_EIGS · 全部All: GenEigsSolver, SymEigsSolver, GenEigsRealShiftSolver, SymEigsShiftSolver
Mode 下 Inputs / Outputs 显隐Visibility by Mode
| Mode | Sub | 显示的 InputsInputs | 显示的 OutputsOutputs |
|---|
| Linear System Solve | Direct | A, b, Pin | x |
|---|
| Linear System Solve | Iterative | A, b, Pin, Max Iterations, Tolerance | x |
|---|
| Decompose | Matrix Factor | A | Decomposition |
|---|
| Decompose | Eigen（无 Shift） | A, Pin, Num Eigenpairs | Eigenvectors, Eigenvalues |
|---|
| Decompose | Eigen + Shift 求解器 | A, Pin, Num Eigenpairs, Shift | Eigenvectors, Eigenvalues |
|---|
| Solve with Decomposition | — | A, b, Pin, Decomposition | x |
|---|
| Multiply | — | A, x | x |
|---|
说明：Note: Num Eigenpairs 仅在only when Mode=Decompose + Decompose Mode=Eigen；不是始终显示。not always visible.
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
GeometryNodeMeshLaplacian · GeometryNodeTree
Mesh Laplacian
功能Function
从 Mesh 构建稀疏拉普拉斯/扩散矩阵（Uniform/Cotangent 等），供 Linear Solver 使用。
Builds sparse Laplacian/diffusion matrix from Mesh for Linear Solver.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| ModeMenu | Uniform 或 Cotangent 离散。Uniform or Cotangent. 显示条件Shown when: 始终显示always |
|---|
| MeshGeometry | 输入网格。Input mesh. 显示条件Shown when: 始终显示 / always |
|---|
| Diffusion MatrixBool | 是否构建扩散形式。Build diffusion form. default=False 显示条件Shown when: 始终显示 / always |
|---|
| Diffusion CoefficientFloat | 扩散系数。Diffusion coefficient. default=1.0 显示条件Shown when: 始终显示 / always |
|---|
| Use MassBool | 是否用质量矩阵。Include mass matrix. default=False 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| MatrixBundle | 稀疏矩阵 Bundle。Sparse matrix Bundle. |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
GeometryNodeObjectInfo · GeometryNodeTree
Object Info
功能Function
读取物体变换与几何；BIKINI 额外输出 Seed（稳定整数种子）。
Object transform/geometry; BIKINI adds Seed integer output.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| ObjectObject | 目标物体。Target object. 显示条件Shown when: 始终显示 / always |
|---|
| As InstanceBool | 是否作为实例。Output as instance. default=False 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| TransformMatrix | 物体变换矩阵。Object transform. |
|---|
| LocationVector | 位置。Location. |
|---|
| RotationRotation | 旋转。Rotation. |
|---|
| ScaleVector | 缩放。Scale. |
|---|
| SeedInt | BIKINI：稳定整数种子输出。BIKINI: stable integer Seed. |
|---|
| GeometryGeometry | 物体几何。Object geometry. |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
GeometryNodeSelectElements · GeometryNodeTree
Select Elements
功能Function
交互选择几何元素。仅选中本节点时按 Enter 进入原生 Edit Mode，用 B/C/1/2/3/A 等编辑模式快捷键点选/框选；Esc 确认写回索引，RMB 取消。输出透传 Geometry + Selection（Bool 场）。Domain（点/边/面/样条）由编辑会话中的选择模式决定并写入内部存储，不是节点上给用户调的 Input/菜单参数。
Interactive element pick. With only this node selected, Enter → native Edit Mode (B/C/1/2/3/A…); Esc commits indices, RMB cancels. Outputs pass-through Geometry + Selection. Domain is set by edit-mode selectmode when confirming — not a user-facing Input menu.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| GeometryGeometry | 输入：已实现的 Mesh 或 Curves（二选一，同时有会报错）。输出：透传同一几何。In: realized Mesh or Curves (not both). Out: pass-through geometry. 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| GeometryGeometry | 输入：已实现的 Mesh 或 Curves（二选一，同时有会报错）。输出：透传同一几何。In: realized Mesh or Curves (not both). Out: pass-through geometry. |
|---|
| SelectionBool | Bool 场：Esc 确认后选中的元素为 true（domain 由编辑模式选择方式写入内部，非用户菜单）。Bool field after Esc; domain comes from edit-mode selectmode (internal), not a user menu. |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
GeometryNodeEditElements · GeometryNodeTree
Edit Elements
功能Function
编辑已选几何元素（与 Select Elements 配合的编辑工作流节点）。
Edit selected geometry elements (paired with Select Elements).
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| GeometryGeometry | 待编辑几何。Geometry to edit. 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| GeometryGeometry | 待编辑几何。Geometry to edit. |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
GeometryNodeHeatGeodesic · GeometryNodeTree
Heat Geodesic
功能Function
基于热方法在网格上计算测地距离场：从 Source 点集向外扩散。
Heat-method geodesic distance field from Source points on a mesh.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| SourceBool | 测地距离源（点/选择）。Geodesic source points/selection. default=False 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| DistanceFloat | 测地距离场。Geodesic distance field. |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
GeometryNodeInstantMeshes · GeometryNodeTree
Instant Meshes
功能Function
Instant Meshes 各向同性重网格：Quad/Triangle 模式，按边长/面数/顶点数等目标控制分辨率。
Instant Meshes isotropic remesh: Quad/Triangle; targets edge length / face / vertex count.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| MeshGeometry | 输入网格。Input mesh. 显示条件Shown when: 始终显示 / always |
|---|
| ModeMenu | Quad 或 Triangle 重网格。Quad or Triangle remesh. 显示条件Shown when: 始终显示 / always |
|---|
| TargetMenu | 分辨率目标：Auto / Edge Length / Faces / Vertices。Resolution target mode. 显示条件Shown when: 始终显示 / always |
|---|
| Edge LengthFloatDistance | 目标边长（Target=Edge Length）。Target edge length. default=0.10000000149011612 显示条件Shown when: Target = Edge Length |
|---|
| Face CountInt | 目标面数（Target=Faces）。Target face count. default=1000 显示条件Shown when: Target = Faces |
|---|
| Vertex CountInt | 目标顶点数（Target=Vertices）。Target vertex count. default=1000 显示条件Shown when: Target = Vertices |
|---|
| Crease AngleFloatAngle | 折痕角度阈值。Crease angle threshold. default=0.5235987901687622 显示条件Shown when: 始终显示 / always |
|---|
| IterationsInt | 求解迭代。Solver iterations. default=6 显示条件Shown when: 始终显示 / always |
|---|
| Smooth IterationsInt | 光顺迭代。Smoothing iterations. default=2 显示条件Shown when: 始终显示 / always |
|---|
| ExtrinsicBool | 是否使用外在度量。Use extrinsic metric. default=True 显示条件Shown when: 始终显示 / always |
|---|
| Align BoundariesBool | 对齐边界。Align to boundaries. default=True 显示条件Shown when: 始终显示 / always |
|---|
| Pure QuadBool | 纯四边（仅 Mode=Quad）。Pure quads (Mode=Quad only). default=True 显示条件Shown when: Mode = Quad |
|---|
| DeterministicBool | 确定性结果。Deterministic output. default=True 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| MeshGeometry | 输入网格。Input mesh. |
|---|
菜单模式与接口显隐Menus & input visibility
Mode Menu
默认Default: Triangle · 全部All: Quad, Triangle
| 模式Mode | 此时显示的 InputsInputs shown |
|---|
Quad | Mesh, Mode, Target, Edge Length, Face Count, Vertex Count, Crease Angle, Iterations, Smooth Iterations, Extrinsic, Align Boundaries, Pure Quad, Deterministic |
|---|
Triangle | Mesh, Mode, Target, Edge Length, Face Count, Vertex Count, Crease Angle, Iterations, Smooth Iterations, Extrinsic, Align Boundaries, Deterministic |
|---|
Target Menu
默认Default: Vertices · 全部All: Auto, Edge Length, Faces, Vertices
| 模式Mode | 此时显示的 InputsInputs shown |
|---|
Auto | Mesh, Mode, Target, Crease Angle, Iterations, Smooth Iterations, Extrinsic, Align Boundaries, Deterministic, Pure Quad |
|---|
Edge Length | Mesh, Mode, Target, Crease Angle, Iterations, Smooth Iterations, Extrinsic, Align Boundaries, Deterministic, Edge Length |
|---|
Faces | Mesh, Mode, Target, Crease Angle, Iterations, Smooth Iterations, Extrinsic, Align Boundaries, Deterministic, Face Count |
|---|
Vertices | Mesh, Mode, Target, Crease Angle, Iterations, Smooth Iterations, Extrinsic, Align Boundaries, Deterministic, Vertex Count |
|---|
另：Also: Pure Quad 仅当only when Mode = Quad。
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
GeometryNodeQuadWild · GeometryNodeTree
QuadWild
功能Function
QuadWild 四边重网格 / 场 / 布局流程（Mode 切换 Remesh、Field、Layout）。
QuadWild quad remesh / field / layout (Mode: Remesh, Field, Layout).
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| MeshGeometry | 输入网格。Input mesh. 显示条件Shown when: 始终显示 / always |
|---|
| ModeMenu | Remesh / Field / Layout。Remesh / Field / Layout. 显示条件Shown when: 始终显示 / always |
|---|
| Sharp AngleFloatAngle | 尖锐特征角度。Sharp feature angle. default=0.6108652353286743 显示条件Shown when: 始终显示 / always |
|---|
| Remesh InputBool | 是否先重网格输入。Remesh input first. default=True 显示条件Shown when: 始终显示 / always |
|---|
| ScaleFloat | 尺度。Scale. default=1.0 显示条件Shown when: 始终显示 / always |
|---|
| AlphaFloat | Alpha 参数。Alpha parameter. default=0.004999999888241291 显示条件Shown when: 始终显示 / always |
|---|
| Smooth OutputBool | 输出光顺。Smooth output. default=True 显示条件Shown when: 始终显示 / always |
|---|
| Attribute PrefixString | 输出属性名前缀。Attribute name prefix. default=qw_dir 显示条件Shown when: 始终显示 / always |
|---|
| Mark SeamsBool | 标记缝线。Mark seams. default=True 显示条件Shown when: 始终显示 / always |
|---|
| Boundary AttributeString | 边界属性名。Boundary attribute name. default=qw_layout_boundary 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| MeshGeometry | 输入网格。Input mesh. |
|---|
菜单模式与接口显隐Menus & input visibility
Mode Menu
默认Default: Layout · 全部All: Remesh, Field, Layout
| 模式Mode | 此时显示的 InputsInputs shown |
|---|
Remesh | Mesh, Mode, Sharp Angle, Remesh Input, Scale, Alpha, Smooth Output, Attribute Prefix, Mark Seams, Boundary Attribute |
|---|
Field | Mesh, Mode, Sharp Angle, Remesh Input, Scale, Alpha, Smooth Output, Attribute Prefix, Mark Seams, Boundary Attribute |
|---|
Layout | Mesh, Mode, Sharp Angle, Remesh Input, Scale, Alpha, Smooth Output, Attribute Prefix, Mark Seams, Boundary Attribute |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
GeometryNodeTriangleRemesh · GeometryNodeTree
Triangle Remesh
功能Function
三角形重网格：均匀或自适应边长，可保边界、贴合原表面。
Triangle remesh: uniform or adaptive edge length; optional boundary protect & surface project.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| MeshGeometry | 输入网格。Input mesh. 显示条件Shown when: 始终显示 / always |
|---|
| ModeMenu | Uniform 或 Adaptive。Uniform or Adaptive. 显示条件Shown when: 始终显示 / always |
|---|
| Edge LengthFloatDistance | 均匀目标边长。Uniform target edge length. default=0.10000000149011612 显示条件Shown when: 始终显示 / always |
|---|
| Min Edge LengthFloatDistance | 自适应最小边长。Adaptive min edge length. default=0.05000000074505806 显示条件Shown when: 始终显示 / always |
|---|
| Max Edge LengthFloatDistance | 自适应最大边长。Adaptive max edge length. default=0.20000000298023224 显示条件Shown when: 始终显示 / always |
|---|
| Approximation ErrorFloatDistance | 逼近误差。Approximation error. default=0.009999999776482582 显示条件Shown when: 始终显示 / always |
|---|
| IterationsInt | 迭代次数。Iterations. default=10 显示条件Shown when: 始终显示 / always |
|---|
| Crease AngleFloatAngle | 折痕角。Crease angle. default=0.5235987901687622 显示条件Shown when: 始终显示 / always |
|---|
| Project to SurfaceBool | 投影回原表面。Project to original surface. default=True 显示条件Shown when: 始终显示 / always |
|---|
| Protect BoundariesBool | 保护边界。Protect boundaries. default=True 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| MeshGeometry | 输入网格。Input mesh. |
|---|
菜单模式与接口显隐Menus & input visibility
Mode Menu
默认Default: Adaptive · 全部All: Uniform, Adaptive
| 模式Mode | 此时显示的 InputsInputs shown |
|---|
Uniform | Mesh, Mode, Edge Length, Min Edge Length, Max Edge Length, Approximation Error, Iterations, Crease Angle, Project to Surface, Protect Boundaries |
|---|
Adaptive | Mesh, Mode, Edge Length, Min Edge Length, Max Edge Length, Approximation Error, Iterations, Crease Angle, Project to Surface, Protect Boundaries |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
GeometryNodeVoronoiFracture · GeometryNodeTree
Voronoi Fracture
功能Function
用站点 Points 对 Geometry 做 Voronoi 破碎；Gap/Inside/Max Neighbors 控制裂缝与邻域。
Voronoi fracture of Geometry by site Points; Gap/Inside/Max Neighbors control cells.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| GeometryGeometry | 被破碎几何。Geometry to fracture. 显示条件Shown when: 始终显示 / always |
|---|
| PointsGeometry | Voronoi 站点。Voronoi sites. 显示条件Shown when: 始终显示 / always |
|---|
| GapFloatDistance | 单元间隙。Gap between cells. default=0.0 显示条件Shown when: 始终显示 / always |
|---|
| InsideBool | 是否只保留内部。Keep interior only. default=True 显示条件Shown when: 始终显示 / always |
|---|
| Max NeighborsInt | 最大邻居数上限。Max neighbor cap. default=0 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| GeometryGeometry | 被破碎几何。Geometry to fracture. |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
GeometryNodeDelaunay3D · GeometryNodeTree
Delaunay 3D
功能Function
对 3D 点集做 Delaunay 四面体化，输出 Mesh（顶点=站点，边/面为 Delaunay 连接；含 site_index）。独立工具，不依赖 Voronoi Fracture 主路径。
3D Delaunay tetrahedralization → Mesh (sites + dual edges/faces; site_index). Standalone tool.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| PointsGeometry | 3D 站点点云/网格点。3D site points. 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| MeshGeometry | 四面体化结果网格（含 site_index）。Tetrahedralized mesh (site_index). |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
GeometryNodeWriteAtIndex · GeometryNodeTree
Write at Index
功能Function
场节点：按 Target Index 把 Value 原子写入目标域（可跨 Domain），冲突时用 Atomic Operator 归并。
Field write: scatter Value into target domain by Target Index; Atomic Operator merges collisions.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| Data TypeMenu | Value 类型：Float / Integer / Vector。Value type: Float/Int/Vector. 显示条件Shown when: 始终显示always |
|---|
| Source DomainMenu | 求值 Target Index 与 Value 的域。Domain for evaluating index & value. 显示条件Shown when: 始终显示always |
|---|
| Target DomainMenu | 写入目标域。Domain receiving writes. 显示条件Shown when: 始终显示always |
|---|
| Atomic OperatorMenu | 多源写同一索引时：Sum / Min / Max / Mean。Merge rule on collision: Sum/Min/Max/Mean. 显示条件Shown when: 始终显示always |
|---|
| Target IndexInt | 每个源元素映射的目标索引（越界忽略）。Target index per source element. default=0 显示条件Shown when: 始终显示 / always |
|---|
| ValueFloat | 要写入的场值；输出为归并后的目标域场。Value field; output is merged target-domain field. default=0.0 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| ValueFloat | 要写入的场值；输出为归并后的目标域场。Value field; output is merged target-domain field. |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
GeometryNodeRBFInterpolate · GeometryNodeTree
RBF Interpolate
功能Function
从 Source 采样点上的 Value 拟合径向基（RBF）插值，使采样点精确还原 f(xᵢ)=vᵢ（解 Φw=v，非核加权平均）；在 Sample Position 上求值输出 Value。菜单 Geometry → Sample。
Fits a radial-basis interpolant through Source sample Values so f(xᵢ)=vᵢ exactly (solves Φw=v, not NW kernel average); evaluates on Sample Position. Menu: Geometry → Sample.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| Data TypeMenu | Value 属性类型（节点头；有 socket 的 attribute type）。Value attribute type (node header; attribute types with sockets). 显示条件Shown when: 始终显示always |
|---|
| SourceGeometry | 采样点几何（Mesh 顶点或 Point Cloud）。Sample points (Mesh verts or Point Cloud). 显示条件Shown when: 始终显示 / always |
|---|
| ValueField | 采样点上的属性/场（evaluated_geometry_field）。Attribute/field on sample points (evaluated_geometry_field). 显示条件Shown when: 始终显示 / always |
|---|
| Sample PositionVector | 求值位置（默认上下文 Position）。Evaluation positions (defaults to context Position). default=Position 显示条件Shown when: 始终显示 / always |
|---|
| Kernel TypeMenu | 径向基 φ(r)，q=r/size。Kernel 面板。Radial basis φ(r), q=r/size. Kernel panel. 显示条件Shown when: 始终显示always |
|---|
| Kernel SizeFloat | 核形状参数 / 支撑半径（Distance）。Shape parameter / support radius (Distance). default=1.0 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| ValueField | 插值结果；在采样点上等于原值，别处平滑（RBF 薄膜）。Interpolated field; exact at samples, smooth elsewhere (RBF film). |
|---|
菜单模式与接口显隐Menus & input visibility
Kernel Type Menu
默认Default: Gaussian · 全部All: Gaussian, Inverse Multiquadric, Linear, Cubic, Quintic, Wendland C2
| Kernel Type | φ(q), q = r / size |
|---|
Gaussian | exp(−q²) |
|---|
Inverse Multiquadric | 1 / √(1+q²) |
|---|
Linear | max(0, 1−q) |
|---|
Cubic | max(0, (1−q)³) |
|---|
Quintic | max(0, (1−q)⁵) |
|---|
Wendland C2 | q<1: (1−q)⁴(4q+1); else 0 |
|---|
限制Limits: n ≤ 4096（稠密 O(n³)）；n > 512 提示可能较慢。对角 +1e-8 正则。
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
GeometryNodeMeshGraphColoring · GeometryNodeTree
Mesh Graph Coloring
功能Function
对网格图做顶点染色，写入属性 Name，输出 Color Count。
Graph-colors the mesh, stores attribute Name, outputs Color Count.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| MeshGeometry | 输入网格。Input mesh. 显示条件Shown when: 始终显示 / always |
|---|
| NameString | 写入的颜色属性名（点域整数色号）。Color attribute name (point domain). default=color 显示条件Shown when: 始终显示 / always |
|---|
| AlgorithmMenu | 染色算法菜单：Greedy / Greedy Random / Welsh–Powell / DSatur / RLF。Coloring algorithm menu. 显示条件Shown when: 始终显示 / always |
|---|
| SeedInt | 仅 Greedy Random：随机置换顶点顺序的种子。其它算法不显示。Only for Greedy Random: seed for random vertex permutation. Hidden otherwise. default=0 显示条件Shown when: Algorithm = Greedy Random |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| MeshGeometry | 输入网格。Input mesh. |
|---|
| Color CountInt | 使用的颜色数。Number of colors used. |
|---|
菜单模式与接口显隐Menus & input visibility
Algorithm Menu
默认Default: DSatur · 全部All: Greedy, Greedy Random, Welsh–Powell, DSatur, RLF
| Algorithm | 显示的 InputsInputs shown |
|---|
Greedy | Mesh, Name, Algorithm |
|---|
Greedy Random | Mesh, Name, Algorithm, Seed |
|---|
Welsh–Powell | Mesh, Name, Algorithm |
|---|
DSatur | Mesh, Name, Algorithm |
|---|
RLF | Mesh, Name, Algorithm |
|---|
Seed：源码source usage_by_single_menu(GreedyRandom) — 仅 Greedy Random 显示。only when Algorithm = Greedy Random.
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
GeometryNodeTangentField · GeometryNodeTree
Tangent Field
功能Function
在网格上生成 N 路切向场，写入以 Prefix 命名的属性。
Builds N tangent directions on the mesh; stores attributes with Prefix.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| MeshGeometry | 输入网格。Input mesh. 显示条件Shown when: 始终显示 / always |
|---|
| NInt | 切向场路数。Number of tangent directions. default=4 显示条件Shown when: 始终显示 / always |
|---|
| PrefixString | 属性名前缀。Attribute prefix. default=dir 显示条件Shown when: 始终显示 / always |
|---|
| NormalizeBool | 是否单位化方向。Normalize directions. default=True 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| MeshGeometry | 输入网格。Input mesh. |
|---|
| DirectionsInt | 方向场输出。Direction field output. |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
GeometryNodeMeshGradient · GeometryNodeTree
Gradient
功能Function
对网格顶点上的标量场 Value 求每面梯度（首三角线性拟合）。勿与官方 Grid Gradient 混淆。输出 Gradient 为面域向量场，可适配其它域。
Per-face gradient of a scalar field defined on mesh vertices (linear fit on first triangle of each face). Not official Grid Gradient. Gradient is face-domain; may adapt to other domains.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| ValueFloat | 定义在网格顶点上的标量场。Scalar field on mesh vertices. 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| GradientVector | 每面梯度向量（优先 Face 域）。Per-face gradient vector (preferred Face domain). |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
GeometryNodeMeshDivergence · GeometryNodeTree
Divergence
功能Function
对网格向量场求每顶点离散散度（三角上线性 FEM：∂Vx/∂x+∂Vy/∂y+∂Vz/∂z，面积加权）。Vector 在顶点求值。勿与官方 Grid Divergence 混淆。
Per-vertex discrete divergence of a mesh vector field (linear FEM on triangles; area-weighted). Vector evaluated on vertices. Not official Grid Divergence.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| VectorVector | 网格上的向量场（顶点求值；面域属性会插值到点）。Vector field on mesh (eval on verts; face attrs interpolate to points). 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| DivergenceFloat | 每顶点散度标量（优先 Point 域）。Per-vertex divergence scalar (preferred Point domain). |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
GeometryNodeCurveIntersections · GeometryNodeTree
Curve Intersections
功能Function
计算曲线交点并输出点云及相关属性。Mode：Curve（3D 曲线互交）/ Curve Project（投影后互交）/ Plane（与平面）/ Surface（与网格表面）。Paired Data Mode 仅在 Curve/Curve Project 下出现；Full Data 时输出配对字段。
Curve intersections → point cloud + fields. Mode: Curve / Curve Project / Plane / Surface. Paired Data Mode only for Curve modes; Full Data enables pair outputs.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| ModeMenu | 求交模式：Curve / Curve Project / Plane / Surface。Intersection mode: Curve / Curve Project / Plane / Surface. 显示条件Shown when: 始终显示 / always |
|---|
| Paired Data ModeMenu | Points Only 只交点；Full Data 另输出配对位置/方向/ID。仅 Mode=Curve 或 Curve Project 时显示。Points Only vs Full Data (pair fields). Only for Curve / Curve Project. 显示条件Shown when: Mode ∈ {Curve, Curve Project} |
|---|
| CurveGeometry | 输入曲线几何。Input curve geometry. 显示条件Shown when: 始终显示 / always |
|---|
| MeshGeometry | 表面网格（仅 Mode=Surface）。Surface mesh (Mode=Surface only). 显示条件Shown when: Mode = Surface |
|---|
| Self IntersectionsBool | 是否包含自交（Curve / Curve Project）。Include self-intersections (Curve modes). default=False 显示条件Shown when: Mode ∈ {Curve, Curve Project} |
|---|
| All IntersectionsBool | 是否包含全部非自交交点（Curve / Curve Project）。Include all non-self intersections (Curve modes). default=True 显示条件Shown when: Mode ∈ {Curve, Curve Project} |
|---|
| DistanceFloatDistance | 交点之间的最大距离阈值（Curve / Curve Project）。Max distance between intersections (Curve modes). default=0.0 显示条件Shown when: Mode ∈ {Curve, Curve Project} |
|---|
| DirectionVector | 输入：平面/正交投影方向（Plane、Curve Project）。输出：交点处曲线方向（Project 模式为投影后方向）。In: plane/ortho direction (Plane, Curve Project). Out: curve direction at hit (projected in Project mode). default=[0.0, 0.0, 1.0] 显示条件Shown when: Mode ∈ {Plane, Curve Project} |
|---|
| CenterVector | 平面中心（仅 Mode=Plane）。Plane center (Mode=Plane only). default=[0.0, 0.0, 0.0] 显示条件Shown when: Mode = Plane |
|---|
| Min AngleFloatAngle | 交点最短夹角下限（始终显示）。Minimum shortest intersection angle (always). default=0.0 显示条件Shown when: 始终显示 / always |
|---|
| Max AngleFloatAngle | 交点最短夹角上限（始终显示，默认 π/2）。Maximum shortest intersection angle (always, default π/2). default=1.5707963705062866 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| PointsGeometry | 交点点云。Intersection point cloud. |
|---|
| Curve IndexInt | 交点所属曲线索引（Full Data 或 Plane/Surface 时可用）。Curve index field (Full Data or Plane/Surface). 显示条件Shown when: Paired Data Mode = Full Data，或 Mode ∈ {Plane, Surface} |
|---|
| DirectionVector | 输入：平面/正交投影方向（Plane、Curve Project）。输出：交点处曲线方向（Project 模式为投影后方向）。In: plane/ortho direction (Plane, Curve Project). Out: curve direction at hit (projected in Project mode). 显示条件Shown when: Paired Data Mode = Full Data，或 Mode ∈ {Plane, Surface} |
|---|
| FactorFloat | 样条总长比例因子。Fraction of spline length. 显示条件Shown when: Paired Data Mode = Full Data，或 Mode ∈ {Plane, Surface} |
|---|
| LengthFloat | 沿样条弧长。Distance along spline. 显示条件Shown when: Paired Data Mode = Full Data，或 Mode ∈ {Plane, Surface} |
|---|
| NormalVector | 表面法线（Mode=Surface 时显示）。Surface normal (Mode=Surface). 显示条件Shown when: Mode = Surface |
|---|
| Pair PositionVector | 配对交点位置（Full Data）。Opposing pair position. 显示条件Shown when: Paired Data Mode = Full Data |
|---|
| Pair DirectionVector | 配对交点方向（Full Data）。Opposing pair direction. 显示条件Shown when: Paired Data Mode = Full Data |
|---|
| PairBool | 是否为配对交点之一（Full Data）。Is one of a matching pair. 显示条件Shown when: Paired Data Mode = Full Data |
|---|
| Pair IDInt | 配对唯一 ID（Full Data）。Unique pair ID. 显示条件Shown when: Paired Data Mode = Full Data |
|---|
菜单模式与接口显隐Menus & input visibility
Mode Menu
默认Default: Curve · Curve / Curve Project / Plane / Surface
| Mode | 额外显示的 InputsExtra inputs | 备注Notes |
|---|
Curve | Paired Data Mode, Self Intersections, All Intersections, Distance | 3D 曲线–曲线求交 |
|---|
Curve Project | Paired Data Mode, Self Intersections, All Intersections, Distance, Direction | 投影到正交平面后求交；Direction=投影平面法向 |
|---|
Plane | Direction, Center | 曲线与平面求交 |
|---|
Surface | Mesh | 曲线与网格表面求交 |
|---|
始终显示Always: Mode, Curve, Min Angle, Max Angle
Paired Data Mode Menu
仅当Only when Mode ∈ {Curve, Curve Project}。默认Default: Points Only。
| Paired Data Mode | 额外 OutputsExtra outputs |
|---|
Points Only | — |
|---|
Full Data | Pair Position, Pair Direction, Pair, Pair ID；且 Curve Index / Direction / Factor / Length 等字段输出可用 |
|---|
输出Outputs: Normal → Mode=Surface；Curve Index/Direction/Factor/Length → Full Data 或 Mode∈{Plane,Surface}（源码 usage_inference）。
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
NodeExpression · GeometryNodeTree
Expression
功能Function
表达式节点：字符串 Expression + 可扩展输入项；求值得到输出。支持自动补全（见 Notes）。类型 id 为 NodeExpression。
Expression string + extendable inputs → result. Autocomplete available. Type id: NodeExpression.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| ExpressionString | 表达式字符串（输入为源码；输出为求值结果类型随式子）。Expression string (in) / evaluated result (out). 显示条件Shown when: 始终显示 / always |
|---|
| （动态扩展）(dynamic extend)Virtual | 拖线或侧栏添加自定义输入项Drag or sidebar to add custom inputs always |
|---|
| （动态扩展）(dynamic extend)Virtual | 拖线或侧栏添加自定义输入项Drag or sidebar to add custom inputs always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| ExpressionColor | 表达式字符串（输入为源码；输出为求值结果类型随式子）。Expression string (in) / evaluated result (out). |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
ImageNodeImportPoints · ImageNodeTree
Import Points
功能Function
嵌套 Geometry Nodes 树生成点云；双击进入编辑。输出 Points 及 rotation/size/id 等属性约定。
Nested GN tree → point cloud. Double-click to edit. Points with rotation/size/id conventions.
Inputs
—
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| PointsGeometry | 嵌套 GN 生成的点几何。Points from nested GN. |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
ImageNodePointStamp · ImageNodeTree
Point Stamp
功能Function
按点属性把多张 Stamp 纹理盖到 UV 平面：id 选纹理，rotation/size 控制朝向与尺寸。
Stamp multi textures at points using id/rotation/size; outputs Color + Bundle.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| PointsGeometry | 点几何（含 rotation/size/id）。Points with rotation/size/id. 显示条件Shown when: 始终显示 / always |
|---|
| StampColor | 多路 Stamp 纹理（multi-input）。Multi-input stamp textures. default=[0.800000011920929, 0.800000011920929, 0.800000011920929, 1.0] 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| ColorColor | 盖章合成的颜色图。Stamped color image. |
|---|
| BundleBundle | 点属性 Bundle 签名。Point attribute Bundle. |
|---|
| radiusFloat | — |
|---|
| sizeVector2D | — |
|---|
| idInt | — |
|---|
| alphaFloat | — |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
ImageNodeNormalToHeight · ImageNodeTree
Normal to Height
功能Function
法线贴图 → 高度图（积分/重建）；Scale/Invert 调节。
Normal map → height map; Scale/Invert.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| NormalColor | 输入法线。Input normal. default=[0.5, 0.5, 1.0, 1.0] 显示条件Shown when: 始终显示 / always |
|---|
| ScaleFloat | 高度尺度。Height scale. default=1.0 显示条件Shown when: 始终显示 / always |
|---|
| InvertBool | 反转。Invert. default=False 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| HeightColor | 输出高度。Output height. |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
ImageNodeHeightToNormal · ImageNodeTree
Height to Normal
功能Function
高度图 → 法线贴图；Scale/Invert 调节。
Height map → normal map; Scale/Invert.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| HeightColor | 输入高度。Input height. default=[0.5, 0.5, 0.5, 1.0] 显示条件Shown when: 始终显示 / always |
|---|
| ScaleFloat | 法线强度。Normal strength. default=1.0 显示条件Shown when: 始终显示 / always |
|---|
| InvertBool | 反转。Invert. default=False 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| NormalColor | 输出法线。Output normal. |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
ImageNodeBakeImage · ImageNodeTree
Bake Image
功能Function
把求值后的图像写出到磁盘。仅点击节点体 Bake 按钮时写盘（不在每次树求值时写出）。节点体菜单：Format（PNG/JPEG/OpenEXR/…）、Color Space（默认 Auto）；接口 Path / Prefix + 可扩展多路 Image（socket 名=文件名主体）。
Write evaluated images to disk only when pressing Bake (not every cook). Node-body: Format + Color Space; sockets Path/Prefix + extendable Image slots (name = filename stem).
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| BakeOperator | 节点体上的 Bake 按钮（node.image_process_bake）。仅点击时写盘，不在每次 cook 时写出。Bake button on node body; writes disk only when pressed, not on every cook. 显示条件Shown when: 始终显示 / always |
|---|
| FormatMenu | 输出图片格式（节点体菜单，非 socket）。Output image format (node-body menu, not a socket). 显示条件Shown when: 始终显示 / always |
|---|
| Color SpaceMenu | 写出颜色空间。默认 Auto（空存储 / RNA 默认 AUTO）；界面从颜色管理列表选，与 Blender 图像保存一致。Output color space; default Auto. Picked from color management list. 显示条件Shown when: 始终显示 / always |
|---|
| PathStringFilePath | 输出目录。// 相对已保存 .blend（如 //textures/）；未保存 blend 不会回退到 exe 目录；也可绝对路径。Output directory. // relative to saved .blend; absolute path allowed. default=// 显示条件Shown when: 始终显示 / always |
|---|
| PrefixString | 可选文件名前缀，加在各 Image 槽名称前（如 shot_ + Color → shot_Color.png）。Optional prefix before each image item name. 显示条件Shown when: 始终显示 / always |
|---|
| ImageColor | 要烘焙的图像。可用扩展槽添加多路；socket 名称即输出文件名主体（加 Prefix + 扩展名）。Image to bake; extend for more. Socket name = filename stem (+ Prefix + ext). default=[0.0, 0.0, 0.0, 1.0] 显示条件Shown when: 始终显示 / always |
|---|
| （动态扩展）(dynamic extend)Virtual | 拖线或侧栏添加自定义输入项Drag or sidebar to add custom inputs always |
|---|
Outputs
—
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
ImageNodeFileOutput · ImageNodeTree
Image Output
功能Function
GPU TE 图像输出节点：命名输出 Image 供查看/下游。
GPU TE image output with Name for display/downstream.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| ImageColor | 输出图像。Image to output. default=[0.0, 0.0, 0.0, 1.0] 显示条件Shown when: 始终显示 / always |
|---|
| NameString | 输出名称（编辑器内标识）。Output name in editor. default=GPU Texture Editor Output 显示条件Shown when: 始终显示 / always |
|---|
Outputs
—
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
ImageNodeGradient · ImageNodeTree
Gradient
功能Function
对标量/彩色图像求空间梯度，输出 Gradient 向量。
Spatial gradient of image → Gradient vector.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| ImageColor | 输入标量/彩色图。Input image. default=[1.0, 1.0, 1.0, 1.0] 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| GradientVector | 梯度向量。Gradient vector. |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
ImageNodeDivergence · ImageNodeTree
Divergence
功能Function
对二维向量场求散度 ∇·V，输出标量 Divergence 图像。
Divergence ∇·V of a 2D vector field → scalar image.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| VectorVector | 输入向量场（通常 xy）。Input vector field. default=[0.0, 0.0, 0.0] 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| DivergenceFloat | 散度标量图。Scalar divergence. |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
ImageNodeFluidSimInput · ImageNodeTree
Fluid Simulation Input
功能Function
流体模拟区输入端：传入/回传速度、温度、散度、碰撞等场。
Fluid sim zone input: velocity/temperature/divergence/collision fields.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| VelocityVectorXYZ2D | 速度场。Velocity field. default=[0.0, 0.0] 显示条件Shown when: 始终显示 / always |
|---|
| TemperatureFloat | 温度场。Temperature. default=0.0 显示条件Shown when: 始终显示 / always |
|---|
| DivergenceFloat | 散度场。Divergence. default=0.0 显示条件Shown when: 始终显示 / always |
|---|
| Collision MaskFloat | 碰撞遮罩。Collision mask. default=0.0 显示条件Shown when: 始终显示 / always |
|---|
| Collider VelocityVectorXYZ2D | 碰撞体速度。Collider velocity. default=[0.0, 0.0] 显示条件Shown when: 始终显示 / always |
|---|
| Air MaskFloat | 空气遮罩。Air mask. default=0.0 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| Delta TimeFloat | 时间步长。Time step. |
|---|
| VelocityVector2D | 速度场。Velocity field. |
|---|
| TemperatureFloat | 温度场。Temperature. |
|---|
| DivergenceFloat | 散度场。Divergence. |
|---|
| Collision MaskFloat | 碰撞遮罩。Collision mask. |
|---|
| Collider VelocityVector2D | 碰撞体速度。Collider velocity. |
|---|
| Air MaskFloat | 空气遮罩。Air mask. |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
ImageNodeFluidSimOutput · ImageNodeTree
Fluid Simulation Output
功能Function
流体模拟区输出端：汇总模拟后的 Color 与各物理场。
Fluid sim zone output: Color and physics fields after step.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| ColorColor | 模拟输出颜色。Sim color. default=[0.0, 0.0, 0.0, 1.0] 显示条件Shown when: 始终显示 / always |
|---|
| （动态扩展）(dynamic extend)Virtual | 拖线或侧栏添加自定义输入项Drag or sidebar to add custom inputs always |
|---|
| VelocityVectorXYZ2D | 速度场。Velocity field. default=[0.0, 0.0] 显示条件Shown when: 始终显示 / always |
|---|
| TemperatureFloat | 温度场。Temperature. default=0.0 显示条件Shown when: 始终显示 / always |
|---|
| DivergenceFloat | 散度场。Divergence. default=0.0 显示条件Shown when: 始终显示 / always |
|---|
| Collision MaskFloat | 碰撞遮罩。Collision mask. default=0.0 显示条件Shown when: 始终显示 / always |
|---|
| Collider VelocityVectorXYZ2D | 碰撞体速度。Collider velocity. default=[0.0, 0.0] 显示条件Shown when: 始终显示 / always |
|---|
| Air MaskFloat | 空气遮罩。Air mask. default=0.0 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| ColorColor | 模拟输出颜色。Sim color. |
|---|
| VelocityVector2D | 速度场。Velocity field. |
|---|
| TemperatureFloat | 温度场。Temperature. |
|---|
| DivergenceFloat | 散度场。Divergence. |
|---|
| Collision MaskFloat | 碰撞遮罩。Collision mask. |
|---|
| Collider VelocityVector2D | 碰撞体速度。Collider velocity. |
|---|
| Air MaskFloat | 空气遮罩。Air mask. |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
ImageNodeRasterizeGeometry · ImageNodeTree
Rasterize Geometry
功能Function
把几何/物体光栅化到图像域（世界空间或 UV），输出 Position/Normal/Alpha 与属性通道。
Rasterize geometry/object to image (world or UV); Position/Normal/Alpha + attributes.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| ModeMenu | World Space 或 UV Space。World or UV space. 显示条件Shown when: 始终显示 / always |
|---|
| ObjectObject | 要光栅化的物体。Object to rasterize. 显示条件Shown when: 始终显示 / always |
|---|
| Ray OriginVectorTranslation | 射线原点（相关模式）。Ray origin. default=[0.0, 0.0, 0.0] 显示条件Shown when: 始终显示 / always |
|---|
| Ray DirectionVector | 射线方向。Ray direction. default=[0.0, 0.0, 1.0] 显示条件Shown when: 始终显示 / always |
|---|
| SizeFloat | 输出尺寸相关。Size related. default=2.0 显示条件Shown when: 始终显示 / always |
|---|
| UV MapString | UV 属性名。UV map name. 显示条件Shown when: 始终显示 / always |
|---|
| AttributesString | 要光栅化的属性。Attributes to rasterize. 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| PositionVector | 光栅化位置。Rasterized position. |
|---|
| NormalVector | 光栅化法线。Rasterized normal. |
|---|
| AlphaFloat | 覆盖 alpha。Coverage alpha. |
|---|
| AttributesBundle | 要光栅化的属性。Attributes to rasterize. |
|---|
菜单模式与接口显隐Menus & input visibility
Mode Menu
默认Default: UV Space · 全部All: World Space, UV Space
| 模式Mode | 此时显示的 InputsInputs shown |
|---|
World Space | Mode, Object, Ray Origin, Ray Direction, Size, UV Map, Attributes |
|---|
UV Space | Mode, Object, Ray Origin, Ray Direction, Size, UV Map, Attributes |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
ImageNodeSampleAtPixel · ImageNodeTree
Sample at Pixel
功能Function
在整数像素坐标 Pixel 处采样 Image，输出 Value。
Sample Image at integer Pixel → Value.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| ImageColor | 被采样图像。Image to sample. default=[0.0, 0.0, 0.0, 1.0] 显示条件Shown when: 始终显示 / always |
|---|
| PixelVectorPixel2D | 整数像素坐标。Integer pixel coord. default=[0.0, 0.0] 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| ValueColor | 采样值。Sampled value. |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
ImageNodeWriteAtPixel · ImageNodeTree
Write at Pixel
功能Function
向像素 Pixel 写入 Value；多源冲突时用 Atomic Operator 归并。
Write Value at Pixel; Atomic Operator merges concurrent writes.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| Atomic OperatorMenu | 多写冲突归并算子。Merge op for concurrent writes. 显示条件Shown when: 始终显示 / always |
|---|
| PixelVectorPixel2D | 写入像素坐标。Pixel to write. default=[0.0, 0.0] 显示条件Shown when: 始终显示 / always |
|---|
| ValueColor | 写入/输出值。Value written / result. default=[1.0, 1.0, 1.0, 1.0] 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| ValueColor | 写入/输出值。Value written / result. |
|---|
菜单模式与接口显隐Menus & input visibility
Atomic Operator Menu
默认Default: Mean · 全部All: Sum, Min, Max, Mean
| 模式Mode | 此时显示的 InputsInputs shown |
|---|
Sum | Atomic Operator, Pixel, Value |
|---|
Min | Atomic Operator, Pixel, Value |
|---|
Max | Atomic Operator, Pixel, Value |
|---|
Mean | Atomic Operator, Pixel, Value |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
ImageNodePaint · ImageNodeTree
Paint
功能Function
在 GPU Texture Editor 内交互绘制，输出 Color 与 Alpha。
Interactive paint in GPU TE; outputs Color and Alpha.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| ColorColor | 画布颜色输入/输出。Canvas color in/out. default=[0.0, 0.0, 0.0, 1.0] 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| ColorColor | 画布颜色输入/输出。Canvas color in/out. |
|---|
| AlphaFloat | 绘制 alpha。Paint alpha. |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
ImageNodeHistogram · ImageNodeTree
Histogram
功能Function
直方图/色阶类处理：按通道拉伸或裁剪色调映射。
Histogram / levels-style remap by channel.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| ColorColor | 输入图像。Input image. default=[0.0, 0.0, 0.0, 1.0] 显示条件Shown when: 始终显示 / always |
|---|
| ChannelMenu | RGB / 单通道 / Luma。RGB / single / Luma. 显示条件Shown when: 始终显示 / always |
|---|
| AutoBool | 自动色阶。Auto levels. default=False 显示条件Shown when: 始终显示 / always |
|---|
| ClipFloatFactor | 裁剪比例。Clip amount. default=0.0010000000474974513 显示条件Shown when: 始终显示 / always |
|---|
| Output BlackFloatFactor | 输出黑点。Output black. default=0.0 显示条件Shown when: 始终显示 / always |
|---|
| Output WhiteFloatFactor | 输出白点。Output white. default=1.0 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| ColorColor | 输入图像。Input image. |
|---|
菜单模式与接口显隐Menus & input visibility
Channel Menu
默认Default: Luma · 全部All: RGB, Red, Green, Blue, Luma
| 模式Mode | 此时显示的 InputsInputs shown |
|---|
RGB | Color, Channel, Auto, Clip, Output Black, Output White |
|---|
Red | Color, Channel, Auto, Clip, Output Black, Output White |
|---|
Green | Color, Channel, Auto, Clip, Output Black, Output White |
|---|
Blue | Color, Channel, Auto, Clip, Output Black, Output White |
|---|
Luma | Color, Channel, Auto, Clip, Output Black, Output White |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
ImageNodeSDFShape · ImageNodeTree
SDF Shape
功能Function
解析 SDF 基元（球、盒、环等 Shape 菜单），输出有符号距离。
Analytic SDF primitives (Shape menu) → signed distance.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| ShapeMenu | SDF 基元类型菜单。SDF primitive type. 显示条件Shown when: always |
|---|
| VectorVector | 采样坐标。Sample position. default=[0.0, 0.0, 0.0] 显示条件Shown when: 始终显示 / always |
|---|
| RadiusFloat | 半径。Radius. default=0.4000000059604645 显示条件Shown when: Shape ∈ （35 种形状，见下表） |
|---|
| SizeVector | 盒/尺寸。Size. default=[0.4000000059604645, 0.30000001192092896, 0.25] 显示条件Shown when: Shape ∈ （16 种形状，见下表） |
|---|
| HeightFloat | 高度。Height. default=0.800000011920929 显示条件Shown when: Shape ∈ （19 种形状，见下表） |
|---|
| Minor RadiusFloat | 次半径（环等）。Minor radius. default=0.11999999731779099 显示条件Shown when: Shape = Torus (3D) / Capped Torus (3D) / Link (3D) / Death Star (3D) / Moon (2D) |
|---|
| RoundnessFloat | 圆角。Roundness. default=0.07999999821186066 显示条件Shown when: Shape = Round Box (3D) / Box Frame (3D) / Rounded Cylinder (3D) / Rhombus (3D) / Rounded Box (2D) |
|---|
| Top RadiusFloat | 顶部半径。Top radius. default=0.05000000074505806 显示条件Shown when: Shape = Capped Cone (3D) / Round Cone (3D) / Trapezoid (2D) / Uneven Capsule (2D) |
|---|
| OffsetFloat | 偏移。Offset. default=0.0 显示条件Shown when: Shape = Plane (3D) |
|---|
| Point AVector | 控制点 A。Control point A. default=[-0.5, 0.0, 0.0] 显示条件Shown when: Shape = Segment (2D) / Triangle (2D) / Oriented Box (2D) |
|---|
| Point BVector | 控制点 B。Control point B. default=[0.5, 0.0, 0.0] 显示条件Shown when: Shape = Segment (2D) / Triangle (2D) / Oriented Box (2D) |
|---|
| Point CVector | 控制点 C。Control point C. default=[0.0, 0.5, 0.0] 显示条件Shown when: Shape = Triangle (2D) |
|---|
| AngleFloat | 角度。Angle. default=1.0 显示条件Shown when: Shape = Capped Torus (3D) / Cone (3D) / Solid Angle (3D) / Infinite Cone (3D) / Pie (2D) / Arc (2D) / Ring (2D) / Horseshoe (2D) |
|---|
| ThicknessFloat | 厚度。Thickness. default=0.10000000149011612 显示条件Shown when: Shape = Cut Hollow Sphere (3D) / Arc (2D) / Ring (2D) / Horseshoe (2D) / Cross (2D) / Rounded X (2D) / Oriented Box (2D) |
|---|
| CountFloat | 重复/段数。Count. default=5.0 显示条件Shown when: Shape = Star (2D) / Stairs (2D) |
|---|
| FactorFloat | 混合因子。Factor. default=3.0 显示条件Shown when: Shape = Death Star (3D) / Chamfer Box (2D) / Parallelogram (2D) / Star (2D) / Vesica (2D) / Moon (2D) |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| DistanceFloat | 有符号距离。Signed distance. |
|---|
菜单模式与接口显隐Menus & input visibility
Shape Menu
默认Default: Sphere (3D) · 58 shapes
| Input | 显示于哪些 ShapeVisible for shapes |
|---|
Angle | 8 shapes: Capped Torus (3D), Cone (3D), Solid Angle (3D), Infinite Cone (3D), Pie (2D)… |
|---|
Count | Star (2D), Stairs (2D) |
|---|
Factor | Death Star (3D), Chamfer Box (2D), Parallelogram (2D), Star (2D), Vesica (2D), Moon (2D) |
|---|
Height | 19 shapes: Capsule (3D), Capped Cylinder (3D), Capped Cone (3D), Hex Prism (3D), Pyramid (3D)… |
|---|
Minor Radius | Torus (3D), Capped Torus (3D), Link (3D), Death Star (3D), Moon (2D) |
|---|
Offset | Plane (3D) |
|---|
Point A | Segment (2D), Triangle (2D), Oriented Box (2D) |
|---|
Point B | Segment (2D), Triangle (2D), Oriented Box (2D) |
|---|
Point C | Triangle (2D) |
|---|
Radius | 35 shapes: Sphere (3D), Torus (3D), Capsule (3D), Capped Cylinder (3D), Capped Cone (3D)… |
|---|
Roundness | Round Box (3D), Box Frame (3D), Rounded Cylinder (3D), Rhombus (3D), Rounded Box (2D) |
|---|
Size | 16 shapes: Box (3D), Round Box (3D), Box Frame (3D), Rhombus (3D), Ellipsoid (3D)… |
|---|
Thickness | 7 shapes: Cut Hollow Sphere (3D), Arc (2D), Ring (2D), Horseshoe (2D), Cross (2D)… |
|---|
Top Radius | Capped Cone (3D), Round Cone (3D), Trapezoid (2D), Uneven Capsule (2D) |
|---|
Vector | 全部形状all shapes |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
ImageNodeFractalPrimitive · ImageNodeTree
Fractal Primitive
功能Function
分形原语（Mandelbrot/Julia 等）：输出 Color 与 Distance 估计。
Fractal primitive (Mandelbrot/Julia…) → Color + Distance estimate.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| FractalMenu | Mandelbrot / Julia。Mandelbrot / Julia. 显示条件Shown when: 始终显示always |
|---|
| VectorVector | 采样坐标。Sample position. default=[0.0, 0.0, 0.0] 显示条件Shown when: 始终显示 / always |
|---|
| PowerFloat | 幂次。Power. default=2.0 显示条件Shown when: 始终显示 / always |
|---|
| IterationsFloat | 最大迭代。Max iterations. default=64.0 显示条件Shown when: 始终显示 / always |
|---|
| BailoutFloat | 逃逸半径。Bailout radius. default=4.0 显示条件Shown when: 始终显示 / always |
|---|
| Julia CVector | Julia 常数。Julia constant. default=[-0.800000011920929, 0.15600000321865082, 0.0] 显示条件Shown when: Fractal = Julia |
|---|
| ScaleFloat | 缩放。Scale. default=1.5 显示条件Shown when: 始终显示 / always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| ColorColor | 分形着色。Fractal color. |
|---|
| DistanceFloat | 距离估计。Distance estimate. |
|---|
菜单模式与接口显隐Menus & input visibility
Fractal Menu
默认Default: MANDELBROT · 全部All: Mandelbrot, Julia
| Mode | 显示的 InputsInputs shown |
|---|
Mandelbrot | Vector, Power, Iterations, Bailout, Scale |
|---|
Julia | Vector, Power, Iterations, Bailout, Julia C, Scale |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
CompositorNodeImageProcess · CompositorNodeTree
GPU Texture Editor（合成器节点）
功能Function
这是合成器（Compositor）节点，不是 GPU Texture Editor 编辑器里的节点。在合成树中选择一个 ImageNodeTree（GPU Texture Editor 节点组），合成时嵌套求值该组；本节点上的 Inputs/Outputs 随所选组的 Group Input / Group Output 接口同步。节点体：node_tree 数据块选择器。
A Compositor node (not a node inside the GPU Texture Editor). Pick an ImageNodeTree group; compositor evaluates that group nested. Socket layout mirrors the group's Group Input/Output. Body: node_tree selector.
所属树：Tree: CompositorNodeTree · 合成器 Add 菜单添加，不是 Image Process 编辑器内的节点。Added in Compositor, not inside Image Process editor.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| Node TreeData-Block | 合成器节点体上的选择器：指定要嵌套求值的 ImageNodeTree（GPU Texture Editor 节点组）。不是 GTE 编辑器内部节点。Compositor node-body: ImageNodeTree group to evaluate. Not a node inside the GTE editor. 显示条件Shown when: 始终显示 / always |
|---|
| （动态接口）(dynamic IO)Group | Inputs/Outputs 随所选组的 Group Input / Group Output 自动同步（与节点组节点相同机制）。未选组时本 dump 下为空。Sockets mirror the selected group interface; empty until a group is set. always |
|---|
Outputs
—
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
NodeSocketImage · GeometryNodeImageTexture · ShaderNodeTree
Image Socket（着色器）
功能Function
着色器节点树支持 SOCK_IMAGE 图像数据块接口：可在材质节点组上声明 NodeSocketImage 输入，从组外传入贴图；菜单 Texture → Image Texture 使用 Geometry 同款节点（带 Image / Vector / Frame），inline 阶段替换为 legacy ShaderNodeTexImage，Cycles / EEVEE 等走原有 TexImage 路径。与 GPU Texture Editor（Image Process）无关。
Shader trees accept SOCK_IMAGE: group interfaces can expose NodeSocketImage; Add → Texture → Image Texture uses the Geometry-style node (Image / Vector / Frame), inlined to legacy ShaderNodeTexImage for Cycles / EEVEE. Unrelated to GPU Texture Editor (Image Process).
说明Overview
- 组接口：Shader 组可增加 Image 类型输入；包组后组节点出现 Image 口，贴图可从外部传入。
- 菜单：Add → Texture → Image Texture =
GeometryNodeImageTexture；另保留 Image Texture (legacy) = ShaderNodeTexImage。
- 拖图：向材质节点编辑器拖入图像 → 添加 Geo Image Texture（World 仍为 Environment）。
- 求值：
shader_nodes_inline 将 Geo Image Texture 转为 legacy TexImage（拷贝插值 / 扩展 / 帧偏移）。
- 单值约束：Image 与 Frame 必须是 single value；连场会报 must be a single value。
- 非 HLSL：
ShaderNodeHLSL 的可扩展参数不含 Image 类型（见 HLSL）。
Notes：Blender_Shader_Image_Socket_PR151575_2026-08-04.md（PR #151575 本地移植）
- Group interface — Image input type on shader groups; outer group node exposes Image socket.
- Menu — Image Texture =
GeometryNodeImageTexture; legacy = ShaderNodeTexImage.
- Drag-drop — drop image into material editor → Geo Image Texture (World stays Environment).
- Eval — inliner rewrites to legacy TexImage (interpolation / extension / frame offset).
- Single value — Image and Frame must be singles.
- Not HLSL — HLSL extendable params do not include Image type.
Image Texture（材质内）Inputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| ImageImage | 图像数据块（单值；可来自组接口 Image socket）。Image data-block (single value; may come from group Image socket). 显示条件Shown when: 始终显示 / always |
|---|
| VectorVector | 采样坐标（可连线）。Sample coordinates (linkable). 显示条件Shown when: 始终显示 / always |
|---|
| FrameInt | 序列/电影帧偏移（单值）。EEVEE 对 Frame 支持可能不完整（上游 WIP）。Sequence/movie frame offset (single). EEVEE Frame support may be incomplete (upstream WIP). 显示条件Shown when: 始终显示 / always |
|---|
Image Texture（材质内）Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| ColorColor | 采样颜色（RGBA）。Sampled color (RGBA). |
|---|
| AlphaFloat | Alpha 通道。Alpha channel. |
|---|
来自 Achieve List「着色器 · image socket」+ Notes。socket/管线能力页，非 HLSL 参数。
From Achieve List Shaders · image socket + Notes. Socket/pipeline feature page, not an HLSL param.
ShaderNodeSDFShape · ShaderNodeTree
SDF Shape
功能Function
着色器侧解析 SDF 基元，输出 Distance（与 Image 版同类 Shape 菜单）。
Shader-side analytic SDF primitives → Distance.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| ShapeMenu | SDF 基元类型菜单。SDF primitive type. 显示条件Shown when: always |
|---|
| VectorVector | 着色坐标。Shading position. default=[0.0, 0.0, 0.0] 显示条件Shown when: 始终显示 / always |
|---|
| ScaleFloat | 整体缩放。Overall scale. default=1.0 显示条件Shown when: 始终显示 / always |
|---|
| RadiusFloat | 半径。Radius. default=0.5 显示条件Shown when: Shape ∈ （35 种形状，见下表） |
|---|
| SizeVector | 盒/尺寸。Size. default=[0.5, 0.5, 0.5] 显示条件Shown when: Shape ∈ （16 种形状，见下表） |
|---|
| HeightFloat | 高度。Height. default=1.0 显示条件Shown when: Shape ∈ （19 种形状，见下表） |
|---|
| Minor RadiusFloat | 次半径（环等）。Minor radius. default=0.15000000596046448 显示条件Shown when: Shape = Torus (3D) / Capped Torus (3D) / Link (3D) / Death Star (3D) / Moon (2D) |
|---|
| RoundnessFloat | 圆角。Roundness. default=0.10000000149011612 显示条件Shown when: Shape = Round Box (3D) / Box Frame (3D) / Rounded Cylinder (3D) / Rhombus (3D) / Rounded Box (2D) |
|---|
| Top RadiusFloat | 顶部半径。Top radius. default=0.05000000074505806 显示条件Shown when: Shape = Capped Cone (3D) / Round Cone (3D) / Trapezoid (2D) / Uneven Capsule (2D) |
|---|
| OffsetFloat | 偏移。Offset. default=0.0 显示条件Shown when: Shape = Plane (3D) |
|---|
| Point AVector | 控制点 A。Control point A. default=[-0.5, 0.0, 0.0] 显示条件Shown when: Shape = Segment (2D) / Triangle (2D) / Oriented Box (2D) |
|---|
| Point BVector | 控制点 B。Control point B. default=[0.5, 0.0, 0.0] 显示条件Shown when: Shape = Segment (2D) / Triangle (2D) / Oriented Box (2D) |
|---|
| Point CVector | 控制点 C。Control point C. default=[0.0, 0.5, 0.0] 显示条件Shown when: Shape = Triangle (2D) |
|---|
| AngleFloat | 角度。Angle. default=1.0 显示条件Shown when: Shape = Capped Torus (3D) / Cone (3D) / Solid Angle (3D) / Infinite Cone (3D) / Pie (2D) / Arc (2D) / Ring (2D) / Horseshoe (2D) |
|---|
| ThicknessFloat | 厚度。Thickness. default=0.10000000149011612 显示条件Shown when: Shape = Cut Hollow Sphere (3D) / Arc (2D) / Ring (2D) / Horseshoe (2D) / Cross (2D) / Rounded X (2D) / Oriented Box (2D) |
|---|
| CountFloat | 重复/段数。Count. default=5.0 显示条件Shown when: Shape = Star (2D) / Stairs (2D) |
|---|
| FactorFloat | 混合因子。Factor. default=3.0 显示条件Shown when: Shape = Death Star (3D) / Chamfer Box (2D) / Parallelogram (2D) / Star (2D) / Vesica (2D) / Moon (2D) |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| DistanceFloat | 有符号距离。Signed distance. |
|---|
菜单模式与接口显隐Menus & input visibility
Shape Menu
默认Default: Sphere (3D) · 58 shapes
| Input | 显示于哪些 ShapeVisible for shapes |
|---|
Angle | 8 shapes: Capped Torus (3D), Cone (3D), Solid Angle (3D), Infinite Cone (3D), Pie (2D)… |
|---|
Count | Star (2D), Stairs (2D) |
|---|
Factor | Death Star (3D), Chamfer Box (2D), Parallelogram (2D), Star (2D), Vesica (2D), Moon (2D) |
|---|
Height | 19 shapes: Capsule (3D), Capped Cylinder (3D), Capped Cone (3D), Hex Prism (3D), Pyramid (3D)… |
|---|
Minor Radius | Torus (3D), Capped Torus (3D), Link (3D), Death Star (3D), Moon (2D) |
|---|
Offset | Plane (3D) |
|---|
Point A | Segment (2D), Triangle (2D), Oriented Box (2D) |
|---|
Point B | Segment (2D), Triangle (2D), Oriented Box (2D) |
|---|
Point C | Triangle (2D) |
|---|
Radius | 35 shapes: Sphere (3D), Torus (3D), Capsule (3D), Capped Cylinder (3D), Capped Cone (3D)… |
|---|
Roundness | Round Box (3D), Box Frame (3D), Rounded Cylinder (3D), Rhombus (3D), Rounded Box (2D) |
|---|
Size | 16 shapes: Box (3D), Round Box (3D), Box Frame (3D), Rhombus (3D), Ellipsoid (3D)… |
|---|
Thickness | 7 shapes: Cut Hollow Sphere (3D), Arc (2D), Ring (2D), Horseshoe (2D), Cross (2D)… |
|---|
Top Radius | Capped Cone (3D), Round Cone (3D), Trapezoid (2D), Uneven Capsule (2D) |
|---|
Vector | 全部形状all shapes |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
ShaderNodeFractalPrimitive · ShaderNodeTree
Fractal Primitive
功能Function
着色器侧分形原语，输出 Color 与 Distance。
Shader-side fractal primitive → Color + Distance.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| FractalMenu | Mandelbrot / Julia。Mandelbrot / Julia. 显示条件Shown when: 始终显示always |
|---|
| VectorVector | 着色坐标。Shading position. default=[0.0, 0.0, 0.0] 显示条件Shown when: 始终显示 / always |
|---|
| ScaleFloat | 缩放。Scale. default=1.0 显示条件Shown when: 始终显示 / always |
|---|
| PowerFloat | 幂次。Power. default=2.0 显示条件Shown when: 始终显示 / always |
|---|
| IterationsFloat | 最大迭代。Max iterations. default=64.0 显示条件Shown when: 始终显示 / always |
|---|
| BailoutFloat | 逃逸半径。Bailout radius. default=4.0 显示条件Shown when: 始终显示 / always |
|---|
| Julia CVector | Julia 常数。Julia constant. default=[-0.800000011920929, 0.15600000321865082, 0.0] 显示条件Shown when: Fractal = Julia |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| ColorColor | 颜色。Color. |
|---|
| DistanceFloat | 距离。Distance. |
|---|
菜单模式与接口显隐Menus & input visibility
Fractal Menu
默认Default: MANDELBROT · 全部All: Mandelbrot, Julia
| Mode | 显示的 InputsInputs shown |
|---|
Mandelbrot | Vector, Scale, Power, Iterations, Bailout |
|---|
Julia | Vector, Scale, Power, Iterations, Bailout, Julia C |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
ShaderNodeHLSL · ShaderNodeTree
HLSL
功能Function
EEVEE 用 HLSL 子集自定义着色：中间 Code 文本框 + 可扩展 In/Out 参数，翻译为 GLSL 接入材质。可扩展参数类型为 Float / Int / Boolean / Vector / Color，不含 Image；材质贴图 Image 接口见 Image Socket。
Custom HLSL subset for EEVEE: Code textbox + extendable In/Out, translated to GLSL. Extendable types: Float / Int / Boolean / Vector / Color — no Image; see Image Socket for material image wiring.
Inputs
| 名称Name | 用途 / 菜单 / 显示条件Purpose / menu / visibility |
|---|
| CodeString | HLSL 源码文本（节点体多行框）。RNA：code。支持 floatN、lerp、saturate 等子集。HLSL source textbox. RNA: code. Subset: floatN, lerp, saturate, … default=// Inputs: Color, Fac | Outputs: Result
// HLSL subset: floatN, lerp, saturate, frac, ddx/ddy, mad, rcp, ...
Result = float4(lerp(Color.rgb, Color.rgb * Fac, saturate(Fac)), Color.a);
显示条件Shown when: 始终显示 / always |
|---|
| ColorColor | 默认可扩展输入示例 Color。Default extendable input Color. default=[0.800000011920929, 0.800000011920929, 0.800000011920929, 1.0] 显示条件Shown when: 始终显示 / always |
|---|
| FacFloat | 默认可扩展输入 Fac。Default extendable input Fac. default=0.0 显示条件Shown when: 始终显示 / always |
|---|
| （动态扩展）(dynamic extend)Virtual | 拖线或侧栏添加自定义输入项Drag or sidebar to add custom inputs always |
|---|
Outputs
| 名称Name | 用途 / 显示条件Purpose / visibility |
|---|
| ResultColor | 默认可扩展输出 Result。Default extendable output Result. |
|---|
数据：当前 blender.exe 导出 + Notes 参数说明。无单独「属性」章节。
From live blender.exe + Notes. No separate Properties section.
界面 / 快捷操作UI / Shortcuts
视口叠加层属性预览优化Viewport Attribute Text Overlay
说明Overview
Geometry Nodes Viewer 在 3D 视口叠加层显示属性文字的增强。
- Attribute Text 字号：仅控制 Viewer 属性叠加文字，不影响全局 UI 字号。
- Exclude Backfaces：按当前视图几何遮挡隐藏文字（BVH 自遮挡），不是简单的顶点法线朝向剔除。
- UI 位置：3D Viewport Overlays → Viewer 区域。
Notes：Blender_Viewer_Attribute_Text_Overlay_Implementation.md
Enhancements for Geometry Nodes Viewer attribute text in the 3D Viewport overlay.
- Attribute Text size — only Viewer overlay text.
- Exclude Backfaces — geometric occlusion from view (mesh BVH), not simple normal facing.
- UI: 3D Viewport Overlays → Viewer.
来自 Achieve List「界面 UI 与便捷操作」+ Notes。非几何节点 IO 页。
From Achieve List UI section + Notes. Not a node IO page.
界面 / 快捷操作UI / Shortcuts
节点组 Separator 与 MessageGroup Interface Separator & Message
说明Overview
节点组接口可插入非数据项，用于布局与说明。
- Separator：横线分隔，无 socket / 链接语义。
- Message：多行说明文字（N 面板可编辑 message）。
- Python：
iface.new_separator() / iface.new_message("note")。
- 布局注意：separator 必须推进
locy，禁止在树行里用 separator_spacer() 撑破布局。
Notes：Blender_Node_Group_Interface_Separator_Message.md
Non-data interface items: horizontal Separator and multi-line Message notes.
来自 Achieve List「界面 UI 与便捷操作」+ Notes。非几何节点 IO 页。
From Achieve List UI section + Notes. Not a node IO page.
界面 / 快捷操作UI / Shortcuts
抖动分离与多节点 Combo 插线Shake Detach & Combo Insert
说明Overview
节点编辑器 Houdini 风格连线交互。
- 抖动分离：拖动选中节点时快速方向翻转 → 从外部连线中脱离，邻居旁通重连。
- Combo 插线：多选节点整体拖到一条 wire 上 → 保留 combo 内部连线，以整体插入该 wire（只改边界进出边）。
- 单节点 / 多节点均支持分离。
Notes：Blender_Node_Shake_Detach_And_Combo_Insert_2026-07-26.md
Shake while dragging to detach external links; multi-node combo insert onto a wire keeping internal links.
来自 Achieve List「界面 UI 与便捷操作」+ Notes。非几何节点 IO 页。
From Achieve List UI section + Notes. Not a node IO page.
界面 / 快捷操作UI / Shortcuts
按住 U + 拖动对齐节点Hold U + Drag Align
说明Overview
Houdini 风格节点布局对齐（快捷键 U；不占用 A 全选）。
- 至少选中 2 个非 Frame 节点。
- 按住 / 按下 U 进入对齐模态（十字光标，不启动框选）。
- 左键拖：左右主导 → 左→右分层并对齐 socket Y；上下主导 → 上→下分层。
- 松左键确认；Esc / 右键 / 未拖松 U → 取消。
| 操作 | 结果 |
|---|
| 只按 U 移鼠标（无 LMB） | 等待 LMB，不布局 |
| U + 空白处左键拖 | 对齐布局（不框选） |
| 不按 U 左键拖空白 | 框选 |
| 不按 U 拖节点 | 自由平移 |
Notes：Blender_Node_Hold_U_Align_While_Dragging_2026-07-26.md
Hold U, LMB-drag to layout-align selected nodes (horizontal or vertical by drag direction).
来自 Achieve List「界面 UI 与便捷操作」+ Notes。非几何节点 IO 页。
From Achieve List UI section + Notes. Not a node IO page.
界面 / 快捷操作UI / Shortcuts
电子表格属性列排序Spreadsheet Column Sort
说明Overview
Spreadsheet 表头点击排序（Houdini Geometry Spreadsheet 风格）。
- 点击整格表头循环：升序 → 降序 → 原序。
- 左侧 Index 列同样可排；同时只激活一个排序键。
- 排序在行过滤 / Selection filter 之后。
- 不破坏：拖宽、双击 fit、列重排。
Notes：Blender_Spreadsheet_Column_Sort_2026-07-26.md
Click column headers to cycle ascending / descending / none. Index column sortable too.
来自 Achieve List「界面 UI 与便捷操作」+ Notes。非几何节点 IO 页。
From Achieve List UI section + Notes. Not a node IO page.
界面 / 快捷操作UI / Shortcuts
节点组参数：加入下一行（横排）Join Parameter to Next (Horizontal)
说明Overview
组接口 Socket 可勾选 Horizontally Join to Next Parameter：与下一个参数横排，可连续累加。
- N 面板细节 toggle；最后一项灰掉（无下一个 Socket）。
- Separator / Message 无此属性。
- 外层组节点控件横排；修改器侧连续 join 的 Input 一行多列。
- 内置节点
align_with_previous 经典路径不受影响。
Notes：Blender_Node_Interface_Join_To_Next_Parameter_2026-07-26.md
Interface socket flag: horizontally join with the next parameter; chainable.
来自 Achieve List「界面 UI 与便捷操作」+ Notes。非几何节点 IO 页。
From Achieve List UI section + Notes. Not a node IO page.
界面 / 快捷操作UI / Shortcuts
Ctrl+LMB 节点组参数改名Ctrl+LMB Rename Group Socket
说明Overview
组接口（及 Group Input/Output）在外部可就地改名。
- Ctrl+LMB（或双击）点名字 → 就地编辑（未启用 Optional Label 时）。
- 可改名时悬停有浅色高亮提示。
- 与 Capture Attribute 改名机制一致；与 Ctrl 点 socket 形状改类型不冲突。
Notes：Blender_Node_Group_Interface_Ctrl_LMB_Rename_2026-07-27.md
Ctrl+LMB (or double-click) on socket name to rename; hover highlight when renamable.
来自 Achieve List「界面 UI 与便捷操作」+ Notes。非几何节点 IO 页。
From Achieve List UI section + Notes. Not a node IO page.
界面 / 快捷操作UI / Shortcuts
Ctrl+LMB 改 Socket 数据类型Ctrl+LMB Change Socket Data Type
说明Overview
在节点编辑器中 Ctrl+LMB 点 socket 的彩色形状（不是名字）。
- 短按 <0.2s → 常驻面板点选类型；长按 ≥0.2s → 松手菜单。
- 支持：组接口、Capture Attribute、Expression、Format String、Bundle、Closure 等可改类型的 item。
- 固定类型 socket（如 Math）无菜单。
- Ctrl+点名字仍是改名；Ctrl+拖线仍是 detach link。
Notes：Blender_Node_Socket_Ctrl_Alt_Type_Shape_Switch_2026-08-04.md
Ctrl+LMB on socket shape to change data type (short click panel / long press pie).
来自 Achieve List「界面 UI 与便捷操作」+ Notes。非几何节点 IO 页。
From Achieve List UI section + Notes. Not a node IO page.
界面 / 快捷操作UI / Shortcuts
Alt+LMB 改 Socket Structure 形状Alt+LMB Change Socket Structure Shape
说明Overview
在节点编辑器中 Alt+LMB 点 socket 的彩色形状。
- 修改 Structure Type / Shape：Auto / Single / Field / Grid / List / Dynamic。
- 短按面板 / 长按松手菜单（同 Ctrl，阈值 0.2s）。
- 组接口内外、Bundle 等支持写
structure_type。
Notes：Blender_Node_Socket_Ctrl_Alt_Type_Shape_Switch_2026-08-04.md
Alt+LMB on socket shape to change structure type (Auto/Single/Field/Grid/List/Dynamic).
来自 Achieve List「界面 UI 与便捷操作」+ Notes。非几何节点 IO 页。
From Achieve List UI section + Notes. Not a node IO page.