@photivra/engine 0.2.0 → 0.4.0

package/dist/sensor/sensor-geometry.js

@@ -0,0 +1,71 @@
+// SPDX-License-Identifier: Apache-2.0
+import { calculatedResult } from "../core/calculation-result.js";
+import { InvalidScientificInputError, requirePositiveFinite, requirePositiveInteger } from "../core/validation.js";
+const REFERENCE_35MM_WIDTH_MM = 36;
+const REFERENCE_35MM_HEIGHT_MM = 24;
+const REFERENCE_35MM_DIAGONAL_MM = Math.hypot(REFERENCE_35MM_WIDTH_MM, REFERENCE_35MM_HEIGHT_MM);
+/**
+ * Calculates physical imaging-area metrics independently from native raster
+ * density.
+ *
+ * Crop factor uses the diagonal ratio to a 36 × 24 mm reference frame.
+ * Digital/output crops are not part of this physical imaging-area quantity.
+ *
+ * @param imagingArea Physical photosensitive imaging area.
+ * @returns Physical diagonal, aspect ratio, and diagonal 35 mm crop factor.
+ */
+export function calculateImagingAreaMetrics(imagingArea) {
+    requirePositiveFinite("imagingArea.widthMm", imagingArea.widthMm);
+    requirePositiveFinite("imagingArea.heightMm", imagingArea.heightMm);
+    const diagonalMm = Math.hypot(imagingArea.widthMm, imagingArea.heightMm);
+    return calculatedResult({
+        diagonalMm,
+        aspectRatio: imagingArea.widthMm / imagingArea.heightMm,
+        cropFactor35Mm: REFERENCE_35MM_DIAGONAL_MM / diagonalMm
+    }, "sensor-imaging-area", "1.0.0", [
+        "35 mm reference frame is 36 × 24 mm and crop factor is diagonal-based.",
+        "Digital/output cropping is excluded from physical imaging-area crop factor."
+    ]);
+}
+/**
+ * Calculates physical imaging-area, native-raster, and geometric sampling
+ * metrics without coupling sensor size to resolution.
+ *
+ * The supplied raster is assumed to span the supplied imaging area. Derived
+ * sampling pitch is geometric sample spacing only and must not be interpreted
+ * as photosite fill factor or photon-collection area.
+ *
+ * @param input Physical imaging area and native effective image raster.
+ * @returns Derived imaging-area, raster, and sampling metrics.
+ */
+export function calculateSensorGeometryMetrics(input) {
+    requirePositiveFinite("imagingArea.widthMm", input.imagingArea.widthMm);
+    requirePositiveFinite("imagingArea.heightMm", input.imagingArea.heightMm);
+    requirePositiveInteger("nativeRaster.pixelWidth", input.nativeRaster.pixelWidth);
+    requirePositiveInteger("nativeRaster.pixelHeight", input.nativeRaster.pixelHeight);
+    const totalImageSamples = input.nativeRaster.pixelWidth * input.nativeRaster.pixelHeight;
+    if (!Number.isSafeInteger(totalImageSamples)) {
+        throw new InvalidScientificInputError("nativeRaster total image-sample count must be a positive safe integer.");
+    }
+    const imagingAreaMetrics = calculateImagingAreaMetrics(input.imagingArea).value;
+    const pitchXMicrometers = (input.imagingArea.widthMm / input.nativeRaster.pixelWidth) * 1000;
+    const pitchYMicrometers = (input.imagingArea.heightMm / input.nativeRaster.pixelHeight) * 1000;
+    return calculatedResult({
+        imagingArea: imagingAreaMetrics,
+        nativeRaster: {
+            totalImageSamples,
+            megapixels: totalImageSamples / 1_000_000,
+            aspectRatio: input.nativeRaster.pixelWidth / input.nativeRaster.pixelHeight
+        },
+        sampling: {
+            pitchXMicrometers,
+            pitchYMicrometers,
+            pitchAspectRatio: pitchXMicrometers / pitchYMicrometers
+        }
+    }, "sensor-imaging-area-native-raster", "1.0.0", [
+        "35 mm reference frame is 36 × 24 mm and crop factor is diagonal-based.",
+        "The native effective image raster is assumed to span the supplied physical imaging area.",
+        "Derived sampling pitch is geometric image-sample spacing, not physical photodiode active area or fill factor."
+    ]);
+}
+//# sourceMappingURL=sensor-geometry.js.map

package/dist/sensor/sensor-geometry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sensor-geometry.js","sourceRoot":"","sources":["../../src/sensor/sensor-geometry.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC,OAAO,EACL,gBAAgB,EAEjB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,2BAA2B,EAC3B,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,uBAAuB,GAAG,EAAE,CAAC;AACnC,MAAM,wBAAwB,GAAG,EAAE,CAAC;AACpC,MAAM,0BAA0B,GAAG,IAAI,CAAC,KAAK,CAC3C,uBAAuB,EACvB,wBAAwB,CACzB,CAAC;AAkFF;;;;;;;;;GASG;AACH,MAAM,UAAU,2BAA2B,CACzC,WAA8B;IAE9B,qBAAqB,CAAC,qBAAqB,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAClE,qBAAqB,CAAC,sBAAsB,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAEpE,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAEzE,OAAO,gBAAgB,CACrB;QACE,UAAU;QACV,WAAW,EAAE,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,QAAQ;QACvD,cAAc,EAAE,0BAA0B,GAAG,UAAU;KACxD,EACD,qBAAqB,EACrB,OAAO,EACP;QACE,wEAAwE;QACxE,6EAA6E;KAC9E,CACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,8BAA8B,CAC5C,KAA0C;IAE1C,qBAAqB,CAAC,qBAAqB,EAAE,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IACxE,qBAAqB,CAAC,sBAAsB,EAAE,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC1E,sBAAsB,CACpB,yBAAyB,EACzB,KAAK,CAAC,YAAY,CAAC,UAAU,CAC9B,CAAC;IACF,sBAAsB,CACpB,0BAA0B,EAC1B,KAAK,CAAC,YAAY,CAAC,WAAW,CAC/B,CAAC;IAEF,MAAM,iBAAiB,GACrB,KAAK,CAAC,YAAY,CAAC,UAAU,GAAG,KAAK,CAAC,YAAY,CAAC,WAAW,CAAC;IACjE,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,iBAAiB,CAAC,EAAE,CAAC;QAC7C,MAAM,IAAI,2BAA2B,CACnC,wEAAwE,CACzE,CAAC;IACJ,CAAC;IAED,MAAM,kBAAkB,GAAG,2BAA2B,CACpD,KAAK,CAAC,WAAW,CAClB,CAAC,KAAK,CAAC;IACR,MAAM,iBAAiB,GACrB,CAAC,KAAK,CAAC,WAAW,CAAC,OAAO,GAAG,KAAK,CAAC,YAAY,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IACrE,MAAM,iBAAiB,GACrB,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,GAAG,KAAK,CAAC,YAAY,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC;IAEvE,OAAO,gBAAgB,CACrB;QACE,WAAW,EAAE,kBAAkB;QAC/B,YAAY,EAAE;YACZ,iBAAiB;YACjB,UAAU,EAAE,iBAAiB,GAAG,SAAS;YACzC,WAAW,EACT,KAAK,CAAC,YAAY,CAAC,UAAU,GAAG,KAAK,CAAC,YAAY,CAAC,WAAW;SACjE;QACD,QAAQ,EAAE;YACR,iBAAiB;YACjB,iBAAiB;YACjB,gBAAgB,EAAE,iBAAiB,GAAG,iBAAiB;SACxD;KACF,EACD,mCAAmC,EACnC,OAAO,EACP;QACE,wEAAwE;QACxE,0FAA0F;QAC1F,+GAA+G;KAChH,CACF,CAAC;AACJ,CAAC"}

package/dist/simulation/poc-simulation.d.ts

@@ -1,5 +1,8 @@
 import type { CalculationProvenance } from "../core/calculation-result.js";
+import { type ActiveCaptureFieldOfView, type CaptureOrientation, type OutputFieldOfView, type PhysicalBoundsFromOpticalAxisMm, type RasterRect, type RasterVector, type ResolvedCaptureGeometry } from "../output/capture-geometry.js";
+import { type RasterDimensions, type SensorGeometryMetrics, type SensorImagingArea } from "../sensor/sensor-geometry.js";
 import type { Vector3 } from "../schema/scene.js";
+export declare const POC_SIMULATION_API_VERSION: "0.20.0";
 export interface PocSimulationRequest {
     sensor: {
         widthMm: number;
@@ -25,8 +28,24 @@ export interface PocSimulationRequest {
         };
     };
     crop: {
+        /**
+         * Legacy centered same-aspect crop factor.
+         *
+         * When capture geometry is supplied this must remain 1. New callers should
+         * use capture.activeCaptureRect/outputCropRect instead of stacking two
+         * independent crop models.
+         */
         factor: number;
     };
+    /**
+     * Opt-in staged capture geometry. Omit for exact legacy POC behavior.
+     */
+    capture?: {
+        orientation: CaptureOrientation;
+        activeCaptureRect?: RasterRect;
+        outputCropRect?: RasterRect;
+        outputRaster?: RasterDimensions;
+    };
     diffraction: {
         wavelengthNm: number;
     };
@@ -77,8 +96,20 @@ interface FieldOfViewSummary {
     verticalDegrees: number;
     diagonalDegrees: number;
 }
+interface CaptureSubjectFraming {
+    additionalCropFactor: number;
+    raster: RasterDimensions;
+    megapixels: number;
+    subjectHeightFraction: number;
+    subjectClipped: boolean;
+    additionalCropApplied: boolean;
+    retainedImagingArea: SensorImagingArea;
+    physicalBoundsFromOpticalAxisMm: PhysicalBoundsFromOpticalAxisMm;
+    effectiveFieldOfView: FieldOfViewSummary;
+    basis: "centered-output-framing";
+}
 export interface PocSimulationResponse {
-    apiVersion: "0.17.0";
+    apiVersion: typeof POC_SIMULATION_API_VERSION;
     projection: {
         kind: "focus-aware-thin-lens";
         focusDistanceM: number;
@@ -95,7 +126,66 @@ export interface PocSimulationResponse {
         diagonalDegrees: number;
     };
     sensor: {
+        /** Physical imaging-area/native-raster metrics from the shared sensor foundation. */
+        geometry: SensorGeometryMetrics;
+        /**
+         * Backwards-compatible representative pitch used by the current composed
+         * POC calculations. This remains the horizontal pitch.
+         */
         pixelPitchMicrometers: number;
+        pitchXMicrometers: number;
+        pitchYMicrometers: number;
+        pitchAxisRelativeDifference: number;
+    };
+    capture?: {
+        geometry: ResolvedCaptureGeometry;
+        activeFieldOfView: ActiveCaptureFieldOfView;
+        outputFieldOfView: OutputFieldOfView;
+        focalLength: {
+            actualFocalLengthMm: number;
+            equivalentFocalLength35Mm: number;
+            cropFactor35Mm: number;
+            activeImagingAreaDiagonalMm: number;
+            basis: "diagonal";
+        };
+        /**
+         * Axis-aware pixel-domain mapping from oriented active-capture samples to
+         * the declared output raster. Subject framing is a later crop, not another
+         * resampling step.
+         */
+        outputSamplingScale: {
+            x: number;
+            y: number;
+            axisRelativeDifference: number;
+        };
+        /**
+         * Additional post-output subject framing. This does not mutate physical
+         * sensor identity, active capture, or active-capture focal equivalence.
+         */
+        subjectFraming?: CaptureSubjectFraming;
+        motion: {
+            nativeRasterDeltaPixels: RasterVector;
+            orientedCaptureDeltaPixels: RasterVector;
+            outputDeltaPixels: RasterVector;
+        };
+        motionSamples?: readonly {
+            id: string;
+            nativeRasterDeltaPixels: RasterVector;
+            orientedCaptureDeltaPixels: RasterVector;
+            outputDeltaPixels: RasterVector;
+        }[];
+        cameraShake?: {
+            unstabilized: {
+                nativeRasterDeltaPixels: RasterVector;
+                orientedCaptureDeltaPixels: RasterVector;
+                outputDeltaPixels: RasterVector;
+            };
+            stabilized: {
+                nativeRasterDeltaPixels: RasterVector;
+                orientedCaptureDeltaPixels: RasterVector;
+                outputDeltaPixels: RasterVector;
+            };
+        };
     };
     crop: {
         cropFactor: number;
@@ -112,6 +202,8 @@ export interface PocSimulationResponse {
         source: "equivalent-viewing-approximation";
         circleOfConfusionMm: number;
         scaleFactor: number;
+        targetBasis: "full-sensor" | "final-retained-output";
+        targetImagingArea: SensorImagingArea;
         provenance: {
             kind: "approximation";
             model: string;

package/dist/simulation/poc-simulation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"poc-simulation.d.ts","sourceRoot":"","sources":["../../src/simulation/poc-simulation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"poc-simulation.d.ts","sourceRoot":"","sources":["../../src/simulation/poc-simulation.ts"],"names":[],"mappings":"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"}

package/dist/simulation/poc-simulation.js

@@ -1,5 +1,6 @@
 // SPDX-License-Identifier: Apache-2.0
-import { calculateFieldOfView } from "../camera/field-of-view.js";
+import { calculateEquivalentFocalLength35Mm } from "../camera/equivalent-focal-length.js";
+import { calculateFieldOfView, calculateFieldOfViewBounds } from "../camera/field-of-view.js";
 import { calculateProjectedObjectSize } from "../camera/projected-object-size.js";
 import { InvalidScientificInputError, requirePositiveFinite } from "../core/validation.js";
 import { calculateExposureValue100 } from "../exposure/exposure.js";
@@ -9,10 +10,14 @@ import { estimateEquivalentViewingCircleOfConfusion } from "../optics/circle-of-
 import { calculateAiryDisk } from "../optics/diffraction.js";
 import { calculateThinLensImageDistance } from "../optics/thin-lens.js";
 import { calculateDefocusCircle, calculateDepthOfField } from "../optics/depth-of-field.js";
+import { calculateActiveCaptureFieldOfView, calculateOutputFieldOfView, resolveCaptureGeometry, transformNativeRasterVectorToOriented } from "../output/capture-geometry.js";
 import { calculateCenteredCrop } from "../output/crop.js";
 import { calculateSubjectFramingCrop } from "../output/subject-framing-crop.js";
 import { calculatePixelPitch } from "../sensor/pixel-pitch.js";
+import { calculateSensorGeometryMetrics } from "../sensor/sensor-geometry.js";
 import { estimateCameraShakeBlur } from "../stabilization/camera-shake.js";
+export const POC_SIMULATION_API_VERSION = "0.20.0";
+const POC_MAX_PITCH_AXIS_RELATIVE_DIFFERENCE = 0.01;
 function calculateCroppedFieldOfView(sensorWidthMm, sensorHeightMm, focalLengthMm, focusDistanceM, cropFactor) {
     const diagonalMm = Math.hypot(sensorWidthMm, sensorHeightMm);
     return {
@@ -49,6 +54,80 @@ function requireUniqueSampleIds(label, samples) {
         seen.add(normalizedId);
     }
 }
+function centeredPhysicalCropBounds(bounds, retainedFractionX, retainedFractionY) {
+    const centerX = (bounds.left + bounds.right) / 2;
+    const centerY = (bounds.top + bounds.bottom) / 2;
+    const halfWidth = ((bounds.right - bounds.left) * retainedFractionX) / 2;
+    const halfHeight = ((bounds.bottom - bounds.top) * retainedFractionY) / 2;
+    return {
+        left: centerX - halfWidth,
+        right: centerX + halfWidth,
+        top: centerY - halfHeight,
+        bottom: centerY + halfHeight
+    };
+}
+function calculateFieldOfViewForPhysicalBounds(bounds, focalLengthMm, focusDistanceM) {
+    const horizontal = calculateFieldOfViewBounds({
+        focalLengthMm,
+        minimumSensorCoordinateMm: bounds.left,
+        maximumSensorCoordinateMm: bounds.right,
+        focusDistanceM
+    }).value;
+    const vertical = calculateFieldOfViewBounds({
+        focalLengthMm,
+        minimumSensorCoordinateMm: bounds.top,
+        maximumSensorCoordinateMm: bounds.bottom,
+        focusDistanceM
+    }).value;
+    const projectionDistanceMm = horizontal.projectionDistanceMm;
+    const corners = {
+        topLeft: { x: bounds.left, y: bounds.top },
+        topRight: { x: bounds.right, y: bounds.top },
+        bottomRight: { x: bounds.right, y: bounds.bottom },
+        bottomLeft: { x: bounds.left, y: bounds.bottom }
+    };
+    const angleBetween = (first, second) => {
+        const firstLength = Math.hypot(first.x, first.y, projectionDistanceMm);
+        const secondLength = Math.hypot(second.x, second.y, projectionDistanceMm);
+        const dot = first.x * second.x +
+            first.y * second.y +
+            projectionDistanceMm * projectionDistanceMm;
+        const cosine = Math.max(-1, Math.min(1, dot / (firstLength * secondLength)));
+        return (Math.acos(cosine) * 180) / Math.PI;
+    };
+    return {
+        horizontalDegrees: horizontal.degrees,
+        verticalDegrees: vertical.degrees,
+        diagonalDegrees: Math.max(angleBetween(corners.topLeft, corners.bottomRight), angleBetween(corners.topRight, corners.bottomLeft))
+    };
+}
+function isPortraitOrientation(orientation) {
+    return (orientation === "portrait-clockwise" ||
+        orientation === "portrait-counter-clockwise");
+}
+function resolveCaptureVector(legacyImagePlaneVector, orientation, geometry) {
+    // Legacy projected-motion/camera-shake components use +X right and +Y up.
+    // Capture raster coordinates use +X right and +Y down. Preserve the legacy
+    // fields unchanged and convert explicitly before applying physical rotation.
+    const nativeRasterDeltaPixels = {
+        x: legacyImagePlaneVector.x,
+        y: -legacyImagePlaneVector.y
+    };
+    const orientedCaptureDeltaPixels = transformNativeRasterVectorToOriented({
+        vector: nativeRasterDeltaPixels,
+        orientation
+    });
+    const scaleX = geometry.output.orientedCaptureToOutputScale.x;
+    const scaleY = geometry.output.orientedCaptureToOutputScale.y;
+    return {
+        nativeRasterDeltaPixels,
+        orientedCaptureDeltaPixels,
+        outputDeltaPixels: {
+            x: orientedCaptureDeltaPixels.x * scaleX,
+            y: orientedCaptureDeltaPixels.y * scaleY
+        }
+    };
+}
 /**
  * Composes the validated POC calculations into a single renderer/agent-facing
  * response without introducing any new photographic model.
@@ -59,6 +138,48 @@ function requireUniqueSampleIds(label, samples) {
 export function simulatePocCamera(request) {
     requirePositiveFinite("sensor.widthMm", request.sensor.widthMm);
     requirePositiveFinite("sensor.heightMm", request.sensor.heightMm);
+    const sensorGeometry = calculateSensorGeometryMetrics({
+        imagingArea: {
+            widthMm: request.sensor.widthMm,
+            heightMm: request.sensor.heightMm
+        },
+        nativeRaster: {
+            pixelWidth: request.sensor.pixelWidth,
+            pixelHeight: request.sensor.pixelHeight
+        }
+    }).value;
+    const pitchXMicrometers = sensorGeometry.sampling.pitchXMicrometers;
+    const pitchYMicrometers = sensorGeometry.sampling.pitchYMicrometers;
+    const pitchAxisRelativeDifference = Math.abs(pitchXMicrometers - pitchYMicrometers) /
+        ((pitchXMicrometers + pitchYMicrometers) / 2);
+    if (pitchAxisRelativeDifference >
+        POC_MAX_PITCH_AXIS_RELATIVE_DIFFERENCE) {
+        throw new InvalidScientificInputError("The composed POC currently requires approximately square geometric sampling; X/Y pitch differ by more than 1%. Use lower-level axis-aware engine primitives until the POC contract supports separate X/Y sampling.");
+    }
+    const capture = request.capture;
+    const subjectCropRequest = request.subjectCrop;
+    const captureGeometry = capture === undefined
+        ? undefined
+        : resolveCaptureGeometry({
+            imagingArea: {
+                widthMm: request.sensor.widthMm,
+                heightMm: request.sensor.heightMm
+            },
+            nativeRaster: {
+                pixelWidth: request.sensor.pixelWidth,
+                pixelHeight: request.sensor.pixelHeight
+            },
+            orientation: capture.orientation,
+            ...(capture.activeCaptureRect === undefined
+                ? {}
+                : { activeCaptureRect: capture.activeCaptureRect }),
+            ...(capture.outputCropRect === undefined
+                ? {}
+                : { outputCropRect: capture.outputCropRect }),
+            ...(capture.outputRaster === undefined
+                ? {}
+                : { outputRaster: capture.outputRaster })
+        }).value;
     requirePositiveFinite("lens.focalLengthMm", request.lens.focalLengthMm);
     requirePositiveFinite("lens.aperture", request.lens.aperture);
     requirePositiveFinite("exposure.shutterSeconds", request.exposure.shutterSeconds);
@@ -69,20 +190,10 @@ export function simulatePocCamera(request) {
     if (hasExplicitCircleOfConfusion === hasEquivalentViewingCriterion) {
         throw new InvalidScientificInputError("Provide exactly one focus circle-of-confusion criterion.");
     }
-    const equivalentViewingCircleOfConfusion = request.focus.equivalentViewingCircleOfConfusion === undefined
-        ? undefined
-        : estimateEquivalentViewingCircleOfConfusion({
-            sensorWidthMm: request.sensor.widthMm,
-            sensorHeightMm: request.sensor.heightMm,
-            ...request.focus.equivalentViewingCircleOfConfusion
-        });
-    const circleOfConfusionMm = equivalentViewingCircleOfConfusion?.value.circleOfConfusionMm ??
-        request.focus.circleOfConfusionMm;
-    if (circleOfConfusionMm === undefined) {
-        throw new InvalidScientificInputError("A focus circle-of-confusion criterion is required.");
-    }
-    requirePositiveFinite("focus.circleOfConfusionMm", circleOfConfusionMm);
     requirePositiveFinite("crop.factor", request.crop.factor);
+    if (capture !== undefined && request.crop.factor !== 1) {
+        throw new InvalidScientificInputError("capture geometry cannot be combined with legacy crop.factor other than 1.");
+    }
     requirePositiveFinite("diffraction.wavelengthNm", request.diffraction.wavelengthNm);
     requireUniqueSampleIds("defocusSamples", request.defocusSamples);
     requireUniqueSampleIds("samplingSamples", request.samplingSamples);
@@ -107,6 +218,51 @@ export function simulatePocCamera(request) {
         sensorDimensionMm: diagonalMm,
         focusDistanceM: request.focus.focusDistanceM
     });
+    const activeCaptureFieldOfView = captureGeometry === undefined || capture === undefined
+        ? undefined
+        : calculateActiveCaptureFieldOfView({
+            imagingArea: {
+                widthMm: request.sensor.widthMm,
+                heightMm: request.sensor.heightMm
+            },
+            nativeRaster: {
+                pixelWidth: request.sensor.pixelWidth,
+                pixelHeight: request.sensor.pixelHeight
+            },
+            orientation: capture.orientation,
+            ...(capture.activeCaptureRect === undefined
+                ? {}
+                : { activeCaptureRect: capture.activeCaptureRect }),
+            focalLengthMm: request.lens.focalLengthMm,
+            focusDistanceM: request.focus.focusDistanceM
+        }).value;
+    const equivalentFocalLength = captureGeometry === undefined
+        ? undefined
+        : calculateEquivalentFocalLength35Mm({
+            focalLengthMm: request.lens.focalLengthMm,
+            activeImagingArea: captureGeometry.activeCapture.imagingArea
+        }).value;
+    const outputFieldOfView = captureGeometry === undefined || capture === undefined
+        ? undefined
+        : calculateOutputFieldOfView({
+            imagingArea: {
+                widthMm: request.sensor.widthMm,
+                heightMm: request.sensor.heightMm
+            },
+            nativeRaster: {
+                pixelWidth: request.sensor.pixelWidth,
+                pixelHeight: request.sensor.pixelHeight
+            },
+            orientation: capture.orientation,
+            ...(capture.activeCaptureRect === undefined
+                ? {}
+                : { activeCaptureRect: capture.activeCaptureRect }),
+            ...(capture.outputCropRect === undefined
+                ? {}
+                : { outputCropRect: capture.outputCropRect }),
+            focalLengthMm: request.lens.focalLengthMm,
+            focusDistanceM: request.focus.focusDistanceM
+        }).value;
     const pixelPitch = calculatePixelPitch({
         sensorWidthMm: request.sensor.widthMm,
         pixelWidth: request.sensor.pixelWidth
@@ -117,12 +273,6 @@ export function simulatePocCamera(request) {
         cropFactor: request.crop.factor
     });
     const cropFieldOfView = calculateCroppedFieldOfView(request.sensor.widthMm, request.sensor.heightMm, request.lens.focalLengthMm, request.focus.focusDistanceM, request.crop.factor);
-    const depthOfField = calculateDepthOfField({
-        focalLengthMm: request.lens.focalLengthMm,
-        aperture: request.lens.aperture,
-        focusDistanceM: request.focus.focusDistanceM,
-        circleOfConfusionMm
-    });
     const diffraction = calculateAiryDisk({
         aperture: request.lens.aperture,
         wavelengthNm: request.diffraction.wavelengthNm
@@ -149,6 +299,70 @@ export function simulatePocCamera(request) {
             focusDistanceM: request.focus.focusDistanceM,
             pixelPitchMicrometers: pixelPitch.value.micrometers
         }).value;
+    const captureSubjectFraming = captureGeometry === undefined ||
+        capture === undefined ||
+        subjectCropRequest === undefined ||
+        subjectSampling === undefined
+        ? undefined
+        : (() => {
+            const orientedSubjectHeightPixels = isPortraitOrientation(capture.orientation)
+                ? (subjectSampling.widthPixels ?? 0)
+                : (subjectSampling.heightPixels ?? 0);
+            const outputSubjectHeightPixels = orientedSubjectHeightPixels *
+                captureGeometry.output.orientedCaptureToOutputScale.y;
+            const framing = calculateSubjectFramingCrop({
+                pixelWidth: captureGeometry.output.raster.pixelWidth,
+                pixelHeight: captureGeometry.output.raster.pixelHeight,
+                subjectHeightPixels: outputSubjectHeightPixels,
+                targetSubjectHeightFraction: subjectCropRequest.targetSubjectHeightFraction
+            }).value;
+            const retainedBounds = centeredPhysicalCropBounds(captureGeometry.output.physicalBoundsFromOpticalAxisMm, framing.pixelWidth / captureGeometry.output.raster.pixelWidth, framing.pixelHeight / captureGeometry.output.raster.pixelHeight);
+            const retainedImagingArea = {
+                widthMm: retainedBounds.right - retainedBounds.left,
+                heightMm: retainedBounds.bottom - retainedBounds.top
+            };
+            return {
+                additionalCropFactor: framing.cropFactor,
+                raster: {
+                    pixelWidth: framing.pixelWidth,
+                    pixelHeight: framing.pixelHeight
+                },
+                megapixels: framing.megapixels,
+                subjectHeightFraction: framing.subjectHeightFraction,
+                subjectClipped: framing.subjectClipped,
+                additionalCropApplied: framing.cropped,
+                retainedImagingArea,
+                physicalBoundsFromOpticalAxisMm: retainedBounds,
+                effectiveFieldOfView: calculateFieldOfViewForPhysicalBounds(retainedBounds, request.lens.focalLengthMm, request.focus.focusDistanceM),
+                basis: "centered-output-framing"
+            };
+        })();
+    const equivalentViewingTargetArea = captureGeometry === undefined
+        ? {
+            widthMm: request.sensor.widthMm,
+            heightMm: request.sensor.heightMm
+        }
+        : (captureSubjectFraming?.retainedImagingArea ??
+            captureGeometry.output.imagingArea);
+    const equivalentViewingCircleOfConfusion = request.focus.equivalentViewingCircleOfConfusion === undefined
+        ? undefined
+        : estimateEquivalentViewingCircleOfConfusion({
+            sensorWidthMm: equivalentViewingTargetArea.widthMm,
+            sensorHeightMm: equivalentViewingTargetArea.heightMm,
+            ...request.focus.equivalentViewingCircleOfConfusion
+        });
+    const circleOfConfusionMm = equivalentViewingCircleOfConfusion?.value.circleOfConfusionMm ??
+        request.focus.circleOfConfusionMm;
+    if (circleOfConfusionMm === undefined) {
+        throw new InvalidScientificInputError("A focus circle-of-confusion criterion is required.");
+    }
+    requirePositiveFinite("focus.circleOfConfusionMm", circleOfConfusionMm);
+    const depthOfField = calculateDepthOfField({
+        focalLengthMm: request.lens.focalLengthMm,
+        aperture: request.lens.aperture,
+        focusDistanceM: request.focus.focusDistanceM,
+        circleOfConfusionMm
+    });
     const samplingSamples = request.samplingSamples === undefined
         ? undefined
         : request.samplingSamples.map((sample) => {
@@ -191,13 +405,15 @@ export function simulatePocCamera(request) {
                     (pixelPitch.value.micrometers / 1000)
             };
         });
-    const subjectCrop = request.subjectCrop === undefined || subjectSampling === undefined
+    const subjectCrop = capture !== undefined ||
+        subjectCropRequest === undefined ||
+        subjectSampling === undefined
         ? undefined
         : calculateSubjectFramingCrop({
             pixelWidth: crop.value.pixelWidth,
             pixelHeight: crop.value.pixelHeight,
             subjectHeightPixels: subjectSampling.heightPixels ?? 0,
-            targetSubjectHeightFraction: request.subjectCrop.targetSubjectHeightFraction
+            targetSubjectHeightFraction: subjectCropRequest.targetSubjectHeightFraction
         }).value;
     const totalSubjectCropFactor = subjectCrop === undefined
         ? undefined
@@ -281,8 +497,39 @@ export function simulatePocCamera(request) {
                     (pixelPitch.value.micrometers / 1000)
             };
         });
+    const captureMotion = captureGeometry === undefined || capture === undefined
+        ? undefined
+        : resolveCaptureVector({
+            x: motion.value.deltaXMm / (pixelPitch.value.micrometers / 1000),
+            y: motion.value.deltaYMm / (pixelPitch.value.micrometers / 1000)
+        }, capture.orientation, captureGeometry);
+    const captureMotionSamples = captureGeometry === undefined ||
+        capture === undefined ||
+        motionSamples === undefined
+        ? undefined
+        : motionSamples.map((sample) => ({
+            id: sample.id,
+            ...resolveCaptureVector({
+                x: sample.deltaXPixels,
+                y: sample.deltaYPixels
+            }, capture.orientation, captureGeometry)
+        }));
+    const captureCameraShake = captureGeometry === undefined ||
+        capture === undefined ||
+        cameraShake === undefined
+        ? undefined
+        : {
+            unstabilized: resolveCaptureVector({
+                x: cameraShake.value.unstabilized.deltaXPixels ?? 0,
+                y: cameraShake.value.unstabilized.deltaYPixels ?? 0
+            }, capture.orientation, captureGeometry),
+            stabilized: resolveCaptureVector({
+                x: cameraShake.value.stabilized.deltaXPixels ?? 0,
+                y: cameraShake.value.stabilized.deltaYPixels ?? 0
+            }, capture.orientation, captureGeometry)
+        };
     return {
-        apiVersion: "0.17.0",
+        apiVersion: POC_SIMULATION_API_VERSION,
         projection: {
             kind: "focus-aware-thin-lens",
             focusDistanceM: request.focus.focusDistanceM,
@@ -296,8 +543,39 @@ export function simulatePocCamera(request) {
             diagonalDegrees: diagonalFov.value.degrees
         },
         sensor: {
-            pixelPitchMicrometers: pixelPitch.value.micrometers
+            geometry: sensorGeometry,
+            pixelPitchMicrometers: pixelPitch.value.micrometers,
+            pitchXMicrometers,
+            pitchYMicrometers,
+            pitchAxisRelativeDifference
         },
+        ...(captureGeometry === undefined ||
+            activeCaptureFieldOfView === undefined ||
+            outputFieldOfView === undefined ||
+            equivalentFocalLength === undefined ||
+            captureMotion === undefined
+            ? {}
+            : {
+                capture: {
+                    geometry: captureGeometry,
+                    activeFieldOfView: activeCaptureFieldOfView,
+                    outputFieldOfView,
+                    focalLength: equivalentFocalLength,
+                    outputSamplingScale: {
+                        ...captureGeometry.output.orientedCaptureToOutputScale
+                    },
+                    ...(captureSubjectFraming === undefined
+                        ? {}
+                        : { subjectFraming: captureSubjectFraming }),
+                    motion: captureMotion,
+                    ...(captureMotionSamples === undefined
+                        ? {}
+                        : { motionSamples: captureMotionSamples }),
+                    ...(captureCameraShake === undefined
+                        ? {}
+                        : { cameraShake: captureCameraShake })
+                }
+            }),
         crop: {
             cropFactor: request.crop.factor,
             ...crop.value,
@@ -312,6 +590,12 @@ export function simulatePocCamera(request) {
                 source: "equivalent-viewing-approximation",
                 circleOfConfusionMm,
                 scaleFactor: equivalentViewingCircleOfConfusion.value.scaleFactor,
+                targetBasis: captureGeometry === undefined
+                    ? "full-sensor"
+                    : "final-retained-output",
+                targetImagingArea: {
+                    ...equivalentViewingTargetArea
+                },
                 provenance: {
                     kind: "approximation",
                     model: equivalentViewingCircleOfConfusion.provenance.model,