Classes
class	AbstractFile
class	BlendFile
	Reference to a blend file that can be indexed. More...
struct	AssetLibraryIndex
	References the asset library directory. More...
struct	AssetIndex
class	AssetIndexFile

Functions
constexpr StringRef	ATTRIBUTE_VERSION ("version")
	Indexer for asset libraries.
constexpr StringRef	ATTRIBUTE_ENTRIES ("entries")
constexpr StringRef	ATTRIBUTE_ENTRIES_NAME ("name")
constexpr StringRef	ATTRIBUTE_ENTRIES_CATALOG_ID ("catalog_id")
constexpr StringRef	ATTRIBUTE_ENTRIES_CATALOG_NAME ("catalog_name")
constexpr StringRef	ATTRIBUTE_ENTRIES_DESCRIPTION ("description")
constexpr StringRef	ATTRIBUTE_ENTRIES_AUTHOR ("author")
constexpr StringRef	ATTRIBUTE_ENTRIES_COPYRIGHT ("copyright")
constexpr StringRef	ATTRIBUTE_ENTRIES_LICENSE ("license")
constexpr StringRef	ATTRIBUTE_ENTRIES_TAGS ("tags")
constexpr StringRef	ATTRIBUTE_ENTRIES_PROPERTIES ("properties")
static void	add_id_name (DictionaryValue &result, const short idcode, const StringRefNull name)
	add id + name to the attributes.
static void	init_value_from_file_indexer_entry (DictionaryValue &result, const FileIndexerEntry *indexer_entry)
static void	init_value_from_file_indexer_entries (DictionaryValue &result, const FileIndexerEntries &indexer_entries)
static void	init_indexer_entry_from_value (FileIndexerEntry &indexer_entry, const DictionaryValue &entry)
static int	init_indexer_entries_from_value (FileIndexerEntries &indexer_entries, const DictionaryValue &value)
static eFileIndexerResult	read_index (const char filename, FileIndexerEntries entries, int r_read_entries_len, void user_data)
static void	update_index (const char filename, FileIndexerEntries entries, void *user_data)
static void *	init_user_data (const char *root_directory, size_t root_directory_maxncpy)
static void	free_user_data (void *user_data)
static void	filelist_finished (void *user_data)
constexpr FileIndexerType	asset_indexer ()

Variables
const FileIndexerType	file_indexer_asset = asset_indexer()

Function Documentation

◆ add_id_name()

void blender::ed::asset::index::add_id_name	(	DictionaryValue &	result,
		const short	idcode,
		const StringRefNull	name )

static

add id + name to the attributes.

NOTE: id and name are encoded like ID.name

Definition at line 143 of file asset_indexer.cc.

References ATTRIBUTE_ENTRIES_NAME(), name, and result.

Referenced by init_value_from_file_indexer_entry().

◆ asset_indexer()

FileIndexerType blender::ed::asset::index::asset_indexer ( )

constexpr

Definition at line 742 of file asset_indexer.cc.

References filelist_finished(), FileIndexerType::filelist_finished, free_user_data(), FileIndexerType::free_user_data, init_user_data(), FileIndexerType::init_user_data, read_index(), FileIndexerType::read_index, update_index(), and FileIndexerType::update_index.

◆ ATTRIBUTE_ENTRIES()

StringRef blender::ed::asset::index::ATTRIBUTE_ENTRIES ( "entries" )

constexpr

Referenced by init_indexer_entries_from_value(), and init_value_from_file_indexer_entries().

◆ ATTRIBUTE_ENTRIES_AUTHOR()

StringRef blender::ed::asset::index::ATTRIBUTE_ENTRIES_AUTHOR ( "author" )

constexpr

Referenced by init_indexer_entry_from_value(), and init_value_from_file_indexer_entry().

◆ ATTRIBUTE_ENTRIES_CATALOG_ID()

StringRef blender::ed::asset::index::ATTRIBUTE_ENTRIES_CATALOG_ID ( "catalog_id" )

constexpr

Referenced by init_indexer_entry_from_value(), and init_value_from_file_indexer_entry().

◆ ATTRIBUTE_ENTRIES_CATALOG_NAME()

StringRef blender::ed::asset::index::ATTRIBUTE_ENTRIES_CATALOG_NAME ( "catalog_name" )

constexpr

Referenced by init_indexer_entry_from_value(), and init_value_from_file_indexer_entry().

◆ ATTRIBUTE_ENTRIES_COPYRIGHT()

StringRef blender::ed::asset::index::ATTRIBUTE_ENTRIES_COPYRIGHT ( "copyright" )

constexpr

Referenced by init_indexer_entry_from_value(), and init_value_from_file_indexer_entry().

◆ ATTRIBUTE_ENTRIES_DESCRIPTION()

StringRef blender::ed::asset::index::ATTRIBUTE_ENTRIES_DESCRIPTION ( "description" )

constexpr

Referenced by init_indexer_entry_from_value(), and init_value_from_file_indexer_entry().

◆ ATTRIBUTE_ENTRIES_LICENSE()

StringRef blender::ed::asset::index::ATTRIBUTE_ENTRIES_LICENSE ( "license" )

constexpr

Referenced by init_indexer_entry_from_value(), and init_value_from_file_indexer_entry().

◆ ATTRIBUTE_ENTRIES_NAME()

StringRef blender::ed::asset::index::ATTRIBUTE_ENTRIES_NAME ( "name" )

constexpr

Referenced by add_id_name(), and init_indexer_entry_from_value().

◆ ATTRIBUTE_ENTRIES_PROPERTIES()

StringRef blender::ed::asset::index::ATTRIBUTE_ENTRIES_PROPERTIES ( "properties" )

constexpr

Referenced by init_indexer_entry_from_value(), and init_value_from_file_indexer_entry().

◆ ATTRIBUTE_ENTRIES_TAGS()

StringRef blender::ed::asset::index::ATTRIBUTE_ENTRIES_TAGS ( "tags" )

constexpr

Referenced by init_indexer_entry_from_value(), and init_value_from_file_indexer_entry().

◆ ATTRIBUTE_VERSION()

StringRef blender::ed::asset::index::ATTRIBUTE_VERSION ( "version" )

constexpr

Indexer for asset libraries.

Indexes are stored per input file. Each index can contain zero to multiple asset entries. The indexes are grouped together per asset library. They are stored in BKE_appdir_folder_caches + /asset-library-indices/<asset-library-hash>/<asset-index-hash>_<asset_file>.index.json.

The structure of an index file is

{
  "version": <file version number>,
  "entries": [{
    "name": "<asset name>",
    "catalog_id": "<catalog_id>",
    "catalog_name": "<catalog_name>",
    "description": "<description>",
    "author": "<author>",
    "copyright": "<copyright>",
    "license": "<license>",
    "tags": ["<tag>"],
    "properties": [..]
  }]
}

NOTE: entries, author, description, copyright, license, tags and properties are optional attributes.

NOTE: File browser uses name and idcode separate. Inside the index they are joined together like ID.name. NOTE: File browser group name isn't stored in the index as it is a translatable name.

Referenced by blender::ed::asset::index::AssetIndex::AssetIndex(), and blender::ed::asset::index::AssetIndex::get_version().

◆ filelist_finished()

void blender::ed::asset::index::filelist_finished ( void * user_data )

static

Definition at line 733 of file asset_indexer.cc.

References CLOG_INFO, LOG, and blender::ed::asset::index::AssetLibraryIndex::remove_unused_index_files().

Referenced by asset_indexer().

◆ free_user_data()

void blender::ed::asset::index::free_user_data ( void * user_data )

static

Definition at line 728 of file asset_indexer.cc.

Referenced by asset_indexer().

◆ init_indexer_entries_from_value()

int blender::ed::asset::index::init_indexer_entries_from_value	(	FileIndexerEntries &	indexer_entries,
		const DictionaryValue &	value )

static

Definition at line 258 of file asset_indexer.cc.

References ATTRIBUTE_ENTRIES(), BLI_assert, BLI_linklist_prepend(), element, blender::io::serialize::ArrayValue::elements(), FileIndexerEntries::entries, init_indexer_entry_from_value(), blender::io::serialize::DictionaryValue::lookup_array(), and MEM_callocN().

Referenced by blender::ed::asset::index::AssetIndex::extract_into().

◆ init_indexer_entry_from_value()

void blender::ed::asset::index::init_indexer_entry_from_value	(	FileIndexerEntry &	indexer_entry,
		const DictionaryValue &	entry )

static

Definition at line 215 of file asset_indexer.cc.

Referenced by init_indexer_entries_from_value().

◆ init_user_data()

void * blender::ed::asset::index::init_user_data	(	const char *	root_directory,
		size_t	root_directory_maxncpy )

static

Definition at line 719 of file asset_indexer.cc.

References BLI_strnlen(), blender::ed::asset::index::AssetLibraryIndex::collect_preexisting_file_indices(), and blender::ed::asset::index::AssetLibraryIndex::remove_broken_index_files().

Referenced by asset_indexer().

◆ init_value_from_file_indexer_entries()

void blender::ed::asset::index::init_value_from_file_indexer_entries	(	DictionaryValue &	result,
		const FileIndexerEntries &	indexer_entries )

static

Definition at line 191 of file asset_indexer.cc.

References BLODataBlockInfo::asset_data, ATTRIBUTE_ENTRIES(), FileIndexerEntry::datablock_info, FileIndexerEntries::entries, init_value_from_file_indexer_entry(), LinkNode::next, and result.

Referenced by blender::ed::asset::index::AssetIndex::AssetIndex().

◆ init_value_from_file_indexer_entry()

void blender::ed::asset::index::init_value_from_file_indexer_entry	(	DictionaryValue &	result,
		const FileIndexerEntry *	indexer_entry )

static

Definition at line 153 of file asset_indexer.cc.

References add_id_name(), blender::io::serialize::ArrayValue::append_str(), BLODataBlockInfo::asset_data, ATTRIBUTE_ENTRIES_AUTHOR(), ATTRIBUTE_ENTRIES_CATALOG_ID(), ATTRIBUTE_ENTRIES_CATALOG_NAME(), ATTRIBUTE_ENTRIES_COPYRIGHT(), ATTRIBUTE_ENTRIES_DESCRIPTION(), ATTRIBUTE_ENTRIES_LICENSE(), ATTRIBUTE_ENTRIES_PROPERTIES(), ATTRIBUTE_ENTRIES_TAGS(), AssetMetaData::author, BLI_listbase_is_empty(), AssetMetaData::catalog_id, AssetMetaData::catalog_simple_name, blender::bke::idprop::convert_to_serialize_values(), AssetMetaData::copyright, FileIndexerEntry::datablock_info, AssetMetaData::description, FileIndexerEntry::idcode, AssetMetaData::license, LISTBASE_FOREACH, BLODataBlockInfo::name, AssetMetaData::properties, result, blender::bUUID::str(), and AssetMetaData::tags.

Referenced by init_value_from_file_indexer_entries().

◆ read_index()

eFileIndexerResult blender::ed::asset::index::read_index	(	const char *	filename,
		FileIndexerEntries *	entries,
		int *	r_read_entries_len,
		void *	user_data )

static

Definition at line 647 of file asset_indexer.cc.

References CLOG_DEBUG, CLOG_INFO, blender::ed::asset::index::AssetIndexFile::constains_entries(), blender::ed::asset::index::AssetIndex::CURRENT_VERSION, blender::ed::asset::index::AbstractFile::exists(), FILE_INDEXER_ENTRIES_LOADED, FILE_INDEXER_NEEDS_UPDATE, blender::ed::asset::index::AssetIndexFile::filename, blender::ed::asset::index::AssetIndexFile::is_older_than(), LOG, blender::ed::asset::index::AssetIndexFile::mark_as_used(), and blender::ed::asset::index::AssetIndexFile::read_contents().

Referenced by asset_indexer().

◆ update_index()

void blender::ed::asset::index::update_index	(	const char *	filename,
		FileIndexerEntries *	entries,
		void *	user_data )

static

Definition at line 705 of file asset_indexer.cc.

References CLOG_INFO, blender::ed::asset::index::AssetIndexFile::get_file_path(), blender::ed::asset::index::BlendFile::get_file_path(), LOG, and blender::ed::asset::index::AssetIndexFile::write_contents().

Referenced by asset_indexer().

Variable Documentation

◆ file_indexer_asset

const FileIndexerType blender::ed::asset::index::file_indexer_asset = asset_indexer()

File Indexer Service for indexing asset files.

Opening and parsing a large collection of asset files inside a library can take a lot of time. To reduce the time it takes the files are indexed.

Index files are created for each blend file in the asset library, even when the blend file doesn't contain any assets.
Indexes are stored in an persistent cache folder (BKE_appdir_folder_caches + asset_library_indexes/{asset_library_dir}/{asset_index_file.json}).
The content of the indexes are used when:
- Index exists and can be opened
- Last modification date is earlier than the file it represents.
- The index file version is the latest.
Blend files without any assets can be determined by the size of the index file for some additional performance.

Definition at line 753 of file asset_indexer.cc.

Referenced by file_refresh(), and blender::ed::asset::list::AssetList::setup().

Classes

Functions

Variables

Function Documentation

◆ add_id_name()

◆ asset_indexer()

◆ ATTRIBUTE_ENTRIES()

◆ ATTRIBUTE_ENTRIES_AUTHOR()

◆ ATTRIBUTE_ENTRIES_CATALOG_ID()

◆ ATTRIBUTE_ENTRIES_CATALOG_NAME()

◆ ATTRIBUTE_ENTRIES_COPYRIGHT()

◆ ATTRIBUTE_ENTRIES_DESCRIPTION()

◆ ATTRIBUTE_ENTRIES_LICENSE()

◆ ATTRIBUTE_ENTRIES_NAME()

◆ ATTRIBUTE_ENTRIES_PROPERTIES()

◆ ATTRIBUTE_ENTRIES_TAGS()

◆ ATTRIBUTE_VERSION()

◆ filelist_finished()

◆ free_user_data()

◆ init_indexer_entries_from_value()

◆ init_indexer_entry_from_value()

◆ init_user_data()

◆ init_value_from_file_indexer_entries()

◆ init_value_from_file_indexer_entry()

◆ read_index()

◆ update_index()

Variable Documentation

◆ file_indexer_asset