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.