Enum PrintableTargetError 

#[non_exhaustive]
pub enum PrintableTargetError {
    Io(Error),
    Json(Error),
    UnsupportedSchemaVersion(u32),
    InvalidPageSize,
    InvalidMargin,
    EmptyPrintableArea,
    InvalidPngDpi,
    InvalidChessboardSize,
    InvalidCharucoSize,
    InvalidSquareSize,
    InvalidMarkerSizeRel,
    InvalidBorderBits,
    InvalidCircleDiameter,
    MissingMarkerBoardCellSize,
    InvalidCircleCell,
    DuplicateCircleCells,
    NotEnoughDictionaryCodes {
        needed: usize,
        available: usize,
    },
    BoardDoesNotFit {
        board_width_mm: f64,
        board_height_mm: f64,
        printable_width_mm: f64,
        printable_height_mm: f64,
    },
    CharucoBoard(CharucoBoardError),
    InvalidPuzzleBoardSize,
    InvalidPuzzleBoardOrigin,
    InvalidPuzzleBoardDotDiameter,
    PuzzleBoardSpec(PuzzleBoardSpecError),
}

Error returned when validating a target specification or rendering a printable target bundle.

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.

Io(Error)

An I/O operation failed while writing one of the output files.

Json(Error)

The target document could not be serialized to or deserialized from JSON.

UnsupportedSchemaVersion(u32)

The document declares a schema_version this build does not understand.

InvalidPageSize

A custom page width or height is non-finite or not strictly positive.

InvalidMargin

The page margin is non-finite or negative.

EmptyPrintableArea

The page margins consume the entire page, leaving no printable area.

InvalidPngDpi

The requested PNG render resolution is not strictly positive.

InvalidChessboardSize

A chessboard spec requests fewer than 2 inner rows or columns.

InvalidCharucoSize

A ChArUco spec requests fewer than 2 rows or columns.

InvalidSquareSize

A square-size dimension is non-finite or not strictly positive.

InvalidMarkerSizeRel

The marker-to-square size ratio is non-finite or outside (0, 1].

InvalidBorderBits

The ArUco marker border width is not strictly positive.

InvalidCircleDiameter

The circle-to-square diameter ratio is non-finite or outside (0, 1].

MissingMarkerBoardCellSize

A marker board layout omits the millimeter cell size required to place it on a printable page.

InvalidCircleCell

A marker circle coordinate falls outside the board’s square grid.

DuplicateCircleCells

Two or more marker circles are placed in the same board cell.

NotEnoughDictionaryCodes

The chosen ArUco dictionary has fewer codes than the board needs.

Fields

needed: usize

Number of distinct marker codes the board layout requires.

available: usize

Number of marker codes available in the selected dictionary.

BoardDoesNotFit

The board’s physical size exceeds the page’s printable area.

Fields

board_width_mm: f64

Board width in millimeters.

board_height_mm: f64

Board height in millimeters.

printable_width_mm: f64

Printable-area width in millimeters (page width minus margins).

printable_height_mm: f64

Printable-area height in millimeters (page height minus margins).

CharucoBoard(CharucoBoardError)

Validation of the underlying ChArUco board layout failed.

InvalidPuzzleBoardSize

A PuzzleBoard spec requests a row or column count outside the valid range.

InvalidPuzzleBoardOrigin

A PuzzleBoard’s origin plus size extends past the 501×501 master pattern.

InvalidPuzzleBoardDotDiameter

The PuzzleBoard edge-dot diameter ratio is outside (0, 1].

PuzzleBoardSpec(PuzzleBoardSpecError)

Validation of the underlying PuzzleBoard specification failed.

Trait Implementations

impl Debug for PrintableTargetError

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

Formats the value using the given formatter.

impl Display for PrintableTargetError

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

Formats the value using the given formatter.

impl Error for PrintableTargetError

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<CharucoBoardError> for PrintableTargetError

fn from(source: CharucoBoardError) -> Self

Converts to this type from the input type.

impl From<EncodingError> for PrintableTargetError

fn from(value: EncodingError) -> Self

Converts to this type from the input type.

impl From<Error> for PrintableTargetError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for PrintableTargetError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<PuzzleBoardSpecError> for PrintableTargetError

fn from(source: PuzzleBoardSpecError) -> Self

Converts to this type from the input type.