@photivra/engine 2.18.0 → 2.19.0

package/dist/exposure/program-line.js.map

@@ -1 +1 @@
-{"version":3,"file":"program-line.js","sourceRoot":"","sources":["../../src/exposure/program-line.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Generic exposure program lines, for teaching and for products. A program line is the curve of\n * aperture/shutter pairs a camera's Program mode follows.\n *\n * A program line is control policy, not physics. Each node declares a wanted aperture/shutter pair at\n * an explicit number of stops of optical exposure, relative to the resolver's reference exposure.\n * The resolver later checks that every node is physically consistent with that reference and with\n * what the equipment can do.\n * @see docs/USAGE.md for the equations, units, coordinate conventions, known blockers and support\n * limits.\n */\n\nimport { rejectUnknownFields } from \"../core/record-validation.js\";\nimport { InvalidConfigurationError } from \"../core/configuration-error.js\";\nimport {\n  parseEvidenceList,\n  type EvidenceProvenance\n} from \"../core/evidence-provenance.js\";\n\ntype UnknownRecord = Record<string, unknown>;\n\nexport const EXPOSURE_PROGRAM_LINE_SCHEMA_VERSION =\n  \"0.1.0\" as const;\n\nexport interface ExposureProgramLineNode {\n  nodeId: string;\n  opticalExposureStopsFromReference: number;\n  aperture: number;\n  shutterSeconds: number;\n}\n\nexport interface ExposureProgramLineProfile {\n  schemaVersion:\n    typeof EXPOSURE_PROGRAM_LINE_SCHEMA_VERSION;\n  profileId: string;\n  profileVersion: string;\n  scientificStatus: \"approximation\";\n  policyKind:\n    \"generic-program-line\";\n  interpolation:\n    \"log2-aperture-shutter\";\n  evidence: readonly EvidenceProvenance[];\n  limitations: readonly string[];\n  nodes:\n    readonly ExposureProgramLineNode[];\n}\n\nfunction requireRecord(\n  value: unknown,\n  path: string,\n  allowedKeys: readonly string[] | null\n): UnknownRecord {\n  if (\n    typeof value !== \"object\" ||\n    value === null ||\n    Array.isArray(value)\n  ) {\n    throw new InvalidConfigurationError(\n      path + \" must be an object.\"\n    );\n  }\n  if (allowedKeys !== null) rejectUnknownFields(value, allowedKeys, path);\n  return value as UnknownRecord;\n}\n\nfunction requireNonEmptyString(\n  value: unknown,\n  path: string\n): string {\n  if (\n    typeof value !== \"string\" ||\n    value.trim().length === 0\n  ) {\n    throw new InvalidConfigurationError(\n      path + \" must be a non-empty string.\"\n    );\n  }\n  return value.trim();\n}\n\nfunction requireFinite(\n  value: unknown,\n  path: string\n): number {\n  if (\n    typeof value !== \"number\" ||\n    !Number.isFinite(value)\n  ) {\n    throw new InvalidConfigurationError(\n      path + \" must be finite.\"\n    );\n  }\n  return value;\n}\n\nfunction requirePositiveFinite(\n  value: unknown,\n  path: string\n): number {\n  const parsed =\n    requireFinite(value, path);\n  if (parsed <= 0) {\n    throw new InvalidConfigurationError(\n      path +\n        \" must be greater than zero.\"\n    );\n  }\n  return parsed;\n}\n\nfunction parseLimitations(\n  value: unknown,\n  path: string\n): readonly string[] {\n  if (!Array.isArray(value)) {\n    throw new InvalidConfigurationError(\n      path + \" must be an array.\"\n    );\n  }\n  const parsed = value.map(\n    (entry, index) =>\n      requireNonEmptyString(\n        entry,\n        path + \"[\" + index + \"]\"\n      )\n  );\n  if (\n    new Set(parsed).size !==\n    parsed.length\n  ) {\n    throw new InvalidConfigurationError(\n      path +\n        \" must not contain duplicates.\"\n    );\n  }\n  return parsed;\n}\n\n/**\n * Parses a generic educational/product exposure program line.\n *\n * A program line is control policy, not physics. Each node declares a wanted\n * aperture/shutter pair at an explicit number of stops of optical exposure,\n * relative to the resolver's reference exposure. The resolver later checks\n * that every node is physically consistent with that reference and with what\n * the equipment can do.\n */\nexport function parseExposureProgramLineProfile(\n  value: unknown\n): ExposureProgramLineProfile {\n  const record = requireRecord(\n    value,\n    \"exposureProgramLineProfile\", [\"schemaVersion\", \"scientificStatus\", \"policyKind\", \"interpolation\", \"nodes\", \"profileId\", \"profileVersion\", \"evidence\", \"limitations\"]\n  );\n\n  if (\n    record.schemaVersion !==\n    EXPOSURE_PROGRAM_LINE_SCHEMA_VERSION\n  ) {\n    throw new InvalidConfigurationError(\n      'exposureProgramLineProfile.schemaVersion must be \"' +\n        EXPOSURE_PROGRAM_LINE_SCHEMA_VERSION +\n        '\".'\n    );\n  }\n  if (\n    record.scientificStatus !==\n    \"approximation\"\n  ) {\n    throw new InvalidConfigurationError(\n      'exposureProgramLineProfile.scientificStatus must be \"approximation\".'\n    );\n  }\n  if (\n    record.policyKind !==\n    \"generic-program-line\"\n  ) {\n    throw new InvalidConfigurationError(\n      'exposureProgramLineProfile.policyKind must be \"generic-program-line\".'\n    );\n  }\n  if (\n    record.interpolation !==\n    \"log2-aperture-shutter\"\n  ) {\n    throw new InvalidConfigurationError(\n      'exposureProgramLineProfile.interpolation must be \"log2-aperture-shutter\".'\n    );\n  }\n  if (\n    !Array.isArray(record.nodes) ||\n    record.nodes.length < 2\n  ) {\n    throw new InvalidConfigurationError(\n      \"exposureProgramLineProfile.nodes must contain at least two nodes.\"\n    );\n  }\n\n  let previousStops =\n    Number.NEGATIVE_INFINITY;\n  const ids: string[] = [];\n\n  const nodes = record.nodes.map(\n    (entry, index) => {\n      const path =\n        \"exposureProgramLineProfile.nodes[\" +\n        index +\n        \"]\";\n      const node =\n        requireRecord(entry, path, [\"nodeId\", \"opticalExposureStopsFromReference\", \"aperture\", \"shutterSeconds\"]);\n      const nodeId =\n        requireNonEmptyString(\n          node.nodeId,\n          path + \".nodeId\"\n        );\n      const stops =\n        requireFinite(\n          node\n            .opticalExposureStopsFromReference,\n          path +\n            \".opticalExposureStopsFromReference\"\n        );\n      if (stops <= previousStops) {\n        throw new InvalidConfigurationError(\n          \"exposureProgramLineProfile.nodes opticalExposureStopsFromReference must be strictly increasing.\"\n        );\n      }\n      previousStops = stops;\n      ids.push(nodeId);\n\n      return {\n        nodeId,\n        opticalExposureStopsFromReference:\n          stops,\n        aperture:\n          requirePositiveFinite(\n            node.aperture,\n            path + \".aperture\"\n          ),\n        shutterSeconds:\n          requirePositiveFinite(\n            node.shutterSeconds,\n            path +\n              \".shutterSeconds\"\n          )\n      };\n    }\n  );\n\n  if (\n    new Set(ids).size !== ids.length\n  ) {\n    throw new InvalidConfigurationError(\n      \"exposureProgramLineProfile.nodes[].nodeId must not contain duplicates.\"\n    );\n  }\n\n  return {\n    schemaVersion:\n      EXPOSURE_PROGRAM_LINE_SCHEMA_VERSION,\n    profileId:\n      requireNonEmptyString(\n        record.profileId,\n        \"exposureProgramLineProfile.profileId\"\n      ),\n    profileVersion:\n      requireNonEmptyString(\n        record.profileVersion,\n        \"exposureProgramLineProfile.profileVersion\"\n      ),\n    scientificStatus:\n      \"approximation\",\n    policyKind:\n      \"generic-program-line\",\n    interpolation:\n      \"log2-aperture-shutter\",\n    evidence: parseEvidenceList(\n      record.evidence,\n      \"exposureProgramLineProfile.evidence\"\n    ),\n    limitations:\n      parseLimitations(\n        record.limitations,\n        \"exposureProgramLineProfile.limitations\"\n      ),\n    nodes\n  };\n}\n"]}
+{"version":3,"file":"program-line.js","sourceRoot":"","sources":["../../src/exposure/program-line.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Generic exposure program lines, for teaching and for products. A program line is the curve of\n * aperture/shutter pairs a camera's Program mode follows.\n *\n * A program line is control policy, not physics. Each node declares a wanted aperture/shutter pair at\n * an explicit number of stops of optical exposure, relative to the resolver's reference exposure.\n * The resolver later checks that every node is physically consistent with that reference and with\n * what the equipment can do.\n * @see docs/USAGE.md for the equations, units, coordinate conventions, known blockers and support\n * limits.\n */\n\nimport { InvalidConfigurationError } from \"../core/configuration-error.js\";\nimport {\n  parseEvidenceList,\n  type EvidenceProvenance\n} from \"../core/evidence-provenance.js\";\nimport { requireConfigRecord as requireRecord, requireTrimmedConfigString as requireNonEmptyString, requireConfigFinite as requireFinite, parseConfigLimitations as parseLimitations, requireConfigFiniteAboveZero as requirePositiveFinite } from \"../core/record-validation.js\";\n\nexport const EXPOSURE_PROGRAM_LINE_SCHEMA_VERSION =\n  \"0.1.0\" as const;\n\nexport interface ExposureProgramLineNode {\n  nodeId: string;\n  opticalExposureStopsFromReference: number;\n  aperture: number;\n  shutterSeconds: number;\n}\n\nexport interface ExposureProgramLineProfile {\n  schemaVersion:\n    typeof EXPOSURE_PROGRAM_LINE_SCHEMA_VERSION;\n  profileId: string;\n  profileVersion: string;\n  scientificStatus: \"approximation\";\n  policyKind:\n    \"generic-program-line\";\n  interpolation:\n    \"log2-aperture-shutter\";\n  evidence: readonly EvidenceProvenance[];\n  limitations: readonly string[];\n  nodes:\n    readonly ExposureProgramLineNode[];\n}\n\n/**\n * Parses a generic educational/product exposure program line.\n *\n * A program line is control policy, not physics. Each node declares a wanted\n * aperture/shutter pair at an explicit number of stops of optical exposure,\n * relative to the resolver's reference exposure. The resolver later checks\n * that every node is physically consistent with that reference and with what\n * the equipment can do.\n */\nexport function parseExposureProgramLineProfile(\n  value: unknown\n): ExposureProgramLineProfile {\n  const record = requireRecord(\n    value,\n    \"exposureProgramLineProfile\", [\"schemaVersion\", \"scientificStatus\", \"policyKind\", \"interpolation\", \"nodes\", \"profileId\", \"profileVersion\", \"evidence\", \"limitations\"]\n  );\n\n  if (\n    record.schemaVersion !==\n    EXPOSURE_PROGRAM_LINE_SCHEMA_VERSION\n  ) {\n    throw new InvalidConfigurationError(\n      'exposureProgramLineProfile.schemaVersion must be \"' +\n        EXPOSURE_PROGRAM_LINE_SCHEMA_VERSION +\n        '\".'\n    );\n  }\n  if (\n    record.scientificStatus !==\n    \"approximation\"\n  ) {\n    throw new InvalidConfigurationError(\n      'exposureProgramLineProfile.scientificStatus must be \"approximation\".'\n    );\n  }\n  if (\n    record.policyKind !==\n    \"generic-program-line\"\n  ) {\n    throw new InvalidConfigurationError(\n      'exposureProgramLineProfile.policyKind must be \"generic-program-line\".'\n    );\n  }\n  if (\n    record.interpolation !==\n    \"log2-aperture-shutter\"\n  ) {\n    throw new InvalidConfigurationError(\n      'exposureProgramLineProfile.interpolation must be \"log2-aperture-shutter\".'\n    );\n  }\n  if (\n    !Array.isArray(record.nodes) ||\n    record.nodes.length < 2\n  ) {\n    throw new InvalidConfigurationError(\n      \"exposureProgramLineProfile.nodes must contain at least two nodes.\"\n    );\n  }\n\n  let previousStops =\n    Number.NEGATIVE_INFINITY;\n  const ids: string[] = [];\n\n  const nodes = record.nodes.map(\n    (entry, index) => {\n      const path =\n        \"exposureProgramLineProfile.nodes[\" +\n        index +\n        \"]\";\n      const node =\n        requireRecord(entry, path, [\"nodeId\", \"opticalExposureStopsFromReference\", \"aperture\", \"shutterSeconds\"]);\n      const nodeId =\n        requireNonEmptyString(\n          node.nodeId,\n          path + \".nodeId\"\n        );\n      const stops =\n        requireFinite(\n          node\n            .opticalExposureStopsFromReference,\n          path +\n            \".opticalExposureStopsFromReference\"\n        );\n      if (stops <= previousStops) {\n        throw new InvalidConfigurationError(\n          \"exposureProgramLineProfile.nodes opticalExposureStopsFromReference must be strictly increasing.\"\n        );\n      }\n      previousStops = stops;\n      ids.push(nodeId);\n\n      return {\n        nodeId,\n        opticalExposureStopsFromReference:\n          stops,\n        aperture:\n          requirePositiveFinite(\n            node.aperture,\n            path + \".aperture\"\n          ),\n        shutterSeconds:\n          requirePositiveFinite(\n            node.shutterSeconds,\n            path +\n              \".shutterSeconds\"\n          )\n      };\n    }\n  );\n\n  if (\n    new Set(ids).size !== ids.length\n  ) {\n    throw new InvalidConfigurationError(\n      \"exposureProgramLineProfile.nodes[].nodeId must not contain duplicates.\"\n    );\n  }\n\n  return {\n    schemaVersion:\n      EXPOSURE_PROGRAM_LINE_SCHEMA_VERSION,\n    profileId:\n      requireNonEmptyString(\n        record.profileId,\n        \"exposureProgramLineProfile.profileId\"\n      ),\n    profileVersion:\n      requireNonEmptyString(\n        record.profileVersion,\n        \"exposureProgramLineProfile.profileVersion\"\n      ),\n    scientificStatus:\n      \"approximation\",\n    policyKind:\n      \"generic-program-line\",\n    interpolation:\n      \"log2-aperture-shutter\",\n    evidence: parseEvidenceList(\n      record.evidence,\n      \"exposureProgramLineProfile.evidence\"\n    ),\n    limitations:\n      parseLimitations(\n        record.limitations,\n        \"exposureProgramLineProfile.limitations\"\n      ),\n    nodes\n  };\n}\n"]}

package/dist/facade/develop-joined-parts.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Develop joined parts (#571): the whole-image development steps of a capture whose RAW was rendered in parts.
+ * @see docs/QUICK_START.md, "Developing a capture rendered in parts".
+ */
+import { type SimulateCaptureDngPart, type SimulateCaptureOptions, type SimulateCaptureResult } from "./simulate-capture.js";
+/**
+ * Develops the whole frame of `options` from the packed RAW of region renders of the same request (#571), so a capture can
+ * render its RAW in parallel parts and still take the development steps that filter across the whole image:
+ * `output.diffractionCorrection` and `output.sharpening`, which a region render refuses, and `output.lensCorrections` (#570), which
+ * runs on the whole developed frame here exactly as in `simulateCapture(options)`. The parts are joined exactly as
+ * {@link serializeSimulatedCaptureDngFromParts} joins them (they must cover every native site and agree where they overlap),
+ * and the joined RAW is the whole render's RAW, so the result's `image` (samples and JPEG or PNG bytes), `raw` codes and
+ * `plan` are those of `simulateCapture(options)`, bit for bit.
+ *
+ * `options` is the whole request (no `output.region`), with the development options it should have; render the parts with
+ * the same request plus `output.region`, without `output.diffractionCorrection`, `output.sharpening` and `output.dng`, and with a
+ * fixed white balance in place of `"auto"` (none of these change the RAW codes; auto white balance is measured here over the
+ * joined frame). A part may keep or drop `output.lensCorrections` (a corrected region only widens its `region.nativeRect`).
+ * Any `output.format` serves for a part.
+ *
+ * `onProgress` reports the `white-balance` (with auto white balance), `development`, `diffraction-correction`, `sharpening` and
+ * `jpeg` stages, the detail stages once per output row, so a host can show "Applying sharpening to the whole image". The lens
+ * corrections report no stage of their own: they run between `diffraction-correction` and `sharpening`.
+ * No `raw` stage is reported: no RAW is rendered. What differs from the whole render's result: `diagnostics.providerEvaluationCount`
+ * is 0, `diagnostics.timingsMs` are this call's, `diagnostics.fast` and the `raw.*` assumptions of how the RAW was rendered are
+ * not repeated (they are in the parts' results), and a `parts` assumption records the join.
+ * @returns The capture result of `options`, developed from the joined RAW.
+ */
+export declare function simulateCaptureFromParts(options: SimulateCaptureOptions, parts: readonly SimulateCaptureDngPart[]): Promise<SimulateCaptureResult>;

package/dist/facade/develop-joined-parts.js

@@ -0,0 +1,33 @@
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Develop joined parts (#571): the whole-image development steps of a capture whose RAW was rendered in parts.
+ * @see docs/QUICK_START.md, "Developing a capture rendered in parts".
+ */
+import { runCapture } from "./simulate-capture.js";
+/**
+ * Develops the whole frame of `options` from the packed RAW of region renders of the same request (#571), so a capture can
+ * render its RAW in parallel parts and still take the development steps that filter across the whole image:
+ * `output.diffractionCorrection` and `output.sharpening`, which a region render refuses, and `output.lensCorrections` (#570), which
+ * runs on the whole developed frame here exactly as in `simulateCapture(options)`. The parts are joined exactly as
+ * {@link serializeSimulatedCaptureDngFromParts} joins them (they must cover every native site and agree where they overlap),
+ * and the joined RAW is the whole render's RAW, so the result's `image` (samples and JPEG or PNG bytes), `raw` codes and
+ * `plan` are those of `simulateCapture(options)`, bit for bit.
+ *
+ * `options` is the whole request (no `output.region`), with the development options it should have; render the parts with
+ * the same request plus `output.region`, without `output.diffractionCorrection`, `output.sharpening` and `output.dng`, and with a
+ * fixed white balance in place of `"auto"` (none of these change the RAW codes; auto white balance is measured here over the
+ * joined frame). A part may keep or drop `output.lensCorrections` (a corrected region only widens its `region.nativeRect`).
+ * Any `output.format` serves for a part.
+ *
+ * `onProgress` reports the `white-balance` (with auto white balance), `development`, `diffraction-correction`, `sharpening` and
+ * `jpeg` stages, the detail stages once per output row, so a host can show "Applying sharpening to the whole image". The lens
+ * corrections report no stage of their own: they run between `diffraction-correction` and `sharpening`.
+ * No `raw` stage is reported: no RAW is rendered. What differs from the whole render's result: `diagnostics.providerEvaluationCount`
+ * is 0, `diagnostics.timingsMs` are this call's, `diagnostics.fast` and the `raw.*` assumptions of how the RAW was rendered are
+ * not repeated (they are in the parts' results), and a `parts` assumption records the join.
+ * @returns The capture result of `options`, developed from the joined RAW.
+ */
+export async function simulateCaptureFromParts(options, parts) {
+    return await runCapture(options, "develop-from-parts", parts);
+}
+//# sourceMappingURL=develop-joined-parts.js.map

package/dist/facade/develop-joined-parts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"develop-joined-parts.js","sourceRoot":"","sources":["../../src/facade/develop-joined-parts.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAwF,MAAM,uBAAuB,CAAC;AAEzI;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,OAA+B,EAAE,KAAwC;IACtH,OAAO,MAAM,UAAU,CAAC,OAAO,EAAE,oBAAoB,EAAE,KAAK,CAA0B,CAAC;AACzF,CAAC","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * Develop joined parts (#571): the whole-image development steps of a capture whose RAW was rendered in parts.\n * @see docs/QUICK_START.md, \"Developing a capture rendered in parts\".\n */\n\nimport { runCapture, type SimulateCaptureDngPart, type SimulateCaptureOptions, type SimulateCaptureResult } from \"./simulate-capture.js\";\n\n/**\n * Develops the whole frame of `options` from the packed RAW of region renders of the same request (#571), so a capture can\n * render its RAW in parallel parts and still take the development steps that filter across the whole image:\n * `output.diffractionCorrection` and `output.sharpening`, which a region render refuses, and `output.lensCorrections` (#570), which\n * runs on the whole developed frame here exactly as in `simulateCapture(options)`. The parts are joined exactly as\n * {@link serializeSimulatedCaptureDngFromParts} joins them (they must cover every native site and agree where they overlap),\n * and the joined RAW is the whole render's RAW, so the result's `image` (samples and JPEG or PNG bytes), `raw` codes and\n * `plan` are those of `simulateCapture(options)`, bit for bit.\n *\n * `options` is the whole request (no `output.region`), with the development options it should have; render the parts with\n * the same request plus `output.region`, without `output.diffractionCorrection`, `output.sharpening` and `output.dng`, and with a\n * fixed white balance in place of `\"auto\"` (none of these change the RAW codes; auto white balance is measured here over the\n * joined frame). A part may keep or drop `output.lensCorrections` (a corrected region only widens its `region.nativeRect`).\n * Any `output.format` serves for a part.\n *\n * `onProgress` reports the `white-balance` (with auto white balance), `development`, `diffraction-correction`, `sharpening` and\n * `jpeg` stages, the detail stages once per output row, so a host can show \"Applying sharpening to the whole image\". The lens\n * corrections report no stage of their own: they run between `diffraction-correction` and `sharpening`.\n * No `raw` stage is reported: no RAW is rendered. What differs from the whole render's result: `diagnostics.providerEvaluationCount`\n * is 0, `diagnostics.timingsMs` are this call's, `diagnostics.fast` and the `raw.*` assumptions of how the RAW was rendered are\n * not repeated (they are in the parts' results), and a `parts` assumption records the join.\n * @returns The capture result of `options`, developed from the joined RAW.\n */\nexport async function simulateCaptureFromParts(options: SimulateCaptureOptions, parts: readonly SimulateCaptureDngPart[]): Promise<SimulateCaptureResult> {\n  return await runCapture(options, \"develop-from-parts\", parts) as SimulateCaptureResult;\n}\n"]}

package/dist/facade/generic-lens-capture.d.ts

@@ -1,7 +1,9 @@
 /**
  * What `simulateCapture` needs for `lens.catalogue` (#549), loaded on demand: a capture without a catalogue lens (and a bundle
- * that never asks for one) does not load the catalogue's data or its PSF builder.
+ * that never asks for one) does not load the catalogue's data or its PSF builder. It also holds the developed-image lens
+ * corrections (`output.lensCorrections`, #570), which need a catalogue lens.
  */
-export { GENERIC_LENS_EVIDENCE, genericLensDistortionProfile, genericLensVignettingProfile, resolveGenericLens, simulateGenericLensFocusError } from "../equipment/generic-lens-catalogue.js";
+export { GENERIC_LENS_EVIDENCE, genericLensDispersion, genericLensDistortionProfile, genericLensVignettingProfile, resolveGenericLens, simulateGenericLensFocusError } from "../equipment/generic-lens-catalogue.js";
 export { createGenericLensPsfProfile, genericLensPsfKernelRadius, GENERIC_LENS_PSF_MAXIMUM_COMBINED_RADIUS_SITES } from "../optics/generic-lens-psf.js";
 export { CATALOGUE_FAST_VERIFICATION_TOLERANCE, catalogueFastAssumptions, createCatalogueLensSignal } from "./catalogue-lens-signal.js";
+export { applyDevelopedLensCorrection, developedLensCorrectionSourceRect, prepareDevelopedLensCorrection } from "../output/developed-lens-corrections.js";

package/dist/facade/generic-lens-capture.js

@@ -1,9 +1,11 @@
 // SPDX-License-Identifier: Apache-2.0
 /**
  * What `simulateCapture` needs for `lens.catalogue` (#549), loaded on demand: a capture without a catalogue lens (and a bundle
- * that never asks for one) does not load the catalogue's data or its PSF builder.
+ * that never asks for one) does not load the catalogue's data or its PSF builder. It also holds the developed-image lens
+ * corrections (`output.lensCorrections`, #570), which need a catalogue lens.
  */
-export { GENERIC_LENS_EVIDENCE, genericLensDistortionProfile, genericLensVignettingProfile, resolveGenericLens, simulateGenericLensFocusError } from "../equipment/generic-lens-catalogue.js";
+export { GENERIC_LENS_EVIDENCE, genericLensDispersion, genericLensDistortionProfile, genericLensVignettingProfile, resolveGenericLens, simulateGenericLensFocusError } from "../equipment/generic-lens-catalogue.js";
 export { createGenericLensPsfProfile, genericLensPsfKernelRadius, GENERIC_LENS_PSF_MAXIMUM_COMBINED_RADIUS_SITES } from "../optics/generic-lens-psf.js";
 export { CATALOGUE_FAST_VERIFICATION_TOLERANCE, catalogueFastAssumptions, createCatalogueLensSignal } from "./catalogue-lens-signal.js";
+export { applyDevelopedLensCorrection, developedLensCorrectionSourceRect, prepareDevelopedLensCorrection } from "../output/developed-lens-corrections.js";
 //# sourceMappingURL=generic-lens-capture.js.map

package/dist/facade/generic-lens-capture.js.map

@@ -1 +1 @@
-{"version":3,"file":"generic-lens-capture.js","sourceRoot":"","sources":["../../src/facade/generic-lens-capture.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC;;;GAGG;AACH,OAAO,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,4BAA4B,EAAE,kBAAkB,EAAE,6BAA6B,EAAE,MAAM,wCAAwC,CAAC;AAC9L,OAAO,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,8CAA8C,EAAE,MAAM,+BAA+B,CAAC;AACxJ,OAAO,EAAE,qCAAqC,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * What `simulateCapture` needs for `lens.catalogue` (#549), loaded on demand: a capture without a catalogue lens (and a bundle\n * that never asks for one) does not load the catalogue's data or its PSF builder.\n */\nexport { GENERIC_LENS_EVIDENCE, genericLensDistortionProfile, genericLensVignettingProfile, resolveGenericLens, simulateGenericLensFocusError } from \"../equipment/generic-lens-catalogue.js\";\nexport { createGenericLensPsfProfile, genericLensPsfKernelRadius, GENERIC_LENS_PSF_MAXIMUM_COMBINED_RADIUS_SITES } from \"../optics/generic-lens-psf.js\";\nexport { CATALOGUE_FAST_VERIFICATION_TOLERANCE, catalogueFastAssumptions, createCatalogueLensSignal } from \"./catalogue-lens-signal.js\";\n"]}
+{"version":3,"file":"generic-lens-capture.js","sourceRoot":"","sources":["../../src/facade/generic-lens-capture.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC;;;;GAIG;AACH,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,4BAA4B,EAAE,4BAA4B,EAAE,kBAAkB,EAAE,6BAA6B,EAAE,MAAM,wCAAwC,CAAC;AACrN,OAAO,EAAE,2BAA2B,EAAE,0BAA0B,EAAE,8CAA8C,EAAE,MAAM,+BAA+B,CAAC;AACxJ,OAAO,EAAE,qCAAqC,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AACxI,OAAO,EAAE,4BAA4B,EAAE,iCAAiC,EAAE,8BAA8B,EAAE,MAAM,yCAAyC,CAAC","sourcesContent":["// SPDX-License-Identifier: Apache-2.0\n\n/**\n * What `simulateCapture` needs for `lens.catalogue` (#549), loaded on demand: a capture without a catalogue lens (and a bundle\n * that never asks for one) does not load the catalogue's data or its PSF builder. It also holds the developed-image lens\n * corrections (`output.lensCorrections`, #570), which need a catalogue lens.\n */\nexport { GENERIC_LENS_EVIDENCE, genericLensDispersion, genericLensDistortionProfile, genericLensVignettingProfile, resolveGenericLens, simulateGenericLensFocusError } from \"../equipment/generic-lens-catalogue.js\";\nexport { createGenericLensPsfProfile, genericLensPsfKernelRadius, GENERIC_LENS_PSF_MAXIMUM_COMBINED_RADIUS_SITES } from \"../optics/generic-lens-psf.js\";\nexport { CATALOGUE_FAST_VERIFICATION_TOLERANCE, catalogueFastAssumptions, createCatalogueLensSignal } from \"./catalogue-lens-signal.js\";\nexport { applyDevelopedLensCorrection, developedLensCorrectionSourceRect, prepareDevelopedLensCorrection } from \"../output/developed-lens-corrections.js\";\n"]}

package/dist/facade/simulate-capture.d.ts

@@ -253,6 +253,18 @@ export interface SimulateCaptureDiffractionCorrection {
     /** FIR radius R in pixels, 1–16. Default: the Airy pattern's third dark ring at the design wavelength, within 1–16. */
     kernelRadiusPixels?: number;
 }
+/**
+ * `output.lensCorrections` (#570): which of the catalogue lens's generic corrections (`createGenericLensCorrectionProfile`) the
+ * development applies. Each is off unless set to true.
+ */
+export interface SimulateCaptureLensCorrections {
+    /** Radial distortion r_d = r(1 + k1ρ²), inverted by resampling: it stretches the corners and lowers their resolution. */
+    distortion?: boolean;
+    /** Lateral colour: each channel rescaled by 1/(1 + L·D(λ_c)) into register; axial (longitudinal) colour stays. */
+    lateralColor?: boolean;
+    /** Vignetting: a gain 1/E(ρ) at each pixel's source point; corner noise rises with the signal, the SNR does not. */
+    vignetting?: boolean;
+}
 /** `diagnostics.detail` (#552): what the development detail stages did. Present only when one ran. */
 export interface SimulateCaptureDetailDiagnostics {
     diffractionCorrection?: {
@@ -314,7 +326,8 @@ export interface SimulateCaptureOptions {
          * distance beyond the focal length (no minimum focus distance; `subjectDistanceM` must be at least twice the focal length, as for
          * every lens). Works in `simulateCapture` and the display view. Not combinable with `prime`, `catalogue` or `focalLengthMm`.
          * Optional `widestFNumber` and `narrowestFNumber` (within `IDEAL_LENS_LIMITS`, widest ≤ narrowest; each defaults to its bound)
-         * narrow the range: `fNumber` must lie in it, and shutter priority and program choose apertures only in it. Default off.
+         * narrow the range: `fNumber` must lie in it, and shutter priority and program choose apertures only in it (program limits its
+         * line to a range that does not hold f/4–f/16, #583). Default off.
          */
         ideal?: {
             focalLengthMm: number;
@@ -547,6 +560,16 @@ export interface SimulateCaptureOptions {
          * (not the wide-gamut or perceptual PNG paths); not combinable with `region`. The DNG's RAW codes are not changed. Default off.
          */
         sharpening?: SimulateCaptureSharpening;
+        /**
+         * Opt-in (#570), with `lens.catalogue`: the lens's generic corrections (see {@link SimulateCaptureLensCorrections}) on the
+         * developed linear colour, after demosaic, colour, white balance and `diffractionCorrection`, before the tone curve; for the JPEG,
+         * PNG and samples. The RAW and the DNG are never corrected. To keep the output size with no missing pixels, the corrected image is
+         * magnified by the smallest factor 1/m ≥ 1 that keeps every pixel's source inside the frame (recorded in the
+         * `output.lensCorrections` assumption). Works with `region`: a region develops the frame pixels its corrected pixels read
+         * (`region.nativeRect`, `raw` and `plan` describe that rectangle) and its pixels are the whole render's. All off (or omitted):
+         * the development is unchanged.
+         */
+        lensCorrections?: SimulateCaptureLensCorrections;
     };
     /** Camera motion and shutter type. Default: still camera, global electronic shutter. */
     motion?: SimulateCaptureMotion;
@@ -585,14 +608,14 @@ export interface SimulateCaptureOptions {
     fast?: boolean;
     /** Aborting cancels the running task; the promise rejects with a domain error and returns no partial image. */
     signal?: AbortSignal;
-    /** Called after each committed RAW, development or JPEG tile. Cannot change output. */
+    /** Called after each committed RAW, development, detail or JPEG tile (see {@link SimulateCaptureProgress}). Cannot change output. */
     onProgress?: (progress: SimulateCaptureProgress) => void;
 }
 /**
  * Options reported in `diagnostics.options` (2.1), in this order, when they ran: the ones that change how much work
  * a capture does. `motion.rotation` is a non-zero angular velocity; `sensor.temporalSampleCount` a count above 1.
  */
-export declare const SIMULATE_CAPTURE_COST_OPTIONS: readonly ["lens.pupilSampling", "lens.projection", "lens.distortion", "lens.vignetting", "lens.psf", "lens.diffraction", "lens.defocus", "lens.catalogue", "sensor.antiAliasing", "sensor.pixelAperture.box", "sensor.temporalSampleCount", "motion.rotation", "motion.shutter.rolling", "output.borderHandling.mirror", "output.region", "output.whiteBalance.auto", "output.demosaic.ahd", "output.highlightMode.reconstruct", "output.colorEncoding.wide-gamut", "output.gamutMapping.perceptual", "output.diffractionCorrection", "output.sharpening", "output.format.jpeg", "output.format.png", "output.format.dng"];
+export declare const SIMULATE_CAPTURE_COST_OPTIONS: readonly ["lens.pupilSampling", "lens.projection", "lens.distortion", "lens.vignetting", "lens.psf", "lens.diffraction", "lens.defocus", "lens.catalogue", "sensor.antiAliasing", "sensor.pixelAperture.box", "sensor.temporalSampleCount", "motion.rotation", "motion.shutter.rolling", "output.borderHandling.mirror", "output.region", "output.whiteBalance.auto", "output.demosaic.ahd", "output.highlightMode.reconstruct", "output.colorEncoding.wide-gamut", "output.gamutMapping.perceptual", "output.diffractionCorrection", "output.sharpening", "output.lensCorrections", "output.format.jpeg", "output.format.png", "output.format.dng"];
 export type SimulateCaptureCostOption = typeof SIMULATE_CAPTURE_COST_OPTIONS[number];
 /**
  * The options that take the exact-or-fast flag (#395), in the path style of {@link SIMULATE_CAPTURE_COST_OPTIONS}: each accepts
@@ -610,8 +633,15 @@ export interface SimulateCaptureFastReport {
     /** `engine-reference` when every option ran exact; `approximation-with-a-priori-bound` when any fast method ran (the WebGPU execution record's values). */
     assurance: "engine-reference" | "approximation-with-a-priori-bound";
 }
+/**
+ * One progress event of `onProgress`. Stages run in this order: `raw`, `white-balance` (with auto white balance), `development`
+ * (rows), then, when requested, `diffraction-correction` and `sharpening` (#571: one event per output row of the whole image;
+ * each stage's last event has `completedTileCount === totalTileCount`), then `jpeg`. `output.lensCorrections` (#570) runs between
+ * `diffraction-correction` and `sharpening` and reports no stage of its own. {@link simulateCaptureFromParts}
+ * reports no `raw` stage: its RAW comes from the parts.
+ */
 export interface SimulateCaptureProgress {
-    stage: "raw" | "white-balance" | "development" | "jpeg";
+    stage: "raw" | "white-balance" | "development" | "diffraction-correction" | "sharpening" | "jpeg";
     completedTileCount: number;
     totalTileCount: number;
 }
@@ -1214,11 +1244,13 @@ export interface ParsedDisplayView {
 export declare function parseDisplayViewOption(value: unknown, frameWidth: number, frameHeight: number): ParsedDisplayView;
 /** Internal: passed as the view of a "display-view" run to resolve the request without a view (`prepareDisplayView`, #387). */
 export declare const DISPLAY_VIEW_WITHOUT_VIEW: unique symbol;
+/** Internal: what `runCapture` produces. The two `-from-parts` runs take the parts as `viewOption`. */
+type CaptureRun = "capture" | "ideal-reference" | "display-view" | "dng-from-parts" | "develop-from-parts";
 /**
  * Internal: the request path shared by {@link simulateCapture}, {@link simulateIdealReference} and the display view, whose renderer is
  * passed in; for a display view the renderer's value is returned (a result, or a prepared view with DISPLAY_VIEW_WITHOUT_VIEW).
  */
-export declare function runCapture(options: SimulateCaptureOptions, run: "capture" | "ideal-reference" | "display-view" | "dng-from-parts", viewOption?: unknown, renderView?: (context: DisplayViewRunContext) => Promise<unknown>): Promise<unknown>;
+export declare function runCapture(options: SimulateCaptureOptions, run: CaptureRun, viewOption?: unknown, renderView?: (context: DisplayViewRunContext) => Promise<unknown>): Promise<unknown>;
 /** Chart preset ids accepted by `simulateCapture({ scene: { preset } })`. */
 export declare const SIMULATE_CAPTURE_CHART_PRESETS: readonly ("composite" | "uniform" | "patches" | "slanted-edge" | "siemens-star" | "step-wedge" | "grey-ramp" | "checkerboard" | "point-grid" | "color-patches" | "dead-leaves" | "bar-groups" | "hyperbolic-wedge" | "zone-plate" | "slanted-squares" | "line-grid" | "fiducial")[];
 export {};