#include <cstring>
#include "MEM_guardedalloc.h"
#include "BLI_fileops.h"
#include "BLI_listbase.h"
#include "BLI_path_utils.hh"
#include "BLI_string.h"
#include "BLI_string_utf8.h"
#include "BLI_string_utils.hh"
#include "BKE_appdir.hh"
#include "BKE_asset.hh"
#include "BKE_preferences.h"
#include "BLT_translation.hh"
#include "BLO_read_write.hh"
#include "DNA_asset_types.h"
#include "DNA_defaults.h"
#include "DNA_userdef_types.h"

Macros
#define	U BLI_STATIC_ASSERT(false, "Global 'U' not allowed, only use arguments passed in!")

Functions
Asset Libraries
bUserAssetLibrary *	BKE_preferences_asset_library_add (UserDef userdef, const char name, const char *dirpath)

void	BKE_preferences_asset_library_remove (UserDef userdef, bUserAssetLibrary library)

void	BKE_preferences_asset_library_name_set (UserDef userdef, bUserAssetLibrary library, const char *name)

void	BKE_preferences_asset_library_path_set (bUserAssetLibrary library, const char path)

bUserAssetLibrary *	BKE_preferences_asset_library_find_index (const UserDef *userdef, int index)

bUserAssetLibrary *	BKE_preferences_asset_library_find_by_name (const UserDef userdef, const char name)

bUserAssetLibrary *	BKE_preferences_asset_library_containing_path (const UserDef userdef, const char path)

int	BKE_preferences_asset_library_get_index (const UserDef userdef, const bUserAssetLibrary library)

void	BKE_preferences_asset_library_default_add (UserDef *userdef)

Extension Repositories
static size_t	strncpy_py_module (char dst, const char src, const size_t dst_maxncpy)

bUserExtensionRepo *	BKE_preferences_extension_repo_add (UserDef userdef, const char name, const char module, const char custom_dirpath)

void	BKE_preferences_extension_repo_remove (UserDef userdef, bUserExtensionRepo repo)

bUserExtensionRepo *	BKE_preferences_extension_repo_add_default_remote (UserDef *userdef)

bUserExtensionRepo *	BKE_preferences_extension_repo_add_default_user (UserDef *userdef)

bUserExtensionRepo *	BKE_preferences_extension_repo_add_default_system (UserDef *userdef)

void	BKE_preferences_extension_repo_add_defaults_all (UserDef *userdef)

void	BKE_preferences_extension_repo_name_set (UserDef userdef, bUserExtensionRepo repo, const char *name)

void	BKE_preferences_extension_repo_module_set (UserDef userdef, bUserExtensionRepo repo, const char *module)

bool	BKE_preferences_extension_repo_module_is_valid (const bUserExtensionRepo *repo)

void	BKE_preferences_extension_repo_custom_dirpath_set (bUserExtensionRepo repo, const char path)

size_t	BKE_preferences_extension_repo_dirpath_get (const bUserExtensionRepo repo, char dirpath, const int dirpath_maxncpy)

size_t	BKE_preferences_extension_repo_user_dirpath_get (const bUserExtensionRepo repo, char dirpath, const int dirpath_maxncpy)

bUserExtensionRepo *	BKE_preferences_extension_repo_find_index (const UserDef *userdef, int index)

bUserExtensionRepo *	BKE_preferences_extension_repo_find_by_module (const UserDef userdef, const char module)

static bool	url_char_is_delimiter (const char ch)

bUserExtensionRepo *	BKE_preferences_extension_repo_find_by_remote_url_prefix (const UserDef userdef, const char remote_url_full, const bool only_enabled)

int	BKE_preferences_extension_repo_remote_scheme_end (const char *url)

void	BKE_preferences_extension_remote_to_name (const char *remote_url, char name[sizeof(bUserExtensionRepo::name)])

int	BKE_preferences_extension_repo_get_index (const UserDef userdef, const bUserExtensionRepo repo)

void	BKE_preferences_extension_repo_read_data (BlendDataReader reader, bUserExtensionRepo repo)

void	BKE_preferences_extension_repo_write_data (BlendWriter writer, const bUserExtensionRepo repo)

#bUserAssetShelfSettings
static bUserAssetShelfSettings *	asset_shelf_settings_new (UserDef userdef, const char shelf_idname)

static bUserAssetShelfSettings *	asset_shelf_settings_ensure (UserDef userdef, const char shelf_idname)

bUserAssetShelfSettings *	BKE_preferences_asset_shelf_settings_get (const UserDef userdef, const char shelf_idname)

bool	BKE_preferences_asset_shelf_settings_is_catalog_path_enabled (const UserDef userdef, const char shelf_idname, const char *catalog_path)

bool	BKE_preferences_asset_shelf_settings_ensure_catalog_path_enabled (UserDef userdef, const char shelf_idname, const char *catalog_path)

Detailed Description

User defined asset library API.

Definition in file preferences.cc.

Macro Definition Documentation

◆ U

#define U BLI_STATIC_ASSERT(false, "Global 'U' not allowed, only use arguments passed in!")

Definition at line 34 of file preferences.cc.

Function Documentation

◆ asset_shelf_settings_ensure()

static bUserAssetShelfSettings * asset_shelf_settings_ensure	(	UserDef *	userdef,
		const char *	shelf_idname )

static

Definition at line 537 of file preferences.cc.

References asset_shelf_settings_new(), and BKE_preferences_asset_shelf_settings_get().

Referenced by BKE_preferences_asset_shelf_settings_ensure_catalog_path_enabled().

◆ asset_shelf_settings_new()

static bUserAssetShelfSettings * asset_shelf_settings_new	(	UserDef *	userdef,
		const char *	shelf_idname )

static

Definition at line 527 of file preferences.cc.

References UserDef::asset_shelves_settings, BLI_addtail(), BLI_assert, BLI_listbase_is_empty(), DNA_struct_default_alloc, and STRNCPY.

Referenced by asset_shelf_settings_ensure().

◆ BKE_preferences_asset_library_add()

bUserAssetLibrary * BKE_preferences_asset_library_add	(	UserDef *	userdef,
		const char *	name,
		const char *	dirpath )

Definition at line 40 of file preferences.cc.

References UserDef::asset_libraries, BKE_preferences_asset_library_name_set(), BLI_addtail(), bUserAssetLibrary::dirpath, DNA_struct_default_alloc, and STRNCPY.

Referenced by BKE_preferences_asset_library_default_add(), preferences_asset_library_add_exec(), and blender::asset_system::tests::AssetCatalogTest::save_from_memory_into_existing_asset_lib().

◆ BKE_preferences_asset_library_containing_path()

bUserAssetLibrary * BKE_preferences_asset_library_containing_path	(	const UserDef *	userdef,
		const char *	path )

Definition at line 96 of file preferences.cc.

References UserDef::asset_libraries, BLI_path_contains(), and LISTBASE_FOREACH.

◆ BKE_preferences_asset_library_default_add()

void BKE_preferences_asset_library_default_add ( UserDef * userdef )

Definition at line 113 of file preferences.cc.

References BKE_appdir_folder_documents(), BKE_preferences_asset_library_add(), BKE_PREFS_ASSET_LIBRARY_DEFAULT_NAME, BLI_path_join, DATA_, bUserAssetLibrary::dirpath, FILE_MAXDIR, and N_.

Referenced by BKE_blendfile_userdef_from_defaults(), and blo_do_versions_userdef().

◆ BKE_preferences_asset_library_find_by_name()

bUserAssetLibrary * BKE_preferences_asset_library_find_by_name	(	const UserDef *	userdef,
		const char *	name )

Definition at line 89 of file preferences.cc.

References UserDef::asset_libraries, BLI_findstring(), and offsetof.

◆ BKE_preferences_asset_library_find_index()

bUserAssetLibrary * BKE_preferences_asset_library_find_index	(	const UserDef *	userdef,
		int	index )

Definition at line 84 of file preferences.cc.

References UserDef::asset_libraries, and BLI_findlink().

◆ BKE_preferences_asset_library_get_index()

int BKE_preferences_asset_library_get_index	(	const UserDef *	userdef,
		const bUserAssetLibrary *	library )

Definition at line 107 of file preferences.cc.

References UserDef::asset_libraries, and BLI_findindex().

◆ BKE_preferences_asset_library_name_set()

void BKE_preferences_asset_library_name_set	(	UserDef *	userdef,
		bUserAssetLibrary *	library,
		const char *	name )

Definition at line 63 of file preferences.cc.

References UserDef::asset_libraries, BLI_uniquename(), bUserAssetLibrary::name, offsetof, and STRNCPY_UTF8.

Referenced by BKE_preferences_asset_library_add(), and blo_do_versions_userdef().

◆ BKE_preferences_asset_library_path_set()

void BKE_preferences_asset_library_path_set	(	struct bUserAssetLibrary *	library,
		const char *	path )

Set the library path, ensuring it is pointing to a directory. Single blend files can only act as "Current File" library; libraries on disk should always be directories. If the path does not exist, that's fine; it can created as directory if necessary later.

Definition at line 76 of file preferences.cc.

References BLI_is_file(), BLI_path_parent_dir(), bUserAssetLibrary::dirpath, and STRNCPY.

◆ BKE_preferences_asset_library_remove()

void BKE_preferences_asset_library_remove	(	struct UserDef *	userdef,
		struct bUserAssetLibrary *	library )

Unlink and free a library preference member.

Note: Free's library itself.

Definition at line 58 of file preferences.cc.

References UserDef::asset_libraries, and BLI_freelinkN().

Referenced by preferences_asset_library_remove_exec(), and blender::asset_system::tests::AssetCatalogTest::save_from_memory_into_existing_asset_lib().

◆ BKE_preferences_asset_shelf_settings_ensure_catalog_path_enabled()

bool BKE_preferences_asset_shelf_settings_ensure_catalog_path_enabled	(	UserDef *	userdef,
		const char *	shelf_idname,
		const char *	catalog_path )

Enable a catalog path for a asset shelf identified by shelf_idname. Will create the shelf settings in the Preferences if necessary.

Returns: true if the catalog was newly enabled. The Preferences should be tagged as dirty then.

Definition at line 569 of file preferences.cc.

References asset_shelf_settings_ensure(), BKE_asset_catalog_path_list_add_path(), and BKE_preferences_asset_shelf_settings_is_catalog_path_enabled().

Referenced by BKE_blendfile_userdef_from_defaults(), blo_do_versions_userdef(), blender::ed::asset::shelf::settings_set_catalog_path_enabled(), and blender::ed::sculpt_paint::show_catalog_in_asset_shelf().

◆ BKE_preferences_asset_shelf_settings_get()

bUserAssetShelfSettings * BKE_preferences_asset_shelf_settings_get	(	const UserDef *	userdef,
		const char *	shelf_idname )

Definition at line 548 of file preferences.cc.

References UserDef::asset_shelves_settings, BLI_findstring(), and offsetof.

Referenced by asset_shelf_settings_ensure(), BKE_preferences_asset_shelf_settings_is_catalog_path_enabled(), and blender::ed::asset::shelf::get_enabled_catalog_path_list().

◆ BKE_preferences_asset_shelf_settings_is_catalog_path_enabled()

bool BKE_preferences_asset_shelf_settings_is_catalog_path_enabled	(	const UserDef *	userdef,
		const char *	shelf_idname,
		const char *	catalog_path )

Definition at line 557 of file preferences.cc.

References BKE_asset_catalog_path_list_has_path(), and BKE_preferences_asset_shelf_settings_get().

Referenced by BKE_preferences_asset_shelf_settings_ensure_catalog_path_enabled().

◆ BKE_preferences_extension_remote_to_name()

void BKE_preferences_extension_remote_to_name	(	const char *	remote_url,
		char	name[sizeof(bUserExtensionRepo::name)] )

Definition at line 437 of file preferences.cc.

References BKE_preferences_extension_repo_remote_scheme_end(), BLI_path_basename(), BLI_path_slash_native(), BLI_strncpy_utf8(), bUserExtensionRepo::name, STRPREFIX, UNLIKELY, and url_char_is_delimiter().

◆ BKE_preferences_extension_repo_add()

bUserExtensionRepo * BKE_preferences_extension_repo_add	(	UserDef *	userdef,
		const char *	name,
		const char *	module,
		const char *	custom_dirpath )

Definition at line 161 of file preferences.cc.

References BKE_preferences_extension_repo_module_set(), BKE_preferences_extension_repo_name_set(), BLI_addtail(), BLI_path_cmp, BLI_path_normalize(), BLI_path_slash_rstrip(), bUserExtensionRepo::custom_dirpath, DNA_struct_default_alloc, UserDef::extension_repos, LISTBASE_FOREACH, module, and STRNCPY.

Referenced by BKE_preferences_extension_repo_add_default_remote(), BKE_preferences_extension_repo_add_default_system(), BKE_preferences_extension_repo_add_default_user(), and preferences_extension_repo_add_exec().

◆ BKE_preferences_extension_repo_add_default_remote()

bUserExtensionRepo * BKE_preferences_extension_repo_add_default_remote ( UserDef * userdef )

Definition at line 200 of file preferences.cc.

References BKE_preferences_extension_repo_add(), bUserExtensionRepo::flag, bUserExtensionRepo::remote_url, STRNCPY, USER_EXTENSION_REPO_FLAG_SYNC_ON_STARTUP, and USER_EXTENSION_REPO_FLAG_USE_REMOTE_URL.

Referenced by BKE_preferences_extension_repo_add_defaults_all(), and blo_do_versions_userdef().

◆ BKE_preferences_extension_repo_add_default_system()

bUserExtensionRepo * BKE_preferences_extension_repo_add_default_system ( UserDef * userdef )

Definition at line 219 of file preferences.cc.

References BKE_preferences_extension_repo_add(), bUserExtensionRepo::source, and USER_EXTENSION_REPO_SOURCE_SYSTEM.

Referenced by BKE_preferences_extension_repo_add_defaults_all(), and blo_do_versions_userdef().

◆ BKE_preferences_extension_repo_add_default_user()

bUserExtensionRepo * BKE_preferences_extension_repo_add_default_user ( UserDef * userdef )

Definition at line 212 of file preferences.cc.

References BKE_preferences_extension_repo_add().

Referenced by BKE_preferences_extension_repo_add_defaults_all(), and blo_do_versions_userdef().

◆ BKE_preferences_extension_repo_add_defaults_all()

void BKE_preferences_extension_repo_add_defaults_all ( UserDef * userdef )

Create all default repositories, only use when repositories are empty.

Definition at line 226 of file preferences.cc.

References BKE_preferences_extension_repo_add_default_remote(), BKE_preferences_extension_repo_add_default_system(), BKE_preferences_extension_repo_add_default_user(), BLI_assert, BLI_listbase_is_empty(), and UserDef::extension_repos.

Referenced by BKE_blendfile_userdef_from_defaults().

◆ BKE_preferences_extension_repo_custom_dirpath_set()

void BKE_preferences_extension_repo_custom_dirpath_set	(	bUserExtensionRepo *	repo,
		const char *	path )

Definition at line 282 of file preferences.cc.

References bUserExtensionRepo::custom_dirpath, and STRNCPY.

◆ BKE_preferences_extension_repo_dirpath_get()

size_t BKE_preferences_extension_repo_dirpath_get	(	const bUserExtensionRepo *	repo,
		char *	dirpath,
		const int	dirpath_maxncpy )

Definition at line 287 of file preferences.cc.

References BKE_appdir_folder_id(), BKE_appdir_folder_id_user_notest(), BLENDER_SYSTEM_EXTENSIONS, BLENDER_USER_EXTENSIONS, BLI_path_join, BLI_strncpy_rlen(), bUserExtensionRepo::custom_dirpath, bUserExtensionRepo::flag, bUserExtensionRepo::module, bUserExtensionRepo::source, USER_EXTENSION_REPO_FLAG_USE_CUSTOM_DIRECTORY, USER_EXTENSION_REPO_FLAG_USE_REMOTE_URL, USER_EXTENSION_REPO_SOURCE_SYSTEM, and USER_EXTENSION_REPO_SOURCE_USER.

Referenced by preferences_extension_repo_remove_exec(), and preferences_extension_repo_remove_invoke().

◆ BKE_preferences_extension_repo_find_by_module()

bUserExtensionRepo * BKE_preferences_extension_repo_find_by_module	(	const UserDef *	userdef,
		const char *	module )

Definition at line 338 of file preferences.cc.

References BLI_findstring(), UserDef::extension_repos, module, and offsetof.

◆ BKE_preferences_extension_repo_find_by_remote_url_prefix()

bUserExtensionRepo * BKE_preferences_extension_repo_find_by_remote_url_prefix	(	const UserDef *	userdef,
		const char *	remote_url_full,
		const bool	only_enabled )

Using a full URL/remote path to find a repository that shares its prefix.

Definition at line 361 of file preferences.cc.

References BKE_preferences_extension_repo_remote_scheme_end(), ELEM, UserDef::extension_repos, LISTBASE_FOREACH, url_char_is_delimiter(), USER_EXTENSION_REPO_FLAG_DISABLED, and USER_EXTENSION_REPO_FLAG_USE_REMOTE_URL.

Referenced by drop_extension_url_poll().

◆ BKE_preferences_extension_repo_find_index()

bUserExtensionRepo * BKE_preferences_extension_repo_find_index	(	const UserDef *	userdef,
		int	index )

Definition at line 333 of file preferences.cc.

References BLI_findlink(), and UserDef::extension_repos.

◆ BKE_preferences_extension_repo_get_index()

int BKE_preferences_extension_repo_get_index	(	const UserDef *	userdef,
		const bUserExtensionRepo *	repo )

Definition at line 501 of file preferences.cc.

References BLI_findindex(), and UserDef::extension_repos.

◆ BKE_preferences_extension_repo_module_is_valid()

bool BKE_preferences_extension_repo_module_is_valid ( const bUserExtensionRepo * repo )

Check the module name is valid, while this should always be the case, use this as an additional safely check before performing destructive operations such as recursive file removal to prevent file/memory corruption causing user data loss.

Definition at line 267 of file preferences.cc.

References BLI_strnlen(), bUserExtensionRepo::module, and strncpy_py_module().

Referenced by preferences_extension_repo_remove_exec().