1pfsin(1) General Commands Manual pfsin(1)
2
3
4
6 pfsin - Read an image in one of the several formats and write pfs
7 stream to the standard output
8
10 pfsin <file> [<file>...]
11
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
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
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
88 pfsout(1) pfsinppm(1)
89
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)