Ovis_3D_Area_Texture_Get()
Abstract
Gets information about the texture applied to a 3D area.
Syntax
Ovis_3D_Area_Point_Array_Get (area_dec_ptr, texture_dir_pptr, texture_file_pptr, tile_count_ptr)
| Argument | Type | Description |
|---|---|---|
area_dec_ptr |
OvisT_3D_Area * |
Area of interest |
texture_dir_pptr |
char ** |
Memory to be filled with directory path for texture file |
texture_file_pptr |
char ** |
Memory to be filled with name (including extension) of texture file |
tile_count_ptr |
unsigned int * |
Memory to be filled with the tiling division being used |
Return Type
OvisT_Compcode
OvisC_Compcode_Success if the texture information is obtained; OvisC_Compcode_Failure otherwise.
Header
ovis_decoration.h
Details
For a description of 3D area textures, see the Details section of Ovis_3D_Area_Texture_Set().
Example
OvisT_3D_Area * area;
char * tex_dir;
char * tex_file;
unsigned int tex_tiles;
OvisT_Compcode status;
/* … area created at some point */
status = Ovis_3D_Area_Texture_Get (area, &tex_dir, &tex_file, &tex_tiles);
Errors
- Decoration is NIL.
- Return address for texture directory is NIL.
- Return address for tile count is NIL.
- Decoration is not a 3D area.
Reference
- Use the function
Ovis_3D_Area_Texture_Set()to specify a texture to be applied to a 3D area.