42# define _WIN32_IE 0x0501
57#define STR_OR_FALLBACK(a) ((a) ? (a) : _str_null)
90# define ASSERT_IS_INIT() BLI_assert(is_appdir_init)
92# define ASSERT_IS_INIT() ((void)0)
127 static char version_str[5];
129 SNPRINTF(version_str,
"%d.%d", version / 100, version % 100);
147 return documentfolder;
168 if (path ==
nullptr) {
179 const std::optional<std::string> documents_path = ghost_system_paths->
getUserSpecialDir(
183 if (documents_path &&
BLI_is_dir(documents_path->c_str())) {
197 BLI_path_join(try_documents_path,
sizeof(try_documents_path), home_path,
N_(
"Documents"));
211 std::optional<std::string> caches_root_path = ghost_system_paths->
getUserSpecialDir(
213 if (!caches_root_path || caches_root_path->empty()) [[unlikely]] {
222 caches_root_path->c_str(),
223 "Blender Foundation",
227#elif defined(__APPLE__)
240 wchar_t wpath[MAX_PATH];
241 if (SHGetSpecialFolderPathW(0, wpath, CSIDL_FONTS, 0)) {
244#elif defined(__APPLE__)
246 BLI_path_join(test_dir,
sizeof(test_dir), home_dir,
"Library/Fonts");
249 STRNCPY(test_dir,
"/usr/share/fonts");
281 size_t targetpath_maxncpy,
282 const bool check_is_dir,
283 const char *path_base,
284 const char *folder_name,
285 const char *subfolder_name)
290 BLI_assert(!(folder_name ==
nullptr && (subfolder_name !=
nullptr)));
291 const char *path_array[] = {path_base, folder_name, subfolder_name};
292 const int path_array_num = (folder_name ? (subfolder_name ? 3 : 2) : 1);
294 if (check_is_dir ==
false) {
308 targetpath[0] =
'\0';
320static bool test_env_path(
char *path,
const char *envvar,
const bool check_is_dir)
324 const char *env_path = envvar ?
BLI_getenv(envvar) :
nullptr;
331 if (check_is_dir ==
false) {
332 CLOG_DEBUG(&
LOG,
"Using env '%s' (without test): '%s'", envvar, env_path);
362 size_t targetpath_maxncpy,
363 const char *folder_name,
364 const char *subfolder_name,
366 const bool check_is_dir)
371 "Get path local: folder='%s', subfolder='%s'",
376 const char *path_array[] = {folder_name, subfolder_name};
377 const int path_array_num = subfolder_name ? 2 : 1;
386 const char *path_base =
g_app.program_dirname;
387#if defined(__APPLE__) && !defined(WITH_PYTHON_MODULE)
391 char osx_resourses[
FILE_MAX + 4 + 9];
392 BLI_path_join(osx_resourses,
sizeof(osx_resourses),
g_app.program_dirname,
"..",
"Resources");
395 path_base = osx_resourses;
402 (version) ? relfolder :
nullptr);
405 size_t targetpath_maxncpy,
406 const char *folder_name,
407 const char *subfolder_name)
410 const bool check_is_dir =
true;
412 targetpath, targetpath_maxncpy, folder_name, subfolder_name, version, check_is_dir);
425 size_t targetpath_maxncpy,
426 const char *subfolder_name,
428 const bool check_is_dir)
435 targetpath, targetpath_maxncpy, check_is_dir, user_path, subfolder_name,
nullptr);
440 size_t targetpath_maxncpy,
441 const char *subfolder_name,
444 const bool check_is_dir =
true;
446 targetpath, targetpath_maxncpy, subfolder_name, envvar, check_is_dir);
451 const bool check_is_dir)
454 const char *env_path = envvar ?
BLI_getenv(envvar) :
nullptr;
460 const char separator =
';';
462 const char separator =
':';
465 const char *char_begin = env_path;
467 while (char_begin[0]) {
468 const size_t base_path_len = char_end - char_begin;
469 if (base_path_len > 0 && base_path_len <
PATH_MAX) {
471 memcpy(base_path, char_begin, base_path_len);
472 base_path[base_path_len] =
'\0';
475 if (
test_path(path,
sizeof(path), check_is_dir, base_path, subfolder_name,
nullptr)) {
479 char_begin = char_end[0] ? char_end + 1 : char_end;
497 size_t targetpath_maxncpy,
498 const char *folder_name,
499 const char *subfolder_name,
501 const bool check_is_dir)
506 if (
test_env_path(user_path,
"BLENDER_USER_RESOURCES", check_is_dir)) {
510 else if (
get_path_local_ex(user_path,
sizeof(user_path),
"portable",
nullptr, 0,
true)) {
517 const char *user_base_path = ghost_system_paths->
getUserDir(version,
519 if (user_base_path) {
520 STRNCPY(user_path, user_base_path);
529 "Get path user: '%s', folder='%s', subfolder='%s'",
536 targetpath, targetpath_maxncpy, check_is_dir, user_path, folder_name, subfolder_name);
539 size_t targetpath_maxncpy,
540 const char *folder_name,
541 const char *subfolder_name)
544 const bool check_is_dir =
true;
546 targetpath, targetpath_maxncpy, folder_name, subfolder_name, version, check_is_dir);
560 size_t targetpath_maxncpy,
561 const char *folder_name,
562 const char *subfolder_name,
564 const bool check_is_dir)
568 if (
test_env_path(system_path,
"BLENDER_SYSTEM_RESOURCES", check_is_dir)) {
572 system_path[0] =
'\0';
574 const char *system_base_path = ghost_system_paths->
getSystemDir(
576 if (system_base_path) {
577 STRNCPY(system_path, system_base_path);
581 if (!system_path[0]) {
586 "Get path system: '%s', folder='%s', subfolder='%s'",
593 targetpath, targetpath_maxncpy, check_is_dir, system_path, folder_name, subfolder_name);
597 size_t targetpath_maxncpy,
598 const char *folder_name,
599 const char *subfolder_name)
602 const bool check_is_dir =
true;
604 targetpath, targetpath_maxncpy, folder_name, subfolder_name, version, check_is_dir);
613 size_t targetpath_maxncpy,
614 const char *folder_name,
615 const char *subfolder_name,
617 const bool check_is_dir)
624 if (system_base_path) {
625 STRNCPY(system_path, system_base_path);
628 if (!system_path[0]) {
633 "Get path system libs: '%s', folder='%s', subfolder='%s'",
640 targetpath, targetpath_maxncpy, check_is_dir, system_path, folder_name, subfolder_name);
650 const char *subfolder,
659 if (
get_path_user(path, path_maxncpy,
"datafiles", subfolder)) {
677 if (
get_path_user(path, path_maxncpy,
"datafiles", subfolder)) {
698 if (
get_path_user(path, path_maxncpy,
"config", subfolder)) {
707 if (
get_path_user(path, path_maxncpy,
"scripts", subfolder)) {
725 if (
get_path_user(path, path_maxncpy,
"extensions", subfolder)) {
737 if (
get_path_local(path, path_maxncpy,
"extensions", subfolder)) {
772 const char *subfolder)
776 const bool check_is_dir =
false;
781 path,
sizeof(path), subfolder,
"BLENDER_USER_DATAFILES", check_is_dir))
785 get_path_user_ex(path,
sizeof(path),
"datafiles", subfolder, version, check_is_dir);
789 path,
sizeof(path), subfolder,
"BLENDER_USER_CONFIG", check_is_dir))
793 get_path_user_ex(path,
sizeof(path),
"config", subfolder, version, check_is_dir);
797 path,
sizeof(path), subfolder,
"BLENDER_USER_SCRIPTS", check_is_dir))
801 get_path_user_ex(path,
sizeof(path),
"scripts", subfolder, version, check_is_dir);
805 path,
sizeof(path), subfolder,
"BLENDER_USER_EXTENSIONS", check_is_dir))
809 get_path_user_ex(path,
sizeof(path),
"extensions", subfolder, version, check_is_dir);
816 if (
'\0' == path[0]) {
837 if (!path.has_value()) {
839 if (path.has_value()) {
848 const bool check_is_dir,
855 ok =
get_path_user_ex(path,
sizeof(path),
nullptr,
nullptr, version, check_is_dir);
858 ok =
get_path_local_ex(path,
sizeof(path),
nullptr,
nullptr, version, check_is_dir);
879 const bool check_is_dir)
892#ifndef WITH_PYTHON_MODULE
906 const size_t program_filepath_maxncpy,
907 const char *program_name)
912 char *path =
nullptr;
913 path = br_find_exe(
nullptr);
915 BLI_strncpy(program_filepath, path, program_filepath_maxncpy);
926 if (GetModuleFileNameW(0, fullname_16, program_filepath_maxncpy)) {
930 "Program path can't be found: \"%.*s\"",
931 int(program_filepath_maxncpy),
934 "path contains invalid characters or is too long (see console)",
938 MEM_delete(fullname_16);
942 MEM_delete(fullname_16);
947 if (program_name && program_name[0]) {
949 BLI_strncpy(program_filepath, program_name, program_filepath_maxncpy);
950 if (program_name[0] ==
'.') {
953 BLI_path_program_extensions_add_win32(program_filepath, program_filepath_maxncpy);
958 BLI_strncpy(program_filepath, program_name, program_filepath_maxncpy);
960 BLI_path_program_extensions_add_win32(program_filepath, program_filepath_maxncpy);
970 if (!
STREQ(program_name, program_filepath)) {
971 CLOG_DEBUG(&
LOG,
"Program path guessing '%s' == '%s'", program_name, program_filepath);
980#ifdef WITH_PYTHON_MODULE
987 if (
g_app.program_dirname[0] ==
'\0') {
991 g_app.program_filepath,
g_app.program_dirname,
sizeof(
g_app.program_dirname));
992 g_app.program_filepath[0] =
'\0';
997 g_app.program_filepath,
g_app.program_dirname,
sizeof(
g_app.program_dirname));
1003#ifndef WITH_PYTHON_MODULE
1006 return g_app.program_filepath;
1012 return g_app.program_dirname;
1016 const size_t program_filepath_maxncpy,
1017 const int version_major,
1018 const int version_minor)
1022#ifdef PYTHON_EXECUTABLE_NAME
1024 const char *python_build_def =
STRINGIFY(PYTHON_EXECUTABLE_NAME);
1026 const char *basename =
"python";
1027#if defined(WIN32) && !defined(NDEBUG)
1028 const char *basename_debug =
"python_d";
1030 char python_version[16];
1032 const char *python_names[] = {
1033#ifdef PYTHON_EXECUTABLE_NAME
1036#if defined(WIN32) && !defined(NDEBUG)
1042 bool is_found =
false;
1044 SNPRINTF(python_version,
"%s%d.%d", basename, version_major, version_minor);
1049 if (python_bin_dir.has_value()) {
1051 for (
int i = 0; i <
ARRAY_SIZE(python_names); i++) {
1053 program_filepath, program_filepath_maxncpy, python_bin_dir->c_str(), python_names[i]);
1057 BLI_path_program_extensions_add_win32(program_filepath, program_filepath_maxncpy)
1070 if (is_found ==
false) {
1071 for (
int i = 0; i <
ARRAY_SIZE(python_names); i++) {
1079 if (is_found ==
false) {
1080 *program_filepath =
'\0';
1099 "startup" SEP_STR "bl_app_templates_user",
1103 directories.
append(temp_dir);
1108 "startup" SEP_STR "bl_app_templates_system",
"BLENDER_SYSTEM_SCRIPTS",
true));
1112 "startup" SEP_STR "bl_app_templates_system",
1116 directories.
append(temp_dir);
1131 for (
const std::string &directory : directories) {
1132 BLI_path_join(path, path_maxncpy, directory.c_str(), app_template);
1145 if (app_template[0] ==
'\0') {
1151 app_template, app_template_path,
sizeof(app_template_path)))
1163 templates->clear_no_delete();
1167 for (
const std::string &subdir : directories) {
1170 for (
int f = 0; f < dir_num; f++) {
1172 char *app_template =
BLI_strdup(dirs[f].relname);
1199static bool where_is_temp(
char *tempdir,
const size_t tempdir_maxncpy,
const char *userdir)
1209 const size_t tempdir_session_maxncpy,
1210 const char *tempdir)
1212 tempdir_session[0] =
'\0';
1214 const int tempdir_len = strlen(tempdir);
1216 const char *session_name =
"blender_XXXXXX";
1217 const int session_name_len = strlen(session_name);
1221 const int tempdir_session_len_required = tempdir_len + session_name_len + 1;
1223 if (tempdir_session_len_required <= tempdir_session_maxncpy) {
1225 BLI_string_join(tempdir_session, tempdir_session_maxncpy, tempdir, session_name);
1227 const bool needs_create = (_mktemp_s(tempdir_session, tempdir_session_len_required) == 0);
1229 const bool needs_create = (mkdtemp(tempdir_session) ==
nullptr);
1241 CLOG_WARN(&
LOG,
"Could not generate a temp file name for '%s'", tempdir_session);
1255 g_app.temp_dirname_session_can_be_deleted =
false;
1258 int userdir_args_num = userdir ? 2 : 1;
1259 const char *userdir_args[2] = {userdir,
nullptr};
1261 for (
int i = 0; i < userdir_args_num; i++) {
1264 sizeof(
g_app.temp_dirname_session),
1265 g_app.temp_dirname_base))
1267 g_app.temp_dirname_session_can_be_deleted =
true;
1273 if (
g_app.temp_dirname_session_can_be_deleted ==
false) [[unlikely]] {
1278 "Could not generate a temp session subdirectory, falling back to '%s'",
1279 g_app.temp_dirname_base);
1290 return g_app.temp_dirname_base;
1295 if (
g_app.temp_dirname_session_can_be_deleted ==
false) {
#define BLENDER_USERPREF_FILE
File and directory operations.
Some types for dealing with directories.
#define BLI_path_join(...)
#define FILENAME_IS_CURRPAR(_n)
#define SNPRINTF(dst, format,...)
#define BLI_string_join(...)
Compatibility-like things for windows.
#define CLOG_ERROR(clg_ref,...)
#define CLOG_DEBUG(clg_ref,...)
#define CLOG_WARN(clg_ref,...)
@ GHOST_kUserSpecialDirCaches
@ GHOST_kUserSpecialDirDocuments
#define STR_OR_FALLBACK(a)
#define BLI_assert_unreachable()
#define BLI_assert_msg(a, msg)
virtual const char * getSystemDir(int version, const char *versionstr) const =0
virtual const char * getSystemLibsDir(int, const char *) const
virtual const char * getUserDir(int version, const char *versionstr) const =0
static GHOST_TSuccess dispose()
static GHOST_ISystemPaths * get()
virtual std::optional< std::string > getUserSpecialDir(GHOST_TUserSpecialDirTypes type) const =0
void append(const T &value)
void extend(Span< T > array)
void free(Subdiv *subdiv)
const char * BKE_appdir_program_dir() ATTR_WARN_UNUSED_RESULT ATTR_RETURNS_NONNULL
BLI_assert(slot->slot_subtype.map==BMO_OP_SLOT_SUBTYPE_MAP_FLT)
void BKE_appdir_app_templates(ListBaseT< LinkData > *templates) ATTR_NONNULL(1)
void BKE_tempdir_session_purge()
static bool is_appdir_init
char * STRNCPY(char(&dst)[N], const char *src)
static bool get_path_environment(char *targetpath, size_t targetpath_maxncpy, const char *subfolder_name, const char *envvar)
static bool get_path_system_ex(char *targetpath, size_t targetpath_maxncpy, const char *folder_name, const char *subfolder_name, const int version, const bool check_is_dir)
bool BKE_appdir_folder_id_ex(int folder_id, const char *subfolder, char *path, size_t path_maxncpy)
const char * BKE_appdir_folder_default_or_root() ATTR_WARN_UNUSED_RESULT ATTR_RETURNS_NONNULL
static struct blender::@142352051006215376267360375200157117105334372324 g_app
void * MEM_new_array_uninitialized(size_t len, size_t size, const char *str) ATTR_WARN_UNUSED_RESULT ATTR_ALLOC_SIZE(1
static bool tempdir_session_create(char *tempdir_session, const size_t tempdir_session_maxncpy, const char *tempdir)
unsigned int BLI_filelist_dir_contents(const char *dirname, struct direntry **r_filelist)
std::optional< std::string > BKE_appdir_folder_id_create(int folder_id, const char *subfolder) ATTR_WARN_UNUSED_RESULT
bool BLI_dir_create_recursive(const char *dirname) ATTR_NONNULL()
bool BLI_exists(const char *path) ATTR_WARN_UNUSED_RESULT ATTR_NONNULL()
static bool get_path_user_ex(char *targetpath, size_t targetpath_maxncpy, const char *folder_name, const char *subfolder_name, const int version, const bool check_is_dir)
static bool where_is_temp(char *tempdir, const size_t tempdir_maxncpy, const char *userdir)
static bool get_path_local(char *targetpath, size_t targetpath_maxncpy, const char *folder_name, const char *subfolder_name)
bool BKE_appdir_app_template_any()
static bool get_path_environment_ex(char *targetpath, size_t targetpath_maxncpy, const char *subfolder_name, const char *envvar, const bool check_is_dir)
@ BLENDER_RESOURCE_PATH_SYSTEM_LIBS
@ BLENDER_RESOURCE_PATH_SYSTEM
@ BLENDER_RESOURCE_PATH_USER
@ BLENDER_RESOURCE_PATH_LOCAL
static bool get_path_system(char *targetpath, size_t targetpath_maxncpy, const char *folder_name, const char *subfolder_name)
const char * BKE_tempdir_session() ATTR_WARN_UNUSED_RESULT ATTR_RETURNS_NONNULL
const char * BLI_dir_home()
static bool get_path_user(char *targetpath, size_t targetpath_maxncpy, const char *folder_name, const char *subfolder_name)
static void where_am_i(char *program_filepath, const size_t program_filepath_maxncpy, const char *program_name)
std::optional< std::string > BKE_appdir_folder_id(int folder_id, const char *subfolder) ATTR_WARN_UNUSED_RESULT
char * BLI_strncpy(char *__restrict dst, const char *__restrict src, size_t dst_maxncpy) ATTR_NONNULL(1
void void BLI_path_split_dir_part(const char *filepath, char *dir, size_t dir_maxncpy) ATTR_NONNULL(1
static bool test_path(char *targetpath, size_t targetpath_maxncpy, const bool check_is_dir, const char *path_base, const char *folder_name, const char *subfolder_name)
const char * BKE_appdir_folder_root() ATTR_WARN_UNUSED_RESULT ATTR_RETURNS_NONNULL
int BLI_path_canonicalize_native(char *path, int path_maxncpy)
static const char _str_null[]
bool void BLI_temp_directory_path_get(char *tempdir, const size_t tempdir_maxncpy) ATTR_NONNULL(1)
bool BKE_appdir_app_template_id_search(const char *app_template, char *path, size_t path_maxncpy) ATTR_NONNULL(1)
int BLI_delete(const char *path, bool dir, bool recursive) ATTR_NONNULL()
size_t BLI_strncpy_wchar_as_utf8(char *__restrict dst, const wchar_t *__restrict src, size_t dst_maxncpy) ATTR_NONNULL(1
bool BLI_path_program_search(char *program_filepath, size_t program_filepath_maxncpy, const char *program_name) ATTR_NONNULL(1
bool BKE_appdir_app_template_has_userpref(const char *app_template) ATTR_NONNULL(1)
bool BKE_appdir_program_python_search(char *program_filepath, size_t program_filepath_maxncpy, int version_major, int version_minor) ATTR_NONNULL(1)
bool BLI_path_abs_from_cwd(char *path, size_t path_maxncpy) ATTR_NONNULL(1)
constexpr size_t ARRAY_SIZE(const T(&arg)[N]) noexcept
LinkData * BLI_genericNodeN(void *data)
bool BKE_appdir_folder_documents(char *dir) ATTR_NONNULL(1) ATTR_WARN_UNUSED_RESULT
const char * BKE_tempdir_base() ATTR_WARN_UNUSED_RESULT ATTR_RETURNS_NONNULL
int BLI_path_slash_ensure(char *path, size_t path_maxncpy) ATTR_NONNULL(1)
std::optional< std::string > BKE_appdir_resource_path_id(int folder_id, bool check_is_dir)
bool BLI_is_dir(const char *path) ATTR_WARN_UNUSED_RESULT ATTR_NONNULL()
std::optional< std::string > BKE_appdir_folder_id_user_notest(int folder_id, const char *subfolder) ATTR_WARN_UNUSED_RESULT
void BKE_appdir_program_path_init(const char *argv0) ATTR_NONNULL(1)
static char * blender_version_decimal(const int version)
static bool get_path_local_ex(char *targetpath, size_t targetpath_maxncpy, const char *folder_name, const char *subfolder_name, const int version, const bool check_is_dir)
void BLI_filelist_free(struct direntry *filelist, unsigned int nrentries)
static bool test_env_path(char *path, const char *envvar, const bool check_is_dir)
void BLI_addtail(ListBase *listbase, void *vlink) ATTR_NONNULL(1)
void BKE_appdir_folder_caches(char *path, size_t path_maxncpy) ATTR_NONNULL(1)
char * BLI_strdup(const char *str) ATTR_WARN_UNUSED_RESULT ATTR_NONNULL(1) ATTR_MALLOC
static bool get_path_system_libs_ex(char *targetpath, size_t targetpath_maxncpy, const char *folder_name, const char *subfolder_name, const int version, const bool check_is_dir)
std::optional< std::string > BKE_appdir_resource_path_id_with_version(int folder_id, bool check_is_dir, int version)
bool BKE_appdir_font_folder_default(char *dir, size_t dir_maxncpy)
static Vector< std::string > appdir_app_template_directories()
int BLI_path_normalize_native(char *path) ATTR_NONNULL(1)
bool BLI_temp_directory_path_copy_if_valid(char *tempdir, const size_t tempdir_maxncpy, const char *dirpath) ATTR_NONNULL(1
const char * BKE_appdir_program_path() ATTR_WARN_UNUSED_RESULT ATTR_RETURNS_NONNULL
size_t BLI_path_join_array(char *__restrict dst, const size_t dst_maxncpy, const char *path_array[], const int path_array_num) ATTR_NONNULL(1
@ BLENDER_SYSTEM_EXTENSIONS
@ BLENDER_USER_EXTENSIONS
@ BLENDER_SYSTEM_DATAFILES
const char * BLI_path_slash_rfind(const char *path) ATTR_NONNULL(1) ATTR_WARN_UNUSED_RESULT
void BKE_tempdir_init(const char *userdir)
const char * BLI_getenv(const char *env) ATTR_NONNULL(1) ATTR_WARN_UNUSED_RESULT
const char * BKE_appdir_folder_default() ATTR_WARN_UNUSED_RESULT
char char size_t char const char * BLI_strchr_or_end(const char *str, char ch) ATTR_WARN_UNUSED_RESULT ATTR_RETURNS_NONNULL ATTR_NONNULL(1)
void BLI_windows_get_default_root_dir(char root_dir[4])
static Vector< std::string > get_path_environment_multiple(const char *subfolder_name, const char *envvar, const bool check_is_dir)
char temp_dirname_session[FILE_MAX]
char program_filepath[FILE_MAX]
bool temp_dirname_session_can_be_deleted
char program_dirname[FILE_MAX]
char temp_dirname_base[FILE_MAX]
int conv_utf_16_to_8(const wchar_t *in16, char *out8, size_t size8)