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 区域纹理平铺示例

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 区域。

参考

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com