Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
pfsoutrgbe(1)		     General Commands Manual		   pfsoutrgbe(1)

NAME
     pfsoutrgbe - Write images or frames in Radiance RGBE format

SYNOPSIS
     pfsoutrgbe  [--verbose]  [--radiance] [--quiet] (<file> [--frames <range>])
     [<file>...]

DESCRIPTION
     Use this command to the incoming pfs frames (piped to  standard  input)  to
     Radiance RGBE files (with .hdr extension).

     Each  file  name  can contain a %d pattern, which is substituted with frame
     numbers. The pattern has the same syntax as C printf command. For	example,
     you  can  use %04d to make the frame number four digit with proceedings ze-
     ros. You can select the frames using --frames option (see below).

OPTIONS
     --frames <range>
	    The range of frames is given in a format similar to  matlab  or  oc-
	    tave:

	    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 val-
	    ues, for example 1:100 for frames 1,2,...,100  and	0:2:  for  frame
	    0,2,4,... up to the last file that exists. Note that --frames option
	    must  be specified after the file name containing %d string.  higher
	    bit depths.

     --radiance, -r
	    Correct stored values so that the luminance is reported the same  in
	    pfsview  and  radiance  tools (xview or Photospheare). See IMPORTANT
	    NOTE below.

     --quiet, -q
	    Disable warning message about the change in handling absolute values
	    in RGBE files. See IMPORTANT NOTE below.

EXAMPLES
      pfsin memorial.tiff | pfsoutrgbe memorial.hdr
	    Converts from one HDR format to another

     pfsin test.jpg | pfsout test.png
	    Convert from one image format to another.

SEE ALSO
     pfsout(1) pfsinppm(1)

IMPORTANT NOTE
     There is an incompatibility between viewers of RGBE format in terms of  ab-
     solute  luminance	values.  The ximage viewer from Radiance package expects
     radiance values in RGBE files and multiplies the resulting luminance by the
     WHITE_EFFICACY constant equal to 179.0f to convert from radiance  to  lumi-
     nance.

     To remain compatible with Radiance (xview and Photospheare), pfstools prior
     to  1.9.0	divided  red, green and blue values by 179 on writing and multi-
     plied by that constant on reading RGBE files. This in turn caused incompat-
     ibility with other software, such as Photoshop  or  HDR  toolbox.	Starting
     from pfstools 1.9.0 this division / multiplication step was removed to make
     pfstools  compatible  in  terms of absolute values with the majority of the
     software. The downside is that this change made luminance units)  with  the
     pfstools  1.9.0  or  later. To avoid any mistakes because of that change, a
     long warning messages is shown each time pfsinrgbe or pfsoutrgbe is called.
     The message can be suppressed with --quiet option.

     To enable the old functionality and read or write RGBE files with the  cor-
     rection for WHITE_EFFICACY, add --radiance option to the command line.

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

								   pfsoutrgbe(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=pfsoutrgbe&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help