SuperAPI AI 工具集

figma-3d-transforms

设计与创作

查看项目

更新于 11-13 14:17

技能介绍

figma-3d-transforms 是一项针对 Figma 的 3D 变换技能,用于在请求需要第三维度、普通平面 2D 旋转无法表达时,添加或编辑三维效果,例如透视、景深、Z 轴旋转、倾斜、等距布局、卡片翻转、视差堆叠,以及“让元素从屏幕中突出”等视觉表现。对于仅需平面内旋转的需求,该技能不适用,应直接设置节点的 2D 旋转。

主要能力围绕三个字段展开:node.transform3d 作用于任意节点,表示单个元素的三维姿态,写入形状为 { type: 'FIXED_ORDER', translateZ, rotateX, rotateY, rotateZ, backfaceVisible?, visible? },其中 translateZ 与三个旋转在写入时必填,旋转单位为度,组合顺序类似 CSS 的 translateZ() rotateX() rotateY() rotateZ();该结构本身不含透视,也不支持 X、Y 方向平移,水平或垂直移动需设置节点的 x / y 位置。node.scene3d 仅用于 FRAME、COMPONENT、INSTANCE 容器,写入形状为 { perspective, preserve3d, visible? },用于为容器的子元素提供共享三维空间与统一透视;perspective 为负值(如 -1)表示无透视,preserve3d 为 true 时子元素共享三维空间并可在深度上重叠,为 false 时子元素被平面投影到容器平面。node.transformOrigin 用于设定旋转支点,支持百分比(50 表示中心)或像素单位,默认为居中。

使用方式上,需要先加载 figma-use,并遵循其文件上下文、节点创建、输出与验证规则;在 skillNames 中包含两个技能名,通过 MCP 资源加载时各加 resource: 前缀。示例的 Plugin API 几何操作需在目标文件中通过 use_figma 执行,并按照 figma-use 要求的工作流在节点生成后再应用姿态。若 transform3d 不可用,应停止并说明当前会话未启用 3D 变换,不应重试不支持的接口或在未经用户同意时改用平面插画替代。

透视决策有明确顺序:优先遵循用户明确指定的投影方式(透视对应正距离,正交、等距或“无透视”对应 -1);对暗示物理空间、真实景深或进出屏幕的表述自动添加透视;当只有一个节点仅接受 X 或 Y 旋转时也自动添加透视;其他新三维请求应先简要询问是否添加透视,未确认前默认不加。透视距离建议从最长对象或场景尺寸的约 80% 起步,距离越大效果越细微,过小可能导致几何体朝相机爆炸;任何负距离表示无透视。透视始终位于容器上,通过 scene3d.perspective 暴露,这是形成统一消失点、让一组元素读作一个连贯空间的关键。

在结构上,若带填充的容器内有经过 3D 旋转的子元素,应保持父容器 preserve3d 为 false 以承载透视,并用一个中间帧设为 preserve3d: true 包裹三维子元素,避免旋转几何体切割父容器填充平面造成裁剪。同时不应在同一图层上同时放置 scene3d 透视与 transform3d,透视应位于被变换对象的上层,否则立方体会被渲染成截头锥体。对于门、书页、花瓣、展开等绕边缘或角点铰接的效果,需要移动 transformOrigin 到铰接点后再旋转;普通倾斜元素保留 backfaceVisible 默认开启,仅在正反面设计不同或实心立方体外表面时关闭。

该技能还提供多个操作配方:单元素景深(透视在父容器、旋转在元素)、多元素共享景深的场景(一个容器多个子元素,按索引设置 translateZ 与 rotateY)、环形或 3D 轮播(为每个项目旋转透明 preserve-3D 插槽,内部元素仅应用 translateZ)、等距立方体(三个正方形节点在透明平面框架中各自设置姿态,无透视用 -1)、六面立方体(在透明 preserve-3D 框架中组装垂直面后旋转框架选择视角)以及双面卡片翻转(旋转超过 90 度并隐藏背面)。

限制与注意事项包括:preserve-3D 框架自身不渲染不透明度、混合模式、效果与裁剪,需将这些属性放到平面祖先或包裹层上;scene3d 仅存在于 FRAME、COMPONENT、INSTANCE;写入 transform3d 或 scene3d 会替换整个对象,编辑单个字段时应展开当前值;旋转使用度而非弧度;无透视的单独 X/Y 倾斜只会产生透视缩短;三维场景中的裁剪或穿插通常是深度排序问题,可通过增大某个对象的 translateZ 使其前移;visible 在多数情况下应保持开启,仅在用户明确要求临时隐藏效果时关闭。整个过程中应以通俗语言与用户沟通,不暴露字段名或 Plugin API,并给出简短进度提示。