TikZ standalone para PDF ou PNG

A classe standalone e o cache com externalize.

TikZ standalone para PDF ou PNG

Uma figura TikZ normalmente fica dentro de um artigo, mas muitas vezes você precisa do diagrama como um arquivo próprio: para reaproveitá-lo em uma apresentação de slides, para entregá-lo a um coautor que trabalha no Word, para enviá-lo a um lugar que exige PNG ou simplesmente para evitar recompilar um desenho pesado a cada compilação do documento. A classe de documento standalone existe exatamente para isso. Ela compõe uma única figura em uma página recortada no tamanho da figura:

\documentclass[tikz,border=2pt]{standalone}
\begin{document}
\begin{tikzpicture}
\draw (0,0) -- (1,1);
\end{tikzpicture}
\end{document}

O que as opções da classe fazem

A opção tikz carrega o pacote TikZ para você e manda o standalone recortar a página de saída rente ao tikzpicture, de modo que o PDF resultante tenha exatamente o tamanho do desenho, sem margens de página. A opção border=2pt acrescenta uma folga de dois pontos em todos os lados, o que impede que traços que ficam exatamente sobre a caixa delimitadora sejam cortados por visualizadores ou impressoras. Compile este arquivo como qualquer documento, e a saída será um PDF pequeno, bem recortado, contendo apenas o diagrama.

Prefira esse PDF, porque ele é vetorial: pode ser redimensionado para qualquer tamanho sem perder nitidez. Inseri-lo em outro documento com \includegraphics funciona como descrito em uma página de PDF como figura. Quando uma cópia raster for realmente necessária, converta o PDF compilado em vez de refazer o desenho. Ferramentas de linha de comando como pdftoppm -png -r 300 figure.pdf figure geram um PNG de 300 dpi, e pdf2svg ou o Inkscape geram SVG. Exporte em 300 dpi ou mais se o PNG for impresso.

Guardando figuras em cache com externalize

Em um documento grande, as figuras TikZ são redesenhadas a cada compilação, e meia dúzia de gráficos complexos pode dominar o tempo de compilação. A biblioteca external resolve isso compilando cada figura em seu próprio PDF uma única vez e reutilizando o arquivo em cache até que o código da figura mude:

\usetikzlibrary{external}
\tikzexternalize[prefix=tikz-cache/]

A opção prefix mantém os arquivos gerados em uma pasta própria. A externalização executa o compilador em um modo que dispara subcompilações, por isso exige que o shell escape esteja ativado e não combina bem com algumas configurações. Se ela der problema, mova cada figura grande para um arquivo standalone próprio e inclua os PDFs compilados. Você obtém o mesmo cache, só que à mão e com menos mecanismo. O tempo de compilação em geral é tratado em menos espera pelo PDF.

Um erro comum merece um aviso: não tire uma captura de tela de um diagrama renderizado para obter um PNG. Capturas de tela têm a resolução da tela, que parece aceitável na pré-visualização de um slide e fica borrada em todo o resto. Converta a partir do PDF, em que a resolução é você quem escolhe.

Voltar para Desenhar em TeX