% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/media.R
\name{pdf_file}
\alias{pdf_file}
\title{Create a PDF Object}
\usage{
pdf_file(.path, pages = NULL, .text_extract = FALSE, engine = NULL)
}
\arguments{
\item{.path}{The path to the PDF file on disk.}

\item{pages}{An integer vector of page numbers to include (e.g. \code{1:3}). NULL uses all pages.}

\item{.text_extract}{Logical; if TRUE always use pdftools text extraction regardless of provider
(equivalent to the old \code{.pdf} parameter behaviour). Default FALSE uses binary-first.}

\item{engine}{Optional engine name (e.g. \code{"mistral-ocr"}); a warning is issued if the provider
does not support binary PDF and the engine choice cannot be honoured.}
}
\value{
A \code{tidyllm_pdf} object.
}
\description{
Stores a reference to a local PDF file along with a pdftools text extraction.
Binary encoding is deferred to format time; providers that support binary PDF
encode on demand, others use the stored text fallback.
}
