文档

开始使用

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

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

打开 Studio

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

写下第一个场景

下面的场景包含支架、滑轮、两个物体和一根绳:

scene first_pulley {
  support ceiling
  pulley P fixed to ceiling
  body A mass=2kg
  body B mass=3kg
  rope R path body(A) -> around(P) -> body(B)

  show tension
}

可以先改 mass,再观察图和受力信息。名称 ABPR 是模型中的标识符,后续语句会用它们指向同一个实体。

读懂反馈

Studio 会区分两类问题:

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

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

导出结果

工具栏可以导出 SVG、PNG 或完整项目。文章和课件优先使用 SVG,它在缩放时仍然清晰;需要发到聊天软件时,PNG 更方便。

下一步可以阅读 DSL 基础,了解实体、连接和展示语句如何配合。