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

NAME

6       pfsinrgbe - Load images or frames in Radiance RGBE format
7

SYNOPSIS

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

DESCRIPTION

14       pfsinrgbe command loads images in Radiance RGBE format and  writes  pfs
15       stream  to  the  Standard  Output.  The  pfs stream is usually piped to
16       another program for further processing. To detect the format  automati‐
17       cally based on the extension, use pfsin command.
18
19       Since RGBE is an HDR format, 'LUMINANCE' tag is set to 'RELATIVE' (rel‐
20       ative linear luminance values).
21
22       To read images from standard input use a single  dash  '-'  instead  of
23       filename. The images are read until EOF is reached.
24
25       Each  file  can  contain  a %d pattern, which is substituted with frame
26       numbers. The pattern has the same syntax as C printf command. For exam‐
27       ple, you can use %04d to make the frame number four digit with proceed‐
28       ings zeros. You can select the frames using the following options  (the
29       options must be always given after the file name):
30
31       --frames <range>
32              Range is given in mathlab / octave format:
33
34              startframe:step:endframe
35
36              Frame  numbers  start with startframe (default 0), are increased
37              by step (default 1) and stop at endframe You  can  skip  one  of
38              those  values, for example 1:100 for frames 1,2,...,100 and 0:2:
39              for frame 0,2,4,... up to the last file that exists.
40
41
42       --skip-missing
43              Skip up to ten frames in a row if corresponding files are  miss‐
44              ing.  Otherwise  the program stops reading sequence at the first
45              file that does not exists. This switch does  not  apply  to  the
46              first frame in a sequence. This switch can be useful if there is
47              a rendered animation where some of the frame has not been gener‐
48              ated.
49
50
51       --linear
52              Ignored for compatibility with pfsinppm.
53
54
55       --radiance, -r
56              Correct stored values so that the luminance is reported the same
57              in pfsview and  radiance  tools  (xview  or  Photospheare).  See
58              IMPORTANT NOTE below.
59
60
61       --quiet, -q
62              Disable  warning  message  about the change in handling absolute
63              values in RGBE files. See IMPORTANT NOTE below.
64
65

EXAMPLES

67       pfsinrgbe intro%d.hdr frame%d.hdr | ...
68
69              Concatenate two animations into one and pass it to pipe for fur‐
70              ther processing.
71
72

IMPORTANT NOTE

74       There  is an incompatibility between viewers of RGBE format in terms of
75       absolute luminance values. The  ximage  viewer  from  Radiance  package
76       expects  radiance  values  in  RGBE  files and multiplies the resulting
77       luminance by the WHITE_EFFICACY constant equal  to  179.0f  to  convert
78       from radiance to luminance.
79
80       To  remain  compatible with Radiance (xview and Photospheare), pfstools
81       prior to 1.9.0 divided red, green and blue values by 179 on writing and
82       multiplied  by that constant on reading RGBE files. This in turn caused
83       incompatibility with other software, such as Photoshop or HDR  toolbox.
84       Starting  from  pfstools  1.9.0 this division / multiplication step was
85       removed to make pfstools compatible in terms of  absolute  values  with
86       the  majority  of  the  software. The downside is that this change made
87       luminance units) with the pfstools 1.9.0 or later. To  avoid  any  mis‐
88       takes  because  of  that  change, a long warning messages is shown each
89       time pfsinrgbe or pfsoutrgbe is called. The message can  be  suppressed
90       with --quiet option.
91
92       To  enable  the old functionality and read or write RGBE files with the
93       correction for WHITE_EFFICACY, add --radiance  option  to  the  command
94       line.
95
96

BUGS

98       Please  report  bugs  and  comments on implementation to the discussion
99       group http://groups.google.com/group/pfstools
100

SEE ALSO

102       pfsin(1), pfsout(1)
103
104
105
106
107
108                                                                  pfsinrgbe(1)
Impressum