|
MayaFlux 1.0.0
Digital-First Multimedia Processing Framework
|
|
nodiscard |
Place every instance of a document through a table.
The document is a tree of a root element named forma carrying a version of 1. The root may also carry xmlns declarations, which are ignored, so the mf: prefix below can be declared for tools that validate namespaces. Its templates element holds template elements, each with an id and exactly one child, the factory, whose name is looked up in the table. Its surface elements hold instance elements with an id, a template naming a template, and the placement attributes the factory describes. Ids are unique across the document. A surface id is a name the host binds in surfaces.
An instance may also carry attributes of the document's own, all beginning with mf: and applied to the placed element through its Layer:
Placement is two phases. The structure is checked and every instance is decoded first, so a bad document fails before any Surface is touched. Then each prepared instance is placed in document order and the Layer attributes are applied.
| Source | Element type of the document tree, with a Reflect::RecordAccess. |
| table | Factories by name. |
| root | Root element of the document. |
| surfaces | Surfaces by the name the document's surface elements use. |
| error | Receives the reason, with a row, when nullopt is returned. |
Definition at line 777 of file Instantiate.hpp.
References MayaFlux::Portal::Forma::Detail::instantiate(), and instantiate_document().
Referenced by instantiate_document(), instantiate_document(), instantiate_document(), and instantiate_xml().