#include <gtk/gtk.h>
#include <string.h>
#include <librsvg/rsvg.h>

Include dependency graph for utility.h:

This graph shows which files directly or indirectly include this file:

Typedefs
typedef enum dt_logo_season_t	dt_logo_season_t

Enumerations
enum	dt_logo_season_t { DT_LOGO_SEASON_NONE = 0 , DT_LOGO_SEASON_HALLOWEEN = 1 , DT_LOGO_SEASON_XMAS = 2 , DT_LOGO_SEASON_EASTER = 3 }

Functions
size_t	safe_strlen (const char *str)
	check if the string is empty or NULL before calling strlen()

gchar *	dt_util_dstrcat (gchar str, const gchar format,...) __attribute__((format(printf

gchar gchar *	dt_util_str_replace (const gchar string, const gchar pattern, const gchar *substitute)

guint	dt_util_str_occurence (const gchar haystack, const gchar needle)

gchar *	dt_util_glist_to_str (const gchar separator, GList items)

GList *	dt_util_str_to_glist (const gchar separator, const gchar text)

GList *	dt_util_glist_uniq (GList *items)

gchar *	dt_util_fix_path (const gchar *path)

size_t	dt_utf8_strlcpy (char dest, const char src, size_t n)

gboolean	dt_util_test_image_file (const char *filename)

gboolean	dt_util_test_writable_dir (const char *path)

gboolean	dt_util_dir_exist (const char *dir)

gboolean	dt_util_is_dir_empty (const char *dirname)

gchar *	dt_util_foo_to_utf8 (const char *string)

guint	dt_util_string_count_char (const char *text, const char needle)

void	dt_util_str_to_loc_numbers_format (char *data)

dt_logo_season_t	dt_util_get_logo_season (void)

cairo_surface_t *	dt_util_get_logo (const float size)

cairo_surface_t *	dt_util_get_logo_text (const float size)

gchar *	dt_util_latitude_str (float latitude)

gchar *	dt_util_longitude_str (float longitude)

gchar *	dt_util_elevation_str (float elevation)

double	dt_util_gps_string_to_number (const gchar *input)

gboolean	dt_util_gps_rationale_to_number (const double r0_1, const double r0_2, const double r1_1, const double r1_2, const double r2_1, const double r2_2, char sign, double *result)

gboolean	dt_util_gps_elevation_to_number (const double r_1, const double r_2, char sign, double *result)

gchar *	dt_util_normalize_path (const gchar *input)

gchar *	dt_util_path_get_dirname (const gchar *filename)

gchar *	dt_util_format_exposure (const float exposuretime)

char *	dt_read_file (const char filename, size_t filesize)

void	dt_copy_file (const char src, const char dst)

void	dt_copy_resource_file (const char src, const char dst)

RsvgDimensionData	dt_get_svg_dimension (RsvgHandle *svg)

void	dt_render_svg (RsvgHandle svg, cairo_t cr, double width, double height, double offset_x, double offset_y)

gboolean	dt_has_same_path_basename (const char filename1, const char filename2)

char *	dt_copy_filename_extension (const char filename1, const char filename2)

gchar *	dt_str_replace (const char string, const char search, const char *replace)

gchar *	dt_cleanup_separators (gchar *string)

gchar *	dt_util_remove_whitespace (const gchar *path)

GDateTime *	dt_util_get_file_datetime (const char *const path)

Typedef Documentation

◆ dt_logo_season_t

typedef enum dt_logo_season_t dt_logo_season_t

Enumeration Type Documentation

◆ dt_logo_season_t

enum dt_logo_season_t

Enumerator
DT_LOGO_SEASON_NONE
DT_LOGO_SEASON_HALLOWEEN
DT_LOGO_SEASON_XMAS
DT_LOGO_SEASON_EASTER

Definition at line 92 of file utility.h.

Function Documentation

◆ dt_cleanup_separators()

gchar * dt_cleanup_separators ( gchar * string )

Definition at line 1059 of file utility.c.

References dt_str_replace(), and L.

Referenced by _path_cleanup(), and button_clicked().

◆ dt_copy_file()

void dt_copy_file	(	const char *	src,
		const char *	dst
	)

Definition at line 920 of file utility.c.

References IS_NULL_PTR, and L.

Referenced by dt_copy_resource_file(), and write_image().

◆ dt_copy_filename_extension()

char * dt_copy_filename_extension	(	const char *	filename1,
		const char *	filename2
	)

Definition at line 1030 of file utility.c.

References IS_NULL_PTR, and L.

◆ dt_copy_resource_file()

void dt_copy_resource_file	(	const char *	src,
		const char *	dst
	)

Definition at line 952 of file utility.c.

References dt_copy_file(), dt_free, dt_loc_get_datadir(), DT_PATH_MAX, and L.

Referenced by finalize_store().

◆ dt_get_svg_dimension()

RsvgDimensionData dt_get_svg_dimension ( RsvgHandle * svg )

Definition at line 961 of file utility.c.

References dimension(), height, L, and width.

Referenced by _util_get_svg_img(), and process().

◆ dt_has_same_path_basename()

gboolean dt_has_same_path_basename	(	const char *	filename1,
		const char *	filename2
	)

Definition at line 1011 of file utility.c.

References FALSE, i, IS_NULL_PTR, L, and TRUE.

◆ dt_read_file()

char * dt_read_file	(	const char *	filename,
		size_t *	filesize
	)

Definition at line 896 of file utility.c.

References dt_free, IS_NULL_PTR, and L.

Referenced by _read_xmp_packet(), dt_exif_xmp_write_with_imgpath(), dt_pdf_add_icc(), and load_profile_from_dir().

◆ dt_render_svg()

void dt_render_svg	(	RsvgHandle *	svg,
		cairo_t *	cr,
		double	width,
		double	height,
		double	offset_x,
		double	offset_y
	)

Definition at line 994 of file utility.c.

References height, L, and width.

Referenced by _util_get_svg_img(), and process().

◆ dt_str_replace()

gchar * dt_str_replace	(	const char *	string,
		const char *	search,
		const char *	replace
	)

Definition at line 1050 of file utility.c.

References L, and res.

Referenced by dt_cleanup_separators().

◆ dt_utf8_strlcpy()

size_t dt_utf8_strlcpy	(	char *	dest,
		const char *	src,
		size_t	n
	)

dt_utf8_strlcpy: @dest: buffer to fill with characters from @src @src: UTF-8 encoded string
: size of @dest

Like the BSD-standard strlcpy() function, but is careful not to truncate in the middle of a character. The @src string must be valid UTF-8 encoded text. (Use g_utf8_validate() on all text before trying to use UTF-8 utility functions with it.)

Return value: strlen(src) Implementation by Philip Page, see https://bugzilla.gnome.org/show_bug.cgi?id=520116

Definition at line 293 of file utility.c.

References L, and n.

Referenced by _get_profiles().

◆ dt_util_dir_exist()

gboolean dt_util_dir_exist ( const char * dir )

returns true if the path represents directories

Definition at line 371 of file utility.c.

References IS_NULL_PTR, and L.

Referenced by _import_copy_file(), and dt_collection_load_filmroll().

◆ dt_util_dstrcat()

gchar * dt_util_dstrcat	(	gchar *	str,
		const gchar *	format,
			...
	)

dynamically allocate and concatenate string

◆ dt_util_elevation_str()

gchar * dt_util_elevation_str ( float elevation )

Definition at line 590 of file utility.c.

References L, OSD_ELEVATION_ASL, and OSD_ELEVATION_BSL.

Referenced by _metadata_view_update_values().

◆ dt_util_fix_path()

gchar * dt_util_fix_path ( const gchar * path )

fixes the given path by replacing a possible tilde with the correct home directory

Definition at line 226 of file utility.c.

References dt_free, dt_loc_get_home_dir(), IS_NULL_PTR, and L.

Referenced by _update_preview(), dt_loc_init_generic(), and store().

◆ dt_util_foo_to_utf8()

gchar * dt_util_foo_to_utf8 ( const char * string )

returns a valid UTF-8 string for the given char array. has to be freed with g_free().

Definition at line 396 of file utility.c.

References IS_NULL_PTR, and L.

Referenced by _exif_decode_iptc_data(), and _sanitize_db().

◆ dt_util_format_exposure()

gchar * dt_util_format_exposure ( const float exposuretime )

Definition at line 868 of file utility.c.

References L.

Referenced by _create_alternative_view(), _expand_exif_and_gps(), _metadata_view_update_values(), dt_image_print_exif(), and update_preview_cb().

◆ dt_util_get_file_datetime()

GDateTime * dt_util_get_file_datetime ( const char *const path )

Definition at line 792 of file utility.c.

References error(), IS_NULL_PTR, and L.

Referenced by _init_expansion().

◆ dt_util_get_logo()

cairo_surface_t * dt_util_get_logo ( const float size )

Definition at line 524 of file utility.c.

References _util_get_svg_img(), DT_LOGO_SEASON_NONE, dt_util_get_logo_season(), L, and size.

Referenced by size_allocate_callback().

◆ dt_util_get_logo_season()

dt_logo_season_t dt_util_get_logo_season ( void )

returns the dt logo season to use right now

Definition at line 438 of file utility.c.

References DT_LOGO_SEASON_EASTER, DT_LOGO_SEASON_HALLOWEEN, DT_LOGO_SEASON_NONE, DT_LOGO_SEASON_XMAS, easter(), and L.

Referenced by dt_util_get_logo().

◆ dt_util_get_logo_text()

cairo_surface_t * dt_util_get_logo_text ( const float size )

Definition at line 536 of file utility.c.

References _util_get_svg_img(), L, and size.

◆ dt_util_glist_to_str()

gchar * dt_util_glist_to_str	(	const gchar *	separator,
		GList *	items
	)

generate a string from the elements of the list, separated by separator. the result has to be freed.

Definition at line 170 of file utility.c.

References dt_free, i, IS_NULL_PTR, items, and L.

Referenced by _event_dnd_get(), _expand_geometry_and_misc(), _expand_rating_and_metadata(), _save_last_tag_used(), dt_history_get_items_as_string(), dt_styles_get_item_list_as_string(), dt_tag_import(), and get_query_string().

◆ dt_util_glist_uniq()

GList * dt_util_glist_uniq ( GList * items )

take a list of strings and remove all duplicates. the result will be sorted.

Definition at line 197 of file utility.c.

References dt_free, IS_NULL_PTR, items, L, and value.

Referenced by dt_tag_get_list(), and dt_tag_get_list_export().

◆ dt_util_gps_elevation_to_number()

gboolean dt_util_gps_elevation_to_number	(	const double	r_1,
		const double	r_2,
		char	sign,
		double *	result
	)

Definition at line 665 of file utility.c.

References FALSE, IS_NULL_PTR, L, res, sign, and TRUE.

Referenced by _exif_decode_exif_data(), and dt_exif_decode_xmp_data().

◆ dt_util_gps_rationale_to_number()

gboolean dt_util_gps_rationale_to_number	(	const double	r0_1,
		const double	r0_2,
		const double	r1_1,
		const double	r1_2,
		const double	r2_1,
		const double	r2_2,
		char	sign,
		double *	result
	)