refactor(Sample): adapt demos to XFactory IProgress<object> signature

Made-with: Cursor

Common/DemoMessageAndExceptionHandling.cs

@@ -1,57 +0,0 @@
-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,7 +18,8 @@ namespace Sample
         static int Main(string[] args)
         {
             Console.WriteLine("HiAPI starting.");
-            LocalApp.AppBegin();
+            using var loggerFactory = Microsoft.Extensions.Logging.LoggerFactory.Create(b => b.AddConsole());
+            LocalApp.AppBegin(loggerFactory.CreateLogger("Hi.Sample"));
 
             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, res) => new DemoBuildMachineTool());
+            XFactory.Regs.Add(XName, (xml, baseDirectory, relFile, progress, 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,7 +42,8 @@ public static class DemoBuildGeomOnlyMachiningProject
 
 	static void Main()
 	{
-		LocalApp.AppBegin();
+		using var loggerFactory = Microsoft.Extensions.Logging.LoggerFactory.Create(b => b.AddConsole());
+		LocalApp.AppBegin(loggerFactory.CreateLogger("Hi.Sample"));
 		LocalProjectService localProjectService = new LocalProjectService();
 
 		var projectPath = "C:/HiNC-Projects/NewProject/Main.hincproj";
@@ -82,9 +83,10 @@ 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", GenMode.Default);
+					"Resource", "MachineTool/PMC-B1/PMC-B1.mt", progress);
 		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,7 +142,8 @@ public static class DemoBuildMachiningProject
 	[STAThread]
 	static void Main()
 	{
-		LocalApp.AppBegin();
+		using var loggerFactory = Microsoft.Extensions.Logging.LoggerFactory.Create(b => b.AddConsole());
+		LocalApp.AppBegin(loggerFactory.CreateLogger("Hi.Sample"));
 		LocalProjectService localProjectService = new LocalProjectService();
 
 		var projectPath = "C:/HiNC-Projects/NewProject/Main.hincproj";
@@ -151,6 +152,8 @@ public static class DemoBuildMachiningProject
 		localProjectService.LoadProject(projectPath);
 		MachiningProject machiningProject = localProjectService.MachiningProject;
 
+		IProgress<object> progress = null;
+
 		#region ConfigureMachiningToolHouse
 		localProjectService.MachiningToolHouse = new MachiningToolHouse()
 		{
@@ -194,16 +197,16 @@ public static class DemoBuildMachiningProject
 			IdealGeom = null,
 			WorkpieceGeomToFixtureBuckleTransformer = new StaticTranslation(new Vec3d(0, 0, 0)),
 			CuttingPara = XFactory.GenByFile<ICuttingPara>(
-				"Resource/CuttingParameter", "Al6061T6.mp", GenMode.Default),
+				"Resource/CuttingParameter", "Al6061T6.mp", progress),
 			WorkpieceMaterial = XFactory.GenByFile<WorkpieceMaterial>(
-				"Resource/WorkpieceMaterial", "Al6061T6.WorkpieceMaterial", GenMode.Default),
+				"Resource/WorkpieceMaterial", "Al6061T6.WorkpieceMaterial", progress),
 		};
 		#endregion
 
 		#region ConfigureMachineChain
 		localProjectService.MachiningChain
 			= XFactory.GenByFile<CodeXyzabcMachineTool>(
-				"Resource", "MachineTool/PMC-B1/PMC-B1.mt", GenMode.Default);
+				"Resource", "MachineTool/PMC-B1/PMC-B1.mt", progress);
 		#endregion
 
 		machiningProject.MakeXmlSourceToFile(projectPath);

Machining/DemoUseMachiningProject.cs

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

Mech/DemoTopo1.cs

@@ -4,79 +4,78 @@ using Hi.Disp;
 using Hi.Geom;
 using Hi.Mech.Topo;
 
-namespace Sample.Mech
+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>
-    /// 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()
-        {
-            #region DocSite.DemoTopo1
-            //build coordinate systems and the assembly.
-            Asmb asmb = new Asmb { Name = "Mech" };
-            Anchor O = new Anchor(asmb, "O");
-            Anchor O1 = new Anchor(asmb, "O1");
-            Anchor X = new Anchor(asmb, "X");
-            Anchor Z = new Anchor(asmb, "Z");
-            Anchor B = new Anchor(asmb, "B");
+	/// <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()
+	{
+		#region DocSite.DemoTopo1
+		//build coordinate systems and the assembly.
+		Asmb asmb = new Asmb { Name = "Mech" };
+		Anchor O = new Anchor(asmb, "O");
+		Anchor O1 = new Anchor(asmb, "O1");
+		Anchor X = new Anchor(asmb, "X");
+		Anchor Z = new Anchor(asmb, "Z");
+		Anchor B = new Anchor(asmb, "B");
 
-            //build kinematic link
-            Branch.Attach(O, O1, new StaticTranslation(new Vec3d(0, 0, 80)));
-            Branch brnX = Branch.Attach(O1, X, new DynamicTranslation(new Vec3d(1, 0, 0)));
-            Branch brnZ = Branch.Attach(X, Z, new DynamicTranslation(new Vec3d(0, 0, 1)));
-            Branch brnB = Branch.Attach(Z, B, new DynamicRotation(new Vec3d(0, 1, 0), 0, new Vec3d(-100, 0, 0)));
+		//build kinematic link
+		Branch.Attach(O, O1, new StaticTranslation(new Vec3d(0, 0, 80)));
+		Branch brnX = Branch.Attach(O1, X, new DynamicTranslation(new Vec3d(1, 0, 0)));
+		Branch brnZ = Branch.Attach(X, Z, new DynamicTranslation(new Vec3d(0, 0, 1)));
+		Branch brnB = Branch.Attach(Z, B, new DynamicRotation(new Vec3d(0, 1, 0), 0, new Vec3d(-100, 0, 0)));
 
-            //drive the dynamic transformation by single value for each branch.
-            brnX.Step = 200;
-            brnZ.Step = 100;
-            brnB.Step = MathUtil.ToRad(-60);
+		//drive the dynamic transformation by single value for each branch.
+		brnX.Step = 200;
+		brnZ.Step = 100;
+		brnB.Step = MathUtil.ToRad(-60);
 
-            //Get and show the transform matrices relative to O.
-            Dictionary<Anchor, Mat4d> matMap = asmb.GetMat4dMap(O);
-            Console.WriteLine("Transform Matrix relative to O:");
-            foreach (KeyValuePair<Anchor, Mat4d> keyValue in matMap)
-                Console.WriteLine($"{keyValue.Key.Name} : {keyValue.Value}");
-            #endregion
+		//Get and show the transform matrices relative to O.
+		Dictionary<Anchor, Mat4d> matMap = asmb.GetMat4dMap(O);
+		Console.WriteLine("Transform Matrix relative to O:");
+		foreach (KeyValuePair<Anchor, Mat4d> keyValue in matMap)
+			Console.WriteLine($"{keyValue.Key.Name} : {keyValue.Value}");
+		#endregion
 
-            return (asmb,O);
-        }
+		return (asmb, O);
+	}
 
-        /// <summary>
-        /// Captures the assembly visualization and saves it to a file.
-        /// Initializes the display engine, sets up the assembly visualization with an isometric view, and saves a snapshot to a bitmap file.
-        /// </summary>
-        /// <param name="src">A tuple containing the assembly and root anchor for visualization</param>
-        static void SnapshotToFile((Asmb asmb, Anchor root) src)
-        {
-            //all the drawing function has to call DispEngine.Init() before using.
-            DispEngine.Init();
-            DispEngine.EnableSuppressDefaultLogo = true;
+	/// <summary>
+	/// Captures the assembly visualization and saves it to a file.
+	/// Initializes the display engine, sets up the assembly visualization with an isometric view, and saves a snapshot to a bitmap file.
+	/// </summary>
+	/// <param name="src">A tuple containing the assembly and root anchor for visualization</param>
+	static void SnapshotToFile((Asmb asmb, Anchor root) src)
+	{
+		//all the drawing function has to call DispEngine.Init() before using.
+		DispEngine.Init();
+		DispEngine.EnableSuppressDefaultLogo = true;
 
-            using (DispEngine dispEngine = new DispEngine(
-                src.asmb.GetAsmbDraw(src.root)))
-            {
-                dispEngine.SetViewToIsometricView();
-                dispEngine.Snapshot("DemoTopo1.bmp", 680, 480);
-            }
-            Console.WriteLine("Snapshot file output.");
+		using (DispEngine dispEngine = new DispEngine(
+			src.asmb.GetAsmbDraw(src.root)))
+		{
+			dispEngine.SetViewToIsometricView();
+			dispEngine.Snapshot("DemoTopo1.bmp", 680, 480);
+		}
+		Console.WriteLine("Snapshot file output.");
 
-            DispEngine.FinishDisp();
-        }
-        static void Main()
-        {
-            SnapshotToFile(GetDemoAsmb());
-        }
-    }
+		DispEngine.FinishDisp();
+	}
+	static void Main()
+	{
+		SnapshotToFile(GetDemoAsmb());
+	}
 }