pfsinrgbe(1) [debian man page]
pfsinrgbe(1) General Commands Manual pfsinrgbe(1) NAME
pfsinrgbe - Load images or frames in Radiance RGBE format SYNOPSIS
pfsinrgbe [--linear] (<file> [--frames <range>] [--skip-missing]) [<file>...] DESCRIPTION
pfsinrgbe command loads images in Radiance RGBE format and writes pfs stream to the Standard Output. The pfs stream is usually piped to another program for further processing. To detect the format automatically based on the extension, use pfsin command. Since RGBE is an HDR format, 'LUMINANCE' tag is set to 'RELATIVE' (relative linear luminance values). To read images from standard input use a single dash '-' instead of filename. The images are read until EOF is reached. Each file can contain a %d pattern, which is substituted with frame numbers. The pattern has the same syntax as C printf command. For exam- ple, you can use %04d to make the frame number four digit with proceedings zeros. You can select the frames using the following options (the options must be always given after the file name): --frames <range> Range is given in mathlab / octave format: startframe:step:endframe Frame numbers start with startframe (default 0), are increased by step (default 1) and stop at endframe You can skip one of those values, for example 1:100 for frames 1,2,...,100 and 0:2: for frame 0,2,4,... up to the last file that exists. --skip-missing Skip up to ten frames in a row if corresponding files are missing. Otherwise the program stops reading sequence at the first file that does not exists. This switch does not apply to the first frame in a sequence. This switch can be useful if there is a rendered animation where some of the frame has not been generated. --linear Ignored for compatibility with pfsinppm. EXAMPLES
pfsinrgbe intro%d.hdr frame%d.hdr | ... Concatenate two animations into one and pass it to pipe for further processing. IMPORTANT NOTE
There is an incompatibility between viewers of RGBE format in terms of absolute luminance values. The ximage viewer from Radiance package expects radiance values in RGBE files and uses the WHITE_EFFICACY constant equal to 179.0f to convert from radiance to luminance. This in practice means that the values displayed with pfsview maybe higher than expected. To compensate for this incompatibility we suggest to use pfsabsolute command: pfsinrgbe measured_luminance.hdr | pfsabsolute 1 179 | pfsview This is not necessary when RGBE files are saved using pfsoutrgbe, Radiance package, mkhdr or Photospheare. This is also not relevant when only relative absolute values are considered. BUGS
Please report bugs and comments on implementation to the discussion group http://groups.google.com/group/pfstools SEE ALSO
pfsin(1), pfsout(1) pfsinrgbe(1)
Check Out this Related Man Page
pfsin(1) General Commands Manual pfsin(1) NAME
pfsin - Read an image in one of the several formats and write pfs stream to the standard output SYNOPSIS
pfsin <file> [<file>...] DESCRIPTION
This command can be used to read high- or low- dynamic range image in several recognized formats and output pfs stream on standard output. The pfs stream is usually piped to another program for further processing (see examples). To get a list of recognized formats and exten- sions, execute: pfsin --help This command is a front-end for pfsin* programs for reading images: pfsinrgbe, pfsinexr, etc. Based on the file extension, appropriate pro- gram is executed. If two different file format are given as parameters, two different program for loading images are executed. Additional options starting with dash '-' can be passed to pfsin* programs. The following rules apply for passing the options: the options given before any image file name (or %d pattern) are passed to all pfsin* programs. Options given after image file name are only passed to the program executed for that file(s). Note also that all option that take an argument (except --frames) must given in the form --option=value, that is without a space between an option and its argument. OPTIONS
The following options are shared by most pfsin* commands, although some may not accept --absolute and may ignore --linear. --frames <range> Range is given in mathlab / octave format: startframe:step:endframe Frame numbers start with startframe (default 0), are increased by step (default 1) and stop at endframe You can skip one of those values, for example 1:100 for frames 1,2,...,100 and 0:2: for frames 0,2,4,... up to the last file that exists. --skip-missing Skip up to ten frames in a row if corresponding files are missing. Otherwise the program stops reading sequence at the first file that does not exists. This switch does not apply to the first frame in a sequence. This switch can be useful if there is a rendered animation where some of the frame has not been generated. --linear, -l Converts pixel values to linear luminance (XYZ), assuming the sRGB color space for the input image. The maximum pixel value (255,255,255) is mapped to Y=1. LUMINANCE tag is set to RELATIVE. --absolute <max_lum>, -a <max_lum> --absolute converts pixel values to an absolute linear luminance (XYZ), that is the color space, in which channel Y contains lumi- nance given in cd/m^2. The sRGB color space is assumed for the input image. The maximum pixel value (255,255,255) is mapped to Y=<max_lum>. <max_lum> is typically set to 80 [cd/m^2] for a CRT monitor. LUMINANCE tag is set to ABSOLUTE. --absolute process images almost the same as --relative, but additionally it scales all pixels by <max_lum>. EXAMPLES
pfsin memorial.pic | pfsview See a hdr image in Radiance format (RGBE). pfsin memorial.pic | pfstmo_drago03 | pfsout memorial.jpeg Tone map a hdr image and save it as JPEG. SEE ALSO
pfsout(1) pfsinppm(1) BUGS
For LDR formats - JPEG, PNG, PNM: If pfstools are compiled without ImageMagic support, this command currently will not handle multiple frames given with a %d pattern. Please report bugs and comments on implementation to the discussion group http://groups.google.com/group/pfstools pfsin(1)