> For the complete documentation index, see [llms.txt](https://ayakaleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayakaleaf-pro.ayaka.space/latex/overleaf-learn-latex-pt/primitivas-tex-latex/08-pdfinclusionerrorlevel.md).

# \pdfinclusionerrorlevel

`\pdfinclusionerrorlevel[=]` *inteiro*

Este comando é usado para controlar o comportamento do motor TEX quando é incluído um ficheiro PDF que tem uma versão mais recente do que a especificada por [`\pdfminorversion`](/latex/overleaf-learn-latex-pt/primitivas-tex-latex/09-pdfminorversion.md).

* “`[=]`” significa que o sinal de igual é opcional.

**Exemplos de utilização**

* `\pdfinclusionerrorlevel=-1` (ou qualquer coisa $$<0$$): não fornece qualquer informação de diagnóstico.
* `\pdfinclusionerrorlevel=0` (predefinição): faz com que o motor TEX emita um aviso.
* `\pdfinclusionerrorlevel=1`: faz com que o motor TEX gere um erro.

#### \pdfinclusionerrorlevel: Informação de contexto

Desde que foi publicado pela primeira vez na década de 1990, o [formato de ficheiro PDF](https://en.wikipedia.org/wiki/PDF) tem sido alvo de inúmeras revisões e melhorias que resultam periodicamente na publicação de uma nova versão da especificação formal do PDF. Consequentemente, qualquer ficheiro PDF, incluindo os produzidos por motores TEX, estará em conformidade com uma determinada versão da especificação PDF — como PDF 1.4, 1.5, etc. Cada ficheiro PDF contém dados que identificam a versão da especificação PDF com a qual o ficheiro está em conformidade — para que qualquer aplicação que pretenda “consumir” um ficheiro PDF (por exemplo, importá-lo, processá-lo, etc.) saiba que conjunto de funcionalidades PDF é provável que esteja presente nesse ficheiro.

Se o seu documento TEX importar uma imagem em formato PDF, por exemplo através de `\includegraphics`, essa imagem pode estar em conformidade com uma especificação PDF mais recente (posterior) do que a suportada pelo próprio ficheiro de saída PDF do motor TeX. Claramente, isto pode provocar um “conflito” entre a versão PDF gerada por um motor TEX e a versão PDF usada por uma das imagens importadas. A título de exemplo, o documento composto produzido por um motor TEX pode estar em conformidade com, digamos, a versão PDF 1.4, mas uma imagem importada pode estar em conformidade com, digamos, PDF 1.5. Se essa imagem importada for simplesmente incorporada sem qualquer ação adicional, então, claramente, o ficheiro de saída PDF produzido por TEX deixa de estar em conformidade com o PDF 1.4 porque passa agora a conter conteúdo gráfico baseado na especificação PDF 1.5. O `\pdfinclusionerrorlevel` comando ajuda a gerir isto.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ayakaleaf-pro.ayaka.space/latex/overleaf-learn-latex-pt/primitivas-tex-latex/08-pdfinclusionerrorlevel.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.