SkyPattern 用户指南
SkyPattern 是一个几何设计工具，允许您在交互式画布中创建和操作几何元素。本指南将帮助您有效地使用该应用程序。
开始使用
界面概述
SkyPattern 界面由三个主要区域组成：
- 顶部工具栏：包含 SkyPattern 标志、模式切换（制图/排料）、PDF/SVG 导出、本地备份的保存/加载按钮、输入模式切换（鼠标/触控板）、主题切换器（浅色/深色）和语言选择器
- 画布区域：交互式 SVG 画布，您可以在其中查看和操作几何元素
- 右侧面板：带有图标的元素列表、添加/删除按钮和属性编辑器。您可以通过拖动左边缘来调整此面板的大小，使其更宽或更窄。
- 底部状态栏：显示文档 ID、当前模式和保存状态
基本导航
SkyPattern 支持两种输入模式，您可以在工具栏中切换：
鼠标模式（
）：
- 平移：用鼠标滚轮（中键）点击并拖动，或按住 Shift 键并用鼠标左键拖动
- 缩放：滚动鼠标滚轮以放大/缩小
触控板模式（
）：
- 平移：双指向任何方向滚动（上、下、左、右）
- 缩放：捏合手势（双指捏合/展开）
两种模式：
- 选择元素：单击画布或元素列表中的任何元素以选择它
- 模式切换：使用工具栏中的选项卡在"制图"、"排料"和"笔记"模式之间切换
- 主题切换：单击主题按钮在浅色和深色模式之间切换
- 网格切换：单击网格按钮（
）以显示/隐藏画布上的 1 厘米参考网格。网格有助于对齐和测量验证，但不会出现在导出中。
使用元素
添加新元素
- 单击右侧面板中的 ➕ 按钮，或按
n键 - 将创建并选择一个新的未命名元素
- 从编辑器中的下拉菜单中选择元素类型
- 配置元素属性
元素类型
基点
- 目的：在特定的 X,Y 坐标处创建固定点
- 属性：
- X 坐标（厘米）
- Y 坐标（厘米）
- 示例：
x: 10, y: 20在位置 (10cm, 20cm) 创建一个点
常量
- 目的：定义可重用的数值
- 属性：
- 值（可以是数学表达式）
- 描述（可选）：描述该常量含义的文字备注
- 示例：
value: 15或value: 10 * 1.5
角度距离
- 目的：在另一个点的特定角度和距离处创建一个点
- 属性：
- 起点：参考点名称
- 角度：方向（度）（0° = 右/东，90° = 下/南，180° = 左/西，270° = 上/北）
- 距离：距离参考点的距离（厘米）
- 示例：从 "basePoint"，角度 45°，距离 20
沿直线
- 目的：沿着两个现有点之间的直线放置一个点
- 属性：
- 起点：直线的起点
- 终点：直线的终点
- 长度：从起点沿直线的距离（厘米）
- 示例：沿直线的中点：
length: len(@point1, @point2) * 0.5
直线交点
- 目的：找到两条直线相交的位置
- 属性：使用起点/终点对定义两条直线
- 示例：直线 1 从 "point1" 到 "point2"，直线 2 从 "point3" 到 "point4"
X和Y交点
- 目的：使用一个元素的 X 坐标和另一个元素的 Y 坐标创建一个点
- 属性：
- 点 X：获取 X 坐标的元素
- 点 Y：获取 Y 坐标的元素
直线
- 目的：在两点之间绘制可见直线
- 属性：起点和终点
贝塞尔曲线
- 目的：使用控制柄创建平滑曲线
- 属性：具有控制角度和距离的多个点
- 用法：单击并拖动控制柄以调整曲线形状
圆弧
- 目的：创建圆弧或弧段
- 属性：
- 中心点：圆弧的中心
- 半径：圆弧半径（厘米）
- 起始角度：起始角度（度）（0° = 右，90° = 下）
- 结束角度：结束角度（度）
- 示例：从 0° 到 90° 的四分之一圆，或从 0° 到 360° 的完整圆
高级交点
- 圆弧与曲线交点：查找圆弧和贝塞尔曲线之间的交点
- 圆弧与直线交点：查找圆弧和由两点定义的无限直线之间的交点
- 贝塞尔曲线与直线交点：查找贝塞尔曲线和由两点定义的无限直线之间的交点
- 曲线上的点：在曲线上的特定距离处放置点。距离不得超过曲线的总长度，否则将显示错误。
变换元素
- 目的：通过应用平移和旋转创建元素的变换副本
- 属性：
- 元素：要变换的元素名称数组
- 平移 X：水平偏移（厘米）
- 平移 Y：垂直偏移（厘米）
- 旋转：旋转角度（度）
- 旋转中心：旋转的中心点（可选，默认为原点 0,0）
- 特点：
- 一次变换多个元素
- 支持围绕指定中心点旋转
- 适用于点、贝塞尔曲线和其他几何元素
- 变换的元素通过组合原始元素名称和变换名称来命名（例如，
point1transform1）
- 示例：变换
["point1", "curve1"]，translateX: 10，translateY: 5，rotation: 45，pivot: "centerPoint"- 创建
point1transform1和curve1transform1 - 围绕
centerPoint旋转 45°，然后向右平移 10cm，向下平移 5cm
- 创建
- 用法：创建旋转的袖子纸样，以不同角度排列领子片，围绕中心点重复装饰元素，或以圆形布局定位纸样片
纸样片
- 目的：通过连接点、线、曲线和圆弧创建封闭的多边形形状
- 属性：
- 点数组：定义边界的元素名称（点、贝塞尔曲线或圆弧）
- 排料 X：排料模式的水平位置（厘米）。可以手动编辑或在排料模式下拖动纸样片。
- 排料 Y：排料模式的垂直位置（厘米）。可以手动编辑或在排料模式下拖动纸样片。
- 排料旋转：排料模式的旋转角度（度）（围绕纸样片中心旋转）
- 布纹角度：布纹方向（度）（默认为 90° = 垂直）
- 布纹长度：布纹指示器的长度（厘米）
- 布纹 X：从片中心的水平偏移（厘米）
- 布纹 Y：从片中心的垂直偏移（厘米）
- 显示布纹：切换显示/隐藏布纹（复选框）
- 剪口：轮廓上应出现剪口（对齐标记）的点数组
- 特点：
- 自动截断相邻点之间的贝塞尔曲线和圆弧
- 渲染为填充的封闭路径
- 在形状的质心处显示标签
- 在制图模式中：显示在其定义的坐标处
- 在排料模式中：显示在排料 X/Y 位置以排列纸样片，布纹指示器可见
- 布纹：显示一条两端带箭头的线，以指示面料的纹理方向。当您调整排料旋转时，布纹会随纸样片旋转。
- 剪口：在指定点从纸样边缘向外延伸的小垂直线。用于在缝合片段时标记对齐点。
- 示例：点数组：
["cornerA", "edgeCurve", "cornerB", "arcSegment", "cornerC"]- 如果
edgeCurve是贝塞尔曲线，它将在cornerA和cornerB之间自动截断 - 如果
arcSegment是圆弧，它将在cornerB和cornerC之间绘制弧段 - 没有相邻点的曲线和圆弧使用其完整长度
- 90°（垂直）的布纹有助于在裁剪面料时正确定向片段
- 如果
- 用法：为缝纫纸样、技术图纸或设计模板定义纸样片的边界。使用圆弧制作光滑的曲线边缘，如袖窿或领口。布纹指示器有助于确保在裁剪纸样片时正确对齐面料纹理。
使用数学表达式
大多数数值属性接受数学表达式。您可以使用：
基本算术
10 + 5，width * 2，radius / 3(10 + 5) * 2（括号用于分组）- 支持
+、-、*、/运算符
动态函数（使用元素）
len(@point1, @point2)- 两点之间的距离（厘米）len(@bezierCurve)- 贝塞尔曲线的总弧长（厘米）angle(@point1, @point2)- 从 point1 到 point2 的角度（度）angle(@point1, @vertex, @point2)- 顶点处两臂之间的角度（绝对值）getX(@pointName)- 获取点的 X 坐标getY(@pointName)- 获取点的 Y 坐标bisect(@point1, @vertex, @point2)- 平分顶点处两臂之间角度的角度
重要：在函数中引用元素名称时，必须在其前面加上 @。例如：len(@basePoint, @corner) 而不是 len(basePoint, corner)。
静态数学函数
- 三角函数：
sin(弧度)，cos(弧度)，tan(弧度) - 反三角函数：
asin(值)，acos(值)，atan(值) - 双参数反正切：
atan2(y, x) - 角度转换：
torad(度)，todeg(弧度) - 弦函数：
crd(弧度)（弦 = 2×sin(角度/2)），acrd(弦长)（反弦，返回弧度） - 指数/对数：
exp(x)，log(x)，log10(x) - 基本数学：
sqrt(x)，abs(x)，pow(底数, 指数)，sign(x) - 舍入：
ceil(x)，floor(x)，round(x)，trunc(x) - 多参数：
min(a, b, c, ...)，max(a, b, c, ...)
常量和元素引用
- 内置常量：
PI（3.14159...），GOLDEN_RATIO（1.618...） - 元素引用：直接使用元素名称：
myConstant，centerRadius - 函数中的元素名称：使用
@elementName在函数调用中引用元素名称
重要说明
- 三角函数需要弧度，但 SkyPattern 的角度是度数
- 使用转换函数：
sin(torad(myAngle))或todeg(asin(0.5)) - 弦函数也使用弧度：
crd(torad(60))或todeg(acrd(1.5)) - 元素名称区分大小写
- 函数需要括号和逗号分隔的参数
元素管理
选择元素
- 单击画布中的元素
- 使用右侧面板中的元素列表
- 选定的元素会高亮显示
- 单击元素列表中的放大镜（🔍）按钮可激活筛选模式，显示搜索框以按名称筛选元素
重新排序元素
- 使用 ⬆︎ 和 ⬇︎ 按钮更改计算顺序
- 元素按列表顺序计算，因此依赖项必须先出现
重命名元素
- 编辑元素编辑器中的名称字段以重命名元素
- 对重命名元素的所有引用——包括公式、点字段、数组及变换派生名称——将在整个文档中自动更新
- 例如，重命名
p1也会将变换派生名称p1t1自动更新为新名称t1
隐藏/显示元素
- 每个元素在编辑器面板中都有一个"隐藏"复选框
- 隐藏的元素在画布或导出中不可见
- 用于临时隐藏构造元素或管理重叠元素
- 隐藏的元素仍然存在并被计算，只是不显示
使用图层
图层通过将相关元素分组并控制其可见性来帮助您组织复杂的纸样。
将元素分配给图层：
- 选择一个元素并打开元素编辑器
- 在编辑器中找到"图层名称"下拉菜单
- 从下拉菜单中选择现有图层，或选择"+ 新建"以创建新图层
- 创建新图层时，在提示时输入描述性名称
- 没有图层分配的元素始终可见
管理图层可见性：
- 图层面板出现在右列顶部，可通过单击"图层"标题旁的三角形切换按钮（▼/▶）来折叠或展开
- 每个图层都显示一个名称旁边的复选框
- 已选中 = 图层在画布和元素列表中可见
- 未选中 = 图层从视图中隐藏
- 单击复选框以快速打开和关闭整个元素组
最佳实践：
- 使用图层将构造元素与完成的纸样片分开组织
- 按纸样部分（例如，"袖子"、"上衣"、"领子"）对相关元素进行分组
- 隐藏当前未使用的图层以减少视觉混乱
使用示例：
- 为引导线和参考点创建"构造"图层
- 为最终纸样片创建"纸样"图层
删除元素
- 选择元素并单击 ➖ 按钮
- 小心：引用此元素的其他元素将失去其计算
画布控制
制图模式 vs 排料模式 vs 笔记模式
SkyPattern 有三种查看模式，您可以使用工具栏中的选项卡进行切换：
制图模式：默认工作模式，您可以在其中创建和编辑所有元素。所有点、线、曲线和纸样片都显示在其定义的坐标处。使用此模式制作您的纸样。
排料模式：用于排列完成的纸样片的布局模式。在此模式下：
- 只有纸样片可见（点和线等构造元素被隐藏）
- 每个纸样片显示在其排料 X/Y 位置
- 单击并拖动纸样片以重新定位它们（自动更新排料 X/Y 值）
- 用于排列片段以进行裁剪、打印或导出
- 纸样片标签更大以提高可见性
笔记模式：用于记笔记和共享信息的实时协作文本编辑器。在此模式下：
- 简单的文本编辑器代替画布
- 实时协作：多个用户可以同时编辑同一文档
- 更改会自动在所有连接的客户端之间同步
- 连接状态指示器显示实时协作的连接状态
- 所有笔记都保存到数据库并在会话之间保持
- 适用于纸样说明、测量笔记、设计想法或团队协作
坐标系统
- 原点 (0,0) 在左上角
- X 向右增加（东）
- Y 向下增加（南）
- 角度：0° = 右，90° = 下，180° = 左，270° = 上
- 所有距离均以厘米 (cm) 为单位
键盘快捷键
n：添加新元素- 单击元素外部以取消选择
输入控制
鼠标模式（默认）：
- 单击：选择元素
- 鼠标滚轮单击并拖动：平移画布
- Shift + 左键单击并拖动：平移画布
- 鼠标滚轮滚动：放大/缩小
- 贝塞尔柄：单击并拖动以调整曲线控制点
触控板模式：
- 单击：选择元素
- Shift + 左键单击并拖动：平移画布（双指滚动的替代方法）
- 双指滚动：向所有方向平移画布
- 捏合手势：放大/缩小（双指）
- 贝塞尔柄：单击并拖动以调整曲线控制点
使用工具栏中的输入模式切换按钮（/）在鼠标和触控板模式之间切换。
保存和加载
云端文档
如果您有文档 ID（显示在底部状态栏中），您的工作每 500 毫秒自动保存到云端。
本地备份
单击工具栏中的本地备份按钮（数据库图标）以打开备份对话框。
- 保存本地备份：将您的设计以 JSON 文件格式下载到计算机
- 从备份加载：打开文件选择器以上传之前保存的 JSON 文件
- 用于离线工作或共享设计
型纸向导
型纸向导将引导您完成型纸的自定义、排版和打印全流程。在使用预定义尺寸的模板型纸时尤为方便。
打开向导： 点击工具栏中的魔法棒按钮可打开或关闭向导面板。
步骤① — 调整尺寸
向导列出所有带有说明的常量元素。修改任意数值后，型纸会实时更新，您可以在继续下一步之前查看效果。
请阅读每个字段的说明（例如"胸围"、"背长"），以了解所调整的内容。
步骤② — 检查排版
打印前，需要将每个型纸片定位在虚拟打印画布上。切换到排版（片段）模式可查看和调整每个片段的打印位置。
- 自动计算排版： 点击此按钮，系统将使用货架装箱算法自动排列所有片段，使其互不重叠。界面会自动切换到片段模式，以便您立即查看结果。
- 手动调整： 在片段模式下点击并拖动任意片段以微调其位置。手动摆放通常能比自动算法实现更密集的排列，更有效地节省用纸。
步骤③ — 确认 PDF 设置
点击 PDF 打印设置，打开打印对话框。配置纸张大小、方向、重叠边距和页面网格（列数 × 行数）。
- 自动计算页数： 自动计算放置所有片段所需的最少页数，并选择纵向或横向以最小化总页数。
步骤④ — 开始制作
打印 PDF 后，将各页拼合为完整的实物型纸。请参见下方拼合打印页面。
步骤⑤ — 开始缝纫
点击打开备注标签页，查看附加在本型纸文档中的制作说明和缝纫指南。
拼合打印页面
打印完成后，按照以下步骤将各页面拼合成一张完整的型纸。
了解页面布局
每张打印页面包含：
- 左上角的页面标签：如"Page(1,1)"、"Page(2,1)"等
- 第一个数字 = 列（从左到右）
- 第二个数字 = 行（从上到下）
- 带有两种线型的重叠边距：
- 实线 — 裁剪边（在此处剪切）
- 虚线 — 重叠边界
- 中央的型纸线
拼合步骤
- 铺开所有页面（在大桌子或地板上）
- 根据页面标签按网格排列
- Page(1,1) 置于左上角，Page(2,1) 紧靠其右，以此类推
- 裁剪内部页面
- 对于四边都有相邻页面的页面，沿实线重叠线裁剪
- 边缘页面保留重叠边距
- 对齐并用胶带粘贴
- 从最上方一行开始
- 重叠页面，对齐型纸线和标记
- 利用重叠区域精确对齐
- 从背面粘贴胶带，保持正面平整
- 逐行操作，最后将各行拼合在一起
- 检查对齐情况
- 型纸线应在页面边界处平滑衔接
- 如果线条不对齐，请确认是否以 100% 比例打印
提示和最佳实践
命名元素
- 使用描述性名称，如"centerPoint"、"radius"、"cornerAngle"
- 名称在公式中使用，因此避免空格和特殊字符
- 使用驼峰命名法或下划线：
baseWidth或base_width - 全角字符会自动标准化：如果使用全角字符（例如通过日文或中文键盘输入）键入元素名称，系统会自动将其转换为对应的半角字符（如
ａ→a，１→1）
构建复杂设计
- 从基点开始建立关键位置
- 为重要测量创建常量
- 使用角度/距离和沿直线元素创建相关点
- 添加线和曲线以可视化设计
- 使用交点查找派生点
公式示例
- 常量：
myRadius / 2- 半径常量的一半 - 垂直角度：
angle(@center, @corner) + 90- 从角度偏移 90 度 - 移位位置：
getX(@point1) + 5- X 位置向右移动 5cm - 中点距离：
len(@point1, @point2) * 0.5- 点之间距离的一半 - 沿直线的分数：
len(@point1, @point2) / 3- 距离的三分之一 - 三角函数：
sin(angle(@p1, @p2) * PI / 180) * 10- 角度的正弦乘以 10 - 复杂表达式：
sqrt(pow(getX(@p2) - getX(@p1), 2) + pow(getY(@p2) - getY(@p1), 2))- 距离公式 - 角平分线：
bisect(@arm1, @vertex, @arm2)- 均匀分割两臂的角度 - 最小/最大：
max(getX(@p1), getX(@p2), getX(@p3))- 最右侧的 X 坐标
故障排除
- 元素未计算：检查所有引用的元素是否存在并首先计算
- 意外位置：验证公式和元素顺序
- 性能问题：简化复杂曲线或减少元素数量
- 曲线上的点"距离超出范围"错误：距离值超过了曲线的总长度。请减小距离值，或使用
len(@曲线名)检查曲线长度。
高级功能
贝塞尔曲线编辑
- 选择贝塞尔曲线以查看控制柄
- 拖动柄以调整曲线形状
- 控制角度以度为单位，距离以画布单位 (cm) 为单位
圆弧-曲线交点
- 用于查找精确的交点
- 交点索引选择要使用的交点（0、1、2...）
动态测量
- 当依赖项更改时，元素会自动更新
- 通过更改基值创建参数化设计
本指南涵盖了 SkyPattern 的基本功能。尝试不同的元素类型和公式以创建复杂的几何设计！