Ovis_3D_Area_Texture_Set()
摘要
指定应用于 3D 区域的纹理。
语法
Ovis_3D_Area_Texture_Set (area_dec_ptr, texture_dir, texture_file, tile_count)
| 参数 | 类型 | 说明 |
|---|---|---|
area_dec_ptr |
OvisT_3D_Area * |
目标区域 |
texture_dir |
const char * |
纹理文件的目录路径 |
texture_file |
const char * |
纹理文件的名称(含扩展名) |
tile_count |
unsigned int |
要使用的平铺划分数量(参见详情) |
返回类型
OvisT_Compcode
若成功设置纹理,返回 OvisC_Compcode_Success;否则返回 OvisC_Compcode_Failure。
头文件
ovis_decoration.h
详情
纹理是被映射到 3D 区域上的图形文件。该文件可以采用以下任意图形格式:
- JPEG (.jpg)
- Microsoft Windows 位图 (.bmp)
- PNG (.png)
- Silicon Graphics 位图 (.rgb)
- TIFF (.tif)
纹理文件以 n x n 的平铺图像模式映射到所定义的区域,其中 n 由 tile_count 指定。因此,若 tile_count 为 1,则整个区域映射一份纹理;若 tile_count 为 2,则四份纹理以 2 x 2 网格映射到区域(如图 9 所示),以此类推。
图 9:3D 区域纹理平铺示例

纹理会覆盖为区域指定的其他任何选项,例如填充图案或透明度。
注意: 为区域应用纹理是一种开销很大的操作。
示例
OvisT_3D_Area * area;
OvisT_Compcode status;
/* … area created at some point */
status = Ovis_3D_Area_Texture_Set (area, "c:\textures", "my_texture.tif", 2);
错误
- 装饰对象为 NIL。
- 平铺划分数量应大于 0。
- 装饰对象不是 3D 区域。
参考
- 使用函数
Ovis_3D_Area_Texture_Get()可获取应用于 3D 区域的纹理信息。