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