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
|
<!-- 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>3.1.1 Notation and Basic Assumptions</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_93.html"><img alt="previous" border="0" src="prev.png"></a>
</td>
<td align="left" valign="middle" width="30%">
<a href="s_93.html">3.1 Introduction</a>
</td>
<td align="center" valign="middle">
<strong class="NavBar">POV-Ray 3.6 for UNIX documentation</strong><br> <strong>3.1.1
Notation and Basic Assumptions</strong>
</td>
<td align="right" valign="middle" width="30%">
<a href="s_95.html">3.1.2 Command-line Options</a>
</td>
<td align="right" nowrap="" valign="middle" width="32">
<a href="s_95.html"><img alt="next" border="0" src="next.png"></a>
</td>
</tr>
</table>
<h3><a name="s03_01_01">3.1.1 </a>Notation and Basic Assumptions</h3>
<p>
Throughout the tutorial and reference books, the consistent notation is used to mark keywords of the scene
description language, command line switches, INI file keywords and file names. All POV-Ray scene descriptionlanguage
keywords, punctuation and command-line switches are mono-spaced. For example <code>sphere</code>, <code>4.0 * sin(45.0)</code>
or <code>+W640 +H480</code>. Syntax descriptions are mono-spaced and all caps. For example required syntax items are
written like <code>SYNTAX_ITEM</code>, while optional syntax items are written in square braces like <code>[SYNTAX_ITEM]</code>.
If one or more syntax items are required, the ellipsis will be appended like <code>SYNTAX_ITEM...</code>. In case zero
or more syntax items are allowed, the syntax item will be written in square braces with appended ellipsis like <code>[SYNTAX_ITEM...]</code>.
A float value or expression is written mixed case like <code>Value_1</code>, while a vector value or expression is
written in mixed case in angle braces like <code><Value_1></code>. Choices are represented by a vertical bar
between syntax items. For example a choice between three items would be written as <code>ITEM1 | ITEM2 | ITEM3</code>.
Further, a certain lists and arrays also require square braces as part of the language rather than the language
description. When square braces are required as part of the syntax, they will be separated from the contained syntax
item specification with a spaces like <code>[ ITEM ]</code>.
</p>
<p class="note">
<strong>Note:</strong> POV-Ray is a command-line program on Unix and other text-based operating
systems and is menu-driven on Windows and Macintosh platforms. Some of these operating systems use folders to store
files while others use directories. Some separate the folders and sub-folders with a slash character (<code>/</code>),
back-slash character (<code>\</code>), or others.
</p>
<p>
We have tried to make this documentation as generic as possible but sometimes we have to refer to folders, files,
options etc. and there is no way to escape it. Here are some assumptions we make...
</p>
<ol>
<li>
You installed POV-Ray in the "<code>C:\POVRAY36</code>" directory. For MS-Dos this is probably true but
for Unix it might be "<code>/usr/povray3</code>", or for Windows it might be "<code>C:\Program
Files\POV-Ray for Windows v3.6</code>", for Mac it might be "<code>MyHD:Apps:POV-Ray 36:</code>", or
you may have used some other drive or directory. So if we tell you that "Include files are stored in the <code>\povray36\include</code>
directory," we assume you can translate that to something like "<code>::POVRAY36:INCLUDE</code>" or
"<code>C:\Program Files\POV-Ray for Windows v3.6\include</code>" or whatever is appropriate for your
platform, operating system and installation.
</li>
<li>
POV-Ray uses INI files and/or command-line switches (if available) to choose options in all versions, but Windows
and Mac also use dialog boxes or menu choices to set options. We will describe options assuming you are using
switches or INI files when describing what the options do. We have taken care to use the same terminology in
designing menus and dialogs as we use in describing switches or INI keywords. See your version-specific documentation
on menu and dialogs.
</li>
<li>
Some of you are reading this using a help-reader, built-in help, web-browser, formatted printout, or plain text
file. We assume you know how to get around in which ever medium you are using. We will say "See the chapter on
"<a href="s_64.html#s02_02_08">Setting POV-Ray Options</a>" we assume you can click, scroll, browse, flip
pages or whatever to get there.
</li>
</ol>
<br>
<table class="NavBar" width="100%">
<tr>
<td align="left" nowrap="" valign="middle" width="32">
<a href="s_93.html"><img alt="previous" border="0" src="prev.png"></a>
</td>
<td align="left" valign="middle" width="30%">
<a href="s_93.html">3.1 Introduction</a>
</td>
<td align="center" valign="middle">
<strong>3.1.1 Notation and Basic Assumptions</strong>
</td>
<td align="right" valign="middle" width="30%">
<a href="s_95.html">3.1.2 Command-line Options</a>
</td>
<td align="right" nowrap="" valign="middle" width="32">
<a href="s_95.html"><img alt="next" border="0" src="next.png"></a>
</td>
</tr>
</table>
</body> </html>
|
