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

NAME

6       pfsoutppm,  pfsouttiff,  pfsoutrgbe, pfsoutexr - Write images or frames
7       in one of the several formats
8

SYNOPSIS

10       pfsoutppm (<file> [--srgb] [--frames <range>])  [<file>...]
11
12       pfsouttiff (<file> [--srgb] [--frames <range>])  [<file>...]
13
14       pfsoutrgbe (<file> [--frames <range>])  [<file>...]
15
16       pfsoutexr (<file> [--frames <range>])  [<file>...]
17
18

DESCRIPTION

20       This command can be used to write pfs frames piped to standard input in
21       one  of the several recognized formats. See the manual page of pfsinppm
22       to get a list of available formats.
23
24       To write images to standard output use a single  dash  '-'  instead  of
25       filename.
26
27       Each  file  name  can  contain  a %d pattern, which is substituted with
28       frame numbers. The pattern has the same syntax as C printf command. For
29       example, you can use %04d to make the frame number four digit with pro‐
30       ceedings zeros. You can select the frames using the  following  options
31       (the options must be always given after the file name):
32
33       --frames <range>
34              Range is given in mathlab / octave format:
35
36              startframe:step:endframe
37
38              Frame  numbers  start with startframe (default 0), are increased
39              by step (default 1) and stop at endframe You  can  skip  one  of
40              those  values, for example 1:100 for frames 1,2,...,100 and 0:2:
41              for frame 0,2,4,... up to the last file that exists.
42
43       --srgb, -s
44              Apply the sRGB non-linearity (approximately  2.2  gamma)  before
45              writing  a  file.  This can be used instead of using pfsgamma -g
46              2.2 to store the result  of  some  tone-mapping  operators.  The
47              option  will compress contrast to make sure that tone values are
48              properly shown on a display. It should be only  used  with  lin‐
49              earized  (not gamma corrected) images that are normalized to the
50              0-1 range.
51
52       --bit-depth <val>, -b <val>
53              Enforce bit-depth (per color channel). The  allowed  values  are
54              from  8  to  32.  If  not  specified, the bit depth from the pfs
55              stream ('BITDEPTH' tag) will be used instead. If the  'BITDEPTH'
56              tag is missing, the ImageMagick default value will be used (usu‐
57              ally 16). The bit depth of actually stored file may be lower  of
58              that  specified,  if the file format does not support higher bit
59              depths.
60
61

EXAMPLES

63        pfsin memorial.tiff | pfsoutrgbe memorial.hdr
64              Converts from one HDR format to another
65
66       pfsin test.jpg | pfsout test.png
67              Convert from one image format to another.
68
69        pfsin --linear test.jpg | pfsout --srgb test.png
70              The same as above, but  apply  inverse  gamma  correction  after
71              reading  an  image  (--linear)  and  then apply gamma correction
72              before writing an image (--srgb).
73

SEE ALSO

75       pfsout(1) pfsinppm(1)
76

BUGS

78       Writing TIFF files with pfsouttiff seems to be broken,  but  pfsoutimg‐
79       magick  can be used instead. pfsout will attempt to use pfsoutimgmagick
80       and fall  back  to  pfsouttiff  if  pfstools  were  not  compiled  with
81       ImageMagick.
82
83       Please  report  bugs  and  comments on implementation to the discussion
84       group http://groups.google.com/group/pfstools
85
86
87
88                                                                  pfsoutppm(1)