Update C# examples and documentation (#4482)

* added more examples for C#

* improved documentations

* added c# example for triangulation

Author: ABSitf

doxygen/examples/GlobalRegistration.dox

@@ -7,12 +7,12 @@ Example of Global Registration
 
 - <b class="tab-title">C++</b>
 \include GlobalRegistration.dox.cpp
+- <b class="tab-title">Python</b>
+\include GlobalRegistration.dox.py
 - <b class="tab-title">C</b>
 \include GlobalRegistration.dox.c
 - <b class="tab-title">C#</b>
 \include GlobalRegistration.dox.cs
-- <b class="tab-title">Python</b>
-\include GlobalRegistration.dox.py
 
 </div>
 

doxygen/examples/MeshExport.dox

@@ -14,6 +14,9 @@ See a more relevant example \ref ExampleNumpy
 - <b class="tab-title">C</b>
 \include MeshExport.dox.c
 
+- <b class="tab-title">C#</b>
+\include MeshExport.dox.cs
+
 </div>
 
  */

doxygen/examples/MeshFillHole.dox

@@ -11,6 +11,8 @@ Example of filling holes
 \include MeshFillHole.dox.py
 - <b class="tab-title">C</b>
 \include MeshFillHole.dox.c
+- <b class="tab-title">C#</b>
+\include MeshFillHole.dox.cs
 
 </div>
 

doxygen/examples/MeshICP.dox

@@ -11,6 +11,8 @@ Example of mesh ICP (finding transformation to match objects)
 \include MeshICP.dox.py
 - <b class="tab-title">C</b>
 \include MeshICP.dox.c
+- <b class="tab-title">C#</b>
+\include MeshICP.dox.cs
 
 </div>
 

doxygen/examples/MeshLoadSave.dox

@@ -17,6 +17,9 @@ Further examples won't check return values for sake of clarity
 - <b class="tab-title">C</b>
 \include MeshLoadSave.dox.c
 
+- <b class="tab-title">C#</b>
+\include MeshLoadSave.dox.cs
+
 </div>
 
  */

doxygen/layout_templates/base_struct.xml

@@ -44,6 +44,8 @@
         <tab type="user" url="__BEGIN_URL__ExamplePlotly__END_URL__" title="Plotly Visualization"/>
         <tab type="user" url="__BEGIN_URL__ExampleNumpy__END_URL__" title="Using Numpy"/>
         <tab type="user" url="__BEGIN_URL__ExampleNumpyTriangulation__END_URL__" title="Numpy Triangulation"/>
+        <tab type="user" url="__BEGIN_URL__ExampleCudaOffset__END_URL__" title="Offset with Cuda"/>
+        <tab type="user" url="__BEGIN_URL__ExampleDicomFiles__END_URL__" title="Open Dicom Files"/>
       </tab>
     </tab>
     <tab type="usergroup" url="__BEGIN_URL__PackageOverview__END_URL__" title="Package Overview">

examples/c-sharp-examples/MeshICP.dox.cs

@@ -0,0 +1,42 @@
+using System.Reflection;
+using static MR.DotNet;
+
+public class MeshICPExample
+{
+    public static void Run()
+    {
+        try
+        {
+            // Load meshes
+
+            Mesh meshFloating = MeshLoad.FromAnySupportedFormat("meshA.stl");
+            MeshOrPointsXf meshXfFloating = new MeshOrPointsXf(meshFloating, new AffineXf3f());
+            MeshOrPointsXf meshXfFixed = new MeshOrPointsXf(MeshLoad.FromAnySupportedFormat("meshB.stl"), new AffineXf3f());
+
+            // Prepare ICP parameters
+            float diagonal = meshXfFixed.obj.BoundingBox.Diagonal();
+            float icpSamplingVoxelSize = diagonal * 0.01f; // To sample points from object
+            ICPProperties icpParams = new ICPProperties();
+            icpParams.distThresholdSq = diagonal * diagonal * 0.01f; // Use points pairs with maximum distance specified
+            icpParams.exitVal = diagonal * 0.003f; // Stop when distance reached
+
+            // Calculate transformation
+            ICP icp = new ICP(meshXfFloating, meshXfFixed, icpSamplingVoxelSize);
+            icp.SetParams( icpParams );
+            AffineXf3f xf = icp.CalculateTransformation();
+
+            // Transform floating mesh
+            meshFloating.Transform(xf);
+
+            // Output information string
+            Console.WriteLine("info {0}", icp.GetStatusInfo());
+
+            // Save result
+            MeshSave.ToAnySupportedFormat( meshFloating, "meshA_icp.stl");
+        }
+        catch (Exception e)
+        {
+            Console.WriteLine("Error: {0}", e.Message);
+        }
+    }
+}

examples/c-sharp-examples/Triangulation.dox.cs

@@ -0,0 +1,56 @@
+using System.Reflection;
+using static MR.DotNet;
+
+public class TriangulationExample
+{
+    public static void Run()
+    {
+        try
+        {
+            // Generate point cloud
+            Vector3f[] points = new Vector3f[9900];
+
+            const float uConst = MathF.PI * 2 / 100;
+            const float vConst = MathF.PI / 101;
+            for (int i = 0; i < 100; ++i)
+            {
+                float u = uConst * i;
+                for (int j = 1; j < 100; ++j)
+                {
+                    float v = vConst * j;
+
+                    points[i * 99 + j - 1] = new Vector3f(
+                        MathF.Cos(u) * MathF.Sin(v),
+                        MathF.Sin(u) * MathF.Sin(v),
+                        MathF.Cos(v)
+                    );
+                }
+            }
+
+            PointCloud pc = PointCloud.FromPoints(points);
+
+
+            // Triangulate it
+            TriangulationParameters parameters = new TriangulationParameters();
+            Mesh? triangulated = TriangulatePointCloud(pc, parameters);
+            if ( triangulated == null)
+            {
+                Console.WriteLine("Error during triangulation");
+                return;
+            }
+
+            // Fix possible issues
+            OffsetParameters offsetParameters = new OffsetParameters();
+            MeshPart mp = new MeshPart(triangulated);
+            offsetParameters.voxelSize = Offset.SuggestVoxelSize( mp, 5e+6f);
+            Mesh mesh = Offset.OffsetMesh(mp, 0f, offsetParameters);
+
+            // Save result
+            MeshSave.ToAnySupportedFormat(mp.mesh, "meshA_icp.stl");
+        }
+        catch (Exception e)
+        {
+            Console.WriteLine("Error: {0}", e.Message);
+        }
+    }
+}