1pfsin(1)                    General Commands Manual                   pfsin(1)
2
3
4

NAME

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

SYNOPSIS

10       pfsin <file> [<file>...]
11

DESCRIPTION

13       This command can be used to read high- or low- dynamic range  image  in
14       several  recognized  formats  and output pfs stream on standard output.
15       The pfs stream is usually piped to another program for further process‐
16       ing (see examples). To get a list of recognized formats and extensions,
17       execute:
18
19         pfsin --help
20
21       This command is a front-end for pfsin*  programs  for  reading  images:
22       pfsinrgbe, pfsinexr, etc. Based on the file extension, appropriate pro‐
23       gram is executed. If two different file format are given as parameters,
24       two  different  program  for  loading  images  are executed. Additional
25       options starting with dash '-' can be passed to  pfsin*  programs.  The
26       following rules apply for passing the options: the options given before
27       any image file name (or %d pattern) are passed to all pfsin*  programs.
28       Options given after image file name are only passed to the program exe‐
29       cuted for that file(s). Note also that all option that take an argument
30       (except  --frames) must given in the form --option=value, that is with‐
31       out a space between an option and its argument.
32
33

OPTIONS

35       The following options are shared by most pfsin* commands, although some
36       may not accept --absolute and may ignore --linear.
37
38       --frames <range>
39              Range is given in mathlab / octave format:
40
41              startframe:step:endframe
42
43              Frame  numbers  start with startframe (default 0), are increased
44              by step (default 1) and stop at endframe You  can  skip  one  of
45              those  values, for example 1:100 for frames 1,2,...,100 and 0:2:
46              for frames 0,2,4,... up to the last file that exists.
47
48
49       --skip-missing
50              Skip up to ten frames in a row if corresponding files are  miss‐
51              ing.  Otherwise  the program stops reading sequence at the first
52              file that does not exists. This switch does  not  apply  to  the
53              first frame in a sequence. This switch can be useful if there is
54              a rendered animation where some of the frame has not been gener‐
55              ated.
56
57
58       --linear, -l
59              Converts  pixel  values  to linear luminance (XYZ), assuming the
60              sRGB color space for the input image. The  maximum  pixel  value
61              (255,255,255)  is  mapped  to Y=1. LUMINANCE tag is set to RELA‐
62              TIVE.
63
64
65       --absolute <max_lum>, -a <max_lum>
66              --absolute converts pixel values to an absolute linear luminance
67              (XYZ),  that  is  the  color  space, in which channel Y contains
68              luminance given in cd/m^2. The sRGB color space is  assumed  for
69              the input image. The maximum pixel value (255,255,255) is mapped
70              to Y=<max_lum>. <max_lum> is typically set to 80 [cd/m^2] for  a
71              CRT  monitor.  LUMINANCE  tag  is  set  to  ABSOLUTE. --absolute
72              process images almost the same as --relative,  but  additionally
73              it scales all pixels by <max_lum>.
74
75

EXAMPLES

77       pfsin memorial.pic | pfsview
78
79              See a hdr image in Radiance format (RGBE).
80
81
82       pfsin memorial.pic | pfstmo_drago03 | pfsout memorial.jpeg
83
84              Tone map a hdr image and save it as JPEG.
85
86

SEE ALSO

88       pfsout(1) pfsinppm(1)
89

BUGS

91       For  LDR  formats  -  JPEG,  PNG, PNM: If pfstools are compiled without
92       ImageMagic support, this command currently  will  not  handle  multiple
93       frames given with a %d pattern.
94
95       Please  report  bugs  and  comments on implementation to the discussion
96       group http://groups.google.com/group/pfstools
97
98
99
100                                                                      pfsin(1)
Impressum