xiiAssetDocumentGenerator Class Reference

Provides functionality for importing files as asset documents. More...

#include <AssetDocumentGenerator.h>

Inheritance diagram for xiiAssetDocumentGenerator:

Classes
struct	ImportMode
	Describes one option to import an asset. More...

Public Member Functions
xiiStatus	Import (xiiStringView sInputFileAbs, xiiStringView sMode, bool bOpenDocument)
	Imports the given file with the mode. Must be a mode that the generator supports.
virtual void	GetImportModes (xiiStringView sAbsInputFile, xiiDynamicArray< ImportMode > &out_modes) const =0
	Used to fill out which import modes may be available for the given asset.
virtual xiiStringView	GetDocumentExtension () const =0
	Returns the target asset document file extension.
virtual xiiStringView	GetGeneratorGroup () const =0
	Allows to merge the import modes of multiple generators in the UI in one group.
virtual xiiStatus	Generate (xiiStringView sInputFileAbs, xiiStringView sMode, xiiDynamicArray< xiiDocument * > &out_generatedDocuments)=0
	Tells the generator to create a new asset document with the chosen mode.
bool	SupportsFileType (xiiStringView sFile) const
	Returns whether this generator supports the given file type for import.
Public Member Functions inherited from xiiReflectedClass
virtual const xiiRTTI *	GetDynamicRTTI () const
bool	IsInstanceOf (const xiiRTTI *pType) const
	Returns whether the type of this instance is of the given type or derived from it.
template<typename T>
XII_ALWAYS_INLINE bool	IsInstanceOf () const
	Returns whether the type of this instance is of the given type or derived from it.

Static Public Member Functions
static void	GetSupportsFileTypes (xiiSet< xiiString > &out_extensions)
	Creates a list of all importable file extensions. Note that this is an expensive function so the the result should be cached.
static void	ImportAssets ()
	Opens a file browse dialog to let the user choose which files to import.
static void	ImportAssets (const xiiDynamicArray< xiiString > &filesToImport)
	Opens the "Asset Import" dialog to let the user choose how to import the given files.
static void	CreateGenerators (xiiHybridArray< xiiAssetDocumentGenerator *, 16 > &out_generators)
	Instantiates all currently available generators.
static void	DestroyGenerators (const xiiHybridArray< xiiAssetDocumentGenerator *, 16 > &generators)
	Destroys the previously instantiated generators.
Static Public Member Functions inherited from xiiNoBase
static const xiiRTTI *	GetStaticRTTI ()

Protected Member Functions
void	AddSupportedFileType (xiiStringView sExtension)

Friends
class	xiiQtAssetImportDlg

Detailed Description

Provides functionality for importing files as asset documents.

Derived from this class to add a custom importer (see existing derived classes for examples). Each importer typically handles one target asset type.

Member Function Documentation

Generate()

virtual xiiStatus xiiAssetDocumentGenerator::Generate ( xiiStringView sInputFileAbs, xiiStringView sMode, xiiDynamicArray< xiiDocument * > & out_generatedDocuments )

pure virtual

Tells the generator to create a new asset document with the chosen mode.

Implemented in xiiAnimatedMeshAssetDocumentGenerator, xiiAnimationClipAssetDocumentGenerator, xiiDecalAssetDocumentGenerator, xiiLUTAssetDocumentGenerator, xiiMeshAssetDocumentGenerator, xiiSkeletonAssetDocumentGenerator, xiiTextureAssetDocumentGenerator, and xiiTextureCubeAssetDocumentGenerator.

GetDocumentExtension()

virtual xiiStringView xiiAssetDocumentGenerator::GetDocumentExtension ( ) const

pure virtual

Returns the target asset document file extension.

Implemented in xiiAnimatedMeshAssetDocumentGenerator, xiiAnimationClipAssetDocumentGenerator, xiiDecalAssetDocumentGenerator, xiiLUTAssetDocumentGenerator, xiiMeshAssetDocumentGenerator, xiiSkeletonAssetDocumentGenerator, xiiTextureAssetDocumentGenerator, and xiiTextureCubeAssetDocumentGenerator.

GetGeneratorGroup()

virtual xiiStringView xiiAssetDocumentGenerator::GetGeneratorGroup ( ) const

pure virtual

Allows to merge the import modes of multiple generators in the UI in one group.

Implemented in xiiAnimatedMeshAssetDocumentGenerator, xiiAnimationClipAssetDocumentGenerator, xiiDecalAssetDocumentGenerator, xiiLUTAssetDocumentGenerator, xiiMeshAssetDocumentGenerator, xiiSkeletonAssetDocumentGenerator, xiiTextureAssetDocumentGenerator, and xiiTextureCubeAssetDocumentGenerator.

GetImportModes()

virtual void xiiAssetDocumentGenerator::GetImportModes ( xiiStringView sAbsInputFile, xiiDynamicArray< ImportMode > & out_modes ) const

pure virtual

Used to fill out which import modes may be available for the given asset.

Note: sAbsInputFile may be empty, in this case it should fill out the array for "general purpose" import (any file of the supported types).

Implemented in xiiAnimatedMeshAssetDocumentGenerator, xiiAnimationClipAssetDocumentGenerator, xiiDecalAssetDocumentGenerator, xiiLUTAssetDocumentGenerator, xiiMeshAssetDocumentGenerator, xiiSkeletonAssetDocumentGenerator, xiiTextureAssetDocumentGenerator, and xiiTextureCubeAssetDocumentGenerator.

GetSupportsFileTypes()

void xiiAssetDocumentGenerator::GetSupportsFileTypes ( xiiSet< xiiString > & out_extensions )

static

Creates a list of all importable file extensions. Note that this is an expensive function so the the result should be cached.

Parameters

out_Extensions

List of all file extensions that can be imported.

ImportAssets()

void xiiAssetDocumentGenerator::ImportAssets ( )

static

Opens a file browse dialog to let the user choose which files to import.

After the user chose one or multiple files, opens the "Asset Import" dialog to let them choose details.

---

The documentation for this class was generated from the following files:

• /home/runner/work/XII/XII/Source/Editor/EditorFramework/Assets/AssetDocumentGenerator.h
• /home/runner/work/XII/XII/Source/Editor/EditorFramework/Assets/Implementation/AssetDocumentGenerator.cpp