Ovis_Entity_Child_Entity_Nth()
Abstract
Returns the n-th child entity associated with an entity.
Syntax
Ovis_Entity_Child_Entity_Nth (entity_ptr, child_index)
| Argument | Type | Description |
|---|---|---|
entity_ptr |
OvisT_Entity * |
Ovis entity |
child_index |
unsigned int |
Index of the child entity |
Return Type
OvisT_Entity *
Pointer to the child entity
Header
ovis_entity.h
Details
This function returns the n-th child entity associated with the entity. In 3D Network Visualizer, this relationship is shown by having the child entities displayed in a subtree of the parent entity.
Example
OvisT_Entity * parent,* child;
unsigned int count, i;
/* …parent entity created elsewhere */
count = Ovis_Entity_Child_Entity_Count (parent);
for (i = 0; i < count; i++)
{
child = Ovis_Entity_Child_Entity_Nth (parent, i);
/* … do something with child entity */
}
Errors
- Entity is NIL.
Reference
- Use the function Ovis_Entity_Child_Entity_Count() to retrieve the number of child entities of an entity.