Scene Description Language

# 6.0 Scene Description Language

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 `+I`file 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_DIRECTIVES        |
        camera { CAMERA_ITEMS... } |
        OBJECTS                    |
        ATMOSPHERIC_EFFECTS        |
        global_settings { GLOBAL_ITEMS }

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 "Atmospheric Effects" and section "Global Settings" for details.

In 'Scene Description Language' ...
6.1 | Language Basics
6.2 | Language Directives
6.3 | POV-Ray Coordinate System
6.4 | Camera
6.5 | Objects
6.6 | Interior
6.7 | Textures
6.8 | Media
6.9 | Atmospheric Effects
6.10 | Photons
6.11 | Global Settings