调试渲染器(Debug-Renderer)

调试渲染器是引擎提供的一种批量渲染屏幕文字的功能接口,主要用于调试,输出任意的文字调试信息到屏幕上。目前仅支持原生平台。

其效果图如下所示:

debug-renderer-demo

使用方式

  1. 确保在项目设置面板中,调试渲染器处于勾选状态 debug-renderer-setting

  2. 由于每帧渲染完这些文字后会清空顶点缓存,所以需要在 update 等函数中,每帧添加调试文本,示例 TS 代码如下:

  1. import { native, Vec2 } from 'cc';
  2. import { NATIVE } from 'cc/env';
  3. if (NATIVE) {
  4. native.DebugRenderer.getInstance().addText("Stanley", new Vec2(100, 100));
  5. }

C++ 接口描述

  1. void addText(const ccstd::string &text, const Vec2 &screenPos, const DebugTextInfo &info = DebugTextInfo());

其参数描述如下:

  • text:要输出的文字
  • screenPos:文字展示的位置
  • info:定义字体的样式

DebugTextInfo 可以定制输出文字的外观,其参数描述如下:

属性说明
color文字颜色
bold是否粗体
italic是否斜体
shadow是否开启阴影效果
shadowThickness阴影宽度
shadowColor阴影颜色
scale文字缩放比例