debian man page for pfsin

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)