本插件提供C封装的接口函数库,可以通过动态链接的方式,将插件集成到游戏项目中。
HcSetResolution函数可以为depth buffer设置分辨率。传入的分辨率必须是2的倍数,否则设置无效,并返回错误码HcErrorCode。
const unsigned int alignedWidth = 400; const unsigned int alignedHeight = 200; CHECK_RESULT(HcSetResolution(obj, alignedWidth, alignedHeight));
Occluder由数据结构HcOccluderMeshType描述,其中包含以下成员。
HcOccluderMeshType occluders = { .numMesh = 1, .meshes = &mesh, .bWinding = HC_CCW,
.idxType = HC_UNSIGNED_SHORT, .vtxStride = case0VtxStride,
.nearClipDistance = 0.1f };
其中HcMeshType在构造时需要设置以下成员。
HcMeshTypemesh = { .vertices = vertices, .nVertices = case0VerticesNum,
.indices = indices, .nIndices = case0IndicesNum };
MatrixCopy(mesh.localToClip, ProjectionMatrix * ViewMatrix * WorldMatrix, MATRIX_DIMENSIONS); Occludee由数据结构HcOccludeeBoxType描述,其中包含以下成员。
HcOccludeeBoxType occludees = { .numBox = OCCLUDEE_BOX_NUM, .boxMinMax = aabb };
MatrixCopy(occludees.worldToClip, ProjectionMatrix * ViewMatrix, MATRIX_DIMENSIONS);
投影矩阵需要将近平面和远平面[zn, zf]映射到[1, 0]的区间,对于右手坐标系下的透视投影而言,可以使用如下投影矩阵。其中,Zn是近平面的位置,W是近平面的宽度,H是近平面的高度。

把Occluder添加到遮挡剔除模块,然后光栅化。示例代码如下。
// 将occluders添加到遮挡剔除模块中 CHECK_RESULT(HcAddOccluderMeshes(obj, occluders)); // 将occluders光栅化到depth buffer中,用于遮挡查询 CHECK_RESULT(HcRasterizeOccluder(obj));
对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]);