\"                                      Hey, EMACS: -*- nroff -*-
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH EXRSTDATTR 1 "March 31, 2004"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
exrstdattr \- a utility for modifying OpenEXR standard attributes.
.SH SYNOPSIS
.B exrstdattr
.RI "[options] infile outfile"
.SH DESCRIPTION
This manual page documents briefly the
.B exrstdattr
command.
This manual page was written for the Debian distribution because the original
program does not have a manual page.
.PP
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
.\" \fI<whatever>\fP escape sequences to invode bold face and italics, 
.\" respectively.

\fBexrstdattr\fP reads an OpenEXR image from infile, sets the values of one or
more standard attributes in the image's header, and saves the result in
outfile. Note that infile and outfile must not refer to the same file (i.e. the
program cannot edit an image file "in place").

.SH OPTIONS
Options for setting attribute values include:
.TP
.B \-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)
.TP
.B \-whiteLuminance f
white luminance, in candelas per square meter (float, >= 0.0)
.TP
.B \-xDensity f
horizontal output density, in pixels per inch (float, >= 0.0)
.TP 
.B \-owner s
name of the owner of the image (string)
.TP
.B \-comments s
additional information about the image (string)
.TP
.B \-capDate s
date when the image was created or captured, in local time (string, formatted
as YYYY:MM:DD hh:mm:ss)
.TP
.B \-utcOffset f
offset of local time at capDate from UTC, in seconds (float, UTC == local time
+ x)
.TP
.B \-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)
.TP
.B \-focus f
the camera's focus distance, in meters (float, > 0, or "infinity")
.TP
.B \-expTime f
exposure time, in seconds (float, >= 0)
.TP
.B \-aperture f
lens apterture, in f\-stops (float, >= 0)
.TP
.B \-isoSpeed f
effective speed of the film or image sensor that was used to record the image
(float, >= 0)
.TP
.B \-envmap s
indicates that the image is an environment map (string, LATLONG or CUBE)
.TP
.B \-pixelAspectRatio f
width divided by height of a pixel (float, >= 0)
.TP
.B \-screenWindowWidth f
width of the screen window (float, >= 0)
.TP
.B \-screenWindowCenter f f
center of the screen window (2 floats)
.TP 
.B \-h
prints these options

.SH AUTHOR
This manual page was written by Andrew Lau <netsnipe@users.sourceforge.net>,
for the Debian GNU/Linux system (but may be used by others).