Introdução
Não importa se você está usando um contexto 2D ou WebGL, qualquer pessoa que já tenha trabalhado com o elemento <canvas> sabe que pode ser extremamente difícil depurar. Trabalhar com uma tela geralmente envolve uma lista longa e difícil de seguir de chamadas:
function draw() {
context.clearRect(0, 0, 258, 258);
context.fillStyle = "#EEEEEE";
context.beginPath();
context.arc(129, 129, 127, 0, 6.28, true);
context.closePath();
context.fill();
// … and on and on
}
Às vezes, você quer capturar as instruções enviadas para um contexto de tela e analisá-las uma por uma. Felizmente, há um novo recurso de inspeção de tela no DevTools do Chrome que permite fazer exatamente isso.
Neste artigo, vou mostrar como usar esse recurso para começar a depurar seu trabalho no Canvas. O inspetor é compatível com contextos 2D e WebGL. Portanto, não importa qual você esteja usando, é possível receber informações úteis de depuração imediatamente.
Primeiros passos
Para começar, acesse about:flags no Chrome e ative a opção "Ativar experimentos das Ferramentas para Desenvolvedores".
Em seguida, acesse o DevTools e clique na engrenagem
no canto inferior direito. Em seguida, acesse Experimentos e ative a Inspeção de tela:
Para que as mudanças entrem em vigor, feche e reabra o DevTools (você pode usar Alt+R ou Option+R, uma alternativa prática).
Quando o DevTools for reaberto, acesse a seção "Perfis" para ver uma nova opção "Canvas Profiler".
Para começar, você vai notar que o Canvas Profiler está desativado. Quando você tiver uma página com uma tela que quer depurar, basta pressionar Ativar. A página será atualizada e estará pronta para capturar as chamadas de <canvas>:
Você precisa decidir se quer capturar um único frame ou frames consecutivos, em que um frame é exatamente o mesmo que você veria na linha do tempo do DevTools.
Single frame captura as chamadas até o fim do frame atual e depois para. Já os frames consecutivos capturam todos os frames de todos os elementos <canvas> até que você interrompa o processo. O modo escolhido depende de como você está usando o elemento <canvas>. Para uma animação em andamento, talvez você queira capturar um único frame. Para uma animação breve que ocorre em resposta a um evento do usuário, talvez seja necessário capturar frames consecutivos.
Com isso, tudo está configurado e pronto para começar a captura.
Capturando frames
Para capturar, basta pressionar Start e interagir com o aplicativo normalmente. Depois de algum tempo, volte para o DevTools e, se estiver capturando consecutivamente, pressione Stop.
Agora você tem um novo perfil na lista à esquerda, com o número de chamadas de contexto capturadas em todos os elementos <canvas>. Clique no perfil para ver uma tela como esta:
No painel inferior, você verá uma lista de todos os frames capturados que podem ser analisados. Ao clicar em cada um deles, a captura de tela na parte de cima vai mostrar o estado do elemento <canvas> no final desse frame. Se você tiver vários elementos <canvas>, poderá escolher qual deles será mostrado usando o menu logo abaixo da captura de tela.
Dentro do frame, você verá grupos de chamadas de desenho. Cada grupo de chamadas de desenho contém uma única chamada de desenho, que será a última chamada no grupo. Mas o que é uma chamada de desenho? Para um contexto 2D, isso inclui clearRect(), drawImage(), fill(), stroke(), putImageData() ou qualquer função de renderização de texto. Para WebGL, inclui clear(), drawArrays() ou drawElements(). É basicamente qualquer coisa que mude o conteúdo do buffer de desenho atual. Se você não gosta de gráficos, pense em um buffer como um bitmap com pixels que estamos manipulando.
Agora, basta percorrer a lista. Isso pode ser feito no nível do frame, do grupo de chamadas de desenho ou da chamada. Seja qual for a forma escolhida para percorrer a lista (e há botões logo abaixo da captura de tela que ajudam a navegar rapidamente), você verá o contexto naquele ponto, o que significa que poderá encontrar e corrigir bugs rapidamente à medida que eles surgirem.
Encontre as diferenças
Outro recurso útil é a capacidade de ver quais propriedades e variáveis mudaram entre duas chamadas.
Para ver isso, basta clicar no botão da barra lateral (
) e uma nova visualização vai aparecer. Ao analisar as chamadas de desenho, você vai ver as propriedades que foram atualizadas. Os buffers ou matrizes vão mostrar o conteúdo se você passar o cursor sobre eles.
Faça sua voz ser ouvida!
Agora você sabe como depurar seu trabalho de canvas no DevTools do Chrome. Se você tiver feedback sobre a ferramenta Canvas Profiler, registre um bug ou poste no grupo do Chrome DevTools. Informe se você encontrar bugs ou se quiser ver mais alguma coisa ao inspecionar um <canvas>, porque é somente com o uso e o feedback dos desenvolvedores que as ferramentas do Chrome melhoram.