Enum RenderError 

pub enum RenderError {
    EmptyScore,
    InvalidRow {
        row: usize,
    },
    ViewResolution {
        view_id: String,
        reason: String,
    },
    InvalidLayout {
        reason: String,
    },
    InvalidOptions {
        reason: String,
    },
    UnsupportedClef,
    UnsupportedAccidental {
        alter: i8,
    },
    InvalidTabPosition {
        string: u8,
        lines: u8,
    },
    TabMetricsOverflow,
    MeasureTextTooLarge {
        size: usize,
    },
    InvalidMeasureTextOffset {
        field: &'static str,
    },
    InvalidNotePlacement {
        field: &'static str,
    },
    InvalidXmlCharacter {
        codepoint: u32,
    },
    Annotation(RenderAnnotationError),
}

Errors returned by render_svg / render_svg_with_layout.

These are all system-boundary validation failures — an arbitrary Score can reference notation this renderer does not (yet) support. Never fails silently: unsupported notation or an accidental beyond double-sharp/double-flat is reported, not dropped or approximated.

Variants

EmptyScore

The score has no staves to render (no parts, or no parts with staves).

InvalidRow

A requested system row does not exist in the supplied layout.

Fields

row: usize

ViewResolution

A linked score view could not be resolved to a renderable score snapshot.

Fields

view_id: String

reason: String

InvalidLayout

The score and precomputed layout do not have compatible indices.

Fields

reason: String

InvalidOptions

Rendering dimensions or system settings are not finite and positive.

Fields

reason: String

UnsupportedClef

A staff uses a clef this renderer has no staff-position mapping for.

UnsupportedAccidental

A pitch’s alter is outside the supported range (-2..=2: double-flat..double-sharp).

Fields

alter: i8

InvalidTabPosition

A tablature position cannot be represented by the owning staff.

Fields

string: u8

lines: u8

TabMetricsOverflow

Tablature glyph metrics overflowed before SVG emission.

MeasureTextTooLarge

A measure-level styled text entry exceeds the bounded renderer input size.

Fields

size: usize

InvalidMeasureTextOffset

A measure-level styled text offset is not finite or cannot fit SVG coordinates.

Fields

field: &'static str

InvalidNotePlacement

A note-level MusicXML placement offset is not finite or cannot fit SVG coordinates.

Fields

field: &'static str

InvalidXmlCharacter

A score text contains a character that XML 1.0 cannot represent.

Fields

codepoint: u32

Annotation(RenderAnnotationError)

Host-provided annotation validation failed.

Trait Implementations

impl Clone for RenderError

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

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, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for RenderError

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 PartialEq for RenderError

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for RenderError