Struct SemanticScene 

pub struct SemanticScene<ObjectCategory, RegionCategory> { /* private fields */ }

Scene containing semantically annotated levels, regions, and objects.

A scene owns its levels, levels own their regions, and regions own their objects. Category payloads are dataset-specific generic types.

Implementations

impl<ObjectCategory, RegionCategory> SemanticScene<ObjectCategory, RegionCategory>

pub fn from_parts( name: impl Into<String>, label: impl Into<String>, counts: HashMap<&'static str, usize>, aabb: Option<Aabb>, levels: Vec<SemanticLevel<ObjectCategory, RegionCategory>>, ) -> Self

Creates a scene from its nested model parts.

The levels vector owns the full nested scene graph: levels contain regions, and regions contain objects. counts stores descriptor header counts by their dataset-specific names.

pub fn name(&self) -> &str

Returns the scene name from the descriptor header.

pub fn label(&self) -> &str

Returns the scene label from the descriptor header.

pub const fn aabb(&self) -> Option<&Aabb>

Returns the scene axis-aligned bounding box.

This is optional because a malformed or partially built scene may not have a parsed header.

pub fn levels(&self) -> &[SemanticLevel<ObjectCategory, RegionCategory>]

Returns all levels in the scene.

pub fn regions( &self, ) -> impl Iterator<Item = &SemanticRegion<ObjectCategory, RegionCategory>>

Returns all regions in the scene.

pub fn objects(&self) -> impl Iterator<Item = &SemanticObject<ObjectCategory>>

Returns all semantic objects in the scene.

impl SemanticScene<(), ()>

pub fn load<D: Dataset>( path: impl AsRef<Path>, options: D::Options, ) -> Result<SemanticScene<D::ObjectCategory, D::RegionCategory>, D::Error>

where D::Error: From<Error>,

Loads a scene from a path using a dataset implementation.

Errors

Returns I/O errors from opening the file or dataset-specific parse and validation failures.

pub fn from_reader<D: Dataset, R: BufRead>( reader: R, options: D::Options, ) -> Result<SemanticScene<D::ObjectCategory, D::RegionCategory>, D::Error>

Loads a scene from any buffered reader using a dataset implementation.

Errors

Returns dataset-specific I/O, parse, and validation failures.

pub fn from_str<D: Dataset>( input: &str, options: D::Options, ) -> Result<SemanticScene<D::ObjectCategory, D::RegionCategory>, D::Error>

Loads a scene from an in-memory string using a dataset implementation.

Errors

Returns dataset-specific parse and validation failures.

Trait Implementations

impl<ObjectCategory: Clone, RegionCategory: Clone> Clone for SemanticScene<ObjectCategory, RegionCategory>

fn clone(&self) -> SemanticScene<ObjectCategory, RegionCategory>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<ObjectCategory: Debug, RegionCategory: Debug> Debug for SemanticScene<ObjectCategory, RegionCategory>

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

Formats the value using the given formatter.

impl<ObjectCategory, RegionCategory> Default for SemanticScene<ObjectCategory, RegionCategory>

fn default() -> Self

Returns the “default value” for a type.

impl<ObjectCategory, RegionCategory> Display for SemanticScene<ObjectCategory, RegionCategory>

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

Formats the value using the given formatter.