Struct dae_parser::Instance

pub struct Instance<T: Instantiate> {
    pub sid: Option<String>,
    pub url: UrlRef<T>,
    pub data: T::Data,
    pub extra: Vec<Extra>,
}

Instantiates a COLLADA material resource, possibly applying transformations or effects to the object.

The data field depends on the type of object being instantiated. Most types use () for this field but some types have additional data:

• Instance<Geometry>: InstanceGeometryData
• Instance<Controller>: InstanceControllerData
• Instance<Effect>: InstanceEffectData
• Instance<PhysicsModel>: InstancePhysicsModelData

Additionally, some instance nodes are even more different and have their own types:

• InstanceMaterial, not Instance<Material>
• InstanceRigidBody, not Instance<RigidBody>
• InstanceRigidConstraint, not Instance<RigidConstraint>

Fields

sid: Option<String>

A text string containing the scoped identifier of this element. This value must be unique within the scope of the parent element.

url: UrlRef<T>

The URL of the location of the T element to instantiate. Can refer to a local instance or external reference.

data: T::Data

The additional data associated with the instantiation, if any.

extra: Vec<Extra>

Provides arbitrary additional information about this element.

Implementations

impl Instance<Geometry>

pub fn instance_materials(&self) -> &[InstanceMaterial]

Get the list of InstanceMaterials bound in this Instance<Geometry>.

Trait Implementations

impl<T: Clone + Instantiate> Clone for Instance<T> where
    T::Data: Clone, 

fn clone(&self) -> Instance<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug + Instantiate> Debug for Instance<T> where
    T::Data: Debug, 

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

Formats the value using the given formatter.

impl<T: Instantiate> XNode for Instance<T>

const NAME: &'static str

The name of the XML element.

fn parse(element: &Element) -> Result<Self, Error>

Parse an XML element into this type. In most cases, the parser will require with a debug_assert that the element to parse has name Self::NAME.

fn parse_box(element: &Element) -> Result<Box<Self>, Error>

Parse an XML element and return the data structure in a Box. This can be faster in some cases when the data structure is large.

fn parse_one<'a>(
    it: &mut impl Iterator<Item = &'a Element>
) -> Result<Self, Error>

Parse a single required element from the given element iterator.

fn parse_opt(it: &mut Peekable<Children<'_>>) -> Result<Option<Self>, Error>

Parse an optional element from the given element iterator, using Self::NAME to determine if it is the correct type.

fn parse_opt_box(
    it: &mut Peekable<Children<'_>>
) -> Result<Option<Box<Self>>, Error>

Parse an optional boxed element from the given element iterator, using Self::NAME to determine if it is the correct type.

fn parse_list(it: &mut Peekable<Children<'_>>) -> Result<Vec<Self>, Error>

Parse a list of elements from the given element iterator, as long as it continues yielding elements of name Self::NAME.

fn parse_list_n<const N: usize>(
    it: &mut Peekable<Children<'_>>
) -> Result<Vec<Self>, Error>

Parse a list of elements from the given element iterator, as long as it continues yielding elements of name Self::NAME, and assert that the resulting list has length at least N.