QText2DEntity不渲染及背景不透明问题排查求助

问题一：窗口重置后QText2DEntity偶现无法渲染 #

• 彻底清理旧资源：重置窗口时，确保旧的Qt3DWindow、场景根实体QEntity及所有子实体（包括QText2DEntity）都被完全delete，避免残留资源与新窗口冲突。不要只移除Widget而不释放Qt3D内部对象。
• 调整实体创建时机：将动态创建QText2DEntity的逻辑延迟到m_view->setRootEntity(m_scene)之后，或者监听Qt3DWindow::frameGraphInitialized信号，待渲染上下文完全初始化后再创建文本实体。
• 验证实体层级关系：创建QText2DEntity后，检查它的父实体是否正确、父实体是否已加入场景根实体。可以通过打印textEntity->parent()和m_scene->children()确认层级无误。
• 调整渲染策略：当前设置了OnDemand渲染策略，重置后可能缺少触发渲染的条件。临时切换为Qt3DRender::QRenderSettings::AlwaysOn测试，若文本显示正常，再通过手动调用m_view->requestUpdate()触发渲染。
• 显式加载字体：创建QText2DEntity时，显式指定字体文件路径（如textEntity->setFont(QFont(":/fonts/xxx.ttf"))），避免依赖系统默认字体的加载异常。

问题二：QText2DEntity背景透明度异常 #

• 自定义透明材质：给QText2DEntity的背景部分设置QPhongAlphaMaterial，并将alpha()设为0：

  auto alphaMaterial = new Qt3DExtras::QPhongAlphaMaterial(textEntity);
  alphaMaterial->setAlpha(0.0f);
  textEntity->addComponent(alphaMaterial);
  

• 确保纹理带alpha通道：手动创建背景纹理时，设置QTexture2D的格式为Qt3DRender::QTexture2D::RGBA8_UNorm，保证透明通道有效。
• 调整渲染状态：给QText2DEntity添加QRenderStateSet，禁用深度测试或设置正确的混合模式：

  auto renderStateSet = new Qt3DRender::QRenderStateSet(textEntity);
  auto depthTest = new Qt3DRender::QDepthTest();
  depthTest->setDepthFunction(Qt3DRender::QDepthTest::Never);
  renderStateSet->addRenderState(depthTest);
  textEntity->addComponent(renderStateSet);
  

• 优化Z轴位置：将QText2DEntity的Z轴位置调整到所属实体的前方，避免被实体遮挡，同时确保它在视锥体内。
• 手动组合文本与背景：放弃QText2DEntity自带的背景，用QPlaneMesh做透明背景（搭配QPhongAlphaMaterial），再叠加无背景的QText2DEntity，手动控制两者的位置和层级。

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