跳转到内容
flamo
开始使用

图形

Figma Adapter 把页面、Frame、Group、Text、Vector、媒体与布局信息规范化为 Artifact scene。Runtime 消费的是 Flamo 的通用 scene contract,而不是在每一帧直接读取 Figma API 对象。

Figma native nodes
-> adapter normalize / validate
-> canonical scene nodes + assets + provenance
-> Studio / Runtime render

层级、transform、尺寸、clip、paint、stroke、effect、text、Auto Layout 和资源引用应在适配阶段变成 Runtime 已有消费者理解的字段。遇到不能无损 lowering 的输入时,adapter 返回明确 unsupported diagnostic,不能悄悄丢字段后宣称完成。

Flamo durable authoring 当前覆盖 frame、group、rect、line、ellipse、polygon、star、vector、path、curve、arrow、text、textPath、image、video 和 htmlSurface 十六种 primitive。Figma 输入可能组合或降解到这些通用能力,但 Figma 节点类型与 Flamo primitive 不是简单的一对一枚举复制。

例如:

  • Rectangle 进入 ROUNDED_RECTANGLE,圆角与 smoothing 保留语义;
  • Polygon/Star 使用 canonical point 参数;
  • Vector/Path 进入经过校验的 vector command 与几何缓存;
  • Image/Video 通过注册资源与 media paint 表达;
  • Figma 专用业务对象应在上层编译为 Group/Vector/Path,而不是扩张 Runtime core。

语义字段与 fill/stroke geometry cache 必须一致。修改尺寸、圆角、path 或 stroke weight 后,应使对应派生缓存失效或重建;不能保留旧矩形缓存,让带圆角的语义最终画成直角。资源导入还应校验格式、尺寸、hash 与可移植项目路径。

结构 critic 只证明 scene 可加载;Runtime screenshot 只证明捕获到了像素。要声称与来源一致,需要把同一 Artifact revision 绑定到字体、资源和经过批准的参考图 pixel gate。查看 FlamoArtifact 手册可核对 scene 的精确字段。