Enum BlockGraphError 

#[non_exhaustive]
pub enum BlockGraphError {
    BlockExists(IVec3),
    BlockPositionOccupied(IVec3),
    ModuleBlockOverlap {
        position: IVec3,
        first: Arc<MaterializedModuleSite>,
        second: Arc<MaterializedModuleSite>,
    },
    BlockNotFound(IVec3),
    InvalidTag {
        tag: String,
    },
    PipeNotFound(IVec3, IVec3),
    PipeExists(IVec3, IVec3),
    CoordinateOverflow {
        position: IVec3,
        offset: IVec3,
    },
    CoordinateNormalizationOverflow {
        min_z: i32,
        max_z: i32,
    },
    CoordinateRotationOverflow {
        position: IVec3,
        axis: UDirection,
    },
    MeasurementEdgeMissingTimeBasis(IVec3, IVec3),
    Invalid(InvalidBlockGraphError),
    InvalidAction(InvalidActionError),
    Io {
        path: PathBuf,
        source: Arc<Error>,
    },
    Block(BlockError),
    Parse(ParseError),
    ModuleSource(Arc<ModuleError>),
    HierarchyRequiresFlatten {
        operation: &'static str,
    },
    ModuleMaterialization(Arc<ModuleCertificationError>),
    Zx(ZXError),
    FillPorts(FillPortsError),
    Stabilizer(StabilizerError),
    GltfSerialize(Arc<Error>),
    RotationUnsupportedDynamicBlocks,
    RotationRequiresHalfTurns,
    RotationWalkingRequiresTimeAxis,
    RotationCubeHeightRequiresTimeAxis,
}

Errors from constructing, editing, parsing, validating, transforming, or exporting a BlockGraph.

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.

BlockExists(IVec3)

A block already occupies the requested anchor position.

BlockPositionOccupied(IVec3)

A block footprint overlaps an occupied lattice cell.

ModuleBlockOverlap

Two materialized module blocks overlap at one lattice cell.

Fields

position: IVec3

Conflicting lattice cell.

first: Arc<MaterializedModuleSite>

First module site occupying the cell.

second: Arc<MaterializedModuleSite>

Second module site occupying the cell.

BlockNotFound(IVec3)

No block occupies the requested position.

InvalidTag

A tag is empty or contains a forbidden character.

Fields

tag: String

Rejected tag text.

PipeNotFound(IVec3, IVec3)

No pipe connects the requested endpoints.

PipeExists(IVec3, IVec3)

A pipe already connects the requested endpoints.

CoordinateOverflow

Adding an offset to a lattice position overflowed.

Fields

position: IVec3

Original lattice position.

offset: IVec3

Offset that could not be added.

CoordinateNormalizationOverflow

Normalizing the graph’s time span would overflow coordinates.

Fields

min_z: i32

Minimum time coordinate before normalization.

max_z: i32

Maximum time coordinate before normalization.

CoordinateRotationOverflow

Rotating a position would negate an unrepresentable coordinate.

Fields

position: IVec3

Position that could not be rotated.

axis: UDirection

Rotation axis whose component overflowed.

MeasurementEdgeMissingTimeBasis(IVec3, IVec3)

A measurement pipe has no inferable temporal basis.

Invalid(InvalidBlockGraphError)

The resulting block graph violates a graph invariant.

InvalidAction(InvalidActionError)

A classical action violates an action invariant.

Io

Reading or writing a graph file failed.

Fields

path: PathBuf

File path being accessed.

source: Arc<Error>

Underlying I/O failure.

Block(BlockError)

A block kind or property is invalid.

Parse(ParseError)

Bloq graph text could not be parsed.

ModuleSource(Arc<ModuleError>)

Executable BLOG module declarations or imports are invalid.

HierarchyRequiresFlatten

A flat geometry operation was requested on authored module structure.

Fields

operation: &'static str

Operation that cannot preserve the authored hierarchy or interface.

ModuleMaterialization(Arc<ModuleCertificationError>)

A BLOG module hierarchy could not be materialized as a graph.

Zx(ZXError)

ZX graph construction or analysis failed.

FillPorts(FillPortsError)

Open ports could not be filled consistently.

Stabilizer(StabilizerError)

Stabilizer construction or analysis failed.

GltfSerialize(Arc<Error>)

glTF JSON serialization failed.

RotationUnsupportedDynamicBlocks

Dynamic blocks support rotation only around the time axis.

RotationRequiresHalfTurns

Y blocks require rotations by an even number of quarter turns.

RotationWalkingRequiresTimeAxis

Walking and patch-rotation blocks support only time-axis rotation.

RotationCubeHeightRequiresTimeAxis

Non-default cube heights support only time-axis rotation.

Implementations

impl BlockGraphError

pub fn is_incomplete_action_program(&self) -> bool

Whether this action error can be repaired by adding another action.

Trait Implementations

impl Clone for BlockGraphError

fn clone(&self) -> BlockGraphError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BlockGraphError

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

Formats the value using the given formatter.

impl Display for BlockGraphError

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

Formats the value using the given formatter.

impl Error for BlockGraphError

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<BlockError> for BlockGraphError

fn from(source: BlockError) -> Self

Converts to this type from the input type.

impl From<BlockGraphError> for VerifyLogicalError

fn from(source: BlockGraphError) -> Self

Converts to this type from the input type.

impl From<BlockGraphError> for FeedbackInferenceError

fn from(source: BlockGraphError) -> Self

Converts to this type from the input type.

impl From<BooleanResourceError> for BlockGraphError

fn from(error: BooleanResourceError) -> Self

Converts to this type from the input type.

impl From<FillPortsError> for BlockGraphError

fn from(source: FillPortsError) -> Self

Converts to this type from the input type.

impl From<InvalidActionError> for BlockGraphError

fn from(source: InvalidActionError) -> Self

Converts to this type from the input type.

impl From<InvalidBlockGraphError> for BlockGraphError

fn from(source: InvalidBlockGraphError) -> Self

Converts to this type from the input type.

impl From<ParseError> for BlockGraphError

fn from(source: ParseError) -> Self

Converts to this type from the input type.

impl From<StabilizerError> for BlockGraphError

fn from(source: StabilizerError) -> Self

Converts to this type from the input type.

impl From<ZXError> for BlockGraphError

fn from(source: ZXError) -> Self

Converts to this type from the input type.