code-painter 1.0.0__py3-none-any.whl

/321/207/320/265/320/256/321/207/320/274/320/244/321/207/320/260/320/221/321/211/320/255/320/243//321/207/320/265/320/256/321/207/320/274/320/244/321/205/342/225/221/320/243//321/205/320/225/320/223/321/207/342/224/244/320/260/321/205/342/225/221/320/243//321/205/320/225/320/223/321/207/342/224/244/320/260_/321/210/342/225/226/320/277/321/205/342/225/233/320/224/321/206/320/246/320/227/321/205/320/275/320/247.py

@@ -0,0 +1,119 @@
+# -*- coding:utf-8 -*-
+# title           :
+# description     :
+# author          :Python超人/三月三提供
+# date            :2024-06-01
+# link            :https://gitee.com/march3
+# python_version  :3.9
+# ==============================================================================
+import os
+import svgwrite
+
+from 神笔码靓.神笔库.神笔绘图板工具 import 神笔绘图板工具
+from 神笔码靓.神笔库.定义集 import *
+from 神笔码靓.神笔库.元素库 import 可变换元素, 元素位置信息, 样式可修改元素
+
+
+class 路径文字元素(可变换元素, 样式可修改元素):
+
+    def 获取元素范围(self):
+        return self.获取路径点列表范围()
+
+    def 字旋转(self, 旋转角度: float):
+        self.设置属性值("字旋转", 旋转角度)
+        return self
+
+    def 构建文字(self):
+        粗体, 斜体, 下划线, 字符间距 = self.批量获取属性(["粗体", "斜体", "下划线", "字符间距"])
+        style = self.样式.文字样式生成(粗体, 斜体, 下划线, 字符间距)
+
+        P = self.获取属性值
+        C = self.获取颜色值
+        t = self.dwg.text("", insert=(0, 0), fill=C("填充颜色"),
+                          font_size=P("字体大小"),
+                          style=style,
+                          text_anchor=P("水平基线对齐"),
+                          stroke=C("描边颜色"), stroke_width=P("描边宽度"),
+                          # alignment_baseline=P("垂直基线对齐"),
+                          font_family=P("字体"),
+                          # opacity=P("透明度", 1),
+                          id=self.获取元素id(t="t"))
+
+        self.属性修改处理(t)
+
+        # 透明度 = P("透明度", 1)
+        # if 透明度 != 1:
+        #     t.attribs["opacity"] = 透明度
+        #
+        # _描边样式 = P("描边样式")
+        # if _描边样式 is not None:
+        #     t['stroke-dasharray'] = _描边样式
+        #
+        _字旋转 = P("字旋转", 0)
+        if _字旋转 != 0:
+            t["rotate"] = _字旋转
+
+        return t
+
+    def 构建路径(self):
+        P = self.获取属性值
+        C = self.获取颜色值
+        点列表 = P("点列表")
+        fp = 点列表[0]
+        if fp[0] in ["M", "m"]:
+            t, x, y = fp
+        else:
+            t, x, y = "M", fp[0], fp[1]
+        path = self.dwg.path(d="{}{:.2f},{:.2f} ".format(t, x, y), stroke=C("描边颜色"), fill="none",
+                             stroke_width=0, opacity=P("透明度", 1), shape_rendering='auto',
+                             # stroke_linejoin="arcs",
+                             id=self.获取元素id(t="p"))
+
+        d_list = 神笔绘图板工具.点列表转SVG路径(点列表)
+        # if 转相对坐标:
+        #     d_list = 神笔绘图板工具.绝对坐标转相对坐标(d_list)
+        for di in d_list[1:]:
+            path.push(di)
+
+        if P("闭合", 否):
+            path.push('Z')
+
+        _描边样式 = P("描边样式")
+        if _描边样式 is not None:
+            path['stroke-dasharray'] = _描边样式
+
+        return path
+
+    def 先描边(self):
+        self.样式字符串("paint-order:stroke;")
+        return self
+
+    def 构建SVG元素(self):
+        text = self.构建文字()
+        path = self.构建路径()
+
+        P = self.获取属性值
+
+        # text.letter_spacing = 5
+        if "x" in text.attribs:
+            del text.attribs["x"]
+        if "y" in text.attribs:
+            del text.attribs["y"]
+        if "alignment-baseline" in text.attribs:
+            del text.attribs["alignment-baseline"]
+
+        textpath = self.dwg.textPath(path=path, text=P("文字"), startOffset=P("开始位移"), spacing="auto",
+                                     method="stretch")
+
+        text.add(textpath)
+        _字旋转 = P("字旋转", 0)
+        if _字旋转 != 0:
+            text["rotate"] = _字旋转
+        g = self.dwg.g()
+
+        样式可修改元素.属性修改处理(self, text)
+        可变换元素.属性修改处理(self, text)
+
+        g.add(text)
+        g.add(path)
+        return g

/321/207/320/265/320/256/321/207/320/274/320/244/321/207/320/260/320/221/321/211/320/255/320/243//321/207/320/265/320/256/321/207/320/274/320/244/321/205/342/225/221/320/243//321/205/320/225/320/223/321/207/342/224/244/320/260/321/205/342/225/221/320/243//321/205/320/225/320/223/321/207/342/224/244/320/260_/321/211/320/221/320/276/321/207/342/225/234/320/271.py

@@ -0,0 +1,75 @@
+# -*- coding:utf-8 -*-
+# title           :
+# description     :
+# author          :Python超人/三月三提供
+# date            :2024-06-01
+# link            :https://gitee.com/march3
+# python_version  :3.9
+# ==============================================================================
+import os
+import svgwrite
+
+from 神笔码靓.神笔库.定义集 import *
+from 神笔码靓.神笔库.元素库 import 可变换元素, 元素位置信息
+from 神笔码靓.神笔库.神笔绘图板工具 import 神笔绘图板工具
+
+
+class 遮罩元素(可变换元素):
+
+    def 获取元素范围(self):
+        P = self.获取属性值
+
+        遮罩元素_, 被遮元素 = P("遮罩元素"), P("被遮元素")
+
+        return 遮罩元素_.获取元素范围()
+
+    # def 构建SVG元素(self):
+    #     P = self.获取属性值
+    #     遮罩元素_, 被遮元素 = P("遮罩元素"), P("被遮元素")
+    #     if not isinstance(遮罩元素_, list):
+    #         遮罩元素_ = [遮罩元素_]
+    #
+    #     mask = self.dwg.mask(id=self.获取元素id(t="ma"))
+    #
+    #     for 元素 in 遮罩元素_:
+    #         mask.add(元素.build_svg_element())
+    #
+    #     if 被遮元素 is not None:
+    #         被遮元素.build_svg_element()['mask'] = getattr(mask, "get_funciri")()
+    #
+    #     return mask
+
+    # 遮罩单位 ——“使用用户空间 | 物体边界框”
+    # 定义属性 x、y、宽度和高度所使用的坐标系。
+    # 如果遮罩单位为 “使用用户空间”，那么 x、y、宽度和高度表示在引用遮罩元素时所处的当前用户坐标系中的数值（即通过遮罩属性引用遮罩元素的那个元素的用户坐标系）。
+    # 如果遮罩单位为 “物体边界框”，那么 x、y、宽度和高度表示应用遮罩的元素的边界框的分数或百分比。
+    # 默认值是 “物体边界框”。
+    # 遮罩内容单位 ——“使用用户空间 | 物体边界框”
+    # 定义遮罩内容所使用的坐标系。
+    # 如果遮罩内容单位为 “使用用户空间”，遮罩元素内容的用户坐标系就是在引用遮罩元素时所处的当前用户坐标系（即通过遮罩属性引用遮罩元素的那个元素的用户坐标系）。
+    # 如果遮罩内容单位为 “物体边界框”，遮罩内容的用户坐标系是依据应用遮罩的元素的边界框来建立的。
+    # 默认值是 “使用用户空间”。
+
+    def 构建SVG元素(self):
+        P = self.获取属性值
+        遮罩元素_, 被遮元素 = P("遮罩元素"), P("被遮元素")
+        if not isinstance(遮罩元素_, list):
+            遮罩元素_ = [遮罩元素_]
+        遮罩单位 = P("遮罩单位", None)
+        遮罩内容单位 = P("遮罩内容单位", None)
+        mask = self.dwg.mask(id=self.获取元素id(t="ma"))
+        if 遮罩单位:
+            mask.attribs["maskUnits"] = 遮罩单位
+        if 遮罩内容单位:
+            mask.attribs["maskContentUnits"] = 遮罩内容单位
+        for 元素 in 遮罩元素_:
+            mask.add(元素.build_svg_element())
+
+        if 被遮元素 is not None:
+            if not isinstance(被遮元素, list):
+                被遮元素 = [被遮元素]
+
+            for 元素 in 被遮元素:
+                元素.build_svg_element()['mask'] = getattr(mask, "get_funciri")()
+
+        return mask

/321/207/320/265/320/256/321/207/320/274/320/244/321/207/320/260/320/221/321/211/320/255/320/243//321/207/320/265/320/256/321/207/320/274/320/244/321/205/342/225/221/320/243//321/205/320/225/320/223/321/207/342/224/244/320/260/321/205/342/225/221/320/243//321/205/320/225/320/223/321/207/342/224/244/320/260_/321/211/320/243/342/225/233/321/206/320/236/320/265.py

@@ -0,0 +1,39 @@
+# -*- coding:utf-8 -*-
+# title           :
+# description     :
+# author          :Python超人/三月三提供
+# date            :2024-11-05
+# link            :https://gitee.com/march3
+# python_version  :3.9
+# ==============================================================================
+import os
+import svgwrite
+
+from 神笔码靓.神笔库.定义集 import *
+from 神笔码靓.神笔库.元素库 import 元素
+from 神笔码靓.神笔库.神笔绘图板工具 import 神笔绘图板工具
+
+
+class 链接元素(元素):
+    def 构建SVG元素(self):
+        元素对象, 链接地址, 链接提示, 链接描述, 新开窗口 = self.批量获取属性(["元素对象", "链接地址", "链接提示", "链接描述", "新开窗口"])
+        if 新开窗口:
+            target = '_blank'
+        else:
+            target = '_self'
+
+        if hasattr(元素对象,"___绑定链接"):
+            if getattr(元素对象, "___绑定链接") == True:
+                raise Exception(f"{元素对象}已经绑定了一个链接，无法再绑定其他链接")
+
+        # 创建一个带有超级链接的文本元素
+        link = self.dwg.add(self.dwg.a(href=链接地址, target=target))
+        link.add(元素对象.build_svg_element())
+        # link.set_title(链接说明)
+
+        link.set_desc(title=链接提示, desc=链接描述)
+        setattr(元素对象, "___绑定链接", True)
+        # 将图形元素添加到SVG文档中
+        # dwg.add(link_text)
+
+        return link

/321/207/320/265/320/256/321/207/320/274/320/244/321/207/320/260/320/221/321/211/320/255/320/243//321/207/320/265/320/256/321/207/320/274/320/244/321/205/342/225/221/320/243//321/205/320/225/320/223/321/207/342/224/244/320/260/321/205/342/225/221/320/243//321/205/320/225/320/223/321/207/342/224/244/320/260/321/210/342/225/234/320/274/321/210/342/225/226/320/277/321/205/342/225/233/320/224/321/206/320/244/320/277/321/206/320/234/320/221.py

@@ -0,0 +1,14 @@
+# -*- coding:utf-8 -*-
+# title           :
+# description     :
+# author          :Python超人/三月三提供
+# date            :2024-06-01
+# link            :https://gitee.com/march3
+# python_version  :3.9
+# ==============================================================================
+
+
+class 支持元素转路径:
+    from 神笔码靓.神笔库.元素库 import 路径元素
+    def 转路径元素(self, 保留元素=False) -> 路径元素:
+        raise NotImplementedError("暂未实现 转路径元素 功能")

/321/207/320/265/320/256/321/207/320/274/320/244/321/207/320/260/320/221/321/211/320/255/320/243//321/207/320/265/320/256/321/207/320/274/320/244/321/205/342/225/221/320/243//321/205/320/225/320/223/321/207/342/224/244/320/260/321/205/342/225/221/320/243//321/205/320/237/320/277/321/206/320/243/320/235/321/204/342/225/234/320/254/321/205/320/225/320/223/321/207/342/224/244/320/260/321/211/320/253/320/226/321/205/320/240/320/230.py

@@ -0,0 +1,98 @@
+# -*- coding:utf-8 -*-
+# title           :
+# description     :
+# author          :Python超人/三月三提供
+# date            :2024-08-17
+# link            :https://gitee.com/march3
+# python_version  :3.9
+# ==============================================================================
+import svgwrite
+
+from 神笔码靓.神笔库.元素库 import 元素模板, 元素组
+from 神笔码靓.神笔库.动画工具集 import 缩放动画关键帧, 旋转动画关键帧, 倾斜动画关键帧, 平移动画关键帧
+from 神笔码靓.神笔库.定义集 import *
+from 神笔码靓.神笔库.通用工具集 import *
+
+
+class 可操作元素集合(列表):
+    def __init__(self, 绘图板, seq=()):
+        # # def __init__(self, seq=())
+        # list.__init__(self, seq=seq)
+        from 神笔码靓.神笔库 import 神笔绘图板
+        self.绘图板: 神笔绘图板 = 绘图板
+
+    def 元素类型列表(self):
+        from 神笔码靓.神笔库.元素库 import 元素
+        for item in self:
+            if isinstance(item, 元素):
+                yield item
+
+    def 添加到列表(self, 元素列表: list):
+        for item in self.元素类型列表():
+            item.添加到列表(元素列表)
+        return self
+
+    def _操作(self, *args, **kwargs):
+        操作名 = kwargs["操作名"]
+        del kwargs["操作名"]
+        for item in self.元素类型列表():
+            if hasattr(item, 操作名):
+                funs = getattr(item, 操作名)
+                if callable(funs):
+                    funs(*args, **kwargs)
+        return self
+
+    def __getattr__(self, name):
+        # name 是方法名
+        def method(*args, **kwargs):
+            # print(f"调用的方法名: {name}")
+            # print(f"参数: {args}, 关键字参数: {kwargs}")
+            kwargs["操作名"]=name
+            self._操作(*args, **kwargs)
+            return self
+
+        return method
+
+    # def __getattr__(self, item):
+    #     self._操作(操作名=item, 透明度=透明度)
+    #     return super().__getattr__(item)
+
+    #
+    # def 平移2(self, 位移X, 位移Y=None):
+    #     for item in self.元素类型列表():
+    #         if hasattr(item, "平移"):
+    #             funs = getattr(item, "平移")
+    #             if callable(funs):
+    #                 funs(位移X, 位移Y)
+    #     return self
+
+    def 平移(self, 位移X, 位移Y=None):
+        self._操作(操作名="平移", 位移X=位移X, 位移Y=位移Y)
+        return self
+
+    # def 透明度(self, 透明度=1):
+    #     self._操作(操作名="透明度", 透明度=透明度)
+    #     return self
+
+    def 合并为模板(self, id_: str = None, class_name: str = None, style: str = None,
+              样式类名: str = None, 样式串: str = None, ) -> 元素模板:
+        元素列表 = 列表()
+        self.添加到列表(元素列表)
+        return self.绘图板.创建模板(元素列表=元素列表, id_=id_, class_name=class_name, style=style,
+                             样式类名=样式类名, 样式串=样式串)
+
+    def 合并为组(self, class_name: str = None, style=None, 样式类名: str = None,
+             样式串: str = None, id_: str = None, 追加元素=None) -> 元素组:
+        from 神笔码靓.神笔库.元素库 import 元素
+        元素列表 = 列表()
+        self.添加到列表(元素列表)
+
+        if isinstance(追加元素, 元素):
+            追加元素.添加到列表(元素列表)
+        elif isinstance(追加元素, list):
+            for 元素_ in 追加元素:
+                if isinstance(元素_, 元素):
+                    元素_.添加到列表(元素列表)
+
+        return self.绘图板.创建组合(元素列表=元素列表, class_name=class_name, style=style,
+                             样式类名=样式类名, 样式串=样式串, id_=id_)

/321/207/320/265/320/256/321/207/320/274/320/244/321/207/320/260/320/221/321/211/320/255/320/243//321/207/320/265/320/256/321/207/320/274/320/244/321/205/342/225/221/320/243//321/205/320/225/320/223/321/207/342/224/244/320/260/321/205/342/225/221/320/243//321/206/342/225/225/320/240/321/205/320/237/320/250/321/210/320/231/342/226/223.py

@@ -0,0 +1,67 @@
+# -*- coding:utf-8 -*-
+# title           :
+# description     :
+# author          :Python超人/三月三提供
+# date            :2024-06-01
+# link            :https://gitee.com/march3
+# python_version  :3.9
+# ==============================================================================
+import svgwrite
+
+from 神笔码靓.神笔库.定义集 import *
+
+
+class 渐变色:
+    def __init__(self, svg_element):
+
+        self.svg_element = svg_element
+
+    def 矩阵(self, a, b, c, d, e, f):
+        self.svg_element.matrix(a, b, c, d, e, f)
+        return self
+
+    def 缩放(self, 缩放X,缩放Y=None):
+        # def scale(self, sx, sy=None):
+        # if isinstance(缩放比例, tuple):
+        #     sx, sy = 缩放比例
+        # else:
+        #     sx, sy = 缩放比例, None
+        self.svg_element.scale(缩放X,缩放Y)
+        return self
+
+    def 垂直翻转(self):
+        self.svg_element.scale((-1, 1))
+        return self
+
+    def 水平翻转(self):
+        self.svg_element.scale((1, -1))
+        return self
+
+    def 平移(self, 位移X,位移Y=None):
+        # def translate(self, tx, ty=None):
+        # if isinstance(位移, tuple):
+        #     tx, ty = 位移
+        # else:
+        #     tx, ty = 位移, None
+        self.svg_element.translate(位移X,位移Y)
+        return self
+
+    def 倾斜X(self, 倾斜角度):
+        self.svg_element.skewX(倾斜角度)
+        return self
+
+    def 倾斜Y(self, 倾斜角度):
+        self.svg_element.skewY(倾斜角度)
+        return self
+
+    def 旋转(self, 旋转角度, 旋转中心点=None):
+        self.svg_element.rotate(旋转角度, 旋转中心点)
+        return self
+
+
+class 径向渐变色(渐变色):
+    pass
+
+
+class 线性渐变色(渐变色):
+    pass

/321/207/320/265/320/256/321/207/320/274/320/244/321/207/320/260/320/221/321/211/320/255/320/243//321/207/320/265/320/256/321/207/320/274/320/244/321/205/342/225/221/320/243//321/205/320/225/320/223/321/207/342/224/244/320/260/321/205/342/225/226/320/265/321/205/320/225/342/225/226/321/211/320/253/320/226.py

@@ -0,0 +1,86 @@
+# -*- coding:utf-8 -*-
+# title           :
+# description     :
+# author          :Python超人/三月三提供
+# date            :2024-05-01
+# link            :https://gitee.com/march3
+# python_version  :3.9
+# ==============================================================================
+import re
+from 神笔码靓.神笔库.神笔绘图板 import 神笔绘图板
+from 神笔码靓.神笔库.定义集 import *
+from 神笔码靓.神笔库.配置 import *
+from 神笔码靓.神笔库.通用工具集 import *
+from 神笔码靓.神笔库 import 类型转换工具集
+from dataclasses import dataclass
+
+
+def 获取元素位置信息(元素):
+    print(元素.获取位置信息())
+
+
+class 神笔绘图板模板(神笔绘图板):
+    def 页面设置(self, 设置: 纸张设置):
+        # 输出 PDF 文件，以及 页面打印，在这里设置好
+        设置.上页边距 = "0cm"
+        设置.下页边距 = 0
+        设置.左页边距 = "0cm"
+        设置.右页边距 = 0
+        设置.页面方向 = 纸张方向.自动识别
+        设置.页面尺寸规格 = "A4"
+        设置.页面缩放 = 1.0
+
+    def 创作(self):
+        # 注意：图框不会显示到 PDF 文件中，如果不希望SVG文件显示图框，可以注释或者删除以下代码
+        self.显示图框()
+        self.显示网格(网格线距=10, 网格颜色=颜色.暗灰色, 网格透明度=1, 网格字体大小=9)
+
+        # elm = self.贴图(x=50, y=50, 图片文件="../资源库/图片/三月三印章.png").缩放(0.25)
+        # elm = self.写字(x=272, y=270, 文字="制作从这里开始", 字体大小=60,
+        #              # 垂直基线对齐=文字垂直基线对齐.顶线对齐,水平基线对齐=文字水平基线对齐.起始点对齐
+        #              垂直基线对齐=文字垂直基线对齐.中线对齐, 水平基线对齐=文字水平基线对齐.中点对齐
+        #              ).缩放(0.5)
+        # elm = self.画圆(100, 100, 半径=50, 填充颜色="red", 描边颜色=颜色.透明)
+        # elm = self.画多边形(顶点列表=[(10, 130), (140, 130), (240, 100), (140, 200), (10, 200)]).缩放(0.5).平移((100,50)).缩放(2)
+        # rotate(90 125.0 150.0)
+
+        # _渐变色 = self.样式.创建线性渐变色(开始位置=(100, 100), 结束位置=(200, 200),
+        #                        开始颜色="#ff0000", 结束颜色="#00ff00",
+        #                        开始偏移=0.13, 结束偏移=0.9,
+        #                        )
+
+        # elm =self.画椭圆(x=150, y=180, 半径=(30, 20), 描边颜色=颜色.红色, 填充颜色=_渐变色).平移(100)
+        # elm = self.画椭圆(x=150, y=180, 半径=(30, 20), 描边颜色=颜色.红色, 填充颜色=_渐变色)
+        # elm = self.创建组合(元素列表=[elm]).显示中心点()
+        # elm = self.克隆元素(elm).缩放(1).平移(50).显示中心点()
+
+        # elm = self.画表格(左上起始点=(70, 170), 右下结束点=(180, 150), 列数=4, 行数=5).平移(50).缩放((1,2)).平移((0,-100))
+        # elm = self.画矩形(x=100, y=100, 宽=200, 高=100, 描边颜色=颜色.黑色, 圆角半径=10, 描边样式="5,5").缩放(
+        #     (0.5, 0.8)).垂直翻转()  # .显示中心点()#.旋转(90)
+
+        # _面部色 = "#fbdaad"  # TODO: 未使用渐变色
+        # elm = self.连线([("移动", 412.94, 123.91)], 描边颜色=颜色.黑色, 填充颜色=颜色.透明, id_="头面部",闭合=否).缩放(0.2).\
+        #     追加顶点(("曲线", 430.24, 126.95, 462.06, 132.54, 488.51, 158.63)).追加顶点列表([
+        #     # ("曲线", 430.24, 126.95, 462.06, 132.54, 488.51, 158.63),
+        #     ("曲线", 507.29, 177.15, 514.46, 197.22, 520.17, 213.78),
+        #     ("曲线", 525.90, 230.41, 553.17, 309.54, 510.98, 381.27),
+        #     ("曲线", 501.35, 397.64, 481.06, 432.13, 441.53, 442.55),
+        #     ("曲线", 415.04, 449.53, 392.40, 442.44, 377.19, 437.44),
+        #     ("曲线", 318.62, 418.20, 287.08, 369.51, 275.74, 349.61),
+        #     ("曲线", 268.59, 332.36, 261.44, 315.11, 254.29, 297.87),
+        #     ("曲线", 250.75, 282.57, 246.37, 254.28, 254.63, 220.93),
+        #     ("曲线", 258.80, 204.10, 268.14, 164.99, 303.65, 140.25),
+        #     ("曲线", 344.40, 111.87, 389.97, 119.88, 412.93, 123.91),
+        # ]).平移(100).显示中心点()
+
+        获取元素位置信息(elm)
+
+
+if __name__ == '__main__':
+    # 作品文件路径：保存的 SVG（矢量图）格式的文件路径名称
+    # 宽: 神笔绘图板也需要设置页面的宽度
+    # 高: 神笔绘图板也需要设置页面的高度
+    宽, 高 = 纸张大小.A4_横向(1)
+    神笔 = 神笔绘图板模板(作品文件路径="元素位置信息.svg", 宽=宽 / 2, 高=高 / 1.8)
+    神笔.完成()
+    神笔.生成PDF()

/321/207/320/265/320/256/321/207/320/274/320/244/321/207/320/260/320/221/321/211/320/255/320/243//321/207/320/265/320/256/321/207/320/274/320/244/321/205/342/225/221/320/243//321/205/320/225/320/223/321/207/342/224/244/320/260/321/206/320/236/320/242/321/205/320/230/320/247/321/205/342/225/226/320/265/321/205/320/225/342/225/226/321/211/320/253/320/226.py

@@ -0,0 +1,178 @@
+# -*- coding:utf-8 -*-
+# title           :
+# description     :
+# author          :Python超人/三月三提供
+# date            :2024-11-28
+# link            :https://gitee.com/march3
+# python_version  :3.9
+# ==============================================================================
+# from dataclasses import dataclass
+
+from 神笔码靓.神笔库 import 范围, 计算旋转后的坐标
+from 神笔码靓.神笔库.元素库 import 可操作元素集合
+from 神笔码靓.神笔库.定义集 import *
+
+
+# @dataclass
+# class 动画关键帧:
+#     时间点: [float, int] = 0
+#
+#
+# @dataclass
+# class 缩放动画关键帧(动画关键帧):
+#     缩放X: [float, int] = 1
+#     缩放Y: [float, int] = 1
+#
+#
+# @dataclass
+# class 平移动画关键帧(动画关键帧):
+#     位置X: [float, int] = 0
+#     位置Y: [float, int] = 0
+#
+#
+# @dataclass
+# class 倾斜动画关键帧(动画关键帧):
+#     倾斜角: [float, int] = 10
+#
+#
+# @dataclass
+# class 旋转动画关键帧(动画关键帧):
+#     旋转角: [float, int] = 0
+#     旋转中心点: tuple[[float, int], [float, int]] = (0, 0)
+
+
+class 元素排列工具集:
+    def __init__(self, 高清图=None):
+        from 神笔码靓.神笔库 import 神笔绘图板
+        self.绘图板: 神笔绘图板 = 高清图
+        self.dwg = 高清图.dwg
+
+    def 水平排列(self, 元素集合, 元素间距: float) -> 可操作元素集合:
+        元素列表 = 可操作元素集合(self.绘图板)
+        for i, 元素_ in enumerate(元素集合):
+            元素_.平移(i * 元素间距, 0)
+            元素列表.添加元素(元素_)
+        return 元素列表
+
+    def 垂直排列(self, 元素集合, 元素间距: float) -> 可操作元素集合:
+        元素列表 = 可操作元素集合(self.绘图板)
+        for i, 元素_ in enumerate(元素集合):
+            元素_.平移(0, i * 元素间距)
+            元素列表.添加元素(元素_)
+        return 元素列表
+
+    def 网格水平排列(self, 元素集合, 最大列数, 列间距: float, 行间距: float) -> 可操作元素集合:
+        元素列表 = 可操作元素集合(self.绘图板)
+        集合数量 = len(元素集合)
+        列号 = 0
+        行号 = 0
+        for i in 范围(集合数量):
+            元素_ = 元素集合[i]
+            元素_.平移(列号 * 列间距, 行号 * 行间距)
+            列号 += 1
+            if 列号 >= 最大列数:
+                列号 = 0
+                行号 += 1
+            元素列表.添加元素(元素_)
+
+        return 元素列表
+
+    def 网格垂直排列(self, 元素集合, 最大行数, 行间距: float, 列间距: float) -> 可操作元素集合:
+        元素列表 = 可操作元素集合(self.绘图板)
+        集合数量 = len(元素集合)
+        列号 = 0
+        行号 = 0
+        for i in 范围(集合数量):
+            元素_ = 元素集合[i]
+            元素_.平移(列号 * 列间距, 行号 * 行间距)
+            行号 += 1
+            if 行号 >= 最大行数:
+                行号 = 0
+                列号 += 1
+            元素列表.添加元素(元素_)
+        return 元素列表
+
+    def 环绕排列(self, 元素集合, 环绕中心点: tuple[float, float] = None, 间距角: float = None,
+             顺时针: bool = 是, 元素跟随旋转: bool = 是) -> 可操作元素集合:
+        if 环绕中心点 is None:
+            环绕中心点 = self.绘图板.宽 / 2, self.绘图板.高 / 2
+        集合数量 = len(元素集合)
+        if 间距角 is None:
+            间距角 = 360 / 集合数量
+
+        # if callable(元素集合):
+        #     创造元素 = 元素集合
+        # else:
+        #     if not isinstance(元素集合, list):
+        #         元素集合 = [元素集合]
+        #     重复模板 = self.绘图板.创建模板(元素列表=元素集合)
+        #     创造元素 = lambda 参数: 重复模板.创造元素()
+
+        元素列表 = 可操作元素集合(self.绘图板)
+
+        if 元素跟随旋转:
+            for i in 范围(集合数量):
+                旋转角 = i * 间距角
+                if not 顺时针:
+                    旋转角 = -旋转角
+                参数 = {"索引": i, "间距角": 间距角, "旋转角": 旋转角, "环绕中心点": 环绕中心点}
+                # if callable(元素创造前回调):
+                #     参数_ = 元素创造前回调(参数)
+                #     if 参数_ is not None:
+                #         参数 = 参数_
+                元素_ = 元素集合[i].旋转(参数["旋转角"], 环绕中心点)
+                # if callable(元素创造后回调):
+                #     元素创造后回调(元素, 参数)
+                元素列表.添加元素(元素_)
+        else:
+            for i in 范围(集合数量):
+                旋转角 = i * 间距角
+                if not 顺时针:
+                    旋转角 = -旋转角
+                参数 = {"索引": i, "间距角": 间距角, "旋转角": 旋转角, "环绕中心点": 环绕中心点}
+                # if callable(元素创造前回调):
+                #     参数_ = 元素创造前回调(参数)
+                #     if 参数_ is not None:
+                #         参数 = 参数_
+                元素_ = 元素集合[i]
+                # if callable(元素创造后回调):
+                #     元素创造后回调(元素, 参数)
+                元素列表.添加元素(元素_)
+                if 旋转角 == 0:
+                    continue
+                位置信息 = 元素_.获取位置信息()
+                元素中心 = 位置信息.中心x, 位置信息.中心y
+                元素新x, 元素新y = 计算旋转后的坐标(元素中心, 环绕中心点, 旋转角)
+                元素_.平移(元素新x - 位置信息.中心x, 元素新y - 位置信息.中心y)
+
+        return 元素列表
+
+
+def 测试():
+    from 神笔码靓.神笔库.神笔绘图板 import 神笔绘图板
+
+    神笔 = 神笔绘图板("元素排列工具集.svg")
+    神笔.显示图框()
+
+    # 圆 = 神笔.画圆(x=200, y=200, 半径=50, 填充颜色=颜色.蓝色)
+    #
+    # 方 = 神笔.画矩形(x=200, y=200, 宽=60, 高=40, 填充颜色=颜色.红色).平移(100, 100)
+    # 参考方 = 神笔.画矩形(x=180, y=180, 宽=100, 高=80, 填充颜色=颜色.蓝色).平移(100, 100)
+
+    def 创建爱心(数量: int):
+        爱心集合 = []
+        for i in range(数量):
+            神笔.画爱心(x=100, y=200, 半径大小=20, 填充颜色=颜色.随机色()).添加到列表(爱心集合)
+        return 爱心集合
+
+    神笔.环绕排列(元素集合=创建爱心(12), 间距角=30, 环绕中心点=(500, 500), 顺时针=否, 元素跟随旋转=是).旋转(90)
+    神笔.垂直排列(元素集合=创建爱心(5), 元素间距=60).平移(0, 200)
+    神笔.水平排列(元素集合=创建爱心(5), 元素间距=70)
+    神笔.网格水平排列(元素集合=创建爱心(30), 最大列数=9, 列间距=80, 行间距=80).旋转(10)
+    神笔.网格垂直排列(元素集合=创建爱心(30), 最大行数=8, 行间距=80, 列间距=80).旋转(40)
+
+    神笔.完成()
+
+
+if __name__ == '__main__':
+    测试()