@maplat/transform 0.4.1 → 0.5.1

package/src/types.ts

@@ -1,122 +1,162 @@
-import type { Feature, FeatureCollection, Polygon, Point, Position } from "geojson";
-import type {
-  IndexedTins,
-  Tins,
-  VerticesParams,
-  WeightBuffer
-} from "./geometry.ts";
-import type { EdgeSet, EdgeSetLegacy } from "./edgeutils.ts";
-
-/**
- * Two-way coordinate pair: [source, target].
- */
-export type PointSet = [Position, Position];
-
-/**
- * Directional selector shared across the codebase.
- */
-export type BiDirectionKey = "forw" | "bakw";
-
-/**
- * Weight buffers indexed by node id for both directions.
- */
-export type WeightBufferBD = { [key in BiDirectionKey]?: WeightBuffer };
-
-/**
- * Vertex interpolation modes.
- */
-export type VertexMode = "plain" | "birdeye";
-
-/**
- * Strictness flags supported during transformation.
- */
-export type StrictMode = "strict" | "auto" | "loose";
-
-/**
- * Result of strictness evaluation.
- */
-export type StrictStatus = "strict" | "strict_error" | "loose";
-
-/**
- * Y-axis handling directive.
- */
-export type YaxisMode = "follow" | "invert";
-
-export type Centroid = Feature<Point>;
-export type CentroidBD = { [key in BiDirectionKey]?: Centroid };
-export type TinsBD = { [key in BiDirectionKey]?: Tins };
-export type Kinks = FeatureCollection<Point>;
-export type KinksBD = { [key in BiDirectionKey]?: Kinks };
-export type VerticesParamsBD = { [key in BiDirectionKey]?: VerticesParams };
-export type IndexedTinsBD = { [key in BiDirectionKey]?: IndexedTins };
-
-/**
- * Serialized structure generated by MaplatTin and consumed by Transform.
- */
-export interface Compiled {
-  version?: number;
-  points: PointSet[];
-  tins_points: (number | string)[][][];
-  weight_buffer: WeightBufferBD;
-  strict_status?: StrictStatus;
-  centroid_point: Position[];
-  edgeNodes?: PointSet[];
-  kinks_points?: Position[];
-  yaxisMode?: YaxisMode;
-  vertexMode?: VertexMode;
-  strictMode?: StrictMode;
-  vertices_params: number[][];
-  vertices_points: PointSet[];
-  edges: EdgeSet[];
-  bounds?: number[][];
-  boundsPolygon?: Feature<Polygon>;
-  wh?: number[];
-  xy?: number[];
-}
-
-/**
- * Historical serialization format prior to 2.00703.
- */
-export interface CompiledLegacy extends Compiled {
-  tins?: TinsBD;
-  centroid?: CentroidBD;
-  kinks?: KinksBD;
-  vertices_params: number[][] & VerticesParamsBD;
-  edges: EdgeSet[] & EdgeSetLegacy[];
-}
-
-/**
- * Normalized state derived from modern compiled payloads.
- */
-export interface ModernStatePayload {
-  points: PointSet[];
-  pointsWeightBuffer: WeightBufferBD;
-  strictStatus: StrictStatus;
-  verticesParams: VerticesParamsBD;
-  centroid: CentroidBD;
-  edges: EdgeSet[];
-  edgeNodes?: PointSet[];
-  tins: TinsBD;
-  kinks?: KinksBD;
-  yaxisMode: YaxisMode;
-  strictMode: StrictMode;
-  vertexMode?: VertexMode;
-  bounds?: number[][];
-  boundsPolygon?: Feature<Polygon>;
-  wh?: number[];
-  xy?: number[];
-}
-
-/**
- * Normalized snapshot captured from legacy payloads.
- */
-export interface LegacyStatePayload {
-  compiled: CompiledLegacy;
-  tins: TinsBD;
-  points: PointSet[];
-  strictStatus?: StrictStatus;
-  pointsWeightBuffer: WeightBufferBD;
-  verticesParams: VerticesParamsBD;
-  centroid?: CentroidBD;
-  kinks?: KinksBD;
-}
+import type { Feature, FeatureCollection, Polygon, Point, Position } from "geojson";
+import type {
+  IndexedTins,
+  Tins,
+  VerticesParams,
+  WeightBuffer
+} from "./geometry.ts";
+import type { EdgeSet, EdgeSetLegacy } from "./edgeutils.ts";
+
+/**
+ * Two-way coordinate pair: [source, target].
+ */
+export type PointSet = [Position, Position];
+
+/**
+ * Directional selector shared across the codebase.
+ */
+export type BiDirectionKey = "forw" | "bakw";
+
+/**
+ * Weight buffers indexed by node id for both directions.
+ */
+export type WeightBufferBD = { [key in BiDirectionKey]?: WeightBuffer };
+
+/**
+ * Vertex interpolation modes.
+ */
+export type VertexMode = "plain" | "birdeye";
+
+/**
+ * Strictness flags supported during transformation.
+ */
+export type StrictMode = "strict" | "auto" | "loose";
+
+/**
+ * Result of strictness evaluation.
+ */
+export type StrictStatus = "strict" | "strict_error" | "loose";
+
+/**
+ * Y-axis handling directive.
+ */
+export type YaxisMode = "follow" | "invert";
+
+export type Centroid = Feature<Point>;
+export type CentroidBD = { [key in BiDirectionKey]?: Centroid };
+export type TinsBD = { [key in BiDirectionKey]?: Tins };
+export type Kinks = FeatureCollection<Point>;
+export type KinksBD = { [key in BiDirectionKey]?: Kinks };
+export type VerticesParamsBD = { [key in BiDirectionKey]?: VerticesParams };
+export type IndexedTinsBD = { [key in BiDirectionKey]?: IndexedTins };
+
+/**
+ * Serialized structure generated by MaplatTin and consumed by Transform.
+ */
+export interface Compiled {
+  version?: number;
+  points: PointSet[];
+  tins_points: (number | string)[][][];
+  weight_buffer: WeightBufferBD;
+  strict_status?: StrictStatus;
+  centroid_point: Position[];
+  edgeNodes?: PointSet[];
+  kinks_points?: Position[];
+  yaxisMode?: YaxisMode;
+  vertexMode?: VertexMode;
+  strictMode?: StrictMode;
+  vertices_params: number[][];
+  vertices_points: PointSet[];
+  edges?: EdgeSet[];
+  bounds?: number[][];
+  boundsPolygon?: Feature<Polygon>;
+  wh?: number[];
+  xy?: number[];
+}
+
+/**
+ * Historical serialization format prior to 2.00703.
+ */
+export interface CompiledLegacy extends Compiled {
+  tins?: TinsBD;
+  centroid?: CentroidBD;
+  kinks?: KinksBD;
+  vertices_params: number[][] & VerticesParamsBD;
+  edges: EdgeSet[] & EdgeSetLegacy[];
+}
+
+/**
+ * Normalized state derived from modern compiled payloads.
+ */
+export interface ModernStatePayload {
+  points: PointSet[];
+  pointsWeightBuffer: WeightBufferBD;
+  strictStatus: StrictStatus;
+  verticesParams: VerticesParamsBD;
+  centroid: CentroidBD;
+  edges: EdgeSet[];
+  edgeNodes?: PointSet[];
+  tins: TinsBD;
+  kinks?: KinksBD;
+  yaxisMode: YaxisMode;
+  strictMode: StrictMode;
+  vertexMode?: VertexMode;
+  bounds?: number[][];
+  boundsPolygon?: Feature<Polygon>;
+  wh?: number[];
+  xy?: number[];
+}
+
+/**
+ * Normalized snapshot captured from legacy payloads.
+ */
+export interface LegacyStatePayload {
+  compiled: CompiledLegacy;
+  tins: TinsBD;
+  points: PointSet[];
+  strictStatus?: StrictStatus;
+  pointsWeightBuffer: WeightBufferBD;
+  verticesParams: VerticesParamsBD;
+  centroid?: CentroidBD;
+  kinks?: KinksBD;
+}
+
+// ─── MapTransform types ───────────────────────────────────────────────────────
+
+/**
+ * Viewport representation: center in mercator, zoom level, rotation in radians.
+ */
+export interface Viewpoint {
+  /** Mercator coordinate [x, y] */
+  center: number[];
+  /** Mercator zoom level */
+  zoom: number;
+  /** Rotation angle in radians */
+  rotation: number;
+}
+
+/**
+ * Sub-map TIN data for MapTransform.setMapData().
+ */
+export interface SubMapData {
+  /** Compiled TIN data */
+  compiled: Compiled;
+  /** Layer priority (higher = checked first) */
+  priority: number;
+  /** Layer importance (used when multiple layers overlap) */
+  importance: number;
+  /** Bounds vertices in pixel (XY) space. Falls back to compiled.bounds if omitted. */
+  bounds?: number[][];
+}
+
+/**
+ * Input data for MapTransform.setMapData().
+ */
+export interface MapData {
+  /** Compiled TIN data for the main layer */
+  compiled: Compiled;
+  /** maxZoom value used to compute _maxxy = 2^maxZoom * 256 */
+  maxZoom?: number;
+  /** Sub-map layers */
+  sub_maps?: SubMapData[];
+}

package/src/viewpoint.ts

@@ -0,0 +1,104 @@
+import { MERC_MAX, MERC_CROSSMATRIX } from "./constants.ts";
+import type { Viewpoint } from "./types.ts";
+
+/**
+ * size（画面サイズ）とズームから、地図面座標上での半径を得る
+ *
+ * @param size - 画面サイズ [width, height]
+ * @param zoom - メルカトルズームレベル
+ * @returns メルカトル座標上での半径
+ */
+export function zoom2Radius(size: [number, number], zoom: number): number {
+  const radius = Math.floor(Math.min(size[0], size[1]) / 4);
+  return (radius * MERC_MAX) / 128 / Math.pow(2, zoom);
+}
+
+/**
+ * 与えられた差分行列を回転する
+ *
+ * @param xys - 回転する座標の配列
+ * @param theta - 回転角（ラジアン）
+ * @returns 回転後の座標の配列
+ */
+export function rotateMatrix(xys: number[][], theta: number): number[][] {
+  const result: number[][] = [];
+  for (let i = 0; i < xys.length; i++) {
+    const xy = xys[i];
+    const x = xy[0] * Math.cos(theta) - xy[1] * Math.sin(theta);
+    const y = xy[0] * Math.sin(theta) + xy[1] * Math.cos(theta);
+    result.push([x, y]);
+  }
+  return result;
+}
+
+/**
+ * 画面サイズと地図ズームから、メルカトル座標上での5座標を取得する
+ *
+ * @param center - 中心のメルカトル座標 [x, y]
+ * @param zoom - メルカトルズームレベル
+ * @param rotation - 回転角（ラジアン）
+ * @param size - 画面サイズ [width, height]
+ * @returns 中心＋上下左右の5点のメルカトル座標配列
+ */
+export function mercViewpoint2Mercs(
+  center: number[],
+  zoom: number,
+  rotation: number,
+  size: [number, number]
+): number[][] {
+  const radius = zoom2Radius(size, zoom);
+  const crossDelta = rotateMatrix(MERC_CROSSMATRIX, rotation);
+  const cross = crossDelta.map(xy => [
+    xy[0] * radius + center[0],
+    xy[1] * radius + center[1]
+  ]);
+  return cross;
+}
+
+/**
+ * メルカトル5地点情報からメルカトル地図でのサイズ情報（中心座標、ズーム、回転）を得る
+ *
+ * @param mercs - 中心＋上下左右の5点のメルカトル座標配列
+ * @param size - 画面サイズ [width, height]
+ * @returns Viewpoint オブジェクト（center, zoom, rotation）
+ */
+export function mercs2MercViewpoint(
+  mercs: number[][],
+  size: [number, number]
+): Viewpoint {
+  const center = mercs[0];
+  const nesw = mercs.slice(1, 5);
+  const neswDelta = nesw.map(val => [
+    val[0] - center[0],
+    val[1] - center[1]
+  ]);
+  const normal = [
+    [0.0, 1.0],
+    [1.0, 0.0],
+    [0.0, -1.0],
+    [-1.0, 0.0]
+  ];
+  let abss = 0;
+  let cosx = 0;
+  let sinx = 0;
+  for (let i = 0; i < 4; i++) {
+    const delta = neswDelta[i];
+    const norm = normal[i];
+    const abs = Math.sqrt(Math.pow(delta[0], 2) + Math.pow(delta[1], 2));
+    abss += abs;
+    const outer = delta[0] * norm[1] - delta[1] * norm[0];
+    const inner = Math.acos(
+      (delta[0] * norm[0] + delta[1] * norm[1]) / abs
+    );
+    const theta = outer > 0.0 ? -1.0 * inner : inner;
+    cosx += Math.cos(theta);
+    sinx += Math.sin(theta);
+  }
+  const scale = abss / 4.0;
+  const omega = Math.atan2(sinx, cosx);
+
+  const radius = Math.floor(Math.min(size[0], size[1]) / 4);
+  const zoom = Math.log((radius * MERC_MAX) / 128 / scale) / Math.log(2);
+
+  return { center, zoom, rotation: omega };
+}