Ovis_Layer_Decoration_Add()
Abstract
Adds a decoration to the Ovis layer.
Syntax
Ovis_Layer_Decoration_Add (layer_ptr, dec_ptr)
| Argument | Type | Description |
|---|---|---|
layer_ptr |
OvisT_Layer * |
Ovis layer |
dec_ptr |
OvisT_Decoration * |
Ovis decoration |
Return Type
OvisT_Compcode
OvisC_Compcode_Success if the decoration can be added to the layer; OvisC_Compcode_Failure otherwise.
Header
ovis_layer.h
Details
This function adds the decoration to the layer. When a decoration is created, you can specify an initial layer. Decorations can belong to multiple layers.
Example
OvisT_Layer * layer;
OvisT_3D_Sphere * sphere;
/* layer and sphere created elsewhere */
Ovis_Layer_Decoration_Add (layer, sphere);
Errors
- Layer is NIL.
- Decoration is NIL
Reference
- Use the function
Ovis_Layer_Decoration_Remove()to remove a decoration from a layer. - Use the function
Ovis_Layer_Child_Decoration_Count()to obtain the number of child decorations. - Use the function
Ovis_Layer_Child_Decoration_Nth()to retrieve a child decoration of a layer.