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

FreeBSD Manual Pages

  
 
  

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

NAME
       pfspanoramic - Perform projective transformations of spherical images

SYNOPSIS
       pfspanoramic  <source  projection>+<target  projection> [--width	<val>]
       [--height <val>]	[--oversample <val>] [--interpolate]  [--xrotate  <an-
       gle>] [--yrotate	<angle>] [--zrotate <angle>]

DESCRIPTION
       Transform  spherical  maps between various projections. Currently polar
       (latitude-longitude), angular (light probe), mirrorball and cylindrical
       are  supported.	The  syntax  for  specifying  the  transformation   is
       source_projection+target_projection,  where  source_projection  is  the
       current mapping that source image uses  and  target_projection  is  the
       projection  you'd  like	it to be transformed to. If the	projection has
       some optional parameters, you can specify  them	with  syntax:  <source
       projection>/<argument>/...+<target projection>/<argument>/...

       As of now only angular supports a parameter - angle - which defines how
       many  degrees  from  the	viewing	direction the projection should	cover,
       e.g. angular+angular/angle=180 converts angular image to	show only half
       of a hemisphere around the viewing direction.

OPTIONS
       --width <val>, -w <val>

       --height	<val>, -h <val>

	      Make the target image  respectively  <val>  pixels  wide	and/or
	      high.  If	 only one is specified,	the other is computed from the
	      target projection's typical W/H ratio.  If neither is specified,
	      the width	is taken from the source image and height is  computed
	      as above.

       --oversample <val>, -o <val>

	      Oversample  each target pixel <val>x<val>	times, improving qual-
	      ity in areas that	are scaled down	with respect to	the source im-
	      age. Reasonable values are 2 to 5, while setting it  higher  may
	      make the reprojection unbearably slow.

       --interpolate, -i

	      Use  bilinear  interpolation when	sampling the source image. In-
	      creases quality in magnified areas.

       --xrotate <angle>, -x <angle>

	      Rotate the spherical image <angle> degrees around	X axis.

       --yrotate <angle>, -y <angle>

	      Rotate the spherical image <angle> degrees around	Y axis.

       --zrotate <angle>, -z <angle>

	      Rotate the spherical image <angle> degrees around	Z axis.

EXAMPLES
       pfsin grace_probe.hdr | pfspanoramic angular+polar -i -o	3 -y 90	-w 500
       | pfsout	grace.hdr

	      Transform	grace angular map to polar  (latitude-longitude)  pro-
	      jection  applying	 bilinear  interpolation and 3x3 oversampling,
	      while rotating it	by 90 degrees around Y axis. The image will be
	      resized to 500x250 pixels	 (as  the  polar  projection  has  2:1
	      width-to-height ratio) and finally saved in grace.hdr.

SEE ALSO
       pfsin(1)	pfsout(1)

BUGS
       Please report bugs and comments to Miloslaw Smyk	<thorgal@wfmh.org.pl>.

							       pfspanoramic(1)

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

home | help