使用stb_truetype渲染文本时黑块与颜色异常问题求助

问题详情 #

我在自研游戏引擎中基于stb_truetype实现文本绘制功能时，遇到两个无法解决的问题：

• 文本背后始终显示黑块，无法实现透明背景
• 设置十六进制颜色#FFFFFF（白色）时，文本实际显示为红色

相关代码、字体结构定义、主程序代码及问题预览图如下：

engine.h 字体结构定义 #

// 此处粘贴你的字体结构代码

引擎文本渲染核心代码 #

// 此处粘贴引擎中负责文本渲染的实现代码

主程序调用代码 #

// 此处粘贴主程序中调用文本渲染功能的代码

问题效果预览 #

操作与预期 #

• 已执行操作：在自研引擎中集成文本渲染功能
• 预期效果：文本背景完全透明，显示颜色与设置的十六进制值完全一致

针对性解决方向 #

1. 文本黑块（背景不透明）问题 #

stb_truetype生成的字形是带alpha通道的灰度图，黑块问题大概率出在混合配置或纹理格式上：

• 开启Alpha混合：若使用OpenGL渲染，必须先调用glEnable(GL_BLEND)，并设置正确的混合函数：glBlendFunc(GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA)，确保字形的alpha通道能正确控制透明度
• 使用支持alpha的纹理格式：创建字形纹理时，需选择GL_RGBA或GL_ALPHA格式。stb_truetype输出的是单通道灰度数据，需将其填充到RGBA纹理的alpha通道（RGB通道可设为目标颜色或0），或直接创建ALPHA类型的纹理
• 检查帧缓冲清除逻辑：确认渲染文本前，帧缓冲的alpha通道已被正确清除，避免背景渲染覆盖文本的透明信息

2. 颜色显示异常（白色变红色）问题 #

这种颜色通道错位的情况，通常源于颜色传递或解析环节的错误：

• 通道顺序不匹配：比如引擎将RGB格式误解析为BGR，或着色器中颜色通道顺序写反。例如传递(255,255,255)时，若着色器仅读取第一个通道（红色）作为最终颜色，就会显示红色
• 颜色值未归一化：#FFFFFF对应RGB值为(255,255,255)，若着色器期望0-1范围的浮点值，直接传递255会导致数值溢出，仅红色通道保留有效数值
• 着色器代码错误：检查片段着色器，确认是否正确使用了传入的颜色变量，比如是否误将红色通道值重复赋值给绿色、蓝色通道，或颜色变量在传递过程中被截断了部分通道

内容的提问来源于stack exchange，提问作者idkhonstly