FAssetData

A struct to hold important information about an assets found by the Asset Registry This struct is transient and should never be serialized

Choose your operating system:

Windows

macOS

Linux

References

Module

CoreUObject

Header

/Engine/Source/Runtime/CoreUObject/Public/AssetRegistry/AssetData.h

Include

#include "AssetRegistry/AssetData.h"

Syntax

struct FAssetData

Remarks

A struct to hold important information about an assets found by the Asset Registry This struct is transient and should never be serialized

Variables

Name Description

Public variable

FName

 

AssetClass

The name of the asset's class

Public variable

FName

 

AssetName

The name of the asset without the package

Public variable

TArray< int32, ...

 

ChunkIDs

The IDs of the pakchunks this asset is located in for streaming install.

Public variable

FName

 

ObjectPath

The object path for the asset in the form PackageName.ObjectName, or PackageName.ObjectName:SubObjectName.

Public variable

uint32

 

PackageFlags

Asset package flags

Public variable

FName

 

PackageName

The name of the package in which the asset is found, this is the full long package name such as /Game/Path/Package

Public variable

FName

 

PackagePath

The path to the package in which the asset is found, this is /Game/Path with the Package stripped off

Public variable

TSharedPtr< FAs...

 

TaggedAssetBundles

The 'AssetBundles' tag key is separated from TagsAndValues and typed for performance reasons.

Public variable

FAssetDataTagMa...

 

TagsAndValues

The map of values for properties that were marked AssetRegistrySearchable or added by GetAssetRegistryTags

Constructors

Name Description

Public function

FAssetData()

Default constructor

Public function

FAssetData

(
    const UObject* InAsset,
    FAssetData::ECreationFlags InCreati...
)

Constructor taking a UObject.

Public function

FAssetData

(
    const UObject* InAsset,
    bool bAllowBlueprintClass
)

Constructor taking a UObject.

Public function

FAssetData

(
    const FString& InLongPackageName,
    const FString& InObjectPath,
    FName InAssetClass,
    FAssetDataTagMap InTags,
    TArrayView< const int32 > InChunkID...,
    uint32 InPackageFlags
)

Constructor with a long package name and a full object path which might not be part of the package this asset is in.

Public function

FAssetData

(
    FName InPackageName,
    FName InPackagePath,
    FName InAssetName,
    FName InAssetClass,
    FAssetDataTagMap InTags,
    TArrayView< const int32 > InChunkID...,
    uint32 InPackageFlags
)

Constructor building the ObjectPath in the form of InPackageName.InAssetName.

Functions

Name Description

Public function Const

UObject *...

 

FastGetAsset

(
    bool bLoad
)

Returns the asset UObject if it is loaded or loads the asset if it is unloaded then returns the result

Public function Const

bool

 

FindTag

(
    const FName InTagName
)

Try to find the given tag

Public function Const

UObject *...

 

GetAsset()

Returns the asset UObject if it is loaded or loads the asset if it is unloaded then returns the result

Public function Const

UClass *

 

GetClass()

Returns the class UClass if it is loaded.

Public function Static

const TCHAR ...

 

GetCollectionTagPrefix()

The prefix used for collection entries inside TagsAndValues

Public function Const

void

 

GetExportTextName

(
    FStringBuilderBase& OutExportTextN...
)

Populates OutExportTextNameBuilder with the name for the asset in the form: Class'ObjectPath'

Public function Const

void

 

GetExportTextName

(
    FString& OutExportTextName
)

Populates OutExportTextName with the name for the asset in the form: Class'ObjectPath'

Public function Const

FString

 

GetExportTextName()

Returns the name for the asset in the form: Class'ObjectPath'

Public function Static

T *

 

GetFirstAsset

(
    const TArray< FAssetData >& Assets
)

Convenience template for finding first asset of a class

Public function Static

FAssetData

 

GetFirstAssetDataOfClass

(
    const TArray< FAssetData >& Assets,
    const UClass* DesiredClass
)

Get the first FAssetData of a particular class from an Array of FAssetData

Public function Const

FString

 

GetFullName()

Returns the full name for the asset in the form: Class ObjectPath

Public function Const

void

 

GetFullName

(
    FStringBuilderBase& OutFullNameBui...
)

Populates OutFullNameBuilder with the full name for the asset in the form: Class ObjectPath

Public function Const

void

 

GetFullName

(
    FString& OutFullName
)

Populates OutFullName with the full name for the asset in the form: Class ObjectPath

Public function Const

UPackage ...

 

GetPackage()

Public function Const

FPrimaryAsse...

 

GetPrimaryAssetId()

Gets primary asset id of this data

Public function Const

bool

 

GetTagValue

(
    FName Tag,
    FText& OutValue
)

Public function Const

bool

 

GetTagValue

(
    FName Tag,
    ValueType& OutValue
)

Try and get the value associated with the given tag as a type converted value

Public function Const

bool

 

GetTagValue

(
    FName Tag,
    FName& OutValue
)

Public function Const

bool

 

GetTagValue

(
    FName Tag,
    FString& OutValue
)

Public function Const

FString

 

GetTagValueRef

(
    FName Tag
)

Public function Const

ValueType

 

GetTagValueRef

(
    const FName Tag
)

Try and get the value associated with the given tag as a type converted value, or an empty value if it doesn't exist

Public function Const

FName

 

GetTagValueRef

(
    FName Tag
)

Public function Const

FAssetRegist...

 

GetTagValueRef

(
    FName Tag
)

Public function Const

FText

 

GetTagValueRef

(
    FName Tag
)

Public function Const

bool

 

HasAllPackageFlags

(
    uint32 FlagsToCheck
)

Used to check whether all of the passed flags are set in the cached asset package flags.

Public function Const

bool

 

HasAnyPackageFlags

(
    uint32 FlagsToCheck
)

Used to check whether the any of the passed flags are set in the cached asset package flags.

Public function Const

bool

 

IsAssetLoaded()

Returns true if the asset is loaded

Public function Const

bool

 

IsRedirector()

Returns true if the this asset is a redirector.

Public function Static

bool

 

IsRedirector

(
    UObject* Object
)

Public function Const

bool

 

IsTopLevelAsset()

Returns true iff the Asset is a TopLevelAsset (not a subobject, its outer is a UPackage).

Public function Static

bool

 

IsTopLevelAsset

(
    UObject* Object
)

Returns true iff the given Object, assumed to be an Asset, is a TopLevelAsset (not a subobject, its outer is a UPackage).

Public function Static

bool

 

IsUAsset

(
    UObject* Object
)

Returns true if the given UObject is the main asset in a package, true for maps and assets but false for secondary objects like class redirectors Every UAsset is also a TopLevelAsset.

Public function Const

bool

 

IsUAsset()

Returns true if this is the main asset in a package, true for maps and assets but false for secondary objects like class redirectors Every UAsset is also a TopLevelAsset.

Public function Const

bool

 

IsValid()

Checks to see if this AssetData refers to an asset or is NULL

Public function Const

void

 

PrintAssetData()

Prints the details of the asset to the log

Public function

void

 

SerializeForCache

(
    Archive&& Ar
)

Serialize as part of the registry cache.

Public function

void

 

SetTagsAndAssetBundles

(
    FAssetDataTagMap&& Tags
)

Public function

void

 

Shrink()

Public function Const

FSoftObjectP...

 

ToSoftObjectPath()

Convert to a SoftObjectPath for loading

Operators

Name Description

Public function Const

bool

 

operator!=

(
    const FAssetData& Other
)

Public function Const

bool

 

operator<

(
    const FAssetData& Other
)

Public function Const

bool

 

operator==

(
    const FAssetData& Other
)

FAssetDatas are equal if their object paths match

Public function Const

bool

 

operator>

(
    const FAssetData& Other
)

Enums

Name

Description

Public enum

ECreationFlags

Deprecated Functions

Name Description

Public function Const

FSoftObjectP...

 

ToStringReference()

ToStringReference was renamed to ToSoftObjectPath