#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 ASSET_IMPORT_APPEND_REUSE, UserDef::asset_libraries, BKE_preferences_asset_library_name_set(), BLI_addtail(), bUserAssetLibrary::dirpath, DNA_struct_default_alloc, UserDef::experimental, bUserAssetLibrary::import_method, name, UserDef_Experimental::no_data_block_packing, 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()

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(), 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 134 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(), 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, BKE_preferences_asset_library_find_by_name(), and name.

Referenced by 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_WARN_UNUSED_RESULT.

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

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

References UserDef::asset_libraries, BLI_uniquename(), bUserAssetLibrary::name, 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 97 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 79 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 596 of file preferences.cc.

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

Referenced by BKE_blendfile_userdef_from_defaults(), 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 575 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(), 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 584 of file preferences.cc.

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

Referenced by BKE_preferences_asset_shelf_settings_ensure_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(), BKE_preferences_extension_repo_write_data(), and name.

Referenced by 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 221 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_asset_library_get_index(), 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 240 of file preferences.cc.

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

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

References BKE_preferences_extension_repo_add().

Referenced by BKE_preferences_asset_library_get_index(), 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 247 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(), and BKE_preferences_asset_library_get_index().

◆ BKE_preferences_extension_repo_custom_dirpath_set()

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

Definition at line 303 of file preferences.cc.

References bUserExtensionRepo::custom_dirpath, and STRNCPY().

Referenced by BKE_preferences_asset_library_get_index().

◆ BKE_preferences_extension_repo_dirpath_get()

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

Definition at line 308 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 BKE_preferences_asset_library_get_index(), 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 359 of file preferences.cc.

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

Referenced by BKE_preferences_asset_library_get_index().

◆ 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 382 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 BKE_preferences_asset_library_get_index(), 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 354 of file preferences.cc.

References BLI_findlink(), and UserDef::extension_repos.

Referenced by BKE_preferences_asset_library_get_index().

◆ BKE_preferences_extension_repo_get_index()

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

Definition at line 528 of file preferences.cc.

References BLI_findindex(), and UserDef::extension_repos.

Referenced by BKE_preferences_extension_remote_to_name().

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

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

Referenced by BKE_preferences_asset_library_get_index(), and preferences_extension_repo_remove_exec().