Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

pfspanoramic(1) [debian man page]

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 (latitude-longitude), angular (light probe), mirrorball and cylindri-
       cal are supported. The syntax for specifying the transformation is source_projection+target_projection, where source_projection is the cur-
       rent 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 quality in areas that are scaled down with respect to the source image.
	      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. 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)

Check Out this Related Man Page

pfspad(1)						      General Commands Manual							 pfspad(1)

NAME

       pfspad - Add borders to a frame in PFS stream

SYNOPSIS

       pfspad  [--left	<columns>]  [--right <columns>] [--top <rows>] [--bottom <rows>] [--width <new_width>] [--height <new_height>] [--R <val>]
       [--G <val>] [--B <val>] [--Y <val>] [--help]

DESCRIPTION

       Add borders to each frame in PFS stream. User specifies size of left, right, top and bottom border or size of an  output  image.  Color	of
       borders can be specified as well.

OPTIONS

       --left <columns>, -l <columns>
	      Width in pixels of the left border.

       --right <columns>, -r <columns>
	      Width in pixels of the right border.

       --top <rows>, -t <rows>
	      Height in pixels of the top border.

       --bottom <rows>, -b <rows>
	      Height in pixels of the bottom border.

       --width <new_width>, -W <new_width>
	      Width of an output image. Note that --width can be mixed with either --left or --right option.

       --height <new_height>, -H <new_height>
	      Height of an output image. Note that --height can be mixed with either --top or --bottom option.

       --R <val>, -R <val>, --G <val>, -G <val>, --B <val>, -B <val>
	      Color of borders in RGB mode. Default color is black, and if some of the components is not specified, its value is set to 0.0.

       --Y <val>, -Y <val>
	      Color of borders in luminance mode.

       --help, -h
	      Print a list of commandline options.

EXAMPLES

       pfsin image.hdr | pfspad --left 50 --bottom 20 | pfsout out.hdr
	      Add 50 columns to the left and 20 rows to the bottom side of image.hdr.  Color of borders is default black.

       pfsin image.hdr | pfspad --top 20 --height 500 --width 400 --R 1.0 | pfsout out.hdr
	      Add 20 rows to the top side of image.hdr and create output image out.hdr 500 pixels in height and 400 pixels in width. Color of bor-
	      ders is set to red.

SEE ALSO

       pfsin(1) pfsout(1)

BUGS

       Please report bugs and comments to Dorota Zdrojewska <dzdrojewska@wi.ps.pl>.

																	 pfspad(1)
Man Page