Pular para o conteúdo

graphicx e \includegraphics no Scissor LaTeX

O pacote graphicx funciona em parte no Scissor LaTeX: \includegraphics mostra arquivos PNG, JPG, SVG e PDF do seu projeto e lê width=; height, scale, angle, trim e clip são ignorados, \rotatebox não gira, e \scalebox e \resizebox só redimensionam um desenho TikZ.

O que o pacote faz

O graphicx oferece \includegraphics[options]{file} para inserir um arquivo de imagem, e caixas que escalam, redimensionam ou giram o conteúdo: \scalebox, \resizebox e \rotatebox.

O que funciona aqui

Comando ou opçãoNo Scissor LaTeXObservações
\includegraphics{file.png}FuncionaArquivos PNG, JPG, JPEG, SVG e PDF do projeto. Sem width=, a imagem mantém o próprio tamanho.
\includegraphics{file} (sem extensão)Em parteEncontra arquivos .png, .jpg, .jpeg e .svg. Um PDF precisa da extensão escrita: {plot.pdf}.
width=0.5\linewidth, width=4cmFuncionaComprimentos e frações de \linewidth ou \textwidth. A altura segue a proporção.
height=, scale=, angle=, trim=, clip, keepaspectratioIgnoradoIgnorados sem mensagem.
Arquivos EPS, ou um arquivo que não está no projetoMarcadorUma caixa tracejada com o nome do arquivo e uma nota "Imagens fora do projeto" na aba Problemas.
Várias imagens em sequênciaEm parteCada imagem fica em uma linha própria, mesmo dentro de um parágrafo. Imagens lado a lado só funcionam nas células de um tabular.
\graphicspath{...}IgnoradoAceito sem mensagem.
\scalebox{2}{...}, \resizebox{w}{!}{...}Em parteSó um único desenho TikZ dentro é redimensionado; texto e imagens mantêm o tamanho.
\rotatebox{90}{...}IgnoradoO conteúdo é mantido, sem girar.
\reflectbox{...}Não suportadoPulado com uma nota na aba Problemas; o conteúdo é mantido.

Exemplos

Uma imagem com metade da largura da linha, em uma figura com legenda:

\includegraphics com width=

LaTeXPreâmbulo: \usepackage{graphicx}Abrir no editor (abre em uma nova aba)
\begin{figure}[h]
  \centering
  \includegraphics[width=0.5\linewidth]{graphicx-photo}
  \caption{Weekly orders in John Doe's shop.}
  \label{fig:orders}
\end{figure}
Figure~\ref{fig:orders} shows four weeks.

Arquivos SVG e PDF também funcionam. Escreva a extensão para um PDF:

Uma imagem SVG e uma PDF

LaTeXPreâmbulo: \usepackage{graphicx}Abrir no editor (abre em uma nova aba)
\includegraphics[width=4cm]{graphicx-diagram.svg}

\includegraphics[width=4cm]{graphicx-chart.pdf}

O height= é ignorado. Esta imagem deveria ter 1 cm de altura, mas mantém o próprio tamanho:

height= é ignorado

LaTeXPreâmbulo: \usepackage{graphicx}Abrir no editor (abre em uma nova aba)
\includegraphics[height=1cm]{graphicx-photo.png}

Use width= no lugar. Para uma imagem com cerca de 1 cm de altura, calcule a largura pela proporção (esta é 16 por 9, então cerca de 1,8 cm).

Um arquivo ausente, ou em um formato que o compositor não lê, vira um marcador tracejado e uma nota na aba Problemas:

Uma imagem ausente mostra um marcador

LaTeXPreâmbulo: \usepackage{graphicx}Abrir no editor (abre em uma nova aba)
\includegraphics[width=5cm]{results/plot.eps}

Aba Problemas: Images not in the project: results/plot.eps

O \resizebox escala um desenho TikZ para uma largura dada:

\resizebox em volta de um desenho TikZ

LaTeXPreâmbulo: \usepackage{graphicx,tikz}Abrir no editor (abre em uma nova aba)
\resizebox{3cm}{!}{%
  \begin{tikzpicture}
    \draw (0,0) rectangle (4,2);
    \draw (0,0) -- (4,2);
    \node at (2,2.4) {44};
  \end{tikzpicture}}

Compatibilidade

  • De uma instalação do TeX para cá: envie os arquivos de imagem com os mesmos nomes de pasta. Imagens dimensionadas com height= ou scale= aparecem no próprio tamanho; troque para width=. Figuras PDF incluídas sem extensão precisam de .pdf acrescentado.
  • Daqui para uma instalação do TeX: o pdfLaTeX não lê arquivos SVG. Converta-os para PDF (ou use o pacote svg), ou fique só com imagens PNG, JPG e PDF.

O manual completo está no CTAN: ctan.org/pkg/graphicx. Para figuras, legendas e posicionamento, veja Figuras e imagens e Flutuantes: posicionando figuras e tabelas.

Perguntas e respostas

Por que minha imagem está grande demais?

Sem width=, uma imagem mantém o próprio tamanho, e height= e scale= são ignorados. Acrescente width=0.8\linewidth ou uma largura fixa como width=6cm.

Posso incluir uma figura em PDF?

Sim. Envie o PDF para o projeto e escreva o nome do arquivo com a extensão, por exemplo \includegraphics[width=\linewidth]{plot.pdf}.

Por que minha imagem aparece como uma caixa tracejada?

O arquivo não está no projeto, o caminho é diferente, ou é um arquivo EPS. A aba Problemas indica o arquivo que não foi encontrado.

Cada exemplo desta página é composto pelo Scissor LaTeX quando o site é gerado. Última atualização: 2026-11-07.