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)