Import Data Structures
This section describes basic metadata structures used to represent various scene objects, such as cameras, lights, meshes, etc.
ImportAnimation Structure
This data structure contains metadata on an imported animation and has the following set of properties:
| name | Name of the animation. |
| min_time | Start time of the animation in seconds. |
| max_time | End time of the animation in seconds. |
struct ImportAnimation
{
String name;
float min_time;
float max_time;
};ImportCamera Structure
This data structure contains metadata on an imported camera and has the following set of properties:
| node | Scene node to which the camera is attached as an attribute. |
| data | Camera metadata. |
struct ImportCamera
{
ImportNode *node = nullptr;
UserData *data = nullptr;
};ImportLight Structure
This data structure contains metadata on an imported light and has the following set of properties:
| node | Scene node to which the light is attached as an attribute. |
| data | Light metadata. |
struct ImportLight
{
ImportNode *node = nullptr;
UserData *data = nullptr;
};ImportMesh Structure
This data structure contains metadata on an imported mesh and has the following set of properties:
| name | Mesh name. |
| filepath | Path to the mesh file. |
| animation_filepath | Path to the animation file. |
| has_animations | Flag indicating whether the mesh has aminations or not. |
| nodes | List of nodes to which the mesh is attached as an attribute. |
| geometries | Mesh geometry. A vector of ImportGeometry |
struct ImportMesh
{
String name;
String filepath;
String animation_filepath;
bool has_animations = false;
Vector<ImportNode *> nodes;
Vector<ImportGeometry> geometries;
};ImportMaterial Structure
This data structure contains metadata on an imported material and has the following set of properties:
| name | Material name. |
| filepath | Path to the material's *.mat file. |
| data | Material metadata. |
struct ImportMaterial
{
String name;
String filepath;
UserData *data = nullptr;
};ImportNode Structure
This data structure contains metadata on an imported node and has the following set of properties:
| name | Scene node name. |
| filepath | Path to the node file. |
| parent | Parent node. |
| children | List of all node children. |
| mesh | Mesh node attribute. ImportMesh structure pointer if a mesh attribute is assigned to the node; otherwise, nullptr. |
| light | Light node attribute. ImportLight structure pointer if a light attribute is assigned to the node; otherwise, nullptr. |
| camera | Camera node attribute. ImportCamera structure pointer if a camera attribute is assigned to the node; otherwise, nullptr. |
| transform | Node's transformation matrix. |
| data | Node metadata. |
struct ImportNode
{
String name;
String filepath;
ImportNode *parent;
Vector<ImportNode *> children;
ImportMesh *mesh = nullptr;
ImportLight *light = nullptr;
ImportCamera *camera = nullptr;
Unigine::Math::dmat4 transform;
UserData *data = nullptr;
};ImportTexture Structure
This data structure contains metadata on an imported texture and has the following set of properties:
| filepath | Path to the texture file. |
| original_filepath | Path to the original texture file. |
struct ImportTexture
{
String filepath;
String original_filepath;
};ImportSurface Structure
This data structure contains metadata on an imported surface and has the following set of properties:
| filepath | Surface name. |
| filepath | Path to the mesh file. |
| min_visible_distance | Minimum visibility distance for the surface. |
| max_visible_distance | Minimum visibility distance for the surface. |
| material | Material assigned to the surface. ImportMaterial structure pointer if a material is assigned to the surface; otherwise, nullptr. |
| target_surface | Morph target surface number if any; otherwise, -1. |
| data | Surface metadata. |
struct ImportSurface
{
String name;
String filepath;
float min_visible_distance = -UNIGINE_INFINITY;
float max_visible_distance = UNIGINE_INFINITY;
ImportMaterial *material = nullptr;
int target_surface = -1;
UserData *data = nullptr;
};ImportGeometry Structure
This data structure contains metadata on an imported geometry and has the following set of properties:
| transform | Transformation matrix. |
| surfaces | List of surfaces as a vector of ImportSurface structures. |
| data | Geometry metadata. |
struct ImportGeometry
{
Math::dmat4 transform;
Vector<ImportSurfacegt; surfaces;
UserData *data;
};