The first thing most people want to do with DSS is manipulate the objects showing in the scene.
If you're up to reading this API, you should know how to load objects into the scene through the .scene file format. See the Wiki for more information on this. For a detailed explanation on how the scene-graph works, see the SceneGraph section.
In these examples we will be using Python, and will be using classes. These examples will be much clearer if you already have an understanding of the Python language and its object orientated design. See http://docs.python.org/ for more information.
The Digital Spaces API is available through the dss_core Python module. This is loaded into the Python interpreter by the Script_Python module, and thus is always available, in the global scope. There is no need to import dss_core.
In the below examples, Python specific logic is commented in-line (with """ or #), while Digital Spaces specific logic is commented in a different text style.
See
http://www.digitalspaces.net/wiki/index.php/Basic_motion_in_Python for a tutorial example script describing how to move an object in the scenegraph using Python.
See
http://www.digitalspaces.net/wiki/index.php/Basic_rotation_in_Python for a more complex example, showing how to rotate an object in the scenegraph using Python.
See
http://www.digitalspaces.net/wiki/index.php/Tracking_a_physics_object_in_Python for an example showing how to access the physics representation of a scene node.
See
http://www.digitalspaces.net/wiki/index.php/Tracking_physics_collisions_in_Python for an example showing how to track physics collisions that have occured.
See
http://www.digitalspaces.net/wiki/index.php/Setting_physics_collision_properties_in_Python for an example showing how to pre-set the contact properties applied to certain physics collisions.
See
http://www.digitalspaces.net/wiki/index.php/Altering_physics_behaviour_in_Python for an example showing how to get a callback for physics collisions, allowing logic at run time.
All these examples can be see at http://www.digitalspaces.net/wiki/index.php/Documentation/Tutorials .
