The SceneGraph3D Description Language

Index

directory

Derived from:

Class name:

Placement:

Within the world node

Description:

Defines an additional search path for any file seek operation required. This includes the search of all files immediately referenced by the scene graph (e.g. a 3D mesh file declared as input to an object node), and all indirect subsequent load operations (in this example, the texture bitmaps referenced by the mesh file). It helps organize the scenes and assets in logical groups and make them more portable. By default, only the current directory is included in the search path. Note that this is not a regular scene graph node. It is only valid as a child of the world node and its values are parsed and directly stored in the later.

Special notes:

Inherited attributes:

New attributes:

attribute	type	description
path	STRING	Turns the node and all its children (if any) on or off. When a node is switched off, all processing is suspended, except the message passing mechanism. In the case of the world special node, time keeping continues, even if the node is suspended. Default value is true.

Events:

event name	condition
-

Inherited events:

New messages:

attribute

value

description

Inherited messages:

Redefined messages:

Obsolete messages:

Example

<world ambient="0.3 0.3 0.3" defocus="no" shadows="disk">
  
    <directory path=".\arena"></directory>
    <directory path=".\scripts"></directory>
    <directory path=".\sounds"></directory>
    
    <transformation name="environment" scale="1.0,1.0,1.0" translation="0,0,-10">
        
        <object name="geom2" file="arena.obj"></object>
    
    </transformation>
    
    <object name="geom1" file="fighter.obj"></object>
    
</world>

Last update: 6 Feb. 2009