Update docs — 2026-03-28 10:59

Author: mr-glt

v2/.doctrees/cpp-api/libvcad-tree-composition.doctree

@@ -524,9 +524,11 @@ <h2 id="B">B</h2>
       </ul></li>
       <li><a href="cpp-api/libvcad-tree-composition.html#_CPPv4N9BBoxUnion8addChildENSt10shared_ptrI4NodeEE">BBoxUnion::addChild (C++ function)</a>
 </li>
-      <li><a href="cpp-api/libvcad-tree-composition.html#_CPPv4N9BBoxUnion9BBoxUnionENSt6vectorINSt10shared_ptrI4NodeEEEE">BBoxUnion::BBoxUnion (C++ function)</a>, <a href="cpp-api/libvcad-tree-composition.html#_CPPv4N9BBoxUnion9BBoxUnionEv">[1]</a>
+      <li><a href="cpp-api/libvcad-tree-composition.html#_CPPv4N9BBoxUnion9BBoxUnionERKNSt6vectorINSt10shared_ptrI4NodeEEEE">BBoxUnion::BBoxUnion (C++ function)</a>, <a href="cpp-api/libvcad-tree-composition.html#_CPPv4N9BBoxUnion9BBoxUnionEd">[1]</a>, <a href="cpp-api/libvcad-tree-composition.html#_CPPv4N9BBoxUnion9BBoxUnionEdRKNSt6vectorINSt10shared_ptrI4NodeEEEE">[2]</a>, <a href="cpp-api/libvcad-tree-composition.html#_CPPv4N9BBoxUnion9BBoxUnionEv">[3]</a>
 </li>
       <li><a href="cpp-api/libvcad-tree-composition.html#_CPPv4N9BBoxUnion12bounding_boxEv">BBoxUnion::bounding_box (C++ function)</a>
+</li>
+      <li><a href="cpp-api/libvcad-tree-composition.html#_CPPv4N9BBoxUnion24cache_child_bounding_boxERKNSt10shared_ptrI4NodeEE">BBoxUnion::cache_child_bounding_box (C++ function)</a>
 </li>
       <li><a href="cpp-api/libvcad-tree-composition.html#_CPPv4N9BBoxUnion5cloneEv">BBoxUnion::clone (C++ function)</a>
 </li>
@@ -535,15 +537,39 @@ <h2 id="B">B</h2>
       <li><a href="cpp-api/libvcad-tree-composition.html#_CPPv4N9BBoxUnion8evaluateEddd">BBoxUnion::evaluate (C++ function)</a>
 </li>
       <li><a href="cpp-api/libvcad-tree-composition.html#_CPPv4N9BBoxUnion11m_aabb_treeE">BBoxUnion::m_aabb_tree (C++ member)</a>
+</li>
+      <li><a href="cpp-api/libvcad-tree-composition.html#_CPPv4N9BBoxUnion22m_child_bounding_boxesE">BBoxUnion::m_child_bounding_boxes (C++ member)</a>
+</li>
+      <li><a href="cpp-api/libvcad-tree-composition.html#_CPPv4N9BBoxUnion10m_smooth_kE">BBoxUnion::m_smooth_k (C++ member)</a>
 </li>
       <li><a href="cpp-api/libvcad-tree-composition.html#_CPPv4N9BBoxUnion13material_listEv">BBoxUnion::material_list (C++ function)</a>
+</li>
+      <li><a href="cpp-api/libvcad-tree-composition.html#_CPPv4N9BBoxUnion14sharp_evaluateEddd">BBoxUnion::sharp_evaluate (C++ function)</a>
+</li>
+      <li><a href="cpp-api/libvcad-tree-composition.html#_CPPv4N9BBoxUnion21SharpEvaluationResultE">BBoxUnion::SharpEvaluationResult (C++ struct)</a>
+</li>
+      <li><a href="cpp-api/libvcad-tree-composition.html#_CPPv4N9BBoxUnion21SharpEvaluationResult8min_nodeE">BBoxUnion::SharpEvaluationResult::min_node (C++ member)</a>
+</li>
+      <li><a href="cpp-api/libvcad-tree-composition.html#_CPPv4N9BBoxUnion21SharpEvaluationResult9min_valueE">BBoxUnion::SharpEvaluationResult::min_value (C++ member)</a>
+</li>
+      <li><a href="cpp-api/libvcad-tree-composition.html#_CPPv4N9BBoxUnion15smooth_evaluateEddd">BBoxUnion::smooth_evaluate (C++ function)</a>
+</li>
+      <li><a href="cpp-api/libvcad-tree-composition.html#_CPPv4N9BBoxUnion22SmoothEvaluationResultE">BBoxUnion::SmoothEvaluationResult (C++ struct)</a>
+</li>
+      <li><a href="cpp-api/libvcad-tree-composition.html#_CPPv4N9BBoxUnion22SmoothEvaluationResult8min_nodeE">BBoxUnion::SmoothEvaluationResult::min_node (C++ member)</a>
+</li>
+      <li><a href="cpp-api/libvcad-tree-composition.html#_CPPv4N9BBoxUnion22SmoothEvaluationResult9min_valueE">BBoxUnion::SmoothEvaluationResult::min_value (C++ member)</a>
+</li>
+      <li><a href="cpp-api/libvcad-tree-composition.html#_CPPv4N9BBoxUnion22SmoothEvaluationResult12smooth_valueE">BBoxUnion::SmoothEvaluationResult::smooth_value (C++ member)</a>
 </li>
       <li><a href="cpp-api/libvcad-tree-core.html#_CPPv46Binary">Binary (C++ class)</a>
 
       <ul>
         <li><a href="python-api/pyvcad/tree.html#pyvcad.Binary">(class in pyvcad)</a>
 </li>
       </ul></li>
+  </ul></td>
+  <td style="width: 33%; vertical-align: top;"><ul>
       <li><a href="cpp-api/libvcad-tree-core.html#_CPPv4N6Binary6BinaryERKNSt10shared_ptrI4NodeEERKNSt10shared_ptrI4NodeEE">Binary::Binary (C++ function)</a>, <a href="cpp-api/libvcad-tree-core.html#_CPPv4N6Binary6BinaryEv">[1]</a>
 </li>
       <li><a href="cpp-api/libvcad-tree-core.html#_CPPv4NK6Binary9leftChildEv">Binary::leftChild (C++ function)</a>
@@ -556,8 +582,6 @@ <h2 id="B">B</h2>
 </li>
       <li><a href="cpp-api/libvcad-tree-core.html#_CPPv4NK6Binary10rightChildEv">Binary::rightChild (C++ function)</a>
 </li>
-  </ul></td>
-  <td style="width: 33%; vertical-align: top;"><ul>
       <li><a href="cpp-api/libvcad-tree-core.html#_CPPv4N6Binary12setLeftChildENSt10shared_ptrI4NodeEE">Binary::setLeftChild (C++ function)</a>
 </li>
       <li><a href="cpp-api/libvcad-tree-core.html#_CPPv4N6Binary13setRightChildENSt10shared_ptrI4NodeEE">Binary::setRightChild (C++ function)</a>

v2/.doctrees/environment.pickle

@@ -406,7 +406,7 @@ <h1>Tree — composition nodes<a class="headerlink" href="#tree-composition-node
 </pre></div>
 </div>
 <ol class="arabic simple" start="2">
-<li><p>__init__(self: pyvcad.pyvcad.Rotate, pitch: typing.SupportsFloat, yaw: typing.SupportsFloat, roll: typing.SupportsFloat, around: pyvcad.pyvcad.Vec3 = &lt;pyvcad.pyvcad.Vec3 object at 0x106f14330&gt;) -&gt; None</p></li>
+<li><p>__init__(self: pyvcad.pyvcad.Rotate, pitch: typing.SupportsFloat, yaw: typing.SupportsFloat, roll: typing.SupportsFloat, around: pyvcad.pyvcad.Vec3 = &lt;pyvcad.pyvcad.Vec3 object at 0x108da3bf0&gt;) -&gt; None</p></li>
 </ol>
 <p>Constructor. Creates a Rotate with pitch, yaw, roll angles, and a point around which the rotation is performed.</p>
 <dl class="field-list simple">
@@ -993,7 +993,7 @@ <h1>Tree — composition nodes<a class="headerlink" href="#tree-composition-node
 <dl class="py class">
 <dt class="sig sig-object py" id="pyvcad.BBoxUnion">
 <span class="property"><span class="k"><span class="pre">class</span></span><span class="w"> </span></span><span class="sig-prename descclassname"><span class="pre">pyvcad.</span></span><span class="sig-name descname"><span class="pre">BBoxUnion</span></span><a class="headerlink" href="#pyvcad.BBoxUnion" title="Link to this definition">#</a></dt>
-<dd><p>An n-ary node that represents the union of bounding boxes.</p>
+<dd><p>An n-ary node that accelerates union queries with child bounding boxes. Supports optional smooth blending when k &gt; 0.</p>
 <dl class="py method">
 <dt class="sig sig-object py" id="pyvcad.BBoxUnion.__init__">
 <span class="sig-name descname"><span class="pre">__init__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#pyvcad.BBoxUnion.__init__" title="Link to this definition">#</a></dt>
@@ -1003,7 +1003,8 @@ <h1>Tree — composition nodes<a class="headerlink" href="#tree-composition-node
 </ol>
 <p>Default constructor for BBoxUnion.</p>
 <p class="rubric">Example</p>
-<div class="doctest highlight-default notranslate"><div class="highlight"><pre><span></span><span class="gp">&gt;&gt;&gt; </span><span class="n">union_node</span> <span class="o">=</span> <span class="n">pv</span><span class="o">.</span><span class="n">BBoxUnion</span><span class="p">()</span>
+<div class="doctest highlight-default notranslate"><div class="highlight"><pre><span></span><span class="gp">&gt;&gt;&gt; </span><span class="kn">from</span><span class="w"> </span><span class="nn">libvcad</span><span class="w"> </span><span class="kn">import</span> <span class="n">pyvcad</span> <span class="k">as</span> <span class="n">pv</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">union_node</span> <span class="o">=</span> <span class="n">pv</span><span class="o">.</span><span class="n">BBoxUnion</span><span class="p">()</span>
 </pre></div>
 </div>
 <ol class="arabic simple" start="2">
@@ -1016,10 +1017,43 @@ <h1>Tree — composition nodes<a class="headerlink" href="#tree-composition-node
 </dd>
 </dl>
 <p class="rubric">Example</p>
-<div class="doctest highlight-default notranslate"><div class="highlight"><pre><span></span><span class="gp">&gt;&gt;&gt; </span><span class="n">children</span> <span class="o">=</span> <span class="p">[</span><span class="n">child1</span><span class="p">,</span> <span class="n">child2</span><span class="p">]</span>
+<div class="doctest highlight-default notranslate"><div class="highlight"><pre><span></span><span class="gp">&gt;&gt;&gt; </span><span class="kn">from</span><span class="w"> </span><span class="nn">libvcad</span><span class="w"> </span><span class="kn">import</span> <span class="n">pyvcad</span> <span class="k">as</span> <span class="n">pv</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">children</span> <span class="o">=</span> <span class="p">[</span><span class="n">child1</span><span class="p">,</span> <span class="n">child2</span><span class="p">]</span>
 <span class="gp">&gt;&gt;&gt; </span><span class="n">union_node</span> <span class="o">=</span> <span class="n">pv</span><span class="o">.</span><span class="n">BBoxUnion</span><span class="p">(</span><span class="n">children</span><span class="p">)</span>
 </pre></div>
 </div>
+<ol class="arabic simple" start="3">
+<li><p>__init__(self: pyvcad.pyvcad.BBoxUnion, k: typing.SupportsFloat) -&gt; None</p></li>
+</ol>
+<p>Constructor for smooth BBoxUnion.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><p><strong>k</strong> (<em>float</em>) – The smoothing radius. When k &gt; 0, enables smooth union behavior.</p>
+</dd>
+</dl>
+<p class="rubric">Example</p>
+<div class="doctest highlight-default notranslate"><div class="highlight"><pre><span></span><span class="gp">&gt;&gt;&gt; </span><span class="kn">from</span><span class="w"> </span><span class="nn">libvcad</span><span class="w"> </span><span class="kn">import</span> <span class="n">pyvcad</span> <span class="k">as</span> <span class="n">pv</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">union_node</span> <span class="o">=</span> <span class="n">pv</span><span class="o">.</span><span class="n">BBoxUnion</span><span class="p">(</span><span class="mf">1.0</span><span class="p">)</span>
+</pre></div>
+</div>
+<ol class="arabic simple" start="4">
+<li><p>__init__(self: pyvcad.pyvcad.BBoxUnion, k: typing.SupportsFloat, children: collections.abc.Sequence[pyvcad.pyvcad.Node]) -&gt; None</p></li>
+</ol>
+<p>Constructor for smooth BBoxUnion with children.</p>
+<dl class="field-list simple">
+<dt class="field-odd">Parameters<span class="colon">:</span></dt>
+<dd class="field-odd"><ul class="simple">
+<li><p><strong>k</strong> (<em>float</em>) – The smoothing radius. When k &gt; 0, enables smooth union behavior.</p></li>
+<li><p><strong>children</strong> (<em>list</em><em> of </em><a class="reference internal" href="tree.html#pyvcad.Node" title="pyvcad.Node"><em>Node</em></a>) – The list of child nodes.</p></li>
+</ul>
+</dd>
+</dl>
+<p class="rubric">Example</p>
+<div class="doctest highlight-default notranslate"><div class="highlight"><pre><span></span><span class="gp">&gt;&gt;&gt; </span><span class="kn">from</span><span class="w"> </span><span class="nn">libvcad</span><span class="w"> </span><span class="kn">import</span> <span class="n">pyvcad</span> <span class="k">as</span> <span class="n">pv</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">children</span> <span class="o">=</span> <span class="p">[</span><span class="n">child1</span><span class="p">,</span> <span class="n">child2</span><span class="p">]</span>
+<span class="gp">&gt;&gt;&gt; </span><span class="n">union_node</span> <span class="o">=</span> <span class="n">pv</span><span class="o">.</span><span class="n">BBoxUnion</span><span class="p">(</span><span class="mf">1.0</span><span class="p">,</span> <span class="n">children</span><span class="p">)</span>
+</pre></div>
+</div>
 </dd></dl>
 
 </dd></dl>

v2/.doctrees/python-api/pyvcad/composition.doctree

@@ -395,7 +395,7 @@ <h1>Tree — leaf nodes<a class="headerlink" href="#tree-leaf-nodes" title="Link
 <span class="sig-name descname"><span class="pre">__init__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#pyvcad.Function.__init__" title="Link to this definition">#</a></dt>
 <dd><p>Overloaded function.</p>
 <ol class="arabic simple">
-<li><p>__init__(self: pyvcad.pyvcad.Function, function: str, material: typing.SupportsInt = 1, min: pyvcad.pyvcad.Vec3 = &lt;pyvcad.pyvcad.Vec3 object at 0x106ecbe70&gt;, max: pyvcad.pyvcad.Vec3 = &lt;pyvcad.pyvcad.Vec3 object at 0x106ecbe30&gt;) -&gt; None</p></li>
+<li><p>__init__(self: pyvcad.pyvcad.Function, function: str, material: typing.SupportsInt = 1, min: pyvcad.pyvcad.Vec3 = &lt;pyvcad.pyvcad.Vec3 object at 0x108d90130&gt;, max: pyvcad.pyvcad.Vec3 = &lt;pyvcad.pyvcad.Vec3 object at 0x108d900f0&gt;) -&gt; None</p></li>
 </ol>
 <p>Constructor that takes a function to evaluate, a material, and bounding box.</p>
 <dl class="field-list simple">
@@ -414,7 +414,7 @@ <h1>Tree — leaf nodes<a class="headerlink" href="#tree-leaf-nodes" title="Link
 </pre></div>
 </div>
 <ol class="arabic simple" start="2">
-<li><p>__init__(self: pyvcad.pyvcad.Function, function: collections.abc.Callable[[typing.SupportsFloat, typing.SupportsFloat, typing.SupportsFloat, typing.SupportsFloat, typing.SupportsFloat, typing.SupportsFloat, typing.SupportsFloat, typing.SupportsFloat], float], material: typing.SupportsInt = 1, min: pyvcad.pyvcad.Vec3 = &lt;pyvcad.pyvcad.Vec3 object at 0x100c9a8f0&gt;, max: pyvcad.pyvcad.Vec3 = &lt;pyvcad.pyvcad.Vec3 object at 0x106ecba30&gt;) -&gt; None</p></li>
+<li><p>__init__(self: pyvcad.pyvcad.Function, function: collections.abc.Callable[[typing.SupportsFloat, typing.SupportsFloat, typing.SupportsFloat, typing.SupportsFloat, typing.SupportsFloat, typing.SupportsFloat, typing.SupportsFloat, typing.SupportsFloat], float], material: typing.SupportsInt = 1, min: pyvcad.pyvcad.Vec3 = &lt;pyvcad.pyvcad.Vec3 object at 0x108d5e830&gt;, max: pyvcad.pyvcad.Vec3 = &lt;pyvcad.pyvcad.Vec3 object at 0x108d5e8f0&gt;) -&gt; None</p></li>
 </ol>
 <p>Constructor that takes a native python function to evaluate, a material id, and bounding box.</p>
 <dl class="field-list simple">