Enum ExportError 

pub enum ExportError {
    NoRenderGeometry,
    TooLarge {
        bytes: u64,
    },
    Serialization {
        stage: &'static str,
        detail: String,
    },
    MalformedMeshInput {
        detail: String,
    },
}

A failure the caller must handle; completion of a try_export_* function implies a non-empty artifact.

Variants

NoRenderGeometry

The visible mesh set was empty: the model has no render geometry (or the caller’s visibility filters removed all of it). The export would not be a valid file: an empty GLB has empty accessors, bufferViews, meshes and nodes arrays (glTF schema minItems: 1) and a zero buffers[0].byteLength (schema minimum: 1), and an empty COLLADA document has empty libraries its schema requires children in. Some downstream tools still accept such a file silently, so this is surfaced as an error rather than an artifact.

TooLarge

The projected single-GLB output exceeds the glTF 32-bit (4 GiB) container / buffer limit — the model is too large for one GLB and must be exported as a multi-buffer glTF instead. Carries the projected total container size in bytes (from pass 1), so a caller can log it or size a buffer split without re-meshing. Replaces the historical 4 GiB panic! on the checked export paths (issue #1516).

Fields

bytes: u64

Projected total GLB container size in bytes (may be a lower bound once oversize; see crate::GlbSizeProjection::total_bytes).

Serialization

A downstream encoder (Arrow/Parquet columnar writer, ZIP container, or JSON serializer) rejected the data it was handed. This is an I/O/library failure rather than a business-logic outcome — replaces panicking .unwrap()/.expect() calls on writer/serializer results so a malformed or resource-exhausted encode returns an error instead of unwinding the whole export (see the parquet_bos exporter).

Fields

stage: &'static str

What was being serialized/written (e.g. “entities batch”, “zip write_all”).

detail: String

The underlying error’s Display output.

MalformedMeshInput

A from-meshes writer was handed inconsistent inputs. Two shapes, and they fail differently:

• a COUNT that runs past a buffer — the per-mesh vertex_counts / index_counts sum past the end of the flattened positions / normals / indices. The infallible crate::export_glb_from_meshes silently drops the un-backed tail (a valid GLB missing part of the model, reported as success);
• an index BLOCK that is not whole triangles, or an index VALUE that is not a vertex of its own mesh. The GLB assembler copies the index buffer verbatim, so either reaches the file and glTF-Validator rejects the result (glTF 2.0 3.7.2.1).

try_export_glb_from_meshes and try_export_collada_from_meshes surface both, through one index-block predicate (#4684), so a caller bug can’t ship truncated or invalid geometry from either.

Fields

detail: String

Which buffer was too short (expected vs actual lengths), or which mesh carried which out-of-range index.

Implementations

impl ExportError

pub fn code(&self) -> &'static str

Stable machine-readable code, mirrored across the wasm boundary so TS callers can match on it without parsing prose.

Trait Implementations

impl Clone for ExportError

fn clone(&self) -> ExportError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ExportError

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

Formats the value using the given formatter.

impl Display for ExportError

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

Formats the value using the given formatter.

impl Error for ExportError

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 ExportError

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for ExportError

impl StructuralPartialEq for ExportError