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
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
|
<!-- This file copyright Persistence of Vision Raytracer Pty. Ltd. 2003-2004 -->
<html>
<head>
<!-- NOTE: In order to users to help find information about POV-Ray using -->
<!-- web search engines, we ask you to *not* let them index documentation -->
<!-- mirrors because effectively, when searching, users will get hundreds -->
<!-- of results containing the same information! For this reason, the two -->
<!-- meta tags below disable archiving and indexing of this page by all -->
<!-- search engines that support these meta tags. -->
<meta content="noarchive" name="robots">
<meta content="noindex" name="robots">
<meta content="no-cache" http-equiv="Pragma">
<meta content="0" http-equiv="expires">
<title>1.3.6 Rendering the Sample Scenes</title>
<link href="povray35.css" rel="stylesheet" type="text/css">
</head>
<body>
<table class="NavBar" width="100%">
<tr>
<td align="left" nowrap="" valign="middle" width="32">
<a href="s_20.html"><img alt="previous" border="0" src="prev.png"></a>
</td>
<td align="left" valign="middle" width="30%">
<a href="s_20.html">1.3.5 Tutorials</a>
</td>
<td align="center" valign="middle">
<strong class="NavBar">POV-Ray 3.6 for UNIX documentation</strong><br> <strong>1.3.6
Rendering the Sample Scenes</strong>
</td>
<td align="right" valign="middle" width="30%">
<a href="s_22.html">1.3.7 POV-Ray for Unix Tips</a>
</td>
<td align="right" nowrap="" valign="middle" width="32">
<a href="s_22.html"><img alt="next" border="0" src="next.png"></a>
</td>
</tr>
</table>
<h3><a name="s01_03_06">1.3.6 </a>Rendering the Sample Scenes</h3>
<p>
POV-Ray for Unix comes with a set of shell scripts to automatically render the sample scenes coming with POV-Ray.
</p>
<p>
These shell scripts are usually installed in <code>/usr/local/share/povray-3.6/scripts</code>. They require a bash
compatible shell. There are three scripts that are supposed to be called by the user.
</p>
<ul>
<li>
<p>
<code>allscene.sh</code>:
</p>
<p>
renders all stills. The syntax is:
</p>
<pre>allscene.sh [log] [all] [-d scene_directory] [-o output_directory] [-h html_file]</pre>
<p>
If <code>html_file</code> is specified a HTML listing of the rendered scenes is generated. if <a href="http://www.imagemagick.org/" target="new">ImageMagick</a>
is installed the listing will also contain thumbnails of the rendered images.
<li>
<p>
<code>allanim.sh</code>:
</p>
<p>
renders all animations. The syntax is:
</p>
<pre>allanim.sh [log] [-d scene_directory] [-o output_directory] [-h html_file]</pre>
<p>
If <a href="http://ffmpeg.sourceforge.net/" target="new">ffmpeg</a> is installed the script will compile mpeg
files from the rendered animations.
<li>
<p>
<code>portfolio.sh</code>:
</p>
<p>
renders the portfolio. The syntax is:
</p>
<pre>portfolio.sh [log] [-d scene_directory] [-o output_directory]</pre>
<p>
The portfolio is a collection of images illustrating the POV-Ray features and include files coming with the
package.
</p>
</li>
</p>
</li>
</p>
</li>
</ul>
<p>
If the option <code>log</code> is specified, a log file with the complete text output from POV-Ray is written
(filename <code>log.txt</code>)
</p>
<p>
If <code>scene_directory</code> is specified, the sample scenes in this directory are rendered, otherwise the scene
directory is determined form the main povray ini file (usually <code>/usr/local/share/povray-3.6/scenes</code>).
</p>
<p>
If <code>output_directory</code> is specified, all images are written to this directory; if it is not specified the
images are written into the scene file directories. If the directories are not writable, the images are written in the
current directory. All other files (html files, thumbnails) are written here as well.
</p>
<p>
To determine the correct render options the scripts analyze the beginning of the scene files. They search for a
comment of the form
</p>
<pre>// -w320 -h240 +a0.3</pre>
<p>
in the first 50 lines of the scene. The animation script possibly also uses an INI file with the same basename as
the scene file. The <code>allscene.sh</code> has the additional <code>all</code> option which - if specified - renders
also scenes without such an options comment (using default options then).
</p>
<br>
<table class="NavBar" width="100%">
<tr>
<td align="left" nowrap="" valign="middle" width="32">
<a href="s_20.html"><img alt="previous" border="0" src="prev.png"></a>
</td>
<td align="left" valign="middle" width="30%">
<a href="s_20.html">1.3.5 Tutorials</a>
</td>
<td align="center" valign="middle">
<strong>1.3.6 Rendering the Sample Scenes</strong>
</td>
<td align="right" valign="middle" width="30%">
<a href="s_22.html">1.3.7 POV-Ray for Unix Tips</a>
</td>
<td align="right" nowrap="" valign="middle" width="32">
<a href="s_22.html"><img alt="next" border="0" src="next.png"></a>
</td>
</tr>
</table>
</body> </html>
|
