#include "BLI_compiler_attrs.h"
#include "BLI_sys_types.h"

Namespaces
namespace	blender
namespace	blender::bke
namespace	blender::bke::preferences

Functions
bool	blender::bke::preferences::exists ()
Extension Repositories
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)
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, int dirpath_maxncpy)
size_t	BKE_preferences_extension_repo_user_dirpath_get (const bUserExtensionRepo repo, char dirpath, const int dirpath_maxncpy)
bool	BKE_preferences_extension_repo_module_is_valid (const bUserExtensionRepo *repo)
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)
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[64])
int	BKE_preferences_extension_repo_get_index (const UserDef userdef, const bUserExtensionRepo repo)
void	BKE_preferences_extension_repo_read_data (struct BlendDataReader reader, bUserExtensionRepo repo)
void	BKE_preferences_extension_repo_write_data (struct BlendWriter writer, const bUserExtensionRepo repo)
#bUserAssetShelvesSettings
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)

Assert Libraries
#define	BKE_PREFS_ASSET_LIBRARY_DEFAULT_NAME N_("User Library")
struct bUserAssetLibrary *	BKE_preferences_asset_library_add (struct UserDef userdef, const char name, const char *dirpath) ATTR_NONNULL(1)
void	BKE_preferences_asset_library_remove (struct UserDef userdef, struct bUserAssetLibrary library) ATTR_NONNULL()
void	BKE_preferences_asset_library_name_set (struct UserDef userdef, struct bUserAssetLibrary library, const char *name) ATTR_NONNULL()
void	BKE_preferences_asset_library_path_set (struct bUserAssetLibrary library, const char path) ATTR_NONNULL()
struct bUserAssetLibrary *	BKE_preferences_asset_library_find_index (const struct UserDef *userdef, int index) ATTR_NONNULL() ATTR_WARN_UNUSED_RESULT
struct bUserAssetLibrary *	BKE_preferences_asset_library_find_by_name (const struct UserDef userdef, const char name) ATTR_NONNULL() ATTR_WARN_UNUSED_RESULT
struct bUserAssetLibrary *	BKE_preferences_asset_library_containing_path (const struct UserDef userdef, const char path) ATTR_NONNULL() ATTR_WARN_UNUSED_RESULT
int	BKE_preferences_asset_library_get_index (const struct UserDef userdef, const struct bUserAssetLibrary library) ATTR_NONNULL() ATTR_WARN_UNUSED_RESULT
void	BKE_preferences_asset_library_default_add (struct UserDef *userdef) ATTR_NONNULL()

Macro Definition Documentation

◆ BKE_PREFS_ASSET_LIBRARY_DEFAULT_NAME

#define BKE_PREFS_ASSET_LIBRARY_DEFAULT_NAME N_("User Library")

Name of the asset library added by default. Needs translation with DATA_() still.

Definition at line 40 of file BKE_preferences.h.

Referenced by BKE_preferences_asset_library_default_add(), and blo_do_versions_userdef().

Function Documentation

◆ BKE_preferences_asset_library_add()

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

Definition at line 59 of file preferences.cc.

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

Referenced by BKE_preferences_asset_library_add(), 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()

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

Return the bUserAssetLibrary that contains the given file/directory path. The given path can be the library's top-level directory, or any path inside that directory.

When more than one asset libraries match, the first matching one is returned (no smartness when there nested asset libraries).

Return NULL when no such asset library is found.

References ATTR_NONNULL, ATTR_WARN_UNUSED_RESULT, and BKE_preferences_asset_library_containing_path().

Referenced by AS_asset_library_find_suitable_root_path_from_path(), blender::ed::asset::asset_bundle_install_poll(), blender::bke::asset_edit_weak_reference_from_id(), blender::bke::asset_link_id(), BKE_preferences_asset_library_containing_path(), and BKE_preferences_asset_library_containing_path().

◆ BKE_preferences_asset_library_default_add()

void BKE_preferences_asset_library_default_add ( struct UserDef * userdef )

Definition at line 132 of file preferences.cc.

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

Referenced by BKE_blendfile_userdef_from_defaults(), BKE_preferences_asset_library_default_add(), BKE_preferences_asset_library_get_index(), and blo_do_versions_userdef().

◆ BKE_preferences_asset_library_find_by_name()

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

References ATTR_NONNULL, ATTR_WARN_UNUSED_RESULT, and BKE_preferences_asset_library_find_by_name().

Referenced by BKE_preferences_asset_library_find_by_name(), BKE_preferences_asset_library_find_by_name(), blender::ed::sculpt_paint::brush_asset_delete_exec(), blender::ed::sculpt_paint::brush_asset_save_exec(), and blender::asset_system::AssetLibraryService::find_custom_preferences_asset_library_from_asset_weak_ref().

◆ BKE_preferences_asset_library_find_index()

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

References ATTR_NONNULL, ATTR_WARN_UNUSED_RESULT, and BKE_preferences_asset_library_find_index().

Referenced by BKE_preferences_asset_library_find_index(), BKE_preferences_asset_library_find_index(), blender::ed::animrig::create_pose_asset_user_library(), filelist_compare_asset_libraries(), fileselect_refresh_asset_params(), blender::asset_system::AssetLibraryService::find_custom_asset_library_from_library_ref(), blender::ed::asset::get_asset_library_from_opptr(), blender::ed::asset::library_reference_from_enum_value(), blender::ed::asset::library_reference_to_enum_value(), and blender::ed::asset::selected_asset_library().

◆ BKE_preferences_asset_library_get_index()

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

Referenced by BKE_preferences_asset_library_get_index(), and BKE_preferences_asset_library_get_index().

◆ BKE_preferences_asset_library_name_set()

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

Definition at line 82 of file preferences.cc.

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

Referenced by BKE_preferences_asset_library_add(), BKE_preferences_asset_library_name_set(), 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 95 of file preferences.cc.

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

Referenced by BKE_preferences_asset_library_path_set().

◆ 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 77 of file preferences.cc.

References UserDef::asset_libraries, BKE_preferences_asset_library_remove(), and BLI_freelinkN().

Referenced by BKE_preferences_asset_library_remove(), 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 594 of file preferences.cc.

References asset_shelf_settings_ensure(), BKE_asset_catalog_path_list_add_path(), BKE_preferences_asset_shelf_settings_ensure_catalog_path_enabled(), BKE_preferences_asset_shelf_settings_is_catalog_path_enabled(), and bUserAssetShelfSettings::enabled_catalog_paths.

Referenced by BKE_blendfile_userdef_from_defaults(), BKE_preferences_asset_shelf_settings_ensure_catalog_path_enabled(), BKE_preferences_extension_remote_to_name(), blo_do_versions_userdef(), and blender::ed::asset::shelf::settings_set_catalog_path_enabled().

◆ BKE_preferences_asset_shelf_settings_get()

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

Definition at line 573 of file preferences.cc.

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

Referenced by asset_shelf_settings_ensure(), BKE_preferences_asset_shelf_settings_get(), BKE_preferences_asset_shelf_settings_is_catalog_path_enabled(), BKE_preferences_extension_remote_to_name(), 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 582 of file preferences.cc.

References BKE_asset_catalog_path_list_has_path(), BKE_preferences_asset_shelf_settings_get(), BKE_preferences_asset_shelf_settings_is_catalog_path_enabled(), and bUserAssetShelfSettings::enabled_catalog_paths.

Referenced by BKE_preferences_asset_shelf_settings_ensure_catalog_path_enabled(), BKE_preferences_asset_shelf_settings_is_catalog_path_enabled(), and BKE_preferences_extension_remote_to_name().

◆ BKE_preferences_extension_remote_to_name()

void BKE_preferences_extension_remote_to_name	(	const char *	remote_url,
		char	name[64] )

Set a name based on a URL, e.g. https://www.example.com/path -> example.com.

References BKE_preferences_asset_shelf_settings_ensure_catalog_path_enabled(), BKE_preferences_asset_shelf_settings_get(), BKE_preferences_asset_shelf_settings_is_catalog_path_enabled(), BKE_preferences_extension_remote_to_name(), BKE_preferences_extension_repo_get_index(), BKE_preferences_extension_repo_read_data(), and BKE_preferences_extension_repo_write_data().

Referenced by BKE_preferences_extension_remote_to_name(), BKE_preferences_extension_remote_to_name(), and preferences_extension_repo_add_exec().

◆ BKE_preferences_extension_repo_add()

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

◆ BKE_preferences_extension_repo_add_default_remote()

bUserExtensionRepo * BKE_preferences_extension_repo_add_default_remote ( UserDef * userdef )

Definition at line 219 of file preferences.cc.

References BKE_preferences_extension_repo_add(), BKE_preferences_extension_repo_add_default_remote(), 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_asset_library_get_index(), BKE_preferences_extension_repo_add_default_remote(), 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 238 of file preferences.cc.

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

Referenced by BKE_preferences_asset_library_get_index(), BKE_preferences_extension_repo_add_default_system(), 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 231 of file preferences.cc.

References BKE_preferences_extension_repo_add(), and BKE_preferences_extension_repo_add_default_user().

Referenced by BKE_preferences_asset_library_get_index(), BKE_preferences_extension_repo_add_default_user(), 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 245 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(), BKE_preferences_extension_repo_add_defaults_all(), BLI_assert, BLI_listbase_is_empty(), and UserDef::extension_repos.

Referenced by BKE_blendfile_userdef_from_defaults(), BKE_preferences_asset_library_get_index(), and BKE_preferences_extension_repo_add_defaults_all().

◆ BKE_preferences_extension_repo_custom_dirpath_set()

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

Definition at line 301 of file preferences.cc.

References BKE_preferences_extension_repo_custom_dirpath_set(), bUserExtensionRepo::custom_dirpath, and STRNCPY().

Referenced by BKE_preferences_asset_library_get_index(), and BKE_preferences_extension_repo_custom_dirpath_set().

◆ BKE_preferences_extension_repo_dirpath_get()

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

◆ BKE_preferences_extension_repo_find_by_module()

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

Definition at line 357 of file preferences.cc.

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

Referenced by BKE_preferences_asset_library_get_index(), and BKE_preferences_extension_repo_find_by_module().

◆ 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 380 of file preferences.cc.

References BKE_preferences_extension_repo_find_by_remote_url_prefix(), 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 BKE_preferences_asset_library_get_index(), BKE_preferences_extension_repo_find_by_remote_url_prefix(), and 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 352 of file preferences.cc.

References BKE_preferences_extension_repo_find_index(), BLI_findlink(), and UserDef::extension_repos.

Referenced by BKE_preferences_asset_library_get_index(), and BKE_preferences_extension_repo_find_index().

◆ BKE_preferences_extension_repo_get_index()

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

Definition at line 526 of file preferences.cc.

References BKE_preferences_extension_repo_get_index(), BLI_findindex(), and UserDef::extension_repos.

Referenced by BKE_preferences_extension_remote_to_name(), and BKE_preferences_extension_repo_get_index().

◆ 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 286 of file preferences.cc.

References BKE_preferences_extension_repo_module_is_valid(), bUserExtensionRepo::module, strncpy_py_module(), and STRNLEN.

Referenced by BKE_preferences_asset_library_get_index(), BKE_preferences_extension_repo_module_is_valid(), and preferences_extension_repo_remove_exec().