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	<angle>]
     [--yrotate <angle>] [--zrotate <angle>]

DESCRIPTION
     Transform spherical maps between various projections. Currently polar (lat-
     itude-longitude),	angular  (light  probe),  mirrorball and cylindrical are
     supported. The syntax for specifying the transformation  is  source_projec-
     tion+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 pro-
     jection>/<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 projec-
	    tion'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 quality in
	    areas that are scaled down with respect to the source image. Reason-
	    able values are 2 to 5, while setting it higher may make the  repro-
	    jection unbearably slow.

     --interpolate, -i

	    Use bilinear interpolation when sampling the source image. Increases
	    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) projection
	    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+15.1.quarterly>

home | help