Cocos Creator:调试渲染器(Debug-Renderer)

Cocos Creator:调试渲染器(Debug-Renderer)
推荐:将NSDT场景编辑器加入你的3D工具链
3D工具集:NSDT简石数字孪生

调试渲染器(Debug-Renderer)

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

其效果图如下所示:

debug-renderer-demo

使用方式

  1. 确保在项目设置面板中,调试渲染器处于勾选状态
debug-renderer-setting
  1. 由于每帧渲染完这些文字后会清空顶点缓存,所以需要在 update 等函数中,每帧添加调试文本,示例 TS 代码如下:
import { native, Vec2 } from 'cc';
import { NATIVE } from 'cc/env';

if (NATIVE) {
    native.DebugRenderer.getInstance().addText("Stanley", new Vec2(100, 100));
}

C++ 接口描述

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

其参数描述如下:

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

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

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

3D建模学习工作室 翻译整理,转载请注明出处!

上一篇:Cocos Creator:几何渲染器(Geometry-Renderer) (mvrlink.com)

下一篇:Cocos Creator:渲染排序说明 (mvrlink.com)

NSDT场景编辑器 | NSDT 数字孪生 | GLTF在线编辑器 | 3D模型在线转换 | UnrealSynth虚幻合成数据生成器 | 3D模型自动纹理化工具
2023 power by nsdt©鄂ICP备2023000829号