@ue-too/board / index / convertDeltaInViewPortToWorldSpace

Function: convertDeltaInViewPortToWorldSpace()

convertDeltaInViewPortToWorldSpace(delta, cameraZoomLevel, cameraRotation): Point

Defined in: packages/board/src/camera/utils/coordinate-conversion.ts:372

Converts a displacement vector from viewport space to world space. Use this for converting movement deltas, not absolute positions.

Parameters

delta

Point

Displacement vector in viewport space (CSS pixels)

cameraZoomLevel

number

Camera zoom level

cameraRotation

number

Camera rotation in radians

Returns

Point

Displacement vector in world coordinates

Remarks

This transforms a relative displacement, not an absolute point. The conversion accounts for:

• Rotation: Delta is rotated by camera rotation
• Zoom: Delta is scaled by 1/zoom (viewport pixels → world units)

Note: Camera position is NOT needed for delta transformations.

Example

// User dragged 100 pixels to the right in viewport
const viewportDelta = { x: 100, y: 0 };
const worldDelta = convertDeltaInViewPortToWorldSpace(
  viewportDelta,
  2.0,  // 2x zoom
  0     // no rotation
);
// Result: { x: 50, y: 0 } (100 viewport pixels = 50 world units at 2x zoom)