• macad.core解析exchange

    1.exchange

    1. using System;
    2. using System.Collections.Generic;
    3. using System.Linq;
    4. using Macad.Core;
    5.  
    6. namespace Macad.Core
    7. {
    8.     // 交换器注册表
    9.     public static class ExchangeRegistry
    10.     {
    11.         // 交换器字典
    12.         static readonly Dictionary> _Exchangers = new Dictionary>();
    13.  
    14.         // 设置面板字典
    15.         static readonly Dictionary _ExchangerSettingPanels = new Dictionary();
    16.  
    17.         // 枚举和创建区域
    18.  
    19.         // 枚举指定类型的所有交换器
    20.         public static IEnumerable<T> EnumerateExchanger<T>() where T : IExchanger
    21.         {
    22.             if (_Exchangers.TryGetValue(typeof(T), out var list))
    23.                 return list.Cast();
    24.             return new List();
    25.         }
    26.  
    27.         // 查找指定类型的交换器
    28.         public static T FindExchanger<T>(string extension) where T : class, IExchanger
    29.         {
    30.             if (!_Exchangers.TryGetValue(typeof(T), out var list))
    31.                 return null;
    32.  
    33.             var lowerExtension = extension.ToLower();
    34.             return list.FirstOrDefault(exchanger => exchanger.Extensions.Contains(lowerExtension)) as T;
    35.         }
    36.  
    37.         // 判断指定类型的交换器是否支持导出到剪贴板
    38.         public static bool CanExportToClipboard<T>() where T : IExchanger
    39.         {
    40.             if (!_Exchangers.TryGetValue(typeof(T), out var list))
    41.                 return false;
    42.             return list.Any(exchanger => exchanger.CanExportToClipboard());
    43.         }
    44.  
    45.         // 判断指定类型的交换器是否支持从剪贴板导入
    46.         public static bool CanImportFromClipboard<T>(Clipboard clipboard) where T : IExchanger
    47.         {
    48.             if (!_Exchangers.TryGetValue(typeof(T), out var list))
    49.                 return false;
    50.             return list.Any(exchanger => exchanger.CanImportFromClipboard(clipboard));
    51.         }
    52.  
    53.         // 注册区域
    54.  
    55.         // 添加交换器到字典
    56.         static void _AddExchanger(IExchanger exchanger, Type interfaceType)
    57.         {
    58.             if (!_Exchangers.TryGetValue(interfaceType, out var list))
    59.             {
    60.                 list = new List();
    61.                 _Exchangers.Add(interfaceType, list);
    62.             }
    63.  
    64.             if (list.Exists(ex => ex.GetType() == exchanger.GetType()))
    65.             {
    66.                 Messages.Warning($"Exchanger {exchanger.GetType().FullName} already registered for type {interfaceType.Name}");
    67.                 return;
    68.             }
    69.  
    70.             list.Add(exchanger);
    71.         }
    72.  
    73.         // 注册交换器
    74.         public static void Register(IExchanger exchanger)
    75.         {
    76.             var interfaces = exchanger.GetType().GetInterfaces();
    77.  
    78.             foreach (var interfaceType in interfaces)
    79.             {
    80.                 _AddExchanger(exchanger, interfaceType);
    81.             }
    82.         }
    83.  
    84.         // 注册设置面板
    85.         public static void Register(IExchangerSettingsPanelCreator panelCreator)
    86.         {
    87.             if (_ExchangerSettingPanels.TryGetValue(panelCreator.ExchangerType, out var firstPanel))
    88.             {
    89.                 Messages.Error($"Multiple setting panels registered for exchanger {panelCreator.ExchangerType.FullName}: {firstPanel.GetType().FullName} / {panelCreator.GetType().FullName}.");
    90.                 return;
    91.             }
    92.  
    93.             _ExchangerSettingPanels.Add(panelCreator.ExchangerType, panelCreator);
    94.         }
    95.  
    96.         // 查找交换器设置面板
    97.         public static IExchangerSettingsPanelCreator FindExchangerSettingsPanel(IExchanger exchanger)
    98.         {
    99.             if (_ExchangerSettingPanels.TryGetValue(exchanger.GetType(), out var panelCreator))
    100.             {
    101.                 return panelCreator;
    102.             }
    103.  
    104.             return null;
    105.         }
    106.  
    107.         // 设置区域
    108.  
    109.         // 保存设置
    110.         public static void SaveSettings()
    111.         {
    112.             try
    113.             {
    114.                 var settingsList = new Dictionary<string, IExchangerSettings>();
    115.                 var exchangers = _Exchangers.Values.SelectMany(list => list).Distinct();
    116.                 foreach (var exchanger in exchangers)
    117.                 {
    118.                     if (exchanger.Settings != null)
    119.                         settingsList.Add(exchanger.GetType().Name, exchanger.Settings);
    120.                 }
    121.  
    122.                 CoreContext.Current.SaveLocalSettings("ExchangerSettings", settingsList);
    123.             }
    124.             catch (Exception)
    125.             {
    126.                 return;
    127.             }
    128.         }
    129.  
    130.         // 加载设置
    131.         public static void LoadSettings()
    132.         {
    133.             try
    134.             {
    135.                 var settingsList = CoreContext.Current.LoadLocalSettingsstring, IExchangerSettings>>("ExchangerSettings");
    136.                 if (settingsList == null || settingsList.Count == 0)
    137.                     return;
    138.  
    139.                 var exchangers = _Exchangers.Values.SelectMany(list => list).Distinct();
    140.                 foreach (var exchanger in exchangers)
    141.                 {
    142.                     if (settingsList.TryGetValue(exchanger.GetType().Name, out var settingObj))
    143.                         exchanger.Settings = settingObj;
    144.                 }
    145.             }
    146.             catch (Exception)
    147.             {
    148.                 return;
    149.             }
    150.         }
    151.     }
    152. }

    这段代码实现了一个交换器注册表，其中包含了注册、枚举、查找、设置保存和加载等功能：

    • 注册区域：包括注册交换器和注册设置面板。
    • 枚举和创建区域：包括枚举指定类型的所有交换器和查找指定类型的交换器。
    • 设置区域：包括保存设置和加载设置。

    2.

    1. using System;
    2. using System.Collections.Generic;
    3. using Macad.Common.Serialization;
    4.  
    5. namespace Macad.Core
    6. {
    7.     // 交换器设置接口
    8.     [SerializeType]
    9.     public interface IExchangerSettings
    10.     {}
    11.  
    12.     //--------------------------------------------------------------------------------------------------
    13.  
    14.     // 交换器接口
    15.     public interface IExchanger
    16.     {
    17.         string Description { get; }         // 获取交换器描述
    18.         string[] Extensions { get; }        // 获取支持的文件扩展名
    19.         IExchangerSettings Settings { get; set; }   // 获取或设置交换器设置
    20.  
    21.         // 判断是否可以导出到剪贴板
    22.         bool CanExportToClipboard();
    23.         
    24.         // 判断是否可以从剪贴板导入
    25.         bool CanImportFromClipboard(Clipboard clipboard);
    26.     }
    27.  
    28.     //--------------------------------------------------------------------------------------------------
    29.  
    30.     // 实体导出器接口
    31.     public interface IBodyExporter : IExchanger
    32.     {
    33.         // 导出实体
    34.         bool DoExport(string fileName, IEnumerable bodies);
    35.     }
    36.  
    37.     //--------------------------------------------------------------------------------------------------
    38.  
    39.     // 实体导入器接口
    40.     public interface IBodyImporter : IExchanger
    41.     {
    42.         // 导入实体
    43.         bool DoImport(string fileName, out IEnumerable bodies);
    44.     }
    45.  
    46.     //--------------------------------------------------------------------------------------------------
    47.  
    48.     // 草图导出器接口
    49.     public interface ISketchExporter : IExchanger
    50.     {
    51.         // 导出草图到文件
    52.         bool DoExport(string fileName, Shapes.Sketch sketch);
    53.  
    54.         // 导出草图到剪贴板
    55.         bool DoExport(Clipboard clipboard, Shapes.Sketch sketch);
    56.     }
    57.  
    58.     //--------------------------------------------------------------------------------------------------
    59.  
    60.     // 草图导入器接口
    61.     public interface ISketchImporter : IExchanger
    62.     {
    63.         // 从文件导入草图
    64.         bool DoImport(string fileName, out IDictionary<int, Occt.Pnt2d> points, out IDictionary<int, Shapes.SketchSegment> segments, 
    65.             out IEnumerable constraints);
    66.         
    67.         // 从剪贴板导入草图
    68.         bool DoImport(Clipboard clipboard, out IDictionary<int, Occt.Pnt2d> points, out IDictionary<int, Shapes.SketchSegment> segments, 
    69.             out IEnumerable constraints);
    70.     }
    71.  
    72.     //--------------------------------------------------------------------------------------------------
    73.  
    74.     // 绘图导出器接口
    75.     public interface IDrawingExporter : IExchanger
    76.     {
    77.         // 导出绘图
    78.         bool DoExport(string fileName, Drawing.Drawing drawing);
    79.     }
    80.  
    81.     //--------------------------------------------------------------------------------------------------
    82.  
    83.     // 交换器设置面板创建器接口
    84.     public interface IExchangerSettingsPanelCreator
    85.     {
    86.         Type ExchangerType { get; }    // 获取交换器类型
    87.         object CreatePanel<T>(IExchanger exchanger);   // 创建交换器设置面板
    88.     }
    89.  
    90.     //--------------------------------------------------------------------------------------------------
    91.  
    92. }

    这段代码定义了一系列交换器接口，包括实体导入导出器、草图导入导出器、绘图导出器以及交换器设置面板创建器。每个接口都定义了相应的方法，用于实现具体的导入导出操作。

    3.framework

    1. using System;
    2. using Macad.Occt;
    3.  
    4. namespace Macad.Core
    5. {
    6.     // Bnd_Box 类型的扩展方法
    7.     public static class BndBoxExtensions
    8.     {
    9.         // 获取边界框的中心点
    10.         public static Pnt Center(this Bnd_Box box)
    11.         {
    12.             double xMin = 0, yMin = 0, zMin = 0, xMax = 0, yMax = 0, zMax = 0;
    13.             box.Get(ref xMin, ref yMin, ref zMin, ref xMax, ref yMax, ref zMax );
    14.             return new Pnt( 
    15.                 xMin + (xMax - xMin) / 2, 
    16.                 yMin + (yMax - yMin) / 2, 
    17.                 zMin + (zMax - zMin) / 2 );
    18.         }
    19.  
    20.         //--------------------------------------------------------------------------------------------------
    21.  
    22.         // 获取边界框的尺寸
    23.         public static (double X, double Y, double Z) Extents(this Bnd_Box box)
    24.         {
    25.             double xMin = 0, yMin = 0, zMin = 0, xMax = 0, yMax = 0, zMax = 0;
    26.             box.Get(ref xMin, ref yMin, ref zMin, ref xMax, ref yMax, ref zMax );
    27.  
    28.             return (Math.Abs(xMax - xMin), Math.Abs(yMax - yMin), Math.Abs(zMax - zMin));
    29.         }
    30.  
    31.         //--------------------------------------------------------------------------------------------------
    32.  
    33.         // 获取边界框的最小和最大坐标值
    34.         public static (double minX, double minY, double minZ, double maxX, double maxY, double maxZ) MinMax(this Bnd_Box box)
    35.         {
    36.             double xMin = 0, yMin = 0, zMin = 0, xMax = 0, yMax = 0, zMax = 0;
    37.             box.Get(ref xMin, ref yMin, ref zMin, ref xMax, ref yMax, ref zMax );
    38.  
    39.             return (xMin, yMin, zMin, xMax, yMax, zMax);
    40.         }
    41.  
    42.         //--------------------------------------------------------------------------------------------------
    43.  
    44.     }
    45. }

    这段代码定义了针对 Bnd_Box 类型的扩展方法。这些方法使得可以方便地获取边界框的中心点、尺寸以及最小和最大坐标值。

    4.

    1. using System;
    2. using Macad.Occt;
    3.  
    4. namespace Macad.Core
    5. {
    6.     // gp 类型的扩展方法
    7.     public static class gpExtensions
    8.     {
    9.         #region Pnt
    10.  
    11.         // 将点坐标各维度取整
    12.         public static Pnt Rounded(this Pnt pnt)
    13.         {
    14.             return new Pnt(pnt.X.Round(), pnt.Y.Round(), pnt.Z.Round());
    15.         }
    16.         
    17.         //--------------------------------------------------------------------------------------------------
    18.  
    19.         // 交换两个点的值
    20.         public static void Swap(this ref Pnt value, ref Pnt other)
    21.         {
    22.             Pnt temp = value;
    23.             value = other;
    24.             other = temp;
    25.         }
    26.  
    27.         //--------------------------------------------------------------------------------------------------
    28.  
    29.         // 缩放点坐标
    30.         public static Pnt Scaled(this Pnt pnt, double scale)
    31.         {
    32.             return new Pnt(pnt.X * scale, pnt.Y * scale, pnt.Z * scale);
    33.         }
    34.         
    35.         //--------------------------------------------------------------------------------------------------
    36.  
    37.         #endregion
    38.         
    39.         #region Pnt2d
    40.  
    41.         // 将二维点坐标各维度取整
    42.         public static Pnt2d Rounded(this Pnt2d pnt)
    43.         {
    44.             return new (pnt.X.Round(), pnt.Y.Round());
    45.         }
    46.  
    47.         //--------------------------------------------------------------------------------------------------
    48.  
    49.         // 交换两个二维点的值
    50.         public static void Swap(this ref Pnt2d value, ref Pnt2d other)
    51.         {
    52.             Pnt2d temp = value;
    53.             value = other;
    54.             other = temp;
    55.         }
    56.  
    57.         //--------------------------------------------------------------------------------------------------
    58.  
    59.         // 两点之间进行线性插值
    60.         public static Pnt2d Lerped(this Pnt2d value, Pnt2d other, double amount)
    61.         {
    62.             return new Pnt2d(value.X.Lerp(other.X, amount), value.Y.Lerp(other.Y, amount));
    63.         }
    64.  
    65.         //--------------------------------------------------------------------------------------------------
    66.  
    67.         #endregion
    68.  
    69.         #region Vec2d
    70.  
    71.         // 两向量之间进行线性插值
    72.         public static Vec2d Lerped(this Vec2d value, Vec2d other, double amount)
    73.         {
    74.             return new Vec2d(value.X.Lerp(other.X, amount), value.Y.Lerp(other.Y, amount));
    75.         }
    76.  
    77.         //--------------------------------------------------------------------------------------------------
    78.  
    79.         #endregion
    80.  
    81.         #region Dir
    82.  
    83.         // 两个方向之间进行球形线性插值
    84.         public static Dir Slerped(this Dir value, Dir other, double amount)
    85.         {
    86.             double dotProduct = value.Dot(other);
    87.  
    88.             // 确定两个向量之间的最短旋转方向
    89.             if (dotProduct < 0)
    90.             {
    91.                 other.Reverse();
    92.                 dotProduct = -dotProduct;
    93.             }
    94.  
    95.             double angle = Math.Acos(dotProduct);
    96.  
    97.             if (Math.Abs(angle) < 0.000001f)
    98.             {
    99.                 return value;
    100.             }
    101.  
    102.             double invSinAngle = 1f / Math.Sin(angle);
    103.             double factorA = Math.Sin((1f - amount) * angle) * invSinAngle;
    104.             double factorB = Math.Sin(amount * angle) * invSinAngle;
    105.  
    106.             return new Dir(value.ToVec(factorA) + other.ToVec(factorB));
    107.         }
    108.  
    109.         //--------------------------------------------------------------------------------------------------
    110.  
    111.         #endregion
    112.  
    113.         #region Pln
    114.  
    115.         // 获取平面的旋转四元数
    116.         public static Quaternion Rotation(this Pln plane)
    117.         {
    118.             var mat = new Mat(
    119.                 plane.XAxis.Direction.Coord,
    120.                 plane.YAxis.Direction.Coord,
    121.                 plane.Axis.Direction.Coord);
    122.             return new Quaternion(mat);
    123.         }
    124.  
    125.         //--------------------------------------------------------------------------------------------------
    126.  
    127.         // 检查两个平面是否相等
    128.         public static bool IsEqual(this Pln pln1, Pln pln2)
    129.         {
    130.             return pln1.Location.IsEqual(pln2.Location, Double.Epsilon)
    131.                    && pln1.Rotation().IsEqual(pln2.Rotation());
    132.         }
    133.  
    134.         //--------------------------------------------------------------------------------------------------
    135.  
    136.         // 计算点在平面上的参数值
    137.         public static Pnt2d Parameters(this Pln pln, Pnt pnt)
    138.         {
    139.             double u = 0, v = 0;
    140.             ElSLib.Parameters(pln, pnt, ref u, ref v);
    141.             return new Pnt2d(u, v);
    142.         }
    143.  
    144.         //--------------------------------------------------------------------------------------------------
    145.         
    146.         // 计算平面上参数对应的点坐标
    147.         public static Pnt Value(this Pln pln, Pnt2d uv)
    148.         {
    149.             return ElSLib.Value(uv.X, uv.Y, pln);
    150.         }
    151.  
    152.         //--------------------------------------------------------------------------------------------------
    153.  
    154.         #endregion
    155.  
    156.         #region Quaternion
    157.  
    158.         // 将四元数转换为轴-角表示
    159.         public static Ax3 ToAx3(this Quaternion rotation, Pnt location)
    160.         {
    161.             return new Ax3(location,
    162.                 rotation.Multiply(new Vec(0, 0, 1)).ToDir(),
    163.                 rotation.Multiply(new Vec(1, 0, 0)).ToDir());
    164.         }
    165.  
    166.         //--------------------------------------------------------------------------------------------------
    167.  
    168.         // 将四元数转换为欧拉角表示
    169.         public static (double yaw, double pitch, double roll) ToEuler(this Quaternion rotation)
    170.         {
    171.             double y = 0, p = 0, r = 0;
    172.             rotation.GetEulerAngles(ref y, ref p, ref r);
    173.             return (y, p, r);
    174.         }
    175.  
    176.         //--------------------------------------------------------------------------------------------------
    177.  
    178.         #endregion
    179.  
    180.         #region Ax22d
    181.  
    182.         // 计算二维轴的方向
    183.         public static int Sense(this Ax22d ax)
    184.         {
    185.             return ax.YAxis.Angle(ax.XAxis) > 0 ? 1 : -1;
    186.         }
    187.  
    188.         //--------------------------------------------------------------------------------------------------
    189.  
    190.         #endregion
    191.     }
    192. }

    这段代码定义了针对 Pnt、Pnt2d、Vec2d、Dir、Pln、Quaternion 和 Ax22d 类型的扩展方法，提供了各种便捷的数学计算和操作功能。

    5.

    1. using System;
    2. using System.Collections.Generic;
    3. using Macad.Occt;
    4.  
    5. namespace Macad.Core
    6. {
    7.     public static class ListExtensions
    8.     {
    9.         /// 
    10.         /// 检查 IEnumerable 中是否包含与给定的 TopoDS_Shape 相同的形状对象。
    11.         /// 
    12.         public static bool ContainsSame<T>(this IEnumerable list, TopoDS_Shape shape) where T : TopoDS_Shape
    13.         {
    14.             if (shape == null)
    15.             {
    16.                 // 如果给定的形状为空，检查集合中是否存在空形状对象
    17.                 foreach (var item in list)
    18.                 {
    19.                     if (item == null)
    20.                         return true;
    21.                 }
    22.                 return false;
    23.             }
    24.             else
    25.             {
    26.                 // 否则，检查集合中是否存在与给定形状相同的形状对象
    27.                 foreach (var item in list)
    28.                 {
    29.                     if (shape.IsSame(item))
    30.                         return true;
    31.                 }
    32.                 return false;
    33.             }
    34.         }
    35.  
    36.         /// 
    37.         /// 检查 IEnumerable 中是否包含与给定的 TopoDS_Shape 相似（partner）的形状对象。
    38.         /// 
    39.         public static bool ContainsPartner<T>(this IEnumerable list, TopoDS_Shape shape) where T : TopoDS_Shape
    40.         {
    41.             if (shape == null)
    42.             {
    43.                 // 如果给定的形状为空，检查集合中是否存在空形状对象
    44.                 foreach (var item in list)
    45.                 {
    46.                     if (item == null)
    47.                         return true;
    48.                 }
    49.                 return false;
    50.             }
    51.             else
    52.             {
    53.                 // 否则，检查集合中是否存在与给定形状相似（partner）的形状对象
    54.                 foreach (var item in list)
    55.                 {
    56.                     if (shape.IsPartner(item))
    57.                         return true;
    58.                 }
    59.                 return false;
    60.             }
    61.         }
    62.  
    63.         /// 
    64.         /// 返回 IList 中与给定的 TopoDS_Shape 相同的形状对象的索引。
    65.         /// 
    66.         public static int IndexOfSame<T>(this IList list, TopoDS_Shape item) where T : TopoDS_Shape
    67.         {
    68.             int size = list.Count;
    69.             if (item == null)
    70.             {
    71.                 // 如果给定的形状为空，返回列表中第一个空形状对象的索引
    72.                 for (int i = 0; i < size; i++)
    73.                     if (list[i] == null)
    74.                         return i;
    75.                 return -1;
    76.             }
    77.             else
    78.             {
    79.                 // 否则，返回列表中与给定形状相同的形状对象的索引
    80.                 for (int i = 0; i < size; i++)
    81.                 {
    82.                     if (item.IsSame(list[i]))
    83.                         return i;
    84.                 }
    85.                 return -1;
    86.             }
    87.         }
    88.     }
    89. }

    这段代码定义了针对 IEnumerable 和 IList 接口的扩展方法，用于处理 TopoDS_Shape 类型的对象。

    • ContainsSame(this IEnumerable list, TopoDS_Shape shape)：检查 IEnumerable 中是否包含与给定的 TopoDS_Shape 相同的形状对象。

    • ContainsPartner(this IEnumerable list, TopoDS_Shape shape)：检查 IEnumerable 中是否包含与给定的 TopoDS_Shape 相似（partner）的形状对象。

    • IndexOfSame(this IList list, TopoDS_Shape item)：返回 IList 中与给定的 TopoDS_Shape 相同的形状对象的索引。

    这些方法允许在集合中查找相同或相似的形状对象，并提供了方便的方式来处理形状对象的列表。

    6.

    1. using Macad.Occt;
    2.  
    3. namespace Macad.Core
    4. {
    5.     public static class TopLocExtension
    6.     {
    7.         /// 
    8.         /// 将 TopLoc_Location 对象转换为 Ax3 对象。
    9.         /// 
    10.         public static Ax3 ToAx3(this TopLoc_Location rotation)
    11.         {
    12.             // 获取变换矩阵
    13.             var trsf = rotation.Transformation();
    14.             // 获取旋转部分并将其转换为 Ax3 对象，使用平移部分的 Pnt 作为位置点
    15.             return trsf.GetRotation().ToAx3(trsf.TranslationPart().ToPnt());
    16.         }
    17.     }
    18. }

    这个扩展方法允许将 TopLoc_Location 对象转换为 Ax3 对象，从而简化了代码中的操作。

    7.

    1. using System.Collections.Generic;
    2. using System.Diagnostics;
    3. using System.Linq;
    4. using Macad.Occt;
    5.  
    6. namespace Macad.Core
    7. {
    8.     public static class TopoDSShapeExtensions
    9.     {
    10.         /// 
    11.         /// 获取组合实体。
    12.         /// 
    13.         public static List CompSolids(this TopoDS_Shape shape, bool distinct = true)
    14.         {
    15.             // 省略内容
    16.         }
    17.  
    18.         //--------------------------------------------------------------------------------------------------
    19.  
    20.         /// 
    21.         /// 获取实体。
    22.         /// 
    23.         public static List Solids(this TopoDS_Shape shape, bool distinct = true)
    24.         {
    25.             // 省略内容
    26.         }
    27.  
    28.         //--------------------------------------------------------------------------------------------------
    29.  
    30.         /// 
    31.         /// 获取壳体。
    32.         /// 
    33.         public static List Shells(this TopoDS_Shape shape, bool distinct = true)
    34.         {
    35.             // 省略内容
    36.         }
    37.  
    38.         //--------------------------------------------------------------------------------------------------
    39.  
    40.         /// 
    41.         /// 获取面。
    42.         /// 
    43.         public static List Faces(this TopoDS_Shape shape, bool distinct = true)
    44.         {
    45.             Debug.Assert(shape != null);
    46.             
    47.             // 省略内容
    48.         }
    49.  
    50.         //--------------------------------------------------------------------------------------------------
    51.  
    52.         /// 
    53.         /// 获取线框。
    54.         /// 
    55.         public static List Wires(this TopoDS_Shape shape, bool distinct = true)
    56.         {
    57.             // 省略内容
    58.         }
    59.  
    60.         //--------------------------------------------------------------------------------------------------
    61.  
    62.         /// 
    63.         /// 获取边。
    64.         /// 
    65.         public static List Edges(this TopoDS_Shape shape, bool distinct = true)
    66.         {
    67.             // 省略内容
    68.         }
    69.  
    70.         //--------------------------------------------------------------------------------------------------
    71.  
    72.         /// 
    73.         /// 获取顶点。
    74.         /// 
    75.         public static List Vertices(this TopoDS_Shape shape, bool distinct = true)
    76.         {
    77.             // 省略内容
    78.         }
    79.         
    80.         //--------------------------------------------------------------------------------------------------
    81.  
    82.         /// 
    83.         /// 获取质心。
    84.         /// 
    85.         public static Pnt CenterOfMass(this TopoDS_Shape shape)
    86.         {
    87.             // 省略内容
    88.         }
    89.  
    90.         //--------------------------------------------------------------------------------------------------
    91.  
    92.         /// 
    93.         /// 获取面积。
    94.         /// 
    95.         public static double Area(this TopoDS_Shape shape)
    96.         {
    97.             // 省略内容
    98.         }
    99.  
    100.         //--------------------------------------------------------------------------------------------------
    101.  
    102.         /// 
    103.         /// 获取体积。
    104.         /// 
    105.         public static double Volume(this TopoDS_Shape shape)
    106.         {
    107.             // 省略内容
    108.         }
    109.  
    110.         //--------------------------------------------------------------------------------------------------
    111.  
    112.         /// 
    113.         /// 获取包围盒。
    114.         /// 
    115.         public static Bnd_Box BoundingBox(this TopoDS_Shape shape)
    116.         {
    117.             // 省略内容
    118.         }
    119.         
    120.         //--------------------------------------------------------------------------------------------------
    121.  
    122.         // 省略其他扩展方法
    123.     }
    124. }

    这些扩展方法用于检索给定形状（TopoDS_Shape）中包含的不同类型的子形状，例如组合实体、实体、壳体、面、线框、边和顶点。此外，还提供了一些计算几何特性的方法，如质心、面积、体积和包围盒。

    8.

    1. using System;
    2. using System.Collections.Generic;
    3. using System.Collections.ObjectModel;
    4. using System.ComponentModel;
    5. using System.Linq;
    6. using System.Runtime.CompilerServices;
    7. using Macad.Core.Topology;
    8. using Macad.Occt;
    9. using Macad.Occt.Helper;
    10.  
    11. namespace Macad.Core
    12. {
    13.     public sealed class MessageHandler : IDisposable
    14.     {
    15.         #region Properties
    16.  
    17.         /// 
    18.         /// 获取或设置消息项集合。
    19.         /// 
    20.         public ObservableCollection MessageItems
    21.         {
    22.             get { return _MessageItems; }
    23.             set
    24.             {
    25.                 if (_MessageItems != value)
    26.                 {
    27.                     _MessageItems = value;
    28.                     RaiseStaticPropertyChanged();
    29.                 }
    30.             }
    31.         }
    32.  
    33.         //--------------------------------------------------------------------------------------------------
    34.  
    35.         /// 
    36.         /// 获取当前引用实体。
    37.         /// 
    38.         public Entity CurrentReferenceEntity
    39.         {
    40.             get { return _ProcessingEntitiesStack.Count > 0 ? _ProcessingEntitiesStack.Peek() : null; }
    41.         }
    42.  
    43.         //--------------------------------------------------------------------------------------------------
    44.         
    45.         #endregion
    46.  
    47.         #region Member
    48.  
    49.         ObservableCollection _MessageItems;
    50.         ConditionalWeakTable> _EntityMessages;
    51.  
    52.         readonly Stack _ProcessingEntitiesStack = new Stack();
    53.  
    54.         MessageRouter _MessageRouter;
    55.  
    56.         [ThreadStatic]
    57.         static readonly bool _IsMainThread = true;
    58.  
    59.         //--------------------------------------------------------------------------------------------------
    60.  
    61.         #endregion        
    62.             
    63.         #region Initialization and Property handling
    64.  
    65.         /// 
    66.         /// 构造函数。
    67.         /// 
    68.         public MessageHandler()
    69.         {
    70.             _MessageItems = new ObservableCollection();
    71.             _EntityMessages = new ConditionalWeakTable>();
    72.             
    73.             _MessageRouter = new MessageRouter();
    74.             _MessageRouter.MessageArrived += _MessageRouter_MessageArrived;
    75.             _MessageRouter.TraceLevel = Message_Gravity.Warning;
    76.         }
    77.  
    78.         //--------------------------------------------------------------------------------------------------
    79.  
    80.         /// 
    81.         /// 析构函数。
    82.         /// 
    83.         ~MessageHandler()
    84.         {
    85.             Dispose(false);
    86.         }
    87.  
    88.         //--------------------------------------------------------------------------------------------------
    89.  
    90.         /// 
    91.         /// 释放资源。
    92.         /// 
    93.         public void Dispose()
    94.         {
    95.             Dispose(true);
    96.             GC.SuppressFinalize(this);
    97.         }
    98.  
    99.         //--------------------------------------------------------------------------------------------------
    100.  
    101.         void Dispose(bool disposing)
    102.         {
    103.             _MessageRouter?.Dispose();
    104.             _MessageRouter = null;
    105.         }
    106.  
    107.         //--------------------------------------------------------------------------------------------------
    108.  
    109.         void _MessageRouter_MessageArrived(string text, Message_Gravity gravity)
    110.         {
    111.             if (!_IsMainThread)
    112.             {
    113.                 // 只接受主线程之外的其他线程发送的消息
    114.                 return;
    115.             }
    116.  
    117.             MessageSeverity severity;
    118.             switch (gravity)
    119.             {
    120.                 case Message_Gravity.Trace:
    121.                     severity = MessageSeverity.Trace;
    122.                     break;
    123.                 case Message_Gravity.Info:
    124.                     severity = MessageSeverity.Info;
    125.                     break;
    126.                 case Message_Gravity.Warning:
    127.                 case Message_Gravity.Alarm:
    128.                     severity = MessageSeverity.Warning;
    129.                     break;
    130.                 case Message_Gravity.Fail:
    131.                     severity = MessageSeverity.Error;
    132.                     break;
    133.                 default:
    134.                     throw new ArgumentOutOfRangeException(nameof(gravity), gravity, null);
    135.             }
    136.  
    137.             AddMessage(new MessageItem(severity, text));
    138.         }
    139.  
    140.         //--------------------------------------------------------------------------------------------------
    141.  
    142.         public event EventHandler StaticPropertyChanged;
    143.  
    144.         public void RaiseStaticPropertyChanged([CallerMemberName] String propertyName = "")
    145.         {
    146.             StaticPropertyChanged?.Invoke(null, new PropertyChangedEventArgs(propertyName));
    147.         }
    148.  
    149.         //--------------------------------------------------------------------------------------------------
    150.  
    151.         #endregion
    152.  
    153.         #region Messages
    154.  
    155.         public event EventHandler MessageThrown;
    156.  
    157.         //--------------------------------------------------------------------------------------------------
    158.  
    159.         /// 
    160.         /// 添加消息项。
    161.         /// 
    162.         public void AddMessage(MessageItem message)
    163.         {
    164.             if (message.Sender != null && message.Sender.TryGetTarget(out var entity))
    165.             {
    166.                 var list = _EntityMessages.GetValue(entity, key => new List());
    167.                 list.Add(message);
    168.             }
    169.  
    170.             _MessageItems.Add(message);
    171.             MessageThrown?.Invoke(message.Sender, message);
    172.         }
    173.  
    174.         //--------------------------------------------------------------------------------------------------
    175.  
    176.         /// 
    177.         /// 清除指定实体的所有消息。
    178.         /// 
    179.         public void ClearEntityMessages(Entity entity)
    180.         {
    181.             if (!_EntityMessages.TryGetValue(entity, out var messages))
    182.             {
    183.                 return;
    184.             }
    185.  
    186.             messages.ForEach(item => _MessageItems.Remove(item));
    187.             _EntityMessages.Remove(entity);
    188.         }
    189.  
    190.         //--------------------------------------------------------------------------------------------------
    191.  
    192.         /// 
    193.         /// 清除所有实体的消息。
    194.         /// 
    195.         public void ClearAllEntityMessages()
    196.         {
    197.             foreach (var item in _MessageItems.ToArray())
    198.             {
    199.                 if(item.Sender == null)
    200.                     continue;
    201.  
    202.                 _MessageItems.Remove(item);
    203.             }
    204.         }
    205.  
    206.         //--------------------------------------------------------------------------------------------------
    207.  
    208.         /// 
    209.         /// 获取指定实体的消息。
    210.         /// 
    211.         public List GetEntityMessages(Entity entity)
    212.         {
    213.             return _EntityMessages.TryGetValue(entity, out var list) ? list : null;
    214.         }
    215.  
    216.         //--------------------------------------------------------------------------------------------------
    217.         
    218.         #endregion
    219.  
    220.         #region Processing
    221.  
    222.         /// 
    223.         /// 处理消息事件的原因。
    224.         /// 
    225.         public enum ProgressMessageEventReason
    226.         {
    227.             ProcessingStarted,
    228.             ProcessingStopped
    229.         }
    230.  
    231.         //--------------------------------------------------------------------------------------------------
    232.  
    233.         /// 
    234.         /// 处理消息事件参数。
    235.         /// 
    236.         public class ProgressMessageEventArgs : EventArgs
    237.         {
    238.             public ProgressMessageEventReason Reason;
    239.             public string Description;
    240.  
    241.             public ProgressMessageEventArgs(ProgressMessageEventReason reason, string description)
    242.             {
    243.                 Reason = reason;
    244.                 Description = description;
    245.             }
    246.         }
    247.  
    248.         //--------------------------------------------------------------------------------------------------
    249.  
    250.         /// 
    251.         /// 进度消息事件。
    252.         /// 
    253.         public event EventHandler ProgressMessage;
    254.  
    255.         //--------------------------------------------------------------------------------------------------
    256.  
    257.         /// 
    258.         /// 当处理开始时调用。
    259.         /// 
    260.         public void OnProcessingStarted(Entity referenceEntity, string description)
    261.         {
    262.             _ProcessingEntitiesStack.Push(referenceEntity);
    263.  
    264.             if (_ProcessingEntitiesStack.Count == 1)
    265.             {
    266.                 ProgressMessage?.Invoke(this, new ProgressMessageEventArgs(ProgressMessageEventReason.ProcessingStarted, description));
    267.             }
    268.         }
    269.  
    270.         //--------------------------------------------------------------------------------------------------
    271.  
    272.         /// 
    273.         /// 当处理结束时调用。
    274.         /// 
    275.         public void OnProcessingStopped()
    276.         {
    277.             if (_ProcessingEntitiesStack.Count > 0)
    278.             {
    279.                 _ProcessingEntitiesStack.Pop();
    280.             }
    281.  
    282.             if (_ProcessingEntitiesStack.Count == 0)
    283.             {
    284.                 ProgressMessage?.Invoke(this, new ProgressMessageEventArgs(ProgressMessageEventReason.ProcessingStopped, null));
    285.             }
    286.         }
    287.  
    288.         //--------------------------------------------------------------------------------------------------
    289.  
    290.         #endregion
    291.     }
    292. }

    这是一个用于处理消息的类。它包含了一些属性和方法来管理消息集合、处理消息的事件等。其中包括了消息的添加、清除、获取等操作，以及处理过程的开始和结束。

    9.

    1. using System;
    2. using System.Text;
    3. using Macad.Core.Topology;
    4.  
    5. namespace Macad.Core
    6. {
    7.     /// 
    8.     /// 消息严重性级别枚举。
    9.     /// 
    10.     public enum MessageSeverity
    11.     {
    12.         Trace = 0,
    13.         Info = 1,
    14.         Warning = 2,
    15.         Error = 3
    16.     }
    17.  
    18.     //--------------------------------------------------------------------------------------------------
    19.     //--------------------------------------------------------------------------------------------------
    20.  
    21.     /// 
    22.     /// 消息项类。
    23.     /// 
    24.     public class MessageItem
    25.     {
    26.         /// 
    27.         /// 获取时间戳。
    28.         /// 
    29.         public DateTime TimeStamp { get; }
    30.  
    31.         /// 
    32.         /// 获取消息文本。
    33.         /// 
    34.         public string Text { get; }
    35.  
    36.         /// 
    37.         /// 获取消息严重性级别。
    38.         /// 
    39.         public MessageSeverity Severity { get; }
    40.  
    41.         /// 
    42.         /// 获取消息解释。
    43.         /// 
    44.         public string[] Explanation { get; }
    45.  
    46.         /// 
    47.         /// 获取消息发送者的弱引用。
    48.         /// 
    49.         public WeakReference Sender { get; }
    50.  
    51.         //--------------------------------------------------------------------------------------------------
    52.  
    53.         static readonly char[] _LineBreaks = { '\n', '\r' };
    54.  
    55.         //--------------------------------------------------------------------------------------------------
    56.  
    57.         /// 
    58.         /// 构造函数。
    59.         /// 
    60.         public MessageItem(MessageSeverity severity, string text, string explanation=null, Entity sender=null)
    61.         {
    62.             TimeStamp = DateTime.Now;
    63.             Severity = severity;
    64.             Text = text;
    65.             Sender = sender != null ? new WeakReference(sender) : null;
    66.             Explanation = explanation?.Split(_LineBreaks, StringSplitOptions.RemoveEmptyEntries);
    67.         }
    68.  
    69.         //--------------------------------------------------------------------------------------------------
    70.  
    71.         /// 
    72.         /// 返回消息的字符串表示形式。
    73.         /// 
    74.         public override string ToString()
    75.         {
    76.             var sb = new StringBuilder();
    77.             switch (Severity)
    78.             {
    79.                 case MessageSeverity.Trace:
    80.                     sb.Append("Trace: ");
    81.                     break;
    82.                 case MessageSeverity.Info:
    83.                     sb.Append("Info: ");
    84.                     break;
    85.                 case MessageSeverity.Warning:
    86.                     sb.Append("Warning: ");
    87.                     break;
    88.                 case MessageSeverity.Error:
    89.                     sb.Append("Error: ");
    90.                     break;
    91.             }
    92.  
    93.             if (Sender != null && Sender.TryGetTarget(out var senderEntity))
    94.             {
    95.                 sb.Append('[');
    96.                 sb.Append(senderEntity.Name);
    97.                 sb.Append("] ");
    98.             }
    99.  
    100.             sb.AppendLine(Text);
    101.             if (Explanation != null)
    102.             {
    103.                 foreach (var s in Explanation)
    104.                 {
    105.                     sb.AppendLine(s);
    106.                 }
    107.             }
    108.  
    109.             return sb.ToString();
    110.         }
    111.  
    112.         //--------------------------------------------------------------------------------------------------
    113.  
    114.         /// 
    115.         /// 返回消息的简略字符串表示形式。
    116.         /// 
    117.         public string ToShortString()
    118.         {
    119.             string result;
    120.             switch (Severity)
    121.             {
    122.                 case MessageSeverity.Trace:
    123.                     result = "Trace: ";
    124.                     break;
    125.                 case MessageSeverity.Info:
    126.                     result = "Info: ";
    127.                     break;
    128.                 case MessageSeverity.Warning:
    129.                     result = "Warning: ";
    130.                     break;
    131.                 case MessageSeverity.Error:
    132.                     result = "Error: ";
    133.                     break;
    134.                 default:
    135.                     result = "";
    136.                     break;
    137.             }
    138.  
    139.             return result + Text;
    140.         }
    141.  
    142.         //--------------------------------------------------------------------------------------------------
    143.  
    144.     }
    145.  
    146. }

    这段代码定义了消息项类 MessageItem 和消息严重性级别枚举 MessageSeverity。消息项类包含了消息的时间戳、文本、严重性级别、解释和发送者的信息。

    10.

    1. using System;
    2. using System.Runtime.InteropServices;
    3. using Macad.Core.Topology;
    4. using Macad.Occt;
    5.  
    6. namespace Macad.Core
    7. {
    8.     /// 
    9.     /// 消息类，提供发送各种消息的静态方法。
    10.     /// 
    11.     public static class Messages
    12.     {
    13.         /// 
    14.         /// 发送跟踪消息。
    15.         /// 
    16.         public static void Trace(string line, string explanation = null, Entity sender = null)
    17.         {
    18.             var handler = CoreContext.Current?.MessageHandler;
    19.             handler?.AddMessage(new MessageItem(MessageSeverity.Trace, line, explanation, sender ?? handler.CurrentReferenceEntity));
    20.         }
    21.  
    22.         //--------------------------------------------------------------------------------------------------
    23.  
    24.         /// 
    25.         /// 发送信息消息。
    26.         /// 
    27.         public static void Info(string line, string explanation = null, Entity sender = null)
    28.         {
    29.             var handler = CoreContext.Current?.MessageHandler;
    30.             handler?.AddMessage(new MessageItem(MessageSeverity.Info, line, explanation, sender ?? handler.CurrentReferenceEntity));
    31.         }
    32.  
    33.         //--------------------------------------------------------------------------------------------------
    34.  
    35.         /// 
    36.         /// 发送警告消息。
    37.         /// 
    38.         public static void Warning(string line, string explanation = null, Entity sender = null)
    39.         {
    40.             var handler = CoreContext.Current?.MessageHandler;
    41.             handler?.AddMessage(new MessageItem(MessageSeverity.Warning, line, explanation, sender ?? handler.CurrentReferenceEntity));
    42.         }
    43.  
    44.         //--------------------------------------------------------------------------------------------------
    45.  
    46.         /// 
    47.         /// 发送错误消息。
    48.         /// 
    49.         public static void Error(string line, string explanation = null, Entity sender = null)
    50.         {
    51.             var handler = CoreContext.Current?.MessageHandler;
    52.             handler?.AddMessage(new MessageItem(MessageSeverity.Error, line, explanation, sender ?? handler.CurrentReferenceEntity));
    53.         }
    54.  
    55.         //--------------------------------------------------------------------------------------------------
    56.  
    57.         /// 
    58.         /// 发送异常消息。
    59.         /// 
    60.         public static void Exception(string line, Exception exception, Entity sender = null)
    61.         {
    62.             string msg;
    63.             if (exception is SEHException)
    64.             {
    65.                 // 尝试从本地获取信息
    66.                 var info = Interop.ExceptionHelper.GetNativeExceptionInfo(Marshal.GetExceptionPointers());
    67.                 if (info != null)
    68.                 {
    69.                     msg = $"{info.Message} [{info.Source}]";
    70.                 }
    71.                 else
    72.                 {
    73.                     msg = "未知本地异常。";
    74.                 }
    75.             }
    76.             else
    77.             {
    78.                 msg = $"{exception.Message} [ {exception.GetType().FullName} ]";
    79.             }
    80.  
    81.             string expl = "异常: " + msg + "\n" + exception.StackTrace;
    82.             var handler = CoreContext.Current?.MessageHandler;
    83.             handler?.AddMessage(new MessageItem(MessageSeverity.Error, line, expl, sender ?? handler.CurrentReferenceEntity));
    84.         }
    85.  
    86.         //--------------------------------------------------------------------------------------------------
    87.  
    88.         /// 
    89.         /// 发送报告消息。
    90.         /// 
    91.         public static void Report(Message_Report report)
    92.         {
    93.             report.SendMessages(Message.DefaultMessenger());
    94.         }
    95.  
    96.         //--------------------------------------------------------------------------------------------------
    97.  
    98.     }
    99. }

    这段代码定义了一个静态类 Messages，其中包含了用于发送各种消息的静态方法，如跟踪消息、信息消息、警告消息、错误消息、异常消息和报告消息。

    11.

    1. using System;
    2. using Macad.Core.Topology;
    3.  
    4. namespace Macad.Core
    5. {
    6.     /// 
    7.     /// 表示一个处理范围，用于在其范围内开始和结束处理。
    8.     /// 
    9.     public sealed class ProcessingScope : IDisposable
    10.     {
    11.         /// 
    12.         /// 初始化处理范围并开始处理。
    13.         /// 
    14.         /// 参考实体。
    15.         /// 描述处理的信息。
    16.         public ProcessingScope(Entity referenceEntity, string description)
    17.         {
    18.             CoreContext.Current?.MessageHandler?.OnProcessingStarted(referenceEntity, description);
    19.         }
    20.         
    21.         /// 
    22.         /// 处理范围的析构函数，结束处理。
    23.         /// 
    24.         ~ProcessingScope()
    25.         {
    26.             Dispose();
    27.         }
    28.  
    29.         /// 
    30.         public void Dispose()
    31.         {
    32.             CoreContext.Current?.MessageHandler?.OnProcessingStopped();
    33.             GC.SuppressFinalize(this);
    34.         }
    35.     }
    36. }

    这段代码定义了一个 ProcessingScope 类，它表示一个处理范围，用于在其范围内开始和结束处理。

    12.

    1. using System;
    2. using System.Collections.Generic;
    3. using System.Linq;
    4. using Macad.Core.Geom;
    5. using Macad.Core.Shapes;
    6. using Macad.Common;
    7. using Macad.Occt;
    8.  
    9. namespace Macad.Core
    10. {
    11.     #region 类 BRepTopologyTreeNodes
    12.  
    13.     /// 
    14.     /// 表示 BRepTopologyTreeNode 实例的集合。
    15.     /// 
    16.     public class BRepTopologyTreeNodes : List<BRepTopologyTreeNode>
    17.     {
    18.         /// 
    19.         /// 使用指定的容量初始化 BRepTopologyTreeNodes 类的新实例。
    20.         /// 
    21.         /// 列表可以包含的初始元素数。
    22.         public BRepTopologyTreeNodes(int capacity) 
    23.             : base(capacity)
    24.         {
    25.         }
    26.  
    27.         /// 
    28.         /// 初始化 BRepTopologyTreeNodes 类的新实例。
    29.         /// 
    30.         public BRepTopologyTreeNodes()
    31.         {
    32.         }
    33.  
    34.         /// 
    35.         /// 初始化 BRepTopologyTreeNodes 类的新实例，并将元素添加到指定的集合。
    36.         /// 
    37.         /// 要复制到新列表中的集合的元素。
    38.         public BRepTopologyTreeNodes(IEnumerable collection)
    39.             : base(collection)
    40.         {
    41.         }
    42.     }
    43.  
    44.     #endregion
    45.  
    46.     #region 类 BRepTopologyTreeProperty
    47.  
    48.     /// 
    49.     /// 表示 B-Rep 拓扑树节点的属性。
    50.     /// 
    51.     public class BRepTopologyTreeProperty
    52.     {
    53.         /// 
    54.         /// 获取属性的类别。
    55.         /// 
    56.         public string Category { get; }
    57.  
    58.         /// 
    59.         /// 获取属性的名称。
    60.         /// 
    61.         public string Name { get; }
    62.  
    63.         /// 
    64.         /// 获取属性的值。
    65.         /// 
    66.         public string Value { get; }
    67.  
    68.         /// 
    69.         /// 使用指定的类别、名称和值初始化 BRepTopologyTreeProperty 类的新实例。
    70.         /// 
    71.         /// 属性的类别。
    72.         /// 属性的名称。
    73.         /// 属性的值。
    74.         public BRepTopologyTreeProperty(string category, string name, string value)
    75.         {
    76.             Category = category;
    77.             Name = name;
    78.             Value = value;
    79.         }
    80.     }
    81.  
    82.     #endregion
    83.  
    84.     #region 类 BRepTopologyTreeNode
    85.  
    86.     /// 
    87.     /// 表示 B-Rep 拓扑树中的节点。
    88.     /// 
    89.     public class BRepTopologyTreeNode
    90.     {
    91.         #region 属性
    92.  
    93.         /// 
    94.         /// 获取节点的名称。
    95.         /// 
    96.         public string Name { get; private set; }
    97.  
    98.         /// 
    99.         /// 获取节点的子节点。
    100.         /// 
    101.         public BRepTopologyTreeNodes Children
    102.         {
    103.             get
    104.             {
    105.                 // 如果子节点尚未初始化，则初始化它们
    106.                 if (_Children is null)
    107.                     _InitChildren();
    108.                 return _Children;
    109.             }
    110.         }
    111.  
    112.         /// 
    113.         /// 获取与节点关联的 B-Rep 形状。
    114.         /// 
    115.         public TopoDS_Shape BrepShape { get; }
    116.  
    117.         /// 
    118.         /// 获取与节点关联的属性。
    119.         /// 
    120.         public List Properties
    121.         {
    122.             get
    123.             {
    124.                 // 如果属性尚未初始化，则初始化它们
    125.                 if (_Properties is null)
    126.                     _InitProperties();
    127.                 return _Properties;
    128.             }
    129.         }
    130.  
    131.         /// 
    132.         /// 获取与节点关联的形状。
    133.         /// 
    134.         public Shape Shape { get; }
    135.  
    136.         #endregion
    137.  
    138.         #region 构造函数和设置器
    139.  
    140.         /// 
    141.         /// 使用指定的形状初始化 BRepTopologyTreeNode 类的新实例。
    142.         /// 
    143.         /// 与节点关联的形状。
    144.         public BRepTopologyTreeNode(Shape shape)
    145.         {
    146.             Shape = shape;
    147.             BrepShape = shape?.GetBRep();
    148.             _TopLevelShape = BrepShape;
    149.  
    150.             Name = "无效形状";
    151.             if (BrepShape != null)
    152.             {
    153.                 Name = _GetShapeTypeName(BrepShape.ShapeType());
    154.             }
    155.         }
    156.  
    157.         /// 
    158.         /// 使用指定的 B-Rep 形状初始化 BRepTopologyTreeNode 类的新实例。
    159.         /// 
    160.         /// 与节点关联的 B-Rep 形状。
    161.         /// 与节点关联的顶级形状。
    162.         /// 与节点关联的形状。
    163.         public BRepTopologyTreeNode(TopoDS_Shape brepShape, TopoDS_Shape topLevelShape = null, Shape shape = null)
    164.         {
    165.             Shape = shape;
    166.             BrepShape = brepShape;
    167.             _TopLevelShape = topLevelShape ?? brepShape;
    168.  
    169.             Name = "无效形状";
    170.             if (brepShape != null)
    171.             {
    172.                 Name = _GetShapeTypeName(brepShape.ShapeType());
    173.             }
    174.         }
    175.  
    176.         /// 
    177.         /// 使用指定的名称、包含的节点和顶级形状初始化 BRepTopologyTreeNode 类的新实例。
    178.         /// 
    179.         /// 节点的名称。
    180.         /// 此节点中包含的子节点。
    181.         /// 与节点关联的顶级形状。
    182.         /// 与节点关联的形状。
    183.         public BRepTopologyTreeNode(string name, BRepTopologyTreeNodes containedNodes, TopoDS_Shape topLevelShape, Shape shape = null)
    184.         {
    185.             Shape = shape;
    186.             Name = $"{name} ({containedNodes.Count})";
    187.             _Children = containedNodes;
    188.             _TopLevelShape = topLevelShape;
    189.             _Properties = new List();
    190.         }
    191.  
    192.         /// 
    193.         /// 向节点名称添加索引前缀。
    194.         /// 
    195.         /// 要添加为前缀的索引。
    196.         public void AddIndexPrefix(int i)
    197.         {
    198.             Name = $"[{i}] {Name}";
    199.         }
    200.  
    201.         #endregion
    202.  
    203.         #region 成员
    204.  
    205.         BRepTopologyTreeNodes _Children;
    206.         List _Properties;
    207.         readonly TopoDS_Shape _TopLevelShape;
    208.  
    209.         #endregion
    210.  
    211.         #region 子节点
    212.  
    213.         /// 
    214.         /// 初始化子节点。
    215.         /// 
    216.         void _InitChildren()
    217.         {
    218.             if (_Children != null)
    219.                 return;
    220.  
    221.             if (BrepShape == null)
    222.                 return;
    223.  
    224.             _Children = new BRepTopologyTreeNodes();
    225.  
    226.             switch (BrepShape.ShapeType())
    227.             {
    228.                 case TopAbs_ShapeEnum.COMPOUND:
    229.                     _AddShapeCollection(BrepShape.Solids(), true);
    230.                     _AddShapeCollection(BrepShape.Shells(), true);
    231.                     _AddShapeCollection(BrepShape.Faces(), true);
    232.                     _AddShapeCollection(BrepShape.Wires(), true);
    233.                     _AddShapeCollection(BrepShape.Edges(), true);
    234.                     _AddShapeCollection(BrepShape.Vertices(), true);
    235.                     break;
    236.  
    237.                 case TopAbs_ShapeEnum.COMPSOLID:
    238.                     _AddShapeCollection(BrepShape.Solids());
    239.                     break;
    240.  
    241.                 case TopAbs_ShapeEnum.SOLID:
    242.                     _AddShapeCollection(BrepShape.Shells(), true);
    243.                     _AddShapeCollection(BrepShape.Faces(), true);
    244.                     _AddShapeCollection(BrepShape.Wires(), true);
    245.                     _AddShapeCollection(BrepShape.Edges(), true);
    246.                     _AddShapeCollection(BrepShape.Vertices(), true);
    247.                     break;
    248.  
    249.                 case TopAbs_ShapeEnum.SHELL:
    250.                     _AddShapeCollection(BrepShape.Faces(), true);
    251.                     _AddShapeCollection(BrepShape.Wires(), true);
    252.                     _AddShapeCollection(BrepShape.Edges(), true);
    253.                     _AddShapeCollection(BrepShape.Vertices(), true);
    254.                     break;
    255.  
    256.                 case TopAbs_ShapeEnum.FACE:
    257.                     _AddShapeCollection(BrepShape.Wires());
    258.                     break;
    259.  
    260.                 case TopAbs_ShapeEnum.WIRE:
    261.                     _AddShapeCollection(BrepShape.Edges());
    262.                     break;
    263.  
    264.                 case TopAbs_ShapeEnum.EDGE:
    265.                     _AddShapeCollection(BrepShape.Vertices());
    266.                     break;
    267.             }
    268.         }
    269.  
    270.         #endregion
    271.  
    272.         #region 属性列表
    273.  
    274.         /// 
    275.         /// 初始化属性列表。
    276.         /// 
    277.         void _InitProperties()
    278.         {
    279.             if (_Properties != null)
    280.                 return;
    281.  
    282.             _Properties = new List();
    283.             try
    284.             {
    285.                 _AddDefaultProperties();
    286.  
    287.                 switch (BrepShape.ShapeType())
    288.                 {
    289.                     case TopAbs_ShapeEnum.SHELL:
    290.                         _AddShellProperties(BrepShape as TopoDS_Shell ?? TopoDS.Shell(BrepShape));
    291.                         break;
    292.  
    293.                     case TopAbs_ShapeEnum.FACE:
    294.                         _AddFaceProperties(BrepShape as TopoDS_Face ?? TopoDS.Face(BrepShape));
    295.                         break;
    296.  
    297.                     case TopAbs_ShapeEnum.WIRE:
    298.                         _AddWireProperties(BrepShape as TopoDS_Wire ?? TopoDS.Wire(BrepShape));
    299.                         break;
    300.  
    301.                     case TopAbs_ShapeEnum.EDGE:
    302.                         _AddEdgeProperties(BrepShape as TopoDS_Edge ?? TopoDS.Edge(BrepShape));
    303.                         break;
    304.  
    305.                     case TopAbs_ShapeEnum.VERTEX:
    306.                         _AddVertexProperties(BrepShape as TopoDS_Vertex ?? TopoDS.Vertex(BrepShape));
    307.                         break;
    308.                 }
    309.             }
    310.             catch (Exception e)
    311.             {
    312.                 Messages.Exception($"获取 B-Rep 形状 {Name} 的属性时出错", e);
    313.             }
    314.         }
    315.  
    316.         #endregion
    317.  
    318.         #region 集合
    319.  
    320.         /// 
    321.         /// 将形状集合添加到子节点。
    322.         /// 
    323.         /// 形状的类型。
    324.         /// 要添加到子节点的形状集合。
    325.         /// 指示是否对集合进行分组。
    326.         void _AddShapeCollection(IReadOnlyList shapeList, bool group = false) where T: TopoDS_Shape
    327.         {
    328.             if (!shapeList.Any())
    329.                 return;
    330.  
    331.             var collection = group ? new BRepTopologyTreeNodes() : _Children;
    332.             for (var i = 0; i < shapeList.Count; i++)
    333.             {
    334.                 var treeNode = new BRepTopologyTreeNode(shapeList[i], _TopLevelShape, Shape);
    335.                 treeNode.AddIndexPrefix(i);
    336.                 collection.Add(treeNode);
    337.             }
    338.  
    339.             if (group)
    340.             {
    341.                 var name = typeof(T).Name.TrimPrefixes("TopoDS_") + "s";
    342.                 if (name == "Vertexs")
    343.                     name = "Vertices";
    344.  
    345.                 _Children.Add(new BRepTopologyTreeNode(name, collection, _TopLevelShape, Shape));
    346.             }
    347.         }
    348.  
    349.         #endregion
    350.     }
    351.  
    352.     #endregion
    353. }

    这段代码定义了一个名为BRepTopologyTreeNode的类，用于表示 B-Rep（Boundary Representation）拓扑树中的节点。B-Rep是一种用于描述实体几何形状的方法，它通过表示实体的边界以及边界之间的关系来描述几何形状。

    该类的主要作用包括：

    1. 表示B-Rep拓扑树中的节点，每个节点代表一个几何形状元素（如面、边、点等）或由多个子节点组成的组合形状。
    2. 可以获取节点的名称、子节点、B-Rep形状、属性等信息。
    3. 提供了初始化子节点和属性列表的方法，以便在需要时进行延迟加载。
    4. 可以添加索引前缀以标识节点在其父节点中的位置。
    5. 可以根据B-Rep形状的类型添加相应类型的子节点集合，并可选择对子节点进行分组。
    6. 提供了获取B-Rep形状的类型名称、初始化属性列表、初始化子节点、添加子节点等功能的私有辅助方法。

    总之，该类用于构建和管理B-Rep拓扑树的节点，使用户能够方便地表示和操作复杂的几何形状结构。

    13.

    1. using Macad.Common;
    2. using Macad.Occt;
    3.  
    4. namespace Macad.Core
    5. {
    6.     public static class OcctColorUtils
    7.     {
    8.         public static Color Color(Quantity_Color color)
    9.         {
    10.             var red = (float)color.Red();
    11.             var green = (float)color.Green();
    12.             var blue = (float)color.Blue();
    13.             return new Color(red, green, blue);
    14.         }
    15.  
    16.         //--------------------------------------------------------------------------------------------------
    17.  
    18.         public static Color Color(Quantity_NameOfColor colorName)
    19.         {
    20.             return Color(new Quantity_Color(colorName));
    21.         }
    22.  
    23.         //--------------------------------------------------------------------------------------------------
    24.  
    25.         public static Quantity_Color ToColor(this Quantity_NameOfColor colorName)
    26.         {
    27.             return new Quantity_Color(colorName);
    28.         }
    29.  
    30.         //--------------------------------------------------------------------------------------------------
    31.  
    32.         public static Graphic3d_MaterialAspect ToAspect(this Graphic3d_NameOfMaterial materialName)
    33.         {
    34.             return new Graphic3d_MaterialAspect(materialName);
    35.         }
    36.  
    37.         //--------------------------------------------------------------------------------------------------
    38.  
    39.         public static Quantity_Color ToQuantityColor(this Color color)
    40.         {
    41.             return new Quantity_Color(color.Red, color.Green, color.Blue, Quantity_TypeOfColor.sRGB);
    42.         }
    43.  
    44.         //--------------------------------------------------------------------------------------------------
    45.     }
    46. }

    整段代码的作用是提供了一些用于颜色和材质转换的工具方法。这些方法包括：

    1. 将Quantity_Color类型的颜色转换为Color类型的颜色。
    2. 将Quantity_NameOfColor类型的颜色名称转换为Color类型的颜色。
    3. 将Quantity_NameOfColor类型的颜色名称转换为Quantity_Color类型的颜色。
    4. 将Graphic3d_NameOfMaterial类型的材质名称转换为Graphic3d_MaterialAspect类型的材质属性。
    5. 将Color类型的颜色转换为Quantity_Color类型的颜色。

    14.

    1. using System.Diagnostics; // 导入System.Diagnostics命名空间，提供Debug类的定义
    2. using Macad.Common.Serialization; // 导入Macad.Common.Serialization命名空间，提供序列化相关的类和接口
    3. using Macad.Occt; // 导入Macad.Occt命名空间，提供OpenCASCADE的类型定义
    4.  
    5. namespace Macad.Core
    6. {
    7.     public class OcctSerializers // 定义名为OcctSerializers的类，用于提供OpenCASCADE类型的序列化器
    8.     {
    9.         class OcctSerializer_Pnt2d : ISerializer // 定义内部类OcctSerializer_Pnt2d，实现ISerializer接口，用于Pnt2d类型的序列化
    10.         {
    11.             public bool Write(Writer writer, object obj, SerializationContext context)
    12.             {
    13.                 var pnt2d = (Pnt2d)obj; // 将传入的对象转换为Pnt2d类型
    14.                 double[] values = { pnt2d.X, pnt2d.Y }; // 提取Pnt2d对象的坐标值
    15.                 return _DoubleArraySerializer.Write(writer, values, context); // 调用_DoubleArraySerializer对坐标值进行序列化
    16.             }
    17.  
    18.             public object Read(Reader reader, object obj, SerializationContext context)
    19.             {
    20.                 var values = (double[])_DoubleArraySerializer.Read(reader, null, context); // 从Reader中读取序列化的坐标值
    21.                 if ((values != null) && (values.Length == 2)) // 验证读取的坐标值是否正确
    22.                 {
    23.                     return new Pnt2d(values[0], values[1]); // 创建新的Pnt2d对象并返回
    24.                 }
    25.                 return null; // 如果读取的坐标值不正确，则返回null
    26.             }
    27.         }
    28.  
    29.         //--------------------------------------------------------------------------------------------------
    30.  
    31.         // 类似地定义其他OpenCASCADE类型的序列化器，包括Pnt、Vec、Dir、Quaternion、Ax1、Ax2和Pln
    32.         // 每个序列化器都包括Write和Read方法，用于将对象序列化为数组或从数组中反序列化为对象
    33.  
    34.         //--------------------------------------------------------------------------------------------------
    35.  
    36.         static bool _IsInitialized; // 静态变量，标识是否已初始化
    37.         static ISerializer _DoubleArraySerializer; // 静态变量，用于序列化double数组
    38.  
    39.         public static void Init() // 初始化方法，用于注册OpenCASCADE类型的序列化器
    40.         {
    41.             Debug.Assert(!_IsInitialized); // 确保尚未初始化
    42.  
    43.             _DoubleArraySerializer = Serializer.GetSerializer(typeof(double[])); // 获取序列化double数组的序列化器
    44.  
    45.             // 注册各个OpenCASCADE类型的序列化器
    46.             Serializer.AddSerializer(typeof(Pnt), new OcctSerializer_Pnt());
    47.             Serializer.AddSerializer(typeof(Pnt2d), new OcctSerializer_Pnt2d());
    48.             Serializer.AddSerializer(typeof(Vec), new OcctSerializer_Vec());
    49.             Serializer.AddSerializer(typeof(Dir), new OcctSerializer_Dir());
    50.             Serializer.AddSerializer(typeof(Quaternion), new OcctSerializer_Quaternion());
    51.             Serializer.AddSerializer(typeof(Ax1), new OcctSerializer_Ax1());
    52.             Serializer.AddSerializer(typeof(Ax2), new OcctSerializer_Ax2());
    53.             Serializer.AddSerializer(typeof(Pln), new OcctSerializer_Pln());
    54.  
    55.             _IsInitialized = true; // 设置初始化标志为true
    56.         }
    57.  
    58.         //--------------------------------------------------------------------------------------------------
    59.  
    60.     }
    61. }

    这段代码定义了一系列用于OpenCASCADE类型的序列化器，包括Pnt、Pnt2d、Vec、Dir、Quaternion、Ax1、Ax2和Pln。每个序列化器都实现了ISerializer接口，包括Write方法用于将对象序列化为数组，以及Read方法用于从数组中反序列化为对象。在初始化方法Init中，这些序列化器被注册到了全局的Serializer对象中，以便在序列化和反序列化过程中使用。

    15.

    1. using System; // 导入System命名空间，提供基本的系统类型和功能
    2. using Macad.Common.Serialization; // 导入Macad.Common.Serialization命名空间，提供序列化相关的类和接口
    3. using Macad.Occt; // 导入Macad.Occt命名空间，提供OpenCASCADE的类型定义
    4.  
    5. namespace Macad.Core
    6. {
    7.     [SerializeType] // 标记该枚举类型可被序列化
    8.     public enum SubshapeType // 定义名为SubshapeType的枚举类型，用于表示子形状的类型
    9.     {
    10.         Vertex, // 顶点
    11.         Edge, // 边
    12.         Wire, // 线
    13.         Face // 面
    14.     }
    15.  
    16.     //--------------------------------------------------------------------------------------------------
    17.  
    18.     [SerializeType] // 标记该枚举类型可被序列化
    19.     [Flags] // 标记该枚举为位标志枚举
    20.     public enum SubshapeTypes // 定义名为SubshapeTypes的枚举类型，用于表示多个子形状的组合类型
    21.     {
    22.         None = 0, // 无
    23.         Vertex = 1 << 0, // 顶点
    24.         Edge = 1 << 1, // 边
    25.         Wire = 1 << 2, // 线
    26.         Face = 1 << 4, // 面
    27.         All = Vertex | Edge | Wire | Face // 全部类型的组合
    28.     }
    29.  
    30.     //--------------------------------------------------------------------------------------------------
    31.  
    32.     public static class SubshapeTypeHelper // 定义名为SubshapeTypeHelper的静态类，包含一些用于子形状类型操作的方法
    33.     {
    34.         public static SubshapeTypes GetTypes(SubshapeType topAbsShapeEnum) // 返回给定SubshapeType枚举值对应的SubshapeTypes位标志值
    35.         {
    36.             switch (topAbsShapeEnum)
    37.             {
    38.                 case SubshapeType.Face:
    39.                     return SubshapeTypes.Face;
    40.  
    41.                 case SubshapeType.Edge:
    42.                     return SubshapeTypes.Edge;
    43.  
    44.                 case SubshapeType.Wire:
    45.                     return SubshapeTypes.Wire;
    46.  
    47.                 case SubshapeType.Vertex:
    48.                     return SubshapeTypes.Vertex;
    49.  
    50.                 default:
    51.                     throw new NotImplementedException(); // 抛出未实现异常
    52.             }
    53.         }
    54.  
    55.         //--------------------------------------------------------------------------------------------------
    56.  
    57.         // 类似地定义其他用于获取子形状类型的方法，包括GetType和GetTypes方法
    58.  
    59.         //--------------------------------------------------------------------------------------------------
    60.  
    61.         public static TopAbs_ShapeEnum ToTopAbs(this SubshapeType type) // 将SubshapeType枚举值转换为TopAbs_ShapeEnum值
    62.         {
    63.             switch (type)
    64.             {
    65.                 case SubshapeType.Vertex:
    66.                     return TopAbs_ShapeEnum.VERTEX;
    67.                 case SubshapeType.Edge:
    68.                     return TopAbs_ShapeEnum.EDGE;
    69.                 case SubshapeType.Wire:
    70.                     return TopAbs_ShapeEnum.WIRE;
    71.                 case SubshapeType.Face:
    72.                     return TopAbs_ShapeEnum.FACE;
    73.                 default:
    74.                     throw new NotImplementedException(); // 抛出未实现异常
    75.             }
    76.         }
    77.  
    78.         //--------------------------------------------------------------------------------------------------
    79.  
    80.         // 类似地定义其他用于转换子形状类型的方法，包括ToAisSelectionMode和Count方法
    81.  
    82.         //--------------------------------------------------------------------------------------------------
    83.  
    84.     }
    85. }

    这段代码定义了用于处理子形状类型的枚举和辅助方法。首先定义了SubshapeType枚举，表示子形状的具体类型，包括顶点、边、线和面。然后定义了SubshapeTypes枚举，表示多个子形状类型的组合，使用了位标志枚举的特性。接着定义了SubshapeTypeHelper静态类，包含了一系列用于处理子形状类型的方法，包括获取子形状类型、转换类型以及计数等。这些方法可以方便地处理子形状类型的操作和转换。

    16.

    1. using System; // 导入System命名空间，提供基本的系统类型和功能
    2. using System.Collections.Generic; // 导入System.Collections.Generic命名空间，提供泛型集合类型的支持
    3. using Macad.Occt; // 导入Macad.Occt命名空间，提供OpenCASCADE的类型定义
    4.  
    5. namespace Macad.Core // 声明名为Macad.Core的命名空间，该类位于Macad.Core命名空间下
    6. {
    7.     public class TopoDSShapeComparer : IEqualityComparer<TopoDS_Shape> // 定义名为TopoDSShapeComparer的类，实现了IEqualityComparer接口，用于比较TopoDS_Shape对象
    8.     {
    9.         public enum CompareMode // 定义名为CompareMode的枚举类型，表示比较模式
    10.         {
    11.             Equal, // 相等
    12.             Same, // 相同
    13.             Partner // 伙伴
    14.         }
    15.  
    16.         //--------------------------------------------------------------------------------------------------
    17.  
    18.         CompareMode _Mode = CompareMode.Equal; // 声明名为_Mode的字段，用于存储比较模式，默认为Equal
    19.  
    20.         //--------------------------------------------------------------------------------------------------
    21.  
    22.         public TopoDSShapeComparer(CompareMode mode) // 定义TopoDSShapeComparer类的构造函数，初始化比较模式
    23.         {
    24.             _Mode = mode; // 将传入的比较模式赋值给_Mode字段
    25.         }
    26.  
    27.         //--------------------------------------------------------------------------------------------------
    28.  
    29.         public bool Equals(TopoDS_Shape x, TopoDS_Shape y) // 实现IEqualityComparer接口中的Equals方法，用于比较两个TopoDS_Shape对象是否相等
    30.         {
    31.             if (x == null) // 如果第一个对象为null
    32.                 return y == null; // 则当第二个对象也为null时返回true，否则返回false
    33.  
    34.             return _Mode switch // 根据比较模式进行比较
    35.             {
    36.                 CompareMode.Equal => x.Equals(y), // 如果比较模式为Equal，则调用Equals方法比较对象是否相等
    37.                 CompareMode.Same => x.IsSame(y), // 如果比较模式为Same，则调用IsSame方法比较对象是否相同
    38.                 CompareMode.Partner => x.IsPartner(y), // 如果比较模式为Partner，则调用IsPartner方法比较对象是否为伙伴
    39.                 _ => false // 默认情况下返回false
    40.             };
    41.         }
    42.  
    43.         //--------------------------------------------------------------------------------------------------
    44.  
    45.         public int GetHashCode(TopoDS_Shape obj) // 实现IEqualityComparer接口中的GetHashCode方法，用于获取对象的哈希码
    46.         {
    47.             return _Mode switch // 根据比较模式获取哈希码
    48.             {
    49.                 CompareMode.Equal => obj.GetHashCode(), // 如果比较模式为Equal，则直接返回对象的哈希码
    50.                 CompareMode.Same => obj.TShape().GetHashCode() ^ obj.Location().GetHashCode(), // 如果比较模式为Same，则获取对象的TShape和Location的哈希码，并进行异或操作
    51.                 CompareMode.Partner => obj.TShape().GetHashCode(), // 如果比较模式为Partner，则只获取对象的TShape的哈希码
    52.                 _ => 0 // 默认情况下返回0
    53.             };
    54.         }
    55.     }
    56. }

    这段代码定义了一个名为TopoDSShapeComparer的类，用于比较TopoDS_Shape对象。它实现了IEqualityComparer接口，其中T是TopoDS_Shape类型。类中包含了一个枚举CompareMode，表示比较模式，包括相等、相同和伙伴。类中包含了一个字段 _Mode，用于存储比较模式，默认为相等。类中包含了构造函数用于初始化比较模式，以及Equals方法用于比较两个对象是否相等，GetHashCode方法用于获取对象的哈希码。

    17.

    1. using System; // 导入System命名空间，提供基本的系统类型和功能
    2. using System.Collections.Generic; // 导入System.Collections.Generic命名空间，提供泛型集合类型的支持
    3. using System.IO; // 导入System.IO命名空间，提供文件和流的操作功能
    4.  
    5. namespace Macad.Core // 声明名为Macad.Core的命名空间，该类位于Macad.Core命名空间下
    6. {
    7.     internal static class ScriptCache // 声明名为ScriptCache的静态类，用于脚本缓存管理
    8.     {
    9.         struct CachedScriptFileInfo // 定义名为CachedScriptFileInfo的结构体，用于存储缓存的脚本文件信息
    10.         {
    11.             internal string FileName; // 存储文件名
    12.             internal long Length; // 存储文件长度
    13.             internal DateTime LastWriteTime; // 存储文件最后写入时间
    14.         }
    15.  
    16.         class CachedScript // 定义名为CachedScript的内部类，用于存储缓存的脚本实例及其文件信息
    17.         {
    18.             internal ScriptInstance Instance; // 存储脚本实例
    19.             internal CachedScriptFileInfo[] FileInfos; // 存储脚本文件信息数组
    20.         }
    21.  
    22.         //--------------------------------------------------------------------------------------------------
    23.  
    24.         static readonly Dictionary<string, CachedScript> _CachedScripts = new Dictionary<string, CachedScript>(); // 声明名为_CachedScripts的静态只读字典，用于存储缓存的脚本信息
    25.  
    26.         //--------------------------------------------------------------------------------------------------
    27.  
    28.         internal static void Add(ScriptInstance scriptInstance, List<string> fileList) // 声明名为Add的静态方法，用于向脚本缓存中添加脚本实例及其文件信息
    29.         {
    30.             var entry = new CachedScript // 创建CachedScript实例
    31.             {
    32.                 Instance = scriptInstance, // 设置脚本实例
    33.                 FileInfos = new CachedScriptFileInfo[fileList.Count], // 创建缓存的脚本文件信息数组
    34.             };
    35.  
    36.             for (var i = 0; i < fileList.Count; i++) // 遍历文件列表
    37.             {
    38.                 var fi = new FileInfo(fileList[i]); // 获取文件信息
    39.                 var info = new CachedScriptFileInfo() // 创建CachedScriptFileInfo实例
    40.                 {
    41.                     FileName = fileList[i], // 设置文件名
    42.                     Length = fi.Length, // 设置文件长度
    43.                     LastWriteTime = fi.LastWriteTimeUtc // 设置文件最后写入时间
    44.                 };
    45.                 entry.FileInfos[i] = info; // 将文件信息添加到缓存的文件信息数组中
    46.             }
    47.  
    48.             _CachedScripts[scriptInstance.Path] = entry; // 将脚本实例路径及其对应的缓存信息添加到缓存字典中
    49.         }
    50.  
    51.         //--------------------------------------------------------------------------------------------------
    52.  
    53.         internal static ScriptInstance Find(string filename) // 声明名为Find的静态方法，用于在缓存中查找指定路径的脚本实例
    54.         {
    55.             try
    56.             {
    57.                 filename = Path.GetFullPath(filename); // 获取指定路径的绝对路径
    58.                 if (!_CachedScripts.TryGetValue(filename, out CachedScript entry)) // 判断缓存字典中是否包含指定路径的缓存信息
    59.                     return null; // 如果不包含，则返回null
    60.  
    61.                 foreach (var info in entry.FileInfos) // 遍历缓存的文件信息数组
    62.                 {
    63.                     var fi = new FileInfo(info.FileName); // 获取文件信息
    64.                     if (fi.Length != info.Length // 检查文件长度和最后写入时间是否匹配
    65.                         || fi.LastWriteTimeUtc != info.LastWriteTime)
    66.                     {
    67.                         // Cache miss，如果不匹配，则返回null
    68.                         return null;
    69.                     }
    70.                 }
    71.  
    72.                 // Cache hit，如果匹配，则返回对应的脚本实例
    73.                 return entry.Instance;
    74.             }
    75.             catch (Exception)
    76.             {
    77.                 return null; // 发生异常时返回null
    78.             }
    79.         }
    80.  
    81.         //--------------------------------------------------------------------------------------------------
    82.  
    83.         internal static void Clear() // 声明名为Clear的静态方法，用于清空缓存字典
    84.         {
    85.             _CachedScripts.Clear(); // 清空缓存字典
    86.         }
    87.  
    88.         //--------------------------------------------------------------------------------------------------
    89.  
    90.     }
    91. }

    这段代码定义了一个名为 ScriptCache 的静态类，用于管理脚本的缓存。它包含了一个内部结构 CachedScriptFileInfo，用于存储缓存的脚本文件信息，以及一个内部类 CachedScript，用于存储缓存的脚本实例及其文件信息。类中声明了一个静态只读字典 _CachedScripts，用于存储缓存的脚本信息。还包含了方法 Add 用于向缓存中添加脚本实例及其文件信息，方法 Find 用于在缓存中查找指定路径的脚本实例，以及方法 Clear 用于清空缓存字典。

    18.

    1. using System; // 导入 System 命名空间，提供基本的系统类型和功能
    2. using System.Collections.Generic; // 导入 System.Collections.Generic 命名空间，提供泛型集合类型的支持
    3. using System.Collections.Immutable; // 导入 System.Collections.Immutable 命名空间，提供不可变集合类型的支持
    4. using System.Globalization; // 导入 System.Globalization 命名空间，提供区域性特定信息的功能
    5. using System.IO; // 导入 System.IO 命名空间，提供文件和流的操作功能
    6. using System.Linq; // 导入 System.Linq 命名空间，提供 LINQ 查询功能
    7. using System.Reflection; // 导入 System.Reflection 命名空间，提供反射操作的功能
    8. using System.Runtime.Loader; // 导入 System.Runtime.Loader 命名空间，提供程序集加载器的功能
    9. using System.Text; // 导入 System.Text 命名空间，提供字符串处理功能
    10. using Microsoft.CodeAnalysis; // 导入 Microsoft.CodeAnalysis 命名空间，提供编译代码分析的功能
    11. using Microsoft.CodeAnalysis.CSharp; // 导入 Microsoft.CodeAnalysis.CSharp 命名空间，提供 C# 编译器的功能
    12. using Microsoft.CodeAnalysis.CSharp.Scripting; // 导入 Microsoft.CodeAnalysis.CSharp.Scripting 命名空间，提供 C# 脚本编译的功能
    13. using Microsoft.CodeAnalysis.Scripting; // 导入 Microsoft.CodeAnalysis.Scripting 命名空间，提供脚本编译的功能
    14. using Macad.Common; // 导入 Macad.Common 命名空间，提供通用功能
    15. using Macad.Occt; // 导入 Macad.Occt 命名空间，提供 OCC 相关功能
    16. using Microsoft.CodeAnalysis.Scripting.Hosting; // 导入 Microsoft.CodeAnalysis.Scripting.Hosting 命名空间，提供脚本主机环境的功能
    17.  
    18. namespace Macad.Core // 声明名为 Macad.Core 的命名空间，该类位于 Macad.Core 命名空间下
    19. {
    20.     internal sealed class ScriptCompiler // 声明名为 ScriptCompiler 的密封类，用于编译脚本
    21.     {
    22.         static readonly string[] _DefaultReferenceAppAssemblies = // 默认的引用应用程序集
    23.         {
    24.             "Macad.Occt.dll",
    25.             "Macad.Managed.dll",
    26.             "Macad.Common.dll",
    27.             "Macad.Core.dll",
    28.             "Macad.Presentation.dll",
    29.             "Macad.Interaction.dll",
    30.             "Macad.Resources.dll"
    31.         };
    32.  
    33.         static readonly string[] _DefaultImports = // 默认的导入命名空间
    34.         {
    35.             "System",
    36.             "Macad.Common",
    37.             "Macad.Core",
    38.             "Macad.Core.Shapes",
    39.             "Macad.Core.Toolkits",
    40.             "Macad.Core.Topology",
    41.             "Macad.Occt",
    42.         };
    43.  
    44.         static readonly string[] _MetadataSearchPaths = // 元数据搜索路径
    45.         {
    46.             Path.GetDirectoryName(Assembly.GetExecutingAssembly().Location),
    47.             Path.GetDirectoryName(typeof(object).Assembly.Location)
    48.         };
    49.  
    50.         //--------------------------------------------------------------------------------------------------
    51.  
    52.         static float _Version; // 版本号
    53.  
    54.         //--------------------------------------------------------------------------------------------------
    55.  
    56.         static ScriptCompiler() // 静态构造函数
    57.         {
    58.             var version = Assembly.GetExecutingAssembly().GetName().Version; // 获取当前程序集的版本
    59.             _Version = float.Parse($"{version.Major}.{version.Minor}", CultureInfo.InvariantCulture); // 解析版本号
    60.         }
    61.  
    62.         //--------------------------------------------------------------------------------------------------
    63.  
    64.         internal static void OverrideVersion(float version) // 重写版本号
    65.         {
    66.             _Version = version; // 设置版本号
    67.         }
    68.  
    69.         //--------------------------------------------------------------------------------------------------
    70.  
    71.         internal static bool Compile(ScriptInstance scriptInstance) // 编译脚本
    72.         {
    73.             var compiler = new ScriptCompiler(scriptInstance); // 创建 ScriptCompiler 实例
    74.             if (!compiler._Compile()) // 调用 _Compile 方法进行编译
    75.                 return false; // 如果编译失败，返回 false
    76.  
    77.             ScriptCache.Add(scriptInstance, compiler._FileList); // 将编译结果添加到脚本缓存中
    78.  
    79.             return true; // 返回编译成功
    80.         }
    81.  
    82.         //--------------------------------------------------------------------------------------------------
    83.  
    84.         readonly ScriptInstance _ScriptInstance; // 脚本实例
    85.         readonly List<string> _FileList = new List<string>(); // 文件列表
    86.         readonly bool _EnableDebugging = true; // 是否启用调试
    87.  
    88.         //--------------------------------------------------------------------------------------------------
    89.  
    90.         ScriptCompiler(ScriptInstance scriptInstance) // ScriptCompiler 构造函数
    91.         {
    92.             _ScriptInstance = scriptInstance; // 设置脚本实例
    93.         }
    94.  
    95.         //--------------------------------------------------------------------------------------------------
    96.  
    97.         bool _Compile() // 编译
    98.         {
    99.             try
    100.             {
    101.                 var codeStream = _ReadAndPreprocessFile(_ScriptInstance.Path); // 读取并预处理文件
    102.                 if (codeStream == null)
    103.                     return false;
    104.  
    105.                 var baseDirectory = Path.GetDirectoryName(_ScriptInstance.Path); // 获取基目录
    106.  
    107.                 var metadataResolver = ScriptMetadataResolver.Default // 元数据解析器
    108.                                                              .WithSearchPaths(_MetadataSearchPaths)
    109.                                                              .WithBaseDirectory(baseDirectory);
    110.  
    111.                 var sourceResolver = new ScriptSourceResolver(baseDirectory, _ReadAndPreprocessFile); // 源代码解析器
    112.  
    113.                 var options = ScriptOptions.Default // 脚本选项
    114.                                            .WithWarningLevel(4)
    115.                                            .WithReferences(_DefaultReferenceAppAssemblies)
    116.                                            .WithMetadataResolver(metadataResolver)
    117.                                            .WithSourceResolver(sourceResolver)
    118.                                            .WithImports(_DefaultImports)
    119.                                            .WithEmitDebugInformation(_EnableDebugging)
    120.                                            .WithLanguageVersion(LanguageVersion.Latest);
    121.  
    122.                 var assemblyLoader = new InteractiveAssemblyLoader(); // 装载程序集
    123.                 foreach (var defaultAssembly in AssemblyLoadContext.Default.Assemblies) // 加载默认程序集
    124.                 {
    125.                     assemblyLoader.RegisterDependency(defaultAssembly);
    126.                 }
    127.                 // This extra reference is needed for unit test runner which isolate this assembly
    128.                 assemblyLoader.RegisterDependency(Assembly.GetExecutingAssembly()); // 注册依赖程序集
    129.  
    130.                 var script = CSharpScript.Create(codeStream, options, _ScriptInstance.ContextInstance.GetType(), assemblyLoader); // 创建脚本
    131.                 var results = script.Compile(); // 编译脚本
    132.                 codeStream.Dispose(); // 释放流资源
    133.  
    134.                 var hasErrors = _ReportResults(results); // 检查编译结果
    135.                 if (!hasErrors) // 如果没有错误
    136.                 {
    137.                     return _ScriptInstance.Init(script.CreateDelegate()); // 初始化脚本实例
    138.                 }
    139.             }
    140.             catch (Exception e) // 捕获异常
    141.             {
    142.                 Messages.Exception("Script compilation failed. Scriptfile: " + _ScriptInstance.Path, e); // 报告异常
    143.             }
    144.             return false; // 返回编译失败
    145.         }
    146.  
    147.         //--------------------------------------------------------------------------------------------------
    148.  
    149.         Stream _ReadAndPreprocessFile(string filename) // 读取并预处理文件
    150.         {
    151.             if (!File.Exists(filename)) // 检查文件是否存在
    152.             {
    153.                 Messages.Error($"Script imported file {filename} not found. Scriptfile: {_ScriptInstance.Path}"); // 报告错误
    154.                 return null; // 返回空流
    155.             }
    156.  
    157.             if (!_FileList.Contains(filename)) // 检查文件列表中是否包含该文件
    158.             {
    159.                 _FileList.Add(filename); // 添加文件到文件列表
    160.             }
    161.  
    162.             var ms = new MemoryStream(); // 创建内存流
    163.             using StreamWriter sw = new StreamWriter(ms, Encoding.Unicode, 1024, true); // 创建写入器
    164.  
    165.             sw.WriteLine($"#line 1 \"{Path.GetFileName(filename)}\""); // 写入 #line 指令
    166.  
    167.             bool inComment = false; // 是否在注释中
    168.             int lineNumber = 0; // 行号
    169.             using (var reader = File.OpenText(filename)) // 使用文件读取器读取文件
    170.             {
    171.                 while (!reader.EndOfStream) // 循环读取每行
    172.                 {
    173.                     var rawLine = reader.ReadLine(); // 读取原始行
    174.                     if (rawLine == null)
    175.                         break;
    176.                     var line = rawLine.Trim().ToLower(); // 去除首尾空白并转换为小写
    177.  
    178.                     lineNumber++; // 行号递增
    179.  
    180.                     if (line.IsNullOrWhiteSpace()) // 检查是否为空行
    181.                     {
    182.                         sw.WriteLine(rawLine); // 写入空行
    183.                         continue;
    184.                     }
    185.  
    186.                     // We are in a comment block
    187.                     if (inComment) // 如果在注释块中
    188.                     {
    189.                         var posStart = line.LastIndexOf("/*", StringComparison.Ordinal); // 获取注释块起始位置
    190.                         var posEnd = line.LastIndexOf("*/", StringComparison.Ordinal); // 获取注释块结束位置
    191.                         if (posEnd > posStart) // 如果结束位置大于起始位置
    192.                         {
    193.                             // Comment closed
    194.                             inComment = false; // 标记注释块关闭
    195.  
    196.                             // only continue if no code follows
    197.                             if (!line.EndsWith("*/")) // 如果注释块后还有代码
    198.                                 continue;
    199.                         }
    200.  
    201.                         // Comment continues
    202.                         sw.WriteLine(rawLine); // 写入注释行
    203.                         continue;
    204.                     }
    205.  
    206.                     // Pragma
    207.                     if (line.StartsWith("#")) // 如果是 #pragma 指令
    208.                     {
    209.                         if (line.StartsWith("#if ") || line.StartsWith("#elif ")) // 如果是条件编译指令
    210.                         {
    211.                             var second = line.Substring(line.IndexOf(' ') + 1).Trim(); // 获取条件表达式
    212.                             if (second.StartsWith("version ")) // 如果是版本判断
    213.                             {
    214.                                 var value = second.Substring(8); // 获取版本号值
    215.                                 var substitute = _ProcessVersion(value); // 处理版本号
    216.                                 if (substitute == null) // 如果处理失败
    217.                                 {
    218.                                     Messages.Error($"Script error in line {lineNumber}: The version expression is invalid. Scriptfile: {_ScriptInstance.Path}."); // 报告错误
    219.                                     ms.Close(); // 关闭流
    220.                                     return null; // 返回空流
    221.                                 }
    222.  
    223.                                 sw.Write(rawLine.Substring(0, rawLine.IndexOf('#'))); // 写入 #pragma 指令之前的部分
    224.                                 sw.Write(line.Substring(0, line.IndexOf(' ') + 1)); // 写入 #pragma 指令
    225.                                 sw.WriteLine(substitute + " // version " + value); // 写入替换后的版本号表达式
    226.                                 continue;
    227.                             }
    228.                         }
    229.  
    230.                         // non-directive for us, just skip
    231.                         sw.WriteLine(rawLine); // 写入 #pragma 指令
    232.                         continue;
    233.                     }
    234.  
    235.                     // Single comment line
    236.                     if (line.StartsWith("//")) // 如果是单行注释
    237.                     {
    238.                         // non-directive comment line, just skip
    239.                         sw.WriteLine(rawLine); // 写入单行注释
    240.                         continue;
    241.                     }
    242.  
    243.                     // Comment starting
    244.                     if (line.StartsWith("/*")) // 如果是注释块起始
    245.                     {
    246.                         var posStart = line.LastIndexOf("/*", StringComparison.Ordinal); // 获取注释块起始位置
    247.                         var posEnd = line.LastIndexOf("*/", StringComparison.Ordinal); // 获取注释块结束位置
    248.                         if (posEnd < posStart) // 如果结束位置小于起始位置
    249.                         {
    250.                             // Comment opened, but not closed
    251.                             inComment = true; // 标记注释块开启
    252.                         }
    253.                         else
    254.                         {
    255.                             // Comment opened and closed
    256.                             // only continue if no code follows
    257.                             if (!line.EndsWith("*/")) // 如果注释块后还有代码
    258.                                 continue;
    259.                         }
    260.  
    261.                         sw.WriteLine(rawLine); // 写入注释行
    262.                         continue;
    263.                     }
    264.  
    265.                     sw.WriteLine(rawLine); // 写入原始行
    266.                 }
    267.             }
    268.  
    269.             return ms; // 返回内存流
    270.         }
    271.  
    272.         //--------------------------------------------------------------------------------------------------
    273.  
    274.         static readonly char[] _VersionOperands = {'<', '>', '=', '!', ' '}; // 版本号操作符
    275.  
    276.         string _ProcessVersion(string line) // 处理版本号
    277.         {
    278.             var splitIndex = line.LastIndexOfAny(_VersionOperands); // 查找操作符位置
    279.             if (splitIndex < 0) // 如果操作符位置小于 0
    280.                 return null;
    281.  
    282.             var value = line.Substring(splitIndex + 1); // 获取版本号值
    283.             if (!float.TryParse(value, NumberStyles.AllowDecimalPoint, CultureInfo.InvariantCulture, out var version)) // 解析版本号
    284.                 return null;
    285.  
    286.             bool result;
    287.             var operand = line.Substring(0, splitIndex + 1).Trim(); // 获取操作符
    288.             switch (operand) // 判断操作符
    289.             {
    290.                 case "==":
    291.                     result = version.IsEqual(_Version, 0.001f); // 判断是否相等
    292.                     break;
    293.                 case "!=":
    294.                     result = !version.IsEqual(_Version, 0.001f); // 判断是否不相等
    295.                     break;
    296.                 case "<":
    297.                     result = _Version < version; // 判断是否小于
    298.                     break;
    299.                 case "<=":
    300.                     result = _Version < version || version.IsEqual(_Version, 0.001f); // 判断是否小于等于
    301.                     break;
    302.                 case ">":
    303.                     result = _Version > version; // 判断是否大于
    304.                     break;
    305.                 case ">=":
    306.                     result = _Version > version || version.IsEqual(_Version, 0.001f); // 判断是否大于等于
    307.                     break;
    308.                 default:
    309.                     return null;
    310.             }
    311.  
    312.             return result ? "true" : "false"; // 返回处理结果
    313.         }
    314.  
    315.         //--------------------------------------------------------------------------------------------------
    316.  
    317.         bool _ReportResults(ImmutableArray errors) // 报告编译结果
    318.         {
    319.             DiagnosticSeverity severity = DiagnosticSeverity.Info; // 默认的诊断级别为 Info
    320.             var sb = new StringBuilder(); // 创建字符串构建器
    321.             foreach (var diag in errors) // 遍历诊断信息
    322.             {
    323.                 if (diag.Severity < DiagnosticSeverity.Warning) // 如果诊断级别低于警告
    324.                     continue;
    325.                 if (diag.Severity > severity) // 如果诊断级别高于当前级别
    326.                     severity = diag.Severity; // 更新诊断级别
    327.  
    328.                 if (diag.Location != null) // 如果有位置信息
    329.                 {
    330.                     var location = diag.Location.GetMappedLineSpan(); // 获取映射的行范围
    331.                     if (location.IsValid && !location.Path.IsNullOrEmpty()) // 如果有效且路径不为空
    332.                     {
    333.                         sb.Append(Path.GetFileName(location.Path)); // 添加文件名
    334.                         sb.Append($" ({location.Span.Start.Line},{location.Span.Start.Character}): "); // 添加行号和字符位置
    335.                     }
    336.                 }
    337.  
    338.                 sb.Append(severity == DiagnosticSeverity.Error ? "Error " : "Warning "); // 添加错误或警告信息
    339.                 sb.Append(diag.Id); // 添加诊断标识
    340.                 sb.Append(": ");
    341.                 sb.AppendLine(diag.GetMessage(CultureInfo.InvariantCulture)); // 添加诊断消息
    342.             }
    343.  
    344.             if (severity == DiagnosticSeverity.Error) // 如果诊断级别为错误
    345.             {
    346.                 Messages.Error("Script compilation failed with errors.", sb.ToString()); // 报告编译错误
    347.             }
    348.             else if(severity == DiagnosticSeverity.Warning) // 如果诊断级别为警告
    349.             {
    350.                 Messages.Warning("Script compiled with warnings.", sb.ToString()); // 报告编译警告
    351.             }
    352.  
    353.             return severity == DiagnosticSeverity.Error; // 返回是否有错误
    354.         }
    355.  
    356.     }
    357. }

    以上代码是一个用于编译脚本的 C# 类 ScriptCompiler，它负责读取、预处理、编译脚本文件，并提供一些额外的功能，如版本控制和诊断报告。下面是代码的注释说明：

    • ScriptCompiler 类包含了用于编译脚本的各种方法和功能。
    • Compile 方法用于编译脚本实例。
    • _Compile 方法实现了脚本的实际编译过程，包括读取、预处理文件，设置编译选项，编译脚本，并处理编译结果。
    • _ReadAndPreprocessFile 方法用于读取和预处理文件，包括处理注释、#pragma 指令和版本号条件等。
    • _ProcessVersion 方法用于处理版本号条件表达式。
    • _ReportResults 方法用于报告编译结果，包括错误和警告信息。
    • 其他部分包括一些字段和常量的定义，以及静态构造函数和一些辅助方法的实现。

    这个类的主要功能是将脚本文件编译成可执行的代码，并提供错误和警告信息以供调试和修复。

    19.

    1. using Macad.Core.Topology;
    2.  
    3. namespace Macad.Core
    4. {
    5.     /// 
    6.     /// 脚本上下文类，作为所有脚本的基类，在应用程序中提供对各种组件的访问。
    7.     /// 
    8.     public class ScriptContext
    9.     {
    10.         /// 
    11.         /// 默认的脚本上下文实例，允许无需实例化新的对象即可访问其成员。
    12.         /// 
    13.         internal static ScriptContext Default { get; } = new ScriptContext();
    14.  
    15.         //--------------------------------------------------------------------------------------------------
    16.  
    17.         /// 
    18.         /// 模型对象，包含应用程序中的所有实体和对每个实体的引用。
    19.         /// 
    20.         public Model Document => CoreContext.Current.Document;
    21.         
    22.         /// 
    23.         /// 图层集合，定义了与实体的可见性、交互性和可视化相关的共享属性。
    24.         /// 
    25.         public LayerCollection Layers => CoreContext.Current.Layers;
    26.  
    27.         /// 
    28.         /// 工作空间，包含应用程序内部用于可视化和交互的所有功能。
    29.         /// 
    30.         public Workspace Workspace => CoreContext.Current.Workspace;
    31.         
    32.         /// 
    33.         /// 视口，是工作空间的窗口，用于用户在图形环境中查看和操作对象。
    34.         /// 
    35.         public Viewport Viewport => CoreContext.Current.Viewport;
    36.     }
    37. }

    这段代码定义了名为 ScriptContext 的类，它作为脚本的基类，在应用程序中提供对各种组件的访问。下面是对其成员的解释：

    • Default 属性：

      • 提供了 ScriptContext 的静态实例，允许在不需要实例化新的 ScriptContext 对象的情况下轻松访问其成员。

    • Document 属性：

      • 表示模型，其中包含应用程序中的所有实体和对每个实体的引用。通常，CAD 模型的几何结构和结构都驻留在这里。

    • Layers 属性：

      • 表示图层集合，定义了与应用程序中实体的可见性、交互性和可视化相关的共享属性。图层通常用于组织和管理在视口中显示对象的方式。

    • Workspace 属性：

      • 表示工作空间，其中包含应用程序内部用于可视化和交互的所有功能。这包括与 CAD 模型相关的工具、命令和其他功能。

    • Viewport 属性：

      • 表示视口，它是对工作空间的窗口。视口是用户与 CAD 模型交互的地方，在图形环境中查看和操作对象。

    这些属性为脚本提供了对应用程序环境中关键组件的访问，使其能够有效地执行操作并在 CAD 模型中操作数据。

    20.

    1. using System;
    2. using System.Collections.Generic;
    3. using System.IO;
    4. using System.Linq;
    5. using System.Reflection;
    6. using Microsoft.CodeAnalysis.Scripting;
    7.  
    8. namespace Macad.Core
    9. {
    10.     /// 
    11.     /// 表示一个脚本实例，可以加载、编译和运行脚本文件。
    12.     /// 
    13.     public sealed class ScriptInstance
    14.     {
    15.         /// 
    16.         /// 从文件加载脚本实例。
    17.         /// 
    18.         /// 脚本文件路径。
    19.         /// 是否强制重新加载。
    20.         /// 加载的脚本实例。
    21.         public static ScriptInstance LoadScriptFromFile(string filename, bool forceReload = false)
    22.         {
    23.             return LoadScriptFromFile(filename, ScriptContext.Default, forceReload);
    24.         }
    25.  
    26.         //--------------------------------------------------------------------------------------------------
    27.  
    28.         /// 
    29.         /// 从文件加载脚本实例。
    30.         /// 
    31.         /// 脚本文件路径。
    32.         /// 脚本上下文实例。
    33.         /// 是否强制重新加载。
    34.         /// 加载的脚本实例。
    35.         public static ScriptInstance LoadScriptFromFile(string filename, ScriptContext contextInstance, bool forceReload=false)
    36.         {
    37.             if (!File.Exists(filename))
    38.             {
    39.                 Messages.Error( "Script file does not exist: " + filename);
    40.             }
    41.  
    42.             ScriptInstance scriptInstance;
    43.             if (!forceReload)
    44.             {
    45.                 scriptInstance = ScriptCache.Find(filename);
    46.                 if (scriptInstance != null)
    47.                     return scriptInstance;
    48.             }
    49.  
    50.             scriptInstance = new ScriptInstance(filename, contextInstance);
    51.             if(ScriptCompiler.Compile(scriptInstance))
    52.             {
    53.                 return scriptInstance;
    54.             }
    55.             return null;
    56.         }
    57.  
    58.         //--------------------------------------------------------------------------------------------------
    59.  
    60.         /// 
    61.         /// 获取当前正在运行的脚本实例。
    62.         /// 
    63.         public static ScriptInstance Current
    64.         {
    65.             get { return _RunningScripts.Any() ? _RunningScripts.Peek() : null; }
    66.         }
    67.  
    68.         static readonly Stack _RunningScripts = new Stack();
    69.  
    70.         //--------------------------------------------------------------------------------------------------
    71.  
    72.         /// 
    73.         /// 脚本名称。
    74.         /// 
    75.         public string Name { get; }
    76.         
    77.         /// 
    78.         /// 脚本文件路径。
    79.         /// 
    80.         public string Path { get; }
    81.         
    82.         /// 
    83.         /// 脚本上下文实例。
    84.         /// 
    85.         public ScriptContext ContextInstance { get; }
    86.  
    87.         //--------------------------------------------------------------------------------------------------
    88.  
    89.         ScriptRunner<object> _RunnerDelegate;
    90.  
    91.         //--------------------------------------------------------------------------------------------------
    92.  
    93.         /// 
    94.         /// 初始化脚本实例。
    95.         /// 
    96.         internal ScriptInstance(string filename, ScriptContext contextInstance)
    97.         {
    98.             Name = System.IO.Path.GetFileName(filename);
    99.             Path = System.IO.Path.GetFullPath(filename);
    100.             ContextInstance = contextInstance;
    101.             _Reset();
    102.         }
    103.  
    104.         //--------------------------------------------------------------------------------------------------
    105.  
    106.         /// 
    107.         /// 重置脚本实例。
    108.         /// 
    109.         void _Reset()
    110.         {
    111.             _RunnerDelegate = null;
    112.         }
    113.  
    114.         //--------------------------------------------------------------------------------------------------
    115.  
    116.         /// 
    117.         /// 设置脚本运行器委托。
    118.         /// 
    119.         internal bool Init(ScriptRunner<object> runnerDelegate)
    120.         {
    121.             _Reset();
    122.  
    123.             _RunnerDelegate = runnerDelegate;
    124.  
    125.             return true;
    126.         }
    127.  
    128.         //--------------------------------------------------------------------------------------------------
    129.  
    130.         /// 
    131.         /// 运行脚本。
    132.         /// 
    133.         /// 指示脚本是否成功运行。
    134.         public bool Run()
    135.         {
    136.             bool result = false;
    137.             if (_RunnerDelegate == null)
    138.                 return false;
    139.  
    140.             _RunningScripts.Push(this);
    141.             try
    142.             {
    143.                 _RunnerDelegate(ContextInstance).Wait();
    144.                 result = true;
    145.             }
    146.             catch (Exception e)
    147.             {
    148.                 Messages.Exception($"The executed script '{Name}' throwed an exception.", e);
    149.             }
    150.             finally
    151.             {
    152.             }
    153.             _RunningScripts.Pop();
    154.  
    155.             // Only commit after the last script has ended.
    156.             if(_RunningScripts.Count == 0)
    157.                 CoreContext.Current?.UndoHandler?.Commit();
    158.  
    159.             return result;
    160.         }
    161.     }
    162. }

    以上代码是用于处理脚本的加载、编译和运行的类 ScriptInstance。下面是逐行注释和说明：

    1. using 指令：引入了一系列命名空间，包括必要的系统命名空间和 Microsoft.CodeAnalysis.Scripting 用于动态编译和运行脚本的命名空间。

    2. namespace Macad.Core：定义了 Macad.Core 命名空间，包含了整个脚本实例类。

    3. public sealed class ScriptInstance：定义了 ScriptInstance 类，用于表示一个脚本实例。

    4. public static ScriptInstance LoadScriptFromFile(string filename, bool forceReload = false) 方法：从文件加载脚本实例的静态方法。根据提供的文件名加载脚本，并可以选择是否强制重新加载。返回加载的脚本实例。

    5. public static ScriptInstance LoadScriptFromFile(string filename, ScriptContext contextInstance, bool forceReload=false) 方法：从文件加载脚本实例的静态方法，可以指定脚本上下文实例。返回加载的脚本实例。

    6. ScriptInstance(string filename, ScriptContext contextInstance) 构造函数：初始化脚本实例的私有构造函数。用于创建脚本实例对象。

    7. public static ScriptInstance Current 属性：获取当前正在运行的脚本实例。使用栈来存储运行的脚本实例，从而支持嵌套调用。

    8. _RunningScripts 字段：用于存储当前正在运行的脚本实例的栈。

    9. public string Name { get; } 属性：脚本名称。

    10. public string Path { get; } 属性：脚本文件路径。

    11. public ScriptContext ContextInstance { get; } 属性：脚本上下文实例。

    12. _RunnerDelegate 字段：脚本运行器委托，用于执行脚本的方法。

    13. _Reset() 方法：重置脚本实例，清空运行器委托。

    14. internal bool Init(ScriptRunner runnerDelegate) 方法：初始化脚本实例，设置运行器委托。

    15. public bool Run() 方法：运行脚本的方法。使用运行器委托来执行脚本的逻辑，并处理可能发生的异常。最终返回指示脚本是否成功运行的布尔值。

      16. 以上就是 ScriptInstance 类的代码及其注释说明。

      21.

      1. using System;
      2. using System.Collections.Immutable;
      3. using System.IO;
      4. using Microsoft.CodeAnalysis;
      5.  
      6. namespace Macad.Core
      7. {
      8.     /// 
      9.     /// 表示用于解析脚本源文件的解析器。
      10.     /// 
      11.     public sealed class ScriptSourceResolver : SourceFileResolver
      12.     {
      13.         Func<string, Stream> _ReadFunc;
      14.  
      15.         //--------------------------------------------------------------------------------------------------
      16.  
      17.         /// 
      18.         /// 构造函数，初始化脚本源文件解析器。
      19.         /// 
      20.         /// 基本目录。
      21.         /// 读取文件的方法。
      22.         public ScriptSourceResolver(string baseDirectory, Func<string, Stream> readFunc)
      23.             : base(ImmutableArray<string>.Empty, baseDirectory)
      24.         {
      25.             _ReadFunc = readFunc;
      26.         }
      27.  
      28.         //--------------------------------------------------------------------------------------------------
      29.  
      30.         /// 
      31.         /// 打开指定路径的文件流。
      32.         /// 
      33.         /// 已解析的文件路径。
      34.         /// 文件流。
      35.         public override Stream OpenRead(string resolvedPath)
      36.         {
      37.             return _ReadFunc(Path.GetFullPath(resolvedPath));
      38.         }
      39.     }
      40. }

      逐行注释和说明如下：

      1. using 指令：引入了必要的命名空间。

      2. namespace Macad.Core：定义了 Macad.Core 命名空间，包含了整个脚本源文件解析器类。

      3. public sealed class ScriptSourceResolver : SourceFileResolver：定义了 ScriptSourceResolver 类，用于解析脚本的源文件。

      4. Func _ReadFunc;：私有字段，用于存储读取文件的方法。

      5. 构造函数 ScriptSourceResolver(string baseDirectory, Func readFunc)：初始化脚本源文件解析器的构造函数，设置基本目录和读取文件的方法。

      6. public override Stream OpenRead(string resolvedPath) 方法：重写了基类的打开读取方法，根据解析后的文件路径调用存储的读取文件方法获取文件流。

      以上是 ScriptSourceResolver 类的代码及其注释说明。

      22.

      1. using System;
      2. using System.Diagnostics;
      3. using Macad.Core.Topology;
      4.  
      5. namespace Macad.Core
      6. {
      7.     public class DataBlobUndoAction : UndoAction
      8.     {
      9.         byte[] _StoredData;
      10.  
      11.         //--------------------------------------------------------------------------------------------------
      12.  
      13.         public DataBlobUndoAction(Guid instanceGuid)
      14.         {
      15.             InstanceGuid = instanceGuid;
      16.         }
      17.  
      18.         //--------------------------------------------------------------------------------------------------
      19.  
      20.         public bool Set(IUndoableDataBlob dataBlobOwner)
      21.         {
      22.             InstanceGuid = dataBlobOwner.Guid;
      23.  
      24.             var data = dataBlobOwner.GetUndoDataBlob();
      25.             if (data != null)
      26.             {
      27.                 _StoredData = data;
      28.                 //Debug.WriteLine(_StoredData);
      29.                 return true;
      30.             }
      31.             return false;
      32.         }
      33.  
      34.         //--------------------------------------------------------------------------------------------------
      35.  
      36.         public override void Restore(Entity instance, UndoHandler undoHandler)
      37.         {
      38.             var dataBlobOwner = instance as IUndoableDataBlob;
      39.             Debug.Assert(dataBlobOwner != null);
      40.  
      41.             dataBlobOwner.SetUndoDataBlob(_StoredData);
      42.         }
      43.     }
      44. }

      逐行注释和说明如下：

      1. using 指令：引入了必要的命名空间。

      2. namespace Macad.Core：定义了 Macad.Core 命名空间，包含了整个类的定义。

      3. public class DataBlobUndoAction : UndoAction：定义了 DataBlobUndoAction 类，表示数据块撤销操作。

      4. _StoredData：私有字段，存储撤销操作的数据块。

      5. 构造函数 DataBlobUndoAction(Guid instanceGuid)：初始化具有指定实例 GUID 的 DataBlobUndoAction 类的新实例。

      6. public bool Set(IUndoableDataBlob dataBlobOwner) 方法：设置数据块的撤销操作，参数为拥有数据块的对象。

      7. public override void Restore(Entity instance, UndoHandler undoHandler) 方法：重写了基类的恢复方法，用于恢复撤销的操作。

      以上是 DataBlobUndoAction 类的代码及其注释说明。

      23.

      1. using System;
      2.  
      3. namespace Macad.Core
      4. {
      5.     /// 
      6.     /// 定义了可撤销数据块的接口。
      7.     /// 
      8.     public interface IUndoableDataBlob
      9.     {
      10.         /// 
      11.         /// 获取数据块的 GUID。
      12.         /// 
      13.         Guid Guid { get; }
      14.  
      15.         /// 
      16.         /// 获取数据块的撤销数据。
      17.         /// 
      18.         /// 表示数据块的字节数组。
      19.         byte[] GetUndoDataBlob();
      20.  
      21.         /// 
      22.         /// 设置数据块的撤销数据。
      23.         /// 
      24.         /// 要设置的数据块的字节数组。
      25.         void SetUndoDataBlob(byte[] dataBlob);
      26.     }
      27. }

      逐行注释和说明如下：

      1. using 指令：引入了必要的命名空间。

      2. namespace Macad.Core：定义了 Macad.Core 命名空间，包含了整个接口的定义。

      3. public interface IUndoableDataBlob：定义了 IUndoableDataBlob 接口，表示可撤销数据块的接口。

      4. Guid Guid { get; } 属性：获取数据块的唯一标识符（GUID）。

      5. byte[] GetUndoDataBlob() 方法：获取数据块的撤销数据，返回表示数据块的字节数组。

      6. void SetUndoDataBlob(byte[] dataBlob) 方法：设置数据块的撤销数据，参数为要设置的数据块的字节数组。

      以上是 IUndoableDataBlob 接口的代码及其注释说明。

      24.

      1. using System;
      2. using Macad.Core.Topology;
      3.  
      4. namespace Macad.Core
      5. {
      6.     /// 
      7.     /// 定义了可撤销拓扑操作的接口。
      8.     /// 
      9.     public interface IUndoableTopology
      10.     {
      11.         /// 
      12.         /// 获取拓扑操作的唯一标识符（GUID）。
      13.         /// 
      14.         Guid Guid { get; }
      15.  
      16.         /// 
      17.         /// 根据实例的 GUID 查找实体。
      18.         /// 
      19.         /// 要查找的实例的 GUID。
      20.         /// 找到的实体，如果未找到则为 null。
      21.         Entity FindInstance(Guid instanceGuid);
      22.  
      23.         /// 
      24.         /// 获取实例的父实体。
      25.         /// 
      26.         /// 要获取父实体的实例。
      27.         /// 实例的父实体。
      28.         Entity GetParent(Entity instance);
      29.  
      30.         /// 
      31.         /// 从撤销操作中添加子实体。
      32.         /// 
      33.         /// 要添加的子实体。
      34.         /// 子实体的父实体。
      35.         void AddChildFromUndo(Entity instance, Entity parent);
      36.  
      37.         /// 
      38.         /// 从撤销操作中移除子实体。
      39.         /// 
      40.         /// 要移除的子实体。
      41.         void RemoveChildFromUndo(Entity instance);
      42.  
      43.         /// 
      44.         /// 从撤销操作中移动子实体到新的父实体。
      45.         /// 
      46.         /// 要移动的子实体。
      47.         /// 子实体的新父实体。
      48.         void MoveChildFromUndo(Entity instance, Entity newParent);
      49.     }
      50. }

      逐行注释和说明如下：

      1. using 指令：引入了必要的命名空间。

      2. namespace Macad.Core：定义了 Macad.Core 命名空间，包含了整个接口的定义。

      3. public interface IUndoableTopology：定义了 IUndoableTopology 接口，表示可撤销拓扑操作的接口。

      4. Guid Guid { get; } 属性：获取拓扑操作的唯一标识符（GUID）。

      5. Entity FindInstance(Guid instanceGuid) 方法：根据实例的 GUID 查找实体。

      6. Entity GetParent(Entity instance) 方法：获取实例的父实体。

      7. void AddChildFromUndo(Entity instance, Entity parent) 方法：从撤销操作中添加子实体。

      8. void RemoveChildFromUndo(Entity instance) 方法：从撤销操作中移除子实体。

      9. void MoveChildFromUndo(Entity instance, Entity newParent) 方法：从撤销操作中移动子实体到新的父实体。

      以上是 IUndoableTopology 接口的代码及其注释说明。

      25.

      1. using System;
      2. using System.Collections.Generic;
      3. using System.Linq;
      4. using System.Reflection;
      5. using System.Runtime.InteropServices;
      6. using Macad.Core.Topology;
      7.  
      8. namespace Macad.Core
      9. {
      10.     /// 
      11.     /// 表示属性的撤销操作。
      12.     /// 
      13.     public class PropertyUndoAction : UndoAction
      14.     {
      15.         //--------------------------------------------------------------------------------------------------
      16.  
      17.         /// 
      18.         /// 表示属性值的更改。
      19.         /// 
      20.         class PropertyValueChange
      21.         {
      22.             readonly PropertyInfo _PropertyInfo; // 属性信息
      23.             object _Value; // 属性值
      24.             bool _IsEntityReference; // 属性是否引用了实体
      25.  
      26.             //--------------------------------------------------------------------------------------------------
      27.  
      28.             /// 
      29.             /// 构造函数，初始化 PropertyValueChange 的新实例。
      30.             /// 
      31.             /// 要更改的属性信息。
      32.             public PropertyValueChange(PropertyInfo propertyInfo)
      33.             {
      34.                 _PropertyInfo = propertyInfo;
      35.                 _IsEntityReference = typeof(Entity).IsAssignableFrom(_PropertyInfo.DeclaringType)
      36.                                      && typeof(Entity).IsAssignableFrom(_PropertyInfo.PropertyType);
      37.             }
      38.  
      39.             //--------------------------------------------------------------------------------------------------
      40.  
      41.             /// 
      42.             /// 判断属性是否相等。
      43.             /// 
      44.             /// 要比较的属性信息。
      45.             /// 如果属性相等，则为 true，否则为 false。
      46.             public bool IsEqual(PropertyInfo propInfo)
      47.             {
      48.                 return _PropertyInfo.Equals(propInfo);
      49.             }
      50.  
      51.             //--------------------------------------------------------------------------------------------------
      52.  
      53.             /// 
      54.             /// 更新属性的值。
      55.             /// 
      56.             /// 属性所在的实例。
      57.             /// 要设置的属性值。
      58.             public void Update(object instance, object value = null)
      59.             {
      60.                 if (value != null)
      61.                 {
      62.                     _Value = value;
      63.                 }
      64.                 else
      65.                 {
      66.                     if (_IsEntityReference)
      67.                     {
      68.                         // 仅保存引用
      69.                         var entity = _PropertyInfo.GetValue(instance) as Entity;
      70.                         _Value = entity?.Guid;
      71.                     }
      72.                     else
      73.                     {
      74.                         _Value = _PropertyInfo.GetValue(instance);
      75.                     }
      76.                 }
      77.             }
      78.  
      79.             //--------------------------------------------------------------------------------------------------
      80.  
      81.             /// 
      82.             /// 还原属性的值。
      83.             /// 
      84.             /// 属性所在的实例。
      85.             public void RestoreValue(object instance)
      86.             {
      87.                 if (_IsEntityReference)
      88.                 {
      89.                     // 通过引用还原
      90.                     var document = (instance as Entity)?.Document;
      91.                     if (document != null && _Value != null && _Value is Guid guid)
      92.                     {
      93.                         _PropertyInfo.SetValue(instance, document.FindInstance(guid));
      94.                     }
      95.                     else
      96.                     {
      97.                         _PropertyInfo.SetValue(instance, null);
      98.                     }
      99.                 }
      100.                 else
      101.                 {
      102.                     _PropertyInfo.SetValue(instance, _Value);
      103.                 }
      104.             }
      105.  
      106.             //--------------------------------------------------------------------------------------------------
      107.         }
      108.  
      109.         //--------------------------------------------------------------------------------------------------
      110.         //--------------------------------------------------------------------------------------------------
      111.  
      112.         readonly List _ChangeList = new List(); // 属性值更改列表
      113.  
      114.         //--------------------------------------------------------------------------------------------------
      115.  
      116.         /// 
      117.         /// 初始化 PropertyUndoAction 类的新实例。
      118.         /// 
      119.         /// 操作实例的 GUID。
      120.         public PropertyUndoAction(Guid instanceGuid)
      121.         {
      122.             InstanceGuid = instanceGuid;
      123.         }
      124.  
      125.         //--------------------------------------------------------------------------------------------------
      126.  
      127.         /// 
      128.         /// 设置属性的撤销操作。
      129.         /// 
      130.         /// 要设置的属性信息。
      131.         /// 属性所在的实例。
      132.         /// 要设置的属性值。
      133.         public void Set(PropertyInfo propertyInfo, Entity instance, object value = null)
      134.         {
      135.             // 注意：只保存第一个值更改，否则原始状态将会丢失。
      136.             var change = _ChangeList.FirstOrDefault(pvc => pvc.IsEqual(propertyInfo));
      137.                 
      138.             if(change != null)
      139.                 return;
      140.  
      141.             change = new PropertyValueChange(propertyInfo);
      142.             change.Update(instance, value);
      143.             _ChangeList.Add(change);
      144.         }
      145.  
      146.         //--------------------------------------------------------------------------------------------------
      147.  
      148.         /// 
      149.         /// 还原属性的撤销操作。
      150.         /// 
      151.         /// 操作实例。
      152.         /// 撤销处理程序。
      153.         public override void Restore(Entity instance, UndoHandler undoHandler)
      154.         {
      155.             _ChangeList.ForEach( change => change.RestoreValue(instance));
      156.  
      157.             var shape = instance as Shapes.Shape;
      158.             shape?.Invalidate();
      159.         }
      160.  
      161.         //--------------------------------------------------------------------------------------------------
      162.  
      163.     }
      164. }

      逐行注释和说明如下：

      1. using 指令：引入了必要的命名空间。

      2. namespace Macad.Core：定义了 Macad.Core 命名空间，包含了整个类的定义。

      3. public class PropertyUndoAction : UndoAction：定义了表示属性撤销操作的 PropertyUndoAction 类。

      4. class PropertyValueChange：表示属性值的更改，是 PropertyUndoAction 类的嵌套类。

      5. readonly List _ChangeList = new List();：属性值更改列表，用于保存属性值的更改。

      6. public PropertyUndoAction(Guid instanceGuid)：PropertyUndoAction 类的构造函数，初始化实例的 GUID。

      7. public void Set(PropertyInfo propertyInfo, Entity instance, object value = null)：设置属性的撤销操作，记录属性值的更改。

      8. public override void Restore(Entity instance, UndoHandler undoHandler)：还原属性的撤销操作，将属性值还原到之前的状态，并在需要时更新形状的无效状态。

      以上是 PropertyUndoAction 类的代码及其注释说明。

      26.

      1. using System;
      2. using System.Diagnostics;
      3. using Macad.Core.Topology;
      4. using Macad.Common.Serialization;
      5. using Macad.Core.Shapes;
      6. using Macad.Common;
      7.  
      8. namespace Macad.Core
      9. {
      10.     /// 
      11.     /// 表示拓扑操作的撤销动作。
      12.     /// 
      13.     public class TopologyUndoAction : UndoAction
      14.     {
      15.         string _StoredData; // 存储的数据
      16.         UndoHandler.TopologyAction _TopoAction; // 拓扑操作类型
      17.         Guid _ChildGuid; // 子实体的 GUID
      18.         Guid? _ParentGuid; // 父实体的 GUID
      19.  
      20.         //--------------------------------------------------------------------------------------------------
      21.  
      22.         /// 
      23.         /// 初始化 TopologyUndoAction 类的新实例。
      24.         /// 
      25.         /// 实例的 GUID。
      26.         public TopologyUndoAction(Guid instanceGuid)
      27.         {
      28.             InstanceGuid = instanceGuid;
      29.         }
      30.  
      31.         //--------------------------------------------------------------------------------------------------
      32.  
      33.         /// 
      34.         /// 设置拓扑操作的撤销动作。
      35.         /// 
      36.         /// 子实体。
      37.         /// 包含子实体的容器。
      38.         /// 拓扑操作类型。
      39.         /// 如果设置成功，则为 true，否则为 false。
      40.         public bool Set(Entity child, IUndoableTopology container, UndoHandler.TopologyAction action)
      41.         {
      42.             _ChildGuid = child.Guid;
      43.             InstanceGuid = container.Guid;
      44.  
      45.             _ParentGuid = null;
      46.             var parent = container.GetParent(child);
      47.             if (parent != null)
      48.                 _ParentGuid = parent.Guid;
      49.  
      50.             _TopoAction = action;
      51.             _StoredData = null;
      52.  
      53.             switch (action)
      54.             {
      55.                 case UndoHandler.TopologyAction.Added:
      56.                     // 逆操作：移除。我们只需要实例以便稍后移除。
      57.                     return true;
      58.  
      59.                 case UndoHandler.TopologyAction.Removed:
      60.                     // 逆操作：添加。我们需要实例、父实体和其数据以便稍后添加。
      61.                     var data = Serializer.Serialize(child, new SerializationContext(SerializationScope.UndoRedo));
      62.                     if (!data.IsNullOrEmpty())
      63.                     {
      64.                         _StoredData = data;
      65.                         return true;
      66.                     }
      67.                     break;
      68.  
      69.                 case UndoHandler.TopologyAction.Moved:
      70.                     // 逆操作：移动回。我们需要实例和父实体。
      71.                     return true;
      72.             }
      73.  
      74.             return false;
      75.         }
      76.  
      77.         //--------------------------------------------------------------------------------------------------
      78.  
      79.         /// 
      80.         /// 还原拓扑操作的撤销动作。
      81.         /// 
      82.         /// 操作实例。
      83.         /// 撤销处理程序。
      84.         public override void Restore(Entity instance, UndoHandler undoHandler)
      85.         {
      86.             var container = undoHandler.FindEntityInstance(InstanceGuid) as IUndoableTopology;
      87.             Debug.Assert(container != null, "container != null");
      88.  
      89.             var child = undoHandler.FindEntityInstance(_ChildGuid);
      90.             var parent = _ParentGuid.HasValue ? undoHandler.FindEntityInstance(_ParentGuid.Value) : null;
      91.  
      92.             switch (_TopoAction)
      93.             {
      94.                 case UndoHandler.TopologyAction.Added:
      95.                     Debug.Assert(child != null);
      96.  
      97.                     // 逆操作：移除。
      98.                     container.RemoveChildFromUndo(child);
      99.                     break;
      100.  
      101.                 case UndoHandler.TopologyAction.Removed:
      102.                     Debug.Assert(child == null);
      103.  
      104.                     // 逆操作：添加。
      105.                     var context = new SerializationContext(SerializationScope.UndoRedo);
      106.                     context.SetInstance(CoreContext.Current.Document);
      107.                     context.SetInstance(CoreContext.Current.Document);
      108.                     context.SetInstance(CoreContext.Current.Workspace);
      109.  
      110.                     child = Serializer.Deserialize(_StoredData, context);
      111.                     if (child != null)
      112.                     {
      113.                         container.AddChildFromUndo(child, parent);
      114.                         
      115.                         // 更新可视化状态
      116.                         foreach(var entity in context.GetInstanceList())
      117.                             entity.RaiseVisualChanged();
      118.                     }
      119.                     break;
      120.  
      121.                 case UndoHandler.TopologyAction.Moved:
      122.                     Debug.Assert(child != null);
      123.  
      124.                     // 逆操作：移动回。
      125.                     undoHandler.AddTopologyChange(UndoHandler.TopologyAction.Moved, container, child);
      126.  
      127.                     container.MoveChildFromUndo(child, parent);
      128.                     break;
      129.             }
      130.         }
      131.     }
      132. }

      逐行注释和说明如下：

      1. using 指令：引入了必要的命名空间。

      2. namespace Macad.Core：定义了 Macad.Core 命名空间，包含了整个类的定义。

      3. public class TopologyUndoAction : UndoAction：定义了表示拓扑操作的撤销动作的 TopologyUndoAction 类。

      4. string _StoredData;：存储数据，用于保存被移除的实体的数据。

      5. UndoHandler.TopologyAction _TopoAction;：拓扑操作类型，表示进行的拓扑操作。

      6. Guid _ChildGuid;：子实体的 GUID。

      7. Guid? _ParentGuid;：父实体的 GUID。

      8. public TopologyUndoAction(Guid instanceGuid)：TopologyUndoAction 类的构造函数，初始化实例的 GUID。

      9. public bool Set(Entity child, IUndoableTopology container, UndoHandler.TopologyAction action)：设置拓扑操作的撤销动作，记录进行的拓扑操作及相关信息。

      10. public override void Restore(Entity instance, UndoHandler undoHandler)：还原拓扑操作的撤销动作，执行相应的逆操作，并在需要时更新可视化状态。

      27.

      1. using System;
      2. using Macad.Core.Topology;
      3.  
      4. namespace Macad.Core
      5. {
      6.     /// 
      7.     /// 表示撤销动作的抽象基类。
      8.     /// 
      9.     public abstract class UndoAction
      10.     {
      11.         /// 
      12.         /// 获取或设置实例的 GUID。
      13.         /// 
      14.         public Guid InstanceGuid { get; protected set; }
      15.  
      16.         /// 
      17.         /// 还原撤销动作。
      18.         /// 
      19.         /// 应用撤销动作的实例。
      20.         /// 撤销处理程序。
      21.         public abstract void Restore(Entity instance, UndoHandler undoHandler);
      22.     }
      23. }

      逐行注释和说明如下：

      1. using 指令：引入了必要的命名空间。

      2. namespace Macad.Core：定义了 Macad.Core 命名空间，包含了整个类的定义。

      3. public abstract class UndoAction：定义了表示撤销动作的抽象基类 UndoAction。

      4. public Guid InstanceGuid { get; protected set; }：表示实例的 GUID 属性，用于标识要执行撤销动作的实例。

      5. public abstract void Restore(Entity instance, UndoHandler undoHandler);：抽象方法，表示还原撤销动作的操作，需要由派生类实现具体的还原逻辑。

      28.

      1. using System;
      2. using System.Collections.Generic;
      3. using System.Linq;
      4. using System.Reflection;
      5. using System.Runtime.CompilerServices;
      6. using Macad.Core.Topology;
      7. using Macad.Common;
      8. using Macad.Common.Serialization;
      9.  
      10. namespace Macad.Core
      11. {
      12.     /// 
      13.     /// 处理撤销和重做操作的管理器。
      14.     /// 
      15.     public class UndoHandler : BaseObject
      16.     {
      17.         #region Enums
      18.  
      19.         /// 
      20.         /// 表示拓扑操作的枚举。
      21.         /// 
      22.         public enum TopologyAction
      23.         {
      24.             Added,
      25.             Removed,
      26.             Moved
      27.         }
      28.  
      29.         #endregion
      30.  
      31.         #region Properties
      32.  
      33.         /// 
      34.         /// 获取一个值，该值指示是否可以执行撤销操作。
      35.         /// 
      36.         public bool CanUndo
      37.         {
      38.             get { return _UndoStack.Count > 0; }
      39.         }
      40.  
      41.         /// 
      42.         /// 获取一个值，该值指示是否可以执行重做操作。
      43.         /// 
      44.         public bool CanRedo
      45.         {
      46.             get { return _RedoStack.Count > 0; }
      47.         }
      48.  
      49.         /// 
      50.         /// 获取用于存储撤销操作的栈。
      51.         /// 
      52.         public LimitedStack UndoStack
      53.         {
      54.             get { return _UndoStack; }
      55.         }
      56.  
      57.         /// 
      58.         /// 获取用于存储重做操作的栈。
      59.         /// 
      60.         public LimitedStack RedoStack
      61.         {
      62.             get { return _RedoStack; }
      63.         }
      64.  
      65.         #endregion
      66.  
      67.         readonly IUndoableTopology _Document;
      68.         readonly LimitedStack _RedoStack;
      69.         readonly LimitedStack _UndoStack;
      70.         readonly List _PendingActions = new List();
      71.         bool _IsRestoring;
      72.  
      73.         //--------------------------------------------------------------------------------------------------
      74.  
      75.         /// 
      76.         /// 初始化  类的新实例。
      77.         /// 
      78.         /// 撤销处理器所属的文档。
      79.         public UndoHandler(IUndoableTopology document)
      80.         {
      81.             _Document = document;
      82.             _UndoStack = new LimitedStack(500);
      83.             _RedoStack = new LimitedStack(500);
      84.         }
      85.  
      86.         //--------------------------------------------------------------------------------------------------
      87.  
      88.         /// 
      89.         /// 引发属性更改事件。
      90.         /// 
      91.         void RaisePropertyChanged()
      92.         {
      93.             RaisePropertyChanged("CanUndo");
      94.             RaisePropertyChanged("CanRedo");
      95.         }
      96.  
      97.         //--------------------------------------------------------------------------------------------------
      98.  
      99.         /// 
      100.         /// 提交挂起的撤销操作。
      101.         /// 
      102.         public void Commit()
      103.         {
      104.             if (!_IsRestoring)
      105.             {
      106.                 Commit(false);
      107.                 _RedoStack.Clear();
      108.             }
      109.         }
      110.  
      111.         //--------------------------------------------------------------------------------------------------
      112.  
      113.         /// 
      114.         /// 提交挂起的撤销操作。
      115.         /// 
      116.         /// 指示是否提交到重做操作的栈。
      117.         void Commit(bool toRedoStack)
      118.         {
      119.             var stack = toRedoStack ? _RedoStack : _UndoStack;
      120.             if (_PendingActions.Count > 0)
      121.             {
      122.                 // 反转动作列表以便首先撤销最后一个动作
      123.                 _PendingActions.Reverse();
      124.                 stack.Push(_PendingActions.ToArray());
      125.                 _PendingActions.Clear();
      126.             }
      127.         }
      128.  
      129.         //--------------------------------------------------------------------------------------------------
      130.  
      131.         /// 
      132.         /// 添加属性更改的撤销操作。
      133.         /// 
      134.         /// 发生属性更改的实例。
      135.         /// 更改的属性名称。
      136.         /// 属性的克隆值。
      137.         public void AddPropertyChange(Entity instance, [CallerMemberName] string propertyName = "", object clone = null)
      138.         {
      139.             var propInfo = instance.GetType().GetProperty(propertyName, BindingFlags.Public | BindingFlags.NonPublic | BindingFlags.Instance);
      140.             if (propInfo == null) 
      141.                 return;
      142.  
      143.             if (!propInfo.GetCustomAttributes(typeof(SerializeMemberAttribute), true).Any())
      144.                 return;
      145.  
      146.             var action = (PropertyUndoAction)_PendingActions.FirstOrDefault(a => a.InstanceGuid.Equals(instance.Guid) && a is PropertyUndoAction);
      147.             if (action == null)
      148.             {
      149.                 action = new PropertyUndoAction(instance.Guid);
      150.                 _PendingActions.Add(action);
      151.             }
      152.             action.Set(propInfo, instance, clone);
      153.         }
      154.  
      155.         //--------------------------------------------------------------------------------------------------
      156.  
      157.         /// 
      158.         /// 添加数据块更改的撤销操作。
      159.         /// 
      160.         /// 数据块实例。
      161.         public void AddDataBlockChange(IUndoableDataBlob instance)
      162.         {
      163.             var action = (DataBlobUndoAction)_PendingActions.FirstOrDefault(a => a.InstanceGuid.Equals(instance.Guid) && a is DataBlobUndoAction);
      164.             if (action != null)
      165.                 return;
      166.  
      167.             action = new DataBlobUndoAction(instance.Guid);
      168.             if (action.Set(instance))
      169.             {
      170.                 _PendingActions.Add(action);
      171.             }
      172.         }
      173.  
      174.         //--------------------------------------------------------------------------------------------------
      175.  
      176.         /// 
      177.         /// 添加拓扑更改的撤销操作。
      178.         /// 
      179.         /// 拓扑操作类型。
      180.         /// 容器实例。
      181.         /// 拓扑实例。
      182.         public void AddTopologyChange(TopologyAction topologyAction, IUndoableTopology container, Entity instance)
      183.         {
      184.             var action = new TopologyUndoAction(container.Guid);
      185.             if (action.Set(instance, container, topologyAction))
      186.             {
      187.                 _PendingActions.Add(action);
      188.             }
      189.         }
      190.  
      191.         //--------------------------------------------------------------------------------------------------
      192.  
      193.         /// 
      194.         /// 执行指定步数的撤销操作。
      195.         /// 
      196.         /// 撤销步数。
      197.         public void DoUndo(int steps)
      198.         {
      199.             while ((steps > 0) && (_UndoStack.Count > 0))
      200.             {
      201.                 Restore(false);
      202.                 steps--;
      203.             }
      204.  
      205.             Commit(true);
      206.             RaisePropertyChanged();
      207.         }
      208.  
      209.         //--------------------------------------------------------------------------------------------------
      210.  
      211.         /// 
      212.         /// 执行指定步数的重做操作。
      213.         /// 
      214.         /// 重做步数。
      215.         public void DoRedo(int steps)
      216.         {
      217.             while ((steps > 0) && (_RedoStack.Count > 0))
      218.             {
      219.                 Restore(true);
      220.                 steps--;
      221.             }
      222.  
      223.             Commit(false);
      224.             RaisePropertyChanged();
      225.         }
      226.  
      227.         //--------------------------------------------------------------------------------------------------
      228.  
      229.         /// 
      230.         /// 还原撤销操作。
      231.         /// 
      232.         /// 指示是否从重做操作的栈中还原。
      233.         void Restore(bool fromRedoStack)
      234.         {
      235.             var stack = fromRedoStack ? _RedoStack : _UndoStack;
      236.  
      237.             _IsRestoring = true;
      238.             var actions = stack.Pop();
      239.             foreach (var action in actions)
      240.             {
      241.                 var instance = FindEntityInstance(action.InstanceGuid);
      242.                 
      243.                 // 如果未找到实例，则跳过，因为它必须是拓扑操作的一部分
      244.                 if(instance == null)
      245.                     continue;
      246.  
      247.                 instance.OnBeforeUndo();
      248.                 action.Restore(instance, this);
      249.                 instance.OnAfterUndo();
      250.             }
      251.             _IsRestoring = false;
      252.         }
      253.  
      254.         //--------------------------------------------------------------------------------------------------
      255.  
      256.         /// 
      257.         /// 根据实例的 GUID 查找实例。
      258.         /// 
      259.         /// 实例的 GUID。
      260.         /// 找到的实例，如果未找到则为 null。
      261.         public Entity FindEntityInstance(Guid instanceGuid)
      262.         {
      263.             return _Document.FindInstance(instanceGuid);
      264.         }
      265.     }
      266. }

      逐行注释和说明如下：

      1. using 指令：引入了必要的命名空间。

      2. namespace Macad.Core：定义了 Macad.Core 命名空间，包含了整个类的定义。

      3. public class UndoHandler : BaseObject：定义了处理撤销和重做操作的管理器 UndoHandler，它继承自 BaseObject 类。

      4. public enum TopologyAction：定义了表示拓扑操作的枚举类型 TopologyAction，包括 Added、Removed 和 Moved。

      5. IUndoableTopology _Document：存储撤销处理器所属的文档。

      6. LimitedStack _RedoStack 和 LimitedStack _UndoStack：分别用于存储重做操作和撤销操作的栈。

      7. List _PendingActions：存储待提交的撤销动作列表。

      8. public UndoHandler(IUndoableTopology document)：构造函数，初始化撤销处理器。

      9. void RaisePropertyChanged()：引发属性更改事件。

      10. public void Commit() 和 void Commit(bool toRedoStack)：提交挂起的撤销操作。

      11. public void AddPropertyChange(Entity instance, [CallerMemberName] string propertyName = "", object clone = null)：添加属性更改的撤销操作。

      12. public void AddDataBlockChange(IUndoableDataBlob instance)：添加数据块更改的撤销操作。

      13. public void AddTopologyChange(TopologyAction topologyAction, IUndoableTopology container, Entity instance)：添加拓扑更改的撤销操作。

      14. public void DoUndo(int steps) 和 public void DoRedo(int steps)：执行指定步数的撤销和重做操作。

      15. void Restore(bool fromRedoStack)：还原撤销操作。

      16. public Entity FindEntityInstance(Guid instanceGuid)：根据实例的 GUID 查找实例。

      29.

      1. using System.IO;
      2. using System.Text;
      3. using Macad.Common;
      4.  
      5. namespace Macad.Core
      6. {
      7.     /// 
      8.     /// 抽象类，表示剪贴板操作。
      9.     /// 
      10.     public abstract class Clipboard
      11.     {
      12.         /// 
      13.         /// 获取或设置当前剪贴板实例。
      14.         /// 
      15.         public static Clipboard Current { get; protected set; }
      16.  
      17.         /// 
      18.         /// 检查剪贴板中是否包含指定格式的数据。
      19.         /// 
      20.         /// 数据格式。
      21.         /// 如果剪贴板中包含指定格式的数据，则为 true；否则为 false。
      22.         public abstract bool ContainsData(in string format);
      23.  
      24.         /// 
      25.         /// 从剪贴板中获取指定格式的数据流。
      26.         /// 
      27.         /// 数据格式。
      28.         /// 数据流。
      29.         public abstract MemoryStream GetDataStream(in string format);
      30.  
      31.         /// 
      32.         /// 将数据写入剪贴板。
      33.         /// 
      34.         /// 数据格式。
      35.         /// 数据流。
      36.         public abstract void SetData(in string format, in MemoryStream data);
      37.  
      38.         //--------------------------------------------------------------------------------------------------
      39.  
      40.         /// 
      41.         /// 将字符串数据写入剪贴板。
      42.         /// 
      43.         /// 数据格式。
      44.         /// 字符串数据。
      45.         public void SetData(in string format, in string data)
      46.         {
      47.             SetData(format, new MemoryStream(Encoding.Unicode.GetBytes(data)));
      48.         }
      49.  
      50.         /// 
      51.         /// 从剪贴板中获取指定格式的数据并转换为字符串。
      52.         /// 
      53.         /// 数据格式。
      54.         /// 数据字符串。
      55.         public string GetDataAsString(in string format)
      56.         {
      57.             var memstream = GetDataStream(format);
      58.  
      59.             return Encoding.Unicode.GetString(memstream.ToArray());
      60.         }
      61.     }
      62. }

      逐行注释和说明如下：

      1. using 指令：引入了必要的命名空间。

      2. namespace Macad.Core：定义了 Macad.Core 命名空间，包含了整个类的定义。

      3. public abstract class Clipboard：定义了抽象类 Clipboard，表示剪贴板操作。

      4. public static Clipboard Current { get; protected set; }：获取或设置当前剪贴板实例。

      5. public abstract bool ContainsData(in string format)：抽象方法，检查剪贴板中是否包含指定格式的数据。

      6. public abstract MemoryStream GetDataStream(in string format)：抽象方法，从剪贴板中获取指定格式的数据流。

      7. public abstract void SetData(in string format, in MemoryStream data)：抽象方法，将数据写入剪贴板。

      8. public void SetData(in string format, in string data)：将字符串数据写入剪贴板。

      9. public string GetDataAsString(in string format)：从剪贴板中获取指定格式的数据并转换为字符串。

    16. 相关阅读:
      HEVC熵编码核心点介绍
      shell脚本任务
      PAM从入门到精通（二）
      线上问题处理案例：出乎意料的数据库连接池
      AS400 API 从零到一的整个历程
      测试猿送分题： 电商项目如何测试？聪明人这么回答
      CSS复合选择器（二）
      简单学懂链式编程
      【EMQX】 Spring Cloud 集成MQTT并异步入库（mongodb）
      4.无约束优化问题基本公式
    17. 原文地址：https://blog.csdn.net/m0_53082780/article/details/136221116