Diagnóstico de gráficos

Esse documento descreve as Visual Studio ferramentas de diagnóstico de elementos gráficos, que você pode usar para diagnosticar problemas comuns de renderização em aplicativos gráficos de DirectX.Diagnósticos Gráficos suportam Direct3D 10, 10.1, 11 e 11.1 e fornecem suporte limitado para o Direct2D.Ele não suporta versões anteriores do Direct3D, DirectDraw, ou outros APIs gráficos.

Você pode usar Graphics Diagnostics para:

• Quadros renderizados capturados para verificação posterior.

• Procure e selecione os quadros capturados para a inspeção e a análise detalhadas.

• Exibir os eventos de Direct3D que ocorreram durante um quadro, e os seus efeitos no app

• Exibir dados de malha 3d ou processar dados de destino após cada estágio da pipeline.

• Ir para o local do código-fonte de um evento Direct3D particular.

• Descubra quais eventos do Direct3D contribuíram para a cor de um pixel específico em cada quadro.

• Examine os objetos Direct3D, como o estado, buffers, malhas e texturas do dispositivo.

Logs de gráficos

Durante uma sessão de captura de Diagnósticos Gráficos, um log de gráficos é criado para registrar eventos, recursos e estado dos gráficos.Posteriormente, você pode usar o log dos gráficos para recriar e examinar quadros capturados em detalhes, sem ter que replicar o ambiente que foi usado para capturá-los.Você pode carregar diversos arquivos de log de elementos gráficos (.vsglog) ao mesmo tempo para comparar dados e resultados de renderização.Como esses arquivos são independentes, você pode compartilhá-los com outros desenvolvedores.Para obter mais informações, consulte O DirectX Graphics de depuração..

Observação
Como alguns APIs do Windows 8 não estão disponíveis no Windows 7 ou Windows Vista, os aplicativos que usam esses APIs não podem ser recriados no Windows 7 ou Windows Vista.

Para abrir um arquivo de registro de elementos gráficos (vsglog)

1. Em Visual Studio, na barra de menu, escolher Arquivo, Abrir, Arquivo.A caixa de diálogo Abrir Arquivo aparece.

2. Especifique um log de elementos gráficos (.vsglog) a ser aberto e escolha o botão de Abrir.

Trabalho com a barra de ferramentas de Graphics Diagnostics

Você pode usar a barra de ferramentas do Shader Designer para acessar as ferramentas que ajudam você a capturar os dados de registro de elementos gráficos e diagnosticar problemas e depuração que foram capturados no log.

Aqui está a barra de ferramentas Diagnósticos Gráficos:

A tabela a seguir descreve os itens da barra de ferramentas de Diagnósticos Gráficos.Os itens estão listados na ordem em que aparecem da esquerda para a direita.

Botão da Barra de Ferramentas	Descrição
Iniciar Diagnósticos	Inicie um aplicativo Direct3D com suporte para Diagnósticos Gráficos habilitado.Quando você iniciar um app dessa maneira, você pode usar o Graphics Diagnostics para capturar as informações detalhadas sobre quadros individuais no app em execução.
Lista de Eventos	Abre a janela Lista de Eventos de Gráficos.
Histórico de Pixel	Abre a janela Histórico de Pixel de Gráficos.
Pilha de chamadas de evento	Abre a janela Pilha de Chamadas do Evento de Gráficos.
Tabela de Objeto	Abre a janela Tabela de Objetos Gráficos.
Estágios de Pipeline	Abre a janela Estágios de Pipeline Gráficos.
Capturar Quadro	Captura um quadro da execução de um aplicativo Direct3D iniciado usando o botão Iniciar Diagnósticos.O botão Capturar quadro está habilitado somente quando um aplicativo habilitado para Diagnósticos Gráficos estiver sendo executado.

Painel de controle do DirectX

O painel de controle DirectX é um componente de DirectX que você pode usar para alterar a maneira como o DirectX se comporta — por exemplo, você pode ativar a versão de depuração dos componentes de tempo de execução do DirectX, selecionar o tipo de mensagens de depuração que são relatadas, e não permitir que certos recursos de hardware gráfico sejam usados para emular um hardware menos capaz.Esse nível de controle sobre o DirectX pode ajudá-lo a depurar e testar seu aplicativo DirectX.Você pode acessar o Painel de Controle de DirectX no Visual Studio.

Para abrir o painel de controle do DirectX

• Na barra de menus, escolha Depurar, Gráficos, Painel de Controle do DirectX.

Janelas de ferramentas de Diagnósticos Gráficos

A ilustração a seguir mostra as janelas de ferramentas que são usadas para inspecionar e depurar quadros capturados.Cada janela expõe uma categoria diferente de informações que foi capturada para o quadro que está sendo inspecionado e mesmo para pixels individuais no quadro.

Tópicos relacionados

Nome	Descrição
Captura informações de elementos gráficos	Descreve como capturar as informações de gráficos para que você possa a analisar as ferramentas de Diagnóstico Gráficos.
Documento de Log de gráficos	Descreve como usar elementos gráficos que informações em elementos gráficos efetua logon do documento para identificar os artefatos visuais que são causados os problemas.
Lista de eventos de gráficos	Descreve como usar a Lista de eventos de gráficos para identificar os eventos relacionados aos problemas de renderização.
Visualizador de Pipeline de gráficos	Descreve como usar a janela Fases da canalização de gráficos para identificar a fase de canalização onde um problema de renderização aparece primeiro.
Pilha de chamadas do evento de gráficos	Descreve como usar a Pilha de chamadas de eventos de gráficos para localizar o código de aplicativo relacionado aos problemas de renderização.
Histórico de Pixel de gráficos	Descreve como usar o Histórico de pixel de gráficos para examinar os detalhes de eventos que afetaram a cor final de um pixel.
Tabela de objetos gráficos	Descreve como usar a Tabela de objeto gráfico para exibir os detalhes dos objetos relacionados aos problemas de renderização.
Depuração de HLSL	Descreve como usar o Depurador HLSL.