Struct Instance

pub struct Instance<'a> {
    pub type_name: String,
    pub data: InstanceDataFormat<'a>,
    pub fields: LinkedHashMap<String, FieldTemplate>,
    /* private fields */
}

Represents a block of data inside the blend file. An Instance can be a camera, a mesh, a material, or anything else Blender uses internally, like material nodes, user settings or render options. An Instance is conceptually a struct: a collection of named fields which can themselves be structs or primitives.

Fields

type_name: String

data: InstanceDataFormat<'a>

The raw binary data this Instance owns.

fields: LinkedHashMap<String, FieldTemplate>

The fields of this Instance.

Implementations

impl<'a> Instance<'a>

pub fn dna(&self) -> &Dna

pub fn raw(&self) -> &RawBlend

pub fn code(&self) -> [u8; 4]

If this Instance was created from a primary/root Block it will have a code. Possible codes include “OB” for objects, “ME” for meshes, “CA” for cameras, etc.

Panics

Panics if the instance’s underlying data doesn’t have a code

pub fn memory_address(&self) -> NonZeroU64

If this Instance was created from a primary/root or subsidiary Block it will have a memory address. Blender dumps its memory into the blend file when saving and the old memory addresses are used the recreate the connections between blocks when loading the file again.

Panics

Panics if the instance underlying data doesn’t have an old memory address.

pub fn is_valid<T: AsRef<str>>(&self, name: T) -> bool

Tests whether a field is valid and can be accessed using the get methods without panicking. Which get method you have to use depends on the field type.

pub fn get_u8<T: AsRef<str>>(&self, name: T) -> u8

pub fn get_i8<T: AsRef<str>>(&self, name: T) -> i8

pub fn get_char<T: AsRef<str>>(&self, name: T) -> char

pub fn get_u16<T: AsRef<str>>(&self, name: T) -> u16

pub fn get_i16<T: AsRef<str>>(&self, name: T) -> i16

pub fn get_i32<T: AsRef<str>>(&self, name: T) -> i32

pub fn get_u32<T: AsRef<str>>(&self, name: T) -> u32

pub fn get_f32<T: AsRef<str>>(&self, name: T) -> f32

pub fn get_f64<T: AsRef<str>>(&self, name: T) -> f64

pub fn get_u64<T: AsRef<str>>(&self, name: T) -> u64

pub fn get_i64<T: AsRef<str>>(&self, name: T) -> i64

pub fn get_u8_vec<T: AsRef<str>>(&self, name: T) -> Vec<u8>

pub fn get_i8_vec<T: AsRef<str>>(&self, name: T) -> Vec<i8>

pub fn get_i32_vec<T: AsRef<str>>(&self, name: T) -> Vec<i32>

pub fn get_u32_vec<T: AsRef<str>>(&self, name: T) -> Vec<u32>

pub fn get_i16_vec<T: AsRef<str>>(&self, name: T) -> Vec<i16>

pub fn get_u16_vec<T: AsRef<str>>(&self, name: T) -> Vec<u16>

pub fn get_f32_vec<T: AsRef<str>>(&self, name: T) -> Vec<f32>

pub fn get_f64_vec<T: AsRef<str>>(&self, name: T) -> Vec<f64>

pub fn get_u64_vec<T: AsRef<str>>(&self, name: T) -> Vec<u64>

pub fn get_i64_vec<T: AsRef<str>>(&self, name: T) -> Vec<i64>

pub fn get_string<T: AsRef<str>>(&self, name: T) -> String

Example

let obj = blend.instances_with_code(*b"OB").next().unwrap();
let name = obj.get("id").get_string("name");

Panics

• Panics if the field cannot be read as a string.

pub fn get<T: AsRef<str>>(&self, name: T) -> Instance<'a>

Used to access fields which are structs.

Example

let obj = blend.instances_with_code(*b"OB").next().expect("no object found");
let id = obj.get("id");
let data = obj.get("data");

Panics

• Panics if the field is not a valid struct.

pub fn get_iter<T: AsRef<str>>( &self, name: T, ) -> impl Iterator<Item = Instance<'a>>

Used to access fields which are lists of structs.

Example

let obj = blend.instances_with_code(*b"OB").skip(1).next().unwrap();
let materials = obj.get_iter("mat").collect::<Vec<_>>();

Panics

• Panics if the field is not a valid list of structs.

Trait Implementations

impl<'a> Clone for Instance<'a>

fn clone(&self) -> Instance<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Instance<'a>

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

Formats the value using the given formatter.

impl Display for Instance<'_>

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

Formats the value using the given formatter.