fix cubetree init crash.

2026-02-17 15:51:23 +08:00
parent 1a8a3b59d2
commit a21240016f
671 changed files with 12580 additions and 1166 deletions
@@ -243,7 +243,7 @@ This ctor is faster than <a class="xref" href="Hi.Cbtr.CubeTree.html#Hi_Cbtr_Cub
  <h4 class="section" id="Hi_Cbtr_CubeTree__ctor_Hi_Geom_NativeStl_System_Double_System_Threading_CancellationToken_System_IProgress_Hi_Common_NativeProgresses_IProgressReport___remarks">Remarks</h4>
  <div class="markdown level1 remarks"><p>The applied resolution is equal or smaller than the expected resolution.
 The applied resolution is c*(2^i). Where c is a constant; i is a integer to make the closest value of the formula.
-與輸入幾何的誤差分布在菱角及曲面處。</p>
+Errors relative to the input geometry are distributed at sharp edges and curved surfaces.</p>
 </div>


@@ -256,7 +256,7 @@ The applied resolution is c*(2^i). Where c is a constant; i is a integer to make
  
  </h3>

-  <div class="markdown level1 summary"><p>可使用Stl或NativeStl物件初始化，使用NativeStl的速度較快。輸入的三角網格必須是流形幾何(manifold geometry)，即三角形的頂點對齊其他三角形的頂點，且為封閉幾何。</p>
+  <div class="markdown level1 summary"><p>Can be initialized with Stl or NativeStl objects; using NativeStl is faster. The input triangle mesh must be manifold geometry, i.e., triangle vertices are aligned with other triangles' vertices, and the geometry must be closed.</p>
 </div>
  <div class="markdown level1 conceptual"></div>

@@ -269,8 +269,8 @@ The applied resolution is c*(2^i). Where c is a constant; i is a integer to make
    <dt><code>stl</code> <a class="xref" href="Hi.Geom.Stl.html">Stl</a></dt>
    <dd></dd>
    <dt><code>expectedResolution</code> <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.double">double</a></dt>
-    <dd><p>設定裕度，實際裕度會小於等於設定裕度，大約以2的指數作為級距。
-與輸入幾何的誤差分布在菱角及曲面處。</p>
+    <dd><p>Sets the preferred resolution. The actual resolution will be equal to or smaller than the specified value, approximately spaced by powers of 2.
+Errors relative to the input geometry are distributed at sharp edges and curved surfaces.</p>
 </dd>
    <dt><code>token</code> <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.threading.cancellationtoken">CancellationToken</a></dt>
    <dd><p>Cancellation token for the operation</p>
@@ -1043,14 +1043,14 @@ A triangle take 15 double.</p>
  <h4 class="section">Parameters</h4>
  <dl class="parameters">
    <dt><code>resolution</code> <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.double">double</a></dt>
-    <dd><p>設定裕度，實際裕度會小於等於設定裕度，大約以2的指數作為級距。與輸入幾何的誤差分布在菱角及曲面處。裕度越大，三角網格數量越少，運算也較迅速。</p>
+    <dd><p>Sets the preferred resolution. The actual resolution will be equal to or smaller than the specified value, approximately spaced by powers of 2. Errors relative to the input geometry are distributed at sharp edges and curved surfaces. A larger resolution results in fewer triangles and faster computation.</p>
 </dd>
  </dl>

  <h4 class="section">Returns</h4>
  <dl class="parameters">
    <dt><a class="xref" href="https://learn.microsoft.com/dotnet/api/system.collections.generic.list-1">List</a>&lt;<a class="xref" href="Hi.Geom.Tri3d.html">Tri3d</a>&gt;</dt>
-    <dd><p>三角網格</p>
+    <dd><p>Triangle mesh</p>
 </dd>
  </dl>

@@ -1159,7 +1159,7 @@ A triangle take 15 double.</p>

  <div class="markdown level1 summary"><p>Every node in <a class="xref" href="Hi.Cbtr.CubeTree.html">CubeTree</a> can contain one <a class="xref" href="Hi.Cbtr.CbtrPickable.html">CbtrPickable</a> object.
 This function put or replace the contained data of all nodes to <code class="paramref">src</code>.
-使用<a class="xref" href="Hi.Cbtr.CubeTree.html#Hi_Cbtr_CubeTree_UpdateAttach_Hi_Cbtr_CbtrPickable_">UpdateAttach(CbtrPickable)</a>會將尚未儲存資料(<a class="xref" href="Hi.Cbtr.CbtrPickable.html">CbtrPickable</a>為null)的節點放入src。</p>
+Using <a class="xref" href="Hi.Cbtr.CubeTree.html#Hi_Cbtr_CubeTree_UpdateAttach_Hi_Cbtr_CbtrPickable_">UpdateAttach(CbtrPickable)</a> will place nodes that have not yet stored data (<a class="xref" href="Hi.Cbtr.CbtrPickable.html">CbtrPickable</a> is null) into src.</p>
 </div>
  <div class="markdown level1 conceptual"></div>

@@ -1218,8 +1218,8 @@ This function put or replace the contained data of all nodes to <code class="par
  
  </h3>

-  <div class="markdown level1 summary"><p>使用BufferedTris效率比NativeStl好。
-若差集區域的裕度與本體的裕度不同，則該部位採用較低的裕度。</p>
+  <div class="markdown level1 summary"><p>Using BufferedTris is more efficient than NativeStl.
+If the resolution of the subtraction region differs from the body's resolution, the lower resolution is applied to that region.</p>
 </div>
  <div class="markdown level1 conceptual"></div>

@@ -1230,13 +1230,13 @@ This function put or replace the contained data of all nodes to <code class="par
  <h4 class="section">Parameters</h4>
  <dl class="parameters">
    <dt><code>cutterBufferedTris</code> <a class="xref" href="Hi.Cbtr.CachedTris.html">CachedTris</a></dt>
-    <dd><p>差集幾何</p>
+    <dd><p>Subtraction geometry</p>
 </dd>
    <dt><code>preferredCubeWidth</code> <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.double">double</a></dt>
    <dd><p>The preferred cube width for the operation.</p>
 </dd>
    <dt><code>isBuildContactContours</code> <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.boolean">bool</a></dt>
-    <dd><p>為真，則回傳的Substraction中含有差集幾何與工件幾何相交處的圍線群，該圍線群可做後續分析使用。</p>
+    <dd><p>If true, the returned Substraction contains contour groups at the intersection of the subtraction geometry and the workpiece geometry, which can be used for further analysis.</p>
 </dd>
    <dt><code>isAggressiveCut</code> <a class="xref" href="https://learn.microsoft.com/dotnet/api/system.boolean">bool</a></dt>
    <dd><p>If true, uses aggressive cutting mode.</p>
@@ -1362,7 +1362,7 @@ This function put or replace the contained data of all nodes to <code class="par
  
  </h3>

-  <div class="markdown level1 summary"><p>與Substract(BufferedTris,...)同功能。效率較差，多了一個轉換<a class="xref" href="Hi.Cbtr.CachedTris.html">CachedTris</a>的步驟。</p>
+  <div class="markdown level1 summary"><p>Same functionality as Substract(BufferedTris,...). Less efficient due to the additional step of converting to <a class="xref" href="Hi.Cbtr.CachedTris.html">CachedTris</a>.</p>
 </div>
  <div class="markdown level1 conceptual"></div>