#ifndef UFBX_UFBX_H_INCLUDED
#define UFBX_UFBX_H_INCLUDED
// -- User configuration
#if defined(UFBX_CONFIG_HEADER)
#include UFBX_CONFIG_HEADER
#endif
// -- Headers
#if !defined(UFBX_NO_LIBC_TYPES)
#include <stdint.h>
#include <stddef.h>
#include <stdbool.h>
#endif
// -- Platform
#ifndef UFBX_STDC
#if defined(__STDC_VERSION__)
#define UFBX_STDC __STDC_VERSION__
#else
#define UFBX_STDC 0
#endif
#endif
#ifndef UFBX_CPP
#if defined(__cplusplus)
#define UFBX_CPP __cplusplus
#else
#define UFBX_CPP 0
#endif
#endif
#ifndef UFBX_PLATFORM_MSC
#if !defined(UFBX_STANDARD_C) && defined(_MSC_VER)
#define UFBX_PLATFORM_MSC _MSC_VER
#else
#define UFBX_PLATFORM_MSC 0
#endif
#endif
#ifndef UFBX_PLATFORM_GNUC
#if !defined(UFBX_STANDARD_C) && defined(__GNUC__)
#define UFBX_PLATFORM_GNUC __GNUC__
#else
#define UFBX_PLATFORM_GNUC 0
#endif
#endif
#ifndef UFBX_CPP11
// MSVC does not advertise C++11 by default so we need special detection
#if UFBX_CPP >= 201103L || (UFBX_CPP > 0 && UFBX_PLATFORM_MSC >= 1900)
#define UFBX_CPP11 1
#else
#define UFBX_CPP11 0
#endif
#endif
#if defined(_MSC_VER)
#pragma warning(push)
#pragma warning(disable: 4061) // enumerator 'ENUM' in switch of enum 'enum' is not explicitly handled by a case label
#pragma warning(disable: 4201) // nonstandard extension used: nameless struct/union
#pragma warning(disable: 4505) // unreferenced local function has been removed
#pragma warning(disable: 4820) // type': 'N' bytes padding added after data member 'member'
#elif defined(__clang__)
#pragma clang diagnostic push
#pragma clang diagnostic ignored "-Wpedantic"
#pragma clang diagnostic ignored "-Wpadded"
#if defined(__cplusplus)
#pragma clang diagnostic ignored "-Wzero-as-null-pointer-constant"
#pragma clang diagnostic ignored "-Wold-style-cast"
#endif
#elif defined(__GNUC__)
#pragma GCC diagnostic push
#pragma GCC diagnostic ignored "-Wpedantic"
#pragma GCC diagnostic ignored "-Wpadded"
#if defined(__cplusplus)
#pragma GCC diagnostic ignored "-Wzero-as-null-pointer-constant"
#pragma GCC diagnostic ignored "-Wold-style-cast"
#else
#if __GNUC__ >= 5
#pragma GCC diagnostic ignored "-Wc90-c99-compat"
#pragma GCC diagnostic ignored "-Wc99-c11-compat"
#endif
#endif
#endif
#if UFBX_PLATFORM_MSC
#define ufbx_inline static __forceinline
#elif UFBX_PLATFORM_GNUC
#define ufbx_inline static inline __attribute__((always_inline, unused))
#else
#define ufbx_inline static
#endif
// Assertion function used in ufbx, defaults to C standard `assert()`.
// You can define this to your custom preferred assert macro, but in that case
// make sure that it is also used within `ufbx.c`.
// Defining `UFBX_NO_ASSERT` to any value disables assertions.
#ifndef ufbx_assert
#if defined(UFBX_NO_ASSERT) || defined(UFBX_NO_LIBC)
#define ufbx_assert(cond) (void)0
#else
#include <assert.h>
#define ufbx_assert(cond) assert(cond)
#endif
#endif
// Pointer may be `NULL`.
#define ufbx_nullable
// Changing this value from default or calling this function can lead into
// breaking API guarantees.
#define ufbx_unsafe
// Linkage of the main ufbx API functions.
// Defaults to nothing, or `static` if `UFBX_STATIC` is defined.
// If you want to isolate ufbx to a single translation unit you can do the following:
// #define UFBX_STATIC
// #include "ufbx.h"
// #include "ufbx.c"
#ifndef ufbx_abi
#if defined(UFBX_STATIC)
#define ufbx_abi static
#else
#define ufbx_abi
#endif
#endif
// Linkage of the main ufbx data fields in the header.
// Defaults to `extern`, or `static` if `UFBX_STATIC` is defined.
#ifndef ufbx_abi_data
#if defined(UFBX_STATIC)
#define ufbx_abi_data static
#else
#define ufbx_abi_data extern
#endif
#endif
// Linkage of the main ufbx data fields in the source.
// Defaults to nothing, or `static` if `UFBX_STATIC` is defined.
#ifndef ufbx_abi_data_definition
#if defined(UFBX_STATIC)
#define ufbx_abi_data_def static
#else
#define ufbx_abi_data_def
#endif
#endif
// -- Configuration
#ifndef UFBX_REAL_TYPE
#if defined(UFBX_REAL_IS_FLOAT)
#define UFBX_REAL_TYPE float
#else
#define UFBX_REAL_TYPE double
#endif
#endif
// Limits for embedded arrays within structures.
#define UFBX_ERROR_STACK_MAX_DEPTH 8
#define UFBX_PANIC_MESSAGE_LENGTH 128
#define UFBX_ERROR_INFO_LENGTH 256
// Number of thread groups to use if threading is enabled.
// A thread group processes a number of tasks and is then waited and potentially
// re-used later. In essence, this controls the granularity of threading.
#define UFBX_THREAD_GROUP_COUNT 4
// -- Language
// bindgen-disable
#if UFBX_CPP11
template <typename T, typename U>
struct ufbxi_type_is { };
template <typename T>
struct ufbxi_type_is<T, T> { using type = int; };
template <typename T>
struct ufbx_converter { };
#define UFBX_CONVERSION_IMPL(p_name) \
template <typename T, typename S=typename ufbxi_type_is<T, decltype(ufbx_converter<T>::from(*(const p_name*)nullptr))>::type> \
operator T() const { return ufbx_converter<T>::from(*this); }
#define UFBX_CONVERSION_TO_IMPL(p_name) \
template <typename T, typename S=typename ufbxi_type_is<p_name, decltype(ufbx_converter<T>::to(*(const T*)nullptr))>::type> \
p_name(const T &t) { *this = ufbx_converter<T>::to(t); }
#define UFBX_CONVERSION_LIST_IMPL(p_name) \
template <typename T, typename S=typename ufbxi_type_is<T, decltype(ufbx_converter<T>::from_list((p_name*)nullptr, (size_t)0))>::type> \
operator T() const { return ufbx_converter<T>::from_list(data, count); }
#else
#define UFBX_CONVERSION_IMPL(p_name)
#define UFBX_CONVERSION_TO_IMPL(p_name)
#define UFBX_CONVERSION_LIST_IMPL(p_name)
#endif
#if defined(__cplusplus)
#define UFBX_LIST_TYPE(p_name, p_type) struct p_name { p_type *data; size_t count; \
p_type &operator[](size_t index) const { ufbx_assert(index < count); return data[index]; } \
p_type *begin() const { return data; } \
p_type *end() const { return data + count; } \
UFBX_CONVERSION_LIST_IMPL(p_type) \
}
#else
#define UFBX_LIST_TYPE(p_name, p_type) typedef struct p_name { p_type *data; size_t count; } p_name
#endif
// This cannot be enabled automatically if supported as the source file may be
// compiled with a different compiler using different settings than the header
// consumers, in practice it should work but it causes issues such as #70.
#if (UFBX_STDC >= 202311L || UFBX_CPP11) && defined(UFBX_USE_EXPLICIT_ENUM)
#define UFBX_ENUM_REPR : int
#define UFBX_ENUM_FORCE_WIDTH(p_prefix)
#define UFBX_FLAG_REPR : int
#define UFBX_FLAG_FORCE_WIDTH(p_prefix)
#define UFBX_HAS_FORCE_32BIT 0
#else
#define UFBX_ENUM_REPR
#define UFBX_ENUM_FORCE_WIDTH(p_prefix) p_prefix##_FORCE_32BIT = 0x7fffffff
#define UFBX_FLAG_REPR
#define UFBX_FLAG_FORCE_WIDTH(p_prefix) p_prefix##_FORCE_32BIT = 0x7fffffff
#define UFBX_HAS_FORCE_32BIT 1
#endif
#define UFBX_ENUM_TYPE(p_name, p_prefix, p_last) \
enum { p_prefix##_COUNT = p_last + 1 }
#if UFBX_CPP
#define UFBX_VERTEX_ATTRIB_IMPL(p_type) \
p_type &operator[](size_t index) const { ufbx_assert(index < indices.count); return values.data[indices.data[index]]; }
#else
#define UFBX_VERTEX_ATTRIB_IMPL(p_type)
#endif
#if UFBX_CPP11
#define UFBX_CALLBACK_IMPL(p_name, p_fn, p_return, p_params, p_args) \
template <typename F> static p_return _cpp_adapter p_params { F &f = *static_cast<F*>(user); return f p_args; } \
p_name() = default; \
p_name(p_fn *f) : fn(f), user(nullptr) { } \
template <typename F> p_name(F *f) : fn(&_cpp_adapter<F>), user(static_cast<void*>(f)) { }
#else
#define UFBX_CALLBACK_IMPL(p_name, p_fn, p_return, p_params, p_args)
#endif
// bindgen-enable
// -- Version
// Packing/unpacking for `UFBX_HEADER_VERSION` and `ufbx_source_version`.
#define ufbx_pack_version(major, minor, patch) ((uint32_t)(major)*1000000u + (uint32_t)(minor)*1000u + (uint32_t)(patch))
#define ufbx_version_major(version) ((uint32_t)(version)/1000000u%1000u)
#define ufbx_version_minor(version) ((uint32_t)(version)/1000u%1000u)
#define ufbx_version_patch(version) ((uint32_t)(version)%1000u)
// Version of the ufbx header.
// `UFBX_VERSION` is simply an alias of `UFBX_HEADER_VERSION`.
// `ufbx_source_version` contains the version of the corresponding source file.
// HINT: The version can be compared numerically to the result of `ufbx_pack_version()`,
// for example `#if UFBX_VERSION >= ufbx_pack_version(0, 12, 0)`.
#define UFBX_HEADER_VERSION ufbx_pack_version(0, 15, 0)
#define UFBX_VERSION UFBX_HEADER_VERSION
// -- Basic types
// Main floating point type used everywhere in ufbx, defaults to `double`.
// If you define `UFBX_REAL_IS_FLOAT` to any value, `ufbx_real` will be defined
// as `float` instead.
// You can also manually define `UFBX_REAL_TYPE` to any floating point type.
typedef UFBX_REAL_TYPE ufbx_real;
// Null-terminated UTF-8 encoded string within an FBX file
typedef struct ufbx_string {
const char *data;
size_t length;
UFBX_CONVERSION_IMPL(ufbx_string)
} ufbx_string;
// Opaque byte buffer blob
typedef struct ufbx_blob {
const void *data;
size_t size;
UFBX_CONVERSION_IMPL(ufbx_blob)
} ufbx_blob;
// 2D vector
typedef struct ufbx_vec2 {
union {
struct { ufbx_real x, y; };
ufbx_real v[2];
};
UFBX_CONVERSION_IMPL(ufbx_vec2)
} ufbx_vec2;
// 3D vector
typedef struct ufbx_vec3 {
union {
struct { ufbx_real x, y, z; };
ufbx_real v[3];
};
UFBX_CONVERSION_IMPL(ufbx_vec3)
} ufbx_vec3;
// 4D vector
typedef struct ufbx_vec4 {
union {
struct { ufbx_real x, y, z, w; };
ufbx_real v[4];
};
UFBX_CONVERSION_IMPL(ufbx_vec4)
} ufbx_vec4;
// Quaternion
typedef struct ufbx_quat {
union {
struct { ufbx_real x, y, z, w; };
ufbx_real v[4];
};
UFBX_CONVERSION_IMPL(ufbx_quat)
} ufbx_quat;
// Order in which Euler-angle rotation axes are applied for a transform
// NOTE: The order in the name refers to the order of axes *applied*,
// not the multiplication order: eg. `UFBX_ROTATION_ORDER_XYZ` is `Z*Y*X`
// [TODO: Figure out what the spheric rotation order is...]
typedef enum ufbx_rotation_order UFBX_ENUM_REPR {
UFBX_ROTATION_ORDER_XYZ,
UFBX_ROTATION_ORDER_XZY,
UFBX_ROTATION_ORDER_YZX,
UFBX_ROTATION_ORDER_YXZ,
UFBX_ROTATION_ORDER_ZXY,
UFBX_ROTATION_ORDER_ZYX,
UFBX_ROTATION_ORDER_SPHERIC,
UFBX_ENUM_FORCE_WIDTH(UFBX_ROTATION_ORDER)
} ufbx_rotation_order;
UFBX_ENUM_TYPE(ufbx_rotation_order, UFBX_ROTATION_ORDER, UFBX_ROTATION_ORDER_SPHERIC);
// Explicit translation+rotation+scale transformation.
// NOTE: Rotation is a quaternion, not Euler angles!
typedef struct ufbx_transform {
ufbx_vec3 translation;
ufbx_quat rotation;
ufbx_vec3 scale;
UFBX_CONVERSION_IMPL(ufbx_transform)
} ufbx_transform;
// 4x3 matrix encoding an affine transformation.
// `cols[0..2]` are the X/Y/Z basis vectors, `cols[3]` is the translation
typedef struct ufbx_matrix {
union {
struct {
ufbx_real m00, m10, m20;
ufbx_real m01, m11, m21;
ufbx_real m02, m12, m22;
ufbx_real m03, m13, m23;
};
ufbx_vec3 cols[4];
ufbx_real v[12];
};
UFBX_CONVERSION_IMPL(ufbx_matrix)
} ufbx_matrix;
typedef struct ufbx_void_list {
void *data;
size_t count;
} ufbx_void_list;
UFBX_LIST_TYPE(ufbx_bool_list, bool);
UFBX_LIST_TYPE(ufbx_uint32_list, uint32_t);
UFBX_LIST_TYPE(ufbx_real_list, ufbx_real);
UFBX_LIST_TYPE(ufbx_vec2_list, ufbx_vec2);
UFBX_LIST_TYPE(ufbx_vec3_list, ufbx_vec3);
UFBX_LIST_TYPE(ufbx_vec4_list, ufbx_vec4);
UFBX_LIST_TYPE(ufbx_string_list, ufbx_string);
// Sentinel value used to represent a missing index.
#define UFBX_NO_INDEX ((uint32_t)~0u)
// -- Document object model
typedef enum ufbx_dom_value_type UFBX_ENUM_REPR {
UFBX_DOM_VALUE_NUMBER,
UFBX_DOM_VALUE_STRING,
UFBX_DOM_VALUE_ARRAY_I8,
UFBX_DOM_VALUE_ARRAY_I32,
UFBX_DOM_VALUE_ARRAY_I64,
UFBX_DOM_VALUE_ARRAY_F32,
UFBX_DOM_VALUE_ARRAY_F64,
UFBX_DOM_VALUE_ARRAY_RAW_STRING,
UFBX_DOM_VALUE_ARRAY_IGNORED,
UFBX_ENUM_FORCE_WIDTH(UFBX_DOM_VALUE_TYPE)
} ufbx_dom_value_type;
UFBX_ENUM_TYPE(ufbx_dom_value_type, UFBX_DOM_VALUE_TYPE, UFBX_DOM_VALUE_ARRAY_IGNORED);
typedef struct ufbx_dom_node ufbx_dom_node;
typedef struct ufbx_dom_value {
ufbx_dom_value_type type;
ufbx_string value_str;
ufbx_blob value_blob;
int64_t value_int;
double value_float;
} ufbx_dom_value;
UFBX_LIST_TYPE(ufbx_dom_node_list, ufbx_dom_node*);
UFBX_LIST_TYPE(ufbx_dom_value_list, ufbx_dom_value);
struct ufbx_dom_node {
ufbx_string name;
ufbx_dom_node_list children;
ufbx_dom_value_list values;
};
// -- Properties
// FBX elements have properties which are arbitrary key/value pairs that can
// have inherited default values or be animated. In most cases you don't need
// to access these unless you need a feature not implemented directly in ufbx.
// NOTE: Prefer using `ufbx_find_prop[_len](...)` to search for a property by
// name as it can find it from the defaults if necessary.
typedef struct ufbx_prop ufbx_prop;
typedef struct ufbx_props ufbx_props;
// Data type contained within the property. All the data fields are always
// populated regardless of type, so there's no need to switch by type usually
// eg. `prop->value_real` and `prop->value_int` have the same value (well, close)
// if `prop->type == UFBX_PROP_INTEGER`. String values are not converted from/to.
typedef enum ufbx_prop_type UFBX_ENUM_REPR {
UFBX_PROP_UNKNOWN,
UFBX_PROP_BOOLEAN,
UFBX_PROP_INTEGER,
UFBX_PROP_NUMBER,
UFBX_PROP_VECTOR,
UFBX_PROP_COLOR,
UFBX_PROP_COLOR_WITH_ALPHA,
UFBX_PROP_STRING,
UFBX_PROP_DATE_TIME,
UFBX_PROP_TRANSLATION,
UFBX_PROP_ROTATION,
UFBX_PROP_SCALING,
UFBX_PROP_DISTANCE,
UFBX_PROP_COMPOUND,
UFBX_PROP_BLOB,
UFBX_PROP_REFERENCE,
UFBX_ENUM_FORCE_WIDTH(UFBX_PROP_TYPE)
} ufbx_prop_type;
UFBX_ENUM_TYPE(ufbx_prop_type, UFBX_PROP_TYPE, UFBX_PROP_REFERENCE);
// Property flags: Advanced information about properties, not usually needed.
typedef enum ufbx_prop_flags UFBX_FLAG_REPR {
// Supports animation.
// NOTE: ufbx ignores this and allows animations on non-animatable properties.
UFBX_PROP_FLAG_ANIMATABLE = 0x1,
// User defined (custom) property.
UFBX_PROP_FLAG_USER_DEFINED = 0x2,
// Hidden in UI.
UFBX_PROP_FLAG_HIDDEN = 0x4,
// Disallow modification from UI for components.
UFBX_PROP_FLAG_LOCK_X = 0x10,
UFBX_PROP_FLAG_LOCK_Y = 0x20,
UFBX_PROP_FLAG_LOCK_Z = 0x40,
UFBX_PROP_FLAG_LOCK_W = 0x80,
// Disable animation from components.
UFBX_PROP_FLAG_MUTE_X = 0x100,
UFBX_PROP_FLAG_MUTE_Y = 0x200,
UFBX_PROP_FLAG_MUTE_Z = 0x400,
UFBX_PROP_FLAG_MUTE_W = 0x800,
// Property created by ufbx when an element has a connected `ufbx_anim_prop`
// but doesn't contain the `ufbx_prop` it's referring to.
// NOTE: The property may have been found in the templated defaults.
UFBX_PROP_FLAG_SYNTHETIC = 0x1000,
// The property has at least one `ufbx_anim_prop` in some layer.
UFBX_PROP_FLAG_ANIMATED = 0x2000,
// Used by `ufbx_evaluate_prop()` to indicate the the property was not found.
UFBX_PROP_FLAG_NOT_FOUND = 0x4000,
// The property is connected to another one.
// This use case is relatively rare so `ufbx_prop` does not track connections
// directly. You can find connections from `ufbx_element.connections_dst` where
// `ufbx_connection.dst_prop` is this property and `ufbx_connection.src_prop` is defined.
UFBX_PROP_FLAG_CONNECTED = 0x8000,
// The value of this property is undefined (represented as zero).
UFBX_PROP_FLAG_NO_VALUE = 0x10000,
// This property has been overridden by the user.
// See `ufbx_anim.prop_overrides` for more information.
UFBX_PROP_FLAG_OVERRIDDEN = 0x20000,
// Value type.
// `REAL/VEC2/VEC3/VEC4` are mutually exclusive but may coexist with eg. `STRING`
// in some rare cases where the string defines the unit for the vector.
UFBX_PROP_FLAG_VALUE_REAL = 0x100000,
UFBX_PROP_FLAG_VALUE_VEC2 = 0x200000,
UFBX_PROP_FLAG_VALUE_VEC3 = 0x400000,
UFBX_PROP_FLAG_VALUE_VEC4 = 0x800000,
UFBX_PROP_FLAG_VALUE_INT = 0x1000000,
UFBX_PROP_FLAG_VALUE_STR = 0x2000000,
UFBX_PROP_FLAG_VALUE_BLOB = 0x4000000,
UFBX_FLAG_FORCE_WIDTH(UFBX_PROP_FLAGS)
} ufbx_prop_flags;
// Single property with name/type/value.
struct ufbx_prop {
ufbx_string name;
uint32_t _internal_key;
ufbx_prop_type type;
ufbx_prop_flags flags;
ufbx_string value_str;
ufbx_blob value_blob;
int64_t value_int;
union {
ufbx_real value_real_arr[4];
ufbx_real value_real;
ufbx_vec2 value_vec2;
ufbx_vec3 value_vec3;
ufbx_vec4 value_vec4;
};
};
UFBX_LIST_TYPE(ufbx_prop_list, ufbx_prop);
// List of alphabetically sorted properties with potential defaults.
// For animated objects in as scene from `ufbx_evaluate_scene()` this list
// only has the animated properties, the originals are stored under `defaults`.
struct ufbx_props {
ufbx_prop_list props;
size_t num_animated;
ufbx_nullable ufbx_props *defaults;
};
typedef struct ufbx_scene ufbx_scene;
// -- Elements
// Element is the lowest level representation of the FBX file in ufbx.
// An element contains type, id, name, and properties (see `ufbx_props` above)
// Elements may be connected to each other arbitrarily via `ufbx_connection`
typedef struct ufbx_element ufbx_element;
// Unknown
typedef struct ufbx_unknown ufbx_unknown;
// Nodes
typedef struct ufbx_node ufbx_node;
// Node attributes (common)
typedef struct ufbx_mesh ufbx_mesh;
typedef struct ufbx_light ufbx_light;
typedef struct ufbx_camera ufbx_camera;
typedef struct ufbx_bone ufbx_bone;
typedef struct ufbx_empty ufbx_empty;
// Node attributes (curves/surfaces)
typedef struct ufbx_line_curve ufbx_line_curve;
typedef struct ufbx_nurbs_curve ufbx_nurbs_curve;
typedef struct ufbx_nurbs_surface ufbx_nurbs_surface;
typedef struct ufbx_nurbs_trim_surface ufbx_nurbs_trim_surface;
typedef struct ufbx_nurbs_trim_boundary ufbx_nurbs_trim_boundary;
// Node attributes (advanced)
typedef struct ufbx_procedural_geometry ufbx_procedural_geometry;
typedef struct ufbx_stereo_camera ufbx_stereo_camera;
typedef struct ufbx_camera_switcher ufbx_camera_switcher;
typedef struct ufbx_marker ufbx_marker;
typedef struct ufbx_lod_group ufbx_lod_group;
// Deformers
typedef struct ufbx_skin_deformer ufbx_skin_deformer;
typedef struct ufbx_skin_cluster ufbx_skin_cluster;
typedef struct ufbx_blend_deformer ufbx_blend_deformer;
typedef struct ufbx_blend_channel ufbx_blend_channel;
typedef struct ufbx_blend_shape ufbx_blend_shape;
typedef struct ufbx_cache_deformer ufbx_cache_deformer;
typedef struct ufbx_cache_file ufbx_cache_file;
// Materials
typedef struct ufbx_material ufbx_material;
typedef struct ufbx_texture ufbx_texture;
typedef struct ufbx_video ufbx_video;
typedef struct ufbx_shader ufbx_shader;
typedef struct ufbx_shader_binding ufbx_shader_binding;
// Animation
typedef struct ufbx_anim_stack ufbx_anim_stack;
typedef struct ufbx_anim_layer ufbx_anim_layer;
typedef struct ufbx_anim_value ufbx_anim_value;
typedef struct ufbx_anim_curve ufbx_anim_curve;
// Collections
typedef struct ufbx_display_layer ufbx_display_layer;
typedef struct ufbx_selection_set ufbx_selection_set;
typedef struct ufbx_selection_node ufbx_selection_node;
// Constraints
typedef struct ufbx_character ufbx_character;
typedef struct ufbx_constraint ufbx_constraint;
// Audio
typedef struct ufbx_audio_layer ufbx_audio_layer;
typedef struct ufbx_audio_clip ufbx_audio_clip;
// Miscellaneous
typedef struct ufbx_pose ufbx_pose;
typedef struct ufbx_metadata_object ufbx_metadata_object;
UFBX_LIST_TYPE(ufbx_element_list, ufbx_element*);
UFBX_LIST_TYPE(ufbx_unknown_list, ufbx_unknown*);
UFBX_LIST_TYPE(ufbx_node_list, ufbx_node*);
UFBX_LIST_TYPE(ufbx_mesh_list, ufbx_mesh*);
UFBX_LIST_TYPE(ufbx_light_list, ufbx_light*);
UFBX_LIST_TYPE(ufbx_camera_list, ufbx_camera*);
UFBX_LIST_TYPE(ufbx_bone_list, ufbx_bone*);
UFBX_LIST_TYPE(ufbx_empty_list, ufbx_empty*);
UFBX_LIST_TYPE(ufbx_line_curve_list, ufbx_line_curve*);
UFBX_LIST_TYPE(ufbx_nurbs_curve_list, ufbx_nurbs_curve*);
UFBX_LIST_TYPE(ufbx_nurbs_surface_list, ufbx_nurbs_surface*);
UFBX_LIST_TYPE(ufbx_nurbs_trim_surface_list, ufbx_nurbs_trim_surface*);
UFBX_LIST_TYPE(ufbx_nurbs_trim_boundary_list, ufbx_nurbs_trim_boundary*);
UFBX_LIST_TYPE(ufbx_procedural_geometry_list, ufbx_procedural_geometry*);
UFBX_LIST_TYPE(ufbx_stereo_camera_list, ufbx_stereo_camera*);
UFBX_LIST_TYPE(ufbx_camera_switcher_list, ufbx_camera_switcher*);
UFBX_LIST_TYPE(ufbx_marker_list, ufbx_marker*);
UFBX_LIST_TYPE(ufbx_lod_group_list, ufbx_lod_group*);
UFBX_LIST_TYPE(ufbx_skin_deformer_list, ufbx_skin_deformer*);
UFBX_LIST_TYPE(ufbx_skin_cluster_list, ufbx_skin_cluster*);
UFBX_LIST_TYPE(ufbx_blend_deformer_list, ufbx_blend_deformer*);
UFBX_LIST_TYPE(ufbx_blend_channel_list, ufbx_blend_channel*);
UFBX_LIST_TYPE(ufbx_blend_shape_list, ufbx_blend_shape*);
UFBX_LIST_TYPE(ufbx_cache_deformer_list, ufbx_cache_deformer*);
UFBX_LIST_TYPE(ufbx_cache_file_list, ufbx_cache_file*);
UFBX_LIST_TYPE(ufbx_material_list, ufbx_material*);
UFBX_LIST_TYPE(ufbx_texture_list, ufbx_texture*);
UFBX_LIST_TYPE(ufbx_video_list, ufbx_video*);
UFBX_LIST_TYPE(ufbx_shader_list, ufbx_shader*);
UFBX_LIST_TYPE(ufbx_shader_binding_list, ufbx_shader_binding*);
UFBX_LIST_TYPE(ufbx_anim_stack_list, ufbx_anim_stack*);
UFBX_LIST_TYPE(ufbx_anim_layer_list, ufbx_anim_layer*);
UFBX_LIST_TYPE(ufbx_anim_value_list, ufbx_anim_value*);
UFBX_LIST_TYPE(ufbx_anim_curve_list, ufbx_anim_curve*);
UFBX_LIST_TYPE(ufbx_display_layer_list, ufbx_display_layer*);
UFBX_LIST_TYPE(ufbx_selection_set_list, ufbx_selection_set*);
UFBX_LIST_TYPE(ufbx_selection_node_list, ufbx_selection_node*);
UFBX_LIST_TYPE(ufbx_character_list, ufbx_character*);
UFBX_LIST_TYPE(ufbx_constraint_list, ufbx_constraint*);
UFBX_LIST_TYPE(ufbx_audio_layer_list, ufbx_audio_layer*);
UFBX_LIST_TYPE(ufbx_audio_clip_list, ufbx_audio_clip*);
UFBX_LIST_TYPE(ufbx_pose_list, ufbx_pose*);
UFBX_LIST_TYPE(ufbx_metadata_object_list, ufbx_metadata_object*);
typedef enum ufbx_element_type UFBX_ENUM_REPR {
UFBX_ELEMENT_UNKNOWN, // < `ufbx_unknown`
UFBX_ELEMENT_NODE, // < `ufbx_node`
UFBX_ELEMENT_MESH, // < `ufbx_mesh`
UFBX_ELEMENT_LIGHT, // < `ufbx_light`
UFBX_ELEMENT_CAMERA, // < `ufbx_camera`
UFBX_ELEMENT_BONE, // < `ufbx_bone`
UFBX_ELEMENT_EMPTY, // < `ufbx_empty`
UFBX_ELEMENT_LINE_CURVE, // < `ufbx_line_curve`
UFBX_ELEMENT_NURBS_CURVE, // < `ufbx_nurbs_curve`
UFBX_ELEMENT_NURBS_SURFACE, // < `ufbx_nurbs_surface`
UFBX_ELEMENT_NURBS_TRIM_SURFACE, // < `ufbx_nurbs_trim_surface`
UFBX_ELEMENT_NURBS_TRIM_BOUNDARY, // < `ufbx_nurbs_trim_boundary`
UFBX_ELEMENT_PROCEDURAL_GEOMETRY, // < `ufbx_procedural_geometry`
UFBX_ELEMENT_STEREO_CAMERA, // < `ufbx_stereo_camera`
UFBX_ELEMENT_CAMERA_SWITCHER, // < `ufbx_camera_switcher`
UFBX_ELEMENT_MARKER, // < `ufbx_marker`
UFBX_ELEMENT_LOD_GROUP, // < `ufbx_lod_group`
UFBX_ELEMENT_SKIN_DEFORMER, // < `ufbx_skin_deformer`
UFBX_ELEMENT_SKIN_CLUSTER, // < `ufbx_skin_cluster`
UFBX_ELEMENT_BLEND_DEFORMER, // < `ufbx_blend_deformer`
UFBX_ELEMENT_BLEND_CHANNEL, // < `ufbx_blend_channel`
UFBX_ELEMENT_BLEND_SHAPE, // < `ufbx_blend_shape`
UFBX_ELEMENT_CACHE_DEFORMER, // < `ufbx_cache_deformer`
UFBX_ELEMENT_CACHE_FILE, // < `ufbx_cache_file`
UFBX_ELEMENT_MATERIAL, // < `ufbx_material`
UFBX_ELEMENT_TEXTURE, // < `ufbx_texture`
UFBX_ELEMENT_VIDEO, // < `ufbx_video`
UFBX_ELEMENT_SHADER, // < `ufbx_shader`
UFBX_ELEMENT_SHADER_BINDING, // < `ufbx_shader_binding`
UFBX_ELEMENT_ANIM_STACK, // < `ufbx_anim_stack`
UFBX_ELEMENT_ANIM_LAYER, // < `ufbx_anim_layer`
UFBX_ELEMENT_ANIM_VALUE, // < `ufbx_anim_value`
UFBX_ELEMENT_ANIM_CURVE, // < `ufbx_anim_curve`
UFBX_ELEMENT_DISPLAY_LAYER, // < `ufbx_display_layer`
UFBX_ELEMENT_SELECTION_SET, // < `ufbx_selection_set`
UFBX_ELEMENT_SELECTION_NODE, // < `ufbx_selection_node`
UFBX_ELEMENT_CHARACTER, // < `ufbx_character`
UFBX_ELEMENT_CONSTRAINT, // < `ufbx_constraint`
UFBX_ELEMENT_AUDIO_LAYER, // < `ufbx_audio_layer`
UFBX_ELEMENT_AUDIO_CLIP, // < `ufbx_audio_clip`
UFBX_ELEMENT_POSE, // < `ufbx_pose`
UFBX_ELEMENT_METADATA_OBJECT, // < `ufbx_metadata_object`
UFBX_ELEMENT_TYPE_FIRST_ATTRIB = UFBX_ELEMENT_MESH,
UFBX_ELEMENT_TYPE_LAST_ATTRIB = UFBX_ELEMENT_LOD_GROUP,
UFBX_ENUM_FORCE_WIDTH(UFBX_ELEMENT_TYPE)
} ufbx_element_type;
UFBX_ENUM_TYPE(ufbx_element_type, UFBX_ELEMENT_TYPE, UFBX_ELEMENT_METADATA_OBJECT);
// Connection between two elements.
// Source and destination are somewhat arbitrary but the destination is
// often the "container" like a parent node or mesh containing a deformer.
typedef struct ufbx_connection {
ufbx_element *src;
ufbx_element *dst;
ufbx_string src_prop;
ufbx_string dst_prop;
} ufbx_connection;
UFBX_LIST_TYPE(ufbx_connection_list, ufbx_connection);
// Element "base-class" common to each element.
// Some fields (like `connections_src`) are advanced and not visible
// in the specialized element structs.
// NOTE: The `element_id` value is consistent when loading the
// _same_ file, but re-exporting the file will invalidate them.
struct ufbx_element {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
ufbx_node_list instances;
ufbx_element_type type;
ufbx_connection_list connections_src;
ufbx_connection_list connections_dst;
ufbx_nullable ufbx_dom_node *dom_node;
ufbx_scene *scene;
};
// -- Unknown
struct ufbx_unknown {
// Shared "base-class" header, see `ufbx_element`.
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
}; };
// FBX format specific type information.
// In ASCII FBX format:
// super_type: ID, "type::name", "sub_type" { ... }
ufbx_string type;
ufbx_string super_type;
ufbx_string sub_type;
};
// -- Nodes
// Inherit type specifies how hierarchial node transforms are combined.
// This only affects the final scaling, as rotation and translation are always
// inherited correctly.
// NOTE: These don't map to `"InheritType"` property as there may be new ones for
// compatibility with various exporters.
typedef enum ufbx_inherit_mode UFBX_ENUM_REPR {
// Normal matrix composition of hierarchy: `R*S*r*s`.
// child.node_to_world = parent.node_to_world * child.node_to_parent;
UFBX_INHERIT_MODE_NORMAL,
// Ignore parent scale when computing the transform: `R*r*s`.
// ufbx_transform t = node.local_transform;
// t.translation *= parent.inherit_scale;
// t.scale *= node.inherit_scale_node.inherit_scale;
// child.node_to_world = parent.unscaled_node_to_world * t;
// Also known as "Segment scale compensate" in some software.
UFBX_INHERIT_MODE_IGNORE_PARENT_SCALE,
// Apply parent scale component-wise: `R*r*S*s`.
// ufbx_transform t = node.local_transform;
// t.translation *= parent.inherit_scale;
// t.scale *= node.inherit_scale_node.inherit_scale;
// child.node_to_world = parent.unscaled_node_to_world * t;
UFBX_INHERIT_MODE_COMPONENTWISE_SCALE,
UFBX_ENUM_FORCE_WIDTH(UFBX_INHERIT_MODE)
} ufbx_inherit_mode;
UFBX_ENUM_TYPE(ufbx_inherit_mode, UFBX_INHERIT_MODE, UFBX_INHERIT_MODE_COMPONENTWISE_SCALE);
// Axis used to mirror transformations for handedness conversion.
typedef enum ufbx_mirror_axis UFBX_ENUM_REPR {
UFBX_MIRROR_AXIS_NONE,
UFBX_MIRROR_AXIS_X,
UFBX_MIRROR_AXIS_Y,
UFBX_MIRROR_AXIS_Z,
UFBX_ENUM_FORCE_WIDTH(UFBX_MIRROR_AXIS)
} ufbx_mirror_axis;
UFBX_ENUM_TYPE(ufbx_mirror_axis, UFBX_MIRROR_AXIS, UFBX_MIRROR_AXIS_Z);
// Nodes form the scene transformation hierarchy and can contain attached
// elements such as meshes or lights. In normal cases a single `ufbx_node`
// contains only a single attached element, so using `type/mesh/...` is safe.
struct ufbx_node {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
}; };
// Node hierarchy
// Parent node containing this one if not root.
//
// Always non-`NULL` for non-root nodes unless
// `ufbx_load_opts.allow_nodes_out_of_root` is enabled.
ufbx_nullable ufbx_node *parent;
// List of child nodes parented to this node.
ufbx_node_list children;
// Common attached element type and typed pointers. Set to `NULL` if not in
// use, so checking `attrib_type` is not required.
//
// HINT: If you need less common attributes access `ufbx_node.attrib`, you
// can use utility functions like `ufbx_as_nurbs_curve(attrib)` to convert
// and check the attribute in one step.
ufbx_nullable ufbx_mesh *mesh;
ufbx_nullable ufbx_light *light;
ufbx_nullable ufbx_camera *camera;
ufbx_nullable ufbx_bone *bone;
// Less common attributes use these fields.
//
// Defined even if it is one of the above, eg. `ufbx_mesh`. In case there
// is multiple attributes this will be the first one.
ufbx_nullable ufbx_element *attrib;
// Geometry transform helper if one exists.
// See `UFBX_GEOMETRY_TRANSFORM_HANDLING_HELPER_NODES`.
ufbx_nullable ufbx_node *geometry_transform_helper;
// Scale helper if one exists.
// See `UFBX_INHERIT_MODE_HANDLING_HELPER_NODES`.
ufbx_nullable ufbx_node *scale_helper;
// `attrib->type` if `attrib` is defined, otherwise `UFBX_ELEMENT_UNKNOWN`.
ufbx_element_type attrib_type;
// List of _all_ attached attribute elements.
//
// In most cases there is only zero or one attributes per node, but if you
// have a very exotic FBX file nodes may have multiple attributes.
ufbx_element_list all_attribs;
// Local transform in parent, geometry transform is a non-inherited
// transform applied only to attachments like meshes
ufbx_inherit_mode inherit_mode;
ufbx_inherit_mode original_inherit_mode;
ufbx_transform local_transform;
ufbx_transform geometry_transform;
// Combined scale when using `UFBX_INHERIT_MODE_COMPONENTWISE_SCALE`.
// Contains `local_transform.scale` otherwise.
ufbx_vec3 inherit_scale;
// Node where scale is inherited from for `UFBX_INHERIT_MODE_COMPONENTWISE_SCALE`
// and even for `UFBX_INHERIT_MODE_IGNORE_PARENT_SCALE`.
// For componentwise-scale nodes, this will point to `parent`, for scale ignoring
// nodes this will point to the parent of the nearest componentwise-scaled node
// in the parent chain.
ufbx_nullable ufbx_node *inherit_scale_node;
// Raw Euler angles in degrees for those who want them
// Specifies the axis order `euler_rotation` is applied in.
ufbx_rotation_order rotation_order;
// Rotation around the local X/Y/Z axes in `rotation_order`.
// The angles are specified in degrees.
ufbx_vec3 euler_rotation;
// Matrices derived from the transformations, for transforming geometry
// prefer using `geometry_to_world` as that supports geometric transforms.
// Transform from this node to `parent` space.
// Equivalent to `ufbx_transform_to_matrix(&local_transform)`.
ufbx_matrix node_to_parent;
// Transform from this node to the world space, ie. multiplying all the
// `node_to_parent` matrices of the parent chain together.
ufbx_matrix node_to_world;
// Transform from the attribute to this node. Does not affect the transforms
// of `children`!
// Equivalent to `ufbx_transform_to_matrix(&geometry_transform)`.
ufbx_matrix geometry_to_node;
// Transform from attribute space to world space.
// Equivalent to `ufbx_matrix_mul(&node_to_world, &geometry_to_node)`.
ufbx_matrix geometry_to_world;
// Transform from this node to world space, ignoring self scaling.
ufbx_matrix unscaled_node_to_world;
// ufbx-specific adjustment for switching between coodrinate/unit systems.
// HINT: In most cases you don't need to deal with these as these are baked
// into all the transforms above and into `ufbx_evaluate_transform()`.
ufbx_vec3 adjust_pre_translation; // < Translation applied between parent and self
ufbx_quat adjust_pre_rotation; // < Rotation applied between parent and self
ufbx_real adjust_pre_scale; // < Scaling applied between parent and self
ufbx_quat adjust_post_rotation; // < Rotation applied in local space at the end
ufbx_real adjust_post_scale; // < Scaling applied in local space at the end
ufbx_real adjust_translation_scale; // < Scaling applied to translation only
ufbx_mirror_axis adjust_mirror_axis; // < Mirror translation and rotation on this axis
// Materials used by `mesh` or other `attrib`.
// There may be multiple copies of a single `ufbx_mesh` with different materials
// in the `ufbx_node` instances.
ufbx_material_list materials;
// Bind pose
ufbx_nullable ufbx_pose *bind_pose;
// Visibility state.
bool visible;
// True if this node is the implicit root node of the scene.
bool is_root;
// True if the node has a non-identity `geometry_transform`.
bool has_geometry_transform;
// If `true` the transform is adjusted by ufbx, not enabled by default.
// See `adjust_pre_rotation`, `adjust_pre_scale`, `adjust_post_rotation`,
// and `adjust_post_scale`.
bool has_adjust_transform;
// Scale is adjusted by root scale.
bool has_root_adjust_transform;
// True if this node is a synthetic geometry transform helper.
// See `UFBX_GEOMETRY_TRANSFORM_HANDLING_HELPER_NODES`.
bool is_geometry_transform_helper;
// True if the node is a synthetic scale compensation helper.
// See `UFBX_INHERIT_MODE_HANDLING_HELPER_NODES`.
bool is_scale_helper;
// Parent node to children that can compensate for parent scale.
bool is_scale_compensate_parent;
// How deep is this node in the parent hierarchy. Root node is at depth `0`
// and the immediate children of root at `1`.
uint32_t node_depth;
};
// Vertex attribute: All attributes are stored in a consistent indexed format
// regardless of how it's actually stored in the file.
//
// `values` is a contiguous array of attribute values.
// `indices` maps each mesh index into a value in the `values` array.
//
// If `unique_per_vertex` is set then the attribute is guaranteed to have a
// single defined value per vertex accessible via:
// attrib.values.data[attrib.indices.data[mesh->vertex_first_index[vertex_ix]]
typedef struct ufbx_vertex_attrib {
// Is this attribute defined by the mesh.
bool exists;
// List of values the attribute uses.
ufbx_void_list values;
// Indices into `values[]`, indexed up to `ufbx_mesh.num_indices`.
ufbx_uint32_list indices;
// Number of `ufbx_real` entries per value.
size_t value_reals;
// `true` if this attribute is defined per vertex, instead of per index.
bool unique_per_vertex;
// Optional 4th 'W' component for the attribute.
// May be defined for the following:
// ufbx_mesh.vertex_normal
// ufbx_mesh.vertex_tangent / ufbx_uv_set.vertex_tangent
// ufbx_mesh.vertex_bitangent / ufbx_uv_set.vertex_bitangent
// NOTE: This is not loaded by default, set `ufbx_load_opts.retain_vertex_attrib_w`.
ufbx_real_list values_w;
} ufbx_vertex_attrib;
// 1D vertex attribute, see `ufbx_vertex_attrib` for information
typedef struct ufbx_vertex_real {
bool exists;
ufbx_real_list values;
ufbx_uint32_list indices;
size_t value_reals;
bool unique_per_vertex;
ufbx_real_list values_w;
UFBX_VERTEX_ATTRIB_IMPL(ufbx_real)
} ufbx_vertex_real;
// 2D vertex attribute, see `ufbx_vertex_attrib` for information
typedef struct ufbx_vertex_vec2 {
bool exists;
ufbx_vec2_list values;
ufbx_uint32_list indices;
size_t value_reals;
bool unique_per_vertex;
ufbx_real_list values_w;
UFBX_VERTEX_ATTRIB_IMPL(ufbx_vec2)
} ufbx_vertex_vec2;
// 3D vertex attribute, see `ufbx_vertex_attrib` for information
typedef struct ufbx_vertex_vec3 {
bool exists;
ufbx_vec3_list values;
ufbx_uint32_list indices;
size_t value_reals;
bool unique_per_vertex;
ufbx_real_list values_w;
UFBX_VERTEX_ATTRIB_IMPL(ufbx_vec3)
} ufbx_vertex_vec3;
// 4D vertex attribute, see `ufbx_vertex_attrib` for information
typedef struct ufbx_vertex_vec4 {
bool exists;
ufbx_vec4_list values;
ufbx_uint32_list indices;
size_t value_reals;
bool unique_per_vertex;
ufbx_real_list values_w;
UFBX_VERTEX_ATTRIB_IMPL(ufbx_vec4)
} ufbx_vertex_vec4;
// Vertex UV set/layer
typedef struct ufbx_uv_set {
ufbx_string name;
uint32_t index;
// Vertex attributes, see `ufbx_mesh` attributes for more information
ufbx_vertex_vec2 vertex_uv; // < UV / texture coordinates
ufbx_vertex_vec3 vertex_tangent; // < (optional) Tangent vector in UV.x direction
ufbx_vertex_vec3 vertex_bitangent; // < (optional) Tangent vector in UV.y direction
} ufbx_uv_set;
// Vertex color set/layer
typedef struct ufbx_color_set {
ufbx_string name;
uint32_t index;
// Vertex attributes, see `ufbx_mesh` attributes for more information
ufbx_vertex_vec4 vertex_color; // < Per-vertex RGBA color
} ufbx_color_set;
UFBX_LIST_TYPE(ufbx_uv_set_list, ufbx_uv_set);
UFBX_LIST_TYPE(ufbx_color_set_list, ufbx_color_set);
// Edge between two _indices_ in a mesh
typedef struct ufbx_edge {
union {
struct { uint32_t a, b; };
uint32_t indices[2];
};
} ufbx_edge;
UFBX_LIST_TYPE(ufbx_edge_list, ufbx_edge);
// Polygonal face with arbitrary number vertices, a single face contains a
// contiguous range of mesh indices, eg. `{5,3}` would have indices 5, 6, 7
//
// NOTE: `num_indices` maybe less than 3 in which case the face is invalid!
// [TODO #23: should probably remove the bad faces at load time]
typedef struct ufbx_face {
uint32_t index_begin;
uint32_t num_indices;
} ufbx_face;
UFBX_LIST_TYPE(ufbx_face_list, ufbx_face);
// Subset of mesh faces used by a single material or group.
typedef struct ufbx_mesh_part {
// Index of the mesh part.
uint32_t index;
// Sub-set of the geometry
size_t num_faces; // < Number of faces (polygons)
size_t num_triangles; // < Number of triangles if triangulated
size_t num_empty_faces; // < Number of faces with zero vertices
size_t num_point_faces; // < Number of faces with a single vertex
size_t num_line_faces; // < Number of faces with two vertices
// Indices to `ufbx_mesh.faces[]`.
// Always contains `num_faces` elements.
ufbx_uint32_list face_indices;
} ufbx_mesh_part;
UFBX_LIST_TYPE(ufbx_mesh_part_list, ufbx_mesh_part);
typedef struct ufbx_face_group {
int32_t id; // < Numerical ID for this group.
ufbx_string name; // < Name for the face group.
} ufbx_face_group;
UFBX_LIST_TYPE(ufbx_face_group_list, ufbx_face_group);
typedef struct ufbx_subdivision_weight_range {
uint32_t weight_begin;
uint32_t num_weights;
} ufbx_subdivision_weight_range;
UFBX_LIST_TYPE(ufbx_subdivision_weight_range_list, ufbx_subdivision_weight_range);
typedef struct ufbx_subdivision_weight {
ufbx_real weight;
uint32_t index;
} ufbx_subdivision_weight;
UFBX_LIST_TYPE(ufbx_subdivision_weight_list, ufbx_subdivision_weight);
typedef struct ufbx_subdivision_result {
size_t result_memory_used;
size_t temp_memory_used;
size_t result_allocs;
size_t temp_allocs;
// Weights of vertices in the source model.
// Defined if `ufbx_subdivide_opts.evaluate_source_vertices` is set.
ufbx_subdivision_weight_range_list source_vertex_ranges;
ufbx_subdivision_weight_list source_vertex_weights;
// Weights of skin clusters in the source model.
// Defined if `ufbx_subdivide_opts.evaluate_skin_weights` is set.
ufbx_subdivision_weight_range_list skin_cluster_ranges;
ufbx_subdivision_weight_list skin_cluster_weights;
} ufbx_subdivision_result;
typedef enum ufbx_subdivision_display_mode UFBX_ENUM_REPR {
UFBX_SUBDIVISION_DISPLAY_DISABLED,
UFBX_SUBDIVISION_DISPLAY_HULL,
UFBX_SUBDIVISION_DISPLAY_HULL_AND_SMOOTH,
UFBX_SUBDIVISION_DISPLAY_SMOOTH,
UFBX_ENUM_FORCE_WIDTH(UFBX_SUBDIVISION_DISPLAY_MODE)
} ufbx_subdivision_display_mode;
UFBX_ENUM_TYPE(ufbx_subdivision_display_mode, UFBX_SUBDIVISION_DISPLAY_MODE, UFBX_SUBDIVISION_DISPLAY_SMOOTH);
typedef enum ufbx_subdivision_boundary UFBX_ENUM_REPR {
UFBX_SUBDIVISION_BOUNDARY_DEFAULT,
UFBX_SUBDIVISION_BOUNDARY_LEGACY,
// OpenSubdiv: `VTX_BOUNDARY_EDGE_AND_CORNER` / `FVAR_LINEAR_CORNERS_ONLY`
UFBX_SUBDIVISION_BOUNDARY_SHARP_CORNERS,
// OpenSubdiv: `VTX_BOUNDARY_EDGE_ONLY` / `FVAR_LINEAR_NONE`
UFBX_SUBDIVISION_BOUNDARY_SHARP_NONE,
// OpenSubdiv: `FVAR_LINEAR_BOUNDARIES`
UFBX_SUBDIVISION_BOUNDARY_SHARP_BOUNDARY,
// OpenSubdiv: `FVAR_LINEAR_ALL`
UFBX_SUBDIVISION_BOUNDARY_SHARP_INTERIOR,
UFBX_ENUM_FORCE_WIDTH(UFBX_SUBDIVISION_BOUNDARY)
} ufbx_subdivision_boundary;
UFBX_ENUM_TYPE(ufbx_subdivision_boundary, UFBX_SUBDIVISION_BOUNDARY, UFBX_SUBDIVISION_BOUNDARY_SHARP_INTERIOR);
// Polygonal mesh geometry.
//
// Example mesh with two triangles (x, z) and a quad (y).
// The faces have a constant UV coordinate x/y/z.
// The vertices have _per vertex_ normals that point up/down.
//
// ^ ^ ^
// A---B-----C
// |x / /|
// | / y / |
// |/ / z|
// D-----E---F
// v v v
//
// Attributes may have multiple values within a single vertex, for example a
// UV seam vertex has two UV coordinates. Thus polygons are defined using
// an index that counts each corner of each face polygon. If an attribute is
// defined (even per-vertex) it will always have a valid `indices` array.
//
// {0,3} {3,4} {7,3} faces ({ index_begin, num_indices })
// 0 1 2 3 4 5 6 7 8 9 index
//
// 0 1 3 1 2 4 3 2 4 5 vertex_indices[index]
// A B D B C E D C E F vertices[vertex_indices[index]]
//
// 0 0 1 0 0 1 1 0 1 1 vertex_normal.indices[index]
// ^ ^ v ^ ^ v v ^ v v vertex_normal.data[vertex_normal.indices[index]]
//
// 0 0 0 1 1 1 1 2 2 2 vertex_uv.indices[index]
// x x x y y y y z z z vertex_uv.data[vertex_uv.indices[index]]
//
// Vertex position can also be accessed uniformly through an accessor:
// 0 1 3 1 2 4 3 2 4 5 vertex_position.indices[index]
// A B D B C E D C E F vertex_position.data[vertex_position.indices[index]]
//
// Some geometry data is specified per logical vertex. Vertex positions are
// the only attribute that is guaranteed to be defined _uniquely_ per vertex.
// Vertex attributes _may_ be defined per vertex if `unique_per_vertex == true`.
// You can access the per-vertex values by first finding the first index that
// refers to the given vertex.
//
// 0 1 2 3 4 5 vertex
// A B C D E F vertices[vertex]
//
// 0 1 4 2 5 9 vertex_first_index[vertex]
// 0 0 0 1 1 1 vertex_normal.indices[vertex_first_index[vertex]]
// ^ ^ ^ v v v vertex_normal.data[vertex_normal.indices[vertex_first_index[vertex]]]
//
struct ufbx_mesh {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
ufbx_node_list instances;
}; };
// Number of "logical" vertices that would be treated as a single point,
// one vertex may be split to multiple indices for split attributes, eg. UVs
size_t num_vertices; // < Number of logical "vertex" points
size_t num_indices; // < Number of combiend vertex/attribute tuples
size_t num_faces; // < Number of faces (polygons) in the mesh
size_t num_triangles; // < Number of triangles if triangulated
// Number of edges in the mesh.
// NOTE: May be zero in valid meshes if the file doesn't contain edge adjacency data!
size_t num_edges;
size_t max_face_triangles; // < Maximum number of triangles in a face in this mesh
size_t num_empty_faces; // < Number of faces with zero vertices
size_t num_point_faces; // < Number of faces with a single vertex
size_t num_line_faces; // < Number of faces with two vertices
// Faces and optional per-face extra data
ufbx_face_list faces; // < Face index range
ufbx_bool_list face_smoothing; // < Should the face have soft normals
ufbx_uint32_list face_material; // < Indices to `ufbx_mesh.materials[]` and `ufbx_node.materials[]`
ufbx_uint32_list face_group; // < Face polygon group index, indices to `ufbx_mesh.face_groups[]`
ufbx_bool_list face_hole; // < Should the face be hidden as a "hole"
// Edges and optional per-edge extra data
ufbx_edge_list edges; // < Edge index range
ufbx_bool_list edge_smoothing; // < Should the edge have soft normals
ufbx_real_list edge_crease; // < Crease value for subdivision surfaces
ufbx_bool_list edge_visibility; // < Should the edge be visible
// Logical vertices and positions, alternatively you can use
// `vertex_position` for consistent interface with other attributes.
ufbx_uint32_list vertex_indices;
ufbx_vec3_list vertices;
// First index referring to a given vertex, `UFBX_NO_INDEX` if the vertex is unused.
ufbx_uint32_list vertex_first_index;
// Vertex attributes, see the comment over the struct.
//
// NOTE: Not all meshes have all attributes, in that case `indices/data == NULL`!
//
// NOTE: UV/tangent/bitangent and color are the from first sets,
// use `uv_sets/color_sets` to access the other layers.
ufbx_vertex_vec3 vertex_position; // < Vertex positions
ufbx_vertex_vec3 vertex_normal; // < (optional) Normal vectors, always defined if `ufbx_load_opts.generate_missing_normals`
ufbx_vertex_vec2 vertex_uv; // < (optional) UV / texture coordinates
ufbx_vertex_vec3 vertex_tangent; // < (optional) Tangent vector in UV.x direction
ufbx_vertex_vec3 vertex_bitangent; // < (optional) Tangent vector in UV.y direction
ufbx_vertex_vec4 vertex_color; // < (optional) Per-vertex RGBA color
ufbx_vertex_real vertex_crease; // < (optional) Crease value for subdivision surfaces
// Multiple named UV/color sets
// NOTE: The first set contains the same data as `vertex_uv/color`!
ufbx_uv_set_list uv_sets;
ufbx_color_set_list color_sets;
// Materials used by the mesh.
// NOTE: These can be wrong if you want to support per-instance materials!
// Use `ufbx_node.materials[]` to get the per-instance materials at the same indices.
ufbx_material_list materials;
// Face groups for this mesh.
ufbx_face_group_list face_groups;
// Segments that use a given material.
// Defined even if the mesh doesn't have any materials.
ufbx_mesh_part_list material_parts;
// Segments for each face group.
ufbx_mesh_part_list face_group_parts;
// Order of `material_parts` by first face that refers to it.
// Useful for compatibility with FBX SDK and various importers using it,
// as they use this material order by default.
ufbx_uint32_list material_part_usage_order;
// Skinned vertex positions, for efficiency the skinned positions are the
// same as the static ones for non-skinned meshes and `skinned_is_local`
// is set to true meaning you need to transform them manually using
// `ufbx_transform_position(&node->geometry_to_world, skinned_pos)`!
bool skinned_is_local;
ufbx_vertex_vec3 skinned_position;
ufbx_vertex_vec3 skinned_normal;
// Deformers
ufbx_skin_deformer_list skin_deformers;
ufbx_blend_deformer_list blend_deformers;
ufbx_cache_deformer_list cache_deformers;
ufbx_element_list all_deformers;
// Subdivision
uint32_t subdivision_preview_levels;
uint32_t subdivision_render_levels;
ufbx_subdivision_display_mode subdivision_display_mode;
ufbx_subdivision_boundary subdivision_boundary;
ufbx_subdivision_boundary subdivision_uv_boundary;
// The winding of the faces has been reversed.
bool reversed_winding;
// Normals have been generated instead of evalauted.
// Either from missing normals (via `ufbx_load_opts.generate_missing_normals`), skinning,
// tessellation, or subdivision.
bool generated_normals;
// Subdivision (result)
bool subdivision_evaluated;
ufbx_nullable ufbx_subdivision_result *subdivision_result;
// Tessellation (result)
bool from_tessellated_nurbs;
};
// The kind of light source
typedef enum ufbx_light_type UFBX_ENUM_REPR {
// Single point at local origin, at `node->world_transform.position`
UFBX_LIGHT_POINT,
// Infinite directional light pointing locally towards `light->local_direction`
// For global: `ufbx_transform_direction(&node->node_to_world, light->local_direction)`
UFBX_LIGHT_DIRECTIONAL,
// Cone shaped light towards `light->local_direction`, between `light->inner/outer_angle`.
// For global: `ufbx_transform_direction(&node->node_to_world, light->local_direction)`
UFBX_LIGHT_SPOT,
// Area light, shape specified by `light->area_shape`
// TODO: Units?
UFBX_LIGHT_AREA,
// Volumetric light source
// TODO: How does this work
UFBX_LIGHT_VOLUME,
UFBX_ENUM_FORCE_WIDTH(UFBX_LIGHT_TYPE)
} ufbx_light_type;
UFBX_ENUM_TYPE(ufbx_light_type, UFBX_LIGHT_TYPE, UFBX_LIGHT_VOLUME);
// How fast does the light intensity decay at a distance
typedef enum ufbx_light_decay UFBX_ENUM_REPR {
UFBX_LIGHT_DECAY_NONE, // < 1 (no decay)
UFBX_LIGHT_DECAY_LINEAR, // < 1 / d
UFBX_LIGHT_DECAY_QUADRATIC, // < 1 / d^2 (physically accurate)
UFBX_LIGHT_DECAY_CUBIC, // < 1 / d^3
UFBX_ENUM_FORCE_WIDTH(UFBX_LIGHT_DECAY)
} ufbx_light_decay;
UFBX_ENUM_TYPE(ufbx_light_decay, UFBX_LIGHT_DECAY, UFBX_LIGHT_DECAY_CUBIC);
typedef enum ufbx_light_area_shape UFBX_ENUM_REPR {
UFBX_LIGHT_AREA_SHAPE_RECTANGLE,
UFBX_LIGHT_AREA_SHAPE_SPHERE,
UFBX_ENUM_FORCE_WIDTH(UFBX_LIGHT_AREA_SHAPE)
} ufbx_light_area_shape;
UFBX_ENUM_TYPE(ufbx_light_area_shape, UFBX_LIGHT_AREA_SHAPE, UFBX_LIGHT_AREA_SHAPE_SPHERE);
// Light source attached to a `ufbx_node`
struct ufbx_light {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
ufbx_node_list instances;
}; };
// Color and intensity of the light, usually you want to use `color * intensity`
// NOTE: `intensity` is 0.01x of the property `"Intensity"` as that matches
// matches values in DCC programs before exporting.
ufbx_vec3 color;
ufbx_real intensity;
// Direction the light is aimed at in node's local space, usually -Y
ufbx_vec3 local_direction;
// Type of the light and shape parameters
ufbx_light_type type;
ufbx_light_decay decay;
ufbx_light_area_shape area_shape;
ufbx_real inner_angle;
ufbx_real outer_angle;
bool cast_light;
bool cast_shadows;
};
typedef enum ufbx_projection_mode UFBX_ENUM_REPR {
// Perspective projection.
UFBX_PROJECTION_MODE_PERSPECTIVE,
// Orthographic projection.
UFBX_PROJECTION_MODE_ORTHOGRAPHIC,
UFBX_ENUM_FORCE_WIDTH(UFBX_PROJECTION_MODE)
} ufbx_projection_mode;
UFBX_ENUM_TYPE(ufbx_projection_mode, UFBX_PROJECTION_MODE, UFBX_PROJECTION_MODE_ORTHOGRAPHIC);
// Method of specifying the rendering resolution from properties
// NOTE: Handled internally by ufbx, ignore unless you interpret `ufbx_props` directly!
typedef enum ufbx_aspect_mode UFBX_ENUM_REPR {
// No defined resolution
UFBX_ASPECT_MODE_WINDOW_SIZE,
// `"AspectWidth"` and `"AspectHeight"` are relative to each other
UFBX_ASPECT_MODE_FIXED_RATIO,
// `"AspectWidth"` and `"AspectHeight"` are both pixels
UFBX_ASPECT_MODE_FIXED_RESOLUTION,
// `"AspectWidth"` is pixels, `"AspectHeight"` is relative to width
UFBX_ASPECT_MODE_FIXED_WIDTH,
// < `"AspectHeight"` is pixels, `"AspectWidth"` is relative to height
UFBX_ASPECT_MODE_FIXED_HEIGHT,
UFBX_ENUM_FORCE_WIDTH(UFBX_ASPECT_MODE)
} ufbx_aspect_mode;
UFBX_ENUM_TYPE(ufbx_aspect_mode, UFBX_ASPECT_MODE, UFBX_ASPECT_MODE_FIXED_HEIGHT);
// Method of specifying the field of view from properties
// NOTE: Handled internally by ufbx, ignore unless you interpret `ufbx_props` directly!
typedef enum ufbx_aperture_mode UFBX_ENUM_REPR {
// Use separate `"FieldOfViewX"` and `"FieldOfViewY"` as horizontal/vertical FOV angles
UFBX_APERTURE_MODE_HORIZONTAL_AND_VERTICAL,
// Use `"FieldOfView"` as horizontal FOV angle, derive vertical angle via aspect ratio
UFBX_APERTURE_MODE_HORIZONTAL,
// Use `"FieldOfView"` as vertical FOV angle, derive horizontal angle via aspect ratio
UFBX_APERTURE_MODE_VERTICAL,
// Compute the field of view from the render gate size and focal length
UFBX_APERTURE_MODE_FOCAL_LENGTH,
UFBX_ENUM_FORCE_WIDTH(UFBX_APERTURE_MODE)
} ufbx_aperture_mode;
UFBX_ENUM_TYPE(ufbx_aperture_mode, UFBX_APERTURE_MODE, UFBX_APERTURE_MODE_FOCAL_LENGTH);
// Method of specifying the render gate size from properties
// NOTE: Handled internally by ufbx, ignore unless you interpret `ufbx_props` directly!
typedef enum ufbx_gate_fit UFBX_ENUM_REPR {
// Use the film/aperture size directly as the render gate
UFBX_GATE_FIT_NONE,
// Fit the render gate to the height of the film, derive width from aspect ratio
UFBX_GATE_FIT_VERTICAL,
// Fit the render gate to the width of the film, derive height from aspect ratio
UFBX_GATE_FIT_HORIZONTAL,
// Fit the render gate so that it is fully contained within the film gate
UFBX_GATE_FIT_FILL,
// Fit the render gate so that it fully contains the film gate
UFBX_GATE_FIT_OVERSCAN,
// Stretch the render gate to match the film gate
// TODO: Does this differ from `UFBX_GATE_FIT_NONE`?
UFBX_GATE_FIT_STRETCH,
UFBX_ENUM_FORCE_WIDTH(UFBX_GATE_FIT)
} ufbx_gate_fit;
UFBX_ENUM_TYPE(ufbx_gate_fit, UFBX_GATE_FIT, UFBX_GATE_FIT_STRETCH);
// Camera film/aperture size defaults
// NOTE: Handled internally by ufbx, ignore unless you interpret `ufbx_props` directly!
typedef enum ufbx_aperture_format UFBX_ENUM_REPR {
UFBX_APERTURE_FORMAT_CUSTOM, // < Use `"FilmWidth"` and `"FilmHeight"`
UFBX_APERTURE_FORMAT_16MM_THEATRICAL, // < 0.404 x 0.295 inches
UFBX_APERTURE_FORMAT_SUPER_16MM, // < 0.493 x 0.292 inches
UFBX_APERTURE_FORMAT_35MM_ACADEMY, // < 0.864 x 0.630 inches
UFBX_APERTURE_FORMAT_35MM_TV_PROJECTION, // < 0.816 x 0.612 inches
UFBX_APERTURE_FORMAT_35MM_FULL_APERTURE, // < 0.980 x 0.735 inches
UFBX_APERTURE_FORMAT_35MM_185_PROJECTION, // < 0.825 x 0.446 inches
UFBX_APERTURE_FORMAT_35MM_ANAMORPHIC, // < 0.864 x 0.732 inches (squeeze ratio: 2)
UFBX_APERTURE_FORMAT_70MM_PROJECTION, // < 2.066 x 0.906 inches
UFBX_APERTURE_FORMAT_VISTAVISION, // < 1.485 x 0.991 inches
UFBX_APERTURE_FORMAT_DYNAVISION, // < 2.080 x 1.480 inches
UFBX_APERTURE_FORMAT_IMAX, // < 2.772 x 2.072 inches
UFBX_ENUM_FORCE_WIDTH(UFBX_APERTURE_FORMAT)
} ufbx_aperture_format;
UFBX_ENUM_TYPE(ufbx_aperture_format, UFBX_APERTURE_FORMAT, UFBX_APERTURE_FORMAT_IMAX);
typedef enum ufbx_coordinate_axis UFBX_ENUM_REPR {
UFBX_COORDINATE_AXIS_POSITIVE_X,
UFBX_COORDINATE_AXIS_NEGATIVE_X,
UFBX_COORDINATE_AXIS_POSITIVE_Y,
UFBX_COORDINATE_AXIS_NEGATIVE_Y,
UFBX_COORDINATE_AXIS_POSITIVE_Z,
UFBX_COORDINATE_AXIS_NEGATIVE_Z,
UFBX_COORDINATE_AXIS_UNKNOWN,
UFBX_ENUM_FORCE_WIDTH(UFBX_COORDINATE_AXIS)
} ufbx_coordinate_axis;
UFBX_ENUM_TYPE(ufbx_coordinate_axis, UFBX_COORDINATE_AXIS, UFBX_COORDINATE_AXIS_UNKNOWN);
// Coordinate axes the scene is represented in.
// NOTE: `front` is the _opposite_ from forward!
typedef struct ufbx_coordinate_axes {
ufbx_coordinate_axis right;
ufbx_coordinate_axis up;
ufbx_coordinate_axis front;
} ufbx_coordinate_axes;
// Camera attached to a `ufbx_node`
struct ufbx_camera {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
ufbx_node_list instances;
}; };
// Projection mode (perspective/orthographic).
ufbx_projection_mode projection_mode;
// If set to `true`, `resolution` reprensents actual pixel values, otherwise
// it's only useful for its aspect ratio.
bool resolution_is_pixels;
// Render resolution, either in pixels or arbitrary units, depending on above
ufbx_vec2 resolution;
// Horizontal/vertical field of view in degrees
// Valid if `projection_mode == UFBX_PROJECTION_MODE_PERSPECTIVE`.
ufbx_vec2 field_of_view_deg;
// Component-wise `tan(field_of_view_deg)`, also represents the size of the
// proection frustum slice at distance of 1.
// Valid if `projection_mode == UFBX_PROJECTION_MODE_PERSPECTIVE`.
ufbx_vec2 field_of_view_tan;
// Orthographic camera extents.
// Valid if `projection_mode == UFBX_PROJECTION_MODE_ORTHOGRAPHIC`.
ufbx_real orthographic_extent;
// Orthographic camera size.
// Valid if `projection_mode == UFBX_PROJECTION_MODE_ORTHOGRAPHIC`.
ufbx_vec2 orthographic_size;
// Size of the projection plane at distance 1.
// Equal to `field_of_view_tan` if perspective, `orthographic_size` if orthographic.
ufbx_vec2 projection_plane;
// Aspect ratio of the camera.
ufbx_real aspect_ratio;
// Near plane of the frustum in units from the camera.
ufbx_real near_plane;
// Far plane of the frustum in units from the camera.
ufbx_real far_plane;
// Coordinate system that the projection uses.
// FBX saves cameras with +X forward and +Y up, but you can override this using
// `ufbx_load_opts.target_camera_axes` and it will be reflected here.
ufbx_coordinate_axes projection_axes;
// Advanced properties used to compute the above
ufbx_aspect_mode aspect_mode;
ufbx_aperture_mode aperture_mode;
ufbx_gate_fit gate_fit;
ufbx_aperture_format aperture_format;
ufbx_real focal_length_mm; // < Focal length in millimeters
ufbx_vec2 film_size_inch; // < Film size in inches
ufbx_vec2 aperture_size_inch; // < Aperture/film gate size in inches
ufbx_real squeeze_ratio; // < Anamoprhic stretch ratio
};
// Bone attached to a `ufbx_node`, provides the logical length of the bone
// but most interesting information is directly in `ufbx_node`.
struct ufbx_bone {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
ufbx_node_list instances;
}; };
// Visual radius of the bone
ufbx_real radius;
// Length of the bone relative to the distance between two nodes
ufbx_real relative_length;
// Is the bone a root bone
bool is_root;
};
// Empty/NULL/locator connected to a node, actual details in `ufbx_node`
struct ufbx_empty {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
ufbx_node_list instances;
}; };
};
// -- Node attributes (curves/surfaces)
// Segment of a `ufbx_line_curve`, indices refer to `ufbx_line_curve.point_indices[]`
typedef struct ufbx_line_segment {
uint32_t index_begin;
uint32_t num_indices;
} ufbx_line_segment;
UFBX_LIST_TYPE(ufbx_line_segment_list, ufbx_line_segment);
struct ufbx_line_curve {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
ufbx_node_list instances;
}; };
ufbx_vec3 color;
ufbx_vec3_list control_points; // < List of possible values the line passes through
ufbx_uint32_list point_indices; // < Indices to `control_points[]` the line goes through
ufbx_line_segment_list segments;
// Tessellation (result)
bool from_tessellated_nurbs;
};
typedef enum ufbx_nurbs_topology UFBX_ENUM_REPR {
// The endpoints are not connected.
UFBX_NURBS_TOPOLOGY_OPEN,
// Repeats first `ufbx_nurbs_basis.order - 1` control points after the end.
UFBX_NURBS_TOPOLOGY_PERIODIC,
// Repeats the first control point after the end.
UFBX_NURBS_TOPOLOGY_CLOSED,
UFBX_ENUM_FORCE_WIDTH(UFBX_NURBS_TOPOLOGY)
} ufbx_nurbs_topology;
UFBX_ENUM_TYPE(ufbx_nurbs_topology, UFBX_NURBS_TOPOLOGY, UFBX_NURBS_TOPOLOGY_CLOSED);
// NURBS basis functions for an axis
typedef struct ufbx_nurbs_basis {
// Number of control points influencing a point on the curve/surface.
// Equal to the degree plus one.
uint32_t order;
// Topology (periodicity) of the dimension.
ufbx_nurbs_topology topology;
// Subdivision of the parameter range to control points.
ufbx_real_list knot_vector;
// Range for the parameter value.
ufbx_real t_min;
ufbx_real t_max;
// Parameter values of control points.
ufbx_real_list spans;
// `true` if this axis is two-dimensional.
bool is_2d;
// Number of control points that need to be copied to the end.
// This is just for convenience as it could be derived from `topology` and
// `order`. If for example `num_wrap_control_points == 3` you should repeat
// the first 3 control points after the end.
// HINT: You don't need to worry about this if you use ufbx functions
// like `ufbx_evaluate_nurbs_curve()` as they handle this internally.
size_t num_wrap_control_points;
// `true` if the parametrization is well defined.
bool valid;
} ufbx_nurbs_basis;
struct ufbx_nurbs_curve {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
ufbx_node_list instances;
}; };
// Basis in the U axis
ufbx_nurbs_basis basis;
// Linear array of control points
// NOTE: The control points are _not_ homogeneous, meaning you have to multiply
// them by `w` before evaluating the surface.
ufbx_vec4_list control_points;
};
struct ufbx_nurbs_surface {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
ufbx_node_list instances;
}; };
// Basis in the U/V axes
ufbx_nurbs_basis basis_u;
ufbx_nurbs_basis basis_v;
// Number of control points for the U/V axes
size_t num_control_points_u;
size_t num_control_points_v;
// 2D array of control points.
// Memory layout: `V * num_control_points_u + U`
// NOTE: The control points are _not_ homogeneous, meaning you have to multiply
// them by `w` before evaluating the surface.
ufbx_vec4_list control_points;
// How many segments tessellate each span in `ufbx_nurbs_basis.spans`.
uint32_t span_subdivision_u;
uint32_t span_subdivision_v;
// If `true` the resulting normals should be flipped when evaluated.
bool flip_normals;
// Material for the whole surface.
// NOTE: May be `NULL`!
ufbx_nullable ufbx_material *material;
};
struct ufbx_nurbs_trim_surface {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
ufbx_node_list instances;
}; };
};
struct ufbx_nurbs_trim_boundary {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
ufbx_node_list instances;
}; };
};
// -- Node attributes (advanced)
struct ufbx_procedural_geometry {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
ufbx_node_list instances;
}; };
};
struct ufbx_stereo_camera {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
ufbx_node_list instances;
}; };
ufbx_nullable ufbx_camera *left;
ufbx_nullable ufbx_camera *right;
};
struct ufbx_camera_switcher {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
ufbx_node_list instances;
}; };
};
typedef enum ufbx_marker_type UFBX_ENUM_REPR {
UFBX_MARKER_UNKNOWN, // < Unknown marker type
UFBX_MARKER_FK_EFFECTOR, // < FK (Forward Kinematics) effector
UFBX_MARKER_IK_EFFECTOR, // < IK (Inverse Kinematics) effector
UFBX_ENUM_FORCE_WIDTH(UFBX_MARKER_TYPE)
} ufbx_marker_type;
UFBX_ENUM_TYPE(ufbx_marker_type, UFBX_MARKER_TYPE, UFBX_MARKER_IK_EFFECTOR);
// Tracking marker for effectors
struct ufbx_marker {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
ufbx_node_list instances;
}; };
// Type of the marker
ufbx_marker_type type;
};
// LOD level display mode.
typedef enum ufbx_lod_display UFBX_ENUM_REPR {
UFBX_LOD_DISPLAY_USE_LOD, // < Display the LOD level if the distance is appropriate.
UFBX_LOD_DISPLAY_SHOW, // < Always display the LOD level.
UFBX_LOD_DISPLAY_HIDE, // < Never display the LOD level.
UFBX_ENUM_FORCE_WIDTH(UFBX_LOD_DISPLAY)
} ufbx_lod_display;
UFBX_ENUM_TYPE(ufbx_lod_display, UFBX_LOD_DISPLAY, UFBX_LOD_DISPLAY_HIDE);
// Single LOD level within an LOD group.
// Specifies properties of the Nth child of the _node_ containing the LOD group.
typedef struct ufbx_lod_level {
// Minimum distance to show this LOD level.
// NOTE: In world units by default, or in screen percentage if
// `ufbx_lod_group.relative_distances` is set.
ufbx_real distance;
// LOD display mode.
// NOTE: Mostly for editing, you should probably ignore this
// unless making a modeling program.
ufbx_lod_display display;
} ufbx_lod_level;
UFBX_LIST_TYPE(ufbx_lod_level_list, ufbx_lod_level);
// Group of LOD (Level of Detail) levels for an object.
// The actual LOD models are defined in the parent `ufbx_node.children`.
struct ufbx_lod_group {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
ufbx_node_list instances;
}; };
// If set to `true`, `ufbx_lod_level.distance` represents a screen size percentage.
bool relative_distances;
// LOD levels matching in order to `ufbx_node.children`.
ufbx_lod_level_list lod_levels;
// If set to `true` don't account for parent transform when computing the distance.
bool ignore_parent_transform;
// If `use_distance_limit` is enabled hide the group if the distance is not between
// `distance_limit_min` and `distance_limit_max`.
bool use_distance_limit;
ufbx_real distance_limit_min;
ufbx_real distance_limit_max;
};
// -- Deformers
// Method to evaluate the skinning on a per-vertex level
typedef enum ufbx_skinning_method UFBX_ENUM_REPR {
// Linear blend skinning: Blend transformation matrices by vertex weights
UFBX_SKINNING_METHOD_LINEAR,
// One vertex should have only one bone attached
UFBX_SKINNING_METHOD_RIGID,
// Convert the transformations to dual quaternions and blend in that space
UFBX_SKINNING_METHOD_DUAL_QUATERNION,
// Blend between `UFBX_SKINNING_METHOD_LINEAR` and `UFBX_SKINNING_METHOD_BLENDED_DQ_LINEAR`
// The blend weight can be found either per-vertex in `ufbx_skin_vertex.dq_weight`
// or in `ufbx_skin_deformer.dq_vertices/dq_weights` (indexed by vertex).
UFBX_SKINNING_METHOD_BLENDED_DQ_LINEAR,
UFBX_ENUM_FORCE_WIDTH(UFBX_SKINNING_METHOD)
} ufbx_skinning_method;
UFBX_ENUM_TYPE(ufbx_skinning_method, UFBX_SKINNING_METHOD, UFBX_SKINNING_METHOD_BLENDED_DQ_LINEAR);
// Skin weight information for a single mesh vertex
typedef struct ufbx_skin_vertex {
// Each vertex is influenced by weights from `ufbx_skin_deformer.weights[]`
// The weights are sorted by decreasing weight so you can take the first N
// weights to get a cheaper approximation of the vertex.
// NOTE: The weights are not guaranteed to be normalized!
uint32_t weight_begin; // < Index to start from in the `weights[]` array
uint32_t num_weights; // < Number of weights influencing the vertex
// Blend weight between Linear Blend Skinning (0.0) and Dual Quaternion (1.0).
// Should be used if `skinning_method == UFBX_SKINNING_METHOD_BLENDED_DQ_LINEAR`
ufbx_real dq_weight;
} ufbx_skin_vertex;
UFBX_LIST_TYPE(ufbx_skin_vertex_list, ufbx_skin_vertex);
// Single per-vertex per-cluster weight, see `ufbx_skin_vertex`
typedef struct ufbx_skin_weight {
uint32_t cluster_index; // < Index into `ufbx_skin_deformer.clusters[]`
ufbx_real weight; // < Amount this bone influence the vertex
} ufbx_skin_weight;
UFBX_LIST_TYPE(ufbx_skin_weight_list, ufbx_skin_weight);
// Skin deformer specifies a binding between a logical set of bones (a skeleton)
// and a mesh. Each bone is represented by a `ufbx_skin_cluster` that contains
// the binding matrix and a `ufbx_node *bone` that has the current transformation.
struct ufbx_skin_deformer {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
}; };
ufbx_skinning_method skinning_method;
// Clusters (bones) in the skin
ufbx_skin_cluster_list clusters;
// Per-vertex weight information
ufbx_skin_vertex_list vertices;
ufbx_skin_weight_list weights;
// Largest amount of weights a single vertex can have
size_t max_weights_per_vertex;
// Blend weights between Linear Blend Skinning (0.0) and Dual Quaternion (1.0).
// HINT: You probably want to use `vertices` and `ufbx_skin_vertex.dq_weight` instead!
// NOTE: These may be out-of-bounds for a given mesh, `vertices` is always safe.
size_t num_dq_weights;
ufbx_uint32_list dq_vertices;
ufbx_real_list dq_weights;
};
// Cluster of vertices bound to a single bone.
struct ufbx_skin_cluster {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
}; };
// The bone node the cluster is attached to
// NOTE: Always valid if found from `ufbx_skin_deformer.clusters[]` unless
// `ufbx_load_opts.connect_broken_elements` is `true`.
ufbx_nullable ufbx_node *bone_node;
// Binding matrix from local mesh vertices to the bone
ufbx_matrix geometry_to_bone;
// Binding matrix from local mesh _node_ to the bone.
// NOTE: Prefer `geometry_to_bone` in most use cases!
ufbx_matrix mesh_node_to_bone;
// Matrix that specifies the rest/bind pose transform of the node,
// not generally needed for skinning, use `geometry_to_bone` instead.
ufbx_matrix bind_to_world;
// Precomputed matrix/transform that accounts for the current bone transform
// ie. `ufbx_matrix_mul(&cluster->bone->node_to_world, &cluster->geometry_to_bone)`
ufbx_matrix geometry_to_world;
ufbx_transform geometry_to_world_transform;
// Raw weights indexed by each _vertex_ of a mesh (not index!)
// HINT: It may be simpler to use `ufbx_skin_deformer.vertices[]/weights[]` instead!
// NOTE: These may be out-of-bounds for a given mesh, `ufbx_skin_deformer.vertices` is always safe.
size_t num_weights; // < Number of vertices in the cluster
ufbx_uint32_list vertices; // < Vertex indices in `ufbx_mesh.vertices[]`
ufbx_real_list weights; // < Per-vertex weight values
};
// Blend shape deformer can contain multiple channels (think of sliders between morphs)
// that may optionally have in-between keyframes.
struct ufbx_blend_deformer {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
}; };
// Independent morph targets of the deformer.
ufbx_blend_channel_list channels;
};
// Blend shape associated with a target weight in a series of morphs
typedef struct ufbx_blend_keyframe {
// The target blend shape offsets.
ufbx_blend_shape *shape;
// Weight value at which to apply the keyframe at full strength
ufbx_real target_weight;
// The weight the shape should be currently applied with
ufbx_real effective_weight;
} ufbx_blend_keyframe;
UFBX_LIST_TYPE(ufbx_blend_keyframe_list, ufbx_blend_keyframe);
// Blend channel consists of multiple morph-key targets that are interpolated.
// In simple cases there will be only one keyframe that is the target shape.
struct ufbx_blend_channel {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
}; };
// Current weight of the channel
ufbx_real weight;
// Key morph targets to blend between depending on `weight`
// In usual cases there's only one target per channel
ufbx_blend_keyframe_list keyframes;
// Final blend shape ignoring any intermediate blend shapes.
ufbx_nullable ufbx_blend_shape *target_shape;
};
// Blend shape target containing the actual vertex offsets
struct ufbx_blend_shape {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
}; };
// Vertex offsets to apply over the base mesh
// NOTE: The `offset_vertices` may be out-of-bounds for a given mesh!
size_t num_offsets; // < Number of vertex offsets in the following arrays
ufbx_uint32_list offset_vertices; // < Indices to `ufbx_mesh.vertices[]`
ufbx_vec3_list position_offsets; // < Always specified per-vertex offsets
ufbx_vec3_list normal_offsets; // < Empty if not specified
};
typedef enum ufbx_cache_file_format UFBX_ENUM_REPR {
UFBX_CACHE_FILE_FORMAT_UNKNOWN, // < Unknown cache file format
UFBX_CACHE_FILE_FORMAT_PC2, // < .pc2 Point cache file
UFBX_CACHE_FILE_FORMAT_MC, // < .mc/.mcx Maya cache file
UFBX_ENUM_FORCE_WIDTH(UFBX_CACHE_FILE_FORMAT)
} ufbx_cache_file_format;
UFBX_ENUM_TYPE(ufbx_cache_file_format, UFBX_CACHE_FILE_FORMAT, UFBX_CACHE_FILE_FORMAT_MC);
typedef enum ufbx_cache_data_format UFBX_ENUM_REPR {
UFBX_CACHE_DATA_FORMAT_UNKNOWN, // < Unknown data format
UFBX_CACHE_DATA_FORMAT_REAL_FLOAT, // < `float data[]`
UFBX_CACHE_DATA_FORMAT_VEC3_FLOAT, // < `struct { float x, y, z; } data[]`
UFBX_CACHE_DATA_FORMAT_REAL_DOUBLE, // < `double data[]`
UFBX_CACHE_DATA_FORMAT_VEC3_DOUBLE, // < `struct { double x, y, z; } data[]`
UFBX_ENUM_FORCE_WIDTH(UFBX_CACHE_DATA_FORMAT)
} ufbx_cache_data_format;
UFBX_ENUM_TYPE(ufbx_cache_data_format, UFBX_CACHE_DATA_FORMAT, UFBX_CACHE_DATA_FORMAT_VEC3_DOUBLE);
typedef enum ufbx_cache_data_encoding UFBX_ENUM_REPR {
UFBX_CACHE_DATA_ENCODING_UNKNOWN, // < Unknown data encoding
UFBX_CACHE_DATA_ENCODING_LITTLE_ENDIAN, // < Contiguous little-endian array
UFBX_CACHE_DATA_ENCODING_BIG_ENDIAN, // < Contiguous big-endian array
UFBX_ENUM_FORCE_WIDTH(UFBX_CACHE_DATA_ENCODING)
} ufbx_cache_data_encoding;
UFBX_ENUM_TYPE(ufbx_cache_data_encoding, UFBX_CACHE_DATA_ENCODING, UFBX_CACHE_DATA_ENCODING_BIG_ENDIAN);
// Known interpretations of geometry cache data.
typedef enum ufbx_cache_interpretation UFBX_ENUM_REPR {
// Unknown interpretation, see `ufbx_cache_channel.interpretation_name` for more information.
UFBX_CACHE_INTERPRETATION_UNKNOWN,
// Generic "points" interpretation, FBX SDK default. Usually fine to interpret
// as vertex positions if no other cache channels are specified.
UFBX_CACHE_INTERPRETATION_POINTS,
// Vertex positions.
UFBX_CACHE_INTERPRETATION_VERTEX_POSITION,
// Vertex normals.
UFBX_CACHE_INTERPRETATION_VERTEX_NORMAL,
UFBX_ENUM_FORCE_WIDTH(UFBX_CACHE_INTERPRETATION)
} ufbx_cache_interpretation;
UFBX_ENUM_TYPE(ufbx_cache_interpretation, UFBX_CACHE_INTERPRETATION, UFBX_CACHE_INTERPRETATION_VERTEX_NORMAL);
typedef struct ufbx_cache_frame {
// Name of the channel this frame belongs to.
ufbx_string channel;
// Time of this frame in seconds.
double time;
// Name of the file containing the data.
// The specified file may contain multiple frames, use `data_offset` etc. to
// read at the right position.
ufbx_string filename;
// Format of the wrapper file.
ufbx_cache_file_format file_format;
// Axis to mirror the read data by.
ufbx_mirror_axis mirror_axis;
// Factor to scale the geometry by.
ufbx_real scale_factor;
ufbx_cache_data_format data_format; // < Format of the data in the file
ufbx_cache_data_encoding data_encoding; // < Binary encoding of the data
uint64_t data_offset; // < Byte offset into the file
uint32_t data_count; // < Number of data elements
uint32_t data_element_bytes; // < Size of a single data element in bytes
uint64_t data_total_bytes; // < Size of the whole data blob in bytes
} ufbx_cache_frame;
UFBX_LIST_TYPE(ufbx_cache_frame_list, ufbx_cache_frame);
typedef struct ufbx_cache_channel {
// Name of the geometry cache channel.
ufbx_string name;
// What does the data in this channel represent.
ufbx_cache_interpretation interpretation;
// Source name for `interpretation`, especially useful if `interpretation` is
// `UFBX_CACHE_INTERPRETATION_UNKNOWN`.
ufbx_string interpretation_name;
// List of frames belonging to this channel.
// Sorted by time (`ufbx_cache_frame.time`).
ufbx_cache_frame_list frames;
// Axis to mirror the frames by.
ufbx_mirror_axis mirror_axis;
// Factor to scale the geometry by.
ufbx_real scale_factor;
} ufbx_cache_channel;
UFBX_LIST_TYPE(ufbx_cache_channel_list, ufbx_cache_channel);
typedef struct ufbx_geometry_cache {
ufbx_string root_filename;
ufbx_cache_channel_list channels;
ufbx_cache_frame_list frames;
ufbx_string_list extra_info;
} ufbx_geometry_cache;
struct ufbx_cache_deformer {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
}; };
ufbx_string channel;
ufbx_nullable ufbx_cache_file *file;
// Only valid if `ufbx_load_opts.load_external_files` is set!
ufbx_nullable ufbx_geometry_cache *external_cache;
ufbx_nullable ufbx_cache_channel *external_channel;
};
struct ufbx_cache_file {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
}; };
// Filename relative to the currently loaded file.
// HINT: If using functions other than `ufbx_load_file()`, you can provide
// `ufbx_load_opts.filename/raw_filename` to let ufbx resolve this.
ufbx_string filename;
// Absolute filename specified in the file.
ufbx_string absolute_filename;
// Relative filename specified in the file.
// NOTE: May be absolute if the file is saved in a different drive.
ufbx_string relative_filename;
// Filename relative to the loaded file, non-UTF-8 encoded.
// HINT: If using functions other than `ufbx_load_file()`, you can provide
// `ufbx_load_opts.filename/raw_filename` to let ufbx resolve this.
ufbx_blob raw_filename;
// Absolute filename specified in the file, non-UTF-8 encoded.
ufbx_blob raw_absolute_filename;
// Relative filename specified in the file, non-UTF-8 encoded.
// NOTE: May be absolute if the file is saved in a different drive.
ufbx_blob raw_relative_filename;
ufbx_cache_file_format format;
// Only valid if `ufbx_load_opts.load_external_files` is set!
ufbx_nullable ufbx_geometry_cache *external_cache;
};
// -- Materials
// Material property, either specified with a constant value or a mapped texture
typedef struct ufbx_material_map {
// Constant value or factor for the map.
// May be specified simultaneously with a texture, in this case most shading models
// use multiplicative tinting of the texture values.
union {
ufbx_real value_real;
ufbx_vec2 value_vec2;
ufbx_vec3 value_vec3;
ufbx_vec4 value_vec4;
};
int64_t value_int;
// Texture if connected, otherwise `NULL`.
// May be valid but "disabled" (application specific) if `texture_enabled == false`.
ufbx_nullable ufbx_texture *texture;
// `true` if the file has specified any of the values above.
// NOTE: The value may be set to a non-zero default even if `has_value == false`,
// for example missing factors are set to `1.0` if a color is defined.
bool has_value;
// Controls whether shading should use `texture`.
// NOTE: Some shading models allow this to be `true` even if `texture == NULL`.
bool texture_enabled;
// Set to `true` if this feature should be disabled (specific to shader type).
bool feature_disabled;
// Number of components in the value from 1 to 4 if defined, 0 if not.
uint8_t value_components;
} ufbx_material_map;
// Material feature
typedef struct ufbx_material_feature_info {
// Whether the material model uses this feature or not.
// NOTE: The feature can be enabled but still not used if eg. the corresponding factor is at zero!
bool enabled;
// Explicitly enabled/disabled by the material.
bool is_explicit;
} ufbx_material_feature_info;
// Texture attached to an FBX property
typedef struct ufbx_material_texture {
ufbx_string material_prop; // < Name of the property in `ufbx_material.props`
ufbx_string shader_prop; // < Shader-specific property mapping name
// Texture attached to the property.
ufbx_texture *texture;
} ufbx_material_texture;
UFBX_LIST_TYPE(ufbx_material_texture_list, ufbx_material_texture);
// Shading model type
typedef enum ufbx_shader_type UFBX_ENUM_REPR {
// Unknown shading model
UFBX_SHADER_UNKNOWN,
// FBX builtin diffuse material
UFBX_SHADER_FBX_LAMBERT,
// FBX builtin diffuse+specular material
UFBX_SHADER_FBX_PHONG,
// Open Shading Language standard surface
// https://github.com/Autodesk/standard-surface
UFBX_SHADER_OSL_STANDARD_SURFACE,
// Arnold standard surface
// https://docs.arnoldrenderer.com/display/A5AFMUG/Standard+Surface
UFBX_SHADER_ARNOLD_STANDARD_SURFACE,
// 3ds Max Physical Material
// https://knowledge.autodesk.com/support/3ds-max/learn-explore/caas/CloudHelp/cloudhelp/2022/ENU/3DSMax-Lighting-Shading/files/GUID-C1328905-7783-4917-AB86-FC3CC19E8972-htm.html
UFBX_SHADER_3DS_MAX_PHYSICAL_MATERIAL,
// 3ds Max PBR (Metal/Rough) material
// https://knowledge.autodesk.com/support/3ds-max/learn-explore/caas/CloudHelp/cloudhelp/2021/ENU/3DSMax-Lighting-Shading/files/GUID-A16234A5-6500-4662-8B20-A5EC9FE1B255-htm.html
UFBX_SHADER_3DS_MAX_PBR_METAL_ROUGH,
// 3ds Max PBR (Spec/Gloss) material
// https://knowledge.autodesk.com/support/3ds-max/learn-explore/caas/CloudHelp/cloudhelp/2021/ENU/3DSMax-Lighting-Shading/files/GUID-18087194-B2A6-43EF-9B80-8FD1736FAE52-htm.html
UFBX_SHADER_3DS_MAX_PBR_SPEC_GLOSS,
// 3ds glTF Material
// https://help.autodesk.com/view/3DSMAX/2023/ENU/?guid=GUID-7ABFB805-1D9F-417E-9C22-704BFDF160FA
UFBX_SHADER_GLTF_MATERIAL,
// Stingray ShaderFX shader graph.
// Contains a serialized `"ShaderGraph"` in `ufbx_props`.
UFBX_SHADER_SHADERFX_GRAPH,
// Variation of the FBX phong shader that can recover PBR properties like
// `metalness` or `roughness` from the FBX non-physical values.
// NOTE: Enable `ufbx_load_opts.use_blender_pbr_material`.
UFBX_SHADER_BLENDER_PHONG,
// Wavefront .mtl format shader (used by .obj files)
UFBX_SHADER_WAVEFRONT_MTL,
UFBX_ENUM_FORCE_WIDTH(UFBX_SHADER_TYPE)
} ufbx_shader_type;
UFBX_ENUM_TYPE(ufbx_shader_type, UFBX_SHADER_TYPE, UFBX_SHADER_WAVEFRONT_MTL);
// FBX builtin material properties, matches maps in `ufbx_material_fbx_maps`
typedef enum ufbx_material_fbx_map UFBX_ENUM_REPR {
UFBX_MATERIAL_FBX_DIFFUSE_FACTOR,
UFBX_MATERIAL_FBX_DIFFUSE_COLOR,
UFBX_MATERIAL_FBX_SPECULAR_FACTOR,
UFBX_MATERIAL_FBX_SPECULAR_COLOR,
UFBX_MATERIAL_FBX_SPECULAR_EXPONENT,
UFBX_MATERIAL_FBX_REFLECTION_FACTOR,
UFBX_MATERIAL_FBX_REFLECTION_COLOR,
UFBX_MATERIAL_FBX_TRANSPARENCY_FACTOR,
UFBX_MATERIAL_FBX_TRANSPARENCY_COLOR,
UFBX_MATERIAL_FBX_EMISSION_FACTOR,
UFBX_MATERIAL_FBX_EMISSION_COLOR,
UFBX_MATERIAL_FBX_AMBIENT_FACTOR,
UFBX_MATERIAL_FBX_AMBIENT_COLOR,
UFBX_MATERIAL_FBX_NORMAL_MAP,
UFBX_MATERIAL_FBX_BUMP,
UFBX_MATERIAL_FBX_BUMP_FACTOR,
UFBX_MATERIAL_FBX_DISPLACEMENT_FACTOR,
UFBX_MATERIAL_FBX_DISPLACEMENT,
UFBX_MATERIAL_FBX_VECTOR_DISPLACEMENT_FACTOR,
UFBX_MATERIAL_FBX_VECTOR_DISPLACEMENT,
UFBX_ENUM_FORCE_WIDTH(UFBX_MATERIAL_FBX_MAP)
} ufbx_material_fbx_map;
UFBX_ENUM_TYPE(ufbx_material_fbx_map, UFBX_MATERIAL_FBX_MAP, UFBX_MATERIAL_FBX_VECTOR_DISPLACEMENT);
// Known PBR material properties, matches maps in `ufbx_material_pbr_maps`
typedef enum ufbx_material_pbr_map UFBX_ENUM_REPR {
UFBX_MATERIAL_PBR_BASE_FACTOR,
UFBX_MATERIAL_PBR_BASE_COLOR,
UFBX_MATERIAL_PBR_ROUGHNESS,
UFBX_MATERIAL_PBR_METALNESS,
UFBX_MATERIAL_PBR_DIFFUSE_ROUGHNESS,
UFBX_MATERIAL_PBR_SPECULAR_FACTOR,
UFBX_MATERIAL_PBR_SPECULAR_COLOR,
UFBX_MATERIAL_PBR_SPECULAR_IOR,
UFBX_MATERIAL_PBR_SPECULAR_ANISOTROPY,
UFBX_MATERIAL_PBR_SPECULAR_ROTATION,
UFBX_MATERIAL_PBR_TRANSMISSION_FACTOR,
UFBX_MATERIAL_PBR_TRANSMISSION_COLOR,
UFBX_MATERIAL_PBR_TRANSMISSION_DEPTH,
UFBX_MATERIAL_PBR_TRANSMISSION_SCATTER,
UFBX_MATERIAL_PBR_TRANSMISSION_SCATTER_ANISOTROPY,
UFBX_MATERIAL_PBR_TRANSMISSION_DISPERSION,
UFBX_MATERIAL_PBR_TRANSMISSION_ROUGHNESS,
UFBX_MATERIAL_PBR_TRANSMISSION_EXTRA_ROUGHNESS,
UFBX_MATERIAL_PBR_TRANSMISSION_PRIORITY,
UFBX_MATERIAL_PBR_TRANSMISSION_ENABLE_IN_AOV,
UFBX_MATERIAL_PBR_SUBSURFACE_FACTOR,
UFBX_MATERIAL_PBR_SUBSURFACE_COLOR,
UFBX_MATERIAL_PBR_SUBSURFACE_RADIUS,
UFBX_MATERIAL_PBR_SUBSURFACE_SCALE,
UFBX_MATERIAL_PBR_SUBSURFACE_ANISOTROPY,
UFBX_MATERIAL_PBR_SUBSURFACE_TINT_COLOR,
UFBX_MATERIAL_PBR_SUBSURFACE_TYPE,
UFBX_MATERIAL_PBR_SHEEN_FACTOR,
UFBX_MATERIAL_PBR_SHEEN_COLOR,
UFBX_MATERIAL_PBR_SHEEN_ROUGHNESS,
UFBX_MATERIAL_PBR_COAT_FACTOR,
UFBX_MATERIAL_PBR_COAT_COLOR,
UFBX_MATERIAL_PBR_COAT_ROUGHNESS,
UFBX_MATERIAL_PBR_COAT_IOR,
UFBX_MATERIAL_PBR_COAT_ANISOTROPY,
UFBX_MATERIAL_PBR_COAT_ROTATION,
UFBX_MATERIAL_PBR_COAT_NORMAL,
UFBX_MATERIAL_PBR_COAT_AFFECT_BASE_COLOR,
UFBX_MATERIAL_PBR_COAT_AFFECT_BASE_ROUGHNESS,
UFBX_MATERIAL_PBR_THIN_FILM_THICKNESS,
UFBX_MATERIAL_PBR_THIN_FILM_IOR,
UFBX_MATERIAL_PBR_EMISSION_FACTOR,
UFBX_MATERIAL_PBR_EMISSION_COLOR,
UFBX_MATERIAL_PBR_OPACITY,
UFBX_MATERIAL_PBR_INDIRECT_DIFFUSE,
UFBX_MATERIAL_PBR_INDIRECT_SPECULAR,
UFBX_MATERIAL_PBR_NORMAL_MAP,
UFBX_MATERIAL_PBR_TANGENT_MAP,
UFBX_MATERIAL_PBR_DISPLACEMENT_MAP,
UFBX_MATERIAL_PBR_MATTE_FACTOR,
UFBX_MATERIAL_PBR_MATTE_COLOR,
UFBX_MATERIAL_PBR_AMBIENT_OCCLUSION,
UFBX_MATERIAL_PBR_GLOSSINESS,
UFBX_MATERIAL_PBR_COAT_GLOSSINESS,
UFBX_MATERIAL_PBR_TRANSMISSION_GLOSSINESS,
UFBX_ENUM_FORCE_WIDTH(UFBX_MATERIAL_PBR_MAP)
} ufbx_material_pbr_map;
UFBX_ENUM_TYPE(ufbx_material_pbr_map, UFBX_MATERIAL_PBR_MAP, UFBX_MATERIAL_PBR_TRANSMISSION_GLOSSINESS);
// Known material features
typedef enum ufbx_material_feature UFBX_ENUM_REPR {
UFBX_MATERIAL_FEATURE_PBR,
UFBX_MATERIAL_FEATURE_METALNESS,
UFBX_MATERIAL_FEATURE_DIFFUSE,
UFBX_MATERIAL_FEATURE_SPECULAR,
UFBX_MATERIAL_FEATURE_EMISSION,
UFBX_MATERIAL_FEATURE_TRANSMISSION,
UFBX_MATERIAL_FEATURE_COAT,
UFBX_MATERIAL_FEATURE_SHEEN,
UFBX_MATERIAL_FEATURE_OPACITY,
UFBX_MATERIAL_FEATURE_AMBIENT_OCCLUSION,
UFBX_MATERIAL_FEATURE_MATTE,
UFBX_MATERIAL_FEATURE_UNLIT,
UFBX_MATERIAL_FEATURE_IOR,
UFBX_MATERIAL_FEATURE_DIFFUSE_ROUGHNESS,
UFBX_MATERIAL_FEATURE_TRANSMISSION_ROUGHNESS,
UFBX_MATERIAL_FEATURE_THIN_WALLED,
UFBX_MATERIAL_FEATURE_CAUSTICS,
UFBX_MATERIAL_FEATURE_EXIT_TO_BACKGROUND,
UFBX_MATERIAL_FEATURE_INTERNAL_REFLECTIONS,
UFBX_MATERIAL_FEATURE_DOUBLE_SIDED,
UFBX_MATERIAL_FEATURE_ROUGHNESS_AS_GLOSSINESS,
UFBX_MATERIAL_FEATURE_COAT_ROUGHNESS_AS_GLOSSINESS,
UFBX_MATERIAL_FEATURE_TRANSMISSION_ROUGHNESS_AS_GLOSSINESS,
UFBX_ENUM_FORCE_WIDTH(UFBX_MATERIAL_FEATURE)
} ufbx_material_feature;
UFBX_ENUM_TYPE(ufbx_material_feature, UFBX_MATERIAL_FEATURE, UFBX_MATERIAL_FEATURE_TRANSMISSION_ROUGHNESS_AS_GLOSSINESS);
typedef struct ufbx_material_fbx_maps {
union {
ufbx_material_map maps[UFBX_MATERIAL_FBX_MAP_COUNT];
struct {
ufbx_material_map diffuse_factor;
ufbx_material_map diffuse_color;
ufbx_material_map specular_factor;
ufbx_material_map specular_color;
ufbx_material_map specular_exponent;
ufbx_material_map reflection_factor;
ufbx_material_map reflection_color;
ufbx_material_map transparency_factor;
ufbx_material_map transparency_color;
ufbx_material_map emission_factor;
ufbx_material_map emission_color;
ufbx_material_map ambient_factor;
ufbx_material_map ambient_color;
ufbx_material_map normal_map;
ufbx_material_map bump;
ufbx_material_map bump_factor;
ufbx_material_map displacement_factor;
ufbx_material_map displacement;
ufbx_material_map vector_displacement_factor;
ufbx_material_map vector_displacement;
};
};
} ufbx_material_fbx_maps;
typedef struct ufbx_material_pbr_maps {
union {
ufbx_material_map maps[UFBX_MATERIAL_PBR_MAP_COUNT];
struct {
ufbx_material_map base_factor;
ufbx_material_map base_color;
ufbx_material_map roughness;
ufbx_material_map metalness;
ufbx_material_map diffuse_roughness;
ufbx_material_map specular_factor;
ufbx_material_map specular_color;
ufbx_material_map specular_ior;
ufbx_material_map specular_anisotropy;
ufbx_material_map specular_rotation;
ufbx_material_map transmission_factor;
ufbx_material_map transmission_color;
ufbx_material_map transmission_depth;
ufbx_material_map transmission_scatter;
ufbx_material_map transmission_scatter_anisotropy;
ufbx_material_map transmission_dispersion;
ufbx_material_map transmission_roughness;
ufbx_material_map transmission_extra_roughness;
ufbx_material_map transmission_priority;
ufbx_material_map transmission_enable_in_aov;
ufbx_material_map subsurface_factor;
ufbx_material_map subsurface_color;
ufbx_material_map subsurface_radius;
ufbx_material_map subsurface_scale;
ufbx_material_map subsurface_anisotropy;
ufbx_material_map subsurface_tint_color;
ufbx_material_map subsurface_type;
ufbx_material_map sheen_factor;
ufbx_material_map sheen_color;
ufbx_material_map sheen_roughness;
ufbx_material_map coat_factor;
ufbx_material_map coat_color;
ufbx_material_map coat_roughness;
ufbx_material_map coat_ior;
ufbx_material_map coat_anisotropy;
ufbx_material_map coat_rotation;
ufbx_material_map coat_normal;
ufbx_material_map coat_affect_base_color;
ufbx_material_map coat_affect_base_roughness;
ufbx_material_map thin_film_thickness;
ufbx_material_map thin_film_ior;
ufbx_material_map emission_factor;
ufbx_material_map emission_color;
ufbx_material_map opacity;
ufbx_material_map indirect_diffuse;
ufbx_material_map indirect_specular;
ufbx_material_map normal_map;
ufbx_material_map tangent_map;
ufbx_material_map displacement_map;
ufbx_material_map matte_factor;
ufbx_material_map matte_color;
ufbx_material_map ambient_occlusion;
ufbx_material_map glossiness;
ufbx_material_map coat_glossiness;
ufbx_material_map transmission_glossiness;
};
};
} ufbx_material_pbr_maps;
typedef struct ufbx_material_features {
union {
ufbx_material_feature_info features[UFBX_MATERIAL_FEATURE_COUNT];
struct {
ufbx_material_feature_info pbr;
ufbx_material_feature_info metalness;
ufbx_material_feature_info diffuse;
ufbx_material_feature_info specular;
ufbx_material_feature_info emission;
ufbx_material_feature_info transmission;
ufbx_material_feature_info coat;
ufbx_material_feature_info sheen;
ufbx_material_feature_info opacity;
ufbx_material_feature_info ambient_occlusion;
ufbx_material_feature_info matte;
ufbx_material_feature_info unlit;
ufbx_material_feature_info ior;
ufbx_material_feature_info diffuse_roughness;
ufbx_material_feature_info transmission_roughness;
ufbx_material_feature_info thin_walled;
ufbx_material_feature_info caustics;
ufbx_material_feature_info exit_to_background;
ufbx_material_feature_info internal_reflections;
ufbx_material_feature_info double_sided;
ufbx_material_feature_info roughness_as_glossiness;
ufbx_material_feature_info coat_roughness_as_glossiness;
ufbx_material_feature_info transmission_roughness_as_glossiness;
};
};
} ufbx_material_features;
// Surface material properties such as color, roughness, etc. Each property may
// be optionally bound to an `ufbx_texture`.
struct ufbx_material {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
}; };
// FBX builtin properties
// NOTE: These may be empty if the material is using a custom shader
ufbx_material_fbx_maps fbx;
// PBR material properties, defined for all shading models but may be
// somewhat approximate if `shader == NULL`.
ufbx_material_pbr_maps pbr;
// Material features, primarily applies to `pbr`.
ufbx_material_features features;
// Shading information
ufbx_shader_type shader_type; // < Always defined
ufbx_nullable ufbx_shader *shader; // < Optional extended shader information
ufbx_string shading_model_name; // < Often one of `{ "lambert", "phong", "unknown" }`
// Prefix before shader property names with trailing `|`.
// For example `"3dsMax|Parameters|"` where properties would have names like
// `"3dsMax|Parameters|base_color"`. You can ignore this if you use the built-in
// `ufbx_material_fbx_maps fbx` and `ufbx_material_pbr_maps pbr` structures.
ufbx_string shader_prop_prefix;
// All textures attached to the material, if you want specific maps if might be
// more convenient to use eg. `fbx.diffuse_color.texture` or `pbr.base_color.texture`
ufbx_material_texture_list textures; // < Sorted by `material_prop`
};
typedef enum ufbx_texture_type UFBX_ENUM_REPR {
// Texture associated with an image file/sequence. `texture->filename` and
// and `texture->relative_filename` contain the texture's path. If the file
// has embedded content `texture->content` may hold `texture->content_size`
// bytes of raw image data.
UFBX_TEXTURE_FILE,
// The texture consists of multiple texture layers blended together.
UFBX_TEXTURE_LAYERED,
// Reserved as these _should_ exist in FBX files.
UFBX_TEXTURE_PROCEDURAL,
// Node in a shader graph.
// Use `ufbx_texture.shader` for more information.
UFBX_TEXTURE_SHADER,
UFBX_ENUM_FORCE_WIDTH(UFBX_TEXTURE_TYPE)
} ufbx_texture_type;
UFBX_ENUM_TYPE(ufbx_texture_type, UFBX_TEXTURE_TYPE, UFBX_TEXTURE_SHADER);
// Blend modes to combine layered textures with, compatible with common blend
// mode definitions in many art programs. Simpler blend modes have equations
// specified below where `src` is the layer to composite over `dst`.
// See eg. https://www.w3.org/TR/2013/WD-compositing-1-20131010/#blendingseparable
typedef enum ufbx_blend_mode UFBX_ENUM_REPR {
UFBX_BLEND_TRANSLUCENT, // < `src` effects result alpha
UFBX_BLEND_ADDITIVE, // < `src + dst`
UFBX_BLEND_MULTIPLY, // < `src * dst`
UFBX_BLEND_MULTIPLY_2X, // < `2 * src * dst`
UFBX_BLEND_OVER, // < `src * src_alpha + dst * (1-src_alpha)`
UFBX_BLEND_REPLACE, // < `src` Replace the contents
UFBX_BLEND_DISSOLVE, // < `random() + src_alpha >= 1.0 ? src : dst`
UFBX_BLEND_DARKEN, // < `min(src, dst)`
UFBX_BLEND_COLOR_BURN, // < `src > 0 ? 1 - min(1, (1-dst) / src) : 0`
UFBX_BLEND_LINEAR_BURN, // < `src + dst - 1`
UFBX_BLEND_DARKER_COLOR, // < `value(src) < value(dst) ? src : dst`
UFBX_BLEND_LIGHTEN, // < `max(src, dst)`
UFBX_BLEND_SCREEN, // < `1 - (1-src)*(1-dst)`
UFBX_BLEND_COLOR_DODGE, // < `src < 1 ? dst / (1 - src)` : (dst>0?1:0)`
UFBX_BLEND_LINEAR_DODGE, // < `src + dst`
UFBX_BLEND_LIGHTER_COLOR, // < `value(src) > value(dst) ? src : dst`
UFBX_BLEND_SOFT_LIGHT, // < https://www.w3.org/TR/2013/WD-compositing-1-20131010/#blendingsoftlight
UFBX_BLEND_HARD_LIGHT, // < https://www.w3.org/TR/2013/WD-compositing-1-20131010/#blendinghardlight
UFBX_BLEND_VIVID_LIGHT, // < Combination of `COLOR_DODGE` and `COLOR_BURN`
UFBX_BLEND_LINEAR_LIGHT, // < Combination of `LINEAR_DODGE` and `LINEAR_BURN`
UFBX_BLEND_PIN_LIGHT, // < Combination of `DARKEN` and `LIGHTEN`
UFBX_BLEND_HARD_MIX, // < Produces primary colors depending on similarity
UFBX_BLEND_DIFFERENCE, // < `abs(src - dst)`
UFBX_BLEND_EXCLUSION, // < `dst + src - 2 * src * dst`
UFBX_BLEND_SUBTRACT, // < `dst - src`
UFBX_BLEND_DIVIDE, // < `dst / src`
UFBX_BLEND_HUE, // < Replace hue
UFBX_BLEND_SATURATION, // < Replace saturation
UFBX_BLEND_COLOR, // < Replace hue and saturatio
UFBX_BLEND_LUMINOSITY, // < Replace value
UFBX_BLEND_OVERLAY, // < Same as `HARD_LIGHT` but with `src` and `dst` swapped
UFBX_ENUM_FORCE_WIDTH(UFBX_BLEND_MODE)
} ufbx_blend_mode;
UFBX_ENUM_TYPE(ufbx_blend_mode, UFBX_BLEND_MODE, UFBX_BLEND_OVERLAY);
// Blend modes to combine layered textures with, compatible with common blend
typedef enum ufbx_wrap_mode UFBX_ENUM_REPR {
UFBX_WRAP_REPEAT, // < Repeat the texture past the [0,1] range
UFBX_WRAP_CLAMP, // < Clamp the normalized texture coordinates to [0,1]
UFBX_ENUM_FORCE_WIDTH(UFBX_WRAP_MODE)
} ufbx_wrap_mode;
UFBX_ENUM_TYPE(ufbx_wrap_mode, UFBX_WRAP_MODE, UFBX_WRAP_CLAMP);
// Single layer in a layered texture
typedef struct ufbx_texture_layer {
ufbx_texture *texture; // < The inner texture to evaluate, never `NULL`
ufbx_blend_mode blend_mode; // < Equation to combine the layer to the background
ufbx_real alpha; // < Blend weight of this layer
} ufbx_texture_layer;
UFBX_LIST_TYPE(ufbx_texture_layer_list, ufbx_texture_layer);
typedef enum ufbx_shader_texture_type UFBX_ENUM_REPR {
UFBX_SHADER_TEXTURE_UNKNOWN,
// Select an output of a multi-output shader.
// HINT: If this type is used the `ufbx_shader_texture.main_texture` and
// `ufbx_shader_texture.main_texture_output_index` fields are set.
UFBX_SHADER_TEXTURE_SELECT_OUTPUT,
// Open Shading Language (OSL) shader.
// https://github.com/AcademySoftwareFoundation/OpenShadingLanguage
UFBX_SHADER_TEXTURE_OSL,
UFBX_ENUM_FORCE_WIDTH(UFBX_SHADER_TEXTURE_TYPE)
} ufbx_shader_texture_type;
UFBX_ENUM_TYPE(ufbx_shader_texture_type, UFBX_SHADER_TEXTURE_TYPE, UFBX_SHADER_TEXTURE_OSL);
// Input to a shader texture, see `ufbx_shader_texture`.
typedef struct ufbx_shader_texture_input {
// Name of the input.
ufbx_string name;
// Constant value of the input.
union {
ufbx_real value_real;
ufbx_vec2 value_vec2;
ufbx_vec3 value_vec3;
ufbx_vec4 value_vec4;
};
int64_t value_int;
ufbx_string value_str;
ufbx_blob value_blob;
// Texture connected to this input.
ufbx_nullable ufbx_texture *texture;
// Index of the output to use if `texture` is a multi-output shader node.
int64_t texture_output_index;
// Controls whether shading should use `texture`.
// NOTE: Some shading models allow this to be `true` even if `texture == NULL`.
bool texture_enabled;
// Property representing this input.
ufbx_prop *prop;
// Property representing `texture`.
ufbx_nullable ufbx_prop *texture_prop;
// Property representing `texture_enabled`.
ufbx_nullable ufbx_prop *texture_enabled_prop;
} ufbx_shader_texture_input;
UFBX_LIST_TYPE(ufbx_shader_texture_input_list, ufbx_shader_texture_input);
// Texture that emulates a shader graph node.
// 3ds Max exports some materials as node graphs serialized to textures.
// ufbx can parse a small subset of these, as normal maps are often hidden behind
// some kind of bump node.
// NOTE: These encode a lot of details of 3ds Max internals, not recommended for direct use.
// HINT: `ufbx_texture.file_textures[]` contains a list of "real" textures that are connected
// to the `ufbx_texture` that is pretending to be a shader node.
typedef struct ufbx_shader_texture {
// Type of this shader node.
ufbx_shader_texture_type type;
// Name of the shader to use.
ufbx_string shader_name;
// 64-bit opaque identifier for the shader type.
uint64_t shader_type_id;
// Input values/textures (possibly further shader textures) to the shader.
// Sorted by `ufbx_shader_texture_input.name`.
ufbx_shader_texture_input_list inputs;
// Shader source code if found.
ufbx_string shader_source;
ufbx_blob raw_shader_source;
// Representative texture for this shader.
// Only specified if `main_texture.outputs[main_texture_output_index]` is semantically
// equivalent to this texture.
ufbx_texture *main_texture;
// Output index of `main_texture` if it is a multi-output shader.
int64_t main_texture_output_index;
// Prefix for properties related to this shader in `ufbx_texture`.
// NOTE: Contains the trailing '|' if not empty.
ufbx_string prop_prefix;
} ufbx_shader_texture;
// Unique texture within the file.
typedef struct ufbx_texture_file {
// Index in `ufbx_scene.texture_files[]`.
uint32_t index;
// Paths to the resource.
// Filename relative to the currently loaded file.
// HINT: If using functions other than `ufbx_load_file()`, you can provide
// `ufbx_load_opts.filename/raw_filename` to let ufbx resolve this.
ufbx_string filename;
// Absolute filename specified in the file.
ufbx_string absolute_filename;
// Relative filename specified in the file.
// NOTE: May be absolute if the file is saved in a different drive.
ufbx_string relative_filename;
// Filename relative to the loaded file, non-UTF-8 encoded.
// HINT: If using functions other than `ufbx_load_file()`, you can provide
// `ufbx_load_opts.filename/raw_filename` to let ufbx resolve this.
ufbx_blob raw_filename;
// Absolute filename specified in the file, non-UTF-8 encoded.
ufbx_blob raw_absolute_filename;
// Relative filename specified in the file, non-UTF-8 encoded.
// NOTE: May be absolute if the file is saved in a different drive.
ufbx_blob raw_relative_filename;
// Optional embedded content blob, eg. raw .png format data
ufbx_blob content;
} ufbx_texture_file;
UFBX_LIST_TYPE(ufbx_texture_file_list, ufbx_texture_file);
// Texture that controls material appearance
struct ufbx_texture {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
}; };
// Texture type (file / layered / procedural / shader)
ufbx_texture_type type;
// FILE: Paths to the resource
// Filename relative to the currently loaded file.
// HINT: If using functions other than `ufbx_load_file()`, you can provide
// `ufbx_load_opts.filename/raw_filename` to let ufbx resolve this.
ufbx_string filename;
// Absolute filename specified in the file.
ufbx_string absolute_filename;
// Relative filename specified in the file.
// NOTE: May be absolute if the file is saved in a different drive.
ufbx_string relative_filename;
// Filename relative to the loaded file, non-UTF-8 encoded.
// HINT: If using functions other than `ufbx_load_file()`, you can provide
// `ufbx_load_opts.filename/raw_filename` to let ufbx resolve this.
ufbx_blob raw_filename;
// Absolute filename specified in the file, non-UTF-8 encoded.
ufbx_blob raw_absolute_filename;
// Relative filename specified in the file, non-UTF-8 encoded.
// NOTE: May be absolute if the file is saved in a different drive.
ufbx_blob raw_relative_filename;
// FILE: Optional embedded content blob, eg. raw .png format data
ufbx_blob content;
// FILE: Optional video texture
ufbx_nullable ufbx_video *video;
// FILE: Index into `ufbx_scene.texture_files[]` or `UFBX_NO_INDEX`.
uint32_t file_index;
// FILE: True if `file_index` has a valid value.
bool has_file;
// LAYERED: Inner texture layers, ordered from _bottom_ to _top_
ufbx_texture_layer_list layers;
// SHADER: Shader information
// NOTE: May be specified even if `type == UFBX_TEXTURE_FILE` if `ufbx_load_opts.disable_quirks`
// is _not_ specified. Some known shaders that represent files are interpreted as `UFBX_TEXTURE_FILE`.
ufbx_nullable ufbx_shader_texture *shader;
// List of file textures representing this texture.
// Defined even if `type == UFBX_TEXTURE_FILE` in which case the array contains only itself.
ufbx_texture_list file_textures;
// Name of the UV set to use
ufbx_string uv_set;
// Wrapping mode
ufbx_wrap_mode wrap_u;
ufbx_wrap_mode wrap_v;
// UV transform
bool has_uv_transform; // < Has a non-identity `transform` and derived matrices.
ufbx_transform uv_transform; // < Texture transformation in UV space
ufbx_matrix texture_to_uv; // < Matrix representation of `transform`
ufbx_matrix uv_to_texture; // < UV coordinate to normalized texture coordinate matrix
};
// TODO: Video textures
struct ufbx_video {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
}; };
// Paths to the resource
// Filename relative to the currently loaded file.
// HINT: If using functions other than `ufbx_load_file()`, you can provide
// `ufbx_load_opts.filename/raw_filename` to let ufbx resolve this.
ufbx_string filename;
// Absolute filename specified in the file.
ufbx_string absolute_filename;
// Relative filename specified in the file.
// NOTE: May be absolute if the file is saved in a different drive.
ufbx_string relative_filename;
// Filename relative to the loaded file, non-UTF-8 encoded.
// HINT: If using functions other than `ufbx_load_file()`, you can provide
// `ufbx_load_opts.filename/raw_filename` to let ufbx resolve this.
ufbx_blob raw_filename;
// Absolute filename specified in the file, non-UTF-8 encoded.
ufbx_blob raw_absolute_filename;
// Relative filename specified in the file, non-UTF-8 encoded.
// NOTE: May be absolute if the file is saved in a different drive.
ufbx_blob raw_relative_filename;
// Optional embedded content blob
ufbx_blob content;
};
// Shader specifies a shading model and contains `ufbx_shader_binding` elements
// that define how to interpret FBX properties in the shader.
struct ufbx_shader {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
}; };
// Known shading model
ufbx_shader_type type;
// TODO: Expose actual properties here
// Bindings from FBX properties to the shader
// HINT: `ufbx_find_shader_prop()` translates shader properties to FBX properties
ufbx_shader_binding_list bindings;
};
// Binding from a material property to shader implementation
typedef struct ufbx_shader_prop_binding {
ufbx_string shader_prop; // < Property name used by the shader implementation
ufbx_string material_prop; // < Property name inside `ufbx_material.props`
} ufbx_shader_prop_binding;
UFBX_LIST_TYPE(ufbx_shader_prop_binding_list, ufbx_shader_prop_binding);
// Shader binding table
struct ufbx_shader_binding {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
}; };
ufbx_shader_prop_binding_list prop_bindings; // < Sorted by `shader_prop`
};
// -- Animation
typedef struct ufbx_prop_override {
uint32_t element_id;
uint32_t _internal_key;
ufbx_string prop_name;
ufbx_vec4 value;
ufbx_string value_str;
int64_t value_int;
} ufbx_prop_override;
UFBX_LIST_TYPE(ufbx_prop_override_list, ufbx_prop_override);
typedef struct ufbx_transform_override {
uint32_t node_id;
ufbx_transform transform;
} ufbx_transform_override;
UFBX_LIST_TYPE(ufbx_transform_override_list, ufbx_transform_override);
// Animation descriptor used for evaluating animation.
// Usually obtained from `ufbx_scene` via either global animation `ufbx_scene.anim`,
// per-stack animation `ufbx_anim_stack.anim` or per-layer animation `ufbx_anim_layer.anim`.
//
// For advanced usage you can use `ufbx_create_anim()` to create animation descriptors
// with custom layers, property overrides, special flags, etc.
typedef struct ufbx_anim {
// Time begin/end for the animation, both may be zero if absent.
double time_begin;
double time_end;
// List of layers in the animation.
ufbx_anim_layer_list layers;
// Optional overrides for weights for each layer in `layers[]`.
ufbx_real_list override_layer_weights;
// Sorted by `element_id, prop_name`
ufbx_prop_override_list prop_overrides;
// Sorted by `node_id`
ufbx_transform_override_list transform_overrides;
// Evaluate connected properties as if they would not be connected.
bool ignore_connections;
// Custom `ufbx_anim` created by `ufbx_create_anim()`.
bool custom;
} ufbx_anim;
struct ufbx_anim_stack {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
}; };
double time_begin;
double time_end;
ufbx_anim_layer_list layers;
ufbx_anim *anim;
};
typedef struct ufbx_anim_prop {
ufbx_element *element;
uint32_t _internal_key;
ufbx_string prop_name;
ufbx_anim_value *anim_value;
} ufbx_anim_prop;
UFBX_LIST_TYPE(ufbx_anim_prop_list, ufbx_anim_prop);
struct ufbx_anim_layer {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
}; };
ufbx_real weight;
bool weight_is_animated;
bool blended;
bool additive;
bool compose_rotation;
bool compose_scale;
ufbx_anim_value_list anim_values;
ufbx_anim_prop_list anim_props; // < Sorted by `element,prop_name`
ufbx_anim *anim;
uint32_t _min_element_id;
uint32_t _max_element_id;
uint32_t _element_id_bitmask[4];
};
struct ufbx_anim_value {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
}; };
ufbx_vec3 default_value;
ufbx_nullable ufbx_anim_curve *curves[3];
};
// Animation curve segment interpolation mode between two keyframes
typedef enum ufbx_interpolation UFBX_ENUM_REPR {
UFBX_INTERPOLATION_CONSTANT_PREV, // < Hold previous key value
UFBX_INTERPOLATION_CONSTANT_NEXT, // < Hold next key value
UFBX_INTERPOLATION_LINEAR, // < Linear interpolation between two keys
UFBX_INTERPOLATION_CUBIC, // < Cubic interpolation, see `ufbx_tangent`
UFBX_ENUM_FORCE_WIDTH(UFBX_INTERPOLATION)
} ufbx_interpolation;
UFBX_ENUM_TYPE(ufbx_interpolation, UFBX_INTERPOLATION, UFBX_INTERPOLATION_CUBIC);
// Tangent vector at a keyframe, may be split into left/right
typedef struct ufbx_tangent {
float dx; // < Derivative in the time axis
float dy; // < Derivative in the (curve specific) value axis
} ufbx_tangent;
// Single real `value` at a specified `time`, interpolation between two keyframes
// is determined by the `interpolation` field of the _previous_ key.
// If `interpolation == UFBX_INTERPOLATION_CUBIC` the span is evaluated as a
// cubic bezier curve through the following points:
//
// (prev->time, prev->value)
// (prev->time + prev->right.dx, prev->value + prev->right.dy)
// (next->time - next->left.dx, next->value - next->left.dy)
// (next->time, next->value)
//
// HINT: You can use `ufbx_evaluate_curve(ufbx_anim_curve *curve, double time)`
// rather than trying to manually handle all the interpolation modes.
typedef struct ufbx_keyframe {
double time;
ufbx_real value;
ufbx_interpolation interpolation;
ufbx_tangent left;
ufbx_tangent right;
} ufbx_keyframe;
UFBX_LIST_TYPE(ufbx_keyframe_list, ufbx_keyframe);
struct ufbx_anim_curve {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
}; };
ufbx_keyframe_list keyframes;
ufbx_real min_value;
ufbx_real max_value;
};
// -- Collections
// Collection of nodes to hide/freeze
struct ufbx_display_layer {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
}; };
// Nodes included in the layer (exclusively at most one layer per node)
ufbx_node_list nodes;
// Layer state
bool visible; // < Contained nodes are visible
bool frozen; // < Contained nodes cannot be edited
ufbx_vec3 ui_color; // < Visual color for UI
};
// Named set of nodes/geometry features to select.
struct ufbx_selection_set {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
}; };
// Included nodes and geometry features
ufbx_selection_node_list nodes;
};
// Selection state of a node, potentially contains vertex/edge/face selection as well.
struct ufbx_selection_node {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
}; };
// Selection targets, possibly `NULL`
ufbx_nullable ufbx_node *target_node;
ufbx_nullable ufbx_mesh *target_mesh;
bool include_node; // < Is `target_node` included in the selection
// Indices to selected components.
// Guaranteed to be valid as per `ufbx_load_opts.index_error_handling`
// if `target_mesh` is not `NULL`.
ufbx_uint32_list vertices; // < Indices to `ufbx_mesh.vertices`
ufbx_uint32_list edges; // < Indices to `ufbx_mesh.edges`
ufbx_uint32_list faces; // < Indices to `ufbx_mesh.faces`
};
// -- Constraints
struct ufbx_character {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
}; };
};
// Type of property constrain eg. position or look-at
typedef enum ufbx_constraint_type UFBX_ENUM_REPR {
UFBX_CONSTRAINT_UNKNOWN,
UFBX_CONSTRAINT_AIM,
UFBX_CONSTRAINT_PARENT,
UFBX_CONSTRAINT_POSITION,
UFBX_CONSTRAINT_ROTATION,
UFBX_CONSTRAINT_SCALE,
// Inverse kinematic chain to a single effector `ufbx_constraint.ik_effector`
// `targets` optionally contains a list of pole targets!
UFBX_CONSTRAINT_SINGLE_CHAIN_IK,
UFBX_ENUM_FORCE_WIDTH(UFBX_CONSTRAINT_TYPE)
} ufbx_constraint_type;
UFBX_ENUM_TYPE(ufbx_constraint_type, UFBX_CONSTRAINT_TYPE, UFBX_CONSTRAINT_SINGLE_CHAIN_IK);
// Target to follow with a constraint
typedef struct ufbx_constraint_target {
ufbx_node *node; // < Target node reference
ufbx_real weight; // < Relative weight to other targets (does not always sum to 1)
ufbx_transform transform; // < Offset from the actual target
} ufbx_constraint_target;
UFBX_LIST_TYPE(ufbx_constraint_target_list, ufbx_constraint_target);
// Method to determine the up vector in aim constraints
typedef enum ufbx_constraint_aim_up_type UFBX_ENUM_REPR {
UFBX_CONSTRAINT_AIM_UP_SCENE, // < Align the up vector to the scene global up vector
UFBX_CONSTRAINT_AIM_UP_TO_NODE, // < Aim the up vector at `ufbx_constraint.aim_up_node`
UFBX_CONSTRAINT_AIM_UP_ALIGN_NODE, // < Copy the up vector from `ufbx_constraint.aim_up_node`
UFBX_CONSTRAINT_AIM_UP_VECTOR, // < Use `ufbx_constraint.aim_up_vector` as the up vector
UFBX_CONSTRAINT_AIM_UP_NONE, // < Don't align the up vector to anything
UFBX_ENUM_FORCE_WIDTH(UFBX_CONSTRAINT_AIM_UP_TYPE)
} ufbx_constraint_aim_up_type;
UFBX_ENUM_TYPE(ufbx_constraint_aim_up_type, UFBX_CONSTRAINT_AIM_UP_TYPE, UFBX_CONSTRAINT_AIM_UP_NONE);
// Method to determine the up vector in aim constraints
typedef enum ufbx_constraint_ik_pole_type UFBX_ENUM_REPR {
UFBX_CONSTRAINT_IK_POLE_VECTOR, // < Use towards calculated from `ufbx_constraint.targets`
UFBX_CONSTRAINT_IK_POLE_NODE, // < Use `ufbx_constraint.ik_pole_vector` directly
UFBX_ENUM_FORCE_WIDTH(UFBX_CONSTRAINT_IK_POLE_TYPE)
} ufbx_constraint_ik_pole_type;
UFBX_ENUM_TYPE(ufbx_constraint_ik_pole_type, UFBX_CONSTRAINT_IK_POLE_TYPE, UFBX_CONSTRAINT_IK_POLE_NODE);
struct ufbx_constraint {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
}; };
// Type of constraint to use
ufbx_constraint_type type;
ufbx_string type_name;
// Node to be constrained
ufbx_nullable ufbx_node *node;
// List of weighted targets for the constraint (pole vectors for IK)
ufbx_constraint_target_list targets;
// State of the constraint
ufbx_real weight;
bool active;
// Translation/rotation/scale axes the constraint is applied to
bool constrain_translation[3];
bool constrain_rotation[3];
bool constrain_scale[3];
// Offset from the constrained position
ufbx_transform transform_offset;
// AIM: Target and up vectors
ufbx_vec3 aim_vector;
ufbx_constraint_aim_up_type aim_up_type;
ufbx_nullable ufbx_node *aim_up_node;
ufbx_vec3 aim_up_vector;
// SINGLE_CHAIN_IK: Target for the IK, `targets` contains pole vectors!
ufbx_nullable ufbx_node *ik_effector;
ufbx_nullable ufbx_node *ik_end_node;
ufbx_vec3 ik_pole_vector;
};
// -- Audio
struct ufbx_audio_layer {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
}; };
// Clips contained in this layer.
ufbx_audio_clip_list clips;
};
struct ufbx_audio_clip {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
}; };
// Filename relative to the currently loaded file.
// HINT: If using functions other than `ufbx_load_file()`, you can provide
// `ufbx_load_opts.filename/raw_filename` to let ufbx resolve this.
ufbx_string filename;
// Absolute filename specified in the file.
ufbx_string absolute_filename;
// Relative filename specified in the file.
// NOTE: May be absolute if the file is saved in a different drive.
ufbx_string relative_filename;
// Filename relative to the loaded file, non-UTF-8 encoded.
// HINT: If using functions other than `ufbx_load_file()`, you can provide
// `ufbx_load_opts.filename/raw_filename` to let ufbx resolve this.
ufbx_blob raw_filename;
// Absolute filename specified in the file, non-UTF-8 encoded.
ufbx_blob raw_absolute_filename;
// Relative filename specified in the file, non-UTF-8 encoded.
// NOTE: May be absolute if the file is saved in a different drive.
ufbx_blob raw_relative_filename;
// Optional embedded content blob, eg. raw .png format data
ufbx_blob content;
};
// -- Miscellaneous
typedef struct ufbx_bone_pose {
// Node to apply the pose to.
ufbx_node *bone_node;
// Matrix from node local space to world space.
ufbx_matrix bone_to_world;
// Matrix from node local space to parent space.
// NOTE: FBX only stores world transformations so this is approximated from
// the parent world transform.
ufbx_matrix bone_to_parent;
} ufbx_bone_pose;
UFBX_LIST_TYPE(ufbx_bone_pose_list, ufbx_bone_pose);
struct ufbx_pose {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
}; };
// Set if this pose is marked as a bind pose.
bool is_bind_pose;
// List of bone poses.
// Sorted by `ufbx_node.typed_id`.
ufbx_bone_pose_list bone_poses;
};
struct ufbx_metadata_object {
union { ufbx_element element; struct {
ufbx_string name;
ufbx_props props;
uint32_t element_id;
uint32_t typed_id;
}; };
};
// -- Named elements
typedef struct ufbx_name_element {
ufbx_string name;
ufbx_element_type type;
uint32_t _internal_key;
ufbx_element *element;
} ufbx_name_element;
UFBX_LIST_TYPE(ufbx_name_element_list, ufbx_name_element);
// -- Scene
// Scene is the root object loaded by ufbx that everything is accessed from.
typedef enum ufbx_exporter UFBX_ENUM_REPR {
UFBX_EXPORTER_UNKNOWN,
UFBX_EXPORTER_FBX_SDK,
UFBX_EXPORTER_BLENDER_BINARY,
UFBX_EXPORTER_BLENDER_ASCII,
UFBX_EXPORTER_MOTION_BUILDER,
UFBX_ENUM_FORCE_WIDTH(UFBX_EXPORTER)
} ufbx_exporter;
UFBX_ENUM_TYPE(ufbx_exporter, UFBX_EXPORTER, UFBX_EXPORTER_MOTION_BUILDER);
typedef struct ufbx_application {
ufbx_string vendor;
ufbx_string name;
ufbx_string version;
} ufbx_application;
typedef enum ufbx_file_format UFBX_ENUM_REPR {
UFBX_FILE_FORMAT_UNKNOWN, // < Unknown file format
UFBX_FILE_FORMAT_FBX, // < .fbx Kaydara/Autodesk FBX file
UFBX_FILE_FORMAT_OBJ, // < .obj Wavefront OBJ file
UFBX_FILE_FORMAT_MTL, // < .mtl Wavefront MTL (Material template library) file
UFBX_ENUM_FORCE_WIDTH(UFBX_FILE_FORMAT)
} ufbx_file_format;
UFBX_ENUM_TYPE(ufbx_file_format, UFBX_FILE_FORMAT, UFBX_FILE_FORMAT_MTL);
typedef enum ufbx_warning_type UFBX_ENUM_REPR {
// Missing external file file (for example .mtl for Wavefront .obj file or a
// geometry cache)
UFBX_WARNING_MISSING_EXTERNAL_FILE,
// Loaded a Wavefront .mtl file derived from the filename instead of a proper
// `mtllib` statement.
UFBX_WARNING_IMPLICIT_MTL,
// Truncated array has been auto-expanded.
UFBX_WARNING_TRUNCATED_ARRAY,
// Geometry data has been defined but has no data.
UFBX_WARNING_MISSING_GEOMETRY_DATA,
// Duplicated connection between two elements that shouldn't have.
UFBX_WARNING_DUPLICATE_CONNECTION,
// Vertex 'W' attribute length differs from main attribute.
UFBX_WARNING_BAD_VERTEX_W_ATTRIBUTE,
// Missing polygon mapping type.
UFBX_WARNING_MISSING_POLYGON_MAPPING,
// Out-of-bounds index has been clamped to be in-bounds.
// HINT: You can use `ufbx_index_error_handling` to adjust behavior.
UFBX_WARNING_INDEX_CLAMPED,
// Non-UTF8 encoded strings.
// HINT: You can use `ufbx_unicode_error_handling` to adjust behavior.
UFBX_WARNING_BAD_UNICODE,
// Non-node element connected to root.
UFBX_WARNING_BAD_ELEMENT_CONNECTED_TO_ROOT,
// Duplicated object ID in the file, connections will be wrong.
UFBX_WARNING_DUPLICATE_OBJECT_ID,
// Empty face has been removed.
// Use `ufbx_load_opts.allow_empty_faces` if you want to allow them.
UFBX_WARNING_EMPTY_FACE_REMOVED,
// Unknown .obj file directive.
UFBX_WARNING_UNKNOWN_OBJ_DIRECTIVE,
// Warnings after this one are deduplicated.
// See `ufbx_warning.count` for how many times they happened.
UFBX_WARNING_TYPE_FIRST_DEDUPLICATED = UFBX_WARNING_INDEX_CLAMPED,
UFBX_ENUM_FORCE_WIDTH(UFBX_WARNING_TYPE)
} ufbx_warning_type;
UFBX_ENUM_TYPE(ufbx_warning_type, UFBX_WARNING_TYPE, UFBX_WARNING_UNKNOWN_OBJ_DIRECTIVE);
// Warning about a non-fatal issue in the file.
// Often contains information about issues that ufbx has corrected about the
// file but it might indicate something is not working properly.
typedef struct ufbx_warning {
// Type of the warning.
ufbx_warning_type type;
// Description of the warning.
ufbx_string description;
// The element related to this warning or `UFBX_NO_INDEX` if not related to a specific element.
uint32_t element_id;
// Number of times this warning was encountered.
size_t count;
} ufbx_warning;
UFBX_LIST_TYPE(ufbx_warning_list, ufbx_warning);
typedef enum ufbx_thumbnail_format UFBX_ENUM_REPR {
UFBX_THUMBNAIL_FORMAT_UNKNOWN, // < Unknown format
UFBX_THUMBNAIL_FORMAT_RGB_24, // < 8-bit RGB pixels, in memory R,G,B
UFBX_THUMBNAIL_FORMAT_RGBA_32, // < 8-bit RGBA pixels, in memory R,G,B,A
UFBX_ENUM_FORCE_WIDTH(UFBX_THUMBNAIL_FORMAT)
} ufbx_thumbnail_format;
UFBX_ENUM_TYPE(ufbx_thumbnail_format, UFBX_THUMBNAIL_FORMAT, UFBX_THUMBNAIL_FORMAT_RGBA_32);
// Specify how unit / coordinate system conversion should be performed.
// Affects how `ufbx_load_opts.target_axes` and `ufbx_load_opts.target_unit_meters` work,
// has no effect if neither is specified.
typedef enum ufbx_space_conversion UFBX_ENUM_REPR {
// Store the space conversion transform in the root node.
// Sets `ufbx_node.local_transform` of the root node.
UFBX_SPACE_CONVERSION_TRANSFORM_ROOT,
// Perform the conversion by using "adjust" transforms.
// Compensates for the transforms using `ufbx_node.adjust_pre_rotation` and
// `ufbx_node.adjust_pre_scale`. You don't need to account for these unless
// you are manually building transforms from `ufbx_props`.
UFBX_SPACE_CONVERSION_ADJUST_TRANSFORMS,
// Perform the conversion by scaling geometry in addition to adjusting transforms.
// Compensates transforms like `UFBX_SPACE_CONVERSION_ADJUST_TRANSFORMS` but
// applies scaling to geometry as well.
UFBX_SPACE_CONVERSION_MODIFY_GEOMETRY,
UFBX_ENUM_FORCE_WIDTH(UFBX_SPACE_CONVERSION)
} ufbx_space_conversion;
UFBX_ENUM_TYPE(ufbx_space_conversion, UFBX_SPACE_CONVERSION, UFBX_SPACE_CONVERSION_MODIFY_GEOMETRY);
// Embedded thumbnail in the file, valid if the dimensions are non-zero.
typedef struct ufbx_thumbnail {
ufbx_props props;
// Extents of the thumbnail
uint32_t width;
uint32_t height;
// Format of `ufbx_thumbnail.data`.
ufbx_thumbnail_format format;
// Thumbnail pixel data, layout as contiguous rows from bottom to top.
// See `ufbx_thumbnail.format` for the pixel format.
ufbx_blob data;
} ufbx_thumbnail;
// Miscellaneous data related to the loaded file
typedef struct ufbx_metadata {
// List of non-fatal warnings about the file.
// If you need to only check whether a specific warning was triggered you
// can use `ufbx_metadata.has_warning[]`.
ufbx_warning_list warnings;
// FBX ASCII file format.
bool ascii;
// FBX version in integer format, eg. 7400 for 7.4.
uint32_t version;
// File format of the source file.
ufbx_file_format file_format;
// Index arrays may contain `UFBX_NO_INDEX` instead of a valid index
// to indicate gaps.
bool may_contain_no_index;
// May contain meshes with no defined vertex position.
// NOTE: `ufbx_mesh.vertex_position.exists` may be `false`!
bool may_contain_missing_vertex_position;
// Arrays may contain items with `NULL` element references.
// See `ufbx_load_opts.connect_broken_elements`.
bool may_contain_broken_elements;
// Some API guarantees do not apply (depending on unsafe options used).
// Loaded with `ufbx_load_opts.allow_unsafe` enabled.
bool is_unsafe;
// Flag for each possible warning type.
// See `ufbx_metadata.warnings[]` for detailed warning information.
bool has_warning[UFBX_WARNING_TYPE_COUNT];
ufbx_string creator;
bool big_endian;
ufbx_string filename;
ufbx_string relative_root;
ufbx_blob raw_filename;
ufbx_blob raw_relative_root;
ufbx_exporter exporter;
uint32_t exporter_version;
ufbx_props scene_props;
ufbx_application original_application;
ufbx_application latest_application;
ufbx_thumbnail thumbnail;
bool geometry_ignored;
bool animation_ignored;
bool embedded_ignored;
size_t max_face_triangles;
size_t result_memory_used;
size_t temp_memory_used;
size_t result_allocs;
size_t temp_allocs;
size_t element_buffer_size;
size_t num_shader_textures;
ufbx_real bone_prop_size_unit;
bool bone_prop_limb_length_relative;
ufbx_real ortho_size_unit;
int64_t ktime_second; // < One second in internal KTime units
ufbx_string original_file_path;
ufbx_blob raw_original_file_path;
// Space conversion method used on the scene.
ufbx_space_conversion space_conversion;
// Transform that has been applied to root for axis/unit conversion.
ufbx_quat root_rotation;
ufbx_real root_scale;
// Axis that the scene has been mirrored by.
// All geometry has been mirrored in this axis.
ufbx_mirror_axis mirror_axis;
// Amount geometry has been scaled.
// See `UFBX_SPACE_CONVERSION_MODIFY_GEOMETRY`.
ufbx_real geometry_scale;
} ufbx_metadata;
typedef enum ufbx_time_mode UFBX_ENUM_REPR {
UFBX_TIME_MODE_DEFAULT,
UFBX_TIME_MODE_120_FPS,
UFBX_TIME_MODE_100_FPS,
UFBX_TIME_MODE_60_FPS,
UFBX_TIME_MODE_50_FPS,
UFBX_TIME_MODE_48_FPS,
UFBX_TIME_MODE_30_FPS,
UFBX_TIME_MODE_30_FPS_DROP,
UFBX_TIME_MODE_NTSC_DROP_FRAME,
UFBX_TIME_MODE_NTSC_FULL_FRAME,
UFBX_TIME_MODE_PAL,
UFBX_TIME_MODE_24_FPS,
UFBX_TIME_MODE_1000_FPS,
UFBX_TIME_MODE_FILM_FULL_FRAME,
UFBX_TIME_MODE_CUSTOM,
UFBX_TIME_MODE_96_FPS,
UFBX_TIME_MODE_72_FPS,
UFBX_TIME_MODE_59_94_FPS,
UFBX_ENUM_FORCE_WIDTH(UFBX_TIME_MODE)
} ufbx_time_mode;
UFBX_ENUM_TYPE(ufbx_time_mode, UFBX_TIME_MODE, UFBX_TIME_MODE_59_94_FPS);
typedef enum ufbx_time_protocol UFBX_ENUM_REPR {
UFBX_TIME_PROTOCOL_SMPTE,
UFBX_TIME_PROTOCOL_FRAME_COUNT,
UFBX_TIME_PROTOCOL_DEFAULT,
UFBX_ENUM_FORCE_WIDTH(UFBX_TIME_PROTOCOL)
} ufbx_time_protocol;
UFBX_ENUM_TYPE(ufbx_time_protocol, UFBX_TIME_PROTOCOL, UFBX_TIME_PROTOCOL_DEFAULT);
typedef enum ufbx_snap_mode UFBX_ENUM_REPR {
UFBX_SNAP_MODE_NONE,
UFBX_SNAP_MODE_SNAP,
UFBX_SNAP_MODE_PLAY,
UFBX_SNAP_MODE_SNAP_AND_PLAY,
UFBX_ENUM_FORCE_WIDTH(UFBX_SNAP_MODE)
} ufbx_snap_mode;
UFBX_ENUM_TYPE(ufbx_snap_mode, UFBX_SNAP_MODE, UFBX_SNAP_MODE_SNAP_AND_PLAY);
// Global settings: Axes and time/unit scales
typedef struct ufbx_scene_settings {
ufbx_props props;
// Mapping of X/Y/Z axes to world-space directions.
// HINT: Use `ufbx_load_opts.target_axes` to normalize this.
// NOTE: This contains the _original_ axes even if you supply `ufbx_load_opts.target_axes`.
ufbx_coordinate_axes axes;
// How many meters does a single world-space unit represent.
// FBX files usually default to centimeters, reported as `0.01` here.
// HINT: Use `ufbx_load_opts.target_unit_meters` to normalize this.
ufbx_real unit_meters;
// Frames per second the animation is defined at.
double frames_per_second;
ufbx_vec3 ambient_color;
ufbx_string default_camera;
// Animation user interface settings.
// HINT: Use `ufbx_scene_settings.frames_per_second` instead of interpreting these yourself.
ufbx_time_mode time_mode;
ufbx_time_protocol time_protocol;
ufbx_snap_mode snap_mode;
// Original settings (?)
ufbx_coordinate_axis original_axis_up;
ufbx_real original_unit_meters;
} ufbx_scene_settings;
struct ufbx_scene {
ufbx_metadata metadata;
// Global settings
ufbx_scene_settings settings;
// Node instances in the scene
ufbx_node *root_node;
// Default animation descriptor
ufbx_anim *anim;
union {
struct {
ufbx_unknown_list unknowns;
// Nodes
ufbx_node_list nodes;
// Node attributes (common)
ufbx_mesh_list meshes;
ufbx_light_list lights;
ufbx_camera_list cameras;
ufbx_bone_list bones;
ufbx_empty_list empties;
// Node attributes (curves/surfaces)
ufbx_line_curve_list line_curves;
ufbx_nurbs_curve_list nurbs_curves;
ufbx_nurbs_surface_list nurbs_surfaces;
ufbx_nurbs_trim_surface_list nurbs_trim_surfaces;
ufbx_nurbs_trim_boundary_list nurbs_trim_boundaries;
// Node attributes (advanced)
ufbx_procedural_geometry_list procedural_geometries;
ufbx_stereo_camera_list stereo_cameras;
ufbx_camera_switcher_list camera_switchers;
ufbx_marker_list markers;
ufbx_lod_group_list lod_groups;
// Deformers
ufbx_skin_deformer_list skin_deformers;
ufbx_skin_cluster_list skin_clusters;
ufbx_blend_deformer_list blend_deformers;
ufbx_blend_channel_list blend_channels;
ufbx_blend_shape_list blend_shapes;
ufbx_cache_deformer_list cache_deformers;
ufbx_cache_file_list cache_files;
// Materials
ufbx_material_list materials;
ufbx_texture_list textures;
ufbx_video_list videos;
ufbx_shader_list shaders;
ufbx_shader_binding_list shader_bindings;
// Animation
ufbx_anim_stack_list anim_stacks;
ufbx_anim_layer_list anim_layers;
ufbx_anim_value_list anim_values;
ufbx_anim_curve_list anim_curves;
// Collections
ufbx_display_layer_list display_layers;
ufbx_selection_set_list selection_sets;
ufbx_selection_node_list selection_nodes;
// Constraints
ufbx_character_list characters;
ufbx_constraint_list constraints;
// Audio
ufbx_audio_layer_list audio_layers;
ufbx_audio_clip_list audio_clips;
// Miscellaneous
ufbx_pose_list poses;
ufbx_metadata_object_list metadata_objects;
};
ufbx_element_list elements_by_type[UFBX_ELEMENT_TYPE_COUNT];
};
// Unique texture files referenced by the scene.
ufbx_texture_file_list texture_files;
// All elements and connections in the whole file
ufbx_element_list elements; // < Sorted by `id`
ufbx_connection_list connections_src; // < Sorted by `src,src_prop`
ufbx_connection_list connections_dst; // < Sorted by `dst,dst_prop`
// Elements sorted by name, type
ufbx_name_element_list elements_by_name;
// Enabled if `ufbx_load_opts.retain_dom == true`.
ufbx_nullable ufbx_dom_node *dom_root;
};
// -- Curves
typedef struct ufbx_curve_point {
bool valid;
ufbx_vec3 position;
ufbx_vec3 derivative;
} ufbx_curve_point;
typedef struct ufbx_surface_point {
bool valid;
ufbx_vec3 position;
ufbx_vec3 derivative_u;
ufbx_vec3 derivative_v;
} ufbx_surface_point;
// -- Mesh topology
typedef enum ufbx_topo_flags UFBX_FLAG_REPR {
UFBX_TOPO_NON_MANIFOLD = 0x1, // < Edge with three or more faces
UFBX_FLAG_FORCE_WIDTH(UFBX_TOPO_FLAGS)
} ufbx_topo_flags;
typedef struct ufbx_topo_edge {
uint32_t index; // < Starting index of the edge, always defined
uint32_t next; // < Ending index of the edge / next per-face `ufbx_topo_edge`, always defined
uint32_t prev; // < Previous per-face `ufbx_topo_edge`, always defined
uint32_t twin; // < `ufbx_topo_edge` on the opposite side, `UFBX_NO_INDEX` if not found
uint32_t face; // < Index into `mesh->faces[]`, always defined
uint32_t edge; // < Index into `mesh->edges[]`, `UFBX_NO_INDEX` if not found
ufbx_topo_flags flags;
} ufbx_topo_edge;
// Vertex data array for `ufbx_generate_indices()`.
// NOTE: `ufbx_generate_indices()` compares the vertices using `memcmp()`, so
// any padding should be cleared to zero.
typedef struct ufbx_vertex_stream {
void *data; // < Data pointer of shape `char[vertex_count][vertex_size]`.
size_t vertex_count; // < Number of vertices in this stream, for sanity checking.
size_t vertex_size; // < Size of a vertex in bytes.
} ufbx_vertex_stream;
// -- Memory callbacks
// You can optionally provide an allocator to ufbx, the default is to use the
// CRT malloc/realloc/free
// Allocate `size` bytes, must be at least 8 byte aligned
typedef void *ufbx_alloc_fn(void *user, size_t size);
// Reallocate `old_ptr` from `old_size` to `new_size`
// NOTE: If omit `alloc_fn` and `free_fn` they will be translated to:
// `alloc(size)` -> `realloc_fn(user, NULL, 0, size)`
// `free_fn(ptr, size)` -> `realloc_fn(user, ptr, size, 0)`
typedef void *ufbx_realloc_fn(void *user, void *old_ptr, size_t old_size, size_t new_size);
// Free pointer `ptr` (of `size` bytes) returned by `alloc_fn` or `realloc_fn`
typedef void ufbx_free_fn(void *user, void *ptr, size_t size);
// Free the allocator itself
typedef void ufbx_free_allocator_fn(void *user);
// Allocator callbacks and user context
// NOTE: The allocator will be stored to the loaded scene and will be called
// again from `ufbx_free_scene()` so make sure `user` outlives that!
// You can use `free_allocator_fn()` to free the allocator yourself.
typedef struct ufbx_allocator {
// Callback functions, see `typedef`s above for information
ufbx_alloc_fn *alloc_fn;
ufbx_realloc_fn *realloc_fn;
ufbx_free_fn *free_fn;
ufbx_free_allocator_fn *free_allocator_fn;
void *user;
} ufbx_allocator;
typedef struct ufbx_allocator_opts {
// Allocator callbacks
ufbx_allocator allocator;
// Maximum number of bytes to allocate before failing
size_t memory_limit;
// Maximum number of allocations to attempt before failing
size_t allocation_limit;
// Threshold to swap from batched allocations to individual ones
// Defaults to 1MB if set to zero
// NOTE: If set to `1` ufbx will allocate everything in the smallest
// possible chunks which may be useful for debugging (eg. ASAN)
size_t huge_threshold;
// Maximum size of a single allocation containing sub-allocations.
// Defaults to 16MB if set to zero
// The maximum amount of wasted memory depends on `max_chunk_size` and
// `huge_threshold`: each chunk can waste up to `huge_threshold` bytes
// internally and the last chunk might be incomplete. So for example
// with the defaults we can waste around 1MB/16MB = 6.25% overall plus
// up to 32MB due to the two incomplete blocks. The actual amounts differ
// slightly as the chunks start out at 4kB and double in size each time,
// meaning that the maximum fixed overhead (up to 32MB with defaults) is
// at most ~30% of the total allocation size.
size_t max_chunk_size;
} ufbx_allocator_opts;
// -- IO callbacks
// Try to read up to `size` bytes to `data`, return the amount of read bytes.
// Return `SIZE_MAX` to indicate an IO error.
typedef size_t ufbx_read_fn(void *user, void *data, size_t size);
// Skip `size` bytes in the file.
typedef bool ufbx_skip_fn(void *user, size_t size);
// Get the size of the file.
// Return `0` if unknown, `UINT64_MAX` if error.
typedef uint64_t ufbx_size_fn(void *user);
// Close the file
typedef void ufbx_close_fn(void *user);
typedef struct ufbx_stream {
ufbx_read_fn *read_fn; // < Required
ufbx_skip_fn *skip_fn; // < Optional: Will use `read_fn()` if missing
ufbx_size_fn *size_fn; // < Optional
ufbx_close_fn *close_fn; // < Optional
// Context passed to other functions
void *user;
} ufbx_stream;
typedef enum ufbx_open_file_type UFBX_ENUM_REPR {
UFBX_OPEN_FILE_MAIN_MODEL, // < Main model file
UFBX_OPEN_FILE_GEOMETRY_CACHE, // < Unknown geometry cache file
UFBX_OPEN_FILE_OBJ_MTL, // < .mtl material library file
UFBX_ENUM_FORCE_WIDTH(UFBX_OPEN_FILE_TYPE)
} ufbx_open_file_type;
UFBX_ENUM_TYPE(ufbx_open_file_type, UFBX_OPEN_FILE_TYPE, UFBX_OPEN_FILE_OBJ_MTL);
typedef uintptr_t ufbx_open_file_context;
typedef struct ufbx_open_file_info {
// Context that can be passed to the following functions to use a shared allocator:
// ufbx_open_file_ctx()
// ufbx_open_memory_ctx()
ufbx_open_file_context context;
// Kind of file to load.
ufbx_open_file_type type;
// Original filename in the file, not resolved or UTF-8 encoded.
// NOTE: Not necessarily NULL-terminated!
ufbx_blob original_filename;
} ufbx_open_file_info;
// Callback for opening an external file from the filesystem
typedef bool ufbx_open_file_fn(void *user, ufbx_stream *stream, const char *path, size_t path_len, const ufbx_open_file_info *info);
typedef struct ufbx_open_file_cb {
ufbx_open_file_fn *fn;
void *user;
UFBX_CALLBACK_IMPL(ufbx_open_file_cb, ufbx_open_file_fn, bool,
(void *user, ufbx_stream *stream, const char *path, size_t path_len, const ufbx_open_file_info *info),
(stream, path, path_len, info))
} ufbx_open_file_cb;
// Options for `ufbx_open_file()`.
typedef struct ufbx_open_file_opts {
uint32_t _begin_zero;
// Allocator to allocate the memory with.
ufbx_allocator_opts allocator;
// The filename is guaranteed to be NULL-terminated.
ufbx_unsafe bool filename_null_terminated;
uint32_t _end_zero;
} ufbx_open_file_opts;
// Memory stream options
typedef void ufbx_close_memory_fn(void *user, void *data, size_t data_size);
typedef struct ufbx_close_memory_cb {
ufbx_close_memory_fn *fn;
void *user;
UFBX_CALLBACK_IMPL(ufbx_close_memory_cb, ufbx_close_memory_fn, void,
(void *user, void *data, size_t data_size),
(data, data_size))
} ufbx_close_memory_cb;
// Options for `ufbx_open_memory()`.
typedef struct ufbx_open_memory_opts {
uint32_t _begin_zero;
// Allocator to allocate the memory with.
// NOTE: Used even if no copy is made to allocate a small metadata block.
ufbx_allocator_opts allocator;
// Do not copy the memory.
// You can use `close_cb` to free the memory when the stream is closed.
// NOTE: This means the provided data pointer is referenced after creating
// the memory stream, make sure the data stays valid until the stream is closed!
ufbx_unsafe bool no_copy;
// Callback to free the memory blob.
ufbx_close_memory_cb close_cb;
uint32_t _end_zero;
} ufbx_open_memory_opts;
// Detailed error stack frame
typedef struct ufbx_error_frame {
uint32_t source_line;
ufbx_string function;
ufbx_string description;
} ufbx_error_frame;
// Error causes (and `UFBX_ERROR_NONE` for no error).
typedef enum ufbx_error_type UFBX_ENUM_REPR {
// No error, operation has been performed successfully.
UFBX_ERROR_NONE,
// Unspecified error, most likely caused by an invalid FBX file or a file
// that contains something ufbx can't handle.
UFBX_ERROR_UNKNOWN,
// File not found.
UFBX_ERROR_FILE_NOT_FOUND,
// Empty file.
UFBX_ERROR_EMPTY_FILE,
// External file not found.
// See `ufbx_load_opts.load_external_files` for more information.
UFBX_ERROR_EXTERNAL_FILE_NOT_FOUND,
// Out of memory (allocator returned `NULL`).
UFBX_ERROR_OUT_OF_MEMORY,
// `ufbx_allocator_opts.memory_limit` exhausted.
UFBX_ERROR_MEMORY_LIMIT,
// `ufbx_allocator_opts.allocation_limit` exhausted.
UFBX_ERROR_ALLOCATION_LIMIT,
// File ended abruptly.
UFBX_ERROR_TRUNCATED_FILE,
// IO read error.
// eg. returning `SIZE_MAX` from `ufbx_stream.read_fn` or stdio `ferror()` condition.
UFBX_ERROR_IO,
// User cancelled the loading via `ufbx_load_opts.progress_cb` returning `UFBX_PROGRESS_CANCEL`.
UFBX_ERROR_CANCELLED,
// Could not detect file format from file data or filename.
// HINT: You can supply it manually using `ufbx_load_opts.file_format` or use `ufbx_load_opts.filename`
// when using `ufbx_load_memory()` to let ufbx guess the format from the extension.
UFBX_ERROR_UNRECOGNIZED_FILE_FORMAT,
// Options struct (eg. `ufbx_load_opts`) is not cleared to zero.
// Make sure you initialize the structure to zero via eg.
// ufbx_load_opts opts = { 0 }; // C
// ufbx_load_opts opts = { }; // C++
UFBX_ERROR_UNINITIALIZED_OPTIONS,
// The vertex streams in `ufbx_generate_indices()` are empty.
UFBX_ERROR_ZERO_VERTEX_SIZE,
// Vertex stream passed to `ufbx_generate_indices()`.
UFBX_ERROR_TRUNCATED_VERTEX_STREAM,
// Invalid UTF-8 encountered in a file when loading with `UFBX_UNICODE_ERROR_HANDLING_ABORT_LOADING`.
UFBX_ERROR_INVALID_UTF8,
// Feature needed for the operation has been compiled out.
UFBX_ERROR_FEATURE_DISABLED,
// Attempting to tessellate an invalid NURBS object.
// See `ufbx_nurbs_basis.valid`.
UFBX_ERROR_BAD_NURBS,
// Out of bounds index in the file when loading with `UFBX_INDEX_ERROR_HANDLING_ABORT_LOADING`.
UFBX_ERROR_BAD_INDEX,
// Node is deeper than `ufbx_load_opts.node_depth_limit` in the hierarchy.
UFBX_ERROR_NODE_DEPTH_LIMIT,
// Error parsing ASCII array in a thread.
// Threaded ASCII parsing is slightly more strict than non-threaded, for cursed files,
// set `ufbx_load_opts.force_single_thread_ascii_parsing` to `true`.
UFBX_ERROR_THREADED_ASCII_PARSE,
// Unsafe options specified without enabling `ufbx_load_opts.allow_unsafe`.
UFBX_ERROR_UNSAFE_OPTIONS,
// Duplicated override property in `ufbx_create_anim()`
UFBX_ERROR_DUPLICATE_OVERRIDE,
UFBX_ENUM_FORCE_WIDTH(UFBX_ERROR_TYPE)
} ufbx_error_type;
UFBX_ENUM_TYPE(ufbx_error_type, UFBX_ERROR_TYPE, UFBX_ERROR_DUPLICATE_OVERRIDE);
// Error description with detailed stack trace
// HINT: You can use `ufbx_format_error()` for formatting the error
typedef struct ufbx_error {
ufbx_error_type type;
ufbx_string description;
uint32_t stack_size;
ufbx_error_frame stack[UFBX_ERROR_STACK_MAX_DEPTH];
size_t info_length;
char info[UFBX_ERROR_INFO_LENGTH];
} ufbx_error;
// -- Progress callbacks
typedef struct ufbx_progress {
uint64_t bytes_read;
uint64_t bytes_total;
} ufbx_progress;
typedef enum ufbx_progress_result UFBX_ENUM_REPR {
UFBX_PROGRESS_CONTINUE = 0x100,
UFBX_PROGRESS_CANCEL = 0x200,
UFBX_ENUM_FORCE_WIDTH(UFBX_PROGRESS_RESULT)
} ufbx_progress_result;
// Called periodically with the current progress
// Return `false` to cancel further processing
typedef ufbx_progress_result ufbx_progress_fn(void *user, const ufbx_progress *progress);
typedef struct ufbx_progress_cb {
ufbx_progress_fn *fn;
void *user;
UFBX_CALLBACK_IMPL(ufbx_progress_cb, ufbx_progress_fn, ufbx_progress_result,
(void *user, const ufbx_progress *progress),
(progress))
} ufbx_progress_cb;
// -- Inflate
typedef struct ufbx_inflate_input ufbx_inflate_input;
typedef struct ufbx_inflate_retain ufbx_inflate_retain;
// Source data/stream to decompress with `ufbx_inflate()`
struct ufbx_inflate_input {
// Total size of the data in bytes
size_t total_size;
// (optional) Initial or complete data chunk
const void *data;
size_t data_size;
// (optional) Temporary buffer, defaults to 256b stack buffer
void *buffer;
size_t buffer_size;
// (optional) Streaming read function, concatenated after `data`
ufbx_read_fn *read_fn;
void *read_user;
// (optional) Progress reporting
ufbx_progress_cb progress_cb;
uint64_t progress_interval_hint; // < Bytes between progress report calls
// (optional) Change the progress scope
uint64_t progress_size_before;
uint64_t progress_size_after;
// (optional) No the DEFLATE header
bool no_header;
// (optional) No the Adler32 checksum
bool no_checksum;
// (optional) Force internal fast lookup bit amount
size_t internal_fast_bits;
};
// Persistent data between `ufbx_inflate()` calls
// NOTE: You must set `initialized` to `false`, but `data` may be uninitialized
struct ufbx_inflate_retain {
bool initialized;
uint64_t data[1024];
};
typedef enum ufbx_index_error_handling UFBX_ENUM_REPR {
// Clamp to a valid value.
UFBX_INDEX_ERROR_HANDLING_CLAMP,
// Set bad indices to `UFBX_NO_INDEX`.
// This is the recommended way if you need to deal with files with gaps in information.
// HINT: If you use this `ufbx_get_vertex_TYPE()` functions will return zero
// on invalid indices instead of failing.
UFBX_INDEX_ERROR_HANDLING_NO_INDEX,
// Fail loading entierely when encountering a bad index.
UFBX_INDEX_ERROR_HANDLING_ABORT_LOADING,
// Pass bad indices through as-is.
// Requires `ufbx_load_opts.allow_unsafe`.
// UNSAFE: Breaks any API guarantees regarding indexes being in bounds and makes
// `ufbx_get_vertex_TYPE()` memory-unsafe to use.
UFBX_INDEX_ERROR_HANDLING_UNSAFE_IGNORE,
UFBX_ENUM_FORCE_WIDTH(UFBX_INDEX_ERROR_HANDLING)
} ufbx_index_error_handling;
UFBX_ENUM_TYPE(ufbx_index_error_handling, UFBX_INDEX_ERROR_HANDLING, UFBX_INDEX_ERROR_HANDLING_UNSAFE_IGNORE);
typedef enum ufbx_unicode_error_handling UFBX_ENUM_REPR {
// Replace errors with U+FFFD "Replacement Character"
UFBX_UNICODE_ERROR_HANDLING_REPLACEMENT_CHARACTER,
// Replace errors with '_' U+5F "Low Line"
UFBX_UNICODE_ERROR_HANDLING_UNDERSCORE,
// Replace errors with '?' U+3F "Question Mark"
UFBX_UNICODE_ERROR_HANDLING_QUESTION_MARK,
// Remove errors from the output
UFBX_UNICODE_ERROR_HANDLING_REMOVE,
// Fail loading on encountering an Unicode error
UFBX_UNICODE_ERROR_HANDLING_ABORT_LOADING,
// Ignore and pass-through non-UTF-8 string data.
// Requires `ufbx_load_opts.allow_unsafe`.
// UNSAFE: Breaks API guarantee that `ufbx_string` is UTF-8 encoded.
UFBX_UNICODE_ERROR_HANDLING_UNSAFE_IGNORE,
UFBX_ENUM_FORCE_WIDTH(UFBX_UNICODE_ERROR_HANDLING)
} ufbx_unicode_error_handling;
UFBX_ENUM_TYPE(ufbx_unicode_error_handling, UFBX_UNICODE_ERROR_HANDLING, UFBX_UNICODE_ERROR_HANDLING_UNSAFE_IGNORE);
// How to handle FBX node geometry transforms.
// FBX nodes can have "geometry transforms" that affect only the attached meshes,
// but not the children. This is not allowed in many scene representations so
// ufbx provides some ways to simplify them.
// Geometry transforms can also be used to transform any other attributes such
// as lights or cameras.
typedef enum ufbx_geometry_transform_handling UFBX_ENUM_REPR {
// Preserve the geometry transforms as-is.
// To be correct for all files you have to use `ufbx_node.geometry_transform`,
// `ufbx_node.geometry_to_node`, or `ufbx_node.geometry_to_world` to compensate
// for any potential geometry transforms.
UFBX_GEOMETRY_TRANSFORM_HANDLING_PRESERVE,
// Add helper nodes between the nodes and geometry where needed.
// The created nodes have `ufbx_node.is_geometry_transform_helper` set and are
// named `ufbx_load_opts.geometry_transform_helper_name`.
UFBX_GEOMETRY_TRANSFORM_HANDLING_HELPER_NODES,
// Modify the geometry of meshes attached to nodes with geometry transforms.
// Will add helper nodes like `UFBX_GEOMETRY_TRANSFORM_HANDLING_HELPER_NODES` if
// necessary, for example if there are multiple instances of the same mesh with
// geometry transforms.
UFBX_GEOMETRY_TRANSFORM_HANDLING_MODIFY_GEOMETRY,
// Modify the geometry of meshes attached to nodes with geometry transforms.
// NOTE: This will not work correctly for instanced geometry.
UFBX_GEOMETRY_TRANSFORM_HANDLING_MODIFY_GEOMETRY_NO_FALLBACK,
UFBX_ENUM_FORCE_WIDTH(UFBX_GEOMETRY_TRANSFORM_HANDLING)
} ufbx_geometry_transform_handling;
UFBX_ENUM_TYPE(ufbx_geometry_transform_handling, UFBX_GEOMETRY_TRANSFORM_HANDLING, UFBX_GEOMETRY_TRANSFORM_HANDLING_MODIFY_GEOMETRY_NO_FALLBACK);
// How to handle FBX transform inherit modes.
typedef enum ufbx_inherit_mode_handling UFBX_ENUM_REPR {
// Preserve inherit mode in `ufbx_node.inherit_mode`.
// NOTE: To correctly handle all scenes you would need to handle the
// non-standard inherit modes.
UFBX_INHERIT_MODE_HANDLING_PRESERVE,
// Create scale helper nodes parented to nodes that need special inheritance.
// Scale helper nodes will have `ufbx_node.is_scale_helper` and parents of
// scale helpers will have `ufbx_node.scale_helper` pointing to it.
UFBX_INHERIT_MODE_HANDLING_HELPER_NODES,
// Attempt to compensate for bone scale by inversely scaling children.
// NOTE: This only works for uniform non-animated scaling, if scale is
// non-uniform or animated, ufbx will add scale helpers in the same way
// as `UFBX_INHERIT_MODE_HANDLING_HELPER_NODES`.
UFBX_INHERIT_MODE_HANDLING_COMPENSATE,
// Attempt to compensate for bone scale by inversely scaling children.
// Will never create helper nodes.
UFBX_INHERIT_MODE_HANDLING_COMPENSATE_NO_FALLBACK,
// Ignore non-standard inheritance modes.
// Forces all nodes to have `UFBX_INHERIT_MODE_NORMAL` regardless of the
// inherit mode specified in the file. This can be useful for emulating
// results from importers/programs that don't support inherit modes.
UFBX_INHERIT_MODE_HANDLING_IGNORE,
UFBX_ENUM_FORCE_WIDTH(UFBX_INHERIT_MODE_HANDLING)
} ufbx_inherit_mode_handling;
UFBX_ENUM_TYPE(ufbx_inherit_mode_handling, UFBX_INHERIT_MODE_HANDLING, UFBX_INHERIT_MODE_HANDLING_IGNORE);
// How to handle FBX transform pivots.
typedef enum ufbx_pivot_handling UFBX_ENUM_REPR {
// Take pivots into account when computing the transform.
UFBX_PIVOT_HANDLING_RETAIN,
// Translate objects to be located at their pivot.
// NOTE: Only applied if rotation and scaling pivots are equal.
// NOTE: Results in geometric translation. Use `ufbx_geometry_transform_handling`
// to interpret these in a standard scene graph.
UFBX_PIVOT_HANDLING_ADJUST_TO_PIVOT,
UFBX_ENUM_FORCE_WIDTH(UFBX_PIVOT_HANDLING)
} ufbx_pivot_handling;
UFBX_ENUM_TYPE(ufbx_pivot_handling, UFBX_PIVOT_HANDLING, UFBX_PIVOT_HANDLING_ADJUST_TO_PIVOT);
typedef enum ufbx_baked_key_flags UFBX_FLAG_REPR {
// This keyframe represents a constant step from the left side
UFBX_BAKED_KEY_STEP_LEFT = 0x1,
// This keyframe represents a constant step from the right side
UFBX_BAKED_KEY_STEP_RIGHT = 0x2,
// This keyframe is the main part of a step
// Bordering either `UFBX_BAKED_KEY_STEP_LEFT` or `UFBX_BAKED_KEY_STEP_RIGHT`.
UFBX_BAKED_KEY_STEP_KEY = 0x4,
// This keyframe is a real keyframe in the source animation
UFBX_BAKED_KEY_KEYFRAME = 0x8,
// This keyframe has been reduced by maximum sample rate.
// See `ufbx_bake_opts.maximum_sample_rate`.
UFBX_BAKED_KEY_REDUCED = 0x10,
UFBX_FLAG_FORCE_WIDTH(UFBX_BAKED_KEY)
} ufbx_baked_key_flags;
typedef struct ufbx_baked_vec3 {
double time; // < Time of the keyframe, in seconds
ufbx_vec3 value; // < Value at `time`, can be linearly interpolated
ufbx_baked_key_flags flags; // < Additional information about the keyframe
} ufbx_baked_vec3;
UFBX_LIST_TYPE(ufbx_baked_vec3_list, ufbx_baked_vec3);
typedef struct ufbx_baked_quat {
double time; // < Time of the keyframe, in seconds
ufbx_quat value; // < Value at `time`, can be (spherically) linearly interpolated
ufbx_baked_key_flags flags; // < Additional information about the keyframe
} ufbx_baked_quat;
UFBX_LIST_TYPE(ufbx_baked_quat_list, ufbx_baked_quat);
// Baked transform animation for a single node.
typedef struct ufbx_baked_node {
// Typed ID of the node, maps to `ufbx_scene.nodes[]`.
uint32_t typed_id;
// Element ID of the element, maps to `ufbx_scene.elements[]`.
uint32_t element_id;
// The translation channel has constant values for the whole animation.
bool constant_translation;
// The rotation channel has constant values for the whole animation.
bool constant_rotation;
// The scale channel has constant values for the whole animation.
bool constant_scale;
// Translation keys for the animation, maps to `ufbx_node.local_transform.translation`.
ufbx_baked_vec3_list translation_keys;
// Rotation keyframes, maps to `ufbx_node.local_transform.rotation`.
ufbx_baked_quat_list rotation_keys;
// Scale keyframes, maps to `ufbx_node.local_transform.scale`.
ufbx_baked_vec3_list scale_keys;
} ufbx_baked_node;
UFBX_LIST_TYPE(ufbx_baked_node_list, ufbx_baked_node);
// Baked property animation.
typedef struct ufbx_baked_prop {
// Name of the property, eg. `"Visibility"`.
ufbx_string name;
// The value of the property is constant for the whole animation.
bool constant_value;
// Property value keys.
ufbx_baked_vec3_list keys;
} ufbx_baked_prop;
UFBX_LIST_TYPE(ufbx_baked_prop_list, ufbx_baked_prop);
// Baked property animation for a single element.
typedef struct ufbx_baked_element {
// Element ID of the element, maps to `ufbx_scene.elements[]`.
uint32_t element_id;
// List of properties the animation modifies.
ufbx_baked_prop_list props;
} ufbx_baked_element;
UFBX_LIST_TYPE(ufbx_baked_element_list, ufbx_baked_element);
typedef struct ufbx_baked_anim_metadata {
// Memory statistics
size_t result_memory_used;
size_t temp_memory_used;
size_t result_allocs;
size_t temp_allocs;
} ufbx_baked_anim_metadata;
// Animation baked into linearly interpolated keyframes.
// See `ufbx_bake_anim()`.
typedef struct ufbx_baked_anim {
// Nodes that are modified by the animation.
// Some nodes may be missing if the specified animation does not transform them.
// Conversely, some non-obviously animated nodes may be included as exporters
// often may add dummy keyframes for objects.
ufbx_baked_node_list nodes;
// Element properties modified by the animation.
ufbx_baked_element_list elements;
// Playback time range for the animation.
double playback_time_begin;
double playback_time_end;
double playback_duration;
// Keyframe time range.
double key_time_min;
double key_time_max;
// Additional bake information.
ufbx_baked_anim_metadata metadata;
} ufbx_baked_anim;
// -- Thread API
//
// NOTE: This API is still experimental and may change.
// Documentation is currently missing on purpose.
typedef uintptr_t ufbx_thread_pool_context;
typedef struct ufbx_thread_pool_info {
uint32_t max_concurrent_tasks;
} ufbx_thread_pool_info;
typedef bool ufbx_thread_pool_init_fn(void *user, ufbx_thread_pool_context ctx, const ufbx_thread_pool_info *info);
typedef bool ufbx_thread_pool_run_fn(void *user, ufbx_thread_pool_context ctx, uint32_t group, uint32_t start_index, uint32_t count);
typedef bool ufbx_thread_pool_wait_fn(void *user, ufbx_thread_pool_context ctx, uint32_t group, uint32_t max_index);
typedef void ufbx_thread_pool_free_fn(void *user, ufbx_thread_pool_context ctx);
typedef struct ufbx_thread_pool {
ufbx_thread_pool_init_fn *init_fn;
ufbx_thread_pool_run_fn *run_fn;
ufbx_thread_pool_wait_fn *wait_fn;
ufbx_thread_pool_free_fn *free_fn;
void *user;
} ufbx_thread_pool;
typedef struct ufbx_thread_opts {
ufbx_thread_pool pool;
size_t num_tasks;
size_t memory_limit;
} ufbx_thread_opts;
// -- Main API
// Options for `ufbx_load_file/memory/stream/stdio()`
// NOTE: Initialize to zero with `{ 0 }` (C) or `{ }` (C++)
typedef struct ufbx_load_opts {
uint32_t _begin_zero;
ufbx_allocator_opts temp_allocator; // < Allocator used during loading
ufbx_allocator_opts result_allocator; // < Allocator used for the final scene
ufbx_thread_opts thread_opts; // < Threading options
// Preferences
bool ignore_geometry; // < Do not load geometry datsa (vertices, indices, etc)
bool ignore_animation; // < Do not load animation curves
bool ignore_embedded; // < Do not load embedded content
bool ignore_all_content; // < Do not load any content (geometry, animation, embedded)
bool evaluate_skinning; // < Evaluate skinning (see ufbx_mesh.skinned_vertices)
bool evaluate_caches; // < Evaluate vertex caches (see ufbx_mesh.skinned_vertices)
// Try to open external files referenced by the main file automatically.
// Applies to geometry caches and .mtl files for OBJ.
// NOTE: This may be risky for untrusted data as the input files may contain
// references to arbitrary paths in the filesystem.
// NOTE: This only applies to files *implicitly* referenced by the scene, if
// you request additional files via eg. `ufbx_load_opts.obj_mtl_path` they
// are still loaded.
// NOTE: Will fail loading if any external files are not found by default, use
// `ufbx_load_opts.ignore_missing_external_files` to suppress this, in this case
// you can find the errors at `ufbx_metadata.warnings[]` as `UFBX_WARNING_MISSING_EXTERNAL_FILE`.
bool load_external_files;
// Don't fail loading if external files are not found.
bool ignore_missing_external_files;
// Don't compute `ufbx_skin_deformer` `vertices` and `weights` arrays saving
// a bit of memory and time if not needed
bool skip_skin_vertices;
// Skip computing `ufbx_mesh.material_parts[]` and `ufbx_mesh.face_group_parts[]`.
bool skip_mesh_parts;
// Clean-up skin weights by removing negative, zero and NAN weights.
bool clean_skin_weights;
// Read Blender materials as PBR values.
// Blender converts PBR materials to legacy FBX Phong materials in a deterministic way.
// If this setting is enabled, such materials will be read as `UFBX_SHADER_BLENDER_PHONG`,
// which means ufbx will be able to parse roughness and metallic textures.
bool use_blender_pbr_material;
// Don't adjust reading the FBX file depending on the detected exporter
bool disable_quirks;
// Don't allow partially broken FBX files to load
bool strict;
// Force ASCII parsing to use a single thread.
// The multi-threaded ASCII parsing is slightly more lenient as it ignores
// the self-reported size of ASCII arrays, that threaded parsing depends on.
bool force_single_thread_ascii_parsing;
// UNSAFE: If enabled allows using unsafe options that may fundamentally
// break the API guarantees.
ufbx_unsafe bool allow_unsafe;
// Specify how to handle broken indices.
ufbx_index_error_handling index_error_handling;
// Connect related elements even if they are broken. If `false` (default)
// `ufbx_skin_cluster` with a missing `bone` field are _not_ included in
// the `ufbx_skin_deformer.clusters[]` array for example.
bool connect_broken_elements;
// Allow nodes that are not connected in any way to the root. Conversely if
// disabled, all lone nodes will be parented under `ufbx_scene.root_node`.
bool allow_nodes_out_of_root;
// Allow meshes with no vertex position attribute.
// NOTE: If this is set `ufbx_mesh.vertex_position.exists` may be `false`.
bool allow_missing_vertex_position;
// Allow faces with zero indices.
bool allow_empty_faces;
// Generate vertex normals for a meshes that are missing normals.
// You can see if the normals have been generated from `ufbx_mesh.generated_normals`.
bool generate_missing_normals;
// Ignore `open_file_cb` when loading the main file.
bool open_main_file_with_default;
// Path separator character, defaults to '\' on Windows and '/' otherwise.
char path_separator;
// Maximum depth of the node hirerachy.
// Will fail with `UFBX_ERROR_NODE_DEPTH_LIMIT` if a node is deeper than this limit.
// NOTE: The default of 0 allows arbitrarily deep hierarchies. Be careful if using
// recursive algorithms without setting this limit.
uint32_t node_depth_limit;
// Estimated file size for progress reporting
uint64_t file_size_estimate;
// Buffer size in bytes to use for reading from files or IO callbacks
size_t read_buffer_size;
// Filename to use as a base for relative file paths if not specified using
// `ufbx_load_file()`. Use `length = SIZE_MAX` for NULL-terminated strings.
// `raw_filename` will be derived from this if empty.
ufbx_string filename;
// Raw non-UTF8 filename. Does not support NULL termination.
// `filename` will be derived from this if empty.
ufbx_blob raw_filename;
// Progress reporting
ufbx_progress_cb progress_cb;
uint64_t progress_interval_hint; // < Bytes between progress report calls
// External file callbacks (defaults to stdio.h)
ufbx_open_file_cb open_file_cb;
// How to handle geometry transforms in the nodes.
// See `ufbx_geometry_transform_handling` for an explanation.
ufbx_geometry_transform_handling geometry_transform_handling;
// How to handle unconventional transform inherit modes.
// See `ufbx_inherit_mode_handling` for an explanation.
ufbx_inherit_mode_handling inherit_mode_handling;
// How to handle pivots.
// See `ufbx_pivot_handling` for an explanation.
ufbx_pivot_handling pivot_handling;
// How to perform space conversion by `target_axes` and `target_unit_meters`.
// See `ufbx_space_conversion` for an explanation.
ufbx_space_conversion space_conversion;
// Axis used to mirror for conversion between left-handed and right-handed coordinates.
ufbx_mirror_axis handedness_conversion_axis;
// Do not change winding of faces when converting handedness.
bool handedness_conversion_retain_winding;
// Reverse winding of all faces.
// If `handedness_conversion_retain_winding` is not specified, mirrored meshes
// will retain their original winding.
bool reverse_winding;
// Apply an implicit root transformation to match axes.
// Used if `ufbx_coordinate_axes_valid(target_axes)`.
ufbx_coordinate_axes target_axes;
// Scale the scene so that one world-space unit is `target_unit_meters` meters.
// By default units are not scaled.
ufbx_real target_unit_meters;
// Target space for camera.
// By default FBX cameras point towards the positive X axis.
// Used if `ufbx_coordinate_axes_valid(target_camera_axes)`.
ufbx_coordinate_axes target_camera_axes;
// Target space for directed lights.
// By default FBX lights point towards the negative Y axis.
// Used if `ufbx_coordinate_axes_valid(target_light_axes)`.
ufbx_coordinate_axes target_light_axes;
// Name for dummy geometry transform helper nodes.
// See `UFBX_GEOMETRY_TRANSFORM_HANDLING_HELPER_NODES`.
ufbx_string geometry_transform_helper_name;
// Name for dummy scale helper nodes.
// See `UFBX_INHERIT_MODE_HANDLING_HELPER_NODES`.
ufbx_string scale_helper_name;
// Normalize vertex normals.
bool normalize_normals;
// Normalize tangents and bitangents.
bool normalize_tangents;
// Override for the root transform
bool use_root_transform;
ufbx_transform root_transform;
// Animation keyframe clamp threhsold, only applies to specific interpolation modes.
double key_clamp_threshold;
// Specify how to handle Unicode errors in strings.
ufbx_unicode_error_handling unicode_error_handling;
// Retain the 'W' component of mesh normal/tangent/bitangent.
// See `ufbx_vertex_attrib.values_w`.
bool retain_vertex_attrib_w;
// Retain the raw document structure using `ufbx_dom_node`.
bool retain_dom;
// Force a specific file format instead of detecting it.
ufbx_file_format file_format;
// How far to read into the file to determine the file format.
// Default: 16kB
size_t file_format_lookahead;
// Do not attempt to detect file format from file content.
bool no_format_from_content;
// Do not attempt to detect file format from filename extension.
// ufbx primarily detects file format from the file header,
// this is just used as a fallback.
bool no_format_from_extension;
// (.obj) Try to find .mtl file with matching filename as the .obj file.
// Used if the file specified `mtllib` line is not found, eg. for a file called
// `model.obj` that contains the line `usemtl materials.mtl`, ufbx would first
// try to open `materials.mtl` and if that fails it tries to open `model.mtl`.
bool obj_search_mtl_by_filename;
// (.obj) Don't split geometry into meshes by object.
bool obj_merge_objects;
// (.obj) Don't split geometry into meshes by groups.
bool obj_merge_groups;
// (.obj) Force splitting groups even on object boundaries.
bool obj_split_groups;
// (.obj) Path to the .mtl file.
// Use `length = SIZE_MAX` for NULL-terminated strings.
// NOTE: This is used _instead_ of the one in the file even if not found
// and sidesteps `load_external_files` as it's _explicitly_ requested.
ufbx_string obj_mtl_path;
// (.obj) Data for the .mtl file.
ufbx_blob obj_mtl_data;
// The world unit in meters that .obj files are assumed to be in.
// .obj files do not define the working units. By default the unit scale
// is read as zero, and no unit conversion is performed.
ufbx_real obj_unit_meters;
// Coordinate space .obj files are assumed to be in.
// .obj files do not define the coordinate space they use. By default no
// coordinate space is assumed and no conversion is performed.
ufbx_coordinate_axes obj_axes;
uint32_t _end_zero;
} ufbx_load_opts;
// Options for `ufbx_evaluate_scene()`
// NOTE: Initialize to zero with `{ 0 }` (C) or `{ }` (C++)
typedef struct ufbx_evaluate_opts {
uint32_t _begin_zero;
ufbx_allocator_opts temp_allocator; // < Allocator used during evaluation
ufbx_allocator_opts result_allocator; // < Allocator used for the final scene
bool evaluate_skinning; // < Evaluate skinning (see ufbx_mesh.skinned_vertices)
bool evaluate_caches; // < Evaluate vertex caches (see ufbx_mesh.skinned_vertices)
// WARNING: Potentially unsafe! Try to open external files such as geometry caches
bool load_external_files;
// External file callbacks (defaults to stdio.h)
ufbx_open_file_cb open_file_cb;
uint32_t _end_zero;
} ufbx_evaluate_opts;
UFBX_LIST_TYPE(ufbx_const_uint32_list, const uint32_t);
UFBX_LIST_TYPE(ufbx_const_real_list, const ufbx_real);
typedef struct ufbx_prop_override_desc {
// Element (`ufbx_element.element_id`) to override the property from
uint32_t element_id;
// Property name to override.
ufbx_string prop_name;
// Override value, use `value.x` for scalars. `value_int` is initialized
// from `value.x` if zero so keep `value` zeroed even if you don't need it!
ufbx_vec4 value;
ufbx_string value_str;
int64_t value_int;
} ufbx_prop_override_desc;
UFBX_LIST_TYPE(ufbx_const_prop_override_desc_list, const ufbx_prop_override_desc);
UFBX_LIST_TYPE(ufbx_const_transform_override_list, const ufbx_transform_override);
typedef struct ufbx_anim_opts {
uint32_t _begin_zero;
// Animation layers indices.
// Corresponding to `ufbx_scene.anim_layers[]`, aka `ufbx_anim_layer.typed_id`.
ufbx_const_uint32_list layer_ids;
// Override layer weights, parallel to `ufbx_anim_opts.layer_ids[]`.
ufbx_const_real_list override_layer_weights;
// Property overrides.
// These allow you to override FBX properties, such as 'UFBX_Lcl_Rotation`.
ufbx_const_prop_override_desc_list prop_overrides;
// Transform overrides.
// These allow you to override individual nodes' `ufbx_node.local_transform`.
ufbx_const_transform_override_list transform_overrides;
// Ignore connected properties
bool ignore_connections;
ufbx_allocator_opts result_allocator; // < Allocator used to create the `ufbx_anim`
uint32_t _end_zero;
} ufbx_anim_opts;
// Specifies how to handle stepped tangents.
typedef enum ufbx_bake_step_handling UFBX_ENUM_REPR {
// One millisecond default step duration, with potential extra slack for converting to `float`.
UFBX_BAKE_STEP_HANDLING_DEFAULT,
// Use a custom interpolation duration for the constant step.
// See `ufbx_bake_opts.step_custom_duration` and optionally `ufbx_bake_opts.step_custom_epsilon`.
UFBX_BAKE_STEP_HANDLING_CUSTOM_DURATION,
// Stepped keyframes are represented as keyframes at the exact same time.
// Use flags `UFBX_BAKED_KEY_STEP_LEFT` and `UFBX_BAKED_KEY_STEP_RIGHT` to differentiate
// between the primary key and edge limits.
UFBX_BAKE_STEP_HANDLING_IDENTICAL_TIME,
// Represent stepped keyframe times as the previous/next representable `double` value.
// Using this and robust linear interpolation will handle stepped tangents correctly
// without having to look at the key flags.
// NOTE: Casting these values to `float` or otherwise modifying them can collapse
// the keyframes to have the identical time.
UFBX_BAKE_STEP_HANDLING_ADJACENT_DOUBLE,
// Treat all stepped tangents as linearly interpolated.
UFBX_BAKE_STEP_HANDLING_IGNORE,
UFBX_ENUM_FORCE_WIDTH(ufbx_bake_step_handling)
} ufbx_bake_step_handling;
UFBX_ENUM_TYPE(ufbx_bake_step_handling, UFBX_BAKE_STEP_HANDLING, UFBX_BAKE_STEP_HANDLING_IGNORE);
typedef struct ufbx_bake_opts {
uint32_t _begin_zero;
ufbx_allocator_opts temp_allocator; // < Allocator used during loading
ufbx_allocator_opts result_allocator; // < Allocator used for the final baked animation
// Move the keyframe times to start from zero regardless of the animation start time.
// For example, for an animation spanning between frames [30, 60] will be moved to
// [0, 30] in the baked animation.
// NOTE: This is in general not equivalent to subtracting `ufbx_anim.time_begin`
// from each keyframe, as this trimming is done exactly using internal FBX ticks.
bool trim_start_time;
// Samples per second to use for resampling non-linear animation.
// Default: 30
double resample_rate;
// Minimum sample rate to not resample.
// Many exporters resample animation by default. To avoid double-resampling
// keyframe rates higher or equal to this will not be resampled.
// Default: 19.5
double minimum_sample_rate;
// Maximum sample rate to use, this will remove keys if they are too close together.
// Default: unlimited
double maximum_sample_rate;
// Bake the raw versions of properties related to transforms.
bool bake_transform_props;
// Do not bake node transforms.
bool skip_node_transforms;
// Do not resample linear rotation keyframes.
// FBX interpolates rotation in Euler angles, so this might cause incorrect interpolation.
bool no_resample_rotation;
// Ignore layer weight animation.
bool ignore_layer_weight_animation;
// Maximum number of segments to generate from one keyframe.
// Default: 32
size_t max_keyframe_segments;
// How to handle stepped tangents.
ufbx_bake_step_handling step_handling;
// Interpolation duration used by `UFBX_BAKE_STEP_HANDLING_CUSTOM_DURATION`.
double step_custom_duration;
// Interpolation epsilon used by `UFBX_BAKE_STEP_HANDLING_CUSTOM_DURATION`.
// Defined as the minimum fractional decrease/increase in key time, ie.
// `time / (1.0 + step_custom_epsilon)` and `time * (1.0 + step_custom_epsilon)`.
double step_custom_epsilon;
// Enable key reduction.
bool key_reduction_enabled;
// Enable key reduction for non-constant rotations.
// Assumes rotations will be interpolated using a spherical linear interpolation at runtime.
bool key_reduction_rotation;
// Threshold for reducing keys for linear segments.
// Default `0.000001`, use negative to disable.
double key_reduction_threshold;
// Maximum passes over the keys to reduce.
// Every pass can potentially halve the the amount of keys.
// Default: `4`
size_t key_reduction_passes;
uint32_t _end_zero;
} ufbx_bake_opts;
// Options for `ufbx_tessellate_nurbs_curve()`
// NOTE: Initialize to zero with `{ 0 }` (C) or `{ }` (C++)
typedef struct ufbx_tessellate_curve_opts {
uint32_t _begin_zero;
ufbx_allocator_opts temp_allocator; // < Allocator used during tessellation
ufbx_allocator_opts result_allocator; // < Allocator used for the final line curve
// How many segments tessellate each span in `ufbx_nurbs_basis.spans`.
size_t span_subdivision;
uint32_t _end_zero;
} ufbx_tessellate_curve_opts;
// Options for `ufbx_tessellate_nurbs_surface()`
// NOTE: Initialize to zero with `{ 0 }` (C) or `{ }` (C++)
typedef struct ufbx_tessellate_surface_opts {
uint32_t _begin_zero;
ufbx_allocator_opts temp_allocator; // < Allocator used during tessellation
ufbx_allocator_opts result_allocator; // < Allocator used for the final mesh
// How many segments tessellate each span in `ufbx_nurbs_basis.spans`.
// NOTE: Default is `4`, _not_ `ufbx_nurbs_surface.span_subdivision_u/v` as that
// would make it easy to create an FBX file with an absurdly high subdivision
// rate (similar to mesh subdivision). Please enforce copy the value yourself
// enforcing whatever limits you deem reasonable.
size_t span_subdivision_u;
size_t span_subdivision_v;
// Skip computing `ufbx_mesh.material_parts[]`
bool skip_mesh_parts;
uint32_t _end_zero;
} ufbx_tessellate_surface_opts;
// Options for `ufbx_subdivide_mesh()`
// NOTE: Initialize to zero with `{ 0 }` (C) or `{ }` (C++)
typedef struct ufbx_subdivide_opts {
uint32_t _begin_zero;
ufbx_allocator_opts temp_allocator; // < Allocator used during subdivision
ufbx_allocator_opts result_allocator; // < Allocator used for the final mesh
ufbx_subdivision_boundary boundary;
ufbx_subdivision_boundary uv_boundary;
// Do not generate normals
bool ignore_normals;
// Interpolate existing normals using the subdivision rules
// instead of generating new normals
bool interpolate_normals;
// Subdivide also tangent attributes
bool interpolate_tangents;
// Map subdivided vertices into weighted original vertices.
// NOTE: May be O(n^2) if `max_source_vertices` is not specified!
bool evaluate_source_vertices;
// Limit source vertices per subdivided vertex.
size_t max_source_vertices;
// Calculate bone influences over subdivided vertices (if applicable).
// NOTE: May be O(n^2) if `max_skin_weights` is not specified!
bool evaluate_skin_weights;
// Limit bone influences per subdivided vertex.
size_t max_skin_weights;
// Index of the skin deformer to use for `evaluate_skin_weights`.
size_t skin_deformer_index;
uint32_t _end_zero;
} ufbx_subdivide_opts;
// Options for `ufbx_load_geometry_cache()`
// NOTE: Initialize to zero with `{ 0 }` (C) or `{ }` (C++)
typedef struct ufbx_geometry_cache_opts {
uint32_t _begin_zero;
ufbx_allocator_opts temp_allocator; // < Allocator used during loading
ufbx_allocator_opts result_allocator; // < Allocator used for the final scene
// External file callbacks (defaults to stdio.h)
ufbx_open_file_cb open_file_cb;
// FPS value for converting frame times to seconds
double frames_per_second;
// Axis to mirror the geometry by.
ufbx_mirror_axis mirror_axis;
// Enable scaling `scale_factor` all geometry by.
bool use_scale_factor;
// Factor to scale the geometry by.
ufbx_real scale_factor;
uint32_t _end_zero;
} ufbx_geometry_cache_opts;
// Options for `ufbx_read_geometry_cache_TYPE()`
// NOTE: Initialize to zero with `{ 0 }` (C) or `{ }` (C++)
typedef struct ufbx_geometry_cache_data_opts {
uint32_t _begin_zero;
// External file callbacks (defaults to stdio.h)
ufbx_open_file_cb open_file_cb;
bool additive;
bool use_weight;
ufbx_real weight;
// Ignore scene transform.
bool ignore_transform;
uint32_t _end_zero;
} ufbx_geometry_cache_data_opts;
typedef struct ufbx_panic {
bool did_panic;
size_t message_length;
char message[UFBX_PANIC_MESSAGE_LENGTH];
} ufbx_panic;
// -- API
#ifdef __cplusplus
extern "C" {
#endif
// Various zero/empty/identity values
ufbx_abi_data const ufbx_string ufbx_empty_string;
ufbx_abi_data const ufbx_blob ufbx_empty_blob;
ufbx_abi_data const ufbx_matrix ufbx_identity_matrix;
ufbx_abi_data const ufbx_transform ufbx_identity_transform;
ufbx_abi_data const ufbx_vec2 ufbx_zero_vec2;
ufbx_abi_data const ufbx_vec3 ufbx_zero_vec3;
ufbx_abi_data const ufbx_vec4 ufbx_zero_vec4;
ufbx_abi_data const ufbx_quat ufbx_identity_quat;
// Commonly used coordinate axes.
ufbx_abi_data const ufbx_coordinate_axes ufbx_axes_right_handed_y_up;
ufbx_abi_data const ufbx_coordinate_axes ufbx_axes_right_handed_z_up;
ufbx_abi_data const ufbx_coordinate_axes ufbx_axes_left_handed_y_up;
ufbx_abi_data const ufbx_coordinate_axes ufbx_axes_left_handed_z_up;
// Sizes of element types. eg `sizeof(ufbx_node)`
ufbx_abi_data const size_t ufbx_element_type_size[UFBX_ELEMENT_TYPE_COUNT];
// Version of the source file, comparable to `UFBX_HEADER_VERSION`
ufbx_abi_data const uint32_t ufbx_source_version;
// Practically always `true` (see below), if not you need to be careful with threads.
//
// Guaranteed to be `true` in _any_ of the following conditions:
// - ufbx.c has been compiled using: GCC / Clang / MSVC / ICC / EMCC / TCC
// - ufbx.c has been compiled as C++11 or later
// - ufbx.c has been compiled as C11 or later with `<stdatomic.h>` support
//
// If `false` you can't call the following functions concurrently:
// ufbx_evaluate_scene()
// ufbx_free_scene()
// ufbx_subdivide_mesh()
// ufbx_tessellate_nurbs_surface()
// ufbx_free_mesh()
ufbx_abi bool ufbx_is_thread_safe(void);
// Load a scene from a `size` byte memory buffer at `data`
ufbx_abi ufbx_scene *ufbx_load_memory(
const void *data, size_t data_size,
const ufbx_load_opts *opts, ufbx_error *error);
// Load a scene by opening a file named `filename`
ufbx_abi ufbx_scene *ufbx_load_file(
const char *filename,
const ufbx_load_opts *opts, ufbx_error *error);
ufbx_abi ufbx_scene *ufbx_load_file_len(
const char *filename, size_t filename_len,
const ufbx_load_opts *opts, ufbx_error *error);
// Load a scene by reading from an `FILE *file` stream
// NOTE: `file` is passed as a `void` pointer to avoid including <stdio.h>
ufbx_abi ufbx_scene *ufbx_load_stdio(
void *file,
const ufbx_load_opts *opts, ufbx_error *error);
// Load a scene by reading from an `FILE *file` stream with a prefix
// NOTE: `file` is passed as a `void` pointer to avoid including <stdio.h>
ufbx_abi ufbx_scene *ufbx_load_stdio_prefix(
void *file,
const void *prefix, size_t prefix_size,
const ufbx_load_opts *opts, ufbx_error *error);
// Load a scene from a user-specified stream
ufbx_abi ufbx_scene *ufbx_load_stream(
const ufbx_stream *stream,
const ufbx_load_opts *opts, ufbx_error *error);
// Load a scene from a user-specified stream with a prefix
ufbx_abi ufbx_scene *ufbx_load_stream_prefix(
const ufbx_stream *stream,
const void *prefix, size_t prefix_size,
const ufbx_load_opts *opts, ufbx_error *error);
// Free a previously loaded or evaluated scene
ufbx_abi void ufbx_free_scene(ufbx_scene *scene);
// Increment `scene` refcount
ufbx_abi void ufbx_retain_scene(ufbx_scene *scene);
// Format a textual description of `error`.
// Always produces a NULL-terminated string to `char dst[dst_size]`, truncating if
// necessary. Returns the number of characters written not including the NULL terminator.
ufbx_abi size_t ufbx_format_error(char *dst, size_t dst_size, const ufbx_error *error);
// Query
// Find a property `name` from `props`, returns `NULL` if not found.
// Searches through `ufbx_props.defaults` as well.
ufbx_abi ufbx_prop *ufbx_find_prop_len(const ufbx_props *props, const char *name, size_t name_len);
ufbx_abi ufbx_prop *ufbx_find_prop(const ufbx_props *props, const char *name);
// Utility functions for finding the value of a property, returns `def` if not found.
// NOTE: For `ufbx_string` you need to ensure the lifetime of the default is
// sufficient as no copy is made.
ufbx_abi ufbx_real ufbx_find_real_len(const ufbx_props *props, const char *name, size_t name_len, ufbx_real def);
ufbx_abi ufbx_real ufbx_find_real(const ufbx_props *props, const char *name, ufbx_real def);
ufbx_abi ufbx_vec3 ufbx_find_vec3_len(const ufbx_props *props, const char *name, size_t name_len, ufbx_vec3 def);
ufbx_abi ufbx_vec3 ufbx_find_vec3(const ufbx_props *props, const char *name, ufbx_vec3 def);
ufbx_abi int64_t ufbx_find_int_len(const ufbx_props *props, const char *name, size_t name_len, int64_t def);
ufbx_abi int64_t ufbx_find_int(const ufbx_props *props, const char *name, int64_t def);
ufbx_abi bool ufbx_find_bool_len(const ufbx_props *props, const char *name, size_t name_len, bool def);
ufbx_abi bool ufbx_find_bool(const ufbx_props *props, const char *name, bool def);
ufbx_abi ufbx_string ufbx_find_string_len(const ufbx_props *props, const char *name, size_t name_len, ufbx_string def);
ufbx_abi ufbx_string ufbx_find_string(const ufbx_props *props, const char *name, ufbx_string def);
ufbx_abi ufbx_blob ufbx_find_blob_len(const ufbx_props *props, const char *name, size_t name_len, ufbx_blob def);
ufbx_abi ufbx_blob ufbx_find_blob(const ufbx_props *props, const char *name, ufbx_blob def);
// Find property in `props` with concatendated `parts[num_parts]`.
ufbx_abi ufbx_prop *ufbx_find_prop_concat(const ufbx_props *props, const ufbx_string *parts, size_t num_parts);
// Get an element connected to a property.
ufbx_abi ufbx_element *ufbx_get_prop_element(const ufbx_element *element, const ufbx_prop *prop, ufbx_element_type type);
// Find an element connected to a property by name.
ufbx_abi ufbx_element *ufbx_find_prop_element_len(const ufbx_element *element, const char *name, size_t name_len, ufbx_element_type type);
ufbx_abi ufbx_element *ufbx_find_prop_element(const ufbx_element *element, const char *name, ufbx_element_type type);
// Find any element of type `type` in `scene` by `name`.
// For example if you want to find `ufbx_material` named `Mat`:
// (ufbx_material*)ufbx_find_element(scene, UFBX_ELEMENT_MATERIAL, "Mat");
ufbx_abi ufbx_element *ufbx_find_element_len(const ufbx_scene *scene, ufbx_element_type type, const char *name, size_t name_len);
ufbx_abi ufbx_element *ufbx_find_element(const ufbx_scene *scene, ufbx_element_type type, const char *name);
// Find node in `scene` by `name` (shorthand for `ufbx_find_element(UFBX_ELEMENT_NODE)`).
ufbx_abi ufbx_node *ufbx_find_node_len(const ufbx_scene *scene, const char *name, size_t name_len);
ufbx_abi ufbx_node *ufbx_find_node(const ufbx_scene *scene, const char *name);
// Find an animation stack in `scene` by `name` (shorthand for `ufbx_find_element(UFBX_ELEMENT_ANIM_STACK)`)
ufbx_abi ufbx_anim_stack *ufbx_find_anim_stack_len(const ufbx_scene *scene, const char *name, size_t name_len);
ufbx_abi ufbx_anim_stack *ufbx_find_anim_stack(const ufbx_scene *scene, const char *name);
// Find a material in `scene` by `name` (shorthand for `ufbx_find_element(UFBX_ELEMENT_MATERIAL)`).
ufbx_abi ufbx_material *ufbx_find_material_len(const ufbx_scene *scene, const char *name, size_t name_len);
ufbx_abi ufbx_material *ufbx_find_material(const ufbx_scene *scene, const char *name);
// Find a single animated property `prop` of `element` in `layer`.
// Returns `NULL` if not found.
ufbx_abi ufbx_anim_prop *ufbx_find_anim_prop_len(const ufbx_anim_layer *layer, const ufbx_element *element, const char *prop, size_t prop_len);
ufbx_abi ufbx_anim_prop *ufbx_find_anim_prop(const ufbx_anim_layer *layer, const ufbx_element *element, const char *prop);
// Find all animated properties of `element` in `layer`.
ufbx_abi ufbx_anim_prop_list ufbx_find_anim_props(const ufbx_anim_layer *layer, const ufbx_element *element);
// Get a matrix that transforms normals in the same way as Autodesk software.
// NOTE: The resulting normals are slightly incorrect as this function deliberately
// inverts geometric transformation wrong. For better results use
// `ufbx_matrix_for_normals(&node->geometry_to_world)`.
ufbx_abi ufbx_matrix ufbx_get_compatible_matrix_for_normals(const ufbx_node *node);
// Utility
// Decompress a DEFLATE compressed buffer.
// Returns the decompressed size or a negative error code (see source for details).
// NOTE: You must supply a valid `retain` with `ufbx_inflate_retain.initialized == false`
// but the rest can be uninitialized.
ufbx_abi ptrdiff_t ufbx_inflate(void *dst, size_t dst_size, const ufbx_inflate_input *input, ufbx_inflate_retain *retain);
// Same as `ufbx_open_file()` but compatible with the callback in `ufbx_open_file_fn`.
// The `user` parameter is actually not used here.
ufbx_abi bool ufbx_default_open_file(void *user, ufbx_stream *stream, const char *path, size_t path_len, const ufbx_open_file_info *info);
// Open a `ufbx_stream` from a file.
// Use `path_len == SIZE_MAX` for NULL terminated string.
ufbx_abi bool ufbx_open_file(ufbx_stream *stream, const char *path, size_t path_len, const ufbx_open_file_opts *opts, ufbx_error *error);
ufbx_unsafe ufbx_abi bool ufbx_open_file_ctx(ufbx_stream *stream, ufbx_open_file_context ctx, const char *path, size_t path_len, const ufbx_open_file_opts *opts, ufbx_error *error);
// NOTE: Uses the default ufbx allocator!
ufbx_abi bool ufbx_open_memory(ufbx_stream *stream, const void *data, size_t data_size, const ufbx_open_memory_opts *opts, ufbx_error *error);
ufbx_unsafe ufbx_abi bool ufbx_open_memory_ctx(ufbx_stream *stream, ufbx_open_file_context ctx, const void *data, size_t data_size, const ufbx_open_memory_opts *opts, ufbx_error *error);
// Animation evaluation
// Evaluate a single animation `curve` at a `time`.
// Returns `default_value` only if `curve == NULL` or it has no keyframes.
ufbx_abi ufbx_real ufbx_evaluate_curve(const ufbx_anim_curve *curve, double time, ufbx_real default_value);
// Evaluate a value from bundled animation curves.
ufbx_abi ufbx_real ufbx_evaluate_anim_value_real(const ufbx_anim_value *anim_value, double time);
ufbx_abi ufbx_vec3 ufbx_evaluate_anim_value_vec3(const ufbx_anim_value *anim_value, double time);
// Evaluate an animated property `name` from `element` at `time`.
// NOTE: If the property is not found it will have the flag `UFBX_PROP_FLAG_NOT_FOUND`.
ufbx_abi ufbx_prop ufbx_evaluate_prop_len(const ufbx_anim *anim, const ufbx_element *element, const char *name, size_t name_len, double time);
ufbx_abi ufbx_prop ufbx_evaluate_prop(const ufbx_anim *anim, const ufbx_element *element, const char *name, double time);
// Evaluate all _animated_ properties of `element`.
// HINT: This function returns an `ufbx_props` structure with the original properties as
// `ufbx_props.defaults`. This lets you use `ufbx_find_prop/value()` for the results.
ufbx_abi ufbx_props ufbx_evaluate_props(const ufbx_anim *anim, const ufbx_element *element, double time, ufbx_prop *buffer, size_t buffer_size);
// Flags to control `ufbx_evaluate_transform_flags()`.
typedef enum ufbx_transform_flags UFBX_FLAG_REPR {
// Ignore parent scale helper.
UFBX_TRANSFORM_FLAG_IGNORE_SCALE_HELPER = 0x1,
// Ignore componentwise scale.
// Note that if you don't specify this, ufbx will have to potentially
// evaluate the entire parent chain in the worst case.
UFBX_TRANSFORM_FLAG_IGNORE_COMPONENTWISE_SCALE = 0x2,
// Require explicit components
UFBX_TRANSFORM_FLAG_EXPLICIT_INCLUDES = 0x4,
// If `UFBX_TRANSFORM_FLAG_EXPLICIT_INCLUDES`: Evaluate `ufbx_transform.translation`.
UFBX_TRANSFORM_FLAG_INCLUDE_TRANSLATION = 0x10,
// If `UFBX_TRANSFORM_FLAG_EXPLICIT_INCLUDES`: Evaluate `ufbx_transform.rotation`.
UFBX_TRANSFORM_FLAG_INCLUDE_ROTATION = 0x20,
// If `UFBX_TRANSFORM_FLAG_EXPLICIT_INCLUDES`: Evaluate `ufbx_transform.scale`.
UFBX_TRANSFORM_FLAG_INCLUDE_SCALE = 0x40,
UFBX_FLAG_FORCE_WIDTH(UFBX_TRANSFORM_FLAGS)
} ufbx_transform_flags;
// Evaluate the animated transform of a node given a time.
// The returned transform is the local transform of the node (ie. relative to the parent),
// comparable to `ufbx_node.local_transform`.
ufbx_abi ufbx_transform ufbx_evaluate_transform(const ufbx_anim *anim, const ufbx_node *node, double time);
ufbx_abi ufbx_transform ufbx_evaluate_transform_flags(const ufbx_anim *anim, const ufbx_node *node, double time, uint32_t flags);
// Evaluate the blend shape weight of a blend channel.
// NOTE: Return value uses `1.0` for full weight, instead of `100.0` that the internal property `UFBX_Weight` uses.
ufbx_abi ufbx_real ufbx_evaluate_blend_weight(const ufbx_anim *anim, const ufbx_blend_channel *channel, double time);
// Evaluate the whole `scene` at a specific `time` in the animation `anim`.
// The returned scene behaves as if it had been exported at a specific time
// in the specified animation, except that animated elements' properties contain
// only the animated values, the original ones are in `props->defaults`.
//
// NOTE: The returned scene refers to the original `scene` so the original
// scene cannot be freed until all evaluated scenes are freed.
ufbx_abi ufbx_scene *ufbx_evaluate_scene(const ufbx_scene *scene, const ufbx_anim *anim, double time, const ufbx_evaluate_opts *opts, ufbx_error *error);
// Create a custom animation descriptor.
// `ufbx_anim_opts` is used to specify animation layers and weights.
// HINT: You can also leave `ufbx_anim_opts.layer_ids[]` empty and only specify
// overrides to evaluate the scene with different properties or local transforms.
ufbx_abi ufbx_anim *ufbx_create_anim(const ufbx_scene *scene, const ufbx_anim_opts *opts, ufbx_error *error);
// Free an animation returned by `ufbx_create_anim()`.
ufbx_abi void ufbx_free_anim(ufbx_anim *anim);
// Increase the animation reference count.
ufbx_abi void ufbx_retain_anim(ufbx_anim *anim);
// Animation baking
// "Bake" an animation to linearly interpolated keyframes.
// Composites the FBX transformation chain into quaternion rotations.
ufbx_abi ufbx_baked_anim *ufbx_bake_anim(const ufbx_scene *scene, const ufbx_anim *anim, const ufbx_bake_opts *opts, ufbx_error *error);
ufbx_abi void ufbx_retain_baked_anim(ufbx_baked_anim *bake);
ufbx_abi void ufbx_free_baked_anim(ufbx_baked_anim *bake);
ufbx_abi ufbx_baked_node *ufbx_find_baked_node_by_typed_id(ufbx_baked_anim *bake, uint32_t typed_id);
ufbx_abi ufbx_baked_node *ufbx_find_baked_node(ufbx_baked_anim *bake, ufbx_node *node);
ufbx_abi ufbx_baked_element *ufbx_find_baked_element_by_element_id(ufbx_baked_anim *bake, uint32_t element_id);
ufbx_abi ufbx_baked_element *ufbx_find_baked_element(ufbx_baked_anim *bake, ufbx_element *element);
// Evaluate baked animation `keyframes` at `time`.
// Internally linearly interpolates between two adjacent keyframes.
// Handles stepped tangents cleanly, which is not strictly necessary for custom interpolation.
ufbx_abi ufbx_vec3 ufbx_evaluate_baked_vec3(ufbx_baked_vec3_list keyframes, double time);
// Evaluate baked animation `keyframes` at `time`.
// Internally spherically interpolates (`ufbx_quat_slerp()`) between two adjacent keyframes.
// Handles stepped tangents cleanly, which is not strictly necessary for custom interpolation.
ufbx_abi ufbx_quat ufbx_evaluate_baked_quat(ufbx_baked_quat_list keyframes, double time);
// Poses
// Retrieve the bone pose for `node`.
// Returns `NULL` if the pose does not contain `node`.
ufbx_abi ufbx_bone_pose *ufbx_get_bone_pose(const ufbx_pose *pose, const ufbx_node *node);
// Materials
// Find a texture for a given material FBX property.
ufbx_abi ufbx_texture *ufbx_find_prop_texture_len(const ufbx_material *material, const char *name, size_t name_len);
ufbx_abi ufbx_texture *ufbx_find_prop_texture(const ufbx_material *material, const char *name);
// Find a texture for a given shader property.
ufbx_abi ufbx_string ufbx_find_shader_prop_len(const ufbx_shader *shader, const char *name, size_t name_len);
ufbx_abi ufbx_string ufbx_find_shader_prop(const ufbx_shader *shader, const char *name);
// Map from a shader property to material property.
ufbx_abi ufbx_shader_prop_binding_list ufbx_find_shader_prop_bindings_len(const ufbx_shader *shader, const char *name, size_t name_len);
ufbx_abi ufbx_shader_prop_binding_list ufbx_find_shader_prop_bindings(const ufbx_shader *shader, const char *name);
// Find an input in a shader texture.
ufbx_abi ufbx_shader_texture_input *ufbx_find_shader_texture_input_len(const ufbx_shader_texture *shader, const char *name, size_t name_len);
ufbx_abi ufbx_shader_texture_input *ufbx_find_shader_texture_input(const ufbx_shader_texture *shader, const char *name);
// Math
// Returns `true` if `axes` forms a valid coordinate space.
ufbx_abi bool ufbx_coordinate_axes_valid(ufbx_coordinate_axes axes);
// Vector math utility functions.
ufbx_abi ufbx_vec3 ufbx_vec3_normalize(ufbx_vec3 v);
// Quaternion math utility functions.
ufbx_abi ufbx_real ufbx_quat_dot(ufbx_quat a, ufbx_quat b);
ufbx_abi ufbx_quat ufbx_quat_mul(ufbx_quat a, ufbx_quat b);
ufbx_abi ufbx_quat ufbx_quat_normalize(ufbx_quat q);
ufbx_abi ufbx_quat ufbx_quat_fix_antipodal(ufbx_quat q, ufbx_quat reference);
ufbx_abi ufbx_quat ufbx_quat_slerp(ufbx_quat a, ufbx_quat b, ufbx_real t);
ufbx_abi ufbx_vec3 ufbx_quat_rotate_vec3(ufbx_quat q, ufbx_vec3 v);
ufbx_abi ufbx_vec3 ufbx_quat_to_euler(ufbx_quat q, ufbx_rotation_order order);
ufbx_abi ufbx_quat ufbx_euler_to_quat(ufbx_vec3 v, ufbx_rotation_order order);
// Matrix math utility functions.
ufbx_abi ufbx_matrix ufbx_matrix_mul(const ufbx_matrix *a, const ufbx_matrix *b);
ufbx_abi ufbx_real ufbx_matrix_determinant(const ufbx_matrix *m);
ufbx_abi ufbx_matrix ufbx_matrix_invert(const ufbx_matrix *m);
// Get a matrix that can be used to transform geometry normals.
// NOTE: You must normalize the normals after transforming them with this matrix,
// eg. using `ufbx_vec3_normalize()`.
// NOTE: This function flips the normals if the determinant is negative.
ufbx_abi ufbx_matrix ufbx_matrix_for_normals(const ufbx_matrix *m);
// Matrix transformation utilities.
ufbx_abi ufbx_vec3 ufbx_transform_position(const ufbx_matrix *m, ufbx_vec3 v);
ufbx_abi ufbx_vec3 ufbx_transform_direction(const ufbx_matrix *m, ufbx_vec3 v);
// Conversions between `ufbx_matrix` and `ufbx_transform`.
ufbx_abi ufbx_matrix ufbx_transform_to_matrix(const ufbx_transform *t);
ufbx_abi ufbx_transform ufbx_matrix_to_transform(const ufbx_matrix *m);
// Skinning
// Get a matrix representing the deformation for a single vertex.
// Returns `fallback` if the vertex is not skinned.
ufbx_abi ufbx_matrix ufbx_catch_get_skin_vertex_matrix(ufbx_panic *panic, const ufbx_skin_deformer *skin, size_t vertex, const ufbx_matrix *fallback);
ufbx_inline ufbx_matrix ufbx_get_skin_vertex_matrix(const ufbx_skin_deformer *skin, size_t vertex, const ufbx_matrix *fallback) {
return ufbx_catch_get_skin_vertex_matrix(NULL, skin, vertex, fallback);
}
// Resolve the index into `ufbx_blend_shape.position_offsets[]` given a vertex.
// Returns `UFBX_NO_INDEX` if the vertex is not included in the blend shape.
ufbx_abi uint32_t ufbx_get_blend_shape_offset_index(const ufbx_blend_shape *shape, size_t vertex);
// Get the offset for a given vertex in the blend shape.
// Returns `ufbx_zero_vec3` if the vertex is not a included in the blend shape.
ufbx_abi ufbx_vec3 ufbx_get_blend_shape_vertex_offset(const ufbx_blend_shape *shape, size_t vertex);
// Get the _current_ blend offset given a blend deformer.
// NOTE: This depends on the current animated blend weight of the deformer.
ufbx_abi ufbx_vec3 ufbx_get_blend_vertex_offset(const ufbx_blend_deformer *blend, size_t vertex);
// Apply the blend shape with `weight` to given vertices.
ufbx_abi void ufbx_add_blend_shape_vertex_offsets(const ufbx_blend_shape *shape, ufbx_vec3 *vertices, size_t num_vertices, ufbx_real weight);
// Apply the blend deformer with `weight` to given vertices.
// NOTE: This depends on the current animated blend weight of the deformer.
ufbx_abi void ufbx_add_blend_vertex_offsets(const ufbx_blend_deformer *blend, ufbx_vec3 *vertices, size_t num_vertices, ufbx_real weight);
// Curves/surfaces
// Low-level utility to evaluate NURBS the basis functions.
ufbx_abi size_t ufbx_evaluate_nurbs_basis(const ufbx_nurbs_basis *basis, ufbx_real u, ufbx_real *weights, size_t num_weights, ufbx_real *derivatives, size_t num_derivatives);
// Evaluate a point on a NURBS curve given the parameter `u`.
ufbx_abi ufbx_curve_point ufbx_evaluate_nurbs_curve(const ufbx_nurbs_curve *curve, ufbx_real u);
// Evaluate a point on a NURBS surface given the parameter `u` and `v`.
ufbx_abi ufbx_surface_point ufbx_evaluate_nurbs_surface(const ufbx_nurbs_surface *surface, ufbx_real u, ufbx_real v);
// Tessellate a NURBS curve into a polyline.
ufbx_abi ufbx_line_curve *ufbx_tessellate_nurbs_curve(const ufbx_nurbs_curve *curve, const ufbx_tessellate_curve_opts *opts, ufbx_error *error);
// Tessellate a NURBS surface into a mesh.
ufbx_abi ufbx_mesh *ufbx_tessellate_nurbs_surface(const ufbx_nurbs_surface *surface, const ufbx_tessellate_surface_opts *opts, ufbx_error *error);
// Free a line returned by `ufbx_tessellate_nurbs_curve()`.
ufbx_abi void ufbx_free_line_curve(ufbx_line_curve *curve);
// Increase the refcount of the line.
ufbx_abi void ufbx_retain_line_curve(ufbx_line_curve *curve);
// Mesh Topology
// Find the face that contains a given `index`.
// Returns `UFBX_NO_INDEX` if out of bounds.
ufbx_abi uint32_t ufbx_find_face_index(ufbx_mesh *mesh, size_t index);
// Triangulate a mesh face, returning the number of triangles.
// NOTE: You need to space for `(face.num_indices - 2) * 3 - 1` indices!
// HINT: Using `ufbx_mesh.max_face_triangles * 3` is always safe.
ufbx_abi uint32_t ufbx_catch_triangulate_face(ufbx_panic *panic, uint32_t *indices, size_t num_indices, const ufbx_mesh *mesh, ufbx_face face);
ufbx_abi uint32_t ufbx_triangulate_face(uint32_t *indices, size_t num_indices, const ufbx_mesh *mesh, ufbx_face face);
// Generate the half-edge representation of `mesh` to `topo[mesh->num_indices]`
ufbx_abi void ufbx_catch_compute_topology(ufbx_panic *panic, const ufbx_mesh *mesh, ufbx_topo_edge *topo, size_t num_topo);
ufbx_abi void ufbx_compute_topology(const ufbx_mesh *mesh, ufbx_topo_edge *topo, size_t num_topo);
// Get the next/previous edge around a vertex
// NOTE: Does not return the half-edge on the opposite side (ie. `topo[index].twin`)
// Get the next half-edge in `topo`.
ufbx_abi uint32_t ufbx_catch_topo_next_vertex_edge(ufbx_panic *panic, const ufbx_topo_edge *topo, size_t num_topo, uint32_t index);
ufbx_abi uint32_t ufbx_topo_next_vertex_edge(const ufbx_topo_edge *topo, size_t num_topo, uint32_t index);
// Get the previous half-edge in `topo`.
ufbx_abi uint32_t ufbx_catch_topo_prev_vertex_edge(ufbx_panic *panic, const ufbx_topo_edge *topo, size_t num_topo, uint32_t index);
ufbx_abi uint32_t ufbx_topo_prev_vertex_edge(const ufbx_topo_edge *topo, size_t num_topo, uint32_t index);
// Calculate a normal for a given face.
// The returned normal is weighted by face area.
ufbx_abi ufbx_vec3 ufbx_catch_get_weighted_face_normal(ufbx_panic *panic, const ufbx_vertex_vec3 *positions, ufbx_face face);
ufbx_abi ufbx_vec3 ufbx_get_weighted_face_normal(const ufbx_vertex_vec3 *positions, ufbx_face face);
// Generate indices for normals from the topology.
// Respects smoothing groups.
ufbx_abi size_t ufbx_catch_generate_normal_mapping(ufbx_panic *panic, const ufbx_mesh *mesh,
const ufbx_topo_edge *topo, size_t num_topo,
uint32_t *normal_indices, size_t num_normal_indices, bool assume_smooth);
ufbx_abi size_t ufbx_generate_normal_mapping(const ufbx_mesh *mesh,
const ufbx_topo_edge *topo, size_t num_topo,
uint32_t *normal_indices, size_t num_normal_indices, bool assume_smooth);
// Compute normals given normal indices.
// You can use `ufbx_generate_normal_mapping()` to generate the normal indices.
ufbx_abi void ufbx_catch_compute_normals(ufbx_panic *panic, const ufbx_mesh *mesh, const ufbx_vertex_vec3 *positions,
const uint32_t *normal_indices, size_t num_normal_indices,
ufbx_vec3 *normals, size_t num_normals);
ufbx_abi void ufbx_compute_normals(const ufbx_mesh *mesh, const ufbx_vertex_vec3 *positions,
const uint32_t *normal_indices, size_t num_normal_indices,
ufbx_vec3 *normals, size_t num_normals);
// Subdivide a mesh using the Catmull-Clark subdivision `level` times.
ufbx_abi ufbx_mesh *ufbx_subdivide_mesh(const ufbx_mesh *mesh, size_t level, const ufbx_subdivide_opts *opts, ufbx_error *error);
// Free a mesh returned from `ufbx_subdivide_mesh()` or `ufbx_tessellate_nurbs_surface()`.
ufbx_abi void ufbx_free_mesh(ufbx_mesh *mesh);
// Increase the mesh reference count.
ufbx_abi void ufbx_retain_mesh(ufbx_mesh *mesh);
// Geometry caches
// Load geometry cache information from a file.
// As geometry caches can be massive, this does not actually read the data, but
// only seeks through the files to form the metadata.
ufbx_abi ufbx_geometry_cache *ufbx_load_geometry_cache(
const char *filename,
const ufbx_geometry_cache_opts *opts, ufbx_error *error);
ufbx_abi ufbx_geometry_cache *ufbx_load_geometry_cache_len(
const char *filename, size_t filename_len,
const ufbx_geometry_cache_opts *opts, ufbx_error *error);
// Free a geometry cache returned from `ufbx_load_geometry_cache()`.
ufbx_abi void ufbx_free_geometry_cache(ufbx_geometry_cache *cache);
// Increase the geometry cache reference count.
ufbx_abi void ufbx_retain_geometry_cache(ufbx_geometry_cache *cache);
// Read a frame from a geometry cache.
ufbx_abi size_t ufbx_read_geometry_cache_real(const ufbx_cache_frame *frame, ufbx_real *data, size_t num_data, const ufbx_geometry_cache_data_opts *opts);
ufbx_abi size_t ufbx_read_geometry_cache_vec3(const ufbx_cache_frame *frame, ufbx_vec3 *data, size_t num_data, const ufbx_geometry_cache_data_opts *opts);
// Sample the a geometry cache channel, linearly blending between adjacent frames.
ufbx_abi size_t ufbx_sample_geometry_cache_real(const ufbx_cache_channel *channel, double time, ufbx_real *data, size_t num_data, const ufbx_geometry_cache_data_opts *opts);
ufbx_abi size_t ufbx_sample_geometry_cache_vec3(const ufbx_cache_channel *channel, double time, ufbx_vec3 *data, size_t num_data, const ufbx_geometry_cache_data_opts *opts);
// DOM
// Find a DOM node given a name.
ufbx_abi ufbx_dom_node *ufbx_dom_find_len(const ufbx_dom_node *parent, const char *name, size_t name_len);
ufbx_abi ufbx_dom_node *ufbx_dom_find(const ufbx_dom_node *parent, const char *name);
// Utility
// Generate an index buffer for a flat vertex buffer.
// `streams` specifies one or more vertex data arrays, each stream must contain `num_indices` vertices.
// This function compacts the data within `streams` in-place, writing the deduplicated indices to `indices`.
ufbx_abi size_t ufbx_generate_indices(const ufbx_vertex_stream *streams, size_t num_streams, uint32_t *indices, size_t num_indices, const ufbx_allocator_opts *allocator, ufbx_error *error);
// Thread pool
// Run a single thread pool task.
// See `ufbx_thread_pool_run_fn` for more information.
ufbx_unsafe ufbx_abi void ufbx_thread_pool_run_task(ufbx_thread_pool_context ctx, uint32_t index);
// Get or set an arbitrary user pointer for the thread pool context.
// `ufbx_thread_pool_get_user_ptr()` returns `NULL` if unset.
ufbx_unsafe ufbx_abi void ufbx_thread_pool_set_user_ptr(ufbx_thread_pool_context ctx, void *user_ptr);
ufbx_unsafe ufbx_abi void *ufbx_thread_pool_get_user_ptr(ufbx_thread_pool_context ctx);
// -- Inline API
// Utility functions for reading geometry data for a single index.
ufbx_abi ufbx_real ufbx_catch_get_vertex_real(ufbx_panic *panic, const ufbx_vertex_real *v, size_t index);
ufbx_abi ufbx_vec2 ufbx_catch_get_vertex_vec2(ufbx_panic *panic, const ufbx_vertex_vec2 *v, size_t index);
ufbx_abi ufbx_vec3 ufbx_catch_get_vertex_vec3(ufbx_panic *panic, const ufbx_vertex_vec3 *v, size_t index);
ufbx_abi ufbx_vec4 ufbx_catch_get_vertex_vec4(ufbx_panic *panic, const ufbx_vertex_vec4 *v, size_t index);
// Utility functions for reading geometry data for a single index.
ufbx_inline ufbx_real ufbx_get_vertex_real(const ufbx_vertex_real *v, size_t index) { ufbx_assert(index < v->indices.count); return v->values.data[(int32_t)v->indices.data[index]]; }
ufbx_inline ufbx_vec2 ufbx_get_vertex_vec2(const ufbx_vertex_vec2 *v, size_t index) { ufbx_assert(index < v->indices.count); return v->values.data[(int32_t)v->indices.data[index]]; }
ufbx_inline ufbx_vec3 ufbx_get_vertex_vec3(const ufbx_vertex_vec3 *v, size_t index) { ufbx_assert(index < v->indices.count); return v->values.data[(int32_t)v->indices.data[index]]; }
ufbx_inline ufbx_vec4 ufbx_get_vertex_vec4(const ufbx_vertex_vec4 *v, size_t index) { ufbx_assert(index < v->indices.count); return v->values.data[(int32_t)v->indices.data[index]]; }
ufbx_abi ufbx_real ufbx_catch_get_vertex_w_vec3(ufbx_panic *panic, const ufbx_vertex_vec3 *v, size_t index);
ufbx_inline ufbx_real ufbx_get_vertex_w_vec3(const ufbx_vertex_vec3 *v, size_t index) { ufbx_assert(index < v->indices.count); return v->values_w.count > 0 ? v->values_w.data[(int32_t)v->indices.data[index]] : 0.0f; }
// Functions for converting an untyped `ufbx_element` to a concrete type.
// Returns `NULL` if the element is not that type.
ufbx_abi ufbx_unknown *ufbx_as_unknown(const ufbx_element *element);
ufbx_abi ufbx_node *ufbx_as_node(const ufbx_element *element);
ufbx_abi ufbx_mesh *ufbx_as_mesh(const ufbx_element *element);
ufbx_abi ufbx_light *ufbx_as_light(const ufbx_element *element);
ufbx_abi ufbx_camera *ufbx_as_camera(const ufbx_element *element);
ufbx_abi ufbx_bone *ufbx_as_bone(const ufbx_element *element);
ufbx_abi ufbx_empty *ufbx_as_empty(const ufbx_element *element);
ufbx_abi ufbx_line_curve *ufbx_as_line_curve(const ufbx_element *element);
ufbx_abi ufbx_nurbs_curve *ufbx_as_nurbs_curve(const ufbx_element *element);
ufbx_abi ufbx_nurbs_surface *ufbx_as_nurbs_surface(const ufbx_element *element);
ufbx_abi ufbx_nurbs_trim_surface *ufbx_as_nurbs_trim_surface(const ufbx_element *element);
ufbx_abi ufbx_nurbs_trim_boundary *ufbx_as_nurbs_trim_boundary(const ufbx_element *element);
ufbx_abi ufbx_procedural_geometry *ufbx_as_procedural_geometry(const ufbx_element *element);
ufbx_abi ufbx_stereo_camera *ufbx_as_stereo_camera(const ufbx_element *element);
ufbx_abi ufbx_camera_switcher *ufbx_as_camera_switcher(const ufbx_element *element);
ufbx_abi ufbx_marker *ufbx_as_marker(const ufbx_element *element);
ufbx_abi ufbx_lod_group *ufbx_as_lod_group(const ufbx_element *element);
ufbx_abi ufbx_skin_deformer *ufbx_as_skin_deformer(const ufbx_element *element);
ufbx_abi ufbx_skin_cluster *ufbx_as_skin_cluster(const ufbx_element *element);
ufbx_abi ufbx_blend_deformer *ufbx_as_blend_deformer(const ufbx_element *element);
ufbx_abi ufbx_blend_channel *ufbx_as_blend_channel(const ufbx_element *element);
ufbx_abi ufbx_blend_shape *ufbx_as_blend_shape(const ufbx_element *element);
ufbx_abi ufbx_cache_deformer *ufbx_as_cache_deformer(const ufbx_element *element);
ufbx_abi ufbx_cache_file *ufbx_as_cache_file(const ufbx_element *element);
ufbx_abi ufbx_material *ufbx_as_material(const ufbx_element *element);
ufbx_abi ufbx_texture *ufbx_as_texture(const ufbx_element *element);
ufbx_abi ufbx_video *ufbx_as_video(const ufbx_element *element);
ufbx_abi ufbx_shader *ufbx_as_shader(const ufbx_element *element);
ufbx_abi ufbx_shader_binding *ufbx_as_shader_binding(const ufbx_element *element);
ufbx_abi ufbx_anim_stack *ufbx_as_anim_stack(const ufbx_element *element);
ufbx_abi ufbx_anim_layer *ufbx_as_anim_layer(const ufbx_element *element);
ufbx_abi ufbx_anim_value *ufbx_as_anim_value(const ufbx_element *element);
ufbx_abi ufbx_anim_curve *ufbx_as_anim_curve(const ufbx_element *element);
ufbx_abi ufbx_display_layer *ufbx_as_display_layer(const ufbx_element *element);
ufbx_abi ufbx_selection_set *ufbx_as_selection_set(const ufbx_element *element);
ufbx_abi ufbx_selection_node *ufbx_as_selection_node(const ufbx_element *element);
ufbx_abi ufbx_character *ufbx_as_character(const ufbx_element *element);
ufbx_abi ufbx_constraint *ufbx_as_constraint(const ufbx_element *element);
ufbx_abi ufbx_audio_layer *ufbx_as_audio_layer(const ufbx_element *element);
ufbx_abi ufbx_audio_clip *ufbx_as_audio_clip(const ufbx_element *element);
ufbx_abi ufbx_pose *ufbx_as_pose(const ufbx_element *element);
ufbx_abi ufbx_metadata_object *ufbx_as_metadata_object(const ufbx_element *element);
#ifdef __cplusplus
}
#endif
// bindgen-disable
#if UFBX_CPP11
struct ufbx_string_view {
const char *data;
size_t length;
ufbx_string_view() : data(nullptr), length(0) { }
ufbx_string_view(const char *data_, size_t length_) : data(data_), length(length_) { }
UFBX_CONVERSION_TO_IMPL(ufbx_string_view)
};
ufbx_inline ufbx_scene *ufbx_load_file(ufbx_string_view filename, const ufbx_load_opts *opts, ufbx_error *error) { return ufbx_load_file_len(filename.data, filename.length, opts, error); }
ufbx_inline ufbx_prop *ufbx_find_prop(const ufbx_props *props, ufbx_string_view name) { return ufbx_find_prop_len(props, name.data, name.length); }
ufbx_inline ufbx_real ufbx_find_real(const ufbx_props *props, ufbx_string_view name, ufbx_real def) { return ufbx_find_real_len(props, name.data, name.length, def); }
ufbx_inline ufbx_vec3 ufbx_find_vec3(const ufbx_props *props, ufbx_string_view name, ufbx_vec3 def) { return ufbx_find_vec3_len(props, name.data, name.length, def); }
ufbx_inline int64_t ufbx_find_int(const ufbx_props *props, ufbx_string_view name, int64_t def) { return ufbx_find_int_len(props, name.data, name.length, def); }
ufbx_inline bool ufbx_find_bool(const ufbx_props *props, ufbx_string_view name, bool def) { return ufbx_find_bool_len(props, name.data, name.length, def); }
ufbx_inline ufbx_string ufbx_find_string(const ufbx_props *props, ufbx_string_view name, ufbx_string def) { return ufbx_find_string_len(props, name.data, name.length, def); }
ufbx_inline ufbx_blob ufbx_find_blob(const ufbx_props *props, ufbx_string_view name, ufbx_blob def) { return ufbx_find_blob_len(props, name.data, name.length, def); }
ufbx_inline ufbx_element *ufbx_find_prop_element(const ufbx_element *element, ufbx_string_view name, ufbx_element_type type) { return ufbx_find_prop_element_len(element, name.data, name.length, type); }
ufbx_inline ufbx_element *ufbx_find_element(const ufbx_scene *scene, ufbx_element_type type, ufbx_string_view name) { return ufbx_find_element_len(scene, type, name.data, name.length); }
ufbx_inline ufbx_node *ufbx_find_node(const ufbx_scene *scene, ufbx_string_view name) { return ufbx_find_node_len(scene, name.data, name.length); }
ufbx_inline ufbx_anim_stack *ufbx_find_anim_stack(const ufbx_scene *scene, ufbx_string_view name) { return ufbx_find_anim_stack_len(scene, name.data, name.length); }
ufbx_inline ufbx_material *ufbx_find_material(const ufbx_scene *scene, ufbx_string_view name) { return ufbx_find_material_len(scene, name.data, name.length); }
ufbx_inline ufbx_anim_prop *ufbx_find_anim_prop(const ufbx_anim_layer *layer, const ufbx_element *element, ufbx_string_view prop) { return ufbx_find_anim_prop_len(layer, element, prop.data, prop.length); }
ufbx_inline ufbx_prop ufbx_evaluate_prop(const ufbx_anim *anim, const ufbx_element *element, ufbx_string_view name, double time) { return ufbx_evaluate_prop_len(anim, element, name.data, name.length, time); }
ufbx_inline ufbx_texture *ufbx_find_prop_texture(const ufbx_material *material, ufbx_string_view name) { return ufbx_find_prop_texture_len(material, name.data, name.length); }
ufbx_inline ufbx_string ufbx_find_shader_prop(const ufbx_shader *shader, ufbx_string_view name) { return ufbx_find_shader_prop_len(shader, name.data, name.length); }
ufbx_inline ufbx_shader_prop_binding_list ufbx_find_shader_prop_bindings(const ufbx_shader *shader, ufbx_string_view name) { return ufbx_find_shader_prop_bindings_len(shader, name.data, name.length); }
ufbx_inline ufbx_shader_texture_input *ufbx_find_shader_texture_input(const ufbx_shader_texture *shader, ufbx_string_view name) { return ufbx_find_shader_texture_input_len(shader, name.data, name.length); }
ufbx_inline ufbx_geometry_cache *ufbx_load_geometry_cache(ufbx_string_view filename, const ufbx_geometry_cache_opts *opts, ufbx_error *error) { return ufbx_load_geometry_cache_len(filename.data, filename.length, opts, error); }
ufbx_inline ufbx_dom_node *ufbx_dom_find(const ufbx_dom_node *parent, ufbx_string_view name) { return ufbx_dom_find_len(parent, name.data, name.length); }
#endif
#if UFBX_CPP11
template <typename T>
struct ufbx_type_traits { enum { valid = 0 }; };
template<> struct ufbx_type_traits<ufbx_scene> {
enum { valid = 1 };
static void retain(ufbx_scene *ptr) { ufbx_retain_scene(ptr); }
static void free(ufbx_scene *ptr) { ufbx_free_scene(ptr); }
};
template<> struct ufbx_type_traits<ufbx_mesh> {
enum { valid = 1 };
static void retain(ufbx_mesh *ptr) { ufbx_retain_mesh(ptr); }
static void free(ufbx_mesh *ptr) { ufbx_free_mesh(ptr); }
};
template<> struct ufbx_type_traits<ufbx_line_curve> {
enum { valid = 1 };
static void retain(ufbx_line_curve *ptr) { ufbx_retain_line_curve(ptr); }
static void free(ufbx_line_curve *ptr) { ufbx_free_line_curve(ptr); }
};
template<> struct ufbx_type_traits<ufbx_geometry_cache> {
enum { valid = 1 };
static void retain(ufbx_geometry_cache *ptr) { ufbx_retain_geometry_cache(ptr); }
static void free(ufbx_geometry_cache *ptr) { ufbx_free_geometry_cache(ptr); }
};
template<> struct ufbx_type_traits<ufbx_anim> {
enum { valid = 1 };
static void retain(ufbx_anim *ptr) { ufbx_retain_anim(ptr); }
static void free(ufbx_anim *ptr) { ufbx_free_anim(ptr); }
};
template<> struct ufbx_type_traits<ufbx_baked_anim> {
enum { valid = 1 };
static void retain(ufbx_baked_anim *ptr) { ufbx_retain_baked_anim(ptr); }
static void free(ufbx_baked_anim *ptr) { ufbx_free_baked_anim(ptr); }
};
class ufbx_deleter {
public:
template <typename T>
void operator()(T *ptr) const {
static_assert(ufbx_type_traits<T>::valid, "ufbx_deleter() unsupported for type");
ufbx_type_traits<T>::free(ptr);
}
};
// RAII wrapper over refcounted ufbx types.
// Behaves like `std::unique_ptr<T>`.
template <typename T>
class ufbx_unique_ptr {
T *ptr;
using traits = ufbx_type_traits<T>;
static_assert(ufbx_type_traits<T>::valid, "ufbx_unique_ptr unsupported for type");
public:
ufbx_unique_ptr() noexcept : ptr(nullptr) { }
explicit ufbx_unique_ptr(T *ptr_) noexcept : ptr(ptr_) { }
ufbx_unique_ptr(ufbx_unique_ptr &&ref) noexcept : ptr(ref.ptr) { ref.ptr = nullptr; }
~ufbx_unique_ptr() { traits::free(ptr); }
ufbx_unique_ptr &operator=(ufbx_unique_ptr &&ref) noexcept {
if (&ref == this) return *this;
ptr = ref.ptr;
ref.ptr = nullptr;
return *this;
}
void reset(T *new_ptr=nullptr) noexcept {
traits::free(ptr);
ptr = new_ptr;
}
void swap(ufbx_unique_ptr &ref) noexcept {
T *tmp = ptr;
ptr = ref.ptr;
ref.ptr = tmp;
}
T &operator*() const noexcept { return *ptr; }
T *operator->() const noexcept { return ptr; }
T *get() const noexcept { return ptr; }
explicit operator bool() const noexcept { return ptr != nullptr; }
};
// Behaves like `std::shared_ptr<T>` except uses ufbx's internal reference counting,
// so it is half the size of a standard `shared_ptr` but might be marginally slower.
template <typename T>
class ufbx_shared_ptr {
T *ptr;
using traits = ufbx_type_traits<T>;
static_assert(ufbx_type_traits<T>::valid, "ufbx_shared_ptr unsupported for type");
public:
ufbx_shared_ptr() noexcept : ptr(nullptr) { }
explicit ufbx_shared_ptr(T *ptr_) noexcept : ptr(ptr_) { }
ufbx_shared_ptr(const ufbx_shared_ptr &ref) noexcept : ptr(ref.ptr) { traits::retain(ref.ptr); }
ufbx_shared_ptr(ufbx_shared_ptr &&ref) noexcept : ptr(ref.ptr) { ref.ptr = nullptr; }
~ufbx_shared_ptr() { traits::free(ptr); }
ufbx_shared_ptr &operator=(const ufbx_shared_ptr &ref) noexcept {
if (&ref == this) return *this;
traits::free(ptr);
traits::retain(ref.ptr);
ptr = ref.ptr;
return *this;
}
ufbx_shared_ptr &operator=(ufbx_shared_ptr &&ref) noexcept {
if (&ref == this) return *this;
ptr = ref.ptr;
ref.ptr = nullptr;
return *this;
}
void reset(T *new_ptr=nullptr) noexcept {
traits::free(ptr);
ptr = new_ptr;
}
void swap(ufbx_shared_ptr &ref) noexcept {
T *tmp = ptr;
ptr = ref.ptr;
ref.ptr = tmp;
}
T &operator*() const noexcept { return *ptr; }
T *operator->() const noexcept { return ptr; }
T *get() const noexcept { return ptr; }
explicit operator bool() const noexcept { return ptr != nullptr; }
};
#endif
// bindgen-enable
// -- Properties
// Names of common properties in `ufbx_props`.
// Some of these differ from ufbx interpretations.
// Local translation.
// Used by: `ufbx_node`
#define UFBX_Lcl_Translation "Lcl Translation"
// Local rotation expressed in Euler degrees.
// Used by: `ufbx_node`
// The rotation order is defined by the `UFBX_RotationOrder` property.
#define UFBX_Lcl_Rotation "Lcl Rotation"
// Local scaling factor, 3D vector.
// Used by: `ufbx_node`
#define UFBX_Lcl_Scaling "Lcl Scaling"
// Euler rotation interpretation, used by `UFBX_Lcl_Rotation`.
// Used by: `ufbx_node`, enum value `ufbx_rotation_order`.
#define UFBX_RotationOrder "RotationOrder"
// Scaling pivot: point around which scaling is performed.
// Used by: `ufbx_node`.
#define UFBX_ScalingPivot "ScalingPivot"
// Scaling pivot: point around which rotation is performed.
// Used by: `ufbx_node`.
#define UFBX_RotationPivot "RotationPivot"
// Scaling offset: translation added after scaling is performed.
// Used by: `ufbx_node`.
#define UFBX_ScalingOffset "ScalingOffset"
// Rotation offset: translation added after rotation is performed.
// Used by: `ufbx_node`.
#define UFBX_RotationOffset "RotationOffset"
// Pre-rotation: Rotation applied _after_ `UFBX_Lcl_Rotation`.
// Used by: `ufbx_node`.
// Affected by `UFBX_RotationPivot` but not `UFBX_RotationOrder`.
#define UFBX_PreRotation "PreRotation"
// Post-rotation: Rotation applied _before_ `UFBX_Lcl_Rotation`.
// Used by: `ufbx_node`.
// Affected by `UFBX_RotationPivot` but not `UFBX_RotationOrder`.
#define UFBX_PostRotation "PostRotation"
// Controls whether the node should be displayed or not.
// Used by: `ufbx_node`.
#define UFBX_Visibility "Visibility"
// Weight of an animation layer in percentage (100.0 being full).
// Used by: `ufbx_anim_layer`.
#define UFBX_Weight "Weight"
// Blend shape deformation weight (100.0 being full).
// Used by: `ufbx_blend_channel`.
#define UFBX_DeformPercent "DeformPercent"
#if defined(_MSC_VER)
#pragma warning(pop)
#elif defined(__clang__)
#pragma clang diagnostic pop
#elif defined(__GNUC__)
#pragma GCC diagnostic pop
#endif
#endif