唯杰地图 logo唯杰地图
VJMAP
EN

coordinate

vjcad/references/core/coordinate.md 3.4 KB91 行
原文

本文回答：vjcad 坐标系有 WCS（世界）/ UCS（用户）/ DCS（显示），常用转换在 Engine.trans 与 Engine.pcanvas.trans 上：CanvasToWcs / WcsToCanvas 用于鼠标 ↔ 图纸；WcsToUcs / UcsToWcs / WcsToDcs / DcsToWcs / UcsToDcs / DcsToUcs 在用户坐标系 / 显示坐标系之间转换；快捷写法 Engine.canvasToWcs(point)。

一、坐标系关系

引自 vjcad/doc/guide/architecture.md：

WCS（世界坐标系，绝对参考）  <-- WcsToUcs / UcsToWcs -->  UCS（用户坐标系，工作平面）
        ^                                                        ^
        |                                                        |
WcsToDcs / DcsToWcs                                       UcsToDcs / DcsToUcs
        v                                                        v
                  DCS（显示坐标系，屏幕像素）

二、最常用：鼠标 → 图纸

// 写法 A（示例里常见）
const canvas = Engine.pcanvas;
canvas.div.addEventListener('mousemove', (e) => {
  const canvasPt = new Point2D(e.offsetX, e.offsetY);
  const wcsPt    = canvas.trans.CanvasToWcs(canvasPt);
  console.log(`X: ${wcsPt.x.toFixed(2)}, Y: ${wcsPt.y.toFixed(2)}`);
});

// 写法 B（命令文档里常见）
const wcsPt2 = Engine.trans.CanvasToWcs(canvasPt);

// 写法 C（架构文档里出现）
const wcsPt3 = Engine.canvasToWcs(canvasPt);

来源命名差异：Engine.trans.CanvasToWcs 来自 vjcad/doc/command/api-reference.md；Engine.pcanvas.trans.CanvasToWcs 来自 vjcad/example/basic/03viewermode.js 与 04viewerremote.js；Engine.canvasToWcs 来自 vjcad/doc/guide/architecture.md。三处都有效，按你 IDE 里能解析到的即可。

MCP 参考：vjcad/example/basic/03viewermode.js、vjcad/example/basic/04viewerremote.js、vjcad/doc/command/api-reference.md、vjcad/doc/guide/architecture.md。

三、其他转换

// WCS <-> UCS（用于用户界面显示）
const ucsPt  = Engine.trans.WcsToUcs(wcsPt);
const wcsPt2 = Engine.trans.UcsToWcs(ucsPt);

// WCS <-> DCS（用于屏幕绘制）
const dcsPt  = Engine.trans.WcsToDcs(wcsPt);
const wcsPt3 = Engine.trans.DcsToWcs(dcsPt);

// UCS <-> DCS
const dcsPt2 = Engine.trans.UcsToDcs(ucsPt);
const ucsPt2 = Engine.trans.DcsToUcs(dcsPt2);

MCP 参考：vjcad/doc/guide/architecture.md。

四、Point2D 工具

import { Point2D } from 'vjcad';

const p1 = new Point2D(0, 0);
const p2 = new Point2D(100, 100);

p1.x; p1.y;
p1.clone();
p1.move(from, to);
p1.rotate(angle, center);
p1.offset(delta);
// ⚠️ Point2D 没有 distanceTo（distanceTo 只在 GeoPoint 上）；
// 两点距离用 Math.hypot(p2.x - p1.x, p2.y - p1.y)

MCP 参考：vjcad/doc/command/api-reference.md。

五、UCS 的程序操作

UCS 的旋转、原点设置、PLAN 重置等详见：

反例

  • 用 e.clientX / e.clientY 直接当画布坐标：应使用相对画布的 e.offsetX / e.offsetY，再 CanvasToWcs。
  • 把 Engine.trans.CanvasToWcs 与 Engine.pcanvas.trans.CanvasToWcs 当作两套不同 API：实际是同一对象的不同访问路径。

参考（官方文档 MCP）

  • 文档：vjcad/doc/guide/architecture.md、vjcad/doc/command/api-reference.md
  • 示例：vjcad/example/basic/03viewermode.js、vjcad/example/basic/04viewerremote.js