/usr/bin/exrstdattr

Usage: exrstdattr [commands] infile outfile

Read OpenEXR image file infile, set the values of one
or more attributes in the headers of the file, and save
the result in outfile.  Infile and outfile must not refer
to the same file (the program cannot edit an image file "in place").

Command for selecting headers:

  -part i
        If i is greater than or equal to zero, and less
        than the number of parts in the input file, then
        the header for part i becomes "current." If i
        is "any" or -1, then all headers become current.
        Subsequent attribute setting commands affect only
        the current header or headers.  All headers are
        current before the first -part command.

        For example, the command sequence

         -focus 3 -part 2 -aperture 8 -expTime 0.01 -part any -owner luke

        sets the focus and owner attributes in all
        headers, as well as the aperture and expTime
        attributes in the header of part 2.

Commands for setting attribute values:

  -chromaticities f f f f f f f f
        CIE xy chromaticities for the red, green
        and blue primaries, and for the white point
        (8 floats). This attribute is superseded by
        colorInteropID for most purposes.

  -colorInteropID s
        Color Interop Forum ID that identifies the
        color space of the RGB image data (string)

  -whiteLuminance f
        white luminance, in candelas per square meter
        (float, >= 0.0)

  -adoptedNeutral f f
        CIE xy coordinates that should be considered
        "neutral" during color rendering.  Pixels in
        the image file whose xy coordinates match the
        adoptedNeutral value should be mapped to neutral
        values on the display. (2 floats)

  -renderingTransform s
        name of the CTL rendering transform for this
        image (string). This attribute is deprecated.

  -lookModTransform s
        name of the CTL look modification transform for
        this image (string). This attribute is deprecated.

  -xDensity f
        horizontal output density, in pixels per inch
        (float, >= 0.0)

  -owner s
        name of the owner of the image (string)

  -comments s
        additional information about the image (string)

  -capDate s
        date when the image was created or
        captured, in local time (string,
        formatted as YYYY:MM:DD hh:mm:ss)

  -utcOffset f
        offset of local time at capDate from UTC, in
        seconds (float, UTC == local time + x)

  -longitude f
  -latitude f
  -altitude f
        location where the image was recorded, in
        degrees east of Greenwich and north of the
        equator, and in meters above sea level
        (float)

  -focus f
        the camera's focus distance, in meters
        (float, > 0, or "infinity")

  -expTime f
        exposure time, in seconds (float, >= 0)

  -aperture f
        lens apterture, in f-stops (float, >= 0)

  -isoSpeed f
        effective speed of the film or image
        sensor that was used to record the image
        (float, >= 0)

  -envmap s
        indicates that the image is an environment map
        (string, LATLONG or CUBE)

  -framesPerSecond i i
        playback frame rate expressed as a ratio of two
        integers, n and d (the frame rate is n/d frames
        per second)

  -keyCode i i i i i i i
        key code that uniquely identifies a motion
        picture film frame using 7 integers:
         * film manufacturer code (0 - 99)
         * film type code (0 - 99)
         * prefix to identify film roll (0 - 999999)
         * count, increments once every perfsPerCount
           perforations (0 - 9999)
         * offset of frame, in perforations from
           zero-frame reference mark (0 - 119)
         * number of perforations per frame (1 - 15)
         * number of perforations per count (20 - 120)

  -timeCode i i
        SMPTE time and control code, specified as a pair
        of 8-digit base-16 integers.  The first number
        contains the time address and flags (drop frame,
        color frame, field/phase, bgf0, bgf1, bgf2).
        The second number contains the user data and
        control codes.

  -wrapmodes s
        if the image is used as a texture map, specifies
        how the image should be extrapolated outside the
        zero-to-one texture coordinate range
        (string, e.g. "clamp" or "periodic,clamp")

  -pixelAspectRatio f
        width divided by height of a pixel
        (float, >= 0)

  -screenWindowWidth f
        width of the screen window (float, >= 0)

  -screenWindowCenter f f
        center of the screen window (2 floats)

  -string s s
        custom string attribute
        (2 strings, attribute name and value)

  -float s f
        custom float attribute (string + float,
        attribute name and value)

  -int s i
        custom integer attribute (string + integer,
        attribute name and value)

Other options:

  -erase s      remove attribute with given name
  -h, --help    print this message
      --version print version information

Report bugs via https://github.com/AcademySoftwareFoundation/openexr/issues or email security@openexr.com