LiVES  2.0.3
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros
widget-helper.h
Go to the documentation of this file.
1 // widget-helper.h
2 // LiVES
3 // (c) G. Finch 2012 - 2013 <salsaman@gmail.com>
4 // released under the GNU GPL 3 or later
5 // see file ../COPYING or www.gnu.org for licensing details
6 
7 #ifndef HAS_LIVES_WIDGET_HELPER_H
8 #define HAS_LIVES_WIDGET_HELPER_H
9 
10 #ifndef M_PI
11 #define M_PI 3.1415926536
12 #endif
13 
14 typedef enum {
19 
20 
21 #define W_PACKING_WIDTH 10 // packing width for widgets with labels
22 #define W_PACKING_HEIGHT 10 // packing height for widgets
23 #define W_BORDER_WIDTH 10 // default border width
24 
25 
26 #ifdef PAINTER_CAIRO
27 typedef cairo_t lives_painter_t;
28 typedef cairo_surface_t lives_painter_surface_t;
29 
30 typedef cairo_format_t lives_painter_format_t;
31 
32 #define LIVES_PAINTER_FORMAT_A1 CAIRO_FORMAT_A1
33 #define LIVES_PAINTER_FORMAT_A8 CAIRO_FORMAT_A8
34 #define LIVES_PAINTER_FORMAT_ARGB32 CAIRO_FORMAT_ARGB32
35 
36 
37 typedef cairo_content_t lives_painter_content_t; // eg. color, alpha, color+alpha
38 
39 #define LIVES_PAINTER_CONTENT_COLOR CAIRO_CONTENT_COLOR
40 
41 
42 typedef cairo_operator_t lives_painter_operator_t;
43 
44 #define LIVES_PAINTER_OPERATOR_UNKNOWN CAIRO_OPERATOR_OVER
45 #define LIVES_PAINTER_OPERATOR_DEFAULT CAIRO_OPERATOR_OVER
46 
47 #define LIVES_PAINTER_OPERATOR_DEST_OUT CAIRO_OPERATOR_DEST_OUT
48 #if CAIRO_VERSION < CAIRO_VERSION_ENCODE(1, 10, 0)
49 #define LIVES_PAINTER_OPERATOR_DIFFERENCE CAIRO_OPERATOR_OVER
50 #else
51 #define LIVES_PAINTER_OPERATOR_DIFFERENCE CAIRO_OPERATOR_DIFFERENCE
52 #endif
53 
54 typedef cairo_fill_rule_t lives_painter_fill_rule_t;
55 
56 #define LIVES_PAINTER_FILL_RULE_WINDING CAIRO_FILL_RULE_WINDING
57 #define LIVES_PAINTER_FILL_RULE_EVEN_ODD CAIRO_FILL_RULE_EVEN_ODD
58 
59 
60 #endif
61 
62 
63 #ifdef GUI_GTK
64 
65 #ifndef G_ENCODE_VERSION
66 #define G_ENCODE_VERSION(major,minor) ((major) << 16 | (minor) << 8)
67 #endif
68 
69 #define return_true gtk_true
70 
71 typedef GtkJustification LiVESJustification;
72 
73 #define LIVES_JUSTIFY_LEFT GTK_JUSTIFY_LEFT
74 #define LIVES_JUSTIFY_RIGHT GTK_JUSTIFY_RIGHT
75 #define LIVES_JUSTIFY_CENTER GTK_JUSTIFY_CENTER
76 #define LIVES_JUSTIFY_FILL GTK_JUSTIFY_RIGHT
77 
78 typedef GtkOrientation LiVESOrientation;
79 #define LIVES_ORIENTATION_HORIZONTAL GTK_ORIENTATION_HORIZONTAL
80 #define LIVES_ORIENTATION_VERTICAL GTK_ORIENTATION_VERTICAL
81 
82 typedef GdkEvent LiVESXEvent;
83 typedef GdkDisplay LiVESXDisplay;
84 typedef GdkScreen LiVESXScreen;
85 typedef GdkDevice LiVESXDevice;
86 
87 #if GTK_CHECK_VERSION(3,0,0)
88 typedef GdkDeviceManager LiVESXDeviceManager;
89 #endif
90 
91 #if GTK_CHECK_VERSION(3,0,0)
92 #define LIVES_WIDGET_EVENT_EXPOSE_EVENT "draw"
93 #define GTK_OBJECT(a) a
94 #else
95 typedef GtkObject LiVESObject;
96 #define LIVES_WIDGET_EVENT_EXPOSE_EVENT "expose_event"
97 #endif
98 typedef GtkWidget LiVESWidget;
99 typedef GtkContainer LiVESContainer;
100 typedef GtkBin LiVESBin;
101 typedef GtkDialog LiVESDialog;
102 typedef GtkBox LiVESBox;
103 typedef GtkComboBox LiVESCombo;
104 typedef GtkComboBox LiVESComboBox;
105 typedef GtkButton LiVESButton;
106 typedef GtkToggleButton LiVESToggleButton;
107 typedef GtkTextView LiVESTextView;
108 typedef GtkEntry LiVESEntry;
109 typedef GtkRadioButton LiVESRadioButton;
110 typedef GtkSpinButton LiVESSpinButton;
111 typedef GtkLabel LiVESLabel;
112 typedef GtkFileChooser LiVESFileChooser;
113 typedef GtkImageMenuItem LiVESImageMenuItem;
114 typedef GtkTreeView LiVESTreeView;
115 typedef GtkTreeModel LiVESTreeModel;
116 
117 #if GTK_CHECK_VERSION(2,14,0)
118 typedef GtkScaleButton LiVESScaleButton;
119 #else
120 typedef GtkRange LiVESScaleButton;
121 #endif
122 
123 
124 #if GTK_CHECK_VERSION(3,0,0)
125 #define LIVES_WIDGET_COLOR_HAS_ALPHA (1)
126 #define LIVES_WIDGET_COLOR_SCALE(x) (x)
127 #define LIVES_WIDGET_COLOR_SCALE_255(x) ((double)x/255.)
128 typedef GdkRGBA LiVESWidgetColor;
129 typedef GtkStateFlags LiVESWidgetState;
130 
131 #define LIVES_WIDGET_STATE_NORMAL GTK_STATE_FLAG_NORMAL
132 #define LIVES_WIDGET_STATE_ACTIVE GTK_STATE_FLAG_ACTIVE
133 #define LIVES_WIDGET_STATE_PRELIGHT GTK_STATE_FLAG_PRELIGHT
134 #define LIVES_WIDGET_STATE_SELECTED GTK_STATE_FLAG_SELECTED
135 #define LIVES_WIDGET_STATE_INSENSITIVE GTK_STATE_FLAG_INSENSITIVE
136 #define LIVES_WIDGET_STATE_INCONSISTENT GTK_STATE_FLAG_INCONSISTENT
137 #define LIVES_WIDGET_STATE_FOCUSED GTK_STATE_FLAG_FOCUSED
138 #define LIVES_WIDGET_STATE_BACKDROP GTK_STATE_FLAG_BACKDROP
139 
140 #else
141 #define LIVES_WIDGET_COLOR_HAS_ALPHA (0)
142 #define LIVES_WIDGET_COLOR_SCALE(x) ((double)x/65535.)
143 #define LIVES_WIDGET_COLOR_SCALE_255(x) ((int)((double)x*256.+.5))
144 typedef GdkColor LiVESWidgetColor;
145 typedef GtkStateType LiVESWidgetState;
146 
147 #define LIVES_WIDGET_STATE_NORMAL GTK_STATE_NORMAL
148 #define LIVES_WIDGET_STATE_ACTIVE GTK_STATE_ACTIVE
149 #define LIVES_WIDGET_STATE_PRELIGHT GTK_STATE_PRELIGHT
150 #define LIVES_WIDGET_STATE_SELECTED GTK_STATE_SELECTED
151 #define LIVES_WIDGET_STATE_INSENSITIVE GTK_STATE_INSENSITIVE
152 #define LIVES_WIDGET_STATE_INCONSISTENT GTK_STATE_INSENSITIVE+1
153 #define LIVES_WIDGET_STATE_FOCUSED GTK_STATE_INSENSITIVE+2
154 #define LIVES_WIDGET_STATE_BACKDROP GTK_STATE_INSENSITIVE+3
155 #endif
156 
157 typedef enum {
158  LIVES_FILE_CHOOSER_ACTION_OPEN=GTK_FILE_CHOOSER_ACTION_OPEN,
159  LIVES_FILE_CHOOSER_ACTION_SAVE=GTK_FILE_CHOOSER_ACTION_SAVE,
160  LIVES_FILE_CHOOSER_ACTION_SELECT_FOLDER=GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER,
161  LIVES_FILE_CHOOSER_ACTION_CREATE_FOLDER=GTK_FILE_CHOOSER_ACTION_CREATE_FOLDER,
162  LIVES_FILE_CHOOSER_ACTION_SELECT_DEVICE
163 } lives_file_chooser_action_t;
164 
165 
166 typedef enum {
167  LIVES_ICON_SIZE_INVALID=GTK_ICON_SIZE_INVALID,
168  LIVES_ICON_SIZE_MENU=GTK_ICON_SIZE_MENU,
169  LIVES_ICON_SIZE_SMALL_TOOLBAR=GTK_ICON_SIZE_SMALL_TOOLBAR,
170  LIVES_ICON_SIZE_LARGE_TOOLBAR=GTK_ICON_SIZE_LARGE_TOOLBAR,
171  LIVES_ICON_SIZE_BUTTON=GTK_ICON_SIZE_BUTTON,
172  LIVES_ICON_SIZE_DND=GTK_ICON_SIZE_DND,
173  LIVES_ICON_SIZE_DIALOG=GTK_ICON_SIZE_DIALOG
174 } lives_icon_size_t;
175 
176 
177 
178 #if GTK_CHECK_VERSION(3,0,0)
179 typedef GtkScale LiVESRuler;
180 #else
181 typedef GtkRuler LiVESRuler;
182 #endif
183 
184 typedef GtkRange LiVESRange;
185 
186 typedef GtkAdjustment LiVESAdjustment;
187 
188 typedef GdkPixbuf LiVESPixbuf;
189 
190 typedef GdkWindow LiVESXWindow;
191 
192 typedef GdkEventButton LiVESXEventButton;
193 
194 typedef GdkCursor LiVESXCursor;
195 
196 typedef GError LiVESError;
197 
198 #ifndef IS_MINGW
199 typedef gboolean boolean;
200 #endif
201 
202 typedef GList LiVESList;
203 typedef GSList LiVESSList;
204 
205 typedef GtkAccelGroup LiVESAccelGroup;
206 
207 typedef GdkPixbufDestroyNotify LiVESPixbufDestroyNotify;
208 
209 typedef GdkInterpType LiVESInterpType;
210 
211 typedef gpointer LiVESObjectPtr;
212 
213 #define LIVES_WIDGET(widget) GTK_WIDGET(widget)
214 #define LIVES_PIXBUF(widget) GDK_PIXBUF(widget)
215 #define LIVES_WINDOW(widget) GTK_WINDOW(widget)
216 #define LIVES_XWINDOW(widget) GDK_WINDOW(widget)
217 #define LIVES_BOX(widget) GTK_BOX(widget)
218 #define LIVES_ENTRY(widget) GTK_ENTRY(widget)
219 #define LIVES_CONTAINER(widget) GTK_CONTAINER(widget)
220 #define LIVES_BIN(widget) GTK_BIN(widget)
221 #define LIVES_ADJUSTMENT(widget) GTK_ADJUSTMENT(widget)
222 #define LIVES_DIALOG(widget) GTK_DIALOG(widget)
223 #define LIVES_COMBO(widget) GTK_COMBO_BOX(widget)
224 #define LIVES_COMBO_BOX(widget) GTK_COMBO_BOX(widget)
225 #define LIVES_BUTTON(widget) GTK_BUTTON(widget)
226 #define LIVES_LABEL(widget) GTK_LABEL(widget)
227 #define LIVES_FILES_CHOOSER(widget) GTK_FILE_CHOOSER(widget)
228 #define LIVES_RADIO_BUTTON(widget) GTK_RADIO_BUTTON(widget)
229 #define LIVES_SPIN_BUTTON(widget) GTK_SPIN_BUTTON(widget)
230 #define LIVES_IMAGE_MENU_ITEM(widget) GTK_IMAGE_MENU_ITEM(widget)
231 #define LIVES_FILE_CHOOSER(widget) GTK_FILE_CHOOSER(widget)
232 
233 #if GTK_CHECK_VERSION(2,14,0)
234 #define LIVES_SCALE_BUTTON(widget) GTK_SCALE_BUTTON(widget)
235 #else
236 #define LIVES_SCALE_BUTTON(widget) GTK_RANGE(widget)
237 #endif
238 
239 #define LIVES_TOGGLE_BUTTON(widget) GTK_TOGGLE_BUTTON(widget)
240 #define LIVES_TREE_VIEW(widget) GTK_TREE_VIEW(widget)
241 #define LIVES_TEXT_VIEW(widget) GTK_TEXT_VIEW(widget)
242 
243 #if GTK_CHECK_VERSION(3,0,0)
244 #define LIVES_RULER(widget) GTK_SCALE(widget)
245 #define LIVES_ORIENTABLE(widget) GTK_ORIENTABLE(widget)
246 #else
247 #define LIVES_RULER(widget) GTK_RULER(widget)
248 #endif
249 
250 #define LIVES_RANGE(widget) GTK_RANGE(widget)
251 
252 #define LIVES_XEVENT(event) GDK_EVENT(event)
253 
254 #define LIVES_IS_WIDGET(widget) GTK_IS_WIDGET(widget)
255 #if GTK_CHECK_VERSION(3,0,0)
256 #define LIVES_IS_HBOX(widget) (GTK_IS_BOX(widget)&&gtk_orientable_get_orientation(GTK_ORIENTABLE(widget))==GTK_ORIENTATION_HORIZONTAL)
257 #define LIVES_IS_VBOX(widget) (GTK_IS_BOX(widget)&&gtk_orientable_get_orientation(GTK_ORIENTABLE(widget))==GTK_ORIENTATION_HORIZONTAL)
258 #else
259 #define LIVES_IS_HBOX(widget) GTK_IS_HBOX(widget)
260 #define LIVES_IS_VBOX(widget) GTK_IS_VBOX(widget)
261 #endif
262 #define LIVES_IS_COMBO(widget) GTK_IS_COMBO_BOX(widget)
263 #define LIVES_IS_BUTTON(widget) GTK_IS_BUTTON(widget)
264 
265 #define LIVES_INTERP_BEST GDK_INTERP_HYPER
266 #define LIVES_INTERP_NORMAL GDK_INTERP_BILINEAR
267 #define LIVES_INTERP_FAST GDK_INTERP_NEAREST
268 
269 typedef GLogLevelFlags LiVESLogLevelFlags;
270 
271 #define LIVES_LOG_LEVEL_WARNING G_LOG_LEVEL_WARNING
272 #define LIVES_LOG_LEVEL_MASK G_LOG_LEVEL_MASK
273 #define LIVES_LOG_LEVEL_CRITICAL G_LOG_LEVEL_CRITICAL
274 #define LIVES_LOG_FATAL_MASK G_LOG_FATAL_MASK
275 
276 typedef GdkModifierType LiVESModifierType;
277 
278 #define LIVES_CONTROL_MASK GDK_CONTROL_MASK
279 #define LIVES_ALT_MASK GDK_MOD1_MASK
280 #define LIVES_SHIFT_MASK GDK_SHIFT_MASK
281 #define LIVES_LOCK_MASK GDK_LOCK_MASK
282 
283 #ifdef GDK_KEY_a
284 #define LIVES_KEY_Left GDK_KEY_Left
285 #define LIVES_KEY_Right GDK_KEY_Right
286 #define LIVES_KEY_Up GDK_KEY_Up
287 #define LIVES_KEY_Down GDK_KEY_Down
288 
289 #define LIVES_KEY_Space GDK_KEY_space
290 #define LIVES_KEY_BackSpace GDK_KEY_BackSpace
291 #define LIVES_KEY_Return GDK_KEY_Return
292 #define LIVES_KEY_Tab GDK_KEY_Tab
293 #define LIVES_KEY_Home GDK_KEY_Home
294 #define LIVES_KEY_End GDK_KEY_End
295 #define LIVES_KEY_Slash GDK_KEY_slash
296 #define LIVES_KEY_Space GDK_KEY_space
297 #define LIVES_KEY_Plus GDK_KEY_plus
298 #define LIVES_KEY_Minus GDK_KEY_minus
299 #define LIVES_KEY_Equal GDK_KEY_equal
300 
301 #define LIVES_KEY_1 GDK_KEY_1
302 #define LIVES_KEY_2 GDK_KEY_2
303 #define LIVES_KEY_3 GDK_KEY_3
304 #define LIVES_KEY_4 GDK_KEY_4
305 #define LIVES_KEY_5 GDK_KEY_5
306 #define LIVES_KEY_6 GDK_KEY_6
307 #define LIVES_KEY_7 GDK_KEY_7
308 #define LIVES_KEY_8 GDK_KEY_8
309 #define LIVES_KEY_9 GDK_KEY_9
310 #define LIVES_KEY_0 GDK_KEY_0
311 
312 #define LIVES_KEY_a GDK_KEY_a
313 #define LIVES_KEY_b GDK_KEY_b
314 #define LIVES_KEY_c GDK_KEY_c
315 #define LIVES_KEY_d GDK_KEY_d
316 #define LIVES_KEY_e GDK_KEY_e
317 #define LIVES_KEY_f GDK_KEY_f
318 #define LIVES_KEY_g GDK_KEY_g
319 #define LIVES_KEY_h GDK_KEY_h
320 #define LIVES_KEY_i GDK_KEY_i
321 #define LIVES_KEY_j GDK_KEY_j
322 #define LIVES_KEY_k GDK_KEY_k
323 #define LIVES_KEY_l GDK_KEY_l
324 #define LIVES_KEY_m GDK_KEY_m
325 #define LIVES_KEY_n GDK_KEY_n
326 #define LIVES_KEY_o GDK_KEY_o
327 #define LIVES_KEY_p GDK_KEY_p
328 #define LIVES_KEY_q GDK_KEY_q
329 #define LIVES_KEY_r GDK_KEY_r
330 #define LIVES_KEY_s GDK_KEY_s
331 #define LIVES_KEY_t GDK_KEY_t
332 #define LIVES_KEY_u GDK_KEY_u
333 #define LIVES_KEY_v GDK_KEY_v
334 #define LIVES_KEY_w GDK_KEY_w
335 #define LIVES_KEY_x GDK_KEY_x
336 #define LIVES_KEY_y GDK_KEY_y
337 #define LIVES_KEY_z GDK_KEY_z
338 
339 #define LIVES_KEY_F1 GDK_KEY_F1
340 #define LIVES_KEY_F2 GDK_KEY_F2
341 #define LIVES_KEY_F3 GDK_KEY_F3
342 #define LIVES_KEY_F4 GDK_KEY_F4
343 #define LIVES_KEY_F5 GDK_KEY_F5
344 #define LIVES_KEY_F6 GDK_KEY_F6
345 #define LIVES_KEY_F7 GDK_KEY_F7
346 #define LIVES_KEY_F8 GDK_KEY_F8
347 #define LIVES_KEY_F9 GDK_KEY_F9
348 #define LIVES_KEY_F10 GDK_KEY_F10
349 #define LIVES_KEY_F11 GDK_KEY_F11
350 #define LIVES_KEY_F12 GDK_KEY_F12
351 
352 #define LIVES_KEY_Page_Up GDK_KEY_Page_Up
353 #define LIVES_KEY_Page_Down GDK_KEY_Page_Down
354 
355 #define LIVES_KEY_Escape GDK_KEY_Escape
356 
357 #else
358 #define LIVES_KEY_Left GDK_Left
359 #define LIVES_KEY_Right GDK_Right
360 #define LIVES_KEY_Up GDK_Up
361 #define LIVES_KEY_Down GDK_Down
362 
363 #define LIVES_KEY_Space GDK_space
364 #define LIVES_KEY_BackSpace GDK_BackSpace
365 #define LIVES_KEY_Return GDK_Return
366 #define LIVES_KEY_Tab GDK_Tab
367 #define LIVES_KEY_Home GDK_Home
368 #define LIVES_KEY_End GDK_End
369 #define LIVES_KEY_Slash GDK_slash
370 #define LIVES_KEY_Space GDK_space
371 #define LIVES_KEY_Plus GDK_plus
372 #define LIVES_KEY_Minus GDK_minus
373 #define LIVES_KEY_Equal GDK_equal
374 
375 #define LIVES_KEY_1 GDK_1
376 #define LIVES_KEY_2 GDK_2
377 #define LIVES_KEY_3 GDK_3
378 #define LIVES_KEY_4 GDK_4
379 #define LIVES_KEY_5 GDK_5
380 #define LIVES_KEY_6 GDK_6
381 #define LIVES_KEY_7 GDK_7
382 #define LIVES_KEY_8 GDK_8
383 #define LIVES_KEY_9 GDK_9
384 #define LIVES_KEY_0 GDK_0
385 
386 #define LIVES_KEY_a GDK_a
387 #define LIVES_KEY_b GDK_b
388 #define LIVES_KEY_c GDK_c
389 #define LIVES_KEY_d GDK_d
390 #define LIVES_KEY_e GDK_e
391 #define LIVES_KEY_f GDK_f
392 #define LIVES_KEY_g GDK_g
393 #define LIVES_KEY_h GDK_h
394 #define LIVES_KEY_i GDK_i
395 #define LIVES_KEY_j GDK_j
396 #define LIVES_KEY_k GDK_k
397 #define LIVES_KEY_l GDK_l
398 #define LIVES_KEY_m GDK_m
399 #define LIVES_KEY_n GDK_n
400 #define LIVES_KEY_o GDK_o
401 #define LIVES_KEY_p GDK_p
402 #define LIVES_KEY_q GDK_q
403 #define LIVES_KEY_r GDK_r
404 #define LIVES_KEY_s GDK_s
405 #define LIVES_KEY_t GDK_t
406 #define LIVES_KEY_u GDK_u
407 #define LIVES_KEY_v GDK_v
408 #define LIVES_KEY_w GDK_w
409 #define LIVES_KEY_x GDK_x
410 #define LIVES_KEY_y GDK_y
411 #define LIVES_KEY_z GDK_z
412 
413 #define LIVES_KEY_F1 GDK_F1
414 #define LIVES_KEY_F2 GDK_F2
415 #define LIVES_KEY_F3 GDK_F3
416 #define LIVES_KEY_F4 GDK_F4
417 #define LIVES_KEY_F5 GDK_F5
418 #define LIVES_KEY_F6 GDK_F6
419 #define LIVES_KEY_F7 GDK_F7
420 #define LIVES_KEY_F8 GDK_F8
421 #define LIVES_KEY_F9 GDK_F9
422 #define LIVES_KEY_F10 GDK_F10
423 #define LIVES_KEY_F11 GDK_F11
424 #define LIVES_KEY_F12 GDK_F12
425 
426 #define LIVES_KEY_Page_Up GDK_Page_Up
427 #define LIVES_KEY_Page_Down GDK_Page_Down
428 
429 #define LIVES_KEY_Escape GDK_Escape
430 
431 #endif
432 
433 #endif
434 
435 
436 #ifdef GUI_QT
437 typedef QImage LiVESPixbuf;
438 typedef bool boolean;
439 typedef int gint;
440 typedef uchar guchar;
441 typedef (void *) gpointer;
442 typedef (void *)(LiVESPixbufDestroyNotify(uchar *, gpointer));
443 
444 // etc.
445 
446 
447 
448 #define LIVES_INTERP_BEST Qt::SmoothTransformation
449 #define LIVES_INTERP_NORMAL Qt::SmoothTransformation
450 #define LIVES_INTERP_FAST Qt::FastTransformation
451 
452 
453 #endif
454 
455 
456 
457 
458 
459 
460 
461 
462 
463 
464 
465 
466 
467 
468 // basic functions (wrappers for Toolkit functions)
469 
470 // lives_painter_functions
471 
472 lives_painter_t *lives_painter_create(lives_painter_surface_t *target);
473 lives_painter_t *lives_painter_create_from_widget(LiVESWidget *);
474 void lives_painter_set_source_pixbuf (lives_painter_t *, const LiVESPixbuf *, double pixbuf_x, double pixbuf_y);
475 void lives_painter_set_source_surface (lives_painter_t *, lives_painter_surface_t *, double x, double y);
476 lives_painter_surface_t *lives_painter_image_surface_create(lives_painter_format_t format, int width, int height);
477 lives_painter_surface_t *lives_painter_image_surface_create_for_data(uint8_t *data, lives_painter_format_t,
478  int width, int height, int stride);
479 lives_painter_surface_t *lives_painter_surface_create_from_widget(LiVESWidget *, lives_painter_content_t,
480  int width, int height);
481 void lives_painter_surface_flush(lives_painter_surface_t *);
482 
483 void lives_painter_destroy(lives_painter_t *);
484 void lives_painter_surface_destroy(lives_painter_surface_t *);
485 
486 void lives_painter_new_path(lives_painter_t *);
487 
488 void lives_painter_paint(lives_painter_t *);
489 void lives_painter_fill(lives_painter_t *);
490 void lives_painter_stroke(lives_painter_t *);
491 void lives_painter_clip(lives_painter_t *);
492 
493 void lives_painter_set_source_rgb(lives_painter_t *, double red, double green, double blue);
494 void lives_painter_set_source_rgba(lives_painter_t *, double red, double green, double blue, double alpha);
495 
496 void lives_painter_set_line_width(lives_painter_t *, double width);
497 
498 void lives_painter_translate(lives_painter_t *, double x, double y);
499 
500 void lives_painter_rectangle(lives_painter_t *, double x, double y, double width, double height);
501 void lives_painter_arc(lives_painter_t *, double xc, double yc, double radius, double angle1, double angle2);
502 void lives_painter_line_to(lives_painter_t *, double x, double y);
503 void lives_painter_move_to(lives_painter_t *, double x, double y);
504 
505 boolean lives_painter_set_operator(lives_painter_t *, lives_painter_operator_t);
506 
507 void lives_painter_set_fill_rule(lives_painter_t *, lives_painter_fill_rule_t);
508 
509 
510 lives_painter_surface_t *lives_painter_get_target(lives_painter_t *);
511 int lives_painter_format_stride_for_width(lives_painter_format_t, int width);
512 
513 uint8_t *lives_painter_image_surface_get_data(lives_painter_surface_t *);
514 int lives_painter_image_surface_get_width(lives_painter_surface_t *);
515 int lives_painter_image_surface_get_height(lives_painter_surface_t *);
516 int lives_painter_image_surface_get_stride(lives_painter_surface_t *);
517 lives_painter_format_t lives_painter_image_surface_get_format(lives_painter_surface_t *);
518 
519 
520 
521 
522 // utils
523 
524 
525 // object funcs.
526 
527 void lives_object_unref(LiVESObjectPtr);
528 
529 
530 // lives_pixbuf functions
531 
532 int lives_pixbuf_get_width(const LiVESPixbuf *);
533 int lives_pixbuf_get_height(const LiVESPixbuf *);
534 boolean lives_pixbuf_get_has_alpha(const LiVESPixbuf *);
535 int lives_pixbuf_get_rowstride(const LiVESPixbuf *);
536 int lives_pixbuf_get_n_channels(const LiVESPixbuf *);
537 unsigned char *lives_pixbuf_get_pixels(const LiVESPixbuf *);
538 const unsigned char *lives_pixbuf_get_pixels_readonly(const LiVESPixbuf *);
539 LiVESPixbuf *lives_pixbuf_new(boolean has_alpha, int width, int height);
540 LiVESPixbuf *lives_pixbuf_new_from_data (const unsigned char *buf, boolean has_alpha, int width, int height,
541  int rowstride, LiVESPixbufDestroyNotify lives_free_buffer_fn,
542  gpointer destroy_fn_data);
543 
544 LiVESPixbuf *lives_pixbuf_new_from_file(const char *filename, LiVESError **error);
545 LiVESPixbuf *lives_pixbuf_new_from_file_at_scale(const char *filename, int width, int height, boolean preserve_aspect_ratio,
546  LiVESError **error);
547 
548 
549 LiVESPixbuf *lives_pixbuf_scale_simple(const LiVESPixbuf *src, int dest_width, int dest_height,
550  LiVESInterpType interp_type);
551 
552 // basic widget fns
553 
554 void lives_widget_set_bg_color(LiVESWidget *, LiVESWidgetState state, const LiVESWidgetColor *);
555 void lives_widget_set_fg_color(LiVESWidget *, LiVESWidgetState state, const LiVESWidgetColor *);
556 void lives_widget_set_text_color(LiVESWidget *, LiVESWidgetState state, const LiVESWidgetColor *);
557 void lives_widget_set_base_color(LiVESWidget *, LiVESWidgetState state, const LiVESWidgetColor *);
558 
559 void lives_widget_get_fg_state_color(LiVESWidget *, LiVESWidgetState state, LiVESWidgetColor *);
560 void lives_widget_get_bg_state_color(LiVESWidget *, LiVESWidgetState state, LiVESWidgetColor *);
561 
562 boolean lives_color_parse(const char *spec, LiVESWidgetColor *);
563 
564 LiVESWidgetColor *lives_widget_color_copy(LiVESWidgetColor *c1orNULL, const LiVESWidgetColor *c2);
565 
566 LiVESWidget *lives_image_new_from_stock(const char *stock_id, lives_icon_size_t size);
567 
568 LiVESWidget *lives_dialog_get_content_area(LiVESDialog *);
569 LiVESWidget *lives_dialog_get_action_area(LiVESDialog *);
570 
571 LiVESAdjustment *lives_adjustment_new(double value, double lower, double upper,
572  double step_increment, double page_increment, double page_size);
573 
574 void lives_box_set_homogeneous(LiVESBox *, boolean homogeneous);
575 void lives_box_set_spacing(LiVESBox *, int spacing);
576 
577 LiVESWidget *lives_hbox_new(boolean homogeneous, int spacing);
578 LiVESWidget *lives_vbox_new(boolean homogeneous, int spacing);
579 
580 LiVESWidget *lives_hseparator_new(void);
581 LiVESWidget *lives_vseparator_new(void);
582 
583 LiVESWidget *lives_hbutton_box_new(void);
584 LiVESWidget *lives_vbutton_box_new(void);
585 
586 LiVESWidget *lives_hscale_new(LiVESAdjustment *);
587 LiVESWidget *lives_vscale_new(LiVESAdjustment *);
588 
589 LiVESWidget *lives_hpaned_new(void);
590 LiVESWidget *lives_vpaned_new(void);
591 
592 LiVESWidget *lives_hscrollbar_new(LiVESAdjustment *);
593 LiVESWidget *lives_vscrollbar_new(LiVESAdjustment *);
594 
595 LiVESWidget *lives_combo_new(void);
596 LiVESWidget *lives_combo_new_with_model (LiVESTreeModel *model);
597 
598 void lives_combo_append_text(LiVESCombo *, const char *text);
599 void lives_combo_set_entry_text_column(LiVESCombo *, int column);
600 
601 char *lives_combo_get_active_text(LiVESCombo *) WARN_UNUSED;
602 void lives_combo_set_active_text(LiVESCombo *, const char *text);
603 
604 void lives_combo_set_active_string(LiVESCombo *, const char *active_str);
605 
606 LiVESWidget *lives_combo_get_entry(LiVESCombo *);
607 
608 void lives_combo_populate(LiVESCombo *, LiVESList *list);
609 
610 boolean lives_toggle_button_get_active(LiVESToggleButton *);
611 void lives_toggle_button_set_active(LiVESToggleButton *, boolean active);
612 
613 void lives_tooltips_set (LiVESWidget *, const char *tip_text);
614 
615 LiVESSList *lives_radio_button_get_group(LiVESRadioButton *);
616 
617 LiVESWidget *lives_widget_get_parent(LiVESWidget *);
618 
619 LiVESXWindow *lives_widget_get_xwindow(LiVESWidget *);
620 
621 void lives_widget_set_can_focus(LiVESWidget *, boolean state);
622 void lives_widget_set_can_default(LiVESWidget *, boolean state);
623 
624 void lives_container_remove(LiVESContainer *, LiVESWidget *);
625 
626 double lives_ruler_get_value(LiVESRuler *);
627 double lives_ruler_set_value(LiVESRuler *, double value);
628 
629 void lives_ruler_set_range(LiVESRuler *, double lower, double upper, double position, double max_size);
630 double lives_ruler_set_upper(LiVESRuler *, double value);
631 double lives_ruler_set_lower(LiVESRuler *, double value);
632 
633 int lives_widget_get_allocation_x(LiVESWidget *);
634 int lives_widget_get_allocation_y(LiVESWidget *);
635 int lives_widget_get_allocation_width(LiVESWidget *);
636 int lives_widget_get_allocation_height(LiVESWidget *);
637 
638 void lives_widget_set_state(LiVESWidget *, LiVESWidgetState state);
639 LiVESWidgetState lives_widget_get_state(LiVESWidget *widget);
640 
641 LiVESWidget *lives_bin_get_child(LiVESBin *);
642 
643 boolean lives_widget_is_sensitive(LiVESWidget *);
644 boolean lives_widget_is_visible(LiVESWidget *);
645 boolean lives_widget_is_realized(LiVESWidget *);
646 
647 
648 double lives_adjustment_get_upper(LiVESAdjustment *);
649 double lives_adjustment_get_lower(LiVESAdjustment *);
650 double lives_adjustment_get_page_size(LiVESAdjustment *);
651 
652 void lives_adjustment_set_upper(LiVESAdjustment *, double upper);
653 void lives_adjustment_set_lower(LiVESAdjustment *, double lower);
654 void lives_adjustment_set_page_size(LiVESAdjustment *, double page_size);
655 
656 LiVESAdjustment *lives_tree_view_get_hadjustment(LiVESTreeView *);
657 
658 const char *lives_label_get_text(LiVESLabel *);
659 
660 void lives_entry_set_editable(LiVESEntry *, boolean editable);
661 
662 double lives_scale_button_get_value(LiVESScaleButton *);
663 
664 void lives_widget_get_pointer(LiVESXDevice *, LiVESWidget *, int *x, int *y);
665 LiVESXWindow *lives_display_get_window_at_pointer (LiVESXDevice *, LiVESXDisplay *, int *win_x, int *win_y);
666 void lives_display_get_pointer (LiVESXDevice *, LiVESXDisplay *, LiVESXScreen **, int *x, int *y, LiVESModifierType *mask);
667 void lives_display_warp_pointer (LiVESXDevice *, LiVESXDisplay *, LiVESXScreen *, int x, int y);
668 
669 LiVESXDisplay *lives_widget_get_display(LiVESWidget *);
671 
672 uint64_t lives_widget_get_xwinid(LiVESWidget *, const gchar *failure_msg);
673 
674 
675 // optional (return TRUE if implemented)
676 
677 boolean lives_dialog_set_has_separator(LiVESDialog *, boolean has);
678 boolean lives_widget_set_hexpand(LiVESWidget *, boolean state);
679 boolean lives_widget_set_vexpand(LiVESWidget *, boolean state);
680 boolean lives_image_menu_item_set_always_show_image(LiVESImageMenuItem *, boolean show);
681 boolean lives_scale_button_set_orientation(LiVESScaleButton *, LiVESOrientation orientation);
682 
683 // compound functions (composed of basic functions)
684 
685 void lives_painter_set_source_to_bg(lives_painter_t *, LiVESWidget *);
686 
687 LiVESWidget *lives_standard_label_new(const char *text);
688 LiVESWidget *lives_standard_label_new_with_mnemonic(const char *text, LiVESWidget *mnemonic_widget);
689 
690 LiVESWidget *lives_standard_check_button_new(const char *labeltext, boolean use_mnemonic, LiVESBox *box, const char *tooltip);
691 LiVESWidget *lives_standard_radio_button_new(const char *labeltext, boolean use_mnemonic, LiVESSList *rbgroup,
692  LiVESBox *, const char *tooltip);
693 LiVESWidget *lives_standard_spin_button_new(const char *labeltext, boolean use_mnemonic, double val, double min,
694  double max, double step, double page, int dp, LiVESBox *,
695  const char *tooltip);
696 LiVESWidget *lives_standard_combo_new (const char *labeltext, boolean use_mnemonic, LiVESList *list, LiVESBox *,
697  const char *tooltip);
698 
699 LiVESWidget *lives_standard_entry_new(const char *labeltext, boolean use_mnemonic, const char *txt, int dispwidth, int maxchars, LiVESBox *,
700  const char *tooltip);
701 
702 LiVESWidget *lives_standard_dialog_new(const char *title, boolean add_std_buttons);
703 
704 LiVESWidget *lives_standard_hruler_new(void);
705 
706 LiVESWidget *lives_standard_scrolled_window_new(int width, int height, LiVESWidget *child);
707 
708 LiVESWidget *lives_standard_expander_new(const char *label, boolean use_mnemonic, LiVESBox *parent, LiVESWidget *child);
709 
710 LiVESWidget *lives_volume_button_new(LiVESOrientation orientation, LiVESAdjustment *, double volume);
711 
712 LiVESWidget *lives_standard_file_button_new(boolean is_dir, const char *def_dir);
713 
714 
715 // util functions
716 
717 void lives_widget_apply_theme(LiVESWidget *, LiVESWidgetState state);
718 
719 void lives_cursor_unref(LiVESXCursor *cursor);
720 
721 void lives_widget_context_update(void);
722 
723 void lives_widget_get_fg_color(LiVESWidget *, LiVESWidgetColor *);
724 void lives_widget_get_bg_color(LiVESWidget *, LiVESWidgetColor *);
725 
726 LiVESWidget *lives_entry_new_with_max_length(int max);
727 
728 void lives_widget_unparent(LiVESWidget *);
729 
730 void lives_tooltips_copy(LiVESWidget *dest, LiVESWidget *source);
731 
732 size_t calc_spin_button_width(double min, double max, int dp);
733 
734 int get_box_child_index (LiVESBox *, LiVESWidget *child);
735 
736 boolean label_act_toggle (LiVESWidget *, LiVESXEventButton *, LiVESToggleButton *);
737 boolean widget_act_toggle (LiVESWidget *, LiVESToggleButton *);
738 
739 void gtk_tooltips_copy(LiVESWidget *dest, LiVESWidget *source);
740 
741 void lives_spin_button_configure(LiVESSpinButton *, double value, double lower, double upper,
742  double step_increment, double page_increment);
743 
744 void set_button_width(LiVESWidget *buttonbox, LiVESWidget *button, int width);
745 
746 char *text_view_get_text(LiVESTextView *);
747 void text_view_set_text(LiVESTextView *, const char *text, int len);
748 
749 void toggle_button_toggle (LiVESToggleButton *);
750 
751 void set_child_colour(GtkWidget *widget, gpointer set_all);
752 
753 void unhide_cursor(LiVESXWindow *);
754 void hide_cursor(LiVESXWindow *);
755 
756 void get_border_size (LiVESWidget *win, int *bx, int *by);
757 
758 void lives_widget_set_can_focus(LiVESWidget *, boolean state);
759 void lives_widget_set_can_focus_and_default(LiVESWidget *);
760 
761 void lives_general_button_clicked (LiVESButton *, LiVESObjectPtr data_to_free);
762 
763 LiVESWidget *add_hsep_to_box (LiVESBox *);
764 
765 LiVESWidget *add_fill_to_box (LiVESBox *);
766 
767 
768 #define LIVES_JUSTIFY_DEFAULT (widget_opts.default_justify)
769 
770 #define W_MAX_FILLER_LEN 65535
771 
772 
773 typedef enum {
782 
788 
789 void lives_set_cursor_style(lives_cursor_t cstyle, LiVESWidget *);
790 
791 typedef enum {
796 
797 
798 typedef struct {
799  boolean no_gui; // show nothing !
800  boolean swap_label; // swap label/widget position
801  boolean pack_end;
802  boolean line_wrap; // line wrapping for labels
803  boolean non_modal; // non-modal for dialogs
804  boolean expand; // whether spin,check,radio buttons should expand
805  boolean apply_theme; // whether to apply theming to widget
806  double scale; // scale factor for all sizes
807  int packing_width; // default should be W_PACKING_WIDTH
808  int packing_height; // default should be W_PACKING_HEIGHT
809  int border_width; // default should be W_BORDER_WIDTH
810  int filler_len; // length of extra "fill" between widgets
811  LiVESWidget *last_label; // label widget of last standard widget (spin,radio,check,entry,combo) [readonly]
812  LiVESJustification justify; // justify for labels
813  LiVESJustification default_justify;
814 } widget_opts_t;
815 
816 
818 
819 #ifdef NEED_DEF_WIDGET_OPTS
820 
822  FALSE, // no_gui
823  FALSE, // swap_label
824  FALSE, //pack_end
825  FALSE, // line_wrap
826  FALSE, // non_modal
827  LIVES_EXPAND_DEFAULT, // default expand
828  FALSE, // no themeing
829  1.0, // default scale
830  W_PACKING_WIDTH, // def packing width
831  W_PACKING_HEIGHT, // def packing height
832  W_BORDER_WIDTH, // def border width
833  8, // def fill width (in chars)
834  NULL, // last_label
835  LIVES_JUSTIFY_LEFT, // justify
836  LIVES_JUSTIFY_LEFT // default justify
837 };
838 
839 #else
840 
841 extern const widget_opts_t def_widget_opts;
842 
843 #endif
844 
845 #endif
846