🔥 PHASE 2 LAUNCH SALE!

To celebrate our successful launch and initial milestones, we are offering a Phase 2 Special Price: Only $14.9!

(This is a limited-time offer for the next 100 copies only — Secure your copy now before the price increases!)

🌟 FEATURED ON INSPIRATIONTUTS!

SDF.R was highlighted in InspirationTuts' latest Blender Addons video! Watch it in action showing smooth real-time GPU-based SDF modeling.

🎥 Watch the Showcase (Starting at 10:52)

🖥️ Platform Support — Windows, macOS & Linux

SDF.R ships for Windows, macOS (Apple Silicon) and Linux (x86-64). All three are built from the same source, by the same automated pipeline, in every release. They are not side projects and they are not afterthoughts.

I want to be straightforward about one thing: I develop on Windows, and I do not own a Mac or a Linux machine. I cannot sit down and reproduce a problem on those platforms myself. What I can do is read a crash report and fix what it points to — and that works. The macOS crash fixed in V16.1.2 was found entirely from one user's crash log, and the cause turned out to be my own code, not their environment.

So these platforms improve exactly as fast as people tell me things.

Please download the file matching your OS:

• Windows: the standard package (e.g., SDF_R_16_2_2.zip)
• macOS: SDF_R_16_2_2_Darwin.zip — built for Apple Silicon (arm64), does not run on Intel Macs
• Linux: SDF_R_16_2_2_Linux.zip — built for x86-64

If something breaks, the fastest route to a fix is to launch Blender from Terminal (on macOS, /Applications/Blender.app/Contents/MacOS/Blender), reproduce the problem, and send me what the Terminal printed — plus blender.crash.txt from your temporary folder (open $TMPDIR). That file carries the add-on's own line numbers, and it is exactly what solved the V16.1.2 crash.

Code signing: the macOS build is not notarized, so Gatekeeper blocks it on first use. Open System Settings → Privacy & Security and click Open Anyway.

🚀 Future Roadmap

To further elevate your modeling workflow, we are excited to share our vision for the next major milestones in Rust-GPU-SDF:

🚨 CRITICAL SYSTEM REQUIREMENTS

• Supported OS: Windows (64-bit), macOS (Apple Silicon) and Linux (x86-64). All three are built from the same source in every release — see Platform Support above for how macOS and Linux issues get fixed, and what I need from you to do it.
• GPU Requirements: Dedicated Graphics Cards (NVIDIA / AMD) supporting DirectX 12 or Vulkan are highly recommended.
• Integrated GPUs: Intel Iris Xe and other integrated GPUs are supported with auto-VRAM memory scaling, but editing speeds may be reduced at extremely high resolutions.
• Blender Version: 3.6 LTS, 4.x, or 5.x.
• First-Time Startup Note: On the very first launch, the engine will perform a "Warming-up" process to compile shaders. This initial compilation usually takes about 15 to 45 seconds depending on your GPU. If the status does not update after a few minutes, please check your Blender System Console for detailed logs or update your GPU drivers.

SDF.R

Pioneering the Next Generation of Blender Modeling

💎 Dual Topology Engine: Marching Cubes (MC) & Dual Contouring (DC)

SDF.R features two production-ready mesh generation engines. Marching Cubes (MC) remains the default choice, combining stability with high performance for organic, sculpt-like workflows.

As of V15.9.9.1, GPU-accelerated Dual Contouring (DC) has been fully stabilized and is no longer considered experimental. By utilizing a custom SVD-based QEF (Quadratic Error Function) solver, DC preserves sharp corners and creases (such as box edges) that tend to be smoothed out in conventional SDF environments — reliably, at any resolution.

V15.9.9.2 adds a dedicated compute-logic optimization pass: Boolean (CSG) scenes now generate significantly faster thanks to restored per-block spatial culling, Dual Contouring is faster via a lighter normal evaluation, and additional shader-compiler crash triggers on certain NVIDIA drivers have been removed.

V15.9.9.3 focuses on large-scale meshing. Marching Cubes now supports a much more robust GPU Chunked MC path with high-resolution fallback, ghost-cell evaluation, seam weld controls, and visible mesh-health diagnostics. Experimental chunked DC groundwork is also included for testing, but seam-free large-scale DC remains a future backend task.

V15.9.9.4 targets real-time viewport responsiveness. The Ghost Preview now caches its GPU primitive buffer, so simply orbiting/panning the camera no longer rebuilds it every frame; raymarching step count is automatically reduced while you navigate or transform and restored to full quality the moment you stop; and with the result mesh hidden, transform updates skip the entire per-primitive scan and mesh request. The result is markedly smoother interaction in scenes with many primitives.

V16.0.4 introduces the first major V16 modeling feature: a production-ready Gyroid Field primitive. Gyroid structures can now be generated directly inside SDF.R, clipped by Box/Sphere/Cylinder masks, blended into previous primitives, and shaped with Phase plus per-axis frequency controls. CPU mesh generation, GPU/WGSL generation, and the real-time viewport preview share the same Gyroid definition, so the preview and final baked mesh stay aligned.

V16.0.5 generalizes Gyroid Field into a single Math Field primitive with a Formula selector, adding Schwarz P and Schwarz D (Diamond) as new selectable TPMS surfaces alongside Gyroid. All existing presets, mask shapes, boundary modes, phase, and per-axis frequency controls now work identically across every formula, and CPU mesh generation, GPU/WGSL generation, and the real-time viewport preview stay fully in sync for all three.

V16.0.6 focuses on finishing workflow quality. Shared material controls make it easier to unify a piece by applying one base color, Metallic, or Roughness value across the full SDF stack. Snapshot Mesh creates a static mesh copy while preserving the live SDF workspace for further iteration.

V16.0.7 adds a layer-style boolean workflow through Layer Boundary collection dividers. This lets decorative Math Field layers use local Subtract or Intersect operations without cutting every earlier primitive in the stack, opening a more controllable way to build pattern-over-form designs.

V16.1.0 brings native Blender Curves into the SDF stack. With Curve Sync you can draw a path using Blender's own curve tools and have it generate a solid, blendable SDF pipe that supports Union, Subtract, and Intersect just like any other primitive — either by moving the curve into the SDF Collection, or by pointing a lightweight Curve Ref proxy at a curve that lives anywhere else in your scene. A new numeric Bezier primitive and a whole-material Transmission control round out the release.

V16.2.0 reworks Layer Boundary. Switching it on used to give you a group that fused into one shape and then blended softly into the rest of the model — the opposite of a boundary — because the strength of that merge was read from whichever primitive came first in the group. The divider now carries its own Layer Blend, defaulting to a hard seam, and the group it governs is the rows above it, matching group layout and parenting. Files that use Layer Boundary may look different.

V16.2.1 lets a scene hold several SDF trees, each with its own parts, settings and result mesh — so a model's parts come out as separate objects rather than one fused solid. Tree Reference lets one tree carve or join another, which is how two parts are made to fit. Mirror Blend rounds off the crease that per-primitive Mirror has always left down the middle, matching what two real shapes joined with a smooth union would give you. Defaults leave existing files unchanged.

V16.2.2 fixes the ghost preview for Mirror Blend. On V16.2.1 the preview moved the opposite way to the mesh as you raised it, and emptied out at high values, which read as a broken feature. Meshing never used the preview's code, so every mesh and every saved file was already correct. The preview now follows the mesh, and the panel warns when Blend goes past twice the Offset, where the whole shape swells rather than just the seam. V16.1.3 fixes Global Symmetry: with Symmetry X/Y/Z enabled the Ghost Preview showed the mirrored result correctly, but mesh generation returned an empty or half-missing mesh. V16.1.2 is a bug-fix release: a crash on macOS, traced to SDF.R forcing a scene re-evaluation from a timer, is fixed. V16.1.1 targeted viewport responsiveness. The Ghost Preview now renders at a reduced resolution while you navigate or transform, and returns to full resolution the moment you stop. Because this reduces pixel count rather than scene complexity, it stays effective no matter how many primitives are in play. Mesh generation is untouched.

SDF.R V16.2.2 Release Notes — The Mirror Blend preview moves with the mesh

Released 2026-09-12

V16.2.1 added Mirror Blend, which rounds off the hard crease Layout Mirror leaves down the middle of a mirrored shape. The final mesh has been correct since that release; the ghost preview was not. Raising Mirror Blend made the shape in the preview thinner rather than thicker, and past roughly twice the sum of Offset and the shape's own size it vanished from the preview altogether. The likely way to meet this was to raise Mirror Blend looking for a rounder seam, watch the preview shrink or empty out, and conclude the feature was broken. Meshing never used the preview's code, so every mesh generated on V16.2.1 was already correct, and so is every file saved with it. The preview now follows the mesh in the same direction and by close to the same amount — within about 0.01 on a single mirror axis across the whole Blend range, with the seam itself exact — and it no longer creases. The panel also warns when Blend goes past twice the Offset, where the whole shape swells rather than just the seam; raise Offset rather than Blend if you want a rounder seam at the same size. At Mirror Blend 0 the preview takes exactly the path it always did.

Note: the meshing engine is untouched in this release, so there is no shader cache rebuild and the first start after updating is as quick as always.

SDF.R V16.2.1 Release Notes — One Add-on, Separate Objects

Released 2026-09-09

A scene can hold several SDF trees, each with its own parts, settings and result mesh — so a model's parts are separate objects from the start. Tree Reference lets one tree carve or join another, which is how two parts are made to fit. Mirror Blend rounds off the crease that per-primitive Mirror has always left down the middle: 84° down to 8.5°, identical to two real shapes joined with a smooth union. Defaults keep existing files unchanged. Also fixed, and the reason to take this update if you are on V16.2.0: the ghost preview switched off entirely once a tree held more than sixteen parts, counted after layout expansion. Meshing was never affected and no file was damaged, but the live preview stopped drawing. Alongside it: All Clear no longer leaves a hidden result behind or deletes similarly named objects of your own, a saved Dual Contouring error no longer follows a file to a healthy machine, Show Result Mesh now clears the mesh, Auto Domain and Live Normals re-mesh when toggled, and the panel no longer unlocks before the engine is ready.

Note: the GPU shader code changed, so the first start after updating rebuilds the shader cache once. On a discrete GPU that is the usual 15–45 seconds; on integrated graphics it can take several minutes.

SDF.R V16.2.0 Release Notes — Layer Boundary, Reworked

Layer Boundary now does what its name promises. Files that use it may look different; files that never did are unchanged from V16.1.3.

• The merge into the scene took its blend radius from the first primitive in the group — a value that does nothing inside the group, so it appeared inert and then decided the outer seam. At the default 0.2, a layer melted into the model.
• The divider now carries Layer Blend (default 0.0, a hard seam) and its own Profile. Primitive Smoothness and its inheritance are unchanged.
• A layer now covers the group above its divider, matching group layout and parenting, and no longer leaks past the next divider.

• A divider carrying Radial, Grid or any other group layout discarded that layout when Layer Boundary was switched on. The two now work together.
• The ghost preview and the mesh generator now implement the same layer rules.
• Move to SDF: uses the active SDF output as its destination rather than the first one it finds, relinks cleanly for objects that belonged to several collections, and reports which objects it had to guess a shape for rather than turning them into spheres in silence.

SDF.R V16.1.3 Release Notes — Global Symmetry Mesh Fix

A single fix, and a significant one. If you never used Global Symmetry, your output is unchanged from V16.1.2.

Enable Symmetry: X / Y / Z in Mesh Settings and the Ghost Preview does exactly what you expect — the shape appears mirrored across the plane. Then generate a mesh, with either Marching Cubes or Dual Contouring, and a shape placed on the negative side of that plane is missing entirely; one that straddled the plane comes out quietly shrunk. The preview being right is what made this confusing: it looked like the meshing step was refusing to run. It was running — it was simply looking in the wrong place.

It did not fail across the board. Shapes on the positive side, or exactly on the symmetry plane, meshed correctly — and a matching shape on the positive side could make the whole result look right, so the problem could stay hidden in exactly the symmetric scenes Symmetry is used for.

The preview and the mesh generator are two separate implementations of the same scene. The preview raymarches the SDF directly; the generator first works out where in space it needs to look, then samples only that volume on the GPU. Global Symmetry was handled correctly in the first path and incorrectly in the second, in two independent ways.

1. The search volume covered only one side of the plane. The bounding box the generator builds was being clamped to span 0 to +max on a symmetry axis instead of −max to +max. The mirrored half of the model, and any primitive placed on the negative side, sat outside the volume the generator ever looked at, and was discarded before meshing began.

2. Primitive centres were not folded onto the mirrored side. Symmetry works by folding the sampled point onto one side of the plane, and the preview shader folds each primitive's centre to match. The two meshing shaders — the detection pass that finds occupied cells, and the layout evaluation that positions each primitive — did not. A primitive at X = −2 with Symmetry X on was therefore evaluated as if it sat somewhere else entirely.

As soon as a primitive was on the negative side, both faults lined up: the search volume was empty, and so was the output. Both are fixed, in the Windows, macOS and Linux builds alike.

• Global Symmetry only — the X / Y / Z toggles in Mesh Settings. Per-primitive Mirror in the Layout section was never affected.
• Output with Symmetry off is unchanged from V16.1.2.
• Verified on Blender 5.1, running the old and new engines side by side — a primitive at X = −2.0 with Symmetry X produced an empty mesh before and a correct −3.0 to +3.0 mesh now, under Marching Cubes and Dual Contouring alike. All three axes together produce a complete eight-way symmetric mesh.

One internal change, with no visible effect: the Windows, macOS and Linux builds now load the native engine through the same code path and ship byte-for-byte identical Python. Previously each platform's package carried slightly different code that had to be reconciled by hand every release. The macOS and Linux builds now run exactly the code tested on Windows.

SDF.R V16.1.2 Release Notes — macOS Crash Fix

A bug-fix release. Nothing about mesh generation or the preview changes — the geometry SDF.R produces is identical to V16.1.1.

One user reported Blender crashing the moment they added a primitive, every time, on macOS with Blender 5.2. The answer is worth stating plainly: the fault was mine, not their setup.

While SDF.R waits for the mesh calculation to finish, it runs a repeating timer. That timer was asking Blender for the scene's dependency graph — and in Blender, that request does not merely hand one over. If Blender decides an update is due, it re-evaluates the entire scene right there. Inside an operator that is the flow Blender expects. From a timer it begins evaluating at a moment Blender never scheduled, and if the scene's composition shifted just beforehand, the evaluator reads past the end of its own object list. The timer no longer forces an evaluation.

With Factory Settings and only SDF.R enabled, the crash never happened — which made it look like a conflict with another add-on and nearly sent the investigation the wrong way. With a quiet scene the forced evaluation happens to survive; other add-ons only widened the window. If you hit this and concluded something in your setup was to blame, it was not.

• Safety limit on the mesh timer: if the dependency graph stays unavailable, the timer gives up on the queued update after about two seconds instead of polling indefinitely. Normal waiting — during a drag, or while the engine is calculating — is unaffected.

SDF.R V16.1.1 Release Notes — Viewport Preview Performance

A focused performance update for the real-time Ghost Preview. Nothing about mesh generation changes — the geometry SDF.R produces is identical to V16.1.0. Only how the preview is drawn while you are actively navigating or editing has changed.

• Reduced resolution while moving: The preview renders at 50% linear resolution during camera orbit/pan/zoom (a quarter of the pixels) and 65% during object transforms, then upscales to fill the viewport.
• Instant return to full quality: The moment you stop, the preview is redrawn at full resolution. Still frames are unchanged.
• Scales with any scene: Because this reduces pixel count rather than shape complexity, it remains effective regardless of how many primitives are in the stack.

• 3-tap normals while moving: Surface normals were estimated with a 6-tap central difference, meaning six extra full-scene evaluations per hit pixel. During interaction this now uses a 3-tap forward difference that reuses the already-computed distance, halving that cost. Full quality returns when you stop.

• Camera navigation: Helps fully — the primitive buffer is cached, so this is pure draw cost.
• Dragging an object: Helps the drawing portion only. Moving an object also rebuilds the preview buffer on the Python side, which this release does not change.
• Generated mesh: No change whatsoever.

• Blender 5.2 support for the Post-Process panel: the Post-Process (Smoothing) section came up empty on 5.2, with property not found errors in the console. Blender 5.2 moved Geometry Nodes modifier inputs from custom properties to regular ones; SDF.R now reads them either way, so one build covers 5.1 and 5.2. This affected earlier SDF.R versions on 5.2 too.
• Ghost Preview with split viewports: with two or more 3D Viewports open, the preview could fail to appear once the camera came to rest and stayed locked in its reduced-quality state. Motion is now detected per viewport. This dates back to V15.9.9.4; the adaptive resolution above is what made it visible.
• Reduced-resolution buffer reuse: with split viewports of differing sizes the drawing buffer was recreated every frame, cancelling out the speed-up this release is built around. Buffers are now kept per size.
• Mesh data safety check: vertex indices coming back from the engine are range-checked before being handed to Blender. Out-of-range data is rejected with a console message rather than written into the mesh, where it could corrupt memory and crash Blender later. Valid data is unaffected.
• Collection cleanup: an object belonging to three or more collections could be left linked to some of them after being moved into SDF_Collection.

SDF.R V16.1.0 Release Notes — Curve Workflow

V16.1.0 opens up a new way to build shapes in SDF.R: instead of composing everything from numeric primitives, you can now draw a path with Blender's own Curve tools and have SDF.R turn it into a solid, blendable SDF pipe. Curves behave like any other stack item, so they blend smoothly with neighbouring shapes and support Union, Subtract, and Intersect.

• Native curves as geometry: Any Blender Curve object can drive an SDF pipe. Add as many as you like, each with its own Pipe Radius, boolean Operation, Smoothness, Color, Metallic, and Roughness.
• Two ways to attach: Move the curve into the SDF Collection to register it directly, or add a Curve Ref proxy that points at a curve living anywhere else in your scene — the original object never moves and is never modified.
• Reuse one curve many ways: Because settings live on the proxy, several Curve Ref proxies can target the same curve with different radii, colours, or boolean operations.
• One-click edit: An Edit button selects the target curve and enters Edit Mode immediately, so reshaping the path never means hunting through the Outliner.
• Curve type support: Bezier (with handles) and Poly are fully sampled using Subdiv Samples; NURBS is evaluated by Blender itself using the curve's own Resolution Preview U; closed (cyclic) curves loop back on themselves correctly.

• Bezier Curve primitive: A self-contained 3D quadratic Bezier defined by numeric control points, with independent Start and End radius for a smooth taper. Follows the object transform and works with the Layout and Deform stacks.
• Transmission & IOR: Glass-like transmission for the generated SDF material, with a paired IOR control. Unlike Color/Metallic/Roughness (which are stored per vertex and can differ per primitive), Transmission applies to the SDF material as a whole.

• Lightweight curve preview: The Ghost Preview draws Curve Sync as a slim coloured guide line rather than a fully raymarched pipe, so adding many curves does not slow the viewport down. The generated mesh remains exact — enable Show Result Mesh or press Force Update to see the finished shape. Guide thickness is adjustable.

• Instancing accuracy: Fixed geometry that could go missing when Radial or Spiral layouts were combined with Individual/Step Rotation. The bounding volume used to skip empty regions during meshing did not account for the extra per-copy rotation, so parts of elongated or asymmetric shapes could be culled away. The same calculation also ignored the Radial Axis setting, causing losses when the axis was X or Y. This affects any elongated or asymmetric primitive, not just the new curve shapes.
• Stack order for Curve Sync: Curve Sync items now respect stack order, so Subtract and Intersect operate on the shapes above them as expected.
• Stability polish: Adding a Curve Ref no longer creates a duplicate group entry; Solo mode stops at the selected item reliably; duplicating a Collection Divider group carries Curve Sync items across correctly; and removing a Curve Ref proxy leaves the referenced curve untouched.

• Extrude and Lathe removed from the Add grid: Their two working cross-sections (rectangle and circle) overlapped almost entirely with the existing Rounded Box, Cylinder and Torus primitives, so the entry was removed rather than shipped half-complete. Arbitrary cross-section profiles remain on the roadmap. Existing objects are unaffected.

SDF.R V16.0.7 Release Notes - Layer Boundary Workflow

V16.0.7 builds on the V16 Math Field system and adds a more controllable layer-style boolean workflow. It is designed for decorative pattern modeling where you may want an Intersect or Subtract operation to affect only the current layer, not the entire earlier model.

• Scoped boolean composition: A Collection Divider can be marked as a Layer Boundary. The group above it is evaluated on its own and merged into the scene once, so a Subtract or Intersect inside the group reaches only the group.
• Parts that stay separate: Give the body, the eyes and the shell each their own layer boundary and they meet at a hard seam instead of melting together. The divider's Layer Blend sets how soft that seam is, and defaults to none.
• Cleaner Math Field masking: Use a Math Field inside a layer, then use a cylinder, box, or sphere as an Intersect mask without accidentally cutting earlier base forms.
• Layer-style creative control: Build a base shape, close it with a layer boundary, then stack decorative details and close those with a second one. Each layer behaves like a controlled overlay instead of a destructive global operation.

• Improved Collection Divider behavior: Divider rows are kept cleaner and avoid producing duplicate group markers for the same intended grouping operation.
• Snapshot selection behavior: After creating a Snapshot Mesh, the generated snapshot object is selected automatically for easier inspection, moving, material testing, or comparison.
• Appearance-only updates: Apply Color All and Apply Material All are optimized as finishing operations, updating visual attributes without intentionally triggering a full SDF mesh recomputation.

SDF.R V16.0.6 Release Notes - Finishing Workflow

V16.0.6 focuses on making it easier to finish a piece once the main form is working. The goal is not only to generate shapes, but to make them easier to unify, compare, and prepare as presentable mesh objects.

• Apply Color All: Apply one shared base color to every SDF primitive in the stack.
• Apply Material All: Apply shared Metallic and Roughness values across all primitives, useful when the overall object needs a unified material feel.
• Reset material defaults: Resetting the generated shader node setup also returns the shared Metallic and Roughness controls to their defaults.

• Snapshot Mesh: Create a static mesh copy of the current SDF result without finalizing the whole live SDF workspace.
• Smoothness carry-over: Newly added primitives can inherit the previous Smoothness value, helping maintain consistent connection feel across a model.
• Auto Match Scale: Math Field Axis X/Y/Z can be matched to object scale to keep procedural pattern density visually consistent under non-uniform transforms.

🚀 SDF.R V16.0.5 Release Notes — Math Field: Gyroid, Schwarz P & Schwarz D

V16.0.5 restructures the Gyroid Field primitive introduced in V16.0.4 into a general-purpose Math Field primitive, laying the groundwork to keep adding more mathematical field formulas over time. This release adds the first two additional formulas: Schwarz P and Schwarz D (Diamond).

• Formula selector: The Shape list now has a single "Math Field" entry. A new Formula dropdown lets you switch between Gyroid, Schwarz P, and Schwarz D (Diamond) on the same object at any time.
• Shared controls across every formula: Scale, Thickness, Bias, Extent, presets, Mask Shape, Boundary Mode, Phase, and Axis X/Y/Z all continue to work exactly as before — they now simply apply to whichever formula is selected.
• Two new TPMS surfaces: Schwarz P produces a more cubic, evenly-spaced pore structure, while Schwarz D (Diamond) produces a diagonally-symmetric cell pattern — both are additional triply periodic minimal surfaces alongside the original Gyroid.

• Full pipeline parity: All three formulas are implemented in CPU mesh generation, GPU/WGSL chunked mesh generation, and the real-time viewport Ghost Preview shader, so what you see while modeling always matches the final baked mesh.

🚀 SDF.R V16.0.4 Release Notes — About the V16 Gyroid Field Update

V16.0.4 is the first major V16 feature milestone for SDF.R. Rather than only refining the existing primitive set, this version adds a new procedural field-based modeling direction: Gyroid Field. It is designed for porous structures, lattice-like volumes, organic technical surfaces, internal material patterns, and experimental SDF forms that are difficult to build with standard Boolean primitives alone.

• Native SDF Gyroid: Gyroid is available as a standard SDF.R primitive from the primitive buttons and the Shape selector. It participates in the same stack, Union/Subtract/Intersect operations, material coloring, preview, and bake workflow as the existing primitives.
• Core controls: Scale, Thickness, Bias, and Extent define the cell density, wall thickness, field offset, and finite working range.
• Practical presets: Fine, Medium, Coarse, Thick, and Shell-style presets provide quick starting points while still allowing manual parameter editing.

• Mask Shape: Gyroid can be clipped by Box, Sphere, or Cylinder masks, allowing it to become a bounded object instead of an infinite periodic field.
• Boundary Mode: Fade, Open, and Box Clip modes control how the field behaves near the boundary, from softened fade-out to open cuts and closed clipped volumes.
• Use Previous as Mask: A one-click helper turns the previous primitive into a mask and intersects the selected Gyroid with it. This makes it fast to create objects such as a Box filled with gyroid structure or a Sphere containing a porous internal pattern.

• Phase: Shifts the Gyroid periodic field without moving the boundary mask, useful for art-directing where openings, ridges, and surface flow appear.
• Axis X / Y / Z: Independently changes Gyroid frequency along each axis, making it possible to stretch or compress the cellular rhythm in a specific direction without changing the object transform.

• CPU / GPU / Viewport alignment: The Gyroid definition is implemented in CPU mesh generation, GPU/WGSL mesh generation, and Blender's real-time Ghost Preview. The goal is that the interactive preview and final baked mesh remain visually consistent.
• Built on the V15 stability foundation: V16.0.4 inherits the viewport responsiveness, mesh diagnostics, GPU chunked MC, and Dual Contouring stabilization work completed in the late V15 series.

🚀 SDF.R V15.9.9.4 Release Notes — Real-Time Viewport Responsiveness

A focused performance update for the interactive viewport. As scenes accumulate more primitives, moving the camera or dragging objects could start to feel sluggish because the real-time Ghost Preview was rebuilt from scratch every single frame. V15.9.9.4 removes that redundant work. No workflow changes and fully backward compatible — existing scenes and parameters behave exactly as before, just more responsive.

• Camera navigation no longer rebuilds the preview: Orbiting, panning, and zooming don't change your primitives, so the GPU primitive buffer is now cached and reused across frames. The expensive per-frame stack scan, matrix decomposition, data packing, and texture upload are skipped entirely while you simply look around.
• Automatic, always-fresh invalidation: The cache is rebuilt only when something that actually affects the shape changes — a transform, a parameter tweak, an undo/redo, or a stack edit — so the preview never goes stale.

• Interactive step reduction: While you navigate the viewport or transform objects, the raymarching step count is temporarily capped to keep interaction fluid — the heavier the scene, the more this helps.
• Full quality on release: The instant you stop moving, the preview automatically redraws one final frame at full quality, so the still image you inspect is always the high-detail version.

• Lighter transforms while sculpting with the mesh hidden: When "Show Result Mesh" is OFF, transform updates now return early — after keeping the stack and parenting in sync — skipping the full per-primitive fingerprint, rebuild, and mesh request. This pairs perfectly with the "Ghost Preview Only" workflow introduced in V15.9.9.

🚀 SDF.R V15.9.9.3 Release Notes — Large-Scale Meshing & GPU Chunked MC

A large-scale meshing stability update focused on high-density Marching Cubes, safer fallback behavior, and clearer mesh diagnostics. This update is especially useful for larger SDF scenes that previously risked missing regions or incomplete meshes at high resolutions.

• New GPU Chunked MC backend: Large high-resolution jobs can now be split into GPU chunks instead of relying on one monolithic mesh buffer. This greatly improves tolerance for dense scenes and reduces the chance of capacity-related missing mesh regions.
• Automatic high-resolution chunking: In Auto backend mode, high-resolution jobs can start directly with chunked GPU meshing when appropriate.
• Ghost-cell evaluation: GPU chunks evaluate a one-cell expanded region and then filter triangles back to the core chunk area, helping reduce boundary artifacts.
• Chunk seam weld: Added a chunk-only Seam weld scale to help reduce visible boundaries without globally increasing the standard weld threshold.
• Safer chunk sizing: Non-divisible resolutions are handled directly, and safeguards prevent accidental micro-chunk jobs from running for an excessive time.

• Mesh health reporting: The Output & Quality panel can now show states such as OK, CAPACITY_LIMITED, EMPTY_RESULT, BLOCK_OR_PRIM_FALLBACK, and SURFACE_UNDER_SAMPLED.
• More visible generation details: The UI now reports useful meshing information such as backend, face/vertex count, chunk size, ghost cells, weld scale, filtered triangles, chunk usage, issue count, and fallback reason when available.
• Partial mesh protection: Incomplete or empty results can be prevented from replacing the last valid mesh.
• Fallback chain: Capacity-limited or empty results can fall back to GPU Chunked MC, lower-resolution safe retry, and CPU Chunked MC as needed.

• Experimental GPU Chunked DC: A GPU Chunked DC (Seam Test) backend is included for investigation and comparison.
• Known limitation: Chunked DC can still show visible seams because each chunk solves DC independently. Changing seam weld values may reduce or shift the seams, but does not fully remove the structural boundary issue.
• Recommended stable workflow: Use Auto or GPU Chunked MC for large high-resolution scenes. Use normal DC where it fits within current limits, and treat chunked DC as an experimental seam-test mode.

🚀 SDF.R V15.9.9.2 Release Notes — Compute-Logic Optimization & Robustness

A focused optimization and stability update. No workflow changes and fully backward compatible — existing scenes and parameters work exactly as before, just faster and more robust.

• Much faster Boolean (CSG) scenes: Previously, a single Subtract/Intersect anywhere in the scene disabled spatial culling globally, forcing every region to evaluate every primitive. Culling is now restored on a per-block basis, so union-heavy models with a few Booleans build dramatically faster.
• Faster Dual Contouring: The hottest part of DC — per-edge normal evaluation — was switched to a lighter 4-tap gradient (~1/3 fewer SDF evaluations) with virtually no visible quality change. Output normals remain full-quality.
• Reduced per-frame overhead: Removed a redundant duplicate field evaluation in the face pass and an unused per-frame buffer clear left over from an earlier internal redesign.

• Fixed missing geometry on tall Spiral layouts: The Spiral layout's axial pitch was not included in the internal detection bounds, so instances near the ends of a spiral with a large count × pitch could disappear. The bounds now account for the full spiral extent.
• Fewer missing faces with Deformers + Booleans: Widened the detection safety margin for deformed primitives so that combining the Deform Stack (Bend / Twist / Taper / Elongate) with Boolean operations is less likely to drop faces.

• Removed another NVIDIA shader-compiler crash trigger: The Marching Cubes edge-table lookup used the same problematic pattern already fixed in Dual Contouring (a dynamically-indexed local array literal) that could crash the driver's shader compiler on some NVIDIA setups. It now uses module-level constants.

• More stable DC vertices & GPU/CPU parity: Added Tikhonov (Levenberg–Marquardt style) regularization to the GPU QEF solver to match the CPU solver. Vertex placement is now more stable on flat and cylindrical regions, and GPU and CPU results are consistent.

🚀 SDF.R V15.9.9.1 Release Notes — Dual Contouring Officially Stabilized

This update delivers a major stability overhaul for the Dual Contouring (DC) engine. Previously an experimental feature, DC has been rebuilt from the ground up and is now confirmed stable across low to very high resolutions.

• Fixed a critical GPU driver crash when enabling DC: On certain GPU/driver combinations, switching to Dual Contouring could crash Blender entirely during shader compilation. This has been fully resolved.
• Fixed vertex loss at high resolutions: DC meshes could lose a large portion of their vertices unpredictably as resolution increased. The internal block-lookup system has been redesigned for fully deterministic results, even at very high resolutions (500+).
• New SVD-based QEF Solver: Replaced the direct matrix inversion solver with an industry-standard SVD-equivalent solver (Jacobi eigendecomposition + singular value truncation + mass-point biasing). Curved and organic surfaces (spheres, domes, etc.) now generate cleanly, while sharp mechanical edges remain fully preserved.
• Fixed a shading "weave" artifact on curved surfaces: Corrected a face-winding inconsistency in the mesh generator that caused a diagonal, corduroy-like shading pattern on curved DC surfaces. Added alternating quad triangulation for extra smoothness on organic shapes.
• Fixed inverted face normals (both DC and Marching Cubes): Discovered and fixed a long-standing winding bug where Marching Cubes output was fully inverted (relying on Live Normals to mask it), plus a partial winding issue in Dual Contouring. Both engines now output correctly-facing geometry independent of the Live Normals setting.
• New Diagnostic Logging: Added a persistent log file (sdf_debug.log) that records shader compilation diagnostics. If you ever run into GPU-related issues, this log makes it much easier to identify the cause and get you a faster fix.

🚀 SDF.R V15.9.9 Release Notes

New Feature: Ultra-Fast "Ghost Preview Only Mode"

• Massive Performance Boost via Complete Mesh Generation Bypass: The "Mesh Icon" in the UI has been vastly upgraded. It is no longer just a simple visibility toggle—it now acts as the Master Switch for the entire mesh generation process.
• Zero FPS Drop Sculpting Experience: When the Mesh Icon is turned OFF (grayed out), heavy polygonization processes (like Marching Cubes) are completely bypassed. The viewport relies solely on the Raymarching Ghost Shader. You can now tweak shapes, increase resolution, and expand domain sizes with zero calculation overhead!
• One-Click Mesh Restoration: After blazing through your modeling tasks in Preview Mode, simply toggle the Mesh Icon back ON. The mesh calculation triggers instantly in the background, rebuilding your actual wireframes and solid meshes on the fly.

🚀 Rust-GPU-SDF V15.9.8.1 Release Notes (Pilot implementation)

• Full Collection Support in Ghost Preview: Advanced layout expansions using Collections (Empty dividers)—such as Mirror, Radial, and Grid—are now fully supported in the real-time Ghost Preview. This allows users to see fast and perfectly accurate raymarched previews in the viewport before generating the final mesh.
• 1-Click Collection Duplication: Added a dedicated "Duplicate" button for Collection rows in 'The Stack' UI. With a single click, users can duplicate an entire Collection (Empty) along with all its contained SDF primitives. The duplicated group retains all existing layout parameters and is automatically appended to the bottom of the stack.
• UI/UX Refinements:
  • Transformed the Collection name display (e.g., == SDF_Group_Empty ==) in the UI list into a clickable operator button, significantly improving the click hit-box and making it effortless to activate Collections.
  • Replaced the bulky "Break Parent" text label with a clean, toggleable "Chain" icon.
  • Optimized the visibility condition for the advanced rotation menu ("Rotation: Indiv & Accum"). The menu now dynamically appears for both primitives and Collections only when "Radial" or "Spiral" layouts are enabled, making the UI much cleaner and more intuitive.
• 🐛 Bug Fixes:
  • Fixed Mesh Disappearance Caused by Negative Scaling: Resolved a critical bug in the Rust (WGSL) bounding box (AABB) calculation where negative scale values caused the calculation to break, resulting in missing or cropped meshes. By strictly enforcing absolute value calculations (abs()), the computational engine is now highly robust and safe against extreme layout deformations and scale inversions.

🚀 Release Notes (v15.9.8 / Color-related)

v15.9.8 improves the primitive color workflow with better visibility and user control. The original fixed palette flow is preserved, while adding selectable color assignment modes for different workflows.

• Added scene-wide Color Mode:
  • Fixed Palette: Keeps the existing sequential built-in palette behavior.
  • Auto Hue: Automatically rotates hue for each newly added primitive (with fixed saturation/value).
  • Single Color: Uses one shared base color for all newly added primitives.
• Added Auto Hue controls: Saturation, Value, Hue Step (deg) (0–360, default: 120°), and Hue Offset.
• Switched Hue Step to degree-based UI: Replaced normalized step-style tuning with angle-based control for better intuitiveness.
• Improved visibility in The Stack: Added a color chip per stack row, making object-to-color mapping immediately readable from the list.
• UI Placement: Color Mode and related controls are placed in primitive settings below Color and above Metallic/Roughness.
• Compatibility: Default mode remains Fixed Palette, preserving current behavior by default. New rules apply on primitive creation; existing object colors are not auto-recolored.

🚀 Release Notes - Rust-GPU-SDF v15.9.7.4

• Fixed a mismatch between viewport preview (shader) and generated mesh placement when using Grid layout.
• Unified Grid index/clamp behavior in the preview shader to match the mesh-side centered logic.
• Added post-Grid accum_idx updates in the preview path so Step Rotation behaves consistently.
• Improved visual parity and more natural instancing results, especially with Grid + Step Rotation.

🚀 Release Notes for SDF.R V15.9.7.3 (Global UI Update)

This update focuses on globalizing the add-on interface by standardizing all user-facing labels, property names, operator descriptions, dialog boxes, and warning notifications into English. Internal logic, identifiers, and calculation properties remain completely unchanged, ensuring 100% stability and compatibility with your existing projects.

• 1. Unified English User Interface (Global UI): All hardcoded Japanese strings in the Blender Sidebar Panel have been translated into clean, industry-standard English terminology:
  • Deform Stack Types: ストレッチ $\rightarrow$ Elongate | ベンド $\rightarrow$ Bend | ツイスト $\rightarrow$ Twist | テーパー $\rightarrow$ Taper
  • UI Properties & Dynamic Labels: 係数 / 滑らかさ $\rightarrow$ Factor / Smoothness | 大きさ $\rightarrow$ Size | Shell (中空化) $\rightarrow$ Shell (Hollow) | 変形 (スタック) $\rightarrow$ Deform (Stack)
  • Preview Quality Presets: 低 (128) $\rightarrow$ Low (128) | 中 (256) $\rightarrow$ Mid (256) | 高 (512) $\rightarrow$ High (512)
• 2. Globalized Dialogs and Warnings:
  • Dual Contouring Switching Popup: Standardized the experimental notice, compilation time warning (approx. 65 seconds), and Blender unresponsive warning message into English.
  • Operators & Tooltips: All operator labels and descriptions are now fully localized.
• 3. Under the Hood & Documentation: console logs and packaged zip updated to V15.9.7.3.

🚀 Release Notes - Rust-GPU-SDF V15.9.7.2

• Fixed Radial Pattern Alignment and Rotation Direction on Y-Axis (axis == 1): Resolved a misalignment issue where the real-time viewport preview (GLSL) and the generated mesh (Rust/WGSL) did not match when using the Radial/Spiral pattern on the Y-axis.
• Corrected the internal coordinate mapping in the mesh generator. Previously, the generator treated the X-axis as the primary coordinate and the Z-axis as the secondary coordinate. It has now been corrected to use the Z-axis as the primary coordinate and the X-axis as the secondary coordinate, matching the viewport's behavior (counter-clockwise rotation and offset along the Z-axis).
• Affected Components: src/common.wgsl, src/lib.rs, src/sdf.rs.

🚀 Release Notes: Rust-GPU-SDF-V15.9.7.1

This update introduces Primitive Edge Profiles, SDF Shelling, customizable Blend Profiles, and improved GPU initialization stability.

• Primitive Edge Profiles (Bevel / Rounding): Added edge rounding and chamfering directly to primitives (Box, Cylinder, Rounded Box, Hex Prism, Ngon Prism). Supports Round, Sharp, Soft, Tight, and Chamfer.
• SDF Shelling (Hollow Modifier): Hollows out shapes using the formula abs(d) - shell_thickness. Fully synchronized across CPU and GPU.
• Custom Blend Profiles: Transition profiles for blending operations (Union, Subtract, Intersect). Supports Round, Sharp, Soft, Tight, and Chamfer.
• GPU Initialization Auto-Recovery: Automatically removes corrupted shader cache files and retries compilation on startup failure.

🚀 SDF.R V15.9.7 Release Notes

• Added 5 New Primitive Types (Tier 1): Ellipsoid, Rounded Cylinder, Capped Torus, Octahedron, and Cut Sphere. Fully implemented across all pipeline layers.

• Fixed GPU Shape Fallback Issue: Resolved a bug where newly added shapes fell back to the default "Sphere" primitive when generating meshes.
• Fixed Mesh Clipping on Parameter Changes: The local AABB logic and domain expansion algorithm are now synchronized dynamically with shape-specific parameters to prevent mesh clipping.
• Fixed Blocky/Circular Mesh Holes at High Resolutions: Updated detect.wgsl block detection shader to correctly evaluate and keep computation blocks for the new shape IDs.
• Resolved Mesh Cracking in Smooth Blending: Rewrote bounding radius calculations to use 3D diagonal vector lengths and expanded the safety margin for active block detection to ensure seamless blending.

🚀 Release Notes — V15.9.6.2

V15.9.6.2 focuses on robustness improvements for mesh generation stability in complex CSG workflows.

• Strengthened mitigation for band-like mesh dropout observed near shape boundaries during subtraction-heavy modeling.
• Improved Detect Pass block evaluation and added safety fallback to full-primitive evaluation.
• Added a conservative CSG safety mode to reduce topology corruption (unexpected holes/floating artifacts) caused by local-list culling.
• Enhanced Marching Cubes boundary handling by adding local re-evaluation for near-surface cells.
• Enhanced GPU initialization and shader compilation stability.

🚀 SDF.R V15.9.5 Release Notes

• Improved stability for integrated GPUs (iGPU) during startup.
• Fixed clipped/cutoff geometry in torus-heavy layout workflows.
• Improved GPU preview reliability for large procedural layouts.

• 1) Torus clipping in layout workflows: Addressed an issue where torus shapes could appear cut off. Bounding boxes are now shape-aware.
• 2) GPU initialization crash on iGPU systems: Added dynamic memory safety guards to prevent memory overflow crashes.
• 3) Viewport preview cutoff: Improved preview-domain handling and step budgeting for large-scale scenes.

In the spirit of free software and the GNU GPL:
May Blender forever remain free under the GPL!
This addon guarantees all users the freedom to learn from, modify, and share this source code — forever.