pfsinexr(1) [suse 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)

pfsin(1)						      General Commands Manual							  pfsin(1)

NAME

       pfsin - Read an image in one of the several formats and write pfs stream to the standard output

SYNOPSIS

       pfsin <file> [<file>...]

DESCRIPTION

       This  command can be used to read high- or low- dynamic range image in several recognized formats and output pfs stream on standard output.
       The pfs stream is usually piped to another program for further processing (see examples). To get a list of recognized  formats  and  exten-
       sions, execute:

	 pfsin --help

       This command is a front-end for pfsin* programs for reading images: pfsinrgbe, pfsinexr, etc. Based on the file extension, appropriate pro-
       gram is executed. If two different file format are given as parameters, two different program for loading images are  executed.	Additional
       options	starting  with	dash  '-'  can	be passed to pfsin* programs. The following rules apply for passing the options: the options given
       before any image file name (or %d pattern) are passed to all pfsin* programs. Options given after image file name are only  passed  to  the
       program executed for that file(s). Note also that all option that take an argument (except --frames) must given in the form --option=value,
       that is without a space between an option and its argument.

OPTIONS

       The following options are shared by most pfsin* commands, although some may not accept --absolute and may ignore --linear.

       --frames <range>
	      Range is given in mathlab / octave format:

	      startframe:step:endframe

	      Frame numbers start with startframe (default 0), are increased by step (default 1) and stop at endframe You can skip  one  of  those
	      values, for example 1:100 for frames 1,2,...,100 and 0:2: for frames 0,2,4,... up to the last file that exists.

       --skip-missing
	      Skip  up	to  ten frames in a row if corresponding files are missing. Otherwise the program stops reading sequence at the first file
	      that does not exists. This switch does not apply to the first frame in a sequence. This switch can be useful if there is a  rendered
	      animation where some of the frame has not been generated.

       --linear, -l
	      Converts	pixel  values  to  linear  luminance  (XYZ),  assuming	the  sRGB color space for the input image. The maximum pixel value
	      (255,255,255) is mapped to Y=1. LUMINANCE tag is set to RELATIVE.

       --absolute <max_lum>, -a <max_lum>
	      --absolute converts pixel values to an absolute linear luminance (XYZ), that is the color space, in which channel Y  contains  lumi-
	      nance  given  in	cd/m^2.  The  sRGB  color space is assumed for the input image. The maximum pixel value (255,255,255) is mapped to
	      Y=<max_lum>. <max_lum> is typically set to 80 [cd/m^2] for a CRT monitor. LUMINANCE tag  is  set	to  ABSOLUTE.  --absolute  process
	      images almost the same as --relative, but additionally it scales all pixels by <max_lum>.

EXAMPLES

       pfsin memorial.pic | pfsview

	      See a hdr image in Radiance format (RGBE).

       pfsin memorial.pic | pfstmo_drago03 | pfsout memorial.jpeg

	      Tone map a hdr image and save it as JPEG.

SEE ALSO

       pfsout(1) pfsinppm(1)

BUGS

       For  LDR  formats  -  JPEG,  PNG, PNM: If pfstools are compiled without ImageMagic support, this command currently will not handle multiple
       frames given with a %d pattern.

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

																	  pfsin(1)