Enum RenderError 

#[non_exhaustive]
pub enum RenderError {
    Iw44(Iw44Error),
    Jb2(Jb2Error),
    BufTooSmall {
        need: usize,
        got: usize,
    },
    InvalidDimensions {
        width: u32,
        height: u32,
    },
    ChunkOutOfRange {
        chunk_n: usize,
        max: usize,
    },
    Bzz(BzzError),
    Jpeg(String),
    Doc(DocError),
    ResourceLimit(ResourceLimitExceeded),
    UnsupportedOption(&'static str),
}

Errors that can occur during DjVuPage rendering.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Iw44(Iw44Error)

IW44 wavelet decode error.

Jb2(Jb2Error)

JB2 bilevel decode error.

BufTooSmall

The output buffer provided to render_into is too small.

Fields

need: usize

got: usize

InvalidDimensions

The requested render dimensions are invalid (zero width or height).

Fields

width: u32

height: u32

ChunkOutOfRange

chunk_n is out of range for progressive rendering.

Fields

chunk_n: usize

max: usize

Bzz(BzzError)

BZZ decompression error (for FGbz palette).

Jpeg(String)

JPEG decode error (for BGjp/FGjp chunks).

Doc(DocError)

Document-level error (e.g. page index out of range).

ResourceLimit(ResourceLimitExceeded)

A configured resource limit was exceeded during rendering.

UnsupportedOption(&'static str)

A render option is incompatible with the chosen entry point.

Returned by render_streaming when an option requires post-processing of a fully-allocated pixmap (anti-aliasing, Lanczos resampling at a scaled output, or rotation).

Trait Implementations

impl Debug for RenderError

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

Formats the value using the given formatter.

impl Display for RenderError

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

Formats the value using the given formatter.

impl Error for RenderError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<BzzError> for RenderError

fn from(source: BzzError) -> Self

Converts to this type from the input type.

impl From<DocError> for RenderError

fn from(source: DocError) -> Self

Converts to this type from the input type.

impl From<Iw44Error> for RenderError

fn from(source: Iw44Error) -> Self

Converts to this type from the input type.

impl From<Jb2Error> for RenderError

fn from(source: Jb2Error) -> Self

Converts to this type from the input type.

impl From<PixmapError> for RenderError

A refused output pixmap is a render-output limit.

Pixmap::try_new caps one pixmap at Pixmap::MAX_PIXELS; on the render paths that ceiling belongs to the same axis as the configurable max_render_pixels, so it surfaces as RenderError::ResourceLimit. A usize overflow of width * height is an invalid size, not a limit.

fn from(e: PixmapError) -> Self

Converts to this type from the input type.

impl From<RenderError> for TileError

fn from(source: RenderError) -> Self

Converts to this type from the input type.

impl From<RenderError> for PdfError

fn from(source: RenderError) -> Self

Converts to this type from the input type.

impl From<RenderError> for EpubError

fn from(source: RenderError) -> Self

Converts to this type from the input type.

impl From<RenderError> for CbzError

fn from(source: RenderError) -> Self

Converts to this type from the input type.

impl From<RenderError> for TiffError

fn from(source: RenderError) -> Self

Converts to this type from the input type.

impl From<RenderError> for AsyncRenderError

fn from(source: RenderError) -> Self

Converts to this type from the input type.

impl From<RenderError> for ImageCompatError

fn from(source: RenderError) -> Self

Converts to this type from the input type.

impl From<ResourceLimitExceeded> for RenderError

fn from(source: ResourceLimitExceeded) -> Self

Converts to this type from the input type.