pfsinexr(1) [debian man page]

pfsinexr(1)						      General Commands Manual						       pfsinexr(1)

NAME

       pfsinexr - Load images or frames in OpenEXR format

SYNOPSIS

       pfsinexr [--keep-rgb] (<file> [--frames <range>] [--skip-missing])  [<file>...]

DESCRIPTION

       Use this command to read frames in OpenEXR format. The frames are converted to pfs stream and send to the standard output. This command can
       read arbitrary channels from OpenEXR files; color channels XYZ are however specially handled (see option keep-rgb).

       pfsinexr reads also all string attributes from OpenEXR file and write them as tags in pfs stream. Attributes of other types are ignored. If
       attribute name contains a colon (:), the part before colon is treated as a channel name and the attribute is assigned to that channel (sim-
       ilar notation as command line argument of pfstag program).

       pfsinexr recognizes OpenEXR standard attribute WhiteLuminance and multiplies the data by that value to get absolute luminance  values  (see
       also  --fix-halfmax  switch  in pfsoutexr). Additionally the tag LUMINANCE is set to ABSOLUTE unless OpenEXR files contains attribute LUMI-
       NANCE set to semething else. That is the channel Y is assumued to represent absolute luminance levels in cd/m^2.

       If an OpenEXR file contains 'Z' channel, it is renamed to 'DEPTH' to avoid conflict with the Z color channel for the XYZ color space.

       Details on the format of the pattern file names, which are used for reading multiple frames, can be found in the manual page of pfsinppm.

       To automatically recognize a file format from the extension, use pfsin command instead.

       --keep-rgb
	      By default, color channels R, G and B from an OpenEXR file are converted to XYZ color space, which is  suggested	format	for  color
	      data in pfs. When keep-rgb option is specified, color channels RGB are stored as they are without any conversion.

EXAMPLES

	pfsin memorial.exr | pfsout memorial.hdr

	      Converts from one HDR format to another

BUGS

       pfsinexr and pfsoutexr can not take stdin / stdout as an input/output (dash '-' instead of file name).

       Please report bugs and comments on implementation to the discussion group http://groups.google.com/group/pfstools

SEE ALSO

       pfsin(1) pfsinppm(1) pfsoutexr(1)

																       pfsinexr(1)

pfsoutexr(1)						      General Commands Manual						      pfsoutexr(1)

NAME

       pfsoutexr - Write images or frames in OpenEXR format

SYNOPSIS

       pfsoutexr [--compression <method>] [--keep-xyz] (<file> [--frames <range>])  [<file>...]

DESCRIPTION

       Use  this  command to write frames in OpenEXR format. Source pfs frames should be piped to the Standard Input. This command can write arbi-
       trary channels to OpenEXR, color channels XYZ however are specially handled (see option keep-xyz).

       All tags from pfs stream are stored in an OpenEXR file as String attributes. Tags assigned to channels are  stored  in  the  format  <chan-
       nel_name>:<tag_name>, so that pfsinexr can later restore tags in the appropriate channels.

       The  depth channel DEPTH is renamed to Z to keep compatibility with pfsinexr. If the luminance is absolute (tag LUMINANCE set to ABSOLUTE),
       WhiteLuminance attribute in OpenEXR file is set to 1.

       Details on the format of the pattern file names, which are used for saving multiple frames, can be found in the manual page of pfsoutppm.

       --compression <method>, -c <method>
	      Use one the the available compression methods:

	      NO - no compression

	      RLE - run length encoding

	      ZIPS - zlib compression, one scan line at a time

	      ZIP - zlib compression, in blocks of 16 scan lines

	      PIZ - piz-based wavelet compression (default)

	      PXR24 - lossy 24-bit float compression

       --keep-xyz
	      By default, color channels XYZ from pfs stream are converted to RGB color space and HALF format, which  is  a  standard  format  for
	      color  data in OpenEXR. Since Half format is 16-bit and floating points values used in pfs stream are 32-bit, this conversion causes
	      loss of precision. When keep-xyz option is specified, color channels XYZ are stored as they are without any conversion (32-bit float
	      XYZ channels). Note however, that most OpenEXR applications can recognize only RGB Half format images and can not handle 32-bit XYZ.

       --fix-halfmax
	      The  maximum value that can be stored in OpenEXR file is limited to 65504 if 16-bit HALF float is used (color channels are stored by
	      default in this format unless --keep-xyz switch is specified). If the luminance data is  calibrated  in  absolute  values  (cd/m^2),
	      pixel  values  can  easily exceed 65504. To avoid clamping large pixel values, pfsoutexr can rescale data to the range that is valid
	      for 16-bit HALF float format when --fix-halfmax switch is specified. If this switch is missing,  a  warning  message  is	displayed.
	      Scale  factor  used for rescaling is stored in OpenEXR file as OpenEXR standard attribute WhiteLuminance, so that pfsinexr can later
	      restore the absolute values.

EXAMPLES

	pfsin memorial.hdr | pfsoutexr memorial.exr

	      Converts from one HDR format to another

SEE ALSO

       pfsout(1) pfsoutppm(1) pfsinexr(1)

BUGS

       pfsinexr and pfsoutexr can not take stdin / stdout as an input/output (dash '-' instead of file name).

       Please report bugs and comments on implementation to the discussion group http://groups.google.com/group/pfstools

																      pfsoutexr(1)