Skip to content

@ue-too/board / index / convert2WorldSpaceWithTransformationMatrix

函式: convert2WorldSpaceWithTransformationMatrix()

convert2WorldSpaceWithTransformationMatrix(point, transformationMatrix): Point

定義於: packages/board/src/camera/utils/coordinate-conversion.ts:567

Transforms a viewport point to world space using a precomputed transformation matrix. Faster than repeated function calls when transforming many points with the same camera state.

參數

point

Point

Point in viewport coordinates (origin at center)

transformationMatrix

TransformationMatrix

Precomputed transformation matrix from transformationMatrixFromCamera

回傳

Point

World space coordinates of the point

備註

Use this for batch transformations when the camera state is constant:

  1. Create matrix once with transformationMatrixFromCamera
  2. Transform many points with this function

This avoids recalculating sin/cos and matrix operations for each point.

範例

typescript
// Transform many points efficiently
const matrix = transformationMatrixFromCamera(
  { x: 100, y: 200 },
  1.5,
  Math.PI / 4
);

const worldPoints = viewportPoints.map(vp =>
  convert2WorldSpaceWithTransformationMatrix(vp, matrix)
);

參閱

transformationMatrixFromCamera to create the matrix