Como posso resolver problemas de OpenGL do ZED SDK no Ubuntu?
Last updated: October 22, 2026
Depois de atualizar o driver NVIDIA® em uma máquina Ubuntu ou após uma instalação nova, as ferramentas ZED podem não iniciar, ou os exemplos do ZED SDK podem falhar, devido a problemas com o OpenGL.
Isso geralmente acontece em laptops e computadores desktop com dois adaptadores gráficos (gráficos híbridos), quando o sistema operacional não usa a GPU NVIDIA® para renderização.
Uma das mensagens de erro mais comuns nesse caso é:
ERROR: Internal error <FBConfig with necessary capabilities not found> in function fgOpenWindow
Verifique o problema
Abra um terminal [Ctrl+Alt+T] e execute os seguintes comandos (o primeiro instala o utilitário glxinfo, caso ainda não esteja disponível):
sudo apt install mesa-utils glxinfo | grep "OpenGL vendor"
A saída correta é:
OpenGL vendor string: NVIDIA Corporation
Se você obtiver algo diferente, por exemplo OpenGL vendor string: Intel, seu sistema é afetado pelo problema descrito acima.
Solução
Force o sistema operacional a usar a GPU NVIDIA® com o comando prime-select. Verifique a configuração atual:
prime-select query
Se a saída for diferente de nvidia, execute:
sudo prime-select nvidia
e reinicie o sistema.
Observação: se o Secure Boot estiver habilitado, os módulos do kernel NVIDIA® deverão estar assinados (o Ubuntu solicita que você inscreva uma chave MOK ao instalar o driver); caso contrário, o driver não será carregado. Desabilite o Secure Boot na BIOS somente se não conseguir inscrever a chave.
Após a reinicialização, execute glxinfo | grep "OpenGL vendor" novamente e verifique se a saída informa NVIDIA Corporation. Em seguida, inicie a ferramenta ou o exemplo que estava falhando.
Se o problema não for resolvido, escreva para support@stereolabs.com descrevendo o problema e anexando o relatório gerado pela ferramenta de diagnóstico ZED; consulte este artigo.