几何渲染器（Geometry-Renderer）

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

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

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

其中：

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

接口描述

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

支持的几何体类型

类型	接口
虚线	addDashedLine
线段	addLine
三角形	addTriangle
四边形	addQuad
轴对齐包围盒	addBoundingBox
交叉点	addCross
视锥	addFrustum
胶囊体	addCapsule
圆柱	addCylinder
圆锥	addCone
圆形	addCircle
弧形	addArc
任意多边形	addPolygon
圆盘	addDisc
扇形	addSector
球体	addSphere
环面	addTorus
八面体	addOctahedron
贝塞尔曲线	addBezier
样条曲线，包含三种模式：折线段，多段贝塞尔曲线，Catmull-Rom 曲线	addSpline
网格线框	addMesh
基于索引的网格线框	addIndexedMesh

使用方式

由于每帧渲染完这些几何体后会清空顶点缓存，所以需要在 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);
    }
}

运行结果如下：