youle_cocos/cocoscreator_projects/scripts/ui-migration/coords.mjs

/**
 * 坐标换算与锚点推断。见 spec §2。
 * 旧引擎：原点左上、Y 向下、精灵锚点左上。
 * Cocos：原点在父节点中心、Y 向上、节点锚点 (0.5, 0.5)。
 */

// 旧 UI 内容区基准（数据源事实，不可变）。
// 991 个对象的 Left/Top 都是相对旧引擎 1280×720 画布给出的，坐标换算、三区锚点、
// 满屏/越界判断都据此判定。它与「设计分辨率画布宽度」是两回事，见 CANVAS_WIDTH。
export const DESIGN_WIDTH = 1280;
export const DESIGN_HEIGHT = 720;

// Cocos 设计分辨率画布（20:9 主流移动端比例）。落地时 Layer/Group 根节点据此设定
// UITransform 尺寸，运行时 Canvas 按 designResolution + fitHeight 对齐到屏幕。
// 对象坐标与 Widget 值仍以 DESIGN_WIDTH 为基准——靠左贴左、靠右贴右、居中在中心，
// 画布变宽由 Widget 弹性贴边消化，无需重算坐标。
export const CANVAS_WIDTH = 1600;
export const CANVAS_HEIGHT = 720;

const HALF_W = DESIGN_WIDTH / 2;
const HALF_H = DESIGN_HEIGHT / 2;
const LEFT_ZONE = DESIGN_WIDTH / 4;         // 320
const RIGHT_ZONE = (DESIGN_WIDTH * 3) / 4;  // 960

/** 左上坐标 → Cocos 中心锚点坐标。spec §2.2。 */
export function toCocosPosition(left, top, width, height) {
  return {
    x: left + width / 2 - HALF_W,
    y: HALF_H - top - height / 2,
  };
}

/**
 * 水平锚点三区推断。spec §2.3。
 * fitHeight 下垂直方向永远精确撑满，故不推断垂直锚点。
 */
export function inferWidget(left, width) {
  const cx = left + width / 2;
  if (cx < LEFT_ZONE) return { horizontal: 'left', left };
  if (cx > RIGHT_ZONE) return { horizontal: 'right', right: DESIGN_WIDTH - (left + width) };
  return { horizontal: 'center', horizontalCenter: cx - HALF_W };
}

/** 背景与遮罩：四边拉伸。spec §2.4。 */
export function stretchWidget() {
  return { horizontal: 'stretch', vertical: 'stretch', left: 0, right: 0, top: 0, bottom: 0 };
}

export function isFullScreen(width, height) {
  return width >= DESIGN_WIDTH && height >= DESIGN_HEIGHT;
}

/** 坐标超出画布。spec §2.5：不裁剪，只标记。 */
export function isOffscreen(left, top, width, height) {
  return left < 0 || top < 0 || left + width > DESIGN_WIDTH || top + height > DESIGN_HEIGHT;
}