Common/DemoMessageAndExceptionHandling.cs

@@ -0,0 +1,57 @@
+using System;
+using System.Threading.Tasks;
+using Hi.Common;
+using Hi.Common.Messages;
+
+namespace Sample.Common;
+
+/// <summary>
+/// Demonstrates common message and exception handling patterns in HiAPI applications
+/// </summary>
+/// <remarks>
+/// ### Source Code
+/// [!code-csharp[SampleCode](~/../Hi.Sample/Common/DemoMessageAndExceptionHandling.cs)]
+/// </remarks>
+public static class DemoMessageAndExceptionHandling
+{
+	/// <summary>
+	/// Demonstrates normal message handling
+	/// </summary>
+	internal static void DemoNormalMessages()
+	{
+		#region Normal_Messages
+		MessageUtil.ReportMessage("Operation completed successfully.");
+		MessageUtil.ReportWarning("Please check your input.");
+		#endregion
+	}
+	/// <summary>
+	/// Demonstrates exception handling in synchronous code
+	/// </summary>
+	internal static void DemoSynchronousExceptionHandling()
+	{
+		#region Sync_Exception
+		try
+		{
+			// Your code here
+			throw new NotImplementedException("Demo exception");
+		}
+		catch (Exception ex)
+		{
+			ExceptionUtil.ShowException(ex, null);
+		}
+		#endregion
+	}
+	/// <summary>
+	/// Demonstrates exception handling in asynchronous code
+	/// </summary>
+	internal static async Task DemoAsynchronousExceptionHandling()
+	{
+		#region Async_Exception
+		await Task.Run(() =>
+		{
+			// Your async operation here
+			throw new NotImplementedException("Demo async exception");
+		}).ShowIfCatched(null);
+		#endregion
+	}
+}

HelloHiAPI.cs

@@ -18,8 +18,7 @@ namespace Sample
         static int Main(string[] args)
         {
             Console.WriteLine("HiAPI starting.");
-            using var loggerFactory = Microsoft.Extensions.Logging.LoggerFactory.Create(b => b.AddConsole());
-            LocalApp.AppBegin(loggerFactory.CreateLogger("Hi.Sample"));
+            LocalApp.AppBegin();
 
             Console.WriteLine("Hello World! HiAPI.");
 

MachineTool/DemoBuildMachineTool.cs

@@ -1,4 +1,4 @@
-using Hi.Common.XmlUtils;
+using Hi.Common.XmlUtils;
 using Hi.Geom;
 using Hi.Mech;
 using Hi.Mech.Topo;
@@ -25,7 +25,7 @@ namespace Sample.MachineTool
     {
         static DemoBuildMachineTool()
         {
-            XFactory.Regs.Add(XName, (xml, baseDirectory, relFile, progress, res) => new DemoBuildMachineTool());
+            XFactory.Regs.Add(XName, (xml, baseDirectory, relFile, res) => new DemoBuildMachineTool());
         }
         /// <summary>
         /// Generates an XYZ-ABC machine tool instance from embedded resources.

Machining/DemoBuildGeomOnlyMachiningProject.cs

@@ -1,4 +1,4 @@
-using Hi.Common.XmlUtils;
+using Hi.Common.XmlUtils;
 using Hi.Geom;
 using Hi.MachiningProcs;
 using Hi.Mech.Topo;
@@ -42,8 +42,7 @@ public static class DemoBuildGeomOnlyMachiningProject
 
 	static void Main()
 	{
-		using var loggerFactory = Microsoft.Extensions.Logging.LoggerFactory.Create(b => b.AddConsole());
-		LocalApp.AppBegin(loggerFactory.CreateLogger("Hi.Sample"));
+		LocalApp.AppBegin();
 		LocalProjectService localProjectService = new LocalProjectService();
 
 		var projectPath = "C:/HiNC-Projects/NewProject/Main.hincproj";
@@ -83,10 +82,9 @@ public static class DemoBuildGeomOnlyMachiningProject
 			WorkpieceGeomToFixtureBuckleTransformer = new StaticTranslation(new Vec3d(0, 0, 0)),
 		};
 
-		IProgress<object> progress = null;
 		localProjectService.MachiningChain
 				= XFactory.GenByFile<CodeXyzabcMachineTool>(
-					"Resource", "MachineTool/PMC-B1/PMC-B1.mt", progress);
+					"Resource", "MachineTool/PMC-B1/PMC-B1.mt", GenMode.Default);
 		localProjectService.MachiningChainFile = "PMC-B1/PMC-B1.mt";
 
 		localProjectService.SaveProject();

Machining/DemoBuildMachiningProject.cs

@@ -1,4 +1,4 @@
-using System;
+using System;
 using Hi.Milling.Apts;
 using Hi.Common.XmlUtils;
 using Hi.Geom;
@@ -142,8 +142,7 @@ public static class DemoBuildMachiningProject
 	[STAThread]
 	static void Main()
 	{
-		using var loggerFactory = Microsoft.Extensions.Logging.LoggerFactory.Create(b => b.AddConsole());
-		LocalApp.AppBegin(loggerFactory.CreateLogger("Hi.Sample"));
+		LocalApp.AppBegin();
 		LocalProjectService localProjectService = new LocalProjectService();
 
 		var projectPath = "C:/HiNC-Projects/NewProject/Main.hincproj";
@@ -152,8 +151,6 @@ public static class DemoBuildMachiningProject
 		localProjectService.LoadProject(projectPath);
 		MachiningProject machiningProject = localProjectService.MachiningProject;
 
-		IProgress<object> progress = null;
-
 		#region ConfigureMachiningToolHouse
 		localProjectService.MachiningToolHouse = new MachiningToolHouse()
 		{
@@ -197,16 +194,16 @@ public static class DemoBuildMachiningProject
 			IdealGeom = null,
 			WorkpieceGeomToFixtureBuckleTransformer = new StaticTranslation(new Vec3d(0, 0, 0)),
 			CuttingPara = XFactory.GenByFile<ICuttingPara>(
-				"Resource/CuttingParameter", "Al6061T6.mp", progress),
+				"Resource/CuttingParameter", "Al6061T6.mp", GenMode.Default),
 			WorkpieceMaterial = XFactory.GenByFile<WorkpieceMaterial>(
-				"Resource/WorkpieceMaterial", "Al6061T6.WorkpieceMaterial", progress),
+				"Resource/WorkpieceMaterial", "Al6061T6.WorkpieceMaterial", GenMode.Default),
 		};
 		#endregion
 
 		#region ConfigureMachineChain
 		localProjectService.MachiningChain
 			= XFactory.GenByFile<CodeXyzabcMachineTool>(
-				"Resource", "MachineTool/PMC-B1/PMC-B1.mt", progress);
+				"Resource", "MachineTool/PMC-B1/PMC-B1.mt", GenMode.Default);
 		#endregion
 
 		machiningProject.MakeXmlSourceToFile(projectPath);

Machining/DemoUseMachiningProject.cs

@@ -21,8 +21,7 @@ public static class DemoUseMachiningProject
 {
 	static void Main()
 	{
-		using var loggerFactory = Microsoft.Extensions.Logging.LoggerFactory.Create(b => b.AddConsole());
-		LocalApp.AppBegin(loggerFactory.CreateLogger("Hi.Sample"));
+		LocalApp.AppBegin();
 		LocalProjectService localProjectService = new LocalProjectService();
 
 		#region ProjectLoading

Mech/DemoTopo1.cs

@@ -4,24 +4,24 @@ using Hi.Disp;
 using Hi.Geom;
 using Hi.Mech.Topo;
 
-namespace Sample.Mech;
-
-/// <summary>
-/// Demonstrates the creation and visualization of mechanical assemblies with kinematic linkages.
-/// Shows how to build coordinate systems, establish kinematic relationships, and capture visual output.
-/// </summary>
-/// <remarks>
-/// ### Source Code
-/// [!code-csharp[SampleCode](~/../Hi.Sample/Mech/DemoTopo1.cs)]
-/// </remarks>
-public static class DemoTopo1
+namespace Sample.Mech
 {
+    /// <summary>
+    /// Demonstrates the creation and visualization of mechanical assemblies with kinematic linkages.
+    /// Shows how to build coordinate systems, establish kinematic relationships, and capture visual output.
+    /// </summary>
+    /// <remarks>
+    /// ### Source Code
+    /// [!code-csharp[SampleCode](~/../Hi.Sample/Mech/DemoTopo1.cs)]
+    /// </remarks>
+    public static class DemoTopo1
+    {
         /// <summary>
         /// Creates a demonstration assembly with kinematic linkages.
         /// Builds a mechanical assembly with multiple anchors and branches, including both static and dynamic transformations.
         /// </summary>
         /// <returns>A tuple containing the assembly and root anchor</returns>
-	static (Asmb asmb, Anchor root) GetDemoAsmb()
+        static (Asmb asmb,Anchor root) GetDemoAsmb()
         {
             #region DocSite.DemoTopo1
             //build coordinate systems and the assembly.
@@ -50,7 +50,7 @@ public static class DemoTopo1
                 Console.WriteLine($"{keyValue.Key.Name} : {keyValue.Value}");
             #endregion
 
-		return (asmb, O);
+            return (asmb,O);
         }
         
         /// <summary>
@@ -78,4 +78,5 @@ public static class DemoTopo1
         {
             SnapshotToFile(GetDemoAsmb());
         }
+    }
 }