1pfspanoramic(1)             General Commands Manual            pfspanoramic(1)
2
3
4

NAME

6       pfspanoramic - Perform projective transformations of spherical images
7

SYNOPSIS

9       pfspanoramic  <source  projection>+<target  projection> [--width <val>]
10       [--height  <val>]  [--oversample  <val>]   [--interpolate]   [--xrotate
11       <angle>] [--yrotate <angle>] [--zrotate <angle>]
12

DESCRIPTION

14       Transform  spherical  maps between various projections. Currently polar
15       (latitude-longitude), angular (light probe), mirrorball and cylindrical
16       are   supported.  The  syntax  for  specifying  the  transformation  is
17       source_projection+target_projection,  where  source_projection  is  the
18       current  mapping  that  source  image uses and target_projection is the
19       projection you'd like it to be transformed to. If  the  projection  has
20       some  optional  parameters,  you  can specify them with syntax: <source
21       projection>/<argument>/...+<target projection>/<argument>/...
22
23       As of now only angular supports a parameter - angle - which defines how
24       many  degrees  from  the viewing direction the projection should cover,
25       e.g. angular+angular/angle=180 converts angular image to show only half
26       of a hemisphere around the viewing direction.
27
28

OPTIONS

30       --width <val>, -w <val>
31
32       --height <val>, -h <val>
33
34              Make  the  target  image  respectively  <val> pixels wide and/or
35              high. If only one is specified, the other is computed  from  the
36              target projection's typical W/H ratio.  If neither is specified,
37              the width is taken from the source image and height is  computed
38              as above.
39
40
41       --oversample <val>, -o <val>
42
43              Oversample  each target pixel <val>x<val> times, improving qual‐
44              ity in areas that are scaled down with  respect  to  the  source
45              image. Reasonable values are 2 to 5, while setting it higher may
46              make the reprojection unbearably slow.
47
48
49       --interpolate, -i
50
51              Use bilinear  interpolation  when  sampling  the  source  image.
52              Increases quality in magnified areas.
53
54
55       --xrotate <angle>, -x <angle>
56
57              Rotate the spherical image <angle> degrees around X axis.
58
59
60       --yrotate <angle>, -y <angle>
61
62              Rotate the spherical image <angle> degrees around Y axis.
63
64
65       --zrotate <angle>, -z <angle>
66
67              Rotate the spherical image <angle> degrees around Z axis.
68
69

EXAMPLES

71       pfsin grace_probe.hdr | pfspanoramic angular+polar -i -o 3 -y 90 -w 500
72       | pfsout grace.hdr
73
74              Transform grace angular map to polar  (latitude-longitude)  pro‐
75              jection  applying  bilinear  interpolation and 3x3 oversampling,
76              while rotating it by 90 degrees around Y axis. The image will be
77              resized  to  500x250  pixels  (as  the  polar projection has 2:1
78              width-to-height ratio) and finally saved in grace.hdr.
79
80

SEE ALSO

82       pfsin(1) pfsout(1)
83

BUGS

85       Please report bugs and comments to Miloslaw Smyk <thorgal@wfmh.org.pl>.
86
87
88
89                                                               pfspanoramic(1)
Impressum