Skip to content

image_encoding

image_encoding #

The still-photo image-encoding enum.

ImageEncoding #

Bases: Enum

How a captured photo is encoded on disk, shared by every photo node.

  • HEIC — the processed photo (default). Carries the camera's full processing, including the HDR gain map on capable devices.
  • RAW — the sensor mosaic as DNG (Apple ProRAW where supported), for pipelines that do their own development. Falls back loudly, never silently, when the device can't deliver RAW.

The ARKit scene capture's keyframes have no encoding knob — they come off the tracked video feed (no RAW, no HDR container) and are always sRGB JPEG, the reconstruction-native format.

Source code in capturegraph-lib/capturegraph/types/scalars/imaging/image_encoding.py 
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
class ImageEncoding(Enum, name="edu.cornell.image_encoding"):
    """How a captured photo is encoded on disk, shared by every photo node.

    - ``HEIC`` — the processed photo (default). Carries the camera's full
      processing, including the HDR gain map on capable devices.
    - ``RAW`` — the sensor mosaic as DNG (Apple ProRAW where supported), for
      pipelines that do their own development. Falls back loudly, never
      silently, when the device can't deliver RAW.

    The ARKit scene capture's keyframes have no encoding knob — they come off
    the tracked video feed (no RAW, no HDR container) and are always sRGB
    JPEG, the reconstruction-native format.
    """

    HEIC = "heic"
    RAW = "raw"