man/man1/compamb.1
author Axel Jacobs <axel@jaloxa.eu>
Sun, 11 Dec 2011 23:02:02 +0000
changeset 33 02f1d30160d0
parent 12 a5d25b4668ac
permissions -rw-r--r--
Started compamb
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: compamb.1,v 1.3 2007/09/04 17:36:40 greg Exp $"
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
     2
.TH COMPAMB 1 1/23/98 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
compamb - compute good ambient value for a rad input file
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 compamb
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
     7
[
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
     8
.B \-c
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
     9
][
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    10
.B \-e
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    11
]
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    12
.B rad_input_file
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    13
.SH DESCRIPTION
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    14
.I Compamb
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    15
computes a good ambient value for the specified
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    16
.I rad(1)
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    17
variable file and appends it to the file as a "render= \-av" option.
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    18
If the
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    19
.I \-c
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    20
option is specified, then
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    21
.I compamb
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    22
includes color information in the computed ambient value, rather than
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    23
estimating a grey value to avoid rendering color shifts.
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    24
If the
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    25
.I \-e
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    26
option is specified, then
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    27
.I compamb
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    28
also computes a good exposure value for this scene, and appends it to
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    29
the
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    30
.I rad
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    31
file as well.
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    32
.PP
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    33
.I Compamb
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    34
is a shell script that makes calls to other RADIANCE programs and utilities
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    35
to do the actual work.
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    36
A substantial amount of time may be required to complete this script, since
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    37
.I compamb
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    38
calls
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    39
.I rpict(1)
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    40
to render low resolution frames for each view in the
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    41
.I rad
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    42
file, setting "QUALITY=High" to compute interreflections.
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    43
The resulting ambient file is thrown away, since it would disagree
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    44
with the new \-av setting used for the final renderings.
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    45
This method is preferable to setting the
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    46
.I \-aw
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    47
option of
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    48
.I rpict,
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    49
which frequently results in splotchy artifacts.
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    50
.SH AUTHOR
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    51
Greg Ward Larson
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    52
.SH "SEE ALSO"
a5d25b4668ac Added all existing man pages from HEAD-20110626.
Axel Jacobs <axel@jaloxa.eu>
parents:
diff changeset
    53
lookamb(1), rad(1), rpict(1)