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

NAME

6       pfsinppm - Load images or frames in PBM formats
7

SYNOPSIS

9       pfsinppm  (<file>  [--linear] [--absolute <max_lum>] [--frames <range>]
10       [--skip-missing])  [<file>...]
11
12

DESCRIPTION

14       pfsinppm command loads images in PBM formats  (PPM,  PNM  or  PGM)  and
15       writes  pfs  stream  to  the standard output. The pfs stream is usually
16       piped to another program for further processing. To detect  the  format
17       automatically  based  on  the  extension,  use  pfsin command. For more
18       information  on  PBM  formats,   refer   to   the   NetPBM   web   page
19       (http://netpbm.sourceforge.net/).
20
21       Note that PPM or PNM images are low dynamic range. Therefore pixel val‐
22       ues (0-255) are scaled to 0-1 before storing them in pfs stream.  Simi‐
23       larly,  before  writing  low dynamic range image from pfs stream, pixel
24       values are multiplied by 255.  By default, the 'LUMINANCE' tag  is  set
25       to  'DISPLAY'.  The '--linear' switch can force the inverse sRGB trans‐
26       formation and provide linear data. In this case the 'LUMINANCE' tag  is
27       set to 'RELATIVE'. '--absolute' switch can be used to convert pixels to
28       absolute luminance values.
29
30       To read images from standard input use a single  dash  '-'  instead  of
31       filename. The images are read until EOF is reached.
32
33       Each  file  can  contain  a %d pattern, which is substituted with frame
34       numbers. The pattern has the same syntax as C printf command. For exam‐
35       ple, you can use %04d to make the frame number four digit with proceed‐
36       ings zeros. See the OPTIONS section below for details.
37

OPTIONS

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

EXAMPLES

78       pfsinppm frame%04d.ppm --frames 0:10 | pfsview
79
80              Read  frames  from  files  frame0000.ppm,  frame0001.ppm,   ...,
81              frame0010.ppm and show them using pfsview.
82
83

BUGS

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

SEE ALSO

89       pfsin(1), pfsout(1)
90
91
92
93
94
95                                                                   pfsinppm(1)
Impressum