@photivra/engine 0.6.0 → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +674 -0
- package/CHANGELOG.md +186 -0
- package/CITATION.cff +1 -1
- package/CONTRIBUTING.md +76 -0
- package/DCO +33 -0
- package/NODE_SUPPORT.md +37 -0
- package/NOTICE +2 -0
- package/README.md +138 -71
- package/SECURITY.md +55 -0
- package/THIRD_PARTY.md +63 -0
- package/dist/camera/equivalent-focal-length.d.ts +9 -0
- package/dist/camera/equivalent-focal-length.d.ts.map +1 -1
- package/dist/camera/equivalent-focal-length.js +9 -0
- package/dist/camera/equivalent-focal-length.js.map +1 -1
- package/dist/camera/field-of-view.d.ts +13 -0
- package/dist/camera/field-of-view.d.ts.map +1 -1
- package/dist/camera/field-of-view.js +13 -0
- package/dist/camera/field-of-view.js.map +1 -1
- package/dist/camera/projected-object-size.d.ts +8 -0
- package/dist/camera/projected-object-size.d.ts.map +1 -1
- package/dist/camera/projected-object-size.js +8 -0
- package/dist/camera/projected-object-size.js.map +1 -1
- package/dist/capture/capture-export-metadata.d.ts +60 -0
- package/dist/capture/capture-export-metadata.d.ts.map +1 -0
- package/dist/capture/capture-export-metadata.js +62 -0
- package/dist/capture/capture-export-metadata.js.map +1 -0
- package/dist/capture/environment-raw-producer.d.ts +55 -0
- package/dist/capture/environment-raw-producer.d.ts.map +1 -0
- package/dist/capture/environment-raw-producer.js +88 -0
- package/dist/capture/environment-raw-producer.js.map +1 -0
- package/dist/capture/export-jpeg.d.ts +12 -0
- package/dist/capture/export-jpeg.d.ts.map +1 -0
- package/dist/capture/export-jpeg.js +126 -0
- package/dist/capture/export-jpeg.js.map +1 -0
- package/dist/capture/export-tiff.d.ts +45 -0
- package/dist/capture/export-tiff.d.ts.map +1 -0
- package/dist/capture/export-tiff.js +129 -0
- package/dist/capture/export-tiff.js.map +1 -0
- package/dist/capture/focus-control.d.ts +210 -0
- package/dist/capture/focus-control.d.ts.map +1 -0
- package/dist/capture/focus-control.js +664 -0
- package/dist/capture/focus-control.js.map +1 -0
- package/dist/capture/linear-encoding.d.ts +59 -0
- package/dist/capture/linear-encoding.d.ts.map +1 -0
- package/dist/capture/linear-encoding.js +98 -0
- package/dist/capture/linear-encoding.js.map +1 -0
- package/dist/capture/photographic-export.d.ts +135 -0
- package/dist/capture/photographic-export.d.ts.map +1 -0
- package/dist/capture/photographic-export.js +273 -0
- package/dist/capture/photographic-export.js.map +1 -0
- package/dist/capture/raw-frame-limits.d.ts +12 -0
- package/dist/capture/raw-frame-limits.d.ts.map +1 -0
- package/dist/capture/raw-frame-limits.js +13 -0
- package/dist/capture/raw-frame-limits.js.map +1 -0
- package/dist/capture/raw-frame-reconstruction.d.ts +48 -0
- package/dist/capture/raw-frame-reconstruction.d.ts.map +1 -0
- package/dist/capture/raw-frame-reconstruction.js +146 -0
- package/dist/capture/raw-frame-reconstruction.js.map +1 -0
- package/dist/capture/release-sequence.d.ts +120 -0
- package/dist/capture/release-sequence.d.ts.map +1 -0
- package/dist/capture/release-sequence.js +446 -0
- package/dist/capture/release-sequence.js.map +1 -0
- package/dist/capture/sensor-raw-frame.d.ts +34 -0
- package/dist/capture/sensor-raw-frame.d.ts.map +1 -0
- package/dist/capture/sensor-raw-frame.js +106 -0
- package/dist/capture/sensor-raw-frame.js.map +1 -0
- package/dist/capture/sensor-raw-producer.d.ts +51 -0
- package/dist/capture/sensor-raw-producer.d.ts.map +1 -0
- package/dist/capture/sensor-raw-producer.js +235 -0
- package/dist/capture/sensor-raw-producer.js.map +1 -0
- package/dist/capture/simulated-capture.d.ts +125 -0
- package/dist/capture/simulated-capture.d.ts.map +1 -0
- package/dist/capture/simulated-capture.js +248 -0
- package/dist/capture/simulated-capture.js.map +1 -0
- package/dist/color/capture-color.d.ts +73 -0
- package/dist/color/capture-color.d.ts.map +1 -0
- package/dist/color/capture-color.js +145 -0
- package/dist/color/capture-color.js.map +1 -0
- package/dist/color/sensor-color-development.d.ts +23 -0
- package/dist/color/sensor-color-development.d.ts.map +1 -0
- package/dist/color/sensor-color-development.js +56 -0
- package/dist/color/sensor-color-development.js.map +1 -0
- package/dist/color/white-balance.d.ts +175 -0
- package/dist/color/white-balance.d.ts.map +1 -0
- package/dist/color/white-balance.js +606 -0
- package/dist/color/white-balance.js.map +1 -0
- package/dist/composition/image-formation-plan.d.ts +481 -0
- package/dist/composition/image-formation-plan.d.ts.map +1 -0
- package/dist/composition/image-formation-plan.js +2499 -0
- package/dist/composition/image-formation-plan.js.map +1 -0
- package/dist/composition/plan-consumer.d.ts +53 -0
- package/dist/composition/plan-consumer.d.ts.map +1 -0
- package/dist/composition/plan-consumer.js +119 -0
- package/dist/composition/plan-consumer.js.map +1 -0
- package/dist/core/calculation-result.d.ts.map +1 -1
- package/dist/core/calculation-result.js +6 -0
- package/dist/core/calculation-result.js.map +1 -1
- package/dist/core/canonical-json.d.ts +18 -0
- package/dist/core/canonical-json.d.ts.map +1 -0
- package/dist/core/canonical-json.js +44 -0
- package/dist/core/canonical-json.js.map +1 -0
- package/dist/core/configuration-error.d.ts +6 -0
- package/dist/core/configuration-error.d.ts.map +1 -1
- package/dist/core/configuration-error.js +6 -0
- package/dist/core/configuration-error.js.map +1 -1
- package/dist/core/evidence-provenance.d.ts +6 -0
- package/dist/core/evidence-provenance.d.ts.map +1 -1
- package/dist/core/evidence-provenance.js +7 -0
- package/dist/core/evidence-provenance.js.map +1 -1
- package/dist/core/image-formation.d.ts +9 -3
- package/dist/core/image-formation.d.ts.map +1 -1
- package/dist/core/image-formation.js +29 -5
- package/dist/core/image-formation.js.map +1 -1
- package/dist/core/owned-data.d.ts +25 -0
- package/dist/core/owned-data.d.ts.map +1 -0
- package/dist/core/owned-data.js +34 -0
- package/dist/core/owned-data.js.map +1 -0
- package/dist/core/record-validation.d.ts +17 -0
- package/dist/core/record-validation.d.ts.map +1 -0
- package/dist/core/record-validation.js +44 -0
- package/dist/core/record-validation.js.map +1 -0
- package/dist/core/scientific-assurance.d.ts +101 -0
- package/dist/core/scientific-assurance.d.ts.map +1 -0
- package/dist/core/scientific-assurance.js +301 -0
- package/dist/core/scientific-assurance.js.map +1 -0
- package/dist/core/spectral-composition.d.ts +106 -0
- package/dist/core/spectral-composition.d.ts.map +1 -0
- package/dist/core/spectral-composition.js +334 -0
- package/dist/core/spectral-composition.js.map +1 -0
- package/dist/core/spectral.d.ts +34 -0
- package/dist/core/spectral.d.ts.map +1 -0
- package/dist/core/spectral.js +57 -0
- package/dist/core/spectral.js.map +1 -0
- package/dist/core/validation.d.ts +6 -0
- package/dist/core/validation.d.ts.map +1 -1
- package/dist/core/validation.js +6 -0
- package/dist/core/validation.js.map +1 -1
- package/dist/core/version.d.ts +14 -0
- package/dist/core/version.d.ts.map +1 -0
- package/dist/core/version.js +15 -0
- package/dist/core/version.js.map +1 -0
- package/dist/equipment/exposure-capabilities.d.ts +125 -0
- package/dist/equipment/exposure-capabilities.d.ts.map +1 -0
- package/dist/equipment/exposure-capabilities.js +391 -0
- package/dist/equipment/exposure-capabilities.js.map +1 -0
- package/dist/equipment/generic-tier-assets.d.ts +82 -0
- package/dist/equipment/generic-tier-assets.d.ts.map +1 -0
- package/dist/equipment/generic-tier-assets.js +119 -0
- package/dist/equipment/generic-tier-assets.js.map +1 -0
- package/dist/equipment/generic-tier-presets.d.ts +57 -0
- package/dist/equipment/generic-tier-presets.d.ts.map +1 -0
- package/dist/equipment/generic-tier-presets.js +122 -0
- package/dist/equipment/generic-tier-presets.js.map +1 -0
- package/dist/equipment/iso-capabilities.d.ts +143 -0
- package/dist/equipment/iso-capabilities.d.ts.map +1 -0
- package/dist/equipment/iso-capabilities.js +578 -0
- package/dist/equipment/iso-capabilities.js.map +1 -0
- package/dist/equipment/metering-capabilities.d.ts +58 -0
- package/dist/equipment/metering-capabilities.d.ts.map +1 -0
- package/dist/equipment/metering-capabilities.js +151 -0
- package/dist/equipment/metering-capabilities.js.map +1 -0
- package/dist/equipment/release-capabilities.d.ts +33 -0
- package/dist/equipment/release-capabilities.d.ts.map +1 -0
- package/dist/equipment/release-capabilities.js +176 -0
- package/dist/equipment/release-capabilities.js.map +1 -0
- package/dist/exposure/exposure-duration-control.d.ts +72 -0
- package/dist/exposure/exposure-duration-control.d.ts.map +1 -0
- package/dist/exposure/exposure-duration-control.js +161 -0
- package/dist/exposure/exposure-duration-control.js.map +1 -0
- package/dist/exposure/exposure-mode-resolver.d.ts +637 -0
- package/dist/exposure/exposure-mode-resolver.d.ts.map +1 -0
- package/dist/exposure/exposure-mode-resolver.js +1905 -0
- package/dist/exposure/exposure-mode-resolver.js.map +1 -0
- package/dist/exposure/exposure.d.ts +8 -0
- package/dist/exposure/exposure.d.ts.map +1 -1
- package/dist/exposure/exposure.js +8 -0
- package/dist/exposure/exposure.js.map +1 -1
- package/dist/exposure/flash.d.ts +179 -0
- package/dist/exposure/flash.d.ts.map +1 -0
- package/dist/exposure/flash.js +644 -0
- package/dist/exposure/flash.js.map +1 -0
- package/dist/exposure/metering-scene-radiance.d.ts +72 -0
- package/dist/exposure/metering-scene-radiance.d.ts.map +1 -0
- package/dist/exposure/metering-scene-radiance.js +222 -0
- package/dist/exposure/metering-scene-radiance.js.map +1 -0
- package/dist/exposure/metering-target.d.ts +67 -0
- package/dist/exposure/metering-target.d.ts.map +1 -0
- package/dist/exposure/metering-target.js +265 -0
- package/dist/exposure/metering-target.js.map +1 -0
- package/dist/exposure/metering-temporal.d.ts +76 -0
- package/dist/exposure/metering-temporal.d.ts.map +1 -0
- package/dist/exposure/metering-temporal.js +210 -0
- package/dist/exposure/metering-temporal.js.map +1 -0
- package/dist/exposure/metering.d.ts +124 -0
- package/dist/exposure/metering.d.ts.map +1 -0
- package/dist/exposure/metering.js +422 -0
- package/dist/exposure/metering.js.map +1 -0
- package/dist/exposure/program-line.d.ts +29 -0
- package/dist/exposure/program-line.d.ts.map +1 -0
- package/dist/exposure/program-line.js +126 -0
- package/dist/exposure/program-line.js.map +1 -0
- package/dist/index.d.ts +87 -6
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +85 -6
- package/dist/index.js.map +1 -1
- package/dist/motion/camera-rotation.d.ts +16 -0
- package/dist/motion/camera-rotation.d.ts.map +1 -1
- package/dist/motion/camera-rotation.js +16 -0
- package/dist/motion/camera-rotation.js.map +1 -1
- package/dist/motion/capture-rotation-inverse-mapping.d.ts +13 -0
- package/dist/motion/capture-rotation-inverse-mapping.d.ts.map +1 -1
- package/dist/motion/capture-rotation-inverse-mapping.js +13 -0
- package/dist/motion/capture-rotation-inverse-mapping.js.map +1 -1
- package/dist/motion/capture-rotation-temporal-quadrature.d.ts +15 -0
- package/dist/motion/capture-rotation-temporal-quadrature.d.ts.map +1 -1
- package/dist/motion/capture-rotation-temporal-quadrature.js +15 -0
- package/dist/motion/capture-rotation-temporal-quadrature.js.map +1 -1
- package/dist/motion/capture-rotation-trajectory.d.ts +15 -0
- package/dist/motion/capture-rotation-trajectory.d.ts.map +1 -1
- package/dist/motion/capture-rotation-trajectory.js +15 -0
- package/dist/motion/capture-rotation-trajectory.js.map +1 -1
- package/dist/motion/capture-translation-parallax-temporal-quadrature.d.ts +119 -0
- package/dist/motion/capture-translation-parallax-temporal-quadrature.d.ts.map +1 -0
- package/dist/motion/capture-translation-parallax-temporal-quadrature.js +263 -0
- package/dist/motion/capture-translation-parallax-temporal-quadrature.js.map +1 -0
- package/dist/motion/extended-object-projection.d.ts +175 -0
- package/dist/motion/extended-object-projection.d.ts.map +1 -0
- package/dist/motion/extended-object-projection.js +402 -0
- package/dist/motion/extended-object-projection.js.map +1 -0
- package/dist/motion/projected-motion.d.ts +11 -0
- package/dist/motion/projected-motion.d.ts.map +1 -1
- package/dist/motion/projected-motion.js +11 -0
- package/dist/motion/projected-motion.js.map +1 -1
- package/dist/optics/aperture.d.ts +9 -0
- package/dist/optics/aperture.d.ts.map +1 -1
- package/dist/optics/aperture.js +9 -0
- package/dist/optics/aperture.js.map +1 -1
- package/dist/optics/circle-of-confusion.d.ts +8 -0
- package/dist/optics/circle-of-confusion.d.ts.map +1 -1
- package/dist/optics/circle-of-confusion.js +8 -0
- package/dist/optics/circle-of-confusion.js.map +1 -1
- package/dist/optics/complex-pupil-psf.d.ts +128 -0
- package/dist/optics/complex-pupil-psf.d.ts.map +1 -0
- package/dist/optics/complex-pupil-psf.js +462 -0
- package/dist/optics/complex-pupil-psf.js.map +1 -0
- package/dist/optics/depth-of-field.d.ts +18 -0
- package/dist/optics/depth-of-field.d.ts.map +1 -1
- package/dist/optics/depth-of-field.js +29 -4
- package/dist/optics/depth-of-field.js.map +1 -1
- package/dist/optics/diffraction.d.ts +8 -0
- package/dist/optics/diffraction.d.ts.map +1 -1
- package/dist/optics/diffraction.js +8 -0
- package/dist/optics/diffraction.js.map +1 -1
- package/dist/optics/focus-breathing.d.ts +13 -0
- package/dist/optics/focus-breathing.d.ts.map +1 -1
- package/dist/optics/focus-breathing.js +13 -0
- package/dist/optics/focus-breathing.js.map +1 -1
- package/dist/optics/focus-state.d.ts +47 -0
- package/dist/optics/focus-state.d.ts.map +1 -0
- package/dist/optics/focus-state.js +78 -0
- package/dist/optics/focus-state.js.map +1 -0
- package/dist/optics/front-of-lens-filter.d.ts +114 -0
- package/dist/optics/front-of-lens-filter.d.ts.map +1 -0
- package/dist/optics/front-of-lens-filter.js +468 -0
- package/dist/optics/front-of-lens-filter.js.map +1 -0
- package/dist/optics/illumination-vignetting.d.ts +9 -0
- package/dist/optics/illumination-vignetting.d.ts.map +1 -1
- package/dist/optics/illumination-vignetting.js +9 -0
- package/dist/optics/illumination-vignetting.js.map +1 -1
- package/dist/optics/lateral-chromatic-aberration.d.ts +11 -0
- package/dist/optics/lateral-chromatic-aberration.d.ts.map +1 -1
- package/dist/optics/lateral-chromatic-aberration.js +11 -0
- package/dist/optics/lateral-chromatic-aberration.js.map +1 -1
- package/dist/optics/lens-psf-profile.d.ts +217 -0
- package/dist/optics/lens-psf-profile.d.ts.map +1 -0
- package/dist/optics/lens-psf-profile.js +823 -0
- package/dist/optics/lens-psf-profile.js.map +1 -0
- package/dist/optics/polygon-diffraction.d.ts +67 -0
- package/dist/optics/polygon-diffraction.d.ts.map +1 -0
- package/dist/optics/polygon-diffraction.js +145 -0
- package/dist/optics/polygon-diffraction.js.map +1 -0
- package/dist/optics/profile-contract.d.ts +42 -0
- package/dist/optics/profile-contract.d.ts.map +1 -0
- package/dist/optics/profile-contract.js +92 -0
- package/dist/optics/profile-contract.js.map +1 -0
- package/dist/optics/psf-foundation.d.ts +16 -3
- package/dist/optics/psf-foundation.d.ts.map +1 -1
- package/dist/optics/psf-foundation.js +28 -15
- package/dist/optics/psf-foundation.js.map +1 -1
- package/dist/optics/radial-distortion.d.ts +18 -0
- package/dist/optics/radial-distortion.d.ts.map +1 -1
- package/dist/optics/radial-distortion.js +18 -0
- package/dist/optics/radial-distortion.js.map +1 -1
- package/dist/optics/scene-to-sensor-irradiance.d.ts +213 -0
- package/dist/optics/scene-to-sensor-irradiance.d.ts.map +1 -0
- package/dist/optics/scene-to-sensor-irradiance.js +662 -0
- package/dist/optics/scene-to-sensor-irradiance.js.map +1 -0
- package/dist/optics/scene-to-sensor-quadrature.d.ts +63 -0
- package/dist/optics/scene-to-sensor-quadrature.d.ts.map +1 -0
- package/dist/optics/scene-to-sensor-quadrature.js +82 -0
- package/dist/optics/scene-to-sensor-quadrature.js.map +1 -0
- package/dist/optics/sensor-environment-query.d.ts +60 -0
- package/dist/optics/sensor-environment-query.d.ts.map +1 -0
- package/dist/optics/sensor-environment-query.js +50 -0
- package/dist/optics/sensor-environment-query.js.map +1 -0
- package/dist/optics/sensor-psf-quadrature.d.ts +70 -0
- package/dist/optics/sensor-psf-quadrature.d.ts.map +1 -0
- package/dist/optics/sensor-psf-quadrature.js +101 -0
- package/dist/optics/sensor-psf-quadrature.js.map +1 -0
- package/dist/optics/sensor-psf-support.d.ts +20 -0
- package/dist/optics/sensor-psf-support.d.ts.map +1 -0
- package/dist/optics/sensor-psf-support.js +13 -0
- package/dist/optics/sensor-psf-support.js.map +1 -0
- package/dist/optics/stray-light.d.ts +91 -0
- package/dist/optics/stray-light.d.ts.map +1 -0
- package/dist/optics/stray-light.js +110 -0
- package/dist/optics/stray-light.js.map +1 -0
- package/dist/optics/thin-lens.d.ts +8 -0
- package/dist/optics/thin-lens.d.ts.map +1 -1
- package/dist/optics/thin-lens.js +8 -0
- package/dist/optics/thin-lens.js.map +1 -1
- package/dist/output/capture-corrected-sdr.d.ts +49 -0
- package/dist/output/capture-corrected-sdr.d.ts.map +1 -0
- package/dist/output/capture-corrected-sdr.js +149 -0
- package/dist/output/capture-corrected-sdr.js.map +1 -0
- package/dist/output/capture-geometry.d.ts.map +1 -1
- package/dist/output/capture-geometry.js +8 -0
- package/dist/output/capture-geometry.js.map +1 -1
- package/dist/output/capture-sdr.d.ts +49 -0
- package/dist/output/capture-sdr.d.ts.map +1 -0
- package/dist/output/capture-sdr.js +90 -0
- package/dist/output/capture-sdr.js.map +1 -0
- package/dist/output/crop.d.ts +6 -0
- package/dist/output/crop.d.ts.map +1 -1
- package/dist/output/crop.js +6 -0
- package/dist/output/crop.js.map +1 -1
- package/dist/output/geometric-transforms.d.ts +137 -0
- package/dist/output/geometric-transforms.d.ts.map +1 -0
- package/dist/output/geometric-transforms.js +225 -0
- package/dist/output/geometric-transforms.js.map +1 -0
- package/dist/output/lens-corrections.d.ts +121 -0
- package/dist/output/lens-corrections.d.ts.map +1 -0
- package/dist/output/lens-corrections.js +210 -0
- package/dist/output/lens-corrections.js.map +1 -0
- package/dist/output/sdr-rendering.d.ts +81 -0
- package/dist/output/sdr-rendering.d.ts.map +1 -0
- package/dist/output/sdr-rendering.js +106 -0
- package/dist/output/sdr-rendering.js.map +1 -0
- package/dist/output/subject-framing-crop.d.ts +8 -0
- package/dist/output/subject-framing-crop.d.ts.map +1 -1
- package/dist/output/subject-framing-crop.js +8 -0
- package/dist/output/subject-framing-crop.js.map +1 -1
- package/dist/schema/camera.d.ts +6 -0
- package/dist/schema/camera.d.ts.map +1 -1
- package/dist/schema/illumination-spectral.d.ts +51 -0
- package/dist/schema/illumination-spectral.d.ts.map +1 -0
- package/dist/schema/illumination-spectral.js +132 -0
- package/dist/schema/illumination-spectral.js.map +1 -0
- package/dist/schema/illumination-temporal.d.ts +156 -0
- package/dist/schema/illumination-temporal.d.ts.map +1 -0
- package/dist/schema/illumination-temporal.js +554 -0
- package/dist/schema/illumination-temporal.js.map +1 -0
- package/dist/schema/illumination.d.ts +138 -0
- package/dist/schema/illumination.d.ts.map +1 -0
- package/dist/schema/illumination.js +483 -0
- package/dist/schema/illumination.js.map +1 -0
- package/dist/schema/scene-radiance-temporal.d.ts +107 -0
- package/dist/schema/scene-radiance-temporal.d.ts.map +1 -0
- package/dist/schema/scene-radiance-temporal.js +259 -0
- package/dist/schema/scene-radiance-temporal.js.map +1 -0
- package/dist/schema/scene-radiance.d.ts +185 -0
- package/dist/schema/scene-radiance.d.ts.map +1 -0
- package/dist/schema/scene-radiance.js +535 -0
- package/dist/schema/scene-radiance.js.map +1 -0
- package/dist/schema/scene.d.ts +7 -0
- package/dist/schema/scene.d.ts.map +1 -1
- package/dist/schema/validation.d.ts.map +1 -1
- package/dist/schema/validation.js +7 -0
- package/dist/schema/validation.js.map +1 -1
- package/dist/sensor/accumulated-charge.d.ts +199 -0
- package/dist/sensor/accumulated-charge.d.ts.map +1 -0
- package/dist/sensor/accumulated-charge.js +450 -0
- package/dist/sensor/accumulated-charge.js.map +1 -0
- package/dist/sensor/architecture.d.ts +48 -13
- package/dist/sensor/architecture.d.ts.map +1 -1
- package/dist/sensor/architecture.js +58 -16
- package/dist/sensor/architecture.js.map +1 -1
- package/dist/sensor/camera-saturation-capacity.d.ts +138 -0
- package/dist/sensor/camera-saturation-capacity.d.ts.map +1 -0
- package/dist/sensor/camera-saturation-capacity.js +356 -0
- package/dist/sensor/camera-saturation-capacity.js.map +1 -0
- package/dist/sensor/capture-color-sampling-binding.d.ts +1 -0
- package/dist/sensor/capture-color-sampling-binding.d.ts.map +1 -1
- package/dist/sensor/capture-color-sampling-binding.js +14 -0
- package/dist/sensor/capture-color-sampling-binding.js.map +1 -1
- package/dist/sensor/capture-mode-timing.d.ts +63 -0
- package/dist/sensor/capture-mode-timing.d.ts.map +1 -0
- package/dist/sensor/capture-mode-timing.js +270 -0
- package/dist/sensor/capture-mode-timing.js.map +1 -0
- package/dist/sensor/capture-mode.d.ts.map +1 -1
- package/dist/sensor/capture-mode.js +13 -0
- package/dist/sensor/capture-mode.js.map +1 -1
- package/dist/sensor/color-sampling.d.ts.map +1 -1
- package/dist/sensor/color-sampling.js +19 -0
- package/dist/sensor/color-sampling.js.map +1 -1
- package/dist/sensor/constant-rate-temporal-integration.d.ts +126 -0
- package/dist/sensor/constant-rate-temporal-integration.d.ts.map +1 -0
- package/dist/sensor/constant-rate-temporal-integration.js +382 -0
- package/dist/sensor/constant-rate-temporal-integration.js.map +1 -0
- package/dist/sensor/dark-current.d.ts +169 -0
- package/dist/sensor/dark-current.d.ts.map +1 -0
- package/dist/sensor/dark-current.js +427 -0
- package/dist/sensor/dark-current.js.map +1 -0
- package/dist/sensor/environment-photo-signal.d.ts +123 -0
- package/dist/sensor/environment-photo-signal.d.ts.map +1 -0
- package/dist/sensor/environment-photo-signal.js +186 -0
- package/dist/sensor/environment-photo-signal.js.map +1 -0
- package/dist/sensor/eqe-electron-rate.d.ts +107 -0
- package/dist/sensor/eqe-electron-rate.d.ts.map +1 -0
- package/dist/sensor/eqe-electron-rate.js +561 -0
- package/dist/sensor/eqe-electron-rate.js.map +1 -0
- package/dist/sensor/eqe-local-exposure.d.ts +65 -0
- package/dist/sensor/eqe-local-exposure.d.ts.map +1 -0
- package/dist/sensor/eqe-local-exposure.js +84 -0
- package/dist/sensor/eqe-local-exposure.js.map +1 -0
- package/dist/sensor/eqe-temporal-exposure.d.ts +55 -0
- package/dist/sensor/eqe-temporal-exposure.d.ts.map +1 -0
- package/dist/sensor/eqe-temporal-exposure.js +62 -0
- package/dist/sensor/eqe-temporal-exposure.js.map +1 -0
- package/dist/sensor/exposure-window.d.ts +14 -0
- package/dist/sensor/exposure-window.d.ts.map +1 -1
- package/dist/sensor/exposure-window.js +14 -0
- package/dist/sensor/exposure-window.js.map +1 -1
- package/dist/sensor/iso-signal-chain.d.ts +148 -0
- package/dist/sensor/iso-signal-chain.d.ts.map +1 -0
- package/dist/sensor/iso-signal-chain.js +411 -0
- package/dist/sensor/iso-signal-chain.js.map +1 -0
- package/dist/sensor/local-exposure-binding.d.ts +87 -0
- package/dist/sensor/local-exposure-binding.d.ts.map +1 -0
- package/dist/sensor/local-exposure-binding.js +214 -0
- package/dist/sensor/local-exposure-binding.js.map +1 -0
- package/dist/sensor/optical-stack.d.ts.map +1 -1
- package/dist/sensor/optical-stack.js +17 -0
- package/dist/sensor/optical-stack.js.map +1 -1
- package/dist/sensor/photon-energy.d.ts +97 -0
- package/dist/sensor/photon-energy.d.ts.map +1 -0
- package/dist/sensor/photon-energy.js +390 -0
- package/dist/sensor/photon-energy.js.map +1 -0
- package/dist/sensor/physical-charge-capacity.d.ts +130 -0
- package/dist/sensor/physical-charge-capacity.d.ts.map +1 -0
- package/dist/sensor/physical-charge-capacity.js +345 -0
- package/dist/sensor/physical-charge-capacity.js.map +1 -0
- package/dist/sensor/pixel-pitch.d.ts +6 -0
- package/dist/sensor/pixel-pitch.d.ts.map +1 -1
- package/dist/sensor/pixel-pitch.js +6 -0
- package/dist/sensor/pixel-pitch.js.map +1 -1
- package/dist/sensor/radiometry-readiness.d.ts +10 -0
- package/dist/sensor/radiometry-readiness.d.ts.map +1 -1
- package/dist/sensor/radiometry-readiness.js +10 -0
- package/dist/sensor/radiometry-readiness.js.map +1 -1
- package/dist/sensor/raw-readout.d.ts +314 -0
- package/dist/sensor/raw-readout.d.ts.map +1 -0
- package/dist/sensor/raw-readout.js +914 -0
- package/dist/sensor/raw-readout.js.map +1 -0
- package/dist/sensor/raw-reconstruction.d.ts +170 -0
- package/dist/sensor/raw-reconstruction.d.ts.map +1 -0
- package/dist/sensor/raw-reconstruction.js +424 -0
- package/dist/sensor/raw-reconstruction.js.map +1 -0
- package/dist/sensor/readout-exposure-linkage.d.ts +12 -0
- package/dist/sensor/readout-exposure-linkage.d.ts.map +1 -1
- package/dist/sensor/readout-exposure-linkage.js +12 -0
- package/dist/sensor/readout-exposure-linkage.js.map +1 -1
- package/dist/sensor/readout-timing.d.ts +13 -0
- package/dist/sensor/readout-timing.d.ts.map +1 -1
- package/dist/sensor/readout-timing.js +13 -0
- package/dist/sensor/readout-timing.js.map +1 -1
- package/dist/sensor/response-application-compatibility.d.ts +136 -0
- package/dist/sensor/response-application-compatibility.d.ts.map +1 -0
- package/dist/sensor/response-application-compatibility.js +408 -0
- package/dist/sensor/response-application-compatibility.js.map +1 -0
- package/dist/sensor/response-operating-range.d.ts +173 -0
- package/dist/sensor/response-operating-range.d.ts.map +1 -0
- package/dist/sensor/response-operating-range.js +672 -0
- package/dist/sensor/response-operating-range.js.map +1 -0
- package/dist/sensor/responsivity-photocurrent.d.ts +158 -0
- package/dist/sensor/responsivity-photocurrent.d.ts.map +1 -0
- package/dist/sensor/responsivity-photocurrent.js +644 -0
- package/dist/sensor/responsivity-photocurrent.js.map +1 -0
- package/dist/sensor/sampling-aperture.d.ts.map +1 -1
- package/dist/sensor/sampling-aperture.js +14 -0
- package/dist/sensor/sampling-aperture.js.map +1 -1
- package/dist/sensor/scene-eqe-temporal-exposure.d.ts +45 -0
- package/dist/sensor/scene-eqe-temporal-exposure.d.ts.map +1 -0
- package/dist/sensor/scene-eqe-temporal-exposure.js +64 -0
- package/dist/sensor/scene-eqe-temporal-exposure.js.map +1 -0
- package/dist/sensor/sensor-geometry.d.ts +12 -0
- package/dist/sensor/sensor-geometry.d.ts.map +1 -1
- package/dist/sensor/sensor-geometry.js +12 -0
- package/dist/sensor/sensor-geometry.js.map +1 -1
- package/dist/sensor/signal-noise.d.ts +10 -0
- package/dist/sensor/signal-noise.d.ts.map +1 -1
- package/dist/sensor/signal-noise.js +10 -0
- package/dist/sensor/signal-noise.js.map +1 -1
- package/dist/sensor/spatial-sample-reduction.d.ts +44 -1
- package/dist/sensor/spatial-sample-reduction.d.ts.map +1 -1
- package/dist/sensor/spatial-sample-reduction.js +51 -5
- package/dist/sensor/spatial-sample-reduction.js.map +1 -1
- package/dist/sensor/spatial-sampling-quadrature.d.ts +24 -0
- package/dist/sensor/spatial-sampling-quadrature.d.ts.map +1 -1
- package/dist/sensor/spatial-sampling-quadrature.js +27 -0
- package/dist/sensor/spatial-sampling-quadrature.js.map +1 -1
- package/dist/sensor/spatio-spectral-reduction.d.ts +187 -0
- package/dist/sensor/spatio-spectral-reduction.d.ts.map +1 -0
- package/dist/sensor/spatio-spectral-reduction.js +373 -0
- package/dist/sensor/spatio-spectral-reduction.js.map +1 -0
- package/dist/sensor/spectral-coverage.d.ts +24 -0
- package/dist/sensor/spectral-coverage.d.ts.map +1 -0
- package/dist/sensor/spectral-coverage.js +86 -0
- package/dist/sensor/spectral-coverage.js.map +1 -0
- package/dist/sensor/spectral-quadrature.d.ts +169 -0
- package/dist/sensor/spectral-quadrature.d.ts.map +1 -0
- package/dist/sensor/spectral-quadrature.js +542 -0
- package/dist/sensor/spectral-quadrature.js.map +1 -0
- package/dist/sensor/spectral-response.d.ts +192 -0
- package/dist/sensor/spectral-response.d.ts.map +1 -0
- package/dist/sensor/spectral-response.js +664 -0
- package/dist/sensor/spectral-response.js.map +1 -0
- package/dist/sensor/temporal-eqe-sum.d.ts +15 -0
- package/dist/sensor/temporal-eqe-sum.d.ts.map +1 -0
- package/dist/sensor/temporal-eqe-sum.js +30 -0
- package/dist/sensor/temporal-eqe-sum.js.map +1 -0
- package/dist/sensor/temporal-photo-signal.d.ts +38 -0
- package/dist/sensor/temporal-photo-signal.d.ts.map +1 -0
- package/dist/sensor/temporal-photo-signal.js +110 -0
- package/dist/sensor/temporal-photo-signal.js.map +1 -0
- package/dist/sensor/temporal-sample-binding.d.ts +6 -0
- package/dist/sensor/temporal-sample-binding.d.ts.map +1 -0
- package/dist/sensor/temporal-sample-binding.js +32 -0
- package/dist/sensor/temporal-sample-binding.js.map +1 -0
- package/dist/simulation/poc-simulation.d.ts.map +1 -1
- package/dist/simulation/poc-simulation.js +34 -11
- package/dist/simulation/poc-simulation.js.map +1 -1
- package/dist/stabilization/camera-shake.d.ts +11 -0
- package/dist/stabilization/camera-shake.d.ts.map +1 -1
- package/dist/stabilization/camera-shake.js +11 -0
- package/dist/stabilization/camera-shake.js.map +1 -1
- package/dist/stabilization/system.d.ts +218 -0
- package/dist/stabilization/system.d.ts.map +1 -0
- package/dist/stabilization/system.js +695 -0
- package/dist/stabilization/system.js.map +1 -0
- package/docs/API_REFERENCE.md +2017 -0
- package/docs/API_STYLE.md +132 -0
- package/docs/ARCHITECTURE.md +134 -24
- package/docs/AUTOMATION_COORDINATION.md +2 -0
- package/docs/CAPTURE_COLOR.md +25 -0
- package/docs/CAPTURE_CORRECTED_SDR.md +25 -0
- package/docs/CAPTURE_EXPORT_METADATA.md +27 -0
- package/docs/CAPTURE_SDR.md +20 -0
- package/docs/DEVELOPERS.md +60 -0
- package/docs/DIGITAL_OPTICS_FOUNDATION.md +69 -0
- package/docs/ENVIRONMENT_RAW_CAPTURE.md +187 -0
- package/docs/EXPORT_ACCEPTANCE.md +133 -0
- package/docs/GENERIC_TIER_PRESETS.md +269 -0
- package/docs/GEOMETRIC_PREPARATION_REUSE.md +141 -0
- package/docs/IMAGE_FORMATION.md +80 -10
- package/docs/LINEAR_CAPTURE_ENCODING.md +25 -0
- package/docs/MOTION_AND_SIGNAL.md +5 -3
- package/docs/NUMERICAL_CORRECTNESS.md +191 -0
- package/docs/PERFORMANCE_BASELINE.md +56 -0
- package/docs/PHOTOGRAPHIC_EXPORT.md +206 -0
- package/docs/PHYSICS_FOUNDATION.md +152 -5
- package/docs/POC_API.md +2 -0
- package/docs/POC_PROJECTION_REUSE.md +124 -0
- package/docs/PROCESSED_OUTPUT.md +157 -0
- package/docs/PRODUCTION_COMPOSITION.md +373 -0
- package/docs/PRODUCTION_ENVIRONMENT_CAPTURE.md +131 -0
- package/docs/PROVENANCE.md +4 -0
- package/docs/PSF_FOUNDATION.md +110 -88
- package/docs/RAW_FRAME_ENVELOPE.md +56 -0
- package/docs/RAW_FRAME_RECONSTRUCTION.md +30 -0
- package/docs/RELEASE_1_0.md +65 -0
- package/docs/RELEASE_AUDIT.md +38 -0
- package/docs/SCENE_RADIANCE_AND_ILLUMINATION.md +298 -0
- package/docs/SCENE_SENSOR_QUADRATURE.md +98 -0
- package/docs/SCENE_SENSOR_TEMPORAL_EXPOSURE.md +86 -0
- package/docs/SCIENTIFIC_ASSURANCE.md +280 -0
- package/docs/SCIENTIFIC_CONFORMANCE.md +83 -0
- package/docs/SDR_RENDERING.md +33 -0
- package/docs/SENSOR_ENVIRONMENT_QUERY.md +86 -0
- package/docs/SENSOR_EQE_LOCAL_EXPOSURE.md +104 -0
- package/docs/SENSOR_EQE_TEMPORAL_EXPOSURE.md +74 -0
- package/docs/SENSOR_PSF_QUADRATURE.md +90 -0
- package/docs/SENSOR_RAW_FRAME.md +20 -0
- package/docs/SENSOR_RAW_PRODUCER.md +77 -0
- package/docs/SIGNAL_CONFORMANCE.md +23 -0
- package/docs/SIMULATED_CAPTURE.md +65 -0
- package/docs/STABILIZATION.md +160 -17
- package/docs/TEMPORAL_PHOTO_RAW.md +83 -0
- package/docs/TIER_ACCEPTANCE.md +129 -0
- package/docs/TIER_PRESET_ACCEPTANCE.md +59 -0
- package/docs/USAGE.md +5050 -1047
- package/docs/V1_COMPOSITION_MAP.md +123 -0
- package/docs/V1_HELPER_REUSE_REVIEW.md +60 -0
- package/docs/V1_PERFORMANCE_DISPOSITION.md +88 -0
- package/docs/api/camera-equivalent-focal-length.md +53 -0
- package/docs/api/camera-field-of-view.md +119 -0
- package/docs/api/camera-projected-object-size.md +54 -0
- package/docs/api/capture-capture-export-metadata.md +107 -0
- package/docs/api/capture-environment-raw-producer.md +56 -0
- package/docs/api/capture-focus-control.md +419 -0
- package/docs/api/capture-linear-encoding.md +99 -0
- package/docs/api/capture-photographic-export.md +172 -0
- package/docs/api/capture-raw-frame-reconstruction.md +87 -0
- package/docs/api/capture-release-sequence.md +252 -0
- package/docs/api/capture-sensor-raw-frame.md +66 -0
- package/docs/api/capture-sensor-raw-producer.md +98 -0
- package/docs/api/capture-simulated-capture.md +179 -0
- package/docs/api/color-capture-color.md +122 -0
- package/docs/api/color-white-balance.md +386 -0
- package/docs/api/composition-image-formation-plan.md +825 -0
- package/docs/api/composition-plan-consumer.md +98 -0
- package/docs/api/core-calculation-result.md +220 -0
- package/docs/api/core-configuration-error.md +19 -0
- package/docs/api/core-image-formation.md +204 -0
- package/docs/api/core-scientific-assurance.md +214 -0
- package/docs/api/core-spectral-composition.md +268 -0
- package/docs/api/core-spectral.md +78 -0
- package/docs/api/core-validation.md +34 -0
- package/docs/api/core-version.md +14 -0
- package/docs/api/equipment-exposure-capabilities.md +270 -0
- package/docs/api/equipment-generic-tier-assets.md +82 -0
- package/docs/api/equipment-generic-tier-presets.md +103 -0
- package/docs/api/equipment-iso-capabilities.md +295 -0
- package/docs/api/equipment-metering-capabilities.md +126 -0
- package/docs/api/equipment-release-capabilities.md +91 -0
- package/docs/api/exports.json +5656 -0
- package/docs/api/exposure-exposure-duration-control.md +115 -0
- package/docs/api/exposure-exposure-mode-resolver.md +966 -0
- package/docs/api/exposure-exposure.md +150 -0
- package/docs/api/exposure-flash.md +327 -0
- package/docs/api/exposure-metering-scene-radiance.md +154 -0
- package/docs/api/exposure-metering-target.md +134 -0
- package/docs/api/exposure-metering-temporal.md +77 -0
- package/docs/api/exposure-metering.md +172 -0
- package/docs/api/exposure-program-line.md +64 -0
- package/docs/api/motion-camera-rotation.md +215 -0
- package/docs/api/motion-capture-rotation-inverse-mapping.md +128 -0
- package/docs/api/motion-capture-rotation-temporal-quadrature.md +127 -0
- package/docs/api/motion-capture-rotation-trajectory.md +132 -0
- package/docs/api/motion-capture-translation-parallax-temporal-quadrature.md +171 -0
- package/docs/api/motion-extended-object-projection.md +312 -0
- package/docs/api/motion-projected-motion.md +60 -0
- package/docs/api/optics-aperture.md +69 -0
- package/docs/api/optics-circle-of-confusion.md +46 -0
- package/docs/api/optics-complex-pupil-psf.md +193 -0
- package/docs/api/optics-depth-of-field.md +92 -0
- package/docs/api/optics-diffraction.md +46 -0
- package/docs/api/optics-focus-breathing.md +119 -0
- package/docs/api/optics-focus-state.md +64 -0
- package/docs/api/optics-front-of-lens-filter.md +263 -0
- package/docs/api/optics-illumination-vignetting.md +95 -0
- package/docs/api/optics-lateral-chromatic-aberration.md +225 -0
- package/docs/api/optics-lens-psf-profile.md +380 -0
- package/docs/api/optics-polygon-diffraction.md +68 -0
- package/docs/api/optics-profile-contract.md +47 -0
- package/docs/api/optics-psf-foundation.md +181 -0
- package/docs/api/optics-radial-distortion.md +194 -0
- package/docs/api/optics-scene-to-sensor-irradiance.md +371 -0
- package/docs/api/optics-scene-to-sensor-quadrature.md +78 -0
- package/docs/api/optics-sensor-environment-query.md +58 -0
- package/docs/api/optics-sensor-psf-quadrature.md +81 -0
- package/docs/api/optics-stray-light.md +109 -0
- package/docs/api/optics-thin-lens.md +53 -0
- package/docs/api/output-capture-corrected-sdr.md +71 -0
- package/docs/api/output-capture-geometry.md +500 -0
- package/docs/api/output-capture-sdr.md +69 -0
- package/docs/api/output-crop.md +47 -0
- package/docs/api/output-geometric-transforms.md +199 -0
- package/docs/api/output-lens-corrections.md +162 -0
- package/docs/api/output-sdr-rendering.md +122 -0
- package/docs/api/output-subject-framing-crop.md +59 -0
- package/docs/api/schema-camera.md +84 -0
- package/docs/api/schema-illumination-spectral.md +77 -0
- package/docs/api/schema-illumination-temporal.md +289 -0
- package/docs/api/schema-illumination.md +246 -0
- package/docs/api/schema-scene-radiance-temporal.md +215 -0
- package/docs/api/schema-scene-radiance.md +415 -0
- package/docs/api/schema-scene.md +105 -0
- package/docs/api/schema-validation.md +25 -0
- package/docs/api/sensor-accumulated-charge.md +273 -0
- package/docs/api/sensor-architecture.md +155 -0
- package/docs/api/sensor-camera-saturation-capacity.md +215 -0
- package/docs/api/sensor-capture-color-sampling-binding.md +323 -0
- package/docs/api/sensor-capture-mode-timing.md +123 -0
- package/docs/api/sensor-capture-mode.md +321 -0
- package/docs/api/sensor-color-sampling.md +228 -0
- package/docs/api/sensor-constant-rate-temporal-integration.md +152 -0
- package/docs/api/sensor-dark-current.md +227 -0
- package/docs/api/sensor-environment-photo-signal.md +77 -0
- package/docs/api/sensor-eqe-electron-rate.md +166 -0
- package/docs/api/sensor-eqe-local-exposure.md +68 -0
- package/docs/api/sensor-eqe-temporal-exposure.md +73 -0
- package/docs/api/sensor-exposure-window.md +183 -0
- package/docs/api/sensor-iso-signal-chain.md +264 -0
- package/docs/api/sensor-local-exposure-binding.md +126 -0
- package/docs/api/sensor-optical-stack.md +211 -0
- package/docs/api/sensor-photon-energy.md +149 -0
- package/docs/api/sensor-physical-charge-capacity.md +196 -0
- package/docs/api/sensor-pixel-pitch.md +41 -0
- package/docs/api/sensor-radiometry-readiness.md +240 -0
- package/docs/api/sensor-raw-readout.md +499 -0
- package/docs/api/sensor-raw-reconstruction.md +260 -0
- package/docs/api/sensor-readout-exposure-linkage.md +172 -0
- package/docs/api/sensor-readout-timing.md +209 -0
- package/docs/api/sensor-response-application-compatibility.md +256 -0
- package/docs/api/sensor-response-operating-range.md +293 -0
- package/docs/api/sensor-responsivity-photocurrent.md +245 -0
- package/docs/api/sensor-sampling-aperture.md +221 -0
- package/docs/api/sensor-scene-eqe-temporal-exposure.md +56 -0
- package/docs/api/sensor-sensor-geometry.md +143 -0
- package/docs/api/sensor-signal-noise.md +75 -0
- package/docs/api/sensor-spatial-sample-reduction.md +186 -0
- package/docs/api/sensor-spatial-sampling-quadrature.md +188 -0
- package/docs/api/sensor-spatio-spectral-reduction.md +217 -0
- package/docs/api/sensor-spectral-coverage.md +33 -0
- package/docs/api/sensor-spectral-quadrature.md +183 -0
- package/docs/api/sensor-spectral-response.md +291 -0
- package/docs/api/sensor-temporal-photo-signal.md +62 -0
- package/docs/api/simulation-poc-simulation.md +364 -0
- package/docs/api/stabilization-camera-shake.md +71 -0
- package/docs/api/stabilization-system.md +442 -0
- package/docs/benchmarks/2026-10-01-main-baseline.json +694 -0
- package/docs/benchmarks/2026-10-02-geometric-preparation-reuse.json +2190 -0
- package/docs/benchmarks/2026-10-02-poc-projection-reuse.json +2423 -0
- package/docs/benchmarks/2026-10-02-v1-environment-gc-profile.json +210 -0
- package/docs/benchmarks/2026-10-02-v1-environment-ordinary.json +187 -0
- package/docs/benchmarks/2026-10-02-v1-geometry-gc-profile.json +756 -0
- package/docs/benchmarks/2026-10-02-v1-geometry-ordinary-1.json +711 -0
- package/docs/benchmarks/2026-10-02-v1-geometry-ordinary-2.json +711 -0
- package/docs/benchmarks/2026-10-02-v1-poc-gc-profile.json +885 -0
- package/docs/benchmarks/2026-10-02-v1-poc-ordinary-1.json +868 -0
- package/docs/benchmarks/2026-10-02-v1-poc-ordinary-2.json +868 -0
- package/docs/examples/production-capture.mjs +34 -0
- package/docs/examples/production-request.json +4613 -0
- package/docs/examples/quick-start.mjs +12 -0
- package/docs/validation/documentation-fragments.json +212 -0
- package/docs/validation/release-audit-inventory.json +1306 -0
- package/docs/validation/tier-acceptance-report-v1.json +2538 -0
- package/package.json +15 -3
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
2
|
+
/**
|
|
3
|
+
* Module boundary and integration notes.
|
|
4
|
+
* Validates dense bounded native coverage and exact CFA/mode/site/code identity, without IO.
|
|
5
|
+
* Commits native RAW samples and capture metadata; no demosaic, WB, tone or format packing.
|
|
6
|
+
* @see docs/SENSOR_RAW_FRAME.md for equations, coordinate/unit conventions, blockers and support
|
|
7
|
+
* limits.
|
|
8
|
+
*/
|
|
9
|
+
import { requireAllowlistedRecord, requirePublicOpaqueId } from "../core/record-validation.js";
|
|
10
|
+
import { RAW_ATTACHMENT_MAX_NATIVE_SITES } from "./raw-frame-limits.js";
|
|
11
|
+
import { freezeOwnedData } from "../core/owned-data.js";
|
|
12
|
+
import { InvalidConfigurationError } from "../core/configuration-error.js";
|
|
13
|
+
import { parseSimulatedCapture } from "./simulated-capture.js";
|
|
14
|
+
import { parseSensorColorSamplingProfile } from "../sensor/color-sampling.js";
|
|
15
|
+
import { parseCaptureModeProfile } from "../sensor/capture-mode.js";
|
|
16
|
+
import { parseNativeEffectiveRasterColorSamplingBindingProfile, resolveCaptureModeColorSamplingContributors } from "../sensor/capture-color-sampling-binding.js";
|
|
17
|
+
import {} from "../sensor/raw-reconstruction.js";
|
|
18
|
+
export const SENSOR_RAW_FRAME_SCHEMA_VERSION = "0.1.0";
|
|
19
|
+
function object(value, keys) {
|
|
20
|
+
return requireAllowlistedRecord(value, keys, "Invalid RAW-frame fields.");
|
|
21
|
+
}
|
|
22
|
+
function id(value) {
|
|
23
|
+
return requirePublicOpaqueId(value, "Invalid public RAW-frame ID.");
|
|
24
|
+
}
|
|
25
|
+
function integer(value, maximum) {
|
|
26
|
+
if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0 || value > maximum) {
|
|
27
|
+
throw new InvalidConfigurationError("Invalid RAW-frame integer.");
|
|
28
|
+
}
|
|
29
|
+
return Object.is(value, -0) ? 0 : value;
|
|
30
|
+
}
|
|
31
|
+
function point(value) {
|
|
32
|
+
const r = object(value, ["x", "y"]);
|
|
33
|
+
return { x: integer(r.x, 65535), y: integer(r.y, 65535) };
|
|
34
|
+
}
|
|
35
|
+
const sampleKeys = ["version", "captureModeId", "modeSampleCoordinateSystem", "modeSampleIndexFullFrame",
|
|
36
|
+
"colorSamplingProfileId", "colorSamplingSite", "channelId", "rawCode", "blackLevelCode", "digitalSaturationCode",
|
|
37
|
+
"blackSubtractedNormalizedCode", "readoutProfileId", "readoutRegimeId", "sourceChargeSeedUint32",
|
|
38
|
+
"sourceReadNoiseSeedUint32", "physicalScalarSaturationApplied", "digitalSaturationApplied",
|
|
39
|
+
"cfaPhasePreservedInNativeCoordinates", "physicalOrientationApplied", "outputRotationApplied",
|
|
40
|
+
"groupedModeCombinationApplied", "reconstructionApplied", "aliasingModeled", "moireModeled"];
|
|
41
|
+
function sample(value) {
|
|
42
|
+
const s = object(value, sampleKeys);
|
|
43
|
+
if (s.version !== "0.1.0" || s.modeSampleCoordinateSystem !== "capture-mode-full-frame-effective-sample-index" ||
|
|
44
|
+
s.cfaPhasePreservedInNativeCoordinates !== true || ["physicalOrientationApplied", "outputRotationApplied",
|
|
45
|
+
"groupedModeCombinationApplied", "reconstructionApplied", "aliasingModeled", "moireModeled"].some((key) => s[key] !== false) ||
|
|
46
|
+
typeof s.physicalScalarSaturationApplied !== "boolean" || typeof s.digitalSaturationApplied !== "boolean") {
|
|
47
|
+
throw new InvalidConfigurationError("RAW-frame requires native unreconstructed #14 samples with explicit flags.");
|
|
48
|
+
}
|
|
49
|
+
const rawCode = integer(s.rawCode, 65535), blackLevelCode = integer(s.blackLevelCode, 65535), digitalSaturationCode = integer(s.digitalSaturationCode, 65535);
|
|
50
|
+
if (digitalSaturationCode <= blackLevelCode || rawCode > digitalSaturationCode ||
|
|
51
|
+
(s.digitalSaturationApplied && rawCode !== digitalSaturationCode) ||
|
|
52
|
+
typeof s.blackSubtractedNormalizedCode !== "number" ||
|
|
53
|
+
s.blackSubtractedNormalizedCode !== (rawCode - blackLevelCode) / (digitalSaturationCode - blackLevelCode)) {
|
|
54
|
+
throw new InvalidConfigurationError("RAW-frame code/black/white/normalization mismatch.");
|
|
55
|
+
}
|
|
56
|
+
return { version: "0.1.0", captureModeId: id(s.captureModeId), modeSampleCoordinateSystem: s.modeSampleCoordinateSystem,
|
|
57
|
+
modeSampleIndexFullFrame: point(s.modeSampleIndexFullFrame), colorSamplingProfileId: id(s.colorSamplingProfileId),
|
|
58
|
+
colorSamplingSite: point(s.colorSamplingSite), channelId: id(s.channelId), rawCode, blackLevelCode, digitalSaturationCode,
|
|
59
|
+
blackSubtractedNormalizedCode: s.blackSubtractedNormalizedCode, readoutProfileId: id(s.readoutProfileId),
|
|
60
|
+
readoutRegimeId: id(s.readoutRegimeId), sourceChargeSeedUint32: integer(s.sourceChargeSeedUint32, 0xffffffff),
|
|
61
|
+
sourceReadNoiseSeedUint32: integer(s.sourceReadNoiseSeedUint32, 0xffffffff),
|
|
62
|
+
physicalScalarSaturationApplied: s.physicalScalarSaturationApplied, digitalSaturationApplied: s.digitalSaturationApplied,
|
|
63
|
+
cfaPhasePreservedInNativeCoordinates: true, physicalOrientationApplied: false, outputRotationApplied: false,
|
|
64
|
+
groupedModeCombinationApplied: false, reconstructionApplied: false, aliasingModeled: false, moireModeled: false };
|
|
65
|
+
}
|
|
66
|
+
/** Validates dense bounded native coverage and exact CFA/mode/site/code identity, without IO. */
|
|
67
|
+
export function parseSensorRawFrameInput(value) {
|
|
68
|
+
const r = object(value, ["frameId", "capture", "modeId", "captureModeProfile", "colorSamplingProfile",
|
|
69
|
+
"bindingProfile", "containerBitDepth", "samples"]);
|
|
70
|
+
const capture = parseSimulatedCapture(r.capture), modeId = id(r.modeId), frameId = id(r.frameId);
|
|
71
|
+
const captureModeProfile = parseCaptureModeProfile(r.captureModeProfile), colorSamplingProfile = parseSensorColorSamplingProfile(r.colorSamplingProfile), bindingProfile = parseNativeEffectiveRasterColorSamplingBindingProfile(r.bindingProfile);
|
|
72
|
+
const native = capture.geometry.nativeRaster, count = native.pixelWidth * native.pixelHeight;
|
|
73
|
+
const mode = captureModeProfile.modes.find((m) => m.modeId === modeId);
|
|
74
|
+
if (r.containerBitDepth !== 16 || count > RAW_ATTACHMENT_MAX_NATIVE_SITES || !Array.isArray(r.samples) || r.samples.length !== count ||
|
|
75
|
+
Array.from({ length: count }, (_, i) => i in r.samples).includes(false) ||
|
|
76
|
+
colorSamplingProfile.layout.kind !== "periodic-mosaic" || !mode || mode.acquisition.kind !== "single-frame" ||
|
|
77
|
+
mode.perFrameSampling.kind !== "native-effective-raster" || (mode.reconstructionStages?.length ?? 0) !== 0) {
|
|
78
|
+
throw new InvalidConfigurationError("RAW-frame requires bounded single-frame native periodic CFA coverage and uint16 storage.");
|
|
79
|
+
}
|
|
80
|
+
const samples = r.samples.map(sample);
|
|
81
|
+
for (let i = 0; i < samples.length; i++) {
|
|
82
|
+
const s = samples[i], x = i % native.pixelWidth, y = Math.floor(i / native.pixelWidth);
|
|
83
|
+
const c = resolveCaptureModeColorSamplingContributors({ nativeRaster: native, captureModeProfile, modeId,
|
|
84
|
+
colorSamplingProfile, bindingProfile, modeSampleIndexFullFrame: { x, y } });
|
|
85
|
+
if (c.totalContributorSites !== 1 || c.channelComposition.kind !== "single-channel" ||
|
|
86
|
+
s.captureModeId !== modeId || s.colorSamplingProfileId !== colorSamplingProfile.profileId ||
|
|
87
|
+
s.modeSampleIndexFullFrame.x !== x || s.modeSampleIndexFullFrame.y !== y ||
|
|
88
|
+
s.colorSamplingSite.x !== c.colorSamplingSiteRect.x || s.colorSamplingSite.y !== c.colorSamplingSiteRect.y ||
|
|
89
|
+
s.channelId !== c.channelComposition.channelId || s.readoutProfileId !== samples[0].readoutProfileId ||
|
|
90
|
+
s.readoutRegimeId !== samples[0].readoutRegimeId) {
|
|
91
|
+
throw new InvalidConfigurationError("RAW-frame site/phase/channel/readout binding mismatch.");
|
|
92
|
+
}
|
|
93
|
+
}
|
|
94
|
+
return { frameId, capture, modeId, captureModeProfile, colorSamplingProfile, bindingProfile, containerBitDepth: 16, samples };
|
|
95
|
+
}
|
|
96
|
+
/** Commits native RAW samples and capture metadata; no demosaic, WB, tone or format packing. */
|
|
97
|
+
export function createSensorRawFrame(input) {
|
|
98
|
+
const value = parseSensorRawFrameInput(input);
|
|
99
|
+
const frame = { ...value, schemaVersion: SENSOR_RAW_FRAME_SCHEMA_VERSION, sampleDomain: "native-cfa-raw-code",
|
|
100
|
+
sampleOrder: "native-row-major", producerBinding: "caller-declared-capture-attachment", reconstructionApplied: false,
|
|
101
|
+
renderingApplied: false, nativePixelWidth: value.capture.geometry.nativeRaster.pixelWidth,
|
|
102
|
+
nativePixelHeight: value.capture.geometry.nativeRaster.pixelHeight };
|
|
103
|
+
// Copy all profile/evidence arrays before freezing; never freeze caller-owned inputs.
|
|
104
|
+
return freezeOwnedData(JSON.parse(JSON.stringify(frame)));
|
|
105
|
+
}
|
|
106
|
+
//# sourceMappingURL=sensor-raw-frame.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"sensor-raw-frame.js","sourceRoot":"","sources":["../../src/capture/sensor-raw-frame.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
import { type CalculationResult } from "../core/calculation-result.js";
|
|
2
|
+
import { type SensorRawFrameInput, type SensorRawFrame } from "./sensor-raw-frame.js";
|
|
3
|
+
import { composeSensorAccumulatedCharge, type ComposeSensorPhotoAccumulatedChargeInput as ComposeSensorAccumulatedChargeInput } from "../sensor/accumulated-charge.js";
|
|
4
|
+
import { assessSensorPhysicalChargeCapacity, type SensorPhysicalChargeCapacityProfile } from "../sensor/physical-charge-capacity.js";
|
|
5
|
+
import { simulateSensorChargeRealization, simulateSensorRawCode, type SensorChargeSamplingProfile, type SensorReadoutConversionProfile } from "../sensor/raw-readout.js";
|
|
6
|
+
import { type CalculateCaptureExposureWindowsInput, type CaptureExposureWindows } from "../sensor/exposure-window.js";
|
|
7
|
+
export declare const SENSOR_RAW_PRODUCER_SCHEMA_VERSION: "0.3.0";
|
|
8
|
+
/** Capture noise model identity binds the seed schedule and signed electronic readout behavior. */
|
|
9
|
+
export declare const SENSOR_RAW_PRODUCER_NOISE_MODEL: Readonly<{
|
|
10
|
+
readonly id: "photivra-native-raw-noise";
|
|
11
|
+
readonly version: "0.2.0";
|
|
12
|
+
}>;
|
|
13
|
+
/** One declared EQE/dark/completeness event and explicit readout state per native site. */
|
|
14
|
+
export interface SensorRawProducerSiteInput {
|
|
15
|
+
charge: ComposeSensorAccumulatedChargeInput;
|
|
16
|
+
samplingProfile: SensorChargeSamplingProfile;
|
|
17
|
+
capacityProfile: SensorPhysicalChargeCapacityProfile;
|
|
18
|
+
operatingStateId: string;
|
|
19
|
+
readoutProfile: SensorReadoutConversionProfile;
|
|
20
|
+
regimeId: string;
|
|
21
|
+
}
|
|
22
|
+
/** Full-native exposure schedule; sampling coordinates belong to the producer. */
|
|
23
|
+
export type SensorRawProducerExposureWindowInput = Omit<CalculateCaptureExposureWindowsInput, "nativeRaster" | "activeCaptureRect" | "samplePointsNative">;
|
|
24
|
+
/** Bounded single-frame handoff, never a conversion from independent RGB pixels. */
|
|
25
|
+
export interface SensorRawProducerInput {
|
|
26
|
+
frame: Omit<SensorRawFrameInput, "samples">;
|
|
27
|
+
sites: readonly SensorRawProducerSiteInput[];
|
|
28
|
+
/** Omission preserves the existing global 0..shutterSeconds event contract. */
|
|
29
|
+
exposureWindow?: SensorRawProducerExposureWindowInput;
|
|
30
|
+
}
|
|
31
|
+
/** Engine-produced codes and child diagnostics; upstream radiance/response truth remains declared. */
|
|
32
|
+
export interface SensorRawProducerResult {
|
|
33
|
+
schemaVersion: typeof SENSOR_RAW_PRODUCER_SCHEMA_VERSION;
|
|
34
|
+
codeProducer: "engine-charge-capacity-noise-adc";
|
|
35
|
+
upstreamOrigin: "declared-eqe-and-dark-exposure-results";
|
|
36
|
+
upstreamRadiometryVerified: false;
|
|
37
|
+
seedSchedule: "capture-seed-plus-two-native-index-modulo-2-to-32-v1";
|
|
38
|
+
frame: SensorRawFrame;
|
|
39
|
+
localExposureWindows?: CalculationResult<CaptureExposureWindows>;
|
|
40
|
+
sites: readonly {
|
|
41
|
+
accumulatedCharge: ReturnType<typeof composeSensorAccumulatedCharge>;
|
|
42
|
+
capacity: ReturnType<typeof assessSensorPhysicalChargeCapacity>;
|
|
43
|
+
realization: ReturnType<typeof simulateSensorChargeRealization>;
|
|
44
|
+
readout: ReturnType<typeof simulateSensorRawCode>;
|
|
45
|
+
}[];
|
|
46
|
+
}
|
|
47
|
+
/** Validates complete native exposure inputs; no charge/noise/RAW code is accepted as a shortcut. */
|
|
48
|
+
export declare function parseSensorRawProducerInput(value: unknown): SensorRawProducerInput;
|
|
49
|
+
/** Composes existing accumulated-charge → capacity → Poisson → read noise/ADC → native sample → immutable frame contracts. */
|
|
50
|
+
export declare function simulateSensorRawFrame(input: SensorRawProducerInput): CalculationResult<SensorRawProducerResult>;
|
|
51
|
+
//# sourceMappingURL=sensor-raw-producer.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"sensor-raw-producer.d.ts","sourceRoot":"","sources":["../../src/capture/sensor-raw-producer.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAuB,KAAK,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAI5F,OAAO,EAAwB,KAAK,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5G,OAAO,EAAE,8BAA8B,EACrC,KAAK,wCAAwC,IAAI,mCAAmC,EAAE,MAAM,iCAAiC,CAAC;AAChI,OAAO,EAAE,kCAAkC,EACzC,KAAK,mCAAmC,EAAE,MAAM,uCAAuC,CAAC;AAC1F,OAAO,EAAE,+BAA+B,EAAE,qBAAqB,EACI,KAAK,2BAA2B,EAAE,KAAK,8BAA8B,EAAE,MAAM,0BAA0B,CAAC;AAK3K,OAAO,EAAmC,KAAK,oCAAoC,EAAE,KAAK,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAEvJ,eAAO,MAAM,kCAAkC,EAAG,OAAgB,CAAC;AACnE,mGAAmG;AACnG,eAAO,MAAM,+BAA+B;;;EAAgF,CAAC;AAC7H,2FAA2F;AAC3F,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,mCAAmC,CAAC;IAC5C,eAAe,EAAE,2BAA2B,CAAC;IAC7C,eAAe,EAAE,mCAAmC,CAAC;IACrD,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,8BAA8B,CAAC;IAC/C,QAAQ,EAAE,MAAM,CAAC;CAClB;AACD,kFAAkF;AAClF,MAAM,MAAM,oCAAoC,GAAG,IAAI,CAAC,oCAAoC,EAC1F,cAAc,GAAG,mBAAmB,GAAG,oBAAoB,CAAC,CAAC;AAC/D,oFAAoF;AACpF,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,IAAI,CAAC,mBAAmB,EAAE,SAAS,CAAC,CAAC;IAC5C,KAAK,EAAE,SAAS,0BAA0B,EAAE,CAAC;IAC7C,+EAA+E;IAC/E,cAAc,CAAC,EAAE,oCAAoC,CAAC;CACvD;AACD,sGAAsG;AACtG,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,OAAO,kCAAkC,CAAC;IACzD,YAAY,EAAE,kCAAkC,CAAC;IACjD,cAAc,EAAE,wCAAwC,CAAC;IACzD,0BAA0B,EAAE,KAAK,CAAC;IAClC,YAAY,EAAE,sDAAsD,CAAC;IACrE,KAAK,EAAE,cAAc,CAAC;IACtB,oBAAoB,CAAC,EAAE,iBAAiB,CAAC,sBAAsB,CAAC,CAAC;IACjE,KAAK,EAAE,SAAS;QACd,iBAAiB,EAAE,UAAU,CAAC,OAAO,8BAA8B,CAAC,CAAC;QACrE,QAAQ,EAAE,UAAU,CAAC,OAAO,kCAAkC,CAAC,CAAC;QAChE,WAAW,EAAE,UAAU,CAAC,OAAO,+BAA+B,CAAC,CAAC;QAChE,OAAO,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;KACnD,EAAE,CAAC;CACL;AAoHD,qGAAqG;AACrG,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,sBAAsB,CAiDlF;AACD,8HAA8H;AAC9H,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,sBAAsB,GAAG,iBAAiB,CAAC,uBAAuB,CAAC,CA2BhH"}
|
|
@@ -0,0 +1,235 @@
|
|
|
1
|
+
// SPDX-License-Identifier: Apache-2.0
|
|
2
|
+
/**
|
|
3
|
+
* Module boundary and integration notes.
|
|
4
|
+
* Validates complete native exposure inputs; no charge/noise/RAW code is accepted as a shortcut.
|
|
5
|
+
* Composes existing accumulated-charge → capacity → Poisson → read noise/ADC → native sample →
|
|
6
|
+
* immutable frame contracts.
|
|
7
|
+
* @see docs/SIMULATED_CAPTURE.md for equations, coordinate/unit conventions, blockers and support
|
|
8
|
+
* limits.
|
|
9
|
+
*/
|
|
10
|
+
import { requireAllowlistedRecord, requirePublicOpaqueId } from "../core/record-validation.js";
|
|
11
|
+
import { parseSensorEqeTemporalPhotoSignal } from "../sensor/temporal-photo-signal.js";
|
|
12
|
+
import { RAW_REFERENCE_MAX_NATIVE_SITES } from "./raw-frame-limits.js";
|
|
13
|
+
import { approximationResult } from "../core/calculation-result.js";
|
|
14
|
+
import { InvalidConfigurationError } from "../core/configuration-error.js";
|
|
15
|
+
import { parseEvidenceList } from "../core/evidence-provenance.js";
|
|
16
|
+
import { parseSimulatedCapture } from "./simulated-capture.js";
|
|
17
|
+
import { createSensorRawFrame } from "./sensor-raw-frame.js";
|
|
18
|
+
import { composeSensorAccumulatedCharge, parseSensorAccumulatedChargeCompletenessProfile, parseSensorAdditionalStoredChargeComponent } from "../sensor/accumulated-charge.js";
|
|
19
|
+
import { assessSensorPhysicalChargeCapacity, parseSensorPhysicalChargeCapacityProfile } from "../sensor/physical-charge-capacity.js";
|
|
20
|
+
import { simulateSensorChargeRealization, simulateSensorRawCode, parseSensorChargeSamplingProfile, parseSensorReadoutConversionProfile, resolveSensorReadoutRegime } from "../sensor/raw-readout.js";
|
|
21
|
+
import { createSensorRawCaptureSample } from "../sensor/raw-reconstruction.js";
|
|
22
|
+
import { parseSensorColorSamplingProfile } from "../sensor/color-sampling.js";
|
|
23
|
+
import { parseCaptureModeProfile } from "../sensor/capture-mode.js";
|
|
24
|
+
import { parseNativeEffectiveRasterColorSamplingBindingProfile, resolveCaptureModeColorSamplingContributors } from "../sensor/capture-color-sampling-binding.js";
|
|
25
|
+
import { calculateCaptureExposureWindows } from "../sensor/exposure-window.js";
|
|
26
|
+
export const SENSOR_RAW_PRODUCER_SCHEMA_VERSION = "0.3.0";
|
|
27
|
+
/** Capture noise model identity binds the seed schedule and signed electronic readout behavior. */
|
|
28
|
+
export const SENSOR_RAW_PRODUCER_NOISE_MODEL = Object.freeze({ id: "photivra-native-raw-noise", version: "0.2.0" });
|
|
29
|
+
function fields(value, allowed) {
|
|
30
|
+
return requireAllowlistedRecord(value, allowed, "Invalid sensor RAW producer fields.");
|
|
31
|
+
}
|
|
32
|
+
function publicId(value) {
|
|
33
|
+
return requirePublicOpaqueId(value, "Expected public producer identity.");
|
|
34
|
+
}
|
|
35
|
+
function publicIdentities(value) {
|
|
36
|
+
if (value === null || typeof value !== "object")
|
|
37
|
+
return;
|
|
38
|
+
for (const [key, child] of Object.entries(value)) {
|
|
39
|
+
if (/(?:Id|Version)$/.test(key))
|
|
40
|
+
publicId(child);
|
|
41
|
+
else if (/Ids$/.test(key))
|
|
42
|
+
dense(child, 256).forEach(publicId);
|
|
43
|
+
else
|
|
44
|
+
publicIdentities(child);
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
function dense(value, maximum) {
|
|
48
|
+
if (!Array.isArray(value) || value.length > maximum || Array.from({ length: value.length }, (_, i) => i in value).includes(false)) {
|
|
49
|
+
throw new InvalidConfigurationError("Expected bounded dense producer array.");
|
|
50
|
+
}
|
|
51
|
+
return value;
|
|
52
|
+
}
|
|
53
|
+
function optionalEvidence(value) {
|
|
54
|
+
return dense(value, 256).length === 0 ? [] : parseEvidenceList(value, "optionalExposureEvidence");
|
|
55
|
+
}
|
|
56
|
+
function exposureEvidence(value, temporalPhoto) {
|
|
57
|
+
if (temporalPhoto !== undefined)
|
|
58
|
+
return parseSensorEqeTemporalPhotoSignal({ ...temporalPhoto, componentEvidence: value }).componentEvidence;
|
|
59
|
+
const r = fields(value, ["stationarity", "exposureBinding"]);
|
|
60
|
+
const b = fields(r.exposureBinding, ["binding", "colorSamplingProfile", "nominalExposureDuration", "openingBoundary", "closingBoundary"]);
|
|
61
|
+
return { stationarity: parseEvidenceList(r.stationarity, "stationarity"), exposureBinding: {
|
|
62
|
+
binding: parseEvidenceList(b.binding, "binding"), colorSamplingProfile: parseEvidenceList(b.colorSamplingProfile, "colorSamplingProfile"),
|
|
63
|
+
nominalExposureDuration: parseEvidenceList(b.nominalExposureDuration, "nominalExposureDuration"),
|
|
64
|
+
openingBoundary: optionalEvidence(b.openingBoundary), closingBoundary: optionalEvidence(b.closingBoundary)
|
|
65
|
+
} };
|
|
66
|
+
}
|
|
67
|
+
const common = ["colorSamplingProfileId", "channelId", "site", "bindingId", "stationarityProfileId", "timeReference",
|
|
68
|
+
"startOffsetSecondsFromOpeningReference", "endOffsetSecondsFromOpeningReference", "localExposureDurationSeconds", "componentEvidence"];
|
|
69
|
+
const photoTrue = ["timeStationarityEstablished", "temporalIntegrationApplied", "exposureDurationApplied", "countsAreExpectationValues"];
|
|
70
|
+
const photoFalse = ["timeVaryingSignalIntegrated", "multiFrameSequenceIntegrated", "darkChargeIncluded", "otherChargeIncluded",
|
|
71
|
+
"physicalFullWellAssessmentAuthorized", "cameraSaturationAssessmentAuthorized", "saturationAssessed", "shotNoiseApplied",
|
|
72
|
+
"readNoiseApplied", "adcQuantizationApplied", "rawCodeValueProduced", "integerPhotonCountSampled", "integerElectronCountSampled", "chargeCalculated", "currentCalculated"];
|
|
73
|
+
function chargeInput(value) {
|
|
74
|
+
const r = fields(value, ["photoSignal", "darkCharge", "additionalChargeComponents", "completenessProfile"]);
|
|
75
|
+
const temporal = r.photoSignal !== null && typeof r.photoSignal === "object" &&
|
|
76
|
+
r.photoSignal.kind === "eqe-temporal-photo-signal";
|
|
77
|
+
const p = temporal ? parseSensorEqeTemporalPhotoSignal(r.photoSignal) : fields(r.photoSignal, [...common, ...photoTrue, ...photoFalse, "kind", "stationarityStatus", "integrationMethod",
|
|
78
|
+
"accumulatedSignalCompleteness", "incidentPhotonRatePerSecond", "expectedGeneratedElectronRatePerSecond", "expectedIncidentPhotonCount", "expectedGeneratedElectronCount"]);
|
|
79
|
+
const darkFalse = ["integerDarkElectronCountSampled", "darkShotNoiseApplied", "darkCurrentCompensationApplied", "photoSignalIncluded",
|
|
80
|
+
"otherChargeIncluded", "physicalFullWellAssessmentAuthorized", "saturationAssessed"];
|
|
81
|
+
const d = fields(r.darkCharge, [...common, ...darkFalse, "darkCurrentProfileId", "operatingTemperatureC", "temperatureModel",
|
|
82
|
+
"temperatureInterpolationUsed", "temporalIntegrationId", "darkCurrentElectronsPerSecond", "expectedDarkElectronCount", "countMeaning", "expectationValueOnly", "spatialDarkCurrentNonuniformityModeled"]);
|
|
83
|
+
if ((!temporal && (p.kind !== "eqe-expected-counts" || p.integrationMethod !== "constant-rate-times-local-exposure-duration" ||
|
|
84
|
+
p.accumulatedSignalCompleteness !== "photo-signal-only" || (p.stationarityStatus !== "established" && p.stationarityStatus !== "approximation") ||
|
|
85
|
+
photoTrue.some((k) => p[k] !== true) || photoFalse.some((k) => p[k] !== false))) || darkFalse.some((k) => d[k] !== false) ||
|
|
86
|
+
d.expectationValueOnly !== true || d.countMeaning !== "expected-thermally-generated-electrons" ||
|
|
87
|
+
typeof d.spatialDarkCurrentNonuniformityModeled !== "boolean" || typeof d.temperatureInterpolationUsed !== "boolean" ||
|
|
88
|
+
(d.temperatureModel !== "fixed-reference-temperature" && d.temperatureModel !== "piecewise-linear-temperature-table")) {
|
|
89
|
+
throw new InvalidConfigurationError("Producer requires untreated EQE/dark exposure expectations, not sampled, clipped or A/W charge.");
|
|
90
|
+
}
|
|
91
|
+
if (d.temperatureModel === "fixed-reference-temperature" && d.temperatureInterpolationUsed !== false) {
|
|
92
|
+
throw new InvalidConfigurationError("Fixed-temperature dark result cannot claim temperature interpolation.");
|
|
93
|
+
}
|
|
94
|
+
for (const record of [p, d]) {
|
|
95
|
+
for (const k of ["colorSamplingProfileId", "channelId", "bindingId", temporal ? "temporalIntegrationId" : "stationarityProfileId"])
|
|
96
|
+
publicId(record[k]);
|
|
97
|
+
fields(record.site, ["x", "y"]);
|
|
98
|
+
if (record.timeReference !== "first-opening-boundary-phase")
|
|
99
|
+
throw new InvalidConfigurationError("Unsupported producer time origin.");
|
|
100
|
+
}
|
|
101
|
+
publicId(d.darkCurrentProfileId);
|
|
102
|
+
for (const [record, keys] of [[p, ["incidentPhotonRatePerSecond", "expectedGeneratedElectronRatePerSecond", "expectedIncidentPhotonCount", "expectedGeneratedElectronCount"]],
|
|
103
|
+
[d, ["darkCurrentElectronsPerSecond", "expectedDarkElectronCount"]]]) {
|
|
104
|
+
for (const k of keys)
|
|
105
|
+
if (!(temporal && record === p && k.endsWith("RatePerSecond")) && (typeof record[k] !== "number" || !Number.isFinite(record[k]) || record[k] < 0))
|
|
106
|
+
throw new InvalidConfigurationError("Invalid expected rates/counts.");
|
|
107
|
+
}
|
|
108
|
+
const duration = p.localExposureDurationSeconds;
|
|
109
|
+
if (typeof duration !== "number" || !Number.isFinite(duration) || duration <= 0 ||
|
|
110
|
+
(!temporal && (p.expectedIncidentPhotonCount !== p.incidentPhotonRatePerSecond * duration ||
|
|
111
|
+
p.expectedGeneratedElectronCount !== p.expectedGeneratedElectronRatePerSecond * duration)) ||
|
|
112
|
+
d.expectedDarkElectronCount !== d.darkCurrentElectronsPerSecond * duration ||
|
|
113
|
+
p.expectedGeneratedElectronCount > p.expectedIncidentPhotonCount) {
|
|
114
|
+
throw new InvalidConfigurationError("Exposure expectations must match their exact temporal integral or constant-rate products and EQE domain.");
|
|
115
|
+
}
|
|
116
|
+
const e = fields(d.componentEvidence, ["darkCurrent", "siteApproximation", "exposure"]);
|
|
117
|
+
const charge = { photoSignal: { ...p, componentEvidence: exposureEvidence(p.componentEvidence, temporal ? p : undefined) },
|
|
118
|
+
darkCharge: { ...d, componentEvidence: { darkCurrent: parseEvidenceList(e.darkCurrent, "darkCurrent"),
|
|
119
|
+
siteApproximation: optionalEvidence(e.siteApproximation), exposure: exposureEvidence(e.exposure, temporal ? p : undefined) } },
|
|
120
|
+
completenessProfile: parseSensorAccumulatedChargeCompletenessProfile(r.completenessProfile),
|
|
121
|
+
...(r.additionalChargeComponents === undefined ? {} : { additionalChargeComponents: dense(r.additionalChargeComponents, 32).map(parseSensorAdditionalStoredChargeComponent) }) };
|
|
122
|
+
// Existing composition owns exact photo/dark/additional/completeness event consistency.
|
|
123
|
+
composeSensorAccumulatedCharge(charge);
|
|
124
|
+
return charge;
|
|
125
|
+
}
|
|
126
|
+
function localWindows(frame, value) {
|
|
127
|
+
const r = fields(value, ["shutterMechanism", "nominalExposureDurationSeconds", "opening", "closing"]);
|
|
128
|
+
fields(r.nominalExposureDurationSeconds, ["value", "unit", "evidence"]);
|
|
129
|
+
for (const boundary of [r.opening, r.closing]) {
|
|
130
|
+
const b = fields(boundary, ["kind", "directionNative", "traversalDurationSeconds"]);
|
|
131
|
+
if (b.directionNative !== undefined)
|
|
132
|
+
fields(b.directionNative, ["value", "evidence"]);
|
|
133
|
+
if (b.traversalDurationSeconds !== undefined)
|
|
134
|
+
fields(b.traversalDurationSeconds, ["value", "unit", "evidence"]);
|
|
135
|
+
}
|
|
136
|
+
const native = frame.capture.geometry.nativeRaster;
|
|
137
|
+
const timing = calculateCaptureExposureWindows({
|
|
138
|
+
...r,
|
|
139
|
+
nativeRaster: native,
|
|
140
|
+
samplePointsNative: Array.from({ length: native.pixelWidth * native.pixelHeight }, (_, i) => ({
|
|
141
|
+
x: i % native.pixelWidth + 0.5, y: Math.floor(i / native.pixelWidth) + 0.5
|
|
142
|
+
}))
|
|
143
|
+
});
|
|
144
|
+
if (timing.value.nominalExposureDurationSeconds.value !== frame.capture.exposure.shutterSeconds) {
|
|
145
|
+
throw new InvalidConfigurationError("Exposure schedule nominal duration differs from committed capture.");
|
|
146
|
+
}
|
|
147
|
+
return timing;
|
|
148
|
+
}
|
|
149
|
+
function sourceBoundary(schedule) {
|
|
150
|
+
return schedule.kind === "simultaneous" ? { kind: "simultaneous" } : {
|
|
151
|
+
kind: "uniform-linear-native-scan", directionNative: schedule.directionNative,
|
|
152
|
+
traversalDurationSeconds: schedule.traversalDurationSeconds
|
|
153
|
+
};
|
|
154
|
+
}
|
|
155
|
+
/** Validates complete native exposure inputs; no charge/noise/RAW code is accepted as a shortcut. */
|
|
156
|
+
export function parseSensorRawProducerInput(value) {
|
|
157
|
+
const r = fields(value, ["frame", "sites", "exposureWindow"]), f = fields(r.frame, ["frameId", "capture", "modeId", "captureModeProfile", "colorSamplingProfile", "bindingProfile", "containerBitDepth"]);
|
|
158
|
+
const capture = parseSimulatedCapture(f.capture), native = capture.geometry.nativeRaster, count = native.pixelWidth * native.pixelHeight;
|
|
159
|
+
const sites = dense(r.sites, RAW_REFERENCE_MAX_NATIVE_SITES);
|
|
160
|
+
const frame = { frameId: publicId(f.frameId), capture, modeId: publicId(f.modeId), containerBitDepth: 16,
|
|
161
|
+
captureModeProfile: parseCaptureModeProfile(f.captureModeProfile), colorSamplingProfile: parseSensorColorSamplingProfile(f.colorSamplingProfile),
|
|
162
|
+
bindingProfile: parseNativeEffectiveRasterColorSamplingBindingProfile(f.bindingProfile) };
|
|
163
|
+
const mode = frame.captureModeProfile.modes.find((m) => m.modeId === frame.modeId);
|
|
164
|
+
if (f.containerBitDepth !== 16 || count > RAW_REFERENCE_MAX_NATIVE_SITES || sites.length !== count ||
|
|
165
|
+
capture.noise.model.id !== SENSOR_RAW_PRODUCER_NOISE_MODEL.id || capture.noise.model.version !== SENSOR_RAW_PRODUCER_NOISE_MODEL.version ||
|
|
166
|
+
frame.colorSamplingProfile.layout.kind !== "periodic-mosaic" || !mode || mode.acquisition.kind !== "single-frame" ||
|
|
167
|
+
mode.perFrameSampling.kind !== "native-effective-raster" || (mode.reconstructionStages?.length ?? 0) !== 0) {
|
|
168
|
+
throw new InvalidConfigurationError("Producer requires exact noise identity and bounded single-frame native CFA coverage.");
|
|
169
|
+
}
|
|
170
|
+
const timing = r.exposureWindow === undefined ? undefined : localWindows(frame, r.exposureWindow);
|
|
171
|
+
const parsed = sites.map((site, i) => {
|
|
172
|
+
const s = fields(site, ["charge", "samplingProfile", "capacityProfile", "operatingStateId", "readoutProfile", "regimeId"]);
|
|
173
|
+
const charge = chargeInput(s.charge), p = charge.photoSignal;
|
|
174
|
+
const contributors = resolveCaptureModeColorSamplingContributors({ nativeRaster: native, captureModeProfile: frame.captureModeProfile,
|
|
175
|
+
modeId: frame.modeId, colorSamplingProfile: frame.colorSamplingProfile, bindingProfile: frame.bindingProfile,
|
|
176
|
+
modeSampleIndexFullFrame: { x: i % native.pixelWidth, y: Math.floor(i / native.pixelWidth) } });
|
|
177
|
+
const window = timing?.value.samples[i];
|
|
178
|
+
if (contributors.totalContributorSites !== 1 || contributors.channelComposition.kind !== "single-channel" ||
|
|
179
|
+
p.colorSamplingProfileId !== frame.colorSamplingProfile.profileId || p.channelId !== contributors.channelComposition.channelId ||
|
|
180
|
+
p.site.x !== contributors.colorSamplingSiteRect.x || p.site.y !== contributors.colorSamplingSiteRect.y ||
|
|
181
|
+
p.bindingId !== frame.bindingProfile.bindingId || p.startOffsetSecondsFromOpeningReference !== (window?.startOffsetSecondsFromOpeningReference ?? 0) ||
|
|
182
|
+
p.endOffsetSecondsFromOpeningReference !== (window?.endOffsetSecondsFromOpeningReference ?? capture.exposure.shutterSeconds) ||
|
|
183
|
+
p.localExposureDurationSeconds !== (window?.localExposureDurationSeconds ?? capture.exposure.shutterSeconds)) {
|
|
184
|
+
throw new InvalidConfigurationError("Charge site/channel/binding/local exposure differs from committed capture.");
|
|
185
|
+
}
|
|
186
|
+
return { charge, samplingProfile: parseSensorChargeSamplingProfile(s.samplingProfile), capacityProfile: parseSensorPhysicalChargeCapacityProfile(s.capacityProfile),
|
|
187
|
+
operatingStateId: publicId(s.operatingStateId), readoutProfile: parseSensorReadoutConversionProfile(s.readoutProfile), regimeId: publicId(s.regimeId) };
|
|
188
|
+
});
|
|
189
|
+
for (const s of parsed) {
|
|
190
|
+
publicIdentities(s);
|
|
191
|
+
const readout = resolveSensorReadoutRegime({ profile: s.readoutProfile, regimeId: s.regimeId });
|
|
192
|
+
if (s.readoutProfile.profileId !== parsed[0].readoutProfile.profileId || s.regimeId !== parsed[0].regimeId ||
|
|
193
|
+
readout.regime.adc.bitDepth > 16 || readout.regime.adc.digitalSaturationCode <= readout.regime.adc.blackLevelCode ||
|
|
194
|
+
s.readoutProfile.colorSamplingProfileId !== s.charge.photoSignal.colorSamplingProfileId ||
|
|
195
|
+
s.readoutProfile.channelId !== s.charge.photoSignal.channelId || s.samplingProfile.completenessProfileId !== s.charge.completenessProfile.profileId) {
|
|
196
|
+
throw new InvalidConfigurationError("Frame requires one readout identity/regime and a positive uint16 RAW code span.");
|
|
197
|
+
}
|
|
198
|
+
}
|
|
199
|
+
publicIdentities(frame);
|
|
200
|
+
return { frame, sites: parsed, ...(timing === undefined ? {} : { exposureWindow: {
|
|
201
|
+
shutterMechanism: timing.value.shutterMechanism,
|
|
202
|
+
nominalExposureDurationSeconds: timing.value.nominalExposureDurationSeconds,
|
|
203
|
+
opening: sourceBoundary(timing.value.opening.schedule), closing: sourceBoundary(timing.value.closing.schedule)
|
|
204
|
+
} }) };
|
|
205
|
+
}
|
|
206
|
+
/** Composes existing accumulated-charge → capacity → Poisson → read noise/ADC → native sample → immutable frame contracts. */
|
|
207
|
+
export function simulateSensorRawFrame(input) {
|
|
208
|
+
const v = parseSensorRawProducerInput(input), seed = v.frame.capture.noise.seedUint32;
|
|
209
|
+
const sites = v.sites.map((s, i) => {
|
|
210
|
+
const accumulatedCharge = composeSensorAccumulatedCharge(s.charge);
|
|
211
|
+
const capacity = assessSensorPhysicalChargeCapacity({ accumulatedCharge: accumulatedCharge.value, capacityProfile: s.capacityProfile,
|
|
212
|
+
operatingStateId: s.operatingStateId, operatingTemperatureC: s.charge.darkCharge.operatingTemperatureC });
|
|
213
|
+
const realization = simulateSensorChargeRealization({ accumulatedCharge: accumulatedCharge.value, samplingProfile: s.samplingProfile,
|
|
214
|
+
seedUint32: (seed + 2 * i) >>> 0 });
|
|
215
|
+
const readout = simulateSensorRawCode({ chargeRealization: realization.value, physicalCapacityAssessment: capacity.value,
|
|
216
|
+
readoutProfile: s.readoutProfile, regimeId: s.regimeId, readNoiseSeedUint32: (seed + 2 * i + 1) >>> 0 });
|
|
217
|
+
return { accumulatedCharge, capacity, realization, readout };
|
|
218
|
+
});
|
|
219
|
+
const native = v.frame.capture.geometry.nativeRaster;
|
|
220
|
+
const samples = sites.map((s, i) => createSensorRawCaptureSample({ rawCode: s.readout.value,
|
|
221
|
+
contributors: resolveCaptureModeColorSamplingContributors({ nativeRaster: native, captureModeProfile: v.frame.captureModeProfile,
|
|
222
|
+
modeId: v.frame.modeId, colorSamplingProfile: v.frame.colorSamplingProfile, bindingProfile: v.frame.bindingProfile,
|
|
223
|
+
modeSampleIndexFullFrame: { x: i % native.pixelWidth, y: Math.floor(i / native.pixelWidth) } }) }));
|
|
224
|
+
return approximationResult({ schemaVersion: SENSOR_RAW_PRODUCER_SCHEMA_VERSION, codeProducer: "engine-charge-capacity-noise-adc",
|
|
225
|
+
upstreamOrigin: "declared-eqe-and-dark-exposure-results", upstreamRadiometryVerified: false,
|
|
226
|
+
seedSchedule: "capture-seed-plus-two-native-index-modulo-2-to-32-v1", frame: createSensorRawFrame({ ...v.frame, samples }), sites,
|
|
227
|
+
...(v.exposureWindow === undefined ? {} : { localExposureWindows: localWindows(v.frame, v.exposureWindow) }) }, "native-sensor-raw-frame-producer", SENSOR_RAW_PRODUCER_SCHEMA_VERSION, [
|
|
228
|
+
"Untreated EQE/dark exposure results and completeness evidence are upstream declarations; source radiometry is not independently verified",
|
|
229
|
+
"Native row-major site seeds are capture seed plus 2*index / 2*index+1 modulo 2^32; schedule identity is not an independence proof",
|
|
230
|
+
"Existing scalar capacity/noise/readout approximations retain distinct physical/pre-ADC/digital saturation diagnostics; no blooming",
|
|
231
|
+
"Stationarity applies separately to every exact local window; no time-varying radiance integration, multi-frame acquisition, RGB-to-RAW conversion or production-stage activation",
|
|
232
|
+
"Stored capture float planes remain independent; same-RAW export must use the returned frame's reconstruction handoff"
|
|
233
|
+
]);
|
|
234
|
+
}
|
|
235
|
+
//# sourceMappingURL=sensor-raw-producer.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"sensor-raw-producer.js","sourceRoot":"","sources":["../../src/capture/sensor-raw-producer.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,125 @@
|
|
|
1
|
+
import { type CalculationResult, type ProvenanceKind } from "../core/calculation-result.js";
|
|
2
|
+
import { type ResolvedWhiteBalanceState, type WhiteBalanceChannelGains } from "../color/white-balance.js";
|
|
3
|
+
import { type FocusPlane } from "../optics/focus-state.js";
|
|
4
|
+
import { type ResolveCaptureGeometryInput, type ResolvedCaptureGeometry } from "../output/capture-geometry.js";
|
|
5
|
+
export declare const SIMULATED_CAPTURE_SCHEMA_VERSION: "0.2.0";
|
|
6
|
+
/** Distinct linear domains, not one interchangeable 'linear' flag. */
|
|
7
|
+
export type CaptureLinearImageState = "scene-referred-xyz" | "virtual-sensor-channels" | "color-transformed-linear-rgb";
|
|
8
|
+
export interface CapturePublicProfileReference {
|
|
9
|
+
id: string;
|
|
10
|
+
version: string;
|
|
11
|
+
}
|
|
12
|
+
/** Normalized tristimulus white; Y=1. This is not a spectrum or Kelvin value. */
|
|
13
|
+
export interface CaptureWhiteXyz {
|
|
14
|
+
x: number;
|
|
15
|
+
y: 1;
|
|
16
|
+
z: number;
|
|
17
|
+
}
|
|
18
|
+
/** A resolved #108 choice, sanitized for public metadata. No estimator is rerun. */
|
|
19
|
+
export interface CaptureWhiteBalanceIntent {
|
|
20
|
+
stateId: string;
|
|
21
|
+
source: ResolvedWhiteBalanceState["source"];
|
|
22
|
+
locked: boolean;
|
|
23
|
+
channelGains: WhiteBalanceChannelGains;
|
|
24
|
+
sourceProfile: CapturePublicProfileReference | null;
|
|
25
|
+
}
|
|
26
|
+
/** External bytes are caller-owned; the engine never reads a path or URL. */
|
|
27
|
+
export type CaptureFloatStorage = {
|
|
28
|
+
kind: "inline-float64";
|
|
29
|
+
samples: readonly number[];
|
|
30
|
+
} | {
|
|
31
|
+
kind: "external-float32" | "external-float64";
|
|
32
|
+
byteOrder: "little-endian";
|
|
33
|
+
artifactId: string;
|
|
34
|
+
sha256: string;
|
|
35
|
+
sampleCount: number;
|
|
36
|
+
};
|
|
37
|
+
/** Linear float plane; all channels are co-sited and interleaved in row-major order. */
|
|
38
|
+
export interface CaptureLinearPlane {
|
|
39
|
+
id: string;
|
|
40
|
+
imageStateId: string;
|
|
41
|
+
imageState: CaptureLinearImageState;
|
|
42
|
+
rasterBinding: "oriented-active-capture" | "output";
|
|
43
|
+
pixelWidth: number;
|
|
44
|
+
pixelHeight: number;
|
|
45
|
+
channelIds: readonly string[];
|
|
46
|
+
colorProfile: CapturePublicProfileReference | null;
|
|
47
|
+
/** Defined for colorimetric/RGB encodings; null for unresolved sensor channels. */
|
|
48
|
+
encodingReferenceWhiteXyz: CaptureWhiteXyz | null;
|
|
49
|
+
/** Value normalization, independent of capture saturation or eventual integer white. */
|
|
50
|
+
referenceWhiteValue: number;
|
|
51
|
+
whiteBalanceApplication: "intent-only" | "applied-rgb-gains" | "applied-chromatic-adaptation" | "not-applicable";
|
|
52
|
+
captureSaturation: {
|
|
53
|
+
kind: "not-modeled";
|
|
54
|
+
} | {
|
|
55
|
+
kind: "declared-virtual-white";
|
|
56
|
+
whiteLevel: number;
|
|
57
|
+
upstreamClippedSampleCount: number;
|
|
58
|
+
};
|
|
59
|
+
appliedTransforms: readonly {
|
|
60
|
+
profile: CapturePublicProfileReference;
|
|
61
|
+
kind: "linear-color" | "chromatic-adaptation" | "digital-lens-correction";
|
|
62
|
+
}[];
|
|
63
|
+
storage: CaptureFloatStorage;
|
|
64
|
+
}
|
|
65
|
+
/** Format-neutral input from an upstream master/capture provider, not a preview image. */
|
|
66
|
+
export interface SimulatedCaptureInput {
|
|
67
|
+
captureId: string;
|
|
68
|
+
sceneStateId: string;
|
|
69
|
+
/** Seconds on the declared scene clock, not an embedded wall-clock timestamp. */
|
|
70
|
+
sceneTimeSeconds: number;
|
|
71
|
+
geometry: ResolveCaptureGeometryInput;
|
|
72
|
+
exposure: {
|
|
73
|
+
focalLengthMm: number;
|
|
74
|
+
aperture: number;
|
|
75
|
+
shutterSeconds: number;
|
|
76
|
+
iso: number;
|
|
77
|
+
};
|
|
78
|
+
focus: FocusPlane;
|
|
79
|
+
noise: {
|
|
80
|
+
seedUint32: number;
|
|
81
|
+
realizationId: string;
|
|
82
|
+
model: CapturePublicProfileReference;
|
|
83
|
+
};
|
|
84
|
+
source: {
|
|
85
|
+
kind: "scene-linear-master" | "sensor-derived-linear" | "color-transformed-linear-master";
|
|
86
|
+
artifactId: string;
|
|
87
|
+
sha256: string;
|
|
88
|
+
dynamicRangeHistory: "unknown" | "no-loss-declared" | "upstream-clipped";
|
|
89
|
+
};
|
|
90
|
+
whiteBalanceIntent: CaptureWhiteBalanceIntent | null;
|
|
91
|
+
/** Adopted/WB white is a camera choice, not automatically the encoding white. */
|
|
92
|
+
adoptedWhiteXyz: CaptureWhiteXyz | null;
|
|
93
|
+
models: readonly {
|
|
94
|
+
profile: CapturePublicProfileReference;
|
|
95
|
+
scientificStatus: ProvenanceKind;
|
|
96
|
+
publicEvidenceIds: readonly string[];
|
|
97
|
+
}[];
|
|
98
|
+
planes: readonly CaptureLinearPlane[];
|
|
99
|
+
}
|
|
100
|
+
/** Immutable committed value. Geometry/focal equivalence are derived, never caller overrides. */
|
|
101
|
+
export interface SimulatedCapture extends SimulatedCaptureInput {
|
|
102
|
+
schemaVersion: typeof SIMULATED_CAPTURE_SCHEMA_VERSION;
|
|
103
|
+
engineApiVersion: string;
|
|
104
|
+
resolvedGeometry: ResolvedCaptureGeometry;
|
|
105
|
+
equivalentFocalLength35Mm: number;
|
|
106
|
+
}
|
|
107
|
+
/** Converts validated shooting WB into a public metadata allowlist, discarding private extras. */
|
|
108
|
+
export declare function createCaptureWhiteBalanceIntent(input: {
|
|
109
|
+
state: ResolvedWhiteBalanceState;
|
|
110
|
+
}): CaptureWhiteBalanceIntent;
|
|
111
|
+
/** Commits a format-neutral float master manifest; no radiance generation, clamp, WB or export encoding. */
|
|
112
|
+
export declare function createSimulatedCapture(input: SimulatedCaptureInput): CalculationResult<SimulatedCapture>;
|
|
113
|
+
/** Parses an archived capture, recomputing and checking all derived geometry/focal metadata. */
|
|
114
|
+
export declare function parseSimulatedCapture(value: unknown): SimulatedCapture;
|
|
115
|
+
/** Canonical allowlisted JSON, including semantic samples/IDs, not private caches or file layout. */
|
|
116
|
+
export declare function serializeSimulatedCapture(input: {
|
|
117
|
+
capture: SimulatedCapture;
|
|
118
|
+
}): string;
|
|
119
|
+
/** Requires an exact plane image state; callers may not substitute another kind of 'linear'. */
|
|
120
|
+
export declare function resolveSimulatedCapturePlane(input: {
|
|
121
|
+
capture: SimulatedCapture;
|
|
122
|
+
planeId: string;
|
|
123
|
+
requiredImageState: CaptureLinearImageState;
|
|
124
|
+
}): CaptureLinearPlane;
|
|
125
|
+
//# sourceMappingURL=simulated-capture.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"simulated-capture.d.ts","sourceRoot":"","sources":["../../src/capture/simulated-capture.ts"],"names":[],"mappings":"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"}
|