dimine-python-sdk 0.1.8__py3-none-any.whl

dimine_python_sdk/lib/types/line.py

@@ -0,0 +1,188 @@
+import DmPyBindInterface as Dm
+from dimine_python_sdk.lib.types.point import DmDPoint
+
+#线实体
+class DmDbLine:
+    """线类型"""
+    def __init__(self):
+        """构造函数，初始化数据库线对象"""
+        self._obj = Dm.dmDbLine()
+
+    def get_graph_data(self) -> list[DmDPoint]:
+        """
+        获取该线的图形数据（起点和终点）
+        :return: 包含起点和终点的列表，每个元素为DmDPoint实例
+
+        example:
+        ```python
+        line = DmDbLine()
+        graph_data = line.get_graph_data()
+        print("线的起点:", graph_data[0])
+        print("线的终点:", graph_data[1])
+        ```
+        """
+        cpp_list = self._obj.GetGraphData()
+        return [DmDPoint._from_obj(item) for item in cpp_list]
+
+    @classmethod
+    def _from_obj(cls, obj):
+        """
+        :param obj: 原生dmDbLine对象
+        :return: DmDbLine实例
+        """
+        instance = cls.__new__(cls)
+        instance._obj = obj
+        return instance
+
+#三维多段线实体
+class DmDbPolyline:
+    """三维多段线类型"""
+
+    def __init__(self):
+        """
+        构造函数
+        :return: None
+        """
+        self._obj = Dm.dmDbPolyline()
+
+    def get_graph_data(self) -> list[DmDPoint]:
+        """
+        获取多段线的所有顶点坐标
+        :return: 顶点列表，每个元素为DmDPoint实例
+
+        example:
+        ```python
+        polyline = DmDbPolyline()
+        graph_data = polyline.get_graph_data()
+        for point in graph_data:
+            print(point)
+        ```
+        """
+        cpp_list = self._obj.GetGraphData()
+        return [DmDPoint._from_obj(item) for item in cpp_list]
+
+    def __repr__(self) -> str:
+        """
+        字符串表示
+        :return: 多段线的标准字符串表示
+        """
+        return self._obj.__repr__()
+
+    def set_color(self, red: int, green: int, blue: int) -> None:
+        """
+        设置多段线的颜色
+        :param red: 红色分量（0-255）
+        :param green: 绿色分量（0-255）
+        :param blue: 蓝色分量（0-255）
+        :return: None
+
+        example:
+        ```python
+        polyline = DmDbPolyline()
+        polyline.set_color(255, 0, 0)  # 设置为红色
+        ```
+        """
+        self._obj.SetColor(red, green, blue)
+
+    def is_closed(self, tolerance: float = 1e-10) -> bool:
+        """
+        判断多段线是否闭合（起点与终点在容差范围内重合）
+        :param tolerance: 浮点容差阈值，默认1e-10
+        :return: 闭合返回True，否则返回False
+
+        example:
+        ```python
+        polyline = DmDbPolyline()
+        is_closed = polyline.is_closed()
+        if is_closed:
+            print("多段线闭合")
+        else:
+            print("多段线不闭合")
+        ```
+        """
+        return self._obj.IsClosed(tolerance)
+
+    @classmethod
+    def _from_obj(cls, obj):
+        """
+        :param obj: 原生dmDbPolyline对象
+        :return: DmDbPolyline实例
+        """
+        instance = cls.__new__(cls)
+        instance._obj = obj
+        return instance
+
+#矩阵变换
+class DmMatrix4x4:
+    """二次封装dmMatrix4x4New类"""
+    def __init__(self):
+        """构造函数，初始化4x4矩阵"""
+        self._obj = Dm.dmMatrix4x4()
+
+    def align_coord_sys(
+        self,
+        from_origin: DmDPoint,
+        from_x_axis: DmDPoint,
+        from_y_axis: DmDPoint,
+        from_z_axis: DmDPoint,
+        to_origin: DmDPoint,
+        to_x_axis: DmDPoint,
+        to_y_axis: DmDPoint,
+        to_z_axis: DmDPoint
+    ) -> None:
+        """
+        对齐坐标系，将一个坐标系映射到另一个坐标系
+        :param from_origin: 源坐标系原点（DmDPoint实例）
+        :param from_x_axis: 源坐标系X轴方向（DmDPoint实例）
+        :param from_y_axis: 源坐标系Y轴方向（DmDPoint实例）
+        :param from_z_axis: 源坐标系Z轴方向（DmDPoint实例）
+        :param to_origin: 目标坐标系原点（DmDPoint实例）
+        :param to_x_axis: 目标坐标系X轴方向（DmDPoint实例）
+        :param to_y_axis: 目标坐标系Y轴方向（DmDPoint实例）
+        :param to_z_axis: 目标坐标系Z轴方向（DmDPoint实例）
+        :return: None
+
+        example:
+        ```python
+        matrix = DmMatrix4x4()
+        matrix.align_coord_sys(
+            from_origin=DmDPoint(0, 0, 0),
+            from_x_axis=DmDPoint(1, 0, 0),
+            from_y_axis=DmDPoint(0, 1, 0),
+            from_z_axis=DmDPoint(0, 0, 1),
+            to_origin=DmDPoint(100, 100, 100),
+            to_x_axis=DmDPoint(0, 0, 1),
+            to_y_axis=DmDPoint(0, 1, 0),
+            to_z_axis=DmDPoint(1, 0, 0)
+        )
+        ```
+        """
+        self._obj.AlignCoordSys(
+            from_origin._obj,
+            from_x_axis._obj,
+            from_y_axis._obj,
+            from_z_axis._obj,
+            to_origin._obj,
+            to_x_axis._obj,
+            to_y_axis._obj,
+            to_z_axis._obj
+        )
+
+    def transform_point(self, pt_source: DmDPoint) -> DmDPoint:
+        """
+        对三维点应用矩阵变换
+        :param pt_source: 待变换的源点（DmDPoint实例）
+        :return: 变换后的点（DmDPoint实例）
+
+        example:
+        ```python
+        matrix = DmMatrix4x4()
+        pt = DmDPoint(1, 2, 3)
+        transformed_pt = matrix.transform_point(pt)
+        print("变换后的点:", transformed_pt)
+        ```
+        """
+        cpp_result = self._obj.TransformPoint(pt_source._obj)
+        result = DmDPoint()
+        result._obj = cpp_result
+        return result