BIKINI 5.3: Geometry Nodes

Custom geometry nodes and related workflows. Layout modelled on Blender 5.3 Geometry Nodes notes.

自定义几何节点与相关工作流。版式参考 Blender 5.3 Geometry Nodes 说明。

Attributes属性

• String attributes are supported end-to-end (Named Attribute, Store Named Attribute, Capture Attribute, Viewer, geometry propagation, and spreadsheet columns).

• String 属性全链路支持 （Named Attribute、Store Named Attribute、Capture Attribute、Viewer、 几何传递与电子表格列）。

Portal & Clip

• Named Portal / Store Named Portal — pass values by name across a node tree without long noodle runs.
• Geometry Clip — clip geometry against a plane / cut.

• Named Portal / Store Named Portal — 按名称在节点树中传值，避免长距离拉线。
• Geometry Clip — 按平面或裁切几何。

Closures闭包

• Set Default Closure — specify a default closure when no external closure is connected.

• Set Default Closure — 未连接外部闭包时设置默认闭包。

Subdivision细分

• Loop Subdivision — classic Loop subdivision for triangle meshes.

• Loop Subdivision — 三角网格的经典 Loop 细分。

Nearest neighbours最近邻

• K-Nearest — find nearest neighbours for points / samples (smoothing, clustering, field sampling).

• K-Nearest — 点 / 采样的最近邻查询（平滑、聚类、场采样）。

Debug & time调试与时间

• Debug — inspect intermediate geometry / values while authoring.
• Time Shift — offset evaluation time for downstream nodes. With a Simulation Zone, return to frame 1 (or reset cache) after structural changes (native Blender cache behaviour).
• Object Info → Seed — deterministic randomness / instance variation.

• Debug — 编写时检查中间几何 / 数值。
• Time Shift — 为下游偏移求值时间。 与模拟区联用时，结构改动后需回到第一帧重置 cache（原生行为）。
• Object Info → Seed — 确定性随机 / 实例变化。

Select & edit选择与编辑

• Select Elements — domain selection helpers (points / edges / faces) and field-driven masks.
• Edit Elements — temporarily enter free Mesh Edit Mode on the cooked upstream result; store the full edited mesh back on the node (with Reset).

• Select Elements — 域选择（点 / 边 / 面）与场驱动遮罩。
• Edit Elements — 对上游结果临时进入自由 Mesh Edit Mode， 将完整编辑结果存回节点（含 Reset）。

Geodesic, remesh & fracture 测地线、重拓扑与破碎

• Heat Geodesic — approximate surface distance from selected sources via the heat method.
• Instant Meshes — field-aligned remeshing (quad or triangle output).
• QuadWild — remesh / field / layout stages (QRemeshify pipeline).
• Triangle Remesh — isotropic remeshing (uniform or curvature-adaptive).
• Voronoi Fracture — fracture from point / vertex sites (Voro++ neighbour planes, half-space clipping).

• Heat Geodesic — 热方法近似曲面测地距离。
• Instant Meshes — 场对齐重拓扑（四边形或三角形输出）。
• QuadWild — Remesh / Field / Layout 三阶段（QRemeshify 管线）。
• Triangle Remesh — 各向同性三角重拓扑（均匀或曲率自适应）。
• Voronoi Fracture — 点 / 顶点站点破碎（Voro++ 邻接平面、半空间裁切）。

Graph coloring & fields 图染色与场

• Mesh Graph Coloring — color the vertex 1-ring graph so adjacent vertices get different integer IDs.
• Tangent Field — smooth N-RoSy tangent field on the mesh.
• Gradient / Divergence — differential operators on scalar / vector fields.
• Curve Intersection — detect / sample curve intersections.

• Mesh Graph Coloring — 顶点一环邻接图染色，相邻顶点不同整数 ID。
• Tangent Field — 平滑 N-RoSy 切向场。
• Gradient / Divergence — 标量 / 向量场微分算子。
• Curve Intersection — 曲线相交检测 / 采样。

Field write & sample 场写入与采样

• Write at Index — scatter a field into a target domain by Target Index (source and target domains may differ). Collisions merge with Atomic Operator: Sum / Min / Max / Mean. Data Type: Float / Integer / Vector.
• RBF Interpolate — fit a radial-basis interpolant through Source sample Values so f(xᵢ)=vᵢ exactly (solves Φw=v, not a kernel-weighted average), then evaluate on Sample Position. Kernel panel: Type (Gaussian, Inverse Multiquadric, Linear, Cubic, Quintic, Wendland C2) and Size. Menu: Geometry → Sample. Dense solve; n ≤ 4096.

• Write at Index — 按 Target Index 将场 scatter 写入目标域 （源/目标域可不同）。冲突用 Atomic Operator 归并：Sum / Min / Max / Mean。 Data Type：Float / Integer / Vector。
• RBF Interpolate — 从 Source 采样点 Value 拟合径向基插值， 采样点精确还原 f(xᵢ)=vᵢ（解 Φw=v，非核加权平均）， 在 Sample Position 上求值。Kernel 面板：Type （Gaussian / Inverse Multiquadric / Linear / Cubic / Quintic / Wendland C2）与 Size。 菜单：Geometry → Sample。稠密求解；n ≤ 4096。

Expression

• Expression — evaluate a typed expression string on field / socket inputs, with autocomplete for identifiers, functions, and syntax.

• Expression — 对场 / 接口输入求值类型化表达式， 支持标识符、函数与语法的自动补全。

Sparse matrix math 稀疏矩阵数学

Geometry Nodes path for sparse linear algebra on meshes. Backend: Eigen + Spectra. (A dedicated Solver / physics category will come later when true physics solvers land.)

几何节点内的稀疏线性代数路径。后端：Eigen + Spectra。 （真正的物理 Solver 分类会在后续物理求解器落地后再单独开栏。）

Mesh → Mesh Laplacian → [Sparse Matrix Math] → Linear Solver

• Mesh Laplacian — discrete mesh Laplacian as a sparse COO bundle (weight / row / col). Modes: Uniform, Cotangent; optional diffusion / mass.
• Sparse Matrix Math — add / multiply / combine sparse matrix bundles.
• Linear Solver — solve Ax = b, factor, multiply, or partial eigenpairs on sparse matrices (optional pin constraints).

• Mesh Laplacian — 离散网格拉普拉斯，稀疏 COO Bundle （weight / row / col）。模式：Uniform、Cotangent；可选扩散 / 质量。
• Sparse Matrix Math — 稀疏矩阵 Bundle 加减乘组合。
• Linear Solver — 在稀疏矩阵上求解 Ax = b、分解、乘积或部分特征对 （可选钉约束）。

BIKINI 5.3: User Interface BIKINI 5.3：用户界面

Node Group interface节点组接口

• Separator / Message — dividers and help text on group inputs/outputs.
• Join to next parameter — place the next socket on the same row.
• Ctrl + LMB rename — rename group parameters with hover highlight.
• Enable Input / Output — when disabled: hide interface, ignore external links, fall back to defaults.
• Menu multi-select — multi-select menu items with list output.

• Separator / Message — 节点组输入输出分隔线与说明。
• 参数并排 — 下一参数同一行。
• Ctrl + LMB 改名 — 节点组参数改名，高亮提示。
• Enable Input / Output — 关闭时隐藏接口、忽略外部连线，回落默认。
• Menu 多选 — 菜单多选，输出 list。

Socket shortcuts接口快捷操作

• Ctrl + LMB on socket — change socket data type.
• Alt + LMB on socket — change socket shape.

• Ctrl + LMB 接口 — 修改接口数据类型。
• Alt + LMB 接口 — 修改接口形状。

Node editor & spreadsheet 节点编辑器与电子表格

• Shake to detach — shake a node to detach links; multi-insert along a chain.
• Hold U + drag — align nodes horizontally or vertically.
• Spreadsheet sort — click headers to sort attribute columns.

• 抖动分离 — 抖动节点拆线；可连续插入多个节点。
• 按住 U + 拖动 — 水平 / 垂直对齐节点。
• 电子表格排序 — 点击表头对属性列排序。

BIKINI 5.3: Shaders BIKINI 5.3：着色器

• Image socket — image data-block socket type for shader / group wiring.
• SDF Shape — signed-distance primitives for materials.
• Fractal Primitive — Mandelbrot / Julia style colour + distance.
• Expression — compact math / vector expressions on shader sockets.
• HLSL (ShaderNodeHLSL) — custom HLSL subset for EEVEE: multi-line Code textbox + extendable In/Out parameters (Float / Int / Boolean / Vector / Color), translated to GLSL and linked via GPU_stack_link. Menu: Add → Utilities → HLSL. Default: Color + Fac → Result. Cycles has no OSL/SVM path for this node.

• Image socket — 着色器 / 节点组可用的图像数据块接口。
• SDF Shape — 材质用有符号距离基元。
• Fractal Primitive — Mandelbrot / Julia 风格颜色 + 距离。
• Expression — 着色器接口上的紧凑数学 / 向量表达式。
• HLSL（ShaderNodeHLSL）— 面向 EEVEE 的 HLSL 子集： 多行 Code 文本框 + 可扩展 In/Out 参数（Float / Int / Boolean / Vector / Color）， 翻译为 GLSL 后经 GPU_stack_link 接入材质。 菜单：Add → Utilities → HLSL。默认 Color + Fac → Result。 Cycles 无 OSL/SVM 路径，不执行 HLSL 主体。

BIKINI 5.3: Image Process

Dedicated image node tree (ImageNodeTree), also referred to as the GPU Texture Editor.

专用图像节点树（ImageNodeTree），亦称 GPU Texture Editor。

Nodes节点

• Point Stamp — stamp points into an image.
• Normal to Height — convert normal maps to height maps.
• Simulation — image-space simulation workflows in the graph.
• Rasterize Geometry — bring geometry samples into image space.
• Fluid Sim — fluid simulation zone in Image Process.
• Sample at Pixel / Write at Pixel — read or write by pixel coordinate.
• Paint — interactive paint into the image graph.
• Histogram — channel / intensity distribution.
• SDF Shape / Fractal — Image Process path (not the shader variants).

• Point Stamp — 点盖章到图像。
• Normal to Height — 法线转高度。
• Simulation — 图像空间模拟工作流。
• Rasterize Geometry — 几何采样栅格化到图像。
• Fluid Sim — Image Process 流体模拟区域。
• Sample at Pixel / Write at Pixel — 按像素坐标读写。
• Paint — 在图像节点图中绘制。
• Histogram — 通道 / 强度分布。
• SDF Shape / Fractal — Image Process 路径（非着色器变体）。

Compositor合成器

• Compositor bridge — drive Image Process from the classic compositor and return cooked results (接通合成器).

• 接通合成器 — 从经典合成器驱动 Image Process 并取回结果。

BIKINI 5.3: Editors BIKINI 5.3：编辑器

• Data-block reference graph — visualise data-block reference relationships (who uses whom).
• GPU Texture Editor — see Image Process.

• Data-block reference graph — 可视化数据块引用关系（谁引用谁）。
• GPU Texture Editor — 见 Image Process。

BIKINI 5.3: EEVEE & Viewport

• Viewport overlay attribute preview — clearer attribute / Viewer text overlays for string and numeric attributes.
• SDF Shape / Fractal Primitive include GPU material paths for EEVEE viewport preview.

• 视口叠加层属性预览优化 — 字符串与数值属性的属性 / Viewer 文字叠加更清晰。
• SDF Shape / Fractal Primitive 提供 EEVEE 视口预览的 GPU 材质路径。

BIKINI 5.3: Zones

• Repeat Zone — Break — boolean early-exit before the iteration count is reached.
• Simulation Zone — Cache Limit — cap how many frames of simulation cache are retained.

• Repeat Zone — Break — 在达到迭代次数前布尔早退。
• Simulation Zone — Cache Limit — 限制模拟缓存保留帧数。

BIKINI 5.3: Known Issues BIKINI 5.3：已知问题

• Viewport Camera — listed in development notes as //viewport camera; not registered / not shipped in this build.
• Time Shift + Simulation Zone — after graph changes, return to the first frame or clear simulation cache.
• Unofficial custom build; not signed by the Blender Foundation.

• Viewport Camera — 开发笔记中记为 //viewport camera；本构建未注册 / 未打包。
• Time Shift + 模拟区 — 节点图改动后请回到第一帧或清理模拟缓存。
• 非官方自定义构建，未经 Blender Foundation 签名。