Understanding Layers in SDFusion

SDFusion is designed to treat the stacking of Boolean modifications as layers for workflow purposes.
We created this page in response to feedback that this concept was unclear.
We hope it proves helpful to everyone.

What is the Layer Concept?

SDFusion's layers are a system for managing Boolean operations (adding or subtracting shapes) as distinct "layers".
This allows you to non-destructively modify the base mesh (the original 3D object) by overlaying other objects, without damaging the original data.

Basic Role:

Layers are represented as Blender Collections, with each layer functioning as an independent "hierarchy".
Each layer consists of two parts: ADD (Add/Union operation) and SUB (Subtract/Difference operation).

  • ADD: The place to put objects that "add" new shapes to the base. Example: Adding protrusions or extensions.
  • SUB: Where you place objects to "subtract" shapes from the base. Example: Drilling holes or carving recesses.

Layers are managed by number (e.g., ADD-1/SUB-1, ADD-2/SUB-2), and Boolean operations are applied sequentially starting from the lowest numbered layer.
This allows you to control the order of operations and build complex shapes hierarchically.

Meaning of non-destructive: Changes made using layers are only temporarily applied as Blender modifiers.
You can move, adjust, or delete objects at any time; the original mesh remains unchanged until you finally "Apply" the changes.

Understanding with an image:

Imagine baking a cake.
You spread cream on the base cake (base mesh) in Layer 1 (ADD-1) or cut holes with a cookie cutter (SUB-1), then add decorations in Layer 2 (ADD-2). Since each layer is independent, you can easily change the cream thickness later or adjust hole positions.

This layer system enables fluid modeling like SDF using Blender's standard features (Collections and Modifiers), accelerating prototyping and experimental workflows.

Using Layers (Basic Operations)

Main operations are performed via the SDFusion UI panel (sidebar in the 3D Viewport, displayed with N key > SDFusion tab).

Preparing Layers:

  1. Select the base mesh object.
  2. Click "Reset Booleans & Collections" in the UI's "Workflow" section.

This creates a copy of the base and automatically generates the initial layers (ADD-1/SUB-1, ADD-2/SUB-2).
Simultaneously, Boolean modifiers are added, reflecting objects within the layer in real-time.
Finally, a "GeoRemesh" modifier (geometry node-based) is applied, allowing smooth adjustment of the post-Boolean mesh.

Object Assignment (Layer Assignment Section):

  1. Create or select a cutter object (e.g., cube, sphere).

  2. Click the layer button in the UI to assign the object.

  3. Example: Press ADD-1 button → Object moves to ADD-1 collection and is added to the base.

  4. Example: Press the SUB-2 button → Object moves to the SUB-2 collection and is subtracted from the base.

"SDFusion Pool": A temporary storage area outside layers. Place objects here that you don't need yet.
Auto-adjust display: Objects within layers display as wireframes or bounding boxes to maintain performance.

Adding Layers:

If you need more hierarchy, click "Add Layer".

  • A new layer (e.g., ADD-3/SUB-3) is created and added to the modifier stack.
  • You can add an unlimited number, allowing you to build up fine details step by step.

"Organize Modifiers": Automatically re-orders modifiers (keeps GeoRemesh at the end).

Adjustment and Preview (Live Controls & Transform Tools Sections):

Live Controls: Adjust GeoRemesh parameters in real-time with sliders. Instantly see shape changes. - Mesh Density: Controls the resolution of the remeshed result. - Smoothing: Amount of smoothing applied to the mesh. - Sharp: Controls sharpness of edges. - Edge Angle Parameter: Threshold angle for edge detection.

Transform Tools: Quick position and rotation adjustments. - Rotate objects by 90°/45°/30° on X/Y/Z axes. - Move to World Origin (set X/Y/Z to 0). - Align to 3D Cursor. - Display Type: Switch object display (Solid/Wireframe/Bounds). - Overlay Wireframe: Toggle wireframe overlay on/off.

Finalizing (Finalize Section):

  • "Apply All": Applies all modifiers and generates the final mesh. Cutter objects are moved to "SDFusion Cutters" collection (hidden).
  • "Cleanup All": Deletes temporary collections and objects, keeping your project clean.
  • Results are saved in the "SDFusion Results" collection.

Overall Workflow

A typical workflow is as follows. Since it's non-destructive, you can iterate and experiment freely.

  1. Setup: Select base → Click Reset to initialize layers.
  2. Build: Create cutters → Assign to ADD/SUB via Layer Assignment → Add more layers for deeper hierarchy.
  3. Fine-tune: Adjust smoothness with Live Controls → Optimize position/rotation with Transform Tools.
  4. Review & Experiment: Check shape in real-time preview. Move objects to Pool, add/remove layers as needed.
  5. Complete: Apply All to finalize → Cleanup to organize.

This workflow supports everything from rapid prototyping to detailed final mesh generation.

Advantages and Notes

Advantages:

  • Intuitive and Flexible: Layer-based management makes complex Booleans easy to handle hierarchically.
  • Efficient: Real-time adjustments and automatic setup reduce manual work while maintaining performance.
  • Experiment-Friendly: Non-destructive, so explore shapes without fear of failure. Use asset library for procedural cutters.

Notes:

  • Layer order matters: Lower numbers (e.g., SUB-1) are applied first, so plan placement carefully.
  • Object type: Primarily mesh type. Start with primitives (cubes, etc.).
  • Blender version: 4.5+ required. Don't forget to install assets on first use (GeoRemesh node is required).
  • Performance: If too many layers cause slowdown, switch display to Bounds or use Cleanup.

Quick Example: Creating a Cube with a Hole

  1. Select a large cube as base → Click Reset (creates layers 1/2).
  2. Create a small sphere → Assign to SUB-1 in Layer Assignment → Hole appears in base.
  3. Create a cylinder → Click Add Layer to add layer 3 → Assign to ADD-3 → Cylinder is added to base.
  4. Adjust position/rotation with Transform Tools → Increase Mesh Density in Live Controls for smoothness.
  5. Apply All to generate final mesh → Cleanup to clean up.

Layers make modeling fun and efficient, especially for hard surface modeling (mechanical parts, etc.).

---

SDFusionにおけるレイヤーの考え方について

SDFusionではブーリアンモディファイのスタックの仕方をレイヤーに見立てて作業することを見据えています。
これがわかりにくいということでコメントを頂いているので、このページを作成しています。
少しでも皆様の助けになれば幸いです。

レイヤーの概念とは？

SDFusionのレイヤーは、ブーリアン操作（形状の追加や削り取り）を「層（レイヤー）」として管理するシステムです。
これにより、ベースとなるメッシュ（元の3Dオブジェクト）に、他のオブジェクトを重ねて形状を変える操作を、非破壊的に（元のデータを壊さずに）行えます。

基本的な役割:

レイヤーは、Blenderのコレクション（Collection）として表現され、各レイヤーが独立した「階層」として機能します。
各レイヤーは、ADD（追加/結合: Union操作）とSUB（削り取り: Difference操作）の2つの部分からなります。

  • ADD: ベースに新しい形状を「足す」ためのオブジェクトを置く場所。例: 突起や拡張部分を追加。
  • SUB: ベースから形状を「引く」ためのオブジェクトを置く場所。例: 穴を開けたり、凹みを掘ったり。

レイヤーは番号付きで管理され（例: ADD-1/SUB-1、ADD-2/SUB-2）、低い番号のレイヤーから順にブーリアンが適用されます。
これにより、操作の順序をコントロールし、複雑な形状を階層的に構築できます。

非破壊的の意味: レイヤーを使った変更は、Blenderのモディファイア（Modifier）として一時的に適用されるだけ。
いつでもオブジェクトを移動したり、調整したり、削除したりでき、最終的に「適用」するまで元のメッシュは変わりません。

イメージで理解する:

ケーキ作りを想像してください。
ベースのケーキ（ベースメッシュ）に、レイヤー1でクリームを塗る（ADD-1）や型抜きで穴を開ける（SUB-1）、レイヤー2でデコレーションを追加（ADD-2）するような感じ。各レイヤーは独立しているので、クリームの厚さを後から変えたり、穴の位置を調整したりしやすいです。

このレイヤーシステムは、SDFのような流動的なモデリングをBlenderの標準機能（コレクションとモディファイア）で実現し、プロトタイピングを速く、実験的に進められるようにしています。

レイヤーの使い方（基本操作）

SDFusionのUIパネル（3D Viewportのサイドバー、Nキーで表示 > SDFusionタブ）から主に操作します。

レイヤーの準備:

  1. ベースとなるメッシュオブジェクトを選択。
  2. UIの「Workflow」セクションで「Reset Booleans & Collections」をクリック。

これで、ベースのコピーを作成し、初期レイヤー（ADD-1/SUB-1、ADD-2/SUB-2）が自動生成されます。
同時に、Booleanモディファイアが追加され、レイヤー内のオブジェクトがリアルタイムで反映されます。
最後に「GeoRemesh」モディファイア（ジオメトリノードベース）が加わり、ブーリアン後のメッシュを滑らかに調整可能。

オブジェクトの割り当て（Layer Assignmentセクション）:

  1. カッターオブジェクト（例: 立方体や球体など）を作成または選択。

  2. UIでレイヤーボタンをクリックして、オブジェクトを割り当て。

  3. 例: ADD-1ボタンを押す → オブジェクトがADD-1コレクションに移動し、ベースに追加される。

  4. 例: SUB-2ボタンを押す → オブジェクトがSUB-2コレクションに移動し、ベースから削り取られる。

「SDFusion Pool」: レイヤー外の一時保管庫。まだ使わないオブジェクトをここに置いておけます。
表示の自動調整: レイヤー内のオブジェクトはワイヤーフレームやバウンド表示になり、パフォーマンスを保ちます。

レイヤーの追加:

もっと階層が必要なら、「Add Layer」をクリック。

  • 新しいレイヤー（例: ADD-3/SUB-3）が作成され、モディファイアスタックに追加。
  • 無制限に追加可能なので、細かいディテールを段階的に積み重ねられます。

「Organize Modifiers」: モディファイアの順序を自動整列（GeoRemeshを最後に）。

調整とプレビュー（Live ControlsとTransform Toolsセクション）:

Live Controls: GeoRemeshのパラメータをスライダーでリアルタイム調整。形状の変化を即座に確認。 - Mesh Density: リメッシュ結果の解像度を制御。 - Smoothing: メッシュに適用するスムージング量。 - Sharp: エッジのシャープネスを制御。 - Edge Angle Parameter: エッジ検出のしきい値角度。

Transform Tools: 簡単操作で位置/回転を調整。 - X/Y/Z軸で90°/45°/30°回転。 - ワールド原点への移動（X/Y/Zを0に設定）。 - 3Dカーソルへのアライン。 - Display Type: オブジェクトの表示タイプ（Solid/Wireframe/Bounds）を切り替え。 - Overlay Wireframe: ワイヤーフレームオーバーレイのオン/オフ。

最終化（Finalizeセクション）:

  • 「Apply All」: すべてのモディファイアを適用し、最終メッシュを作成。カッターオブジェクトは「SDFusion Cutters」コレクションに移動（非表示）。
  • 「Cleanup All」: 一時コレクションとオブジェクトを削除し、プロジェクトをクリーンに。
  • 結果は「SDFusion Results」コレクションに保存。

ワークフローの全体像

典型的な流れは以下の通り。非破壊的なので、何度も試行錯誤できます。

  1. セットアップ: ベースを選択 → Resetでレイヤー初期化。
  2. 構築: カッターを作成 → Layer AssignmentでADD/SUBに割り当て → 追加レイヤーで階層を深く。
  3. 微調整: Live Controlsで滑らかさをチューニング → Transform Toolsで位置/回転を最適化。
  4. 確認と実験: リアルタイムプレビューで形状を確認。気に入らなければオブジェクトをPoolに移動したり、レイヤーを追加/削除。
  5. 完了: Apply Allで最終化 → Cleanupで整理。

この流れで、迅速なプロトタイピングから詳細な最終メッシュ生成まで対応します。

利点と注意点

利点:

  • 直感的で柔軟: レイヤーごとの管理で、複雑なブーリアンを階層的に扱いやすい。
  • 効率的: リアルタイム調整と自動セットアップで、手作業を減らし、パフォーマンスを維持。
  • 実験向き: 非破壊なので、失敗を恐れず形状を探求。資産ライブラリでプロシージャルカッターを即利用。

注意点:

  • レイヤー順序が重要: 低い番号（例: SUB-1）の操作が先に適用されるので、計画的に配置。
  • オブジェクト制限: 主にメッシュタイプ。プリミティブ（立方体など）から始めましょう。
  • Blenderバージョン: 4.5以上必須。初回は資産インストールを忘れずに（GeoRemeshノードが必要）。
  • パフォーマンス: レイヤーが多すぎると重くなる場合、表示をBoundsに切り替えたり、Cleanupを活用。

簡単な例: 穴あき立方体を作成

  1. ベースとして大きな立方体を選択 → Resetをクリック（レイヤー1/2作成）。
  2. 小さな球体を作成 → Layer AssignmentでSUB-1に割り当て → ベースに穴が開く。
  3. 円柱を作成 → Add Layerでレイヤー3追加 → ADD-3に割り当て → ベースに円柱が追加。
  4. Transform Toolsで位置/回転調整 → Live ControlsでMesh Densityを上げて滑らかに。
  5. Apply Allで最終メッシュ生成 → Cleanupでクリーンアップ。

このように、レイヤーはモデリングを楽しく効率的にします。特にハードサーフェスモデリング（機械部品など）に便利です。