文档

开始使用

用一个最小场景完成编写、预览和导出。

PhysLoom 把一段物理描述编译成图和动画。你不需要先摆放每一个像素;先说明场景里有什么、它们如何连接,再让布局器处理几何关系。

打开 Studio

进入 Studio。左边是模型文本,右边是结果。修改文字后,预览会自动更新;如果模型不完整,诊断信息会指出对应的语句。

写下第一个场景

下面的场景包含一个支架、一个滑轮和两个重物。绳命名为 R,便于显式选择它的张力:

scene first_pulley

support ceiling orientation=horizontal
load A 2kg
load B 3kg
pulley P

P <-> ceiling

rope R
R: A -> P -> B

animate A speed=0.24
show R A.forces A.motion B.forces B.motion

可以先改一个质量值,再观察图、加速度和受力信息。A、B 和 P 是模型中的标识符,后续语句会用它们指向同一个实体。

读懂反馈

Studio 会区分两类问题:

  • 语法问题:某一行无法被 DSL 解析,通常会带行号和建议。
  • 模型问题:语句本身合法,但连接关系不完整或违反约束。

先处理第一条诊断。后面的错误有时只是由它连带产生。

导出结果

工具栏可以导出 SVG、PNG,也可以下载原始 .phys 源码。文章和课件优先使用 SVG,它在缩放时仍然清晰;需要发到聊天软件时,PNG 更方便;需要以后继续修改时,保留 .phys 文件。

下一步可以阅读 DSL 基础,了解实体、连接和展示语句如何配合;也可以直接打开 常用模型写法,从接近目标的例子开始改。