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)

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

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

home | help