Difference between revisions of "Reference:Scene Description Language"

From POV-Wiki
Jump to navigation Jump to search
m (1 revision: Reference Migration Initial Load)
m (link repair)
Line 15: Line 15:
 
then renders the scene.</p>
 
then renders the scene.</p>
 
<p>
 
<p>
The overall syntax of a scene is shown below. See <!--<linkto "Notation and Basic Assumptions">Notation and Basic Assumptions</linkto>--->[[Reference:Notation_and_Basic_Assumptions|Notation and Basic Assumptions]]
+
The overall syntax of a scene is shown below. See [[Reference:Notation and Basic Assumptions|Notation and Basic Assumptions]]
 
for more information on syntax notation.</p>
 
for more information on syntax notation.</p>
 
<pre>
 
<pre>
Line 36: Line 36:
 
restrictions on nesting directives also.</p>
 
restrictions on nesting directives also.</p>
 
<p>
 
<p>
For details on those five items see section [[Reference:Language Directives|Language Directives]], section [[Reference:Object|:Object|Objects]], section [[Reference:Camera|:Camera|Camera]], section [[Atmospheric Effects|:Atmospheric Effects|Atomospheric Effects]] and section [[Global Settings|:global_settings|Global Settings]] for details.</p>
+
For details on those five items see section [[Reference:Language Directives|Language Directives]], section [[Reference:Object|:Object|Objects]], section [[Reference:Camera|:Camera|Camera]], section [[Reference:Atmospheric Effects|:Atmospheric Effects|Atomospheric Effects]] and section [[Reference:Global Settings|:global_settings|Global Settings]] for details.</p>
 
 
==Language Basics==
 
<p>The POV-Ray language consists of identifiers, reserved keywords, floating
 
point expressions, strings, special symbols and comments. The text of a
 
POV-Ray scene file is free format. You may put statements on separate lines
 
or on the same line as you desire. You may add blank lines, spaces or
 
indentations as long as you do not split any keywords or identifiers.</p>
 

Revision as of 09:54, 12 July 2012

The reference section describes the POV-Ray scene description language. It is supposed to be used as a reference for looking up things. It does not contain detailed explanations on how scenes are written or how POV-Ray is used. It just explains all features, their syntax, applications, limits, drawbacks, etc.

The scene description language allows you to describe the world in a readable and convenient way. Files are created in plain ASCII text using an editor of your choice. The input file name is specified using the Input_File_Name=file option or +Ifile switch. By default the files have the extension .pov. POV-Ray reads the file, processes it by creating an internal model of the scene and then renders the scene.

The overall syntax of a scene is shown below. See Notation and Basic Assumptions for more information on syntax notation.

SCENE:
  SCENE_ITEM...
SCENE_ITEM:
  LANGUAGE_DIRECTIVE |
  CAMERA             |
  LIGHT              |
  OBJECT             |
  ATMOSPHERIC_EFFECT |
  GLOBAL_SETTINGS

In plain English, this means that a scene contains one or more scene items and that a scene item may be any of the five items listed below it. The items may appear in any order. None is a required item. In addition to the syntax depicted above, a LANGUAGE_DIRECTIVE may also appear anywhere embedded in other statements between any two tokens. There are some restrictions on nesting directives also.

For details on those five items see section Language Directives, section Objects, section Camera, section Atomospheric Effects and section Global Settings for details.