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)