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

EXAMPLES

56       pfsinrgbe intro%d.hdr frame%d.hdr | ...
57
58              Concatenate two animations into one and pass it to pipe for fur‐
59              ther processing.
60
61

IMPORTANT NOTE

63       There is an incompatibility between viewers of RGBE format in terms  of
64       absolute  luminance  values.  The  ximage  viewer from Radiance package
65       expects radiance values in RGBE files and uses the WHITE_EFFICACY  con‐
66       stant  equal  to  179.0f to convert from radiance to luminance. This in
67       practice means that the values displayed with pfsview maybe higher than
68       expected. To compensate for this incompatibility we suggest to use pfs‐
69       absolute command:
70
71       pfsinrgbe measured_luminance.hdr | pfsabsolute 1 179 | pfsview
72
73       This is not necessary when RGBE files are saved using pfsoutrgbe, Radi‐
74       ance  package,  mkhdr  or  Photospheare. This is also not relevant when
75       only relative absolute values are considered.
76
77
78

BUGS

80       Please report bugs and comments on  implementation  to  the  discussion
81       group http://groups.google.com/group/pfstools
82

SEE ALSO

84       pfsin(1), pfsout(1)
85
86
87
88
89
90                                                                  pfsinrgbe(1)
Impressum