Struct RenderPrep 

pub struct RenderPrep { /* private fields */ }

Render-prep orchestrator.

Implementations

impl RenderPrep

pub fn new(opts: RenderPrepOptions) -> Self

Create a render-prep engine.

pub fn with_serif_default(self) -> Self

Use serif default fallback policy.

pub fn with_font_policy(self, policy: FontPolicy) -> Self

Override fallback font policy used during style-to-face resolution.

pub fn with_embedded_fonts_from_book<R: Read + Seek>( self, book: &mut EpubBook<R>, ) -> Result<Self, RenderPrepError>

Register all embedded fonts from a book.

pub fn with_registered_fonts<I, F>( self, fonts: I, loader: F, ) -> Result<Self, RenderPrepError>

where I: IntoIterator<Item = EmbeddedFontFace>, F: FnMut(&str) -> Result<Vec<u8>, EpubError>,

Register fonts from any external source with a byte loader callback.

pub fn prepare_chapter<R: Read + Seek>( &mut self, book: &mut EpubBook<R>, index: usize, ) -> Result<PreparedChapter, RenderPrepError>

Prepare a chapter into styled runs/events.

pub fn prepare_chapter_into<R: Read + Seek>( &mut self, book: &mut EpubBook<R>, index: usize, out: &mut Vec<StyledEventOrRun>, ) -> Result<(), RenderPrepError>

Prepare a chapter and append results into an output buffer.

pub fn prepare_chapter_with<R: Read + Seek, F: FnMut(StyledEventOrRun)>( &mut self, book: &mut EpubBook<R>, index: usize, on_item: F, ) -> Result<(), RenderPrepError>

Prepare a chapter and stream each styled item via callback.

pub fn prepare_chapter_bytes_with<R: Read + Seek, F: FnMut(StyledEventOrRun)>( &mut self, book: &mut EpubBook<R>, index: usize, html: &[u8], on_item: F, ) -> Result<(), RenderPrepError>

Prepare a chapter from caller-provided XHTML bytes and stream each styled item.

This avoids re-reading chapter bytes from the ZIP archive and is intended for embedded call sites that already own a reusable chapter buffer.

pub fn prepare_chapter_bytes_with_scratch<R: Read + Seek, F: FnMut(StyledEventOrRun)>( &mut self, book: &mut EpubBook<R>, index: usize, html: &[u8], stylesheet_scratch: &mut Vec<u8>, on_item: F, ) -> Result<(), RenderPrepError>

Prepare chapter bytes with caller-provided stylesheet scratch.

This avoids transient stylesheet Vec<u8> allocations by reusing stylesheet_scratch.

pub fn prepare_chapter_with_trace_context<R: Read + Seek, F: FnMut(StyledEventOrRun, RenderPrepTrace)>( &mut self, book: &mut EpubBook<R>, index: usize, on_item: F, ) -> Result<(), RenderPrepError>

Prepare a chapter and stream each styled item with structured trace context.

pub fn prepare_chapter_with_trace<R: Read + Seek, F: FnMut(StyledEventOrRun, Option<FontResolutionTrace>)>( &mut self, book: &mut EpubBook<R>, index: usize, on_item: F, ) -> Result<(), RenderPrepError>

👎Deprecated since 0.2.0: Use prepare_chapter_with_trace_context for stable structured trace output.

Prepare a chapter and stream each styled item with optional font-resolution trace.

Trait Implementations

impl Clone for RenderPrep

fn clone(&self) -> RenderPrep

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RenderPrep

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.