Fabric.js 图层的〔拼合〕与〔拆组〕:处理组合后的坐标换算

2026-10-08 143 浏览 0 评论 1242 字

多个图层合成一个组、再把组打散回独立图层,是编辑器的基本能力。难的不是 Group 本身,而是拆组那一刻:子对象的坐标、缩放、旋转、镜像,只要组合时经历过整体变换,拆出来就得全部重新换算,不然画面上会「瞬间跳变」。这篇就把最难的拆组坐标换算一次讲清楚。

一、组合(Group)

new fabric.Group(objects) 会把多个对象包成一个组,并以它们外接矩形的几何中心作为组的坐标原点。组合之后:

  • 组的 left/top 是组几何中心的坐标;
  • 子对象的 left/top 变成"相对组中心的偏移"。

组合这步本身不难,麻烦在于组合后要保留偏移,让一堆对象作为一个整体去移动、缩放:

function makeGroup(objects, canvas) {
  const group = new fabric.Group(objects);
  group.set({ originX: 'center', originY: 'center' });
  canvas.add(group);
  canvas.setActiveObject(group);
  return group;
}

二、拆组的坐标换算(核心难点)

先拆最简单的情况:组没旋转、没镜像。这时把子对象直接「提溜」出来,转换关系一目了然:

function splitGroupSimple(group, canvas) {
  const list = group._objects;
  const groupPos = group.getCenterPoint();
  const sx = group.scaleX, sy = group.scaleY;
  const created = [];

  list.forEach((child) => {
    child.set({
      left: group.left + child.left * sx,   // 相对于组中心的偏移 * 组缩放
      top: group.top + child.top * sy,
      scaleX: child.scaleX * sx,            // 组外缩放乘到子对象上
      scaleY: child.scaleY * sy,
      angle: group.angle + child.angle,      // 组角度和到子上
      originX: 'center',
      originY: 'center',
    });
    canvas.add(child);
    created.push(child);
  });

  canvas.remove(group);
  return created;
}

可一旦组带了旋转角度,就得把旋转造成的位置偏移也算进去。Fabric 提供了 fabric.util.rotatePoint,能把一个点在组坐标系里旋转:

// 先绕 (0,0) 旋转 group.angle,再加组中心
function rotatePointAround(x, y, degree) {
  const rad = fabric.util.degreesToRadians(degree);
  return {
    x: x * Math.cos(rad) - y * Math.sin(rad),
    y: x * Math.sin(rad) + y * Math.cos(rad),
  };
}

子对象的世界坐标 = rotatePoint(child.offsetX, child.offsetY, group.angle) + group.left/top。拆组时补上这一步,画面就不会跳。

三、镜像(flipX/flipY)最坑

水平、垂直镜像会翻转坐标符号。如果组同时 flipX + rotate(angle),换算顺序就特别讲究。经验法则是:先在未翻转的坐标系里做旋转换算,再对坐标取镜像,最后转回原坐标。可以拆成三步手写,也可以封装一个「旋转+镜像」的坐标函数:

function mirrorRotate(x, y, angleDeg, axis) {
  const rad = Math.PI / 180 * angleDeg;
  // 1. 先逆旋到旋转前坐标系
  const rx = x * Math.cos(-rad) - y * Math.sin(-rad);
  const ry = x * Math.sin(-rad) + y * Math.cos(-rad);
  // 2. 在旋转前坐标系里做镜像
  const mx = axis === 'x' ? -rx : rx;
  const my = axis === 'y' ? -ry : ry;
  // 3. 再旋回来
  return {
    x: mx * Math.cos(rad) - my * Math.sin(rad),
    y: mx * Math.sin(rad) + my * Math.cos(rad),
  };
}

四、子层的角度处理

组的旋转角是 group.angle,子对象自己还有个 angle。拆开后子对象的最终角度 = group.angle + child.angle;要是组的翻转次数是奇数,角度还得取反,不然内容会「镜像了但角度不对」。

五、避坑

  1. 坐标系基准搞混 :拆组坐标计算时 child.left/top 在组内是相对组中心的偏移,而最终对象在画布坐标系是绝对坐标。中间按顺序换算,别混。
  2. 忘了 originX/Y :拆出来的对象若不设 origin: center , left/top 语义是左上角,导致位置瞬移。统一用中心。
  3. 旋转 + 镜像叠加 :三个因素(位移、角度、镜像)必须照顺序处理,任何一项错,都会导致图案有 90° 或镜像不对称的"错乱"。
  4. 组的 _objects 顺序 : group._objects 是内部的集合,直接改前先 slice() 拷贝,避免 in-place 修改污染。
  5. 组合和拆分后的历史 :两者都会改变画布结构,记得 pushHistory,保证 undo。

六、验证

验证办法:构造三个矩形加一个组,给组旋转 30°、加水平镜像,然后拆组。逐项核对每个子对象的最终坐标、角度、镜像方向,再截图对比「拆前整体 vs 拆后逐个」,两边应该完全一致。

FAQ 常见问题

  • 问:拆出来之后子对象位置乱飞、不在原来的地方?
    说明换算顺序或基准不对: child.left/top 在组内是相对组中心的偏移,最终在画布坐标得把组的旋转/缩放/位移一起换算进去,并且统一 origin: center 。别混用 组内相对坐标 和 画布绝对坐标。
  • 问: flipX/flipY 镜像过的组,拆组后图案歪了或反了?
    镜像会影响子对象的 x/y 与角度符号。拆组时要按"位移 → 旋转 → 镜像"的固定顺序处理,任一项漏掉都会导致图案错 90° 或镜像不对称。
  • 问:怎么避免操作过程把组内部的 _objects 弄坏?
    _objects 是 Fabric 内部集合,直接 in-place 修改有风险。先 slice() 拷贝一份再遍历处理,不污染组本身;拆完记得把历史记录 push 进去,保证可 undo。

发布评论

发布评论前请先 登录。
0 评论
点赞
收藏

评论列表 0

暂无评论