man/man1/pmdblur.1
author Axel Jacobs <axel@jaloxa.eu>
Sun, 26 Jun 2011 16:59:38 +0100
changeset 13 ccfb8a3410da
parent 12 a5d25b4668ac
permissions -rw-r--r--
Made falsecolor.pl executable.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
12
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
     1
.\" RCSid "$Id: pmdblur.1,v 1.4 2008/11/10 19:08:17 greg Exp $"
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
     2
.TH PMDBLUR 1 1/17/05 RADIANCE
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
     3
.SH NAME
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
     4
pmdblur - generate views for combined camera motion and depth blurring
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
     5
.SH SYNOPSIS
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
     6
.B pmdblur
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
     7
.B speed
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
     8
.B aperture
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
     9
.B nsamp
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    10
.B v0file
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    11
.B v1file
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    12
.SH DESCRIPTION
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    13
.I Pmdblur
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    14
takes two viewfiles and generates
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    15
.I nsamp
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    16
views starting from
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    17
.I v0file
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    18
and moving towards
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    19
.I v1file,
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    20
simulating an aperture of diameter
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    21
.I aperture
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    22
in world coordinate units.
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    23
When rendered and averaged together, these views will result in
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    24
a picture with motion and depth-of-field
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    25
blur due to a camera changing from v0 to v1
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    26
in a relative time unit of 1, whose shutter is open starting at v0 for
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    27
.I speed
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    28
of these time units.
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    29
Either
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    30
.I pinterp(1)
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    31
or
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    32
.I rpict(1)
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    33
may be called to do the actual work.
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    34
(The given
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    35
.I v0file
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    36
must also be passed on the command line to the chosen renderer, since
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    37
.I pmdblur
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    38
provides supplemental view specifications only.)\0
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    39
.PP
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    40
For
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    41
.I pinterp,
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    42
feed the output of
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    43
.I pmdblur
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    44
to the standard input of
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    45
.I pinterp
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    46
and apply the
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    47
.I \-B
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    48
option to blur views together.
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    49
In most cases, two pictures with z-buffers at v0 and v1 will
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    50
get a satisfactory result, though the perfectionist may wish to
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    51
apply the
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    52
.I \-ff
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    53
option together with the
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    54
.I \-fr
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    55
option of
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    56
.I pinterp.
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    57
.PP
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    58
To use
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    59
.I pmdblur
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    60
with
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    61
.I rpict,
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    62
apply the
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    63
.I \-S
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    64
option to indicate a rendering sequence, and set the
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    65
.I \-o
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    66
option with a formatted file name to save multiple output
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    67
pictures.
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    68
When all the renderings are finished, combine them with the
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    69
.I pcomb(1)
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    70
program, using appropriate scalefactors to achieve an average.
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    71
Note that using
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    72
.I rpict
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    73
is MUCH more expensive than using
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    74
.I pinterp,
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    75
and it is only recommended if the scene and application
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    76
absolutely demand it (e.g. there is prominent refraction that
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    77
must be modeled accurately).
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    78
.PP
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    79
For both
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    80
.I pinterp
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    81
and
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    82
.I rpict,
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    83
the computation time will be proportional to the number of views from
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    84
.I pmdblur.
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    85
We have found a
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    86
.I nsamp
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    87
setting somewhere between 7 and 15 to be adequate for most images.
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    88
Relatively larger values are appropriate for faster camera motion.
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    89
.PP
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    90
The
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    91
.I \-pm
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    92
and/or
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    93
.I \-pd
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    94
options of
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    95
.I rpict
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    96
may be used instead or in combination to blur animated frames, with
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    97
the added advantage of blurring reflections and refractions according
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    98
to their proper motion.
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    99
However, this option will result in more noise and expense than using
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
   100
.I pmdblur
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
   101
with
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
   102
.I pinterp
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
   103
as a post-process.
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
   104
If both blurring methods are used, a smaller value should be given to the
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
   105
.I rpict
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
   106
.I \-pm
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
   107
option equal to the shutter speed divided by the number of samples, and the
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
   108
.I \-pd
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
   109
option equal to the aperture divided by the number of samples.
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
   110
This will be just enough to blur the boundaries of the ghosts
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
   111
which may appear using
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
   112
.I pmdblur
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
   113
with a small number of time samples.
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
   114
.PP
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
   115
To simulate a particular camera's aperture, divide the focal length of
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
   116
the lens by the f-number, then convert to the corresponding
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
   117
world coordinate units.
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
   118
For example, if you wish to simulate a 50mm lens at f/2.0 in
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
   119
a scene modeled in meters, then you divide 50mm by 2.0 to get 25mm,
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
   120
which corresponds to an effective aperture of 0.025 meters.
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
   121
.SH EXAMPLES
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
   122
To use
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
   123
.I pinterp
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
   124
to simulate motion blur between two frames of a walk-through
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
   125
animation, where the camera shutter is open for 1/4 of the
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
   126
interframe distance with an aperture of 0.1 world units:
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
   127
.IP "" .2i
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
   128
pmdblur .25 .1 8 fr1023.hdr fr1024.hdr | pinterp \-B \-vf fr1023.hdr \-x 640 \-y 480
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
   129
fr1023.hdr fr1023.zbf fr1024.hdr fr1024.zbf > fr1023b.hdr
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
   130
.SH AUTHOR
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
   131
Greg Ward
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
   132
.SH "SEE ALSO"
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
   133
pcomb(1), pdfblur(1), pinterp(1), pmblur(1), rcalc(1), rpict(1), vwright(1)