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 pro-
       ceedings	zeros. 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
	      octave:

	      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. 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  IM-
	      PORTANT 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
       absolute	 luminance values. The ximage viewer from Radiance package ex-
       pects radiance values in	RGBE files and multiplies the resulting	 lumi-
       nance  by  the  WHITE_EFFICACY constant equal to	179.0f to convert from
       radiance	to luminance.

       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
       multiplied by that constant on reading RGBE files. This in turn	caused
       incompatibility	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 lu-
       minance	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 pfs-
       inrgbe  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
       correction  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)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | SEE ALSO | IMPORTANT NOTE | BUGS

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

home | help