1. Epic GamesDeveloper
  3. UFactory

UFactory

Base class for all factories An object responsible for creating and importing new objects.

Unreal Engine C++ API Reference > Editor > UnrealEd > Factories

Inheritance Hierarchy

References

   
Module UnrealEd
Header /Engine/Source/Editor/UnrealEd/Classes/Factories/Factory.h
Include #include "Factories/Factory.h"

Syntax

UCLASS (Abstract, MinimalAPI)  
class UFactory : public UObject

Remarks

Base class for all factories An object responsible for creating and importing new objects.

Variables

  Type Name Description
Protected variable TArray< UObject * > AdditionalImportedObjects  
Public variable UProperty Category BlueprintReadWrite TObjectPtr< class UAssetImportTask > AssetImportTask Task for importing file via script interfaces
Public variable UProperty Category BlueprintReadWrite TObjectPtr< const class UAutomatedAssetImportData > AutomatedImportData Data for how to import files via the automated command line importing interface
Protected variable UProperty Category BlueprintReadWrite uint32: 1 bCreateNew The default value to return from CanCreateNew()
Public variable UProperty Category BlueprintReadWrite uint32: 1 bEditAfterNew True if the associated editor should be opened after creating a new object.
Public variable UProperty Category BlueprintReadWrite uint32: 1 bEditorImport True if the factory imports objects from files.
Public variable UProperty Category BlueprintReadWrite uint32: 1 bText True if the factory imports objects from text.
Public variable UProperty Category BlueprintReadWrite TSubclassOf< UObject > ContextClass Class of the context object used to help create the object.
Public variable UProperty Category BlueprintReadWrite TArray< FString > Formats List of formats supported by the factory.
Public variable UProperty int32 ImportPriority Determines the order in which factories are tried when importing or reimporting an object.
Protected variable UProperty int32 OverwriteYesOrNoToAllState For interactive object imports, this value indicates whether the user wants objects to be automatically overwritten (See EAppReturnType), or -1 if the user should be prompted.
Public variable UProperty Category BlueprintReadWrite TSubclassOf< UObject > SupportedClass The class manufactured by this factory.

Constructors

  Type Name Description
Public function  

UFactory ( const FObjectInitializer& ObjectInitializer
)

  

Functions

  Type Name Description
Public function Static void  
Public function Virtual Const bool  
Public function Virtual Const bool Whether the factory is checking for SlowTask::ShouldCancel() while importing and aborting the import when appropriate.
Public function Virtual void

CleanUp ()

 Do clean up after importing is done. Will be called once for multi batch import.
Public function Virtual bool Opens a dialog to configure the factory properties.
Public function Const UObject *

CreateOrOverwriteAsset ( UClass* InClass,
UObject* InParent,
FName InName,
EObjectFlags InFlags,
UObject* InTemplate
)

 Creates an asset if it doesn't exist.
Public function void Pop up message to the user asking whether they wish to overwrite existing state or not.
Public function Virtual bool  
Public function Virtual bool

FactoryCanImport ( const FString& Filename
)

 Whether the specified file can be imported by this factory.
Protected function Virtual UObject *

FactoryCreateBinary ( UClass* InClass,
UObject* InParent,
FName InName,
EObjectFlags Flags,
UObject* Context,
const TCHAR* Type,
const uint8*& Buffer,
const uint8* BufferEnd,
FFeedbackContext* Warn,
bool& bOutOperationCanceled
)

 Create a new object by importing it from a binary buffer (cancelable).
Protected function Virtual UObject *

FactoryCreateBinary ( UClass* InClass,
UObject* InParent,
FName InName,
EObjectFlags Flags,
UObject* Context,
const TCHAR* Type,
const uint8*& Buffer,
const uint8* BufferEnd,
FFeedbackContext* Warn
)

 Create a new object by importing it from a binary buffer.
Public function Virtual UObject *

FactoryCreateFile ( UClass* InClass,
UObject* InParent,
FName InName,
EObjectFlags Flags,
const FString& Filename,
const TCHAR* Parms,
FFeedbackContext* Warn,
bool& bOutOperationCanceled
)

 Create a new object by importing it from a file name.
Public function Virtual UObject *

FactoryCreateNew ( UClass* InClass,
UObject* InParent,
FName InName,
EObjectFlags Flags,
UObject* Context,
FFeedbackContext* Warn
)

 Create a new object by class.
Public function Virtual UObject *

FactoryCreateNew ( UClass* InClass,
UObject* InParent,
FName InName,
EObjectFlags Flags,
UObject* Context,
FFeedbackContext* Warn,
FName CallingContext
)

 Create a new object by class.
Protected function Virtual UObject *

FactoryCreateText ( UClass* InClass,
UObject* InParent,
FName InName,
EObjectFlags Flags,
UObject* Context,
const TCHAR* Type,
const TCHAR*& Buffer,
const TCHAR* BufferEnd,
FFeedbackContext* Warn
)

 Create a new object by importing it from a text buffer.
Protected function Virtual UObject *

FactoryCreateText ( UClass* InClass,
UObject* InParent,
FName InName,
EObjectFlags Flags,
UObject* Context,
const TCHAR* Type,
const TCHAR*& Buffer,
const TCHAR* BufferEnd,
FFeedbackContext* Warn,
bool& bOutOperationCanceled
)

 Create a new object by importing it from a text buffer.
Public function Const const TArray< UObject * > & Returns an array of all the additional objects created during the last imports, as some factories may produce more than one object.
Public function Static FString Get the name of the file currently being imported.
Public function Static int32 Get the default import priority for factories.
Public function Virtual Const FString Returns a new starting point name for newly created assets in the content browser
Public function Virtual Const FText Returns the name of the factory for menus
Public function Static FMD5Hash Get the Hash for the file being imported.
Public function Virtual Const TArray< FString >  
Public function Virtual IImportSettingsParser *  
Public function Virtual Const uint32 When shown in menus, this is the category containing this factory.
Public function Virtual Const const TArray< FText > & Branch of sub-menus containing factory under each provided category.
Public function Virtual Const FName Returns an optional override brush name for the new asset menu.
Public function Const UClass *  
Public function Virtual Const void

GetSupportedFileExtensions ( TArray< FString >& OutExtensions
)

 Creates a list of file extensions supported by this factory
Public function Virtual Const FText Returns the tooltip text description of this factory
Public function Virtual Const FString Returns the documentation excerpt that should be use for the rich tool tip for this factory
Public function Virtual Const FString Returns the documentation page that should be use for the rich tool tip for this factory
Public function Virtual UObject *

ImportObject ( UClass* InClass,
UObject* InOuter,
FName InName,
EObjectFlags Flags,
const FString& Filename,
const TCHAR* Parms,
bool& OutCanceled
)

  
Public function Virtual bool

ImportUntypedBulkDataFromText ( const TCHAR*& Buffer,
FBulkData& BulkData
)

  
Public function Virtual Const bool  
Public function Virtual Const bool Returns true if the provided file extension is supported
Public function void Resets the saved state of this factory.
Public function Virtual UClass * Resolves SupportedClass for factories which support multiple classes.
Public function UFunction Category, BlueprintImplementableEvent bool

ScriptFactoryCanImport ( const FString& Filename
)

 Whether the specified file can be imported by this factory. (Implemented in script)
Public function UFunction Category, BlueprintImplementableEvent bool Import object(s) using a task via script
Public function void Sets the import task being used with this factory
Public function void Sets the automated import data being used with this factory
Public function Virtual Const bool Returns true if this factory should be shown in the New Asset menu (by default calls CanCreateNew).
Public function Static bool

SortFactoriesByPriority ( const UFactory& A,
const UFactory& B
)

 Helper function to sort an array of factories by their import priority - use as a predicate for Sort
Public function Static UObject *

StaticImportObject ( UClass* Class,
UObject* InOuter,
FName Name,
EObjectFlags Flags,
bool& bOutOperationCanceled,
const TCHAR* Filename,
UObject* Context,
UFactory* Factory,
const TCHAR* Parms,
FFeedbackContext* Warn,
int32 MaxImportFileSize
)

  
Public function Static UObject *

StaticImportObject ( UClass* Class,
UObject* InOuter,
FName Name,
EObjectFlags Flags,
const TCHAR* Filename,
UObject* Context,
UFactory* Factory,
const TCHAR* Parms,
FFeedbackContext* Warn,
int32 MaxImportFileSize
)

  

Constants

Name Description
CurrentFilename Name of the file currently being imported.
DefaultImportPriority This is the import priority that all factories are given in the default constructor.
FileHash This is the HASH for the file being imported

Ask questions and help your peers Developer Forums

Write your own tutorials or read those from others Learning Library

On this page
Back to top
Games
Marketplaces
Tools
Online Services
Resources
Company

© 2004-2025, Epic Games, Inc. All rights reserved. Unreal and its logo are Epic’s trademarks or registered trademarks in the US and elsewhere.