Maker.js中的点操作API详解-CSDN博客

本文链接：https://blog.csdn.net/gitblog_01095/article/details/148943930

Maker.js中的点操作API详解

概述

Maker.js是一个强大的2D矢量图形库，专门用于创建和操作CAD图纸。在Maker.js中，点(Point)是最基础的几何元素之一，用于表示二维空间中的坐标位置。本文将深入解析Maker.js中关于点操作的核心API，帮助开发者更好地理解和使用这些功能。

基础点操作

1. 点的加减运算

makerjs.point.add()函数提供了两个点的加法运算能力：

/**
 * 将两个点相加并返回结果
 * @param a 第一个点
 * @param b 第二个点
 * @param subtract 可选参数，设为true时执行减法而非加法
 * @returns 新的点对象
 */
function add(a: IPoint, b: IPoint, subtract?: boolean): IPoint

这个函数实际上可以执行两种操作：

当subtract为false或未提供时：执行点加法 (a + b)
当subtract为true时：执行点减法 (a - b)

2. 点平均计算

makerjs.point.average()函数计算两个点的中点：

/**
 * 计算两个点的平均值（中点）
 * @param a 第一个点
 * @param b 第二个点
 * @returns 两个点的中点
 */
function average(a: IPoint, b: IPoint): IPoint

这在需要找到两点中间位置时非常有用，比如绘制连接线时确定中点。

3. 点克隆

makerjs.point.clone()函数创建点的深拷贝：

/**
 * 克隆一个点
 * @param pointToClone 需要克隆的点
 * @returns 新的点对象
 */
function clone(pointToClone: IPoint): IPoint

在JavaScript中，直接赋值会导致对象引用传递，使用clone可以确保获得完全独立的新点对象。

高级点操作

1. 最近点查找

makerjs.point.closest()函数在一组点中查找距离参考点最近的点：

/**
 * 从一组点中找出距离参考点最近的点
 * @param referencePoint 参考点
 * @param pointOptions 候选点数组
 * @returns 距离最近的点
 */
function closest(referencePoint: IPoint, pointOptions: IPoint[]): IPoint

这个函数在需要寻找最近邻点时非常有用，比如在路径连接或碰撞检测中。

2. 点变形

makerjs.point.distort()函数可以对点进行非均匀缩放：

/**
 * 对点进行变形（非均匀缩放）
 * @param pointToDistort 需要变形的点
 * @param scaleX X轴缩放比例
 * @param scaleY Y轴缩放比例
 * @returns 变形后的新点
 */
function distort(pointToDistort: IPoint, scaleX: number, scaleY: number): IPoint

这在需要实现非均匀缩放效果时非常有用，比如创建透视效果或特殊变形。

特殊点生成

1. 圆/弧上的点

makerjs.point.fromAngleOnCircle()函数可以获取圆或圆弧上指定角度的点：

/**
 * 获取圆或圆弧上指定角度的点
 * @param angleInDegrees 角度值（度）
 * @param circle 圆或圆弧对象
 * @returns 圆上的点
 */
function fromAngleOnCircle(angleInDegrees: number, circle: IPathCircle): IPoint

这在需要沿圆周精确放置元素时非常有用。

2. 路径端点获取

makerjs.point.fromPathEnds()函数可以获取路径的两个端点：

/**
 * 获取路径的两个端点
 * @param pathContext 路径对象
 * @param pathOffset 可选偏移量
 * @returns 包含起点和终点的数组
 */
function fromPathEnds(pathContext: IPath, pathOffset?: IPoint): IPoint[]

对于开放路径（如直线、圆弧），返回起点和终点；对于闭合路径（如圆），返回相同的点。

实际应用示例

示例1：计算多边形中心

const points = [
  { x: 0, y: 0 },
  { x: 10, y: 0 },
  { x: 10, y: 10 },
  { x: 0, y: 10 }
];

// 计算所有点的平均值作为中心点
let center = { x: 0, y: 0 };
points.forEach(p => {
  center = makerjs.point.add(center, p);
});
center = makerjs.point.scale(center, 1 / points.length);

示例2：沿圆周均匀分布点

const circle = { type: 'circle', origin: [0, 0], radius: 50 };
const points = [];

// 每隔30度在圆上放置一个点
for (let angle = 0; angle < 360; angle += 30) {
  points.push(makerjs.point.fromAngleOnCircle(angle, circle));
}