1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
|
/* gap_base.h
* 1997.11.01 hof (Wolfgang Hofer)
*
* GAP ... Gimp Animation Plugins
*
* basic GAP types and utility procedures
*
*/
/* The GIMP -- an image manipulation program
* Copyright (C) 1995 Spencer Kimball and Peter Mattis
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
*/
/* revision history:
* 2.5.0 2009.03.07 hof: created
*/
#ifndef _GAP_BASE_H
#define _GAP_BASE_H
#include "libgimp/gimp.h"
/* -----------------------------
* gap_base_shorten_filename
* -----------------------------
* resulting string is built from prefix filename and suffix
* filename will be shortened when
* prefix + " " + filename + " " + suffix
* is longer then max_chars.
* examples:
* gap_base_shorten_filenam("prefix", "this_is_a_very_long_filename", NULL, 20)
* returns: "prefix ...g_filename"
*
* gap_base_shorten_filenam("prefix", "shortname", NULL, 20)
* returns: "prefix shortname"
*
* the caller is responsible to g_free the returned string
*/
char *
gap_base_shorten_filename(const char *prefix
,const char *filename
,const char *suffix
,gint32 max_chars
);
/* -----------------------------
* gap_base_strdup_add_underscore
* -----------------------------
* duplicates the specifed string and if last character is no underscore add one at end.
* the caller is responsible to g_free the result after usage.
*/
char *
gap_base_strdup_add_underscore(char *name);
/* -----------------------------
* gap_base_strdup_del_underscore
* -----------------------------
* duplicates the specifed string and delete the last character
* if it is the underscore
* the caller is responsible to g_free the result after usage.
*/
char *
gap_base_strdup_del_underscore(char *name);
/* --------------------------------------------------------
* gap_base_dup_filename_and_replace_extension_by_underscore
* --------------------------------------------------------
* returns a duplicate of the specified filename where the extension
* (.xcf .jpg ...) is cut off and rplaced by the underscore character.
* example: filename = "image_000001.xcf"
* returns "image_000001_"
*
* the caller is responsible to g_free the result after usage.
*/
char *
gap_base_dup_filename_and_replace_extension_by_underscore(const char *filename);
/* --------------------------------
* gap_base_fprintf_gdouble
* --------------------------------
* print prefix and gdouble value to file
* (always use "." as decimalpoint, independent of LOCALE language settings)
*/
void
gap_base_fprintf_gdouble(FILE *fp, gdouble value, gint digits, gint precision_digits, const char *pfx);
/* --------------------------------
* gap_base_sscan_flt_numbers
* --------------------------------
* scan the blank separated buffer for 2 integer and 13 float numbers.
* always use "." as decimalpoint in the float numbers regardless to LANGUAGE settings
* return a counter that tells how many numbers were scanned successfully
*/
gint
gap_base_sscan_flt_numbers(gchar *buf
, gdouble *farr
, gint farr_max
);
/* --------------------------------
* gap_base_check_tooltips
* --------------------------------
* check and enable/disable tooltips according to global gimprc settings
*/
gboolean
gap_base_check_tooltips(gboolean *old_state);
/* -----------------------------------------
* gap_base_get_gimprc_int_value
* -----------------------------------------
* get integer configuration value for the keyname gimprc_option_name from the gimprc file.
* returns the configure value in constaint to the specified range
* (between min_value and max_value)
* the specified default_value is returned in case the gimprc
* has no entry for the specified gimprc_option_name.
*/
gint32
gap_base_get_gimprc_int_value (const char *gimprc_option_name
, gint32 default_value, gint32 min_value, gint32 max_value);
/* -----------------------------------------
* gap_base_get_gimprc_gboolean_value
* -----------------------------------------
*/
gboolean
gap_base_get_gimprc_gboolean_value (const char *gimprc_option_name
, gboolean default_value);
/* --------------------------------
* gap_base_getpid
* --------------------------------
* get process id of the current process
*/
gint32
gap_base_getpid(void);
/* --------------------------------
* gap_base_is_pid_alive
* --------------------------------
* return TRUE if the process with the specified pid
* is alive.
* WARNING:
* there is no implementation for the WINDOWS operating system
* where the return value is always TRUE.
*/
gboolean
gap_base_is_pid_alive(gint32 pid);
/* --------------------------------
* gap_base_get_current_time
* --------------------------------
* get curent system time in utc timecode
*/
gint32
gap_base_get_current_time(void);
#endif
|
