Magnum::Trade namespace

Data format exchange.

Contents

Contains plugin interfaces for importing data of various formats and classes for direct access to the data.

This library is built if WITH_TRADE is enabled when building Magnum. To use this library with CMake, request the Trade component of the Magnum package and link to the Magnum::Trade target:

find_package(Magnum REQUIRED Trade)

# ...
target_link_libraries(your-app PRIVATE Magnum::Trade)

Additional plugins and utilities are built separately. See particular Trade::*Importer and *ImageConverter class documentation, the magnum-imageconverter utility documentation, Downloading and building, Downloading and building plugins, Usage with CMake, Plugin usage with CMake and Loading and using plugins for more information.

Namespaces

namespace OpenGex
OpenGEX structure and property names.

Classes

class AbstractImageConverter
Base for image converter plugins.
class AbstractImporter
Base for importer plugins.
class AbstractMaterialData
Base for material data.
class AnimationData
Animation clip data.
class AnimationTrackData
Animation track data.
class AnyImageConverter
Any image converter plugin.
class AnyImageImporter
Any image importer plugin.
class AnySceneImporter
Any scene importer plugin.
class AssimpImporter
Assimp importer.
class BasisImageConverter new in 2019.10
Basis Universal image converter plugin.
class BasisImporter new in 2019.10
Basis Universal importer plugin.
class CameraData
Camera data.
class DdsImporter
DDS image importer plugin.
class DevIlImageImporter
DevIL Image importer plugin.
template<UnsignedInt dimensions>
class ImageData
Image data.
class JpegImageConverter
JPEG image converter plugin.
class JpegImporter
JPEG importer plugin.
class LightData
Light data.
class MeshData2D
Two-dimensional mesh data.
class MeshData3D
Three-dimensional mesh data.
class MeshObjectData2D
Two-dimensional mesh object data.
class MeshObjectData3D
Three-dimensional mesh object data.
class MiniExrImageConverter
OpenEXR image converter plugin using miniexr.
class ObjectData2D
Two-dimensional object data.
class ObjectData3D
Three-dimensional object data.
class ObjImporter
OBJ importer plugin.
class OpenGexImporter
OpenGEX importer.
class PhongMaterialData
Phong material data.
class PngImageConverter
PNG image converter plugin.
class PngImporter
PNG importer plugin.
class SceneData
Scene data.
class StanfordImporter
Stanford PLY importer plugin.
class StbImageConverter
Image converter plugin using stb_image_write.
class StbImageImporter
Image importer plugin using stb_image.
class TextureData
Texture data.
class TgaImageConverter
TGA image converter plugin.
class TgaImporter
TGA importer plugin.
class TinyGltfImporter
TinyGltf importer plugin.

Enums

enum class MaterialType: UnsignedByte { Phong }
Material type.
enum class MaterialAlphaMode: UnsignedByte { Opaque, Mask, Blend }
Material alpha mode.
enum class AnimationTrackType: UnsignedByte { Bool, Float, UnsignedInt, Int, BoolVector2, BoolVector3, BoolVector4, Vector2, Vector2ui, Vector2i, Vector3, Vector3ui, Vector3i, Vector4, Vector4ui, Vector4i, Complex, Quaternion, DualQuaternion, CubicHermite1D, CubicHermite2D, CubicHermite3D, CubicHermiteComplex, CubicHermiteQuaternion }
Type of animation track data.
enum class AnimationTrackTargetType: UnsignedByte { Translation2D, Translation3D, Rotation2D, Rotation3D, Scaling2D, Scaling3D, Custom = 128 }
Target of an animation track.
enum class CameraType: UnsignedByte { Orthographic2D, Orthographic3D, Perspective3D }
Camera type.
enum class ObjectInstanceType2D: UnsignedByte { Camera, Mesh, Empty }
Type of instance held by given 2D object.
enum class ObjectFlag2D: UnsignedByte { HasTranslationRotationScaling = 1 << 0 }
2D object flag
enum class ObjectInstanceType3D: UnsignedByte { Camera, Light, Mesh, Empty }
Type of instance held by given 3D object.
enum class ObjectFlag3D: UnsignedByte { HasTranslationRotationScaling = 1 << 0 }
3D object flag

Typedefs

using ImporterFileCallbackPolicy = InputFileCallbackPolicy deprecated in 2019.10
Input file callback policy.
using ImageData1D = ImageData<1>
One-dimensional image data.
using ImageData2D = ImageData<2>
Two-dimensional image data.
using ImageData3D = ImageData<3>
Three-dimensional image data.
using ObjectFlags2D = Containers::EnumSet<ObjectFlag2D>
2D object flags
using ObjectFlags3D = Containers::EnumSet<ObjectFlag3D>
3D object flags

Functions

auto operator<<(Debug& debug, AbstractImageConverter::Feature value) -> Debug&
Debug output operator.
auto operator<<(Debug& debug, AbstractImageConverter::Features value) -> Debug&
Debug output operator.
auto operator<<(Debug& debug, AbstractImporter::Feature value) -> Debug&
Debug output operator.
auto operator<<(Debug& debug, MaterialType value) -> Debug&
Debug output operator.
auto operator<<(Debug& debug, MaterialAlphaMode value) -> Debug&
Debug output operator.
auto operator<<(Debug& debug, AbstractMaterialData::Flag value) -> Debug&
Debug output operator.
auto operator<<(Debug& debug, AbstractMaterialData::Flags value) -> Debug&
Debug output operator.
auto operator<<(Debug& debug, AnimationTrackType value) -> Debug&
Debug output operator.
auto operator<<(Debug& debug, AnimationTrackTargetType value) -> Debug&
Debug output operator.
template<class V, class R = Animation::ResultOf<V>>
auto animationInterpolatorFor(Animation::Interpolation interpolation) -> auto
Animation interpolator function for given interpolation behavior.
auto operator<<(Debug& debug, CameraType value) -> Debug&
Debug output operator.
auto operator<<(Debug& debug, LightData::Type value) -> Debug&
Debug output operator.
auto operator<<(Debug& debug, ObjectInstanceType2D value) -> Debug&
Debug output operator.
auto operator<<(Debug& debug, ObjectFlag2D value) -> Debug&
Debug output operator.
auto operator<<(Debug& debug, ObjectFlags2D value) -> Debug&
Debug output operator.
auto operator<<(Debug& debug, ObjectInstanceType3D value) -> Debug&
Debug output operator.
auto operator<<(Debug& debug, ObjectFlag3D value) -> Debug&
Debug output operator.
auto operator<<(Debug& debug, ObjectFlags3D value) -> Debug&
Debug output operator.
auto operator<<(Debug& debug, PhongMaterialData::Flag value) -> Debug&
Debug output operator.
auto operator<<(Debug& debug, TextureData::Type value) -> Debug&
Debug output operator.

Enum documentation

enum class Magnum::Trade::MaterialType: UnsignedByte
#include <Magnum/Trade/AbstractMaterialData.h>

Material type.

Enumerators
Phong

Phong shading (see PhongMaterialData)

enum class Magnum::Trade::MaterialAlphaMode: UnsignedByte
#include <Magnum/Trade/AbstractMaterialData.h>

Material alpha mode.

Enumerators
Opaque

Alpha value is ignored and the rendered output is fully opaque.
Mask

The rendered output is either fully transparent or fully opaque, depending on the alpha value and specified AbstractMaterialData::alphaMask() value.
Blend

The alpha value is used to combine source and destination colors using additive blending.

enum class Magnum::Trade::AnimationTrackType: UnsignedByte
#include <Magnum/Trade/AnimationData.h>

Type of animation track data.

Enumerators
Bool

bool
Float

Float
UnsignedInt

UnsignedInt
Int

Int
BoolVector2

Math::BoolVector<2>
BoolVector3

Math::BoolVector<3>
BoolVector4

Math::BoolVector<4>
Vector2

Vector2. Usually used for AnimationTrackTargetType::Translation2D and AnimationTrackTargetType::Scaling2D.
Vector2ui

Vector2ui
Vector2i

Vector2i
Vector3

Vector3. Usually used for AnimationTrackTargetType::Translation3D and AnimationTrackTargetType::Scaling3D.
Vector3ui

Vector3ui
Vector3i

Vector3i
Vector4

Vector4
Vector4ui

Vector4ui
Vector4i

Vector4i
Complex

Complex. Usually used for AnimationTrackTargetType::Rotation2D.
Quaternion

Quaternion. Usually used for AnimationTrackTargetType::Rotation3D.
DualQuaternion

DualQuaternion
CubicHermite1D

CubicHermite1D
CubicHermite2D

CubicHermite2D. Usually used for spline-interpolated AnimationTrackTargetType::Translation2D and AnimationTrackTargetType::Scaling2D.
CubicHermite3D

CubicHermite3D. Usually used for spline-interpolated AnimationTrackTargetType::Translation3D and AnimationTrackTargetType::Scaling3D.
CubicHermiteComplex

CubicHermiteComplex. Usually used for spline-interpolated AnimationTrackTargetType::Rotation2D.
CubicHermiteQuaternion

CubicHermiteQuaternion. Usually used for spline-interpolated AnimationTrackTargetType::Rotation3D.

enum class Magnum::Trade::AnimationTrackTargetType: UnsignedByte
#include <Magnum/Trade/AnimationData.h>

Target of an animation track.

Enumerators
Translation2D

Modifies 2D object translation. Type is usually Vector2 or CubicHermite2D for spline-interpolated data.
Translation3D

Modifies 3D object translation. Type is usually Vector3 or CubicHermite3D for spline-interpolated data.
Rotation2D

Modifies 2D object rotation. Type is usually Complex or CubicHermiteComplex for spline-interpolated data.
Rotation3D

Modifies 3D object rotation. Type is usually Quaternion or CubicHermiteQuaternion for spline-interpolated data.
Scaling2D

Modifies 2D object scaling. Type is usually Vector2 or CubicHermite2D for spline-interpolated data.
Scaling3D

Modifies 3D object scaling. Type is usually Vector3 or CubicHermite3D for spline-interpolated data.
Custom

This and all higher values are for importer-specific targets. Can be of any type, AnimationData::trackTarget() might or might not point to an existing object. See documentation of a particular importer for details.

enum class Magnum::Trade::CameraType: UnsignedByte
#include <Magnum/Trade/CameraData.h>

Camera type.

Enumerators
Orthographic2D

2D orthographic camera
Orthographic3D

3D orthographic camera
Perspective3D

3D perspective camera

enum class Magnum::Trade::ObjectInstanceType2D: UnsignedByte
#include <Magnum/Trade/ObjectData2D.h>

Type of instance held by given 2D object.

Enumerators
Camera

Camera instance (see CameraData)
Mesh

Mesh instance. The data can be cast to MeshObjectData2D to provide more information.
Empty

Empty

enum class Magnum::Trade::ObjectFlag2D: UnsignedByte
#include <Magnum/Trade/ObjectData2D.h>

2D object flag

Enumerators
HasTranslationRotationScaling

The object provides separate translation / rotation / scaling properties. The ObjectData2D::transformation() matrix returns them combined, but it's possible to access particular parts of the transformation using ObjectData2D::translation(), ObjectData2D::rotation() and ObjectData2D::scaling().

enum class Magnum::Trade::ObjectInstanceType3D: UnsignedByte
#include <Magnum/Trade/ObjectData3D.h>

Type of instance held by given 3D object.

Enumerators
Camera

Camera instance (see CameraData)
Light

Light instance (see LightData)
Mesh

Mesh instance. The data can be cast to MeshObjectData3D to provide more information.
Empty

Empty

enum class Magnum::Trade::ObjectFlag3D: UnsignedByte
#include <Magnum/Trade/ObjectData3D.h>

3D object flag

Enumerators
HasTranslationRotationScaling

The object provides separate translation / rotation / scaling properties. The ObjectData3D::transformation() matrix returns them combined, but it's possible to access particular parts of the transformation using ObjectData3D::translation(), ObjectData3D::rotation() and ObjectData3D::scaling().

Typedef documentation

typedef ImageData<1> Magnum::Trade::ImageData1D
#include <Magnum/Trade/ImageData.h>

One-dimensional image data.

typedef ImageData<2> Magnum::Trade::ImageData2D
#include <Magnum/Trade/ImageData.h>

Two-dimensional image data.

typedef ImageData<3> Magnum::Trade::ImageData3D
#include <Magnum/Trade/ImageData.h>

Three-dimensional image data.

typedef Containers::EnumSet<ObjectFlag2D> Magnum::Trade::ObjectFlags2D
#include <Magnum/Trade/ObjectData2D.h>

2D object flags

typedef Containers::EnumSet<ObjectFlag3D> Magnum::Trade::ObjectFlags3D
#include <Magnum/Trade/ObjectData3D.h>

3D object flags

Function documentation

Debug& Magnum::Trade::operator<<(Debug& debug, AbstractImporter::Feature value)
#include <Magnum/Trade/AbstractImporter.h>

Debug output operator.

Debug& Magnum::Trade::operator<<(Debug& debug, MaterialType value)
#include <Magnum/Trade/AbstractMaterialData.h>

Debug output operator.

Debug& Magnum::Trade::operator<<(Debug& debug, MaterialAlphaMode value)
#include <Magnum/Trade/AbstractMaterialData.h>

Debug output operator.

Debug& Magnum::Trade::operator<<(Debug& debug, AbstractMaterialData::Flag value)
#include <Magnum/Trade/AbstractMaterialData.h>

Debug output operator.

Debug& Magnum::Trade::operator<<(Debug& debug, AnimationTrackType value)
#include <Magnum/Trade/AnimationData.h>

Debug output operator.

Debug& Magnum::Trade::operator<<(Debug& debug, AnimationTrackTargetType value)
#include <Magnum/Trade/AnimationData.h>

Debug output operator.

#include <Magnum/Trade/AnimationData.h>
template<class V, class R = Animation::ResultOf<V>>
auto Magnum::Trade::animationInterpolatorFor(Animation::Interpolation interpolation)

Animation interpolator function for given interpolation behavior.

To be used from importer plugins — wrapper around Animation::interpolatorFor(), guaranteeing that the returned function pointer is not instantiated inside the plugin binary to avoid dangling function pointers on plugin unload.

Debug& Magnum::Trade::operator<<(Debug& debug, CameraType value)
#include <Magnum/Trade/CameraData.h>

Debug output operator.

Debug& Magnum::Trade::operator<<(Debug& debug, LightData::Type value)
#include <Magnum/Trade/LightData.h>

Debug output operator.

Debug& Magnum::Trade::operator<<(Debug& debug, ObjectInstanceType2D value)
#include <Magnum/Trade/ObjectData2D.h>

Debug output operator.

Debug& Magnum::Trade::operator<<(Debug& debug, ObjectFlag2D value)
#include <Magnum/Trade/ObjectData2D.h>

Debug output operator.

Debug& Magnum::Trade::operator<<(Debug& debug, ObjectFlags2D value)
#include <Magnum/Trade/ObjectData2D.h>

Debug output operator.

Debug& Magnum::Trade::operator<<(Debug& debug, ObjectInstanceType3D value)
#include <Magnum/Trade/ObjectData3D.h>

Debug output operator.

Debug& Magnum::Trade::operator<<(Debug& debug, ObjectFlag3D value)
#include <Magnum/Trade/ObjectData3D.h>

Debug output operator.

Debug& Magnum::Trade::operator<<(Debug& debug, ObjectFlags3D value)
#include <Magnum/Trade/ObjectData3D.h>

Debug output operator.

Debug& Magnum::Trade::operator<<(Debug& debug, PhongMaterialData::Flag value)
#include <Magnum/Trade/PhongMaterialData.h>

Debug output operator.

Debug& Magnum::Trade::operator<<(Debug& debug, TextureData::Type value)
#include <Magnum/Trade/TextureData.h>

Debug output operator.