几何渲染器（Geometry-Renderer）

几何渲染器是引擎提供的一种批量渲染各种几何体的功能接口，主要用于调试（比如显示物体的包围盒）及 Cocos Creator 的 gizmo 批量显示。

几何渲染器的效果展示如图：

几何渲染器的功能特性如图：

其中：

• solid：是否支持实心模式，如果不支持则显示线框模式
• depth test：是否支持深度测试，如果支持则被遮挡部分半透明显示，未被遮挡部分不透明显示，如果不支持则全部不透明显示
• lighting：是否支持简单光照，如果不支持就使用无光模式
• transform：是否支持变换，如果支持，开发者可传入一个变换矩阵，变换矩阵会作用到几何体的顶点上，方便显示任意坐标空间的几何体

接口描述

几何渲染器位于 geometry-render.ts 和原生 GeometryRenderer.h 内，开发者可根据需求查看。其支持的几何体描述如下：

支持的几何体类型

使用方式

由于每帧渲染完这些几何体后会清空顶点缓存，所以需要在 update 等函数中，每帧往 geometry renderer 对象（位于 camera 中）添加几何体，除此之外不需要额外的操作。

在使用此功能时需要在 项目设置 -> 功能剪裁 内启用 几何渲染器：

注意：请确保您的工程是基于 3D 的。

代码示例如下：

import { _decorator, Component, Camera, Color } from 'cc';
const { ccclass, property, executeInEditMode} = _decorator;
@ccclass('Geometry')
@executeInEditMode(true)
export class Geometry extends Component {
    @property(Camera)
    mainCamera:Camera = null;
    start() {        
        this.mainCamera?.camera.initGeometryRenderer();
    }
    update(deltaTime: number) {
        this.mainCamera?.camera?.geometryRenderer?.addCircle(this.node.worldPosition, 1, Color.GREEN, 20);
    }
}

运行结果如下：