目录

调用C接口

本插件提供C封装的接口函数库,可以通过动态链接的方式,将插件集成到游戏项目中。

创建Hiculling对象

在使用遮挡剔除功能之前,需要先调用HcCreate接口创建HiCulling对象。

HiCulling* obj = HcCreate(true);

设置HcSetResolution参数

HcSetResolution函数可以为depth buffer设置分辨率。传入的分辨率必须是2的倍数,否则设置无效,并返回错误码HcErrorCode。

const unsigned int alignedWidth = 400;
const unsigned int alignedHeight = 200;
CHECK_RESULT(HcSetResolution(obj, alignedWidth, alignedHeight));

设置Occluder和Occludee

Occluder由数据结构HcOccluderMeshType描述,其中包含以下成员。

HcOccluderMeshType occluders = { .numMesh = 1, .meshes = &mesh, .bWinding = HC_CCW, 
                                 .idxType = HC_UNSIGNED_SHORT, .vtxStride = case0VtxStride, 
                                 .nearClipDistance = 0.1f };

其中HcMeshType在构造时需要设置以下成员。

Occludee由数据结构HcOccludeeBoxType描述,其中包含以下成员。

投影矩阵需要将近平面和远平面[zn, zf]映射到[1, 0]的区间,对于右手坐标系下的透视投影而言,可以使用如下投影矩阵。其中,Zn是近平面的位置,W是近平面的宽度,H是近平面的高度。

对Occluder光栅化

把Occluder添加到遮挡剔除模块,然后光栅化。示例代码如下。

// 将occluders添加到遮挡剔除模块中
CHECK_RESULT(HcAddOccluderMeshes(obj, occluders));
// 将occluders光栅化到depth buffer中,用于遮挡查询 
CHECK_RESULT(HcRasterizeOccluder(obj));

对Occludee遮挡查询

对Occludee做遮挡查询,并把结果返回到result中。示例代码如下。

bool visibility[4] = { true };
bool* result[] = { &visibility[0], &visibility[1], &visibility[2], &visibility[3] };
// 利用depth buffer对occludees的AABB(轴对齐包围盒)做遮挡查询 
CHECK_RESULT(HcTestOccludeesAABB(obj, occludees, result));
// 在遮挡查询完成后,清空depth buffer 
CHECK_RESULT(HcClearBuffer(obj));
// 输出遮挡查询结果 
printf("aabb0: %d, aabb1: %d, aabb2: %d, aabb3: %d\n\n",
        visibility[0], visibility[1], visibility[2], visibility[3]);

销毁HiCulling对象

使用结束后,调用HcDestroy销毁对象。

HcDestroy(obj);