Beam Bench文档

Beam Bench项目文档

.lzrproj项目文档格式。自包含的zip归档,包含画布上显示的所有内容及设置。

Beam Bench项目以单个.lzrproj文档的形式存储。该格式是自包含的zip归档:打开.lzrproj文档即可获得保存时画布上的所有内容。

包含的内容

.lzrproj文档包含:

  • 对象:画布上的每个形状、文本、图像、组和阵列,以及它们的几何信息、变换和图层分配。
  • 图层:每个图层的切割设置(操作、功率、速度、次数、间隔、穿孔、割缝)。
  • 机器配置文档引用:保存项目时正在使用的配置文档。
  • 相机状态(如有)、选定的相机ID、对齐/校准引用。
  • 材料库引用:按名称引用。如果接收者拥有相同的材料库名称,这些引用即可解析。
  • 视图状态:平移、缩放、面板布局。
  • 项目备注Notes dialog中的内容。
  • 优化:输出端优化设置(请参阅Laser Control中的Optimization部分)。
  • 作业原点+Start From:放置策略。
  • 最近的自动保存元数据(适用时)。

栅格图像数据会以内嵌方式(base64或类似格式)打包,因此包含图像的项目文档更大,但始终具有可移植性。

如何读取和写入

  • GUI:File → Save(Ctrl+S)、File → Open(Ctrl+O)、File → Save As(Ctrl+Shift+S)。
  • CLI
    beambench-cli project open /abs/path/to/project.lzrproj
    beambench-cli project save
    beambench-cli project save-as /abs/path/to/new.lzrproj
  • HTTP APIPOST /api/v1/projects/openPOST /api/v1/projects/save

共享项目

通过电子邮件发送或上传给他人的.lzrproj文档,打开后会保留相同的画布状态、相同的图层设置和相同的视图。他们将看到:

  • 所有对象的位置相同。
  • 所有图层设置完全一致。
  • 如果他们拥有匹配的材料库,材料库引用将被解析;否则会显示警告。

不会随项目传递的内容:

  • 活动的机器连接(使用对方的机器)。
  • 每位用户的偏好设置(显示单位、在用户级别应用的面板布局覆盖设置)。

边界情况

  • 非常大的栅格图像会使.lzrproj文档变得很大。如果项目太大而无法附加到错误报告,请考虑先对栅格图像进行降采样。
  • 材料库引用按名称解析。如果你的库中有Acrylic 3mm,而接收者也有设置不同的Acrylic 3mm,打开项目后将采用接收者的设置。
  • 机器配置文档引用按ID解析。如果接收者没有相同的配置文档,系统会在打开时提示其选择一个配置文档。

格式兼容性

预发布版本。不同版本之间的架构可能会在不另行通知的情况下发生变化。更新Beam Bench前,请以当前格式保存重要项目。目前还没有向后兼容层,这是1.0版本之后才会考虑的问题。

相关内容

On this page