All files / core/src/RenderingEngine/GenericViewport/Video videoProjectionSnapshot.ts

0% Statements 0/26
0% Branches 0/35
0% Functions 0/8
0% Lines 0/26

Press n or j to go to the next uncovered block, b, p or k for the previous block.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143                                                                                                                                                                                                                                                                                             
import type { Point2, Point3 } from '../../../types';
import type { ProjectionScale } from '../ViewportProjectionTypes';
import {
  VIDEO_PROJECTION_ID,
  type VideoProjectionRequest,
  type VideoProjectionSnapshot,
} from './VideoProjectionTypes';
import { normalizeVideoViewState } from './videoViewportCamera';
import type { VideoViewState } from './VideoViewportTypes';
 
/**
 * Clones a canvas-space point so projection snapshots cannot leak mutable
 * tuple references from resolved views.
 */
function clonePoint2(point: Point2): Point2 {
  return [point[0], point[1]];
}
 
/**
 * Derives intrinsic media-pixel density from the resolved canvas transform.
 */
function getMediaPixelsPerCanvasPixel(
  resolvedView: NonNullable<VideoProjectionSnapshot['resolvedView']>
): number {
  const origin = resolvedView.canvasToWorld([0, 0]);
  const next = resolvedView.canvasToWorld([1, 0]);
 
  return Math.abs(next[0] - origin[0]) || 1;
}
 
/**
 * Returns the best available Video projection scale for the snapshot.
 */
function getScale(
  resolvedView: VideoProjectionSnapshot['resolvedView'],
  zoom: number
): ProjectionScale {
  if (!resolvedView) {
    return { kind: 'fit', value: zoom };
  }
 
  return {
    kind: 'nativePixel',
    pixelsPerCanvasPixel: getMediaPixelsPerCanvasPixel(resolvedView),
  };
}
 
/**
 * Returns the center canvas point used as the default projection anchor.
 */
function getCenterCanvasPoint(
  canvasWidth: number,
  canvasHeight: number
): Point2 {
  return [canvasWidth / 2, canvasHeight / 2];
}
 
/**
 * Resolves the media-space point displayed at the requested canvas point.
 */
function getCenterMediaPoint(
  resolvedView: VideoProjectionSnapshot['resolvedView'],
  canvasPoint: Point2,
  viewState: VideoViewState
): Point2 {
  if (resolvedView) {
    const worldPoint = resolvedView.canvasToWorld(canvasPoint);
 
    return [worldPoint[0], worldPoint[1]];
  }
 
  return viewState.anchorWorld ? clonePoint2(viewState.anchorWorld) : [0, 0];
}
 
/**
 * Builds the media-space Video projection snapshot for a viewport-like object.
 */
export function getVideoProjectionSnapshot(
  request: VideoProjectionRequest
): VideoProjectionSnapshot | undefined {
  const { viewport } = request;
  const viewState = normalizeVideoViewState(
    request.viewState ?? viewport.getViewState?.() ?? {}
  );
  const resolvedView = request.resolvedView ?? viewport.getResolvedView?.();
  const canvasWidth =
    request.canvasWidth ??
    resolvedView?.state?.containerWidth ??
    viewport.element?.clientWidth ??
    1;
  const canvasHeight =
    request.canvasHeight ??
    resolvedView?.state?.containerHeight ??
    viewport.element?.clientHeight ??
    1;
  const canvasPoint = getCenterCanvasPoint(canvasWidth, canvasHeight);
  const mediaPoint = getCenterMediaPoint(resolvedView, canvasPoint, viewState);
  const zoom = resolvedView?.zoom ?? Math.max(viewState.scale ?? 1, 0.001);
  const rawPan = resolvedView?.pan ?? [0, 0];
  const rendererCamera = resolvedView?.toICamera();
  const frameOfReferenceUID =
    request.frameOfReferenceUID ??
    resolvedView?.getFrameOfReferenceUID() ??
    viewport.getFrameOfReferenceUID?.();
 
  return {
    kind: VIDEO_PROJECTION_ID,
    adapterId: VIDEO_PROJECTION_ID,
    canvasHeight,
    canvasWidth,
    dataId: request.dataId,
    frameOfReferenceUID,
    presentation: {
      pan: clonePoint2(rawPan),
      position: {
        kind: 'mediaPoint',
        mediaPoint,
        canvasPoint,
      },
      rawPan: clonePoint2(rawPan),
      rotation: resolvedView?.rotation ?? viewState.rotation ?? 0,
      scale: getScale(resolvedView, zoom),
      zoom,
    },
    rendererCamera,
    resolvedView,
    spaces: {
      canvas: true,
      image: false,
      renderer: Boolean(rendererCamera),
      world: Boolean(resolvedView),
    },
    transforms: resolvedView
      ? {
          canvasToWorld: (point) => resolvedView.canvasToWorld(point),
          worldToCanvas: (point: Point3) => resolvedView.worldToCanvas(point),
        }
      : undefined,
    viewState,
    viewportType: viewport.type,
  };
}