Struct Instance

pub struct Instance<T: Instantiate> {
    pub sid: Option<String>,
    pub url: UrlRef<T>,
    pub name: Option<String>,
    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.

name: Option<String>

The text string name of this element.

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>.

pub fn get_instance_material(&self, symbol: &str) -> Option<&InstanceMaterial>

Look up an InstanceMaterial by symbol name.

impl<T: Instantiate> Instance<T>

pub fn new(url: Url) -> Self

Construct a new instance pointing at the given Url (which should reference an object of type T).

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 From<Instance<Geometry>> for ShapeGeom

fn from(v: Instance<Geometry>) -> Self

Converts to this type from the input type.

impl<T: Instantiate> From<Instance<T>> for DefInstance<T>

fn from(v: Instance<T>) -> Self

Converts to this type from the input type.