Ovis_3D_Area_Texture_Get()
摘要
获取应用于 3D 区域的纹理信息。
语法
Ovis_3D_Area_Point_Array_Get (area_dec_ptr, texture_dir_pptr, texture_file_pptr, tile_count_ptr)
| 参数 | 类型 | 说明 |
|---|---|---|
area_dec_ptr |
OvisT_3D_Area * |
目标区域 |
texture_dir_pptr |
char ** |
用于存放纹理文件目录路径的内存 |
texture_file_pptr |
char ** |
用于存放纹理文件名称(含扩展名)的内存 |
tile_count_ptr |
unsigned int * |
用于存放所用平铺划分数量的内存 |
返回类型
OvisT_Compcode
若成功获取纹理信息,返回 OvisC_Compcode_Success;否则返回 OvisC_Compcode_Failure。
头文件
ovis_decoration.h
详情
关于 3D 区域纹理的说明,请参见 Ovis_3D_Area_Texture_Set() 的详情小节。
示例
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);
错误
- 装饰对象为 NIL。
- 用于返回纹理目录的地址为 NIL。
- 用于返回平铺分数量的地址为 NIL。
- 装饰对象不是 3D 区域。
参考
- 使用函数
Ovis_3D_Area_Texture_Set()可指定应用于 3D 区域的纹理。