NAME

glodInstanceObject - Creates a new instance of an existing GLOD object.

C SPECIFICATION

void glodInstanceObject(GLuint name, GLuint instancename, GLuint groupname)

PARAMETERS

name

The source object to be duplicated

instancename

The new object name. Keep in mind, object names are global, and cannot be repeated, even if the object will be in a different group.

groupname

The name of the group in which this object will reside. If groupname does not yet exist, it will be created with default parameters. See glodNewGroup for more details.

DESCRIPTION

This call allows you to create a copy of an existing object without duplicating the memory it uses for geometry storage. This is useful for those cases where you want to independently adapt an object depending on its position in your scene.

Keep in mind, an instanced object has its own adaptation state. That means that calling glodAdaptGroup will affect only the instances in that particular group.

ERRORS

GLOD_INVALID_NAME is generated if name doesn't exist, or if instancename already exists.

GLOD_INVALID_STATE if generated if the object named name has not been compiled using glodBuildObject() or loaded with glodLoadObject()