FreeBSD manual
download PDF document: exrstdattr.1.pdf
EXRSTDATTR(1) User Commands EXRSTDATTR(1)
NAME
exrstdattr - set exr image metadata
SYNOPSIS
exrstdattr [commands] infile outfile
DESCRIPTION
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)
-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.
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:
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:
-h, --help
print this message
--version print version information
REPORTING BUGS
Report bugs via
https://github.com/AcademySoftwareFoundation/openexr/issues or email
security@openexr.com
COPYRIGHT