1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
|
\
.\" This man page was generated by the Netpbm tool 'makeman' from HTML source.
.\" Do not hand-hack it! If you have bug fixes or improvements, please find
.\" the corresponding HTML page on the Netpbm website, generate a patch
.\" against that, and send it to the Netpbm maintainer.
.TH "Pamshadedrelief User Manual" 1 "26 July 2014" "netpbm documentation"
.SH NAME
pamshadedrelief - generate shaded relief image from an elevation map
.UN synopsis
.SH SYNOPSIS
\fBpamshadedrelief\fP
[\fB-gamma\fP \fIg\fP]
.UN description
.SH DESCRIPTION
.PP
This program is part of
.BR "Netpbm" (1)\c
\&.
.PP
\fBpamshadedrelief\fP creates a shaded relief image from an elevation map.
A shaded relief image is a visual image of terrain, showing the terrain as if
illuminated by oblique light and viewed from above, so that the brightess of
each spot depends upon its slope. A common example of a shaded relief image
is a relief map of the Earth, which shows mountains and valleys.
.PP
The image \fBpamshadedrelief\fP creates is as if illumated by a light
source from the left.
.PP
The output image is a PAM with tuple type \fBGRAYSCALE\fP.
.PP
The program \fBpamcrater\fP is a good thing to use to demonstrate the
function of \fBpamshadedrelief\fP. It generates a terrain map of a cratered
landscape.
.nf
\f(CW
$ pamcrater | pamshadedrelief | pamx
\fP
.fi
.UN options
.SH OPTIONS
.PP
In addition to the options common to all programs based on libnetpbm
(most notably \fB-quiet\fP, see
.UR index.html#commonoptions
Common Options
.UE
\&), \fBpamshadedrelief\fP recognizes the following
command line option:
.TP
\fB-gamma\fP \fIfactor\fP
.TP
\fB-g\fP \fIfactor\fP
The specified \fIfactor\fP is used to gamma adjust the image in
the same manner as performed by \fBpnmgamma\fP. The default value is
1.0, which results in a medium contrast image. Values larger than 1
lighten the image and reduce contrast, while values less than 1 darken
the image, increasing contrast.
.sp
Note that this is separate from the gamma correction that is part of the
definition of the PAM GRAYSCALE format. The image \fBpamshadedrelief\fP
generates is a genuine, gamma-corrected PAM GRAYSCALE image in any case. This
option simply changes the contrast and may compensate for a display device
that does not correctly render PAM GRAYSCALE images.
.UN designnotes
.SH DESIGN NOTES
The\fB-gamma\fP option isn't really necessary since you can achieve
the same effect by piping the output from \fBpamshadedrelief\fP through
\fBpnmgamma\fP. However, \fBpamshadedrelief\fP performs an internal gamma
map anyway in the process of rendering the elevation array into the PAM
GRAYSCALE format, so there's no additional overhead in allowing an additional
gamma adjustment.
.UN seealso
.SH SEE ALSO
.BR "ppmrelief" (1)\c
\&
.BR "pnmgamma" (1)\c
\&,
.BR "pnmsmooth" (1)\c
\&
.BR "pamcrater" (1)\c
\&
.BR "pam" (1)\c
\&,
.UN author
.SH AUTHOR
.PP
\fBpgmcrater\fP, from which this is derived, was written by John Walker:
.nf
John Walker
Autodesk SA
Avenue des Champs-Montants 14b
CH-2074 MARIN
Suisse/Schweiz/Svizzera/Svizra/Switzerland
\fBUsenet:\fP\fIkelvin@Autodesk.com\fP
\fBFax:\fP038/33 88 15
\fBVoice:\fP038/33 76 33
.fi
.PP
Permission to use, copy, modify, and distribute this software and
its documentation for any purpose and without fee is hereby granted,
without any conditions or restrictions. This software is provided
"as is" without express or implied warranty.
.UN history
.SH HISTORY
.PP
\fBpgmcrater\fP was split into \fBpamshadedrelief\fP and \fBpamcrater\fP
in Netpbm 10.68 (September 2014). See the history section of the
\fBpamcrater\fP manual for details.
.SH DOCUMENT SOURCE
This manual page was generated by the Netpbm tool 'makeman' from HTML
source. The master documentation is at
.IP
.B http://netpbm.sourceforge.net/doc/pamshadedrelief.html
.PP
|
