图形编辑器开发：参考线吸附功能，让图形自动对齐

news2024/11/26 22:21:03

最近我给图形编辑器增加了参照线吸附功能，讲讲我的实现思路。

我正在开发的图形设计工具：

https://github.com/F-star/suika

线上体验：

https://blog.fstars.wang/app/suika/

效果是被移动的图形会参考周围图形，自动与它们进行吸附对齐。

不得不说，很酷炫。

感觉这个图形编辑器突然变得灵动起来，有了灵魂一般。
在这里插入图片描述

为什么需要参照线吸附功能？

这里的参照线，指的是在移动目标图形时，当靠近其他图形的包围盒的延长线（看不见）时，会（1）绘制出最近的延长线和延长线上的点，（2）并将目标图形吸附上去，轻松实现（3）对齐的效果。

在这里插入图片描述

可以看到，通过参照线，我们很容易就能实现各种对齐，比如两图形的底边和定边对齐、右下角和左上角对齐。

这在 以对齐为基本要素 的视觉设计中，是非常好用的功能。

在这里插入图片描述

整体思路

整体思路为：

  1. 记录参照线；
  2. 找出目标图形最靠近的水平参照线和垂直参照线；
  3. 计算出偏移值 offsetX、offsetY；
  4. 标记要绘制的所有参照线段（不是两端无限延长的）；
  5. 修正图形的 x、y；
  6. 绘制参照线和点。

记录参照线

首先是确定能够作为 “参照” 的参照图形。

通常来说，参照图形为视口内的图形，并排除掉被移动的目标图形。视口外的图形通常都不在设计师的关注区域内。

确认好参照图形后，计算出它们的包围盒（bbox）。

这次的包围盒有点特殊，要多给一个中点坐标，因为中线也要作为参照线。

接口签名为：

export interface IBoxWithMid {
  minX: number;
  minY: number;
  midX: number;
  midY: number;
  maxX: number;
  maxY: number;
}

它们组成了参照图形的 8 个点，沿着这些点绘制竖线和横线，就是被移动的目标图形对应要吸附的参照线。

被移动的图形也要计算包围盒，并得到 5 个点。基于这些点的产生的水平线和垂直线，在靠近参照线时会吸附到最近的参照线上，分为水平移动和垂直移动两个维度。

编辑器上的效果：

我们首先要把所有的参照线记录下来，在图形准备移动（mousedown）的时候。大致有以下这几个操作：

  1. 遍历参照图形（在视口内，且不为被移动目标图形）；
  2. 计算出它们的包围盒，得到 8 个点，3 条垂直线和 3 条水平线。在一条垂直线上的多个点，其 x 值是相同的，y 不同，我们 x 作为 key，y 的数组为 value，保存到 hLineMap 映射对象中。每一项代表一条垂直线；
  3. 水平线同理，保存在 vLineMap 中。
  4. 然后对这两个 map 的 key 保存到 sortedXs 或 sortedYs 数组中，并排序，方便之后二分查找提高查找效率。

抽象一个 RefLine（参照线）类。

interface IVerticalLine { // 有多个端点的垂直线
  x: number;
  ys: number[];
}

interface IHorizontalLine { // 有多个端点的水平线
  y: number;
  xs: number[];
}


class RefLine {
  // 参照图形产生的垂直参照线，y 相同（作为 key），x 值不同（作为 value）
  private hLineMap = new Map<number, number[]>();
  // 参照图形产生的水平照线，x 相同（作为 key），y 值不同（作为 value）
  private vLineMap = new Map<number, number[]>(); 

  // 对 hLineMap 的 key 排序，方便高效二分查找，找到最近的线
  private sortedXs: number[] = []; 
  // 对 vLineMap 的 key 排序
  private sortedYs: number[] = []; 

  private toDrawVLines: IVerticalLine[] = []; // 等待绘制的垂直参照线
  private toDrawHLines: IHorizontalLine[] = []; // 等待绘制的水平参照线

  constructor(private editor: Editor) {}

  cacheXYToBbox() {
    this.clear();

    const hLineMap = this.hLineMap;
    const vLineMap = this.vLineMap;

    const selectIdSet = this.editor.selectedElements.getIdSet();
    const viewportBbox = this.editor.viewportManager.getBbox2();
    for (const graph of this.editor.sceneGraph.children) {
      // 排除掉被移动的图形
      if (selectIdSet.has(graph.id)) {
        continue;
      }

      const bbox = bboxToBboxWithMid(graph.getBBox2());
      // 排除在视口外的图形
      if (!isRectIntersect2(viewportBbox, bbox)) {
        continue;
      }
			
      // 将参照图形记录下来
   
      // 这里是水平线，特点是 x 相同。
      this.addBboxToMap(hLineMap, bbox.minX, [bbox.minY, bbox.maxY]);
      this.addBboxToMap(hLineMap, bbox.midX, [bbox.minY, bbox.maxY]);
      this.addBboxToMap(hLineMap, bbox.maxX, [bbox.minY, bbox.maxY]);

      this.addBboxToMap(vLineMap, bbox.minY, [bbox.minX, bbox.maxX]);
      this.addBboxToMap(vLineMap, bbox.midY, [bbox.minX, bbox.maxX]);
      this.addBboxToMap(vLineMap, bbox.maxY, [bbox.minX, bbox.maxX]);
    }

    this.sortedXs = Array.from(hLineMap.keys()).sort((a, b) => a - b);
    this.sortedYs = Array.from(vLineMap.keys()).sort((a, b) => a - b);
  }
  
  private addBboxToMap(
    m: Map<number, number[]>,
    xOrY: number,
    xsOrYs: number[],
  ) {
    const line = m.get(xOrY);
    if (line) {
      line.push(...xsOrYs);
    } else {
      m.set(xOrY, [...xsOrYs]);
    }
  }
  
  // ...
}

找出最近参照线

然后是找出目标图形最靠近的水平参照线和垂直参照线。

这一步是在图形移动（mousemove）时做的，是动态变化的。

首先我们分别找到目标图形的 minX、midX、maxX 的最近垂直参照线。

然后计算出它们各自的绝对距离。

最后找出这里面最小的一个。

class RefLinet {
  updateRefLine(_targetBbox: IBox2): {
    offsetX: number;
    offsetY: number;
  } {
    // 重置
    this.toDrawVLines = [];
    this.toDrawHLines = [];
    
    // 目标对象的包围盒，这里补上 midX，midY
    const targetBbox = bboxToBboxWithMid(_targetBbox);

    const hLineMap = this.hLineMap;
    const vLineMap = this.vLineMap;
    const sortedXs = this.sortedXs;
    const sortedYs = this.sortedYs;

    // 一个参照图形都没有，结束
    if (sortedXs.length === 0 && sortedYs.length === 0) {
      return { offsetX: 0, offsetY: 0 };
    }

    // 如果 offsetX 到最后还是 undefined，说明没有找到最靠近的垂直参照线
    let offsetX: number | undefined = undefined;
    let offsetY: number | undefined = undefined;

    // 分别找到目标图形的 minX、midX、maxX 的最近垂直参照线
    const closestMinX = getClosestValInSortedArr(sortedXs, targetBbox.minX);
    const closestMidX = getClosestValInSortedArr(sortedXs, targetBbox.midX);
    const closestMaxX = getClosestValInSortedArr(sortedXs, targetBbox.maxX);

    // 分别计算出距离
    const distMinX = Math.abs(closestMinX - targetBbox.minX);
    const distMidX = Math.abs(closestMidX - targetBbox.midX);
    const distMaxX = Math.abs(closestMaxX - targetBbox.maxX);

    // 找到最近距离
    const closestXDist = Math.min(distMinX, distMidX, distMaxX);
    
    // y 同理
  }
}

这里有一个比较重要的算法，就是找出排序数组中，离目标值最近的数组元素。

该算法二分查找的变体，虽然原理不复杂，但一次能写对，很难。这里我是找 gpt 帮我写的，非常完美。

实现如下：

const getClosestValInSortedArr = (
  sortedArr: number[],
  target: number,
) => {
  if (sortedArr.length === 0) {
    throw new Error('sortedArr can not be empty');
  }
  if (sortedArr.length === 1) {
    return sortedArr[0];
  }

  let left = 0;
  let right = sortedArr.length - 1;

  while (left <= right) {
    const mid = Math.floor((left + right) / 2);

    if (sortedArr[mid] === target) {
      return sortedArr[mid];
    } else if (sortedArr[mid] < target) {
      left = mid + 1;
    } else {
      right = mid - 1;
    }
  }

  // check if left or right is out of bound
  if (left >= sortedArr.length) {
    return sortedArr[right];
  }
  if (right < 0) {
    return sortedArr[left];
  }

  // check which one is closer
  return Math.abs(sortedArr[right] - target) <=
    Math.abs(sortedArr[left] - target)
    ? sortedArr[right]
    : sortedArr[left];
};

计算偏移值

前面我们得到了最小距离 closestXDist。

接着我们要判断其是否小于一个特定的临界值 tol。不可能你离着十米开外，移动一下就千里迢迢吸附过来了吧。

如果满足，我们继续。

offsetX 就差一步了，我们需要确定正负，因为 closestXDist 是一个绝对值。

那我们就拿这个最小距离和之前计算出的三个距离 distMinX、distMidX、distMaxX对比，找到相等的，就能计算出 offsetX 了。

const isEqualNum = (a: number, b: number) => Math.abs(a - b) < 0.00001;
    
const tol = 5 / zoom; // 最小距离不能超过这个

// 确认偏移值 offsetX
if (closestXDist <= tol) {
  // 这里考虑了一下浮点数误差
  if (isEqualNum(closestXDist, distMinX)) {
    offsetX = closestMinX - targetBbox.minX;
  } else if (isEqualNum(closestXDist, distMidX)) {
    offsetX = closestMidX - targetBbox.midX;
  } else if (isEqualNum(closestXDist, distMaxX)) {
    offsetX = closestMaxX - targetBbox.maxX;
  } else {
    throw new Error('it should not reach here, please put a issue to us');
  }
}

offsetY 同理，不赘述。

标记需绘制参照线段

计算出了 offsetX 和 offsetY。

接下来要修正一下我们的 targetBbox。

const correctedTargetBbox = { ...targetBbox };
if (offsetX !== undefined) {
  correctedTargetBbox.minX += offsetX;
  correctedTargetBbox.midX += offsetX;
  correctedTargetBbox.maxX += offsetX;
}
if (offsetY !== undefined) {
  correctedTargetBbox.minY += offsetY;
  correctedTargetBbox.midY += offsetY;
  correctedTargetBbox.maxY += offsetY;
}

修正后的目标图形，它的边就和一些参照线发生了对齐。

对齐的参照线，可能一条没有，可能只有一条，也可能有最多的 6 条。

基于新的目标图形，我们来找它落在的参照线有哪些。

// offsetX 不为 undefined，说明落在了临界值内
if (offsetX !== undefined) {
  /*************** 左垂直的参考线 ************/
  // 对比 “offset” 和 “离 minX 最近的垂直线到 minX 的距离（不是绝对值）”
  if (isEqualNum(offsetX, closestMinX - targetBbox.minX)) {
    // 创建一个垂直线对象（特点是这些点的 x 相同）
    const vLine: IVerticalLine = {
      x: closestMinX,
      ys: [],
    };

    // 修正后的目标图形的对应点。
    vLine.ys.push(correctedTargetBbox.minY);
    vLine.ys.push(correctedTargetBbox.maxY);
    // 参照图形上的点
    vLine.ys.push(...hLineMap.get(closestMinX)!);

    // 添加到 “待绘制垂线集合”
    this.toDrawVLines.push(vLine);
  }
  /*************** 中间垂直的参考线 ************/
  if (isEqualNum(offsetX, closestMidX - targetBbox.midX)
  ) {
    const vLine: IVerticalLine = {
      x: closestMidX,
      ys: [],
    };

    vLine.ys.push(correctedTargetBbox.midY);
    vLine.ys.push(...hLineMap.get(closestMidX)!);

    this.toDrawVLines.push(vLine);
  }
  /*************** 右垂直的参考线 ************/
  // ...
}

// 水平线同理
if (offsetY !== undefined) {
  /*************** 上水平的参考线 ************/
  /*************** 中间水平的参考线 ************/
  /*************** 下水平的参考线 ************/
}

修正图形的 x、y

计算出的 offsetX 和 offsetY，记得拿去修正被移动目标图形的 x 和 y。

const onMousemove = (e) => {
  // ...

  const { offsetX, offsetY } = this.editor.refLine.updateRefLine(
    bboxToBbox2(this.editor.selectedElements.getBBox()!),
  );

  // 修正
  for (let i = 0, len = selectedElements.length; i < len; i++) {
    selectedElements[i].x = startPoints[i].x + dx + offsetX;
    selectedElements[i].y = startPoints[i].y + dy + offsetY;
  }
}

绘制参照线和点

最后是绘制参照线，以绘制垂直线为例。

for (const vLine of this.toDrawVLines) {
  let minY = Infinity;
  let maxY = -Infinity;

  // 这个是世界坐标系转视口坐标系
  const { x } = this.editor.sceneCoordsToViewport(vLine.x, 0);
  
  // 遍历绘制点
  for (const y_ of vLine.ys) {
    // TODO: optimize
    const { y } = this.editor.sceneCoordsToViewport(0, y_);
    minY = Math.min(minY, y);
    maxY = Math.max(maxY, y);

    // 可能有重复的点，用备忘录排除掉
    const key = `${x},${y}`;
    if (pointsSet.has(key)) {
      continue;
    }
    pointsSet.add(key);

    // 绘制点
    drawXShape(ctx, x, y, pointSize);
  }

  // 所有点中的 minY 和 maxY，绘制线段
  drawLine(ctx, x, minY, x, maxY);
}

水平线同理。

优化点

  1. 这里的实现，在图形有旋转角度的时候，参照线会过多显得冗余，可以精简一些，减少要对比的参照线；
  2. 对齐到像素网格的时候，包围盒的值要取整；
  3. 考虑和按住 Shift 固定 x 或 y 平移的情况。

最后

总结一下，参考线吸附的实现，就是找出最近的垂直线和水平线，计算出 offsetX 和 offsetY，修正被移动图形的 x 和 y，并记录并绘制出最终重合的参考线。

我是前端西瓜哥，欢迎关注我，学习更多图形编辑器知识。

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.coloradmin.cn/o/742588.html

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈，一经查实，立即删除！

相关文章

Linux配置静态IP

Linux配置静态IP

Linux配置静态IP 提示&#xff1a;本地虚拟机模拟服务器配置静态IP&#xff0c;大家如果有云服务器也是一样的&#xff0c;后期会出关于云服务器如何配置静态IP 文章目录 Linux配置静态IP一、IP地址的简单介绍二、查看虚拟机的中的网关IP地址三、编辑网络配置文件四、SSH连接五…
阅读更多...
码中寻趣：低码专家与开发者的「神秘会议」 ——华为云Astro扫地僧出山

码中寻趣：低码专家与开发者的「神秘会议」 ——华为云Astro扫地僧出山

迅速推进的数字生态让软件开发门槛越来越高&#xff0c;新手们无疑面临艰巨挑战&#xff0c;而低代码技术显然是绝佳应对方案&#xff0c;让全民用较短的时间开发出工业级应用。 HDC.Cloud 2023扫地僧见面会汇聚华为云资深专家和充满好奇心的开发者。 当刺耳手机铃和颤动的讨论…
阅读更多...
GitHub 集成 Murphysec 实现实时代码检测

GitHub 集成 Murphysec 实现实时代码检测

1. GitHub 集成 Murphysec 效果 将 MurphySec 代码安全检测工具集成到 GitHub Action 中&#xff0c;可对每一次代码更新实时进行安全漏洞检测&#xff0c;并快速修复这些安全漏洞。 集成效果图 2. 操作步骤 提示&#xff1a;如果您使用过 GitHub Actions 请直接按照第3步开始…
阅读更多...
Excel二级联动下拉列表（横向字典配置）

Excel二级联动下拉列表（横向字典配置）

二级联动下拉列表 1. Excel内新建sheet用来存放二级联动列表 2. 新建省份名称引用 在省市字典下&#xff0c;单击A1单元格&#xff0c;选择公式->名称管理器->新建&#xff0c;名称为省份&#xff0c;引用位置为OFFSET(省市字典!$A$1,0,0,COUNTA(省市字典!$A:$A))&…
阅读更多...
【 Python 全栈开发 - 人工智能篇 - 41 】线性回归算法

【 Python 全栈开发 - 人工智能篇 - 41 】线性回归算法

文章目录 一、简介1.1 什么是线性回归&#xff1f;1.2 线性回归在人工智能中的应用预测分析特征工程异常检测 1.3 Python 在人工智能中的角色数据处理和分析机器学习和深度学习自然语言处理 二、理解线性回归2.1 线性回归的基本原理2.2 线性回归模型的假设2.3 线性回归的评估指…
阅读更多...
string——find()，rfind()

string——find()，rfind()

文章目录 find&#xff08;正向查找&#xff09; 正向查抄&#xff0c;会返回要找的子串中第一字符再父串中的下标值 rfind&#xff08;逆向查找&#xff09; std::string url "https://img.bizhizu.com/2015/1231/hskdkfl.jpg";int begin url.find(/); int end …
阅读更多...
如何写一个springboot-starter

如何写一个springboot-starter

使用场景 在目前广泛的微服务治理环境下&#xff0c;我们所开发的代码模块&#xff0c;越来越关注于某一项功能而不是宽泛的整个系统的功能。 所以在我们进行服务拆分的时候&#xff0c;经常会遇到这么一个问题&#xff0c;某些会被不同的模块重复使用&#xff0c;为了避免代…
阅读更多...
Vue 3 中使用 Chart.js

Vue 3 中使用 Chart.js

要在 Vue 3 中使用 Chart.js&#xff0c;您需要先安装和引入 Chart.js 库&#xff0c;并创建一个 Vue 组件来承载图表。 1. 安装库 shell cnpm i chart.js moment chartjs-adapter-moment 2. 代码示例 <template><div><canvas id"chartCanvas">…
阅读更多...
数字孪生系统如何整合CesiumJS？之后会产生什么效果？

数字孪生系统如何整合CesiumJS？之后会产生什么效果？

数字孪生有关的项目中&#xff0c;智慧城市一直是一个比较重要的类型&#xff0c;但是这类智慧城市项目往往包含了大量的GIS相关数据&#xff0c;例如倾斜摄影、DEM、DOM、地形数据等。这时&#xff0c;将GIS系统融合进数字孪生系统的需求就出现了。 这时一个新的问题就出现了…
阅读更多...
Qt(Day5)

Qt(Day5)

写TCP服务器与客户端&#xff1a;
阅读更多...
接口测试模块完整版

接口测试模块完整版

先上代码 #data_test.py from openpyxl import load_workbook class Date_test():classmethoddef Date_test_1(cls):"""配置文件读取模块:return:"""wb load_workbook("data_test.xlsx")ws wb["Sheet1"]url http://loca…
阅读更多...
第五节 配置SpringBootAdmin电子邮件通知

第五节 配置SpringBootAdmin电子邮件通知

本来想用一节就写完SpringBootAdmin的&#xff0c;但随着研究的深入发现一节应该是不够的&#xff0c;网上的资料也不会非常系统&#xff0c;官网的例子有些已经好几年没更新了&#xff0c;所以接下来还是系统性的来写下吧 第一节 完成基础配置&#xff0c;暴露所有端点 第二节…
阅读更多...
智能机器人嵌入ChatGPT会给社会带来哪些进步

智能机器人嵌入ChatGPT会给社会带来哪些进步

智能机器人技术在当今世界中扮演着越来越重要的角色&#xff0c;而其中一个令人印象深刻的例子就是ChatGPT。ChatGPT是一种基于人工智能的对话系统&#xff0c;它利用强大的自然语言处理和生成模型&#xff0c;可以与人类进行自然而流畅的对话。ChatGPT内置了智能机器人技术&am…
阅读更多...
哈达玛矩阵乘法

哈达玛矩阵乘法

哈达玛矩阵乘法 作者: 赵晓鹏时间限制: 1S章节: 递归与分治 输入说明 : 见问题描述。 输出说明 : 见问题描述。 输入范例 : 1 4 -6 输出范例 : -2 10 #include <iostream> #include <vector> using namespace std; vector<int>res; void cal(int len…
阅读更多...
汽车EBSE测试流程分析（三）：通过系统调研确定改进方案

汽车EBSE测试流程分析（三）：通过系统调研确定改进方案

EBSE专题连载共分为“五个”篇章。此文为该连载系列的“第三”篇章&#xff0c;在之前的“篇章&#xff08;二&#xff09;”中已经分析了EBSE步骤一&#xff1a;关于优势和挑战的案例研究。在本篇章&#xff08;三&#xff09;中&#xff0c;我们将结合具体研究实践&#xff0…
阅读更多...
TikTok小店运营必看攻略！

TikTok小店运营必看攻略！

众所周知&#xff0c;国内的抖音早已风生水起&#xff0c;抖音给了很多普通人一夜暴富的机会。而Tiktok也跟随着抖音开启了商业模式&#xff0c;目前流量与机会都是不可小觑的。在店铺申请通过&#xff0c;成功入驻之后&#xff0c;又该如何运营&#xff1f;这篇文章为大家解答…
阅读更多...
小程序自定义海报

小程序自定义海报

如图微信小程序生成海报自定义调整位置 //微信小程序组件 poster.wxml<view styleposition: relative;{{customStyle}};{{painterStyle}}><block wx:if"{{!use2D}}"><canvas canvas-id"photo" style"{{photoStyle}};position: absolut…
阅读更多...
揭开液体活检技术的神秘面纱

揭开液体活检技术的神秘面纱

液体活检&#xff08;liquid biopsy&#xff09;是新兴的肿瘤诊断技术&#xff0c;与传统检测手段相比具有创伤性小、取样便捷、可实时动态检测等优势&#xff0c;在肿瘤早期筛查、分子分型、复发监测和预后评估等方面起到重要作用。 图 1 与传统的组织活检相比&#xff0c;液…
阅读更多...
路径规划算法：基于爬行动物优化的路径规划算法- 附代码

路径规划算法：基于爬行动物优化的路径规划算法- 附代码

路径规划算法&#xff1a;基于爬行动物优化的路径规划算法- 附代码 文章目录 路径规划算法&#xff1a;基于爬行动物优化的路径规划算法- 附代码1.算法原理1.1 环境设定1.2 约束条件1.3 适应度函数 2.算法结果3.MATLAB代码4.参考文献 摘要&#xff1a;本文主要介绍利用智能优化…
阅读更多...
【分布式应用】Filebeat+ELK 部署、logstash filter四大过滤插件

【分布式应用】Filebeat+ELK 部署、logstash filter四大过滤插件

目录 一、 FilebeatELK 部署1.1在 Filebeat 节点上操作1.1.1安装 Filebeat1.1.2设置 filebeat 的主配置文件1.1.3 在 Logstash 组件所在节点上新建一个 Logstash 配置文件1.1.4浏览器访问测试 二 、filter四大插件2.1grok 正则捕获插件2.1.1内置正则表达式调用 2.2logstash 官方…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023