Geometry Objects

This section will explain geometry objects and how they interact with the VisioDevKit 3D module.

  1. What are geometry objects?
  2. Creating an object
  3. Adding the object to the scene
  4. Removing the object from the 3D module

What are geometry objects?

A geometry object is an abstraction of the different types of objects that can be added to the VisioDevKit 3D module. A geometry object derives from Vg3DModule::VgIGeometry and the types of objects supported are described by Vg3DModule::Vg3DModule::VgIGeometryType.

Creating an object

To create an object we first need to populate it's descriptor. A descriptor is a struct which contains the description for a given object. For example, for the Vg3DModule::VgPointDescriptor descriptor, we may want to associate an icon to display. There are several descriptors available depending on what geometry type is desired, see Vg3DModule for the available descriptors. A descriptor is availble for each geometry type, see Vg3DModule::VgIGeometryType.

Once the descriptor has been populated, we use the VgEngine::VgInstanceFactory to instantiate our geometry object.

Adding the object to the scene

When we want to add the object to the scene they need to be associated with a VgEngine::VgLayer.

Only when a layer is visible will the associated geometry objects be visible.

Removing the object from the 3D module

To remove the Vg3DModule::VgIGeometry object from the scene, we can simply deallocate the object. The other option is to set its associated layer to NULL. This might be useful if it's desired to re-add the object to another layer at a later point.

Next

VisioDevKit 2.0, Visioglobe® 2013