O depurador visual do Chaos (DVC) é uma ferramenta que você pode usar para gravar simulações de física. Com o DVC, você pode gravar jogos e aplicativos em execução no aparelho, bem como de um aparelho remoto ou de uma plataforma conectada ao aparelho.
Ao reproduzir gravações no DVC, você pode inspecionar os dados para depuração. Essas gravações são independentes do projeto, o que significa que podem ser carregadas mesmo sem acesso aos arquivos do projeto da Unreal Engine (UE), habilitando a colaboração entre equipes ou a depuração remota.
Os dados que o DVC registra incluem:
Partículas (incluindo velocidades, acelerações, propriedades de massa e estados dos objetos)
Geometria de colisão (incluindo canais de colisão)
Restrições de colisão (pares de contato com o estado)
Restrições de articulação (configurações de estado e articulação)
Restrições do personagem no solo (movimento do personagem com base em física)
Consultas de cenas (incluindo rastreios de linhas, varreduras e sobreposições)
Nós de animação de corpos rígidos (RBAN)
No contexto do DVC, geralmente as partículas se referem a corpos rígidos.
Como iniciar o depurador visual do Chaos?
Há duas formas de inicializar o DVC: pelo editor ou como um programa independente.
No Unreal Editor
Para abrir o depurador visual do Chaos no Unreal Editor, na barra de menus, clique em Ferramentas > Depurar > depurador visual do Chaos. Depois de selecionar o DVC, a ferramenta abrirá em uma nova janela.
Como um programa independente
Para executar o DVC como um programa independente, você deve usar uma compilação de código-fonte da Unreal Engine. É possível baixar uma compilação do código-fonte no GitHub. Para saber mais, consulte Como compilar a Unreal Engine a partir do código-fonte.
Você pode compilar e executar o DVC como um programa independente a partir de um arquivo executável (não portátil) ou de um arquivo em lote (portátil). A tabela a seguir descreve a localização do arquivo e as etapas de compilação para cada opção.
| Fluxo de compilação | Descrição |
|---|---|
Executável do DVC | O executável está no seguinte caminho de arquivo: Para compilar e executar o DVC, siga estas etapas:
Após a compilação, você poderá criar um atalho para o executável e executar a ferramenta com um único clique. |
Arquivo em lote do DVC | O arquivo em lote está no seguinte caminho: Para compilar e executar o DVC, siga estas etapas:
|
Explorar a interface do usuário do DVC
Esta seção descreve os botões, os painéis e as barras de ferramentas mais comuns com os quais você interagirá no depurador visual do Chaos. Embora alguns desses elementos sejam semelhantes à Interface do Unreal Editor, você deve se familiarizar com o DVC devido às diferenças visuais entre ele e algumas versões do Unreal Editor.
As seções abaixo descrevem onde encontrar cada elemento da interface de usuário (IU) e oferecem casos de uso simples. Para se aprofundar mais, siga os links fornecidos nesta página.
| Número | Nome | Visão geral |
|---|---|---|
1 | Barra de menus | Opções para carregar gravações recentes e modificar o layout do DVC. |
2 | Barra de ferramentas principal | Opções para iniciar ou parar gravações, carregar gravações e personalizar os dados a serem gravados. |
3 | Barra de ferramentas da janela de visualização | Opções para modificar quais dados são exibidos na janela de visualização e como eles são visualmente diferenciados. |
4 | Organizador de Cenas | Exibe uma lista de componentes de cena em uma gravação. |
5 | Janela de visualização | Exibe uma gravação carregada ou ao vivo, como a janela de visualização do Unreal Editor. Isso pode incluir:
|
6 | Controles de reprodução | Exibe uma coleção de linhas do tempo de reprodução e logs, incluindo: |
7 | Painel Detalhes | Exibe informações de uma seleção feita na janela de visualização que não tem um Inspetor de dados dedicado, como partículas. |
8 | Inspetores de dados | Fornece detalhes adicionais para: |
Barra de menus
| Nome | Descrição | Imagem |
|---|---|---|
Arquivo | Acesso rápido para abrir gravações recentes. | |
Janela | Mostra ou oculta partes da IU do DVC. |
Barra de ferramentas principal
| Número | Nome | Descrição |
|---|---|---|
1 | Abrir arquivo | Carrega gravações de |
2 | Conectar-se à sessão | (Legado) Conecta-se a um aparelho remoto para depuração remota. Agora é usado apenas ao gravar uma sessão remota pela linha de comando. Confira (Legado) Gravar uma sessão ao vivo com a interface da linha de comando para obter mais informações. |
3 | Combinar | Combina várias gravações abertas no DVC em um arquivo |
4 | Navegador de consultas de cenas | Inspeciona todas as consultas de cenas feitas para um único quadro. Para obter mais informações, consulte Inspectores de dados. |
5 | Alvos de sessão | Seleciona os alvos para gravar. |
6 | Modo de carregamento | Carrega uma ou várias gravações (o que mescla dados). |
7 | Gravar em arquivo | Inicia uma gravação e a salva no arquivo. |
8 | Gravar sessão ao vivo | Inicia uma gravação e renderiza a visualização em tempo real. |
9 | Canais de dados | Personaliza os dados capturados durante a gravação, como: |
10 | Configurações | Personaliza a IU e o desempenho do DVC. |
Barra de ferramentas da janela de visualização
Menu de hambúrguer
| Nome | Descrição | Imagem |
|---|---|---|
Reproduzir na taxa de quadros gravada | Substitui a taxa de quadros gravada por uma fixa. | |
Rastreamento de objetos (F8) | Bloqueia a câmera em um objeto na janela de visualização. | |
Opções de campo de visão | Ajusta o campo de visão da janela de visualização e a distância máxima de renderização. | |
Permitir seleção translúcida (T) | Ativa a habilidade de clicar em objetos translúcidos. | |
Ir para a posição | Teleporta a câmera para uma posição inserida nesse campo, usando um formato XYZ. |
Modo de visualização
O modo de visualização alterna entre a visualização Perspectiva, Superior, Inferior, Esquerda, Direita, Fronte e Trás na janela de visualização.
Modo de iluminação
O modo de iluminação alterna entre os modos de visualização Iluminável, Não Iluminável, Wireframe iluminável e Wireframe na janela de visualização.
Modos de iluminação
Botão Exibir
O botão Exibir modifica quais sinalizadores de visualização e texto de depuração estão visíveis na janela de visualização para uma gravação existente. Para obter mais informações sobre sinalizadores de dados, consulte Sinalizadores de visualização de dados.
As configurações nesse menu permanecem entre as sessões do DVC, a menos que sejam restauradas para os valores padrão.
Barra de ferramentas de transformação e encaixe
A barra de ferramentas de transformação e encaixe é semelhante à barra de ferramentas da janela de visualização legada das versões anteriores do Unreal Editor. Na maioria das vezes, você usará essas ferramentas para manipular atores de luz.
| Ícone | Nome | Descrição |
|---|---|---|
Selecionar objetos | Seleciona objetos dentro da janela de visualização. | |
Selecionar e transladar objetos | Move os atores de luz ao redor do mundo ao longo de eixos individuais, eixos duplos ou em todos os três eixos. | |
Selecionar e girar objetos | Gira atores de luz ao longo de eixos individuais. | |
Selecionar e dimensionar objetos | Escala atores de luz usando o gizmo de escala. Use o dispositivo para dimensionar objetos ao longo de eixos individuais, eixos duplos ou uniformemente em todos os três eixos. | |
Sistema de coordenadas | Alterna o sistema de coordenadas entre Mundo e Local. | |
Encaixar na superfície | Define o comportamento de encaixe dos atores de luz quando você os arrastar pela superfície de outro objeto. | |
Encaixar na grade | Define se os atores de luz se encaixam na grade e estabelece o incremento. | |
Incrementos de rotação | Define se os atores de luz giram em incrementos e estabelece o grau. | |
Incrementos de escala | Define se os atores de luz são redimensionados em incrementos e estabelece o incremento. | |
Velocidade da câmera | Afeta a velocidade com a qual a câmera pode se mover pelo mundo. |
Organizador de cenas
O Organizador de cenas exibe uma lista de componentes de cena em uma gravação. Como cada gravação pode conter vários solucionadores, as partículas de cada solucionador são colocadas em uma pasta com o nome e o ID do solucionador ao qual pertencem. Nessa pasta, cada partícula é rotulada com seu nome de depuração no lado do Chaos.
No DVC, um solucionador de física é uma instância de simulação de física (geralmente de um mundo de jogo) gerenciada pela Chaos Physics Engine.
Controles de reprodução
O depurador visual do Chaos inclui controles para executar e retroceder gravações existentes com base em quadros game-thread, quadros physics-solver ou estágios de uma simulação. Isso maximiza o grau em que você pode inspecionar situações que usam física em rede, física assíncrona ou vários mundos de jogos (como jogos multijogador).
Linha do tempo de quadros de jogo
A Linha do tempo de quadros de jogo representa cada quadro game-thread para uma gravação.
Ao reproduzir uma gravação usando essa linha do tempo, você perceberá que a Linha do tempo do solucionador também é reproduzida. Isso ocorre porque, para cada quadro game-thread executado, o DVC procura o quadro physics-solver mais próximo disponível naquele carimbo de data/hora.
O número de quadros da Linha do tempo de quadros de jogo nem sempre corresponde ao da Linha do tempo do solucionador. Isso ocorre porque os quadros game-thread podem corresponder a vários quadros physics-solver. O acesso às duas linhas do tempo permite inspecionar situações em que isso ocorre, como ao usar Física assíncrona.
Para obter uma explicação detalhada de como o DVC visualiza a física síncrona e assíncrona, dados de vários mundos de jogo e quadros ressimulados, consulte Depurar a física do Chaos na Unreal Engine, aos 16:05 minutos.
Linha do tempo do solucionador
A Linha do tempo do solucionador representa cada quadro physics-solver para uma gravação. Cada solucionador tem uma faixa dedicada. Usando essa linha do tempo, você pode reproduzir dados para qualquer faixa de solucionador e ver qual quadro do solucionador corresponde a um quadro game-thread específico.
| Configuração | Descrição | Imagem |
|---|---|---|
Modo de sincronização da linha do tempo | Controla como cada faixa do solucionador é sincronizada.
| |
Medalha de ressimulação | Aparece em qualquer faixa de solucionador que inclui quadros que fazem parte de uma nova ressimulação feita durante o processo de correção de dessincronização da rede. | |
Controle de visibilidade | Mostra ou oculta dados visualizados de uma determinada faixa de solucionador. |
Linha do tempo de estágios do solucionador
Com a Linha do tempo de estágios do solucionador, você pode pular para um estágio específico de uma simulação de física. Estágios são instantâneos de uma simulação capturados em diferentes pontos em um único quadro de física.
Você pode visualizar os seguintes estágios usando uma simulação de partículas como exemplo:
| Preparar | Descrição |
|---|---|
Início da evolução | Tira um instantâneo de todas as partículas no início da etapa do solucionador. |
Pós-integração | Captura todas as partículas após realizar o cálculo de |
Fase ampla de detecção de colisão | Tira um instantâneo de todas as fases intermediárias (um objeto é criado para cada par de partículas cujas delimitações se sobrepõem) após executar a Fase ampla do processo de detecção de colisão. |
Fase estreita de detecção de colisão | Tira um instantâneo de todas as fases intermediárias após executar a Fase estreita do processo de detecção de colisão. |
Solução pré-restrição | Tira um instantâneo de todas as partículas antes de resolver as restrições disponíveis. |
Solução pós-restrição | Tira um instantâneo de todas as partículas após resolver as restrições. |
Fim da evolução | Tira um instantâneo de todas as partículas ao final da etapa do solucionador. |
A Linha do tempo de estágios do solucionador é útil para inspecionar comportamentos anormais em quadros específicos, como quando um objeto aparece na posição correta no início de um quadro, mas em uma posição inesperada no fim de um quadro.
Log de saída registrado
Ao lado da aba Faixas da Linha do tempo do solucionador, a aba Log de saída registrado é onde o DVC grava a transmissão do log do seu aplicativo para inspeção retroativa.
Log de saída
O Log de saída é um log em tempo real para monitorar atividades. Essa aba mostra o log ativo da instância atual do DVC e exibe erros ou avisos do próprio DVC.
Painel "Detalhes"
O painel Detalhes exibe informações para uma seleção feita na janela de visualização.
O painel Detalhes também atua como o Inspetor de dados para dados de partículas. Para obter mais informações, consulte Dados de partículas (painel Detalhes).
Próxima
Inspetores de dados
Entenda os inspetores de dados no depurador visual do Chaos.
Sinalizadores de visualização de dados
Entender os sinalizadores de visualização de dados no depurador visual do Chaos.
Captura de dados com o depurador visual do Chaos
Capture e reproduza gravações com o depurador visual do Chaos.