gimpenv

gimp_directory ()

gchar*      gimp_directory                  (void);

Returns the user-specific GIMP settings directory. If the environment variable GIMP_DIRECTORY exists, it is used. If it is an absolute path, it is used as is. If it is a relative path, it is taken to be a subdirectory of the home directory. If it is relative path, and no home directory can be determined, it is taken to be a subdirectory of gimp_data_directory().

The usual case is that no GIMP_DIRECTORY environment variable exists, and then we use the GIMPDIR subdirectory of the home directory. If no home directory exists, we use a per-user subdirectory of gimp_data_directory(). In any case, we always return some non-empty string, whether it corresponds to an existing directory or not.

The returned string is allocated just once, and should *NOT* be freed with g_free().

gimp_personal_rc_file ()

gchar*      gimp_personal_rc_file           (gchar *basename);

Returns the name of a file in the user-specific GIMP settings directory.

The returned string is allocated dynamically and *SHOULD* be freed with g_free() after use.

gimp_data_directory ()

gchar*      gimp_data_directory             (void);

Returns the top directory for GIMP data. If the environment variable GIMP_DATADIR exists, that is used. It should be an absolute pathname. Otherwise, on Unix the compile-time defined directory is used. On Win32, the installation directory as deduced from the executable's name is used.

The returned string is allocated just once, and should *NOT* be freed with g_free().

gimp_sysconf_directory ()

gchar*      gimp_sysconf_directory          (void);

Returns the top directory for GIMP config files. If the environment variable GIMP_SYSCONFDIR exists, that is used. It should be an absolute pathname. Otherwise, on Unix the compile-time defined directory is used. On Win32, the installation directory as deduced from the executable's name is used.

The returned string is allocated just once, and should *NOT* be freed with g_free().

gimp_gtkrc ()

gchar*      gimp_gtkrc                      (void);

Returns the name of the GIMP's application-specific gtkrc file.

The returned string is allocated just once, and should *NOT* be freed with g_free().

gimp_path_parse ()

GList*      gimp_path_parse                 (gchar *path,
                                             gint max_paths,
                                             gboolean check,
                                             GList **check_failed);

gimp_path_free ()

void        gimp_path_free                  (GList *path);

This function frees the memory allocated for the list and it's strings.

gimp_path_to_str ()

gchar*      gimp_path_to_str                (GList *path);

gimp_path_get_user_writable_dir ()

gchar*      gimp_path_get_user_writable_dir (GList *path);

Note that you have to g_free() the returned string.