@photivra/engine 0.2.0 → 0.5.0

package/dist/optics/radial-distortion.d.ts

@@ -0,0 +1,131 @@
+import { type CalculationResult } from "../core/calculation-result.js";
+export interface RadialDistortionCoefficients {
+    /** Dimensionless r² coefficient. */
+    k1: number;
+    /** Dimensionless r⁴ coefficient. */
+    k2: number;
+    /** Dimensionless r⁶ coefficient. */
+    k3: number;
+}
+export interface RadialDistortionProfile {
+    /**
+     * Physical image-plane radius used to normalize field position, in mm.
+     * Coefficients are meaningful only with this declared normalization.
+     */
+    normalizationRadiusMm: number;
+    /**
+     * Maximum undistorted normalized radius over which this profile is declared
+     * valid and must remain one-to-one/invertible.
+     */
+    maximumNormalizedRadius: number;
+    coefficients: RadialDistortionCoefficients;
+}
+export interface LensFieldPointMm {
+    /** Image-plane X coordinate relative to the optical axis, in mm. */
+    x: number;
+    /** Image-plane Y coordinate relative to the optical axis, in mm. */
+    y: number;
+}
+export interface CalculateRadialDistortionMappingInput {
+    /** Ideal/undistorted image-plane point. */
+    imagePointMm: LensFieldPointMm;
+    profile: RadialDistortionProfile;
+}
+export interface CalculateInverseRadialDistortionMappingInput {
+    /** Distorted image-plane point to inverse-map back to ideal coordinates. */
+    distortedImagePointMm: LensFieldPointMm;
+    profile: RadialDistortionProfile;
+}
+export interface CalculateInverseRadialDistortionMappingsInput {
+    /** Distorted image-plane destinations to inverse-map in one validated batch. */
+    distortedImagePointsMm: readonly LensFieldPointMm[];
+    profile: RadialDistortionProfile;
+}
+export interface RadialDistortionMapping {
+    direction: "undistorted-to-distorted";
+    sourceImagePointMm: LensFieldPointMm;
+    mappedImagePointMm: LensFieldPointMm;
+    sourceNormalizedRadius: number;
+    mappedNormalizedRadius: number;
+    radialScale: number;
+    deltaMm: {
+        x: number;
+        y: number;
+        distance: number;
+    };
+    profileMinimumRadialDerivative: number;
+}
+export interface InverseRadialDistortionMapping {
+    direction: "distorted-to-undistorted";
+    distortedImagePointMm: LensFieldPointMm;
+    sourceImagePointMm: LensFieldPointMm;
+    distortedNormalizedRadius: number;
+    sourceNormalizedRadius: number;
+    radialScaleAtSource: number;
+    deltaMm: {
+        x: number;
+        y: number;
+        distance: number;
+    };
+    profileMinimumRadialDerivative: number;
+}
+export interface InverseRadialDistortionMappings {
+    direction: "distorted-to-undistorted-batch";
+    mappings: readonly InverseRadialDistortionMapping[];
+    pointCount: number;
+    profileMinimumRadialDerivative: number;
+}
+/** @internal Shared by composite lens-field batch evaluators; not root-exported. */
+export interface ValidatedRadialProfile {
+    normalizationRadiusMm: number;
+    maximumNormalizedRadius: number;
+    coefficients: RadialDistortionCoefficients;
+    minimumRadialDerivative: number;
+    maximumMappedNormalizedRadius: number;
+}
+/** @internal Validates/copies one profile for repeated in-package evaluation. */
+export declare function validateRadialDistortionProfile(profile: RadialDistortionProfile): ValidatedRadialProfile;
+/**
+ * Applies a generic radial lens-distortion field mapping to one ideal
+ * image-plane point.
+ *
+ * The mapping is rotationally symmetric about the optical axis:
+ *
+ *   p_distorted = p_ideal * (1 + k1 r² + k2 r⁴ + k3 r⁶)
+ *
+ * where r is normalized by the caller-declared physical reference radius.
+ *
+ * The profile is accepted only when the radial mapping is strictly monotonic
+ * over its declared operating radius, which makes inverse destination-to-source
+ * sampling well-defined.
+ */
+export declare function calculateRadialDistortionMapping(input: CalculateRadialDistortionMappingInput): CalculationResult<RadialDistortionMapping>;
+/**
+ * Inverse-maps one distorted image-plane point to its ideal/undistorted source
+ * coordinate for destination-to-source renderer sampling.
+ *
+ * The same profile monotonicity requirement used by the forward mapping makes
+ * the inverse unique over the declared operating radius. A deterministic fixed
+ * bisection count is used rather than an unconstrained iterative solver.
+ */
+export interface InverseRadialSourcePointValue {
+    sourceImagePointMm: LensFieldPointMm;
+    distortedNormalizedRadius: number;
+    sourceNormalizedRadius: number;
+    radialScaleAtSource: number;
+}
+/**
+ * @internal Minimal inverse evaluation used by composite in-package batch
+ * models that do not need the standalone radial delta/provenance envelope.
+ */
+export declare function calculateInverseRadialSourcePointValue(distortedImagePointMm: LensFieldPointMm, profile: ValidatedRadialProfile, pointPath: string): InverseRadialSourcePointValue;
+export declare function calculateInverseRadialDistortionMapping(input: CalculateInverseRadialDistortionMappingInput): CalculationResult<InverseRadialDistortionMapping>;
+/**
+ * Inverse-maps multiple distorted image-plane destinations while validating
+ * and resolving the radial profile only once for the complete batch.
+ *
+ * The returned per-point mappings are numerically identical to the scalar API;
+ * provenance and profile validation are shared once at the batch boundary.
+ */
+export declare function calculateInverseRadialDistortionMappings(input: CalculateInverseRadialDistortionMappingsInput): CalculationResult<InverseRadialDistortionMappings>;
+//# sourceMappingURL=radial-distortion.d.ts.map

package/dist/optics/radial-distortion.d.ts.map

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

package/dist/optics/radial-distortion.js

@@ -0,0 +1,227 @@
+// SPDX-License-Identifier: Apache-2.0
+import { approximationResult } from "../core/calculation-result.js";
+import { InvalidScientificInputError, requirePositiveFinite } from "../core/validation.js";
+const INVERSE_BISECTION_ITERATIONS = 80;
+function requireFinite(name, value) {
+    if (!Number.isFinite(value)) {
+        throw new InvalidScientificInputError(`${name} must be finite.`);
+    }
+}
+function radialScale(normalizedRadius, coefficients) {
+    const r2 = normalizedRadius * normalizedRadius;
+    const r4 = r2 * r2;
+    const r6 = r4 * r2;
+    return (1 +
+        coefficients.k1 * r2 +
+        coefficients.k2 * r4 +
+        coefficients.k3 * r6);
+}
+function mappedNormalizedRadius(normalizedRadius, coefficients) {
+    return normalizedRadius * radialScale(normalizedRadius, coefficients);
+}
+function radialDerivativeFromSquaredRadius(squaredRadius, coefficients) {
+    return (1 +
+        3 * coefficients.k1 * squaredRadius +
+        5 * coefficients.k2 * squaredRadius * squaredRadius +
+        7 *
+            coefficients.k3 *
+            squaredRadius *
+            squaredRadius *
+            squaredRadius);
+}
+function derivativeCriticalSquaredRadii(coefficients) {
+    // d/dr² of the radial derivative:
+    // 3 k1 + 10 k2 s + 21 k3 s² = 0, where s = r².
+    const a = 21 * coefficients.k3;
+    const b = 10 * coefficients.k2;
+    const c = 3 * coefficients.k1;
+    if (a === 0) {
+        return b === 0 ? [] : [-c / b];
+    }
+    const discriminant = b * b - 4 * a * c;
+    if (discriminant < 0) {
+        return [];
+    }
+    const root = Math.sqrt(discriminant);
+    return [(-b - root) / (2 * a), (-b + root) / (2 * a)];
+}
+/** @internal Validates/copies one profile for repeated in-package evaluation. */
+export function validateRadialDistortionProfile(profile) {
+    requirePositiveFinite("profile.normalizationRadiusMm", profile.normalizationRadiusMm);
+    requirePositiveFinite("profile.maximumNormalizedRadius", profile.maximumNormalizedRadius);
+    requireFinite("profile.coefficients.k1", profile.coefficients.k1);
+    requireFinite("profile.coefficients.k2", profile.coefficients.k2);
+    requireFinite("profile.coefficients.k3", profile.coefficients.k3);
+    const maximumSquaredRadius = profile.maximumNormalizedRadius * profile.maximumNormalizedRadius;
+    const candidates = [
+        0,
+        maximumSquaredRadius,
+        ...derivativeCriticalSquaredRadii(profile.coefficients).filter((value) => value > 0 && value < maximumSquaredRadius)
+    ];
+    const minimumRadialDerivative = Math.min(...candidates.map((squaredRadius) => radialDerivativeFromSquaredRadius(squaredRadius, profile.coefficients)));
+    if (!Number.isFinite(minimumRadialDerivative) ||
+        minimumRadialDerivative <= 0) {
+        throw new InvalidScientificInputError("Radial distortion profile must remain strictly monotonic over maximumNormalizedRadius so inverse mapping is single-valued.");
+    }
+    const maximumMappedRadius = mappedNormalizedRadius(profile.maximumNormalizedRadius, profile.coefficients);
+    if (!Number.isFinite(maximumMappedRadius) || maximumMappedRadius <= 0) {
+        throw new InvalidScientificInputError("Radial distortion profile produces an invalid mapped operating radius.");
+    }
+    return {
+        normalizationRadiusMm: profile.normalizationRadiusMm,
+        maximumNormalizedRadius: profile.maximumNormalizedRadius,
+        coefficients: { ...profile.coefficients },
+        minimumRadialDerivative,
+        maximumMappedNormalizedRadius: maximumMappedRadius
+    };
+}
+function requirePoint(name, point) {
+    requireFinite(`${name}.x`, point.x);
+    requireFinite(`${name}.y`, point.y);
+}
+function mappingAssumptions() {
+    return [
+        "Generic rotationally symmetric radial polynomial field mapping",
+        "Distortion is centered on the optical axis; decentering and tangential distortion are not modeled",
+        "Normalized radius is image-plane radius divided by the caller-declared normalizationRadiusMm",
+        "Radial scale is 1 + k1 r^2 + k2 r^4 + k3 r^6",
+        "The declared operating radius is required to remain strictly monotonic so inverse mapping is single-valued",
+        "Coefficients are generic caller inputs and do not represent a named lens unless separately calibrated with defensible provenance"
+    ];
+}
+/**
+ * Applies a generic radial lens-distortion field mapping to one ideal
+ * image-plane point.
+ *
+ * The mapping is rotationally symmetric about the optical axis:
+ *
+ *   p_distorted = p_ideal * (1 + k1 r² + k2 r⁴ + k3 r⁶)
+ *
+ * where r is normalized by the caller-declared physical reference radius.
+ *
+ * The profile is accepted only when the radial mapping is strictly monotonic
+ * over its declared operating radius, which makes inverse destination-to-source
+ * sampling well-defined.
+ */
+export function calculateRadialDistortionMapping(input) {
+    requirePoint("imagePointMm", input.imagePointMm);
+    const profile = validateRadialDistortionProfile(input.profile);
+    const sourceRadiusMm = Math.hypot(input.imagePointMm.x, input.imagePointMm.y);
+    const sourceNormalizedRadius = sourceRadiusMm / profile.normalizationRadiusMm;
+    if (sourceNormalizedRadius > profile.maximumNormalizedRadius) {
+        throw new InvalidScientificInputError("imagePointMm lies outside the radial distortion profile maximumNormalizedRadius.");
+    }
+    const scale = radialScale(sourceNormalizedRadius, profile.coefficients);
+    const mappedImagePointMm = {
+        x: input.imagePointMm.x * scale,
+        y: input.imagePointMm.y * scale
+    };
+    const mappedRadius = sourceNormalizedRadius * scale;
+    const deltaX = mappedImagePointMm.x - input.imagePointMm.x;
+    const deltaY = mappedImagePointMm.y - input.imagePointMm.y;
+    return approximationResult({
+        direction: "undistorted-to-distorted",
+        sourceImagePointMm: { ...input.imagePointMm },
+        mappedImagePointMm,
+        sourceNormalizedRadius,
+        mappedNormalizedRadius: mappedRadius,
+        radialScale: scale,
+        deltaMm: {
+            x: deltaX,
+            y: deltaY,
+            distance: Math.hypot(deltaX, deltaY)
+        },
+        profileMinimumRadialDerivative: profile.minimumRadialDerivative
+    }, "generic-radial-lens-distortion", "1.0.0", mappingAssumptions());
+}
+/**
+ * @internal Minimal inverse evaluation used by composite in-package batch
+ * models that do not need the standalone radial delta/provenance envelope.
+ */
+export function calculateInverseRadialSourcePointValue(distortedImagePointMm, profile, pointPath) {
+    requirePoint(pointPath, distortedImagePointMm);
+    const distortedRadiusMm = Math.hypot(distortedImagePointMm.x, distortedImagePointMm.y);
+    const distortedNormalizedRadius = distortedRadiusMm / profile.normalizationRadiusMm;
+    if (distortedNormalizedRadius >
+        profile.maximumMappedNormalizedRadius) {
+        throw new InvalidScientificInputError(`${pointPath} lies outside the mapped radial distortion profile operating radius.`);
+    }
+    let sourceNormalizedRadius = 0;
+    if (distortedNormalizedRadius > 0) {
+        let lower = 0;
+        let upper = profile.maximumNormalizedRadius;
+        for (let iteration = 0; iteration < INVERSE_BISECTION_ITERATIONS; iteration += 1) {
+            const midpoint = (lower + upper) / 2;
+            const mapped = mappedNormalizedRadius(midpoint, profile.coefficients);
+            if (mapped < distortedNormalizedRadius) {
+                lower = midpoint;
+            }
+            else {
+                upper = midpoint;
+            }
+        }
+        sourceNormalizedRadius = (lower + upper) / 2;
+    }
+    const radialScaleAtSource = radialScale(sourceNormalizedRadius, profile.coefficients);
+    const sourceImagePointMm = distortedNormalizedRadius === 0
+        ? { x: 0, y: 0 }
+        : {
+            x: distortedImagePointMm.x / radialScaleAtSource,
+            y: distortedImagePointMm.y / radialScaleAtSource
+        };
+    return {
+        sourceImagePointMm,
+        distortedNormalizedRadius,
+        sourceNormalizedRadius,
+        radialScaleAtSource
+    };
+}
+function calculateInverseRadialDistortionMappingValue(distortedImagePointMm, profile, pointPath) {
+    const source = calculateInverseRadialSourcePointValue(distortedImagePointMm, profile, pointPath);
+    const deltaX = source.sourceImagePointMm.x - distortedImagePointMm.x;
+    const deltaY = source.sourceImagePointMm.y - distortedImagePointMm.y;
+    return {
+        direction: "distorted-to-undistorted",
+        distortedImagePointMm: { ...distortedImagePointMm },
+        sourceImagePointMm: source.sourceImagePointMm,
+        distortedNormalizedRadius: source.distortedNormalizedRadius,
+        sourceNormalizedRadius: source.sourceNormalizedRadius,
+        radialScaleAtSource: source.radialScaleAtSource,
+        deltaMm: {
+            x: deltaX,
+            y: deltaY,
+            distance: Math.hypot(deltaX, deltaY)
+        },
+        profileMinimumRadialDerivative: profile.minimumRadialDerivative
+    };
+}
+export function calculateInverseRadialDistortionMapping(input) {
+    const profile = validateRadialDistortionProfile(input.profile);
+    const mapping = calculateInverseRadialDistortionMappingValue(input.distortedImagePointMm, profile, "distortedImagePointMm");
+    return approximationResult(mapping, "generic-inverse-radial-lens-distortion", "1.0.0", [
+        ...mappingAssumptions(),
+        `Inverse radius is solved with ${INVERSE_BISECTION_ITERATIONS} deterministic bisection iterations`
+    ]);
+}
+/**
+ * Inverse-maps multiple distorted image-plane destinations while validating
+ * and resolving the radial profile only once for the complete batch.
+ *
+ * The returned per-point mappings are numerically identical to the scalar API;
+ * provenance and profile validation are shared once at the batch boundary.
+ */
+export function calculateInverseRadialDistortionMappings(input) {
+    const profile = validateRadialDistortionProfile(input.profile);
+    const mappings = input.distortedImagePointsMm.map((point, index) => calculateInverseRadialDistortionMappingValue(point, profile, `distortedImagePointsMm[${index}]`));
+    return approximationResult({
+        direction: "distorted-to-undistorted-batch",
+        mappings,
+        pointCount: mappings.length,
+        profileMinimumRadialDerivative: profile.minimumRadialDerivative
+    }, "generic-inverse-radial-lens-distortion-batch", "1.0.0", [
+        ...mappingAssumptions(),
+        `Inverse radius is solved with ${INVERSE_BISECTION_ITERATIONS} deterministic bisection iterations per point`,
+        "The radial profile is validated and its invariant extrema are resolved once for the batch"
+    ]);
+}
+//# sourceMappingURL=radial-distortion.js.map

package/dist/optics/radial-distortion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"radial-distortion.js","sourceRoot":"","sources":["../../src/optics/radial-distortion.ts"],"names":[],"mappings":"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"}

package/dist/output/capture-geometry.d.ts

@@ -0,0 +1,278 @@
+import { type CalculationProvenance, type CalculationResult } from "../core/calculation-result.js";
+import { type NativeImageRaster, type RasterDimensions, type SensorImagingArea } from "../sensor/sensor-geometry.js";
+export type CaptureOrientation = "landscape" | "portrait-clockwise" | "landscape-inverted" | "portrait-counter-clockwise";
+export interface RasterPoint {
+    x: number;
+    y: number;
+}
+export interface RasterVector {
+    x: number;
+    y: number;
+}
+/**
+ * Integer half-open rectangle in raster coordinates.
+ *
+ * Coordinates use a top-left origin with +X to the right and +Y downward.
+ * The covered extent is [x, x + width) × [y, y + height).
+ */
+export interface RasterRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface PhysicalBoundsFromOpticalAxisMm {
+    left: number;
+    right: number;
+    top: number;
+    bottom: number;
+}
+export interface NormalizedRasterUv {
+    /** 0 at the left edge, 1 at the right edge. */
+    u: number;
+    /** 0 at the top edge, 1 at the bottom edge. */
+    v: number;
+}
+/**
+ * Pre-orientation optical image-plane coordinate in millimetres.
+ *
+ * Origin is the optical axis; +X points right and +Y points up.
+ */
+export interface ImagePlaneMetricPointMm {
+    x: number;
+    y: number;
+}
+export interface MapOrientedPhysicalUvToImagePlaneInput {
+    uv: NormalizedRasterUv;
+    /**
+     * Physical region represented by the normalized raster, after physical
+     * camera orientation, using the capture contract's +Y-down physical basis.
+     */
+    orientedPhysicalBoundsFromOpticalAxisMm: PhysicalBoundsFromOpticalAxisMm;
+    orientation: CaptureOrientation;
+}
+export interface MapImagePlanePointToOrientedPhysicalUvInput {
+    imagePlanePointMm: ImagePlaneMetricPointMm;
+    /**
+     * Physical region represented by the normalized raster, after physical
+     * camera orientation, using the capture contract's +Y-down physical basis.
+     */
+    orientedPhysicalBoundsFromOpticalAxisMm: PhysicalBoundsFromOpticalAxisMm;
+    orientation: CaptureOrientation;
+}
+export interface ResolveCaptureGeometryInput {
+    imagingArea: SensorImagingArea;
+    nativeRaster: NativeImageRaster;
+    orientation: CaptureOrientation;
+    /**
+     * Active capture rectangle in native sensor raster coordinates.
+     *
+     * Defaults to the full native raster.
+     */
+    activeCaptureRect?: RasterRect;
+    /**
+     * Final digital/output crop in oriented active-capture raster coordinates.
+     *
+     * Defaults to the full oriented active capture.
+     */
+    outputCropRect?: RasterRect;
+    /**
+     * Final output raster after optional digital crop/resampling.
+     *
+     * Defaults to the output-crop dimensions. The output raster must preserve
+     * the crop aspect ratio within a small integer-rounding tolerance.
+     */
+    outputRaster?: RasterDimensions;
+}
+export interface ResolvedCaptureGeometry {
+    native: {
+        imagingArea: SensorImagingArea;
+        raster: NativeImageRaster;
+    };
+    activeCapture: {
+        nativeRect: RasterRect;
+        imagingArea: SensorImagingArea;
+        /**
+         * Top-left active-area offset from the native imaging-area top-left.
+         */
+        physicalOffsetMm: {
+            x: number;
+            y: number;
+        };
+        /** Active-area center relative to the native optical axis. */
+        centerOffsetFromOpticalAxisMm: RasterVector;
+        /** Native physical bounds relative to the optical axis. */
+        physicalBoundsFromOpticalAxisMm: PhysicalBoundsFromOpticalAxisMm;
+        /**
+         * Current generic model assumes native image samples uniformly span the
+         * declared physical imaging area.
+         */
+        imagingAreaDerivation: "uniform-native-raster";
+        raster: RasterDimensions;
+    };
+    orientedCapture: {
+        orientation: CaptureOrientation;
+        imagingArea: SensorImagingArea;
+        /** Oriented physical bounds relative to the optical axis. */
+        physicalBoundsFromOpticalAxisMm: PhysicalBoundsFromOpticalAxisMm;
+        raster: RasterDimensions;
+    };
+    output: {
+        /**
+         * Digital/output crop expressed in oriented active-capture coordinates.
+         *
+         * This crop does not mutate physical sensor identity or active-capture
+         * geometry.
+         */
+        cropRect: RasterRect;
+        raster: RasterDimensions;
+        /** Physical region retained by the digital/output crop. */
+        imagingArea: SensorImagingArea;
+        physicalBoundsFromOpticalAxisMm: PhysicalBoundsFromOpticalAxisMm;
+        centerOffsetFromOpticalAxisMm: RasterVector;
+        sourceRetainedAreaFraction: number;
+        /** Pixel-domain resampling from oriented active capture into output. */
+        orientedCaptureToOutputScale: {
+            x: number;
+            y: number;
+            axisRelativeDifference: number;
+        };
+    };
+}
+export interface TransformRasterPointInput {
+    point: RasterPoint;
+    nativeRaster: NativeImageRaster;
+    orientation: CaptureOrientation;
+}
+export interface TransformRasterVectorInput {
+    vector: RasterVector;
+    orientation: CaptureOrientation;
+}
+export interface TransformRasterRectInput {
+    rect: RasterRect;
+    nativeRaster: NativeImageRaster;
+    orientation: CaptureOrientation;
+}
+export interface CalculateActiveCaptureFieldOfViewInput {
+    imagingArea: SensorImagingArea;
+    nativeRaster: NativeImageRaster;
+    orientation: CaptureOrientation;
+    activeCaptureRect?: RasterRect;
+    focalLengthMm: number;
+    focusDistanceM?: number;
+}
+export interface CalculateOutputFieldOfViewInput {
+    imagingArea: SensorImagingArea;
+    nativeRaster: NativeImageRaster;
+    orientation: CaptureOrientation;
+    activeCaptureRect?: RasterRect;
+    outputCropRect?: RasterRect;
+    focalLengthMm: number;
+    focusDistanceM?: number;
+}
+export interface ActiveCaptureFieldOfView {
+    orientation: CaptureOrientation;
+    horizontalDegrees: number;
+    verticalDegrees: number;
+    /**
+     * Larger of the two opposite-corner diagonal angular spans. For centered
+     * crops both diagonal spans are equal.
+     */
+    diagonalDegrees: number;
+    horizontalBoundsDegrees: {
+        minimum: number;
+        maximum: number;
+    };
+    verticalBoundsDegrees: {
+        minimum: number;
+        maximum: number;
+    };
+    diagonalDegreesByCornerPair: {
+        topLeftToBottomRight: number;
+        topRightToBottomLeft: number;
+    };
+    activeImagingArea: SensorImagingArea;
+    centerOffsetFromOpticalAxisMm: RasterVector;
+    projection: {
+        projectionDistanceMm: number;
+        provenance: CalculationProvenance;
+    };
+}
+export interface OutputFieldOfView {
+    orientation: CaptureOrientation;
+    horizontalDegrees: number;
+    verticalDegrees: number;
+    diagonalDegrees: number;
+    horizontalBoundsDegrees: {
+        minimum: number;
+        maximum: number;
+    };
+    verticalBoundsDegrees: {
+        minimum: number;
+        maximum: number;
+    };
+    diagonalDegreesByCornerPair: {
+        topLeftToBottomRight: number;
+        topRightToBottomLeft: number;
+    };
+    outputImagingArea: SensorImagingArea;
+    centerOffsetFromOpticalAxisMm: RasterVector;
+    projection: {
+        projectionDistanceMm: number;
+        provenance: CalculationProvenance;
+    };
+}
+/**
+ * Transforms a continuous native raster edge-coordinate point into oriented
+ * capture coordinates. Pixel centers can be represented with +0.5 offsets.
+ */
+export declare function transformNativeRasterPointToOriented(input: TransformRasterPointInput): RasterPoint;
+/** Transforms an oriented raster edge-coordinate point back to native coordinates. */
+export declare function transformOrientedRasterPointToNative(input: TransformRasterPointInput): RasterPoint;
+/** Rotates a native raster vector into oriented coordinates. */
+export declare function transformNativeRasterVectorToOriented(input: TransformRasterVectorInput): RasterVector;
+/** Rotates an oriented raster vector back into native coordinates. */
+export declare function transformOrientedRasterVectorToNative(input: TransformRasterVectorInput): RasterVector;
+/**
+ * Maps normalized coordinates in an oriented physical raster region into the
+ * pre-orientation optical image plane used by lens-field and camera-mapping
+ * APIs.
+ *
+ * The supplied physical bounds use the capture contract's +Y-down basis after
+ * physical camera orientation. The returned image-plane point uses optical-axis
+ * origin, +X right and +Y up. No lens or projection equation is applied.
+ */
+export declare function mapOrientedPhysicalUvToImagePlanePoint(input: MapOrientedPhysicalUvToImagePlaneInput): ImagePlaneMetricPointMm;
+/**
+ * Maps a pre-orientation optical image-plane point into normalized coordinates
+ * of an oriented physical raster region.
+ *
+ * This is the exact coordinate inverse of
+ * mapOrientedPhysicalUvToImagePlanePoint(). Points outside the supplied region
+ * fail closed; a tiny tolerance only absorbs floating-point round-trip noise at
+ * an edge.
+ */
+export declare function mapImagePlanePointToOrientedPhysicalUv(input: MapImagePlanePointToOrientedPhysicalUvInput): NormalizedRasterUv;
+/** Transforms an integer half-open native raster rectangle into oriented coordinates. */
+export declare function transformNativeRasterRectToOriented(input: TransformRasterRectInput): RasterRect;
+/** Transforms an oriented integer half-open rectangle back to native coordinates. */
+export declare function transformOrientedRasterRectToNative(input: TransformRasterRectInput): RasterRect;
+/**
+ * Resolves native sensor geometry, active capture, physical camera orientation,
+ * and final digital/output geometry without conflating their identities.
+ */
+export declare function resolveCaptureGeometry(input: ResolveCaptureGeometryInput): CalculationResult<ResolvedCaptureGeometry>;
+/**
+ * Calculates asymmetric horizontal/vertical FOV plus opposite-corner diagonal
+ * spans for the active physical capture area after physical camera orientation.
+ *
+ * Final digital/output crop is intentionally excluded.
+ */
+export declare function calculateActiveCaptureFieldOfView(input: CalculateActiveCaptureFieldOfViewInput): CalculationResult<ActiveCaptureFieldOfView>;
+/**
+ * Calculates final visible field of view after physical active capture,
+ * orientation, and digital/output crop. Output raster resolution does not
+ * affect this optical/framing result.
+ */
+export declare function calculateOutputFieldOfView(input: CalculateOutputFieldOfViewInput): CalculationResult<OutputFieldOfView>;
+//# sourceMappingURL=capture-geometry.d.ts.map

package/dist/output/capture-geometry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-geometry.d.ts","sourceRoot":"","sources":["../../src/output/capture-geometry.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACvB,MAAM,+BAA+B,CAAC;AAMvC,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACvB,MAAM,8BAA8B,CAAC;AAEtC,MAAM,MAAM,kBAAkB,GAC1B,WAAW,GACX,oBAAoB,GACpB,oBAAoB,GACpB,4BAA4B,CAAC;AASjC,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,+BAA+B;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,+CAA+C;IAC/C,CAAC,EAAE,MAAM,CAAC;IACV,+CAA+C;IAC/C,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,sCAAsC;IACrD,EAAE,EAAE,kBAAkB,CAAC;IACvB;;;OAGG;IACH,uCAAuC,EAAE,+BAA+B,CAAC;IACzE,WAAW,EAAE,kBAAkB,CAAC;CACjC;AAED,MAAM,WAAW,2CAA2C;IAC1D,iBAAiB,EAAE,uBAAuB,CAAC;IAC3C;;;OAGG;IACH,uCAAuC,EAAE,+BAA+B,CAAC;IACzE,WAAW,EAAE,kBAAkB,CAAC;CACjC;AAED,MAAM,WAAW,2BAA2B;IAC1C,WAAW,EAAE,iBAAiB,CAAC;IAC/B,YAAY,EAAE,iBAAiB,CAAC;IAChC,WAAW,EAAE,kBAAkB,CAAC;IAChC;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,UAAU,CAAC;IAC/B;;;;OAIG;IACH,cAAc,CAAC,EAAE,UAAU,CAAC;IAC5B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,gBAAgB,CAAC;CACjC;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE;QACN,WAAW,EAAE,iBAAiB,CAAC;QAC/B,MAAM,EAAE,iBAAiB,CAAC;KAC3B,CAAC;IACF,aAAa,EAAE;QACb,UAAU,EAAE,UAAU,CAAC;QACvB,WAAW,EAAE,iBAAiB,CAAC;QAC/B;;WAEG;QACH,gBAAgB,EAAE;YAChB,CAAC,EAAE,MAAM,CAAC;YACV,CAAC,EAAE,MAAM,CAAC;SACX,CAAC;QACF,8DAA8D;QAC9D,6BAA6B,EAAE,YAAY,CAAC;QAC5C,2DAA2D;QAC3D,+BAA+B,EAAE,+BAA+B,CAAC;QACjE;;;WAGG;QACH,qBAAqB,EAAE,uBAAuB,CAAC;QAC/C,MAAM,EAAE,gBAAgB,CAAC;KAC1B,CAAC;IACF,eAAe,EAAE;QACf,WAAW,EAAE,kBAAkB,CAAC;QAChC,WAAW,EAAE,iBAAiB,CAAC;QAC/B,6DAA6D;QAC7D,+BAA+B,EAAE,+BAA+B,CAAC;QACjE,MAAM,EAAE,gBAAgB,CAAC;KAC1B,CAAC;IACF,MAAM,EAAE;QACN;;;;;WAKG;QACH,QAAQ,EAAE,UAAU,CAAC;QACrB,MAAM,EAAE,gBAAgB,CAAC;QACzB,2DAA2D;QAC3D,WAAW,EAAE,iBAAiB,CAAC;QAC/B,+BAA+B,EAAE,+BAA+B,CAAC;QACjE,6BAA6B,EAAE,YAAY,CAAC;QAC5C,0BAA0B,EAAE,MAAM,CAAC;QACnC,wEAAwE;QACxE,4BAA4B,EAAE;YAC5B,CAAC,EAAE,MAAM,CAAC;YACV,CAAC,EAAE,MAAM,CAAC;YACV,sBAAsB,EAAE,MAAM,CAAC;SAChC,CAAC;KACH,CAAC;CACH;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,WAAW,CAAC;IACnB,YAAY,EAAE,iBAAiB,CAAC;IAChC,WAAW,EAAE,kBAAkB,CAAC;CACjC;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,EAAE,kBAAkB,CAAC;CACjC;AAED,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,UAAU,CAAC;IACjB,YAAY,EAAE,iBAAiB,CAAC;IAChC,WAAW,EAAE,kBAAkB,CAAC;CACjC;AAED,MAAM,WAAW,sCAAsC;IACrD,WAAW,EAAE,iBAAiB,CAAC;IAC/B,YAAY,EAAE,iBAAiB,CAAC;IAChC,WAAW,EAAE,kBAAkB,CAAC;IAChC,iBAAiB,CAAC,EAAE,UAAU,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,+BAA+B;IAC9C,WAAW,EAAE,iBAAiB,CAAC;IAC/B,YAAY,EAAE,iBAAiB,CAAC;IAChC,WAAW,EAAE,kBAAkB,CAAC;IAChC,iBAAiB,CAAC,EAAE,UAAU,CAAC;IAC/B,cAAc,CAAC,EAAE,UAAU,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,kBAAkB,CAAC;IAChC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB,uBAAuB,EAAE;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,qBAAqB,EAAE;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,2BAA2B,EAAE;QAC3B,oBAAoB,EAAE,MAAM,CAAC;QAC7B,oBAAoB,EAAE,MAAM,CAAC;KAC9B,CAAC;IACF,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,6BAA6B,EAAE,YAAY,CAAC;IAC5C,UAAU,EAAE;QACV,oBAAoB,EAAE,MAAM,CAAC;QAC7B,UAAU,EAAE,qBAAqB,CAAC;KACnC,CAAC;CACH;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,kBAAkB,CAAC;IAChC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,uBAAuB,EAAE;QACvB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,qBAAqB,EAAE;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,2BAA2B,EAAE;QAC3B,oBAAoB,EAAE,MAAM,CAAC;QAC7B,oBAAoB,EAAE,MAAM,CAAC;KAC9B,CAAC;IACF,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,6BAA6B,EAAE,YAAY,CAAC;IAC5C,UAAU,EAAE;QACV,oBAAoB,EAAE,MAAM,CAAC;QAC7B,UAAU,EAAE,qBAAqB,CAAC;KACnC,CAAC;CACH;AA6LD;;;GAGG;AACH,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,yBAAyB,GAC/B,WAAW,CAgBb;AAED,sFAAsF;AACtF,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,yBAAyB,GAC/B,WAAW,CAiBb;AAED,gEAAgE;AAChE,wBAAgB,qCAAqC,CACnD,KAAK,EAAE,0BAA0B,GAChC,YAAY,CAId;AAED,sEAAsE;AACtE,wBAAgB,qCAAqC,CACnD,KAAK,EAAE,0BAA0B,GAChC,YAAY,CAId;AAED;;;;;;;;GAQG;AACH,wBAAgB,sCAAsC,CACpD,KAAK,EAAE,sCAAsC,GAC5C,uBAAuB,CAsBzB;AAED;;;;;;;;GAQG;AACH,wBAAgB,sCAAsC,CACpD,KAAK,EAAE,2CAA2C,GACjD,kBAAkB,CA4BpB;AAED,yFAAyF;AACzF,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,wBAAwB,GAC9B,UAAU,CAgCZ;AAED,qFAAqF;AACrF,wBAAgB,mCAAmC,CACjD,KAAK,EAAE,wBAAwB,GAC9B,UAAU,CAiCZ;AA+LD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,2BAA2B,GACjC,iBAAiB,CAAC,uBAAuB,CAAC,CA6H5C;AAED;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,sCAAsC,GAC5C,iBAAiB,CAAC,wBAAwB,CAAC,CA0C7C;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,+BAA+B,GACrC,iBAAiB,CAAC,iBAAiB,CAAC,CAsCtC"}