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 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 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)