Module fbxcel_dom::v7400::object

source · [−]

Expand description

Objects-related stuff.

Object

There are some data associated to objects.

Object metadata

Each object node has object metadata. A metadata consists of four elements:

Object ID

Each object has object ID, which is unique in the document.

Some objects have ID but have no corresponding nodes (in low-level tree). Usually they are safely ignorable.

This is represented by ObjectId, and can be retrieved by ObjectHandle::object_id().

Name

Objects may have names. Note that the name can be empty string, and not guaranteed to be unique.

This can be retrieved by ObjectHandle::name().

Class and subclass

These are used to distinguish actual data type (usage) of the object.

It is not users’ business to know their mappings, so fbxcel_dom provides ObjectHandle::get_typed() to automatically cast the object handle to “usable” handle types.

However, fbxcel_dom is not perfect and would miss many mappings (because FBX is proprietary format, and specification is not open). If users want to use object types which are unsupported by fbxcel_dom, they can implement new object handle types by their own, and/or use lower-level APIs (such as ObjectHandle::source_objects(), ObjectHandle::destination_objects(), and fbxcel::tree APIs).

They can be retrieved by ObjectHandle::class() and ObjectHandle::subclass().