]> Pileus Git - ~andy/gtk/blob - gdk/gdk.h
D&D now lets you use shaped windows for drags. As usual, see testgtk.c... Now finish...
[~andy/gtk] / gdk / gdk.h
1 /* GDK - The GIMP Drawing Kit
2  * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
3  *
4  * This library is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU Library General Public
6  * License as published by the Free Software Foundation; either
7  * version 2 of the License, or (at your option) any later version.
8  *
9  * This library is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12  * Library General Public License for more details.
13  *
14  * You should have received a copy of the GNU Library General Public
15  * License along with this library; if not, write to the Free
16  * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
17  */
18 #ifndef __GDK_H__
19 #define __GDK_H__
20
21
22 #include <gdk/gdktypes.h>
23
24
25 #ifdef __cplusplus
26 extern "C" {
27 #endif /* __cplusplus */
28
29
30 /* Initialization, exit and events
31  */
32 void   gdk_init            (int    *argc,
33                             char ***argv);
34 void   gdk_exit            (int     error_code);
35 gchar* gdk_set_locale      (void);
36
37 gint gdk_events_pending  (void);
38 GdkEvent *gdk_event_get  (void);
39 GdkEvent *gdk_event_get_graphics_expose (GdkWindow *window);
40 void gdk_event_put       (GdkEvent     *event);
41
42 GdkEvent *gdk_event_copy (GdkEvent *event);
43 void      gdk_event_free (GdkEvent *event);
44
45 void gdk_set_show_events (gint  show_events);
46 void gdk_set_use_xshm    (gint  use_xshm);
47
48 gint gdk_get_show_events (void);
49 gint gdk_get_use_xshm    (void);
50 gchar *gdk_get_display (void);
51
52 guint32 gdk_time_get      (void);
53 guint32 gdk_timer_get     (void);
54 void    gdk_timer_set     (guint32 milliseconds);
55 void    gdk_timer_enable  (void);
56 void    gdk_timer_disable (void);
57
58 gint gdk_input_add_full   (gint              source,
59                            GdkInputCondition condition,
60                            GdkInputFunction  function,
61                            gpointer          data,
62                            GdkDestroyNotify  destroy);
63 #define gdk_input_add_interp gdk_input_add_full  
64 gint gdk_input_add        (gint              source,
65                            GdkInputCondition condition,
66                            GdkInputFunction  function,
67                            gpointer          data);
68 void gdk_input_remove     (gint              tag);
69
70 gint gdk_pointer_grab   (GdkWindow *     window,
71                          gint            owner_events,
72                          GdkEventMask    event_mask,
73                          GdkWindow *     confine_to,
74                          GdkCursor *     cursor,
75                          guint32         time);
76 void gdk_pointer_ungrab (guint32         time);
77
78 gint gdk_keyboard_grab   (GdkWindow *     window,
79                           gint            owner_events,
80                           guint32         time);
81 void gdk_keyboard_ungrab (guint32         time);
82
83 gint gdk_pointer_is_grabbed (void);
84
85 gint gdk_screen_width  (void);
86 gint gdk_screen_height (void);
87
88 void gdk_flush (void);
89 void gdk_beep (void);
90
91 void gdk_key_repeat_disable (void);
92 void gdk_key_repeat_restore (void);
93
94
95 /* Visuals
96  */
97 gint          gdk_visual_get_best_depth      (void);
98 GdkVisualType gdk_visual_get_best_type       (void);
99 GdkVisual*    gdk_visual_get_system          (void);
100 GdkVisual*    gdk_visual_get_best            (void);
101 GdkVisual*    gdk_visual_get_best_with_depth (gint           depth);
102 GdkVisual*    gdk_visual_get_best_with_type  (GdkVisualType  visual_type);
103 GdkVisual*    gdk_visual_get_best_with_both  (gint           depth,
104                                               GdkVisualType  visual_type);
105
106 /* Actually, these are no-ops... */
107 GdkVisual* gdk_visual_ref (GdkVisual *visual);
108 void       gdk_visual_unref (GdkVisual *visual);
109
110 void gdk_query_depths       (gint           **depths,
111                              gint            *count);
112 void gdk_query_visual_types (GdkVisualType  **visual_types,
113                              gint            *count);
114 void gdk_query_visuals      (GdkVisual      **visuals,
115                              gint            *count);
116
117
118 /* Windows
119  */
120 GdkWindow*    gdk_window_new         (GdkWindow     *parent,
121                                       GdkWindowAttr *attributes,
122                                       gint           attributes_mask);
123
124 GdkWindow *   gdk_window_foreign_new (guint32        anid);
125 void          gdk_window_destroy     (GdkWindow     *window);
126 GdkWindow*    gdk_window_ref         (GdkWindow     *window);
127 void          gdk_window_unref       (GdkWindow     *window);
128
129 void          gdk_window_show        (GdkWindow    *window);
130 void          gdk_window_hide        (GdkWindow    *window);
131 void          gdk_window_withdraw    (GdkWindow    *window);
132 void          gdk_window_move        (GdkWindow    *window,
133                                       gint          x,
134                                       gint          y);
135 void          gdk_window_resize      (GdkWindow    *window,
136                                       gint          width,
137                                       gint          height);
138 void          gdk_window_move_resize (GdkWindow    *window,
139                                       gint          x,
140                                       gint          y,
141                                       gint          width,
142                                       gint          height);
143 void          gdk_window_reparent    (GdkWindow    *window,
144                                       GdkWindow    *new_parent,
145                                       gint          x,
146                                       gint          y);
147 void          gdk_window_clear       (GdkWindow    *window);
148 void          gdk_window_clear_area  (GdkWindow    *window,
149                                       gint          x,
150                                       gint          y,
151                                       gint          width,
152                                       gint          height);
153 void          gdk_window_clear_area_e(GdkWindow    *window,
154                                       gint          x,
155                                       gint          y,
156                                       gint          width,
157                                       gint          height);
158 void          gdk_window_copy_area   (GdkWindow    *window,
159                                       GdkGC        *gc,
160                                       gint          x,
161                                       gint          y,
162                                       GdkWindow    *source_window,
163                                       gint          source_x,
164                                       gint          source_y,
165                                       gint          width,
166                                       gint          height);
167 void          gdk_window_raise       (GdkWindow    *window);
168 void          gdk_window_lower       (GdkWindow    *window);
169
170 void          gdk_window_set_user_data   (GdkWindow       *window,
171                                           gpointer         user_data);
172 void          gdk_window_set_override_redirect(GdkWindow  *window,
173                                                gboolean override_redirect);
174
175 void          gdk_window_add_filter     (GdkWindow     *window,
176                                          GdkFilterFunc  function,
177                                          gpointer       data);
178 void          gdk_window_remove_filter  (GdkWindow     *window,
179                                          GdkFilterFunc  function,
180                                          gpointer       data);
181
182 /* 
183  * This allows for making shaped (partially transparent) windows
184  * - cool feature, needed for Drag and Drag for example.
185  *  The shape_mask can be the mask
186  *  from gdk_pixmap_create_from_xpm.   Stefan Wille
187  */
188 void gdk_window_shape_combine_mask (GdkWindow       *window,
189                                     GdkBitmap       *shape_mask,
190                                     gint             offset_x,
191                                     gint             offset_y);
192
193 /* 
194  * Drag & Drop
195  * Algorithm (drop source):
196  * A window being dragged will be sent a GDK_DRAG_BEGIN message.
197  * It will then do gdk_dnd_drag_addwindow() for any other windows that are to be
198  * dragged.
199  * When we get a DROP_ENTER incoming, we send it on to the window in question.
200  * That window needs to use gdk_dnd_drop_enter_reply() to indicate the state of
201  * things (it must call that even if it's not going to accept the drop)
202  *
203  * These two turn on/off drag or drop, and if enabling it also
204  * sets the list of types supported. The list of types passed in
205  * should be in order of decreasing preference.
206  */
207 void gdk_window_dnd_drag_set (GdkWindow  *window,
208                               guint8      drag_enable,
209                               gchar     **typelist,
210                               guint       numtypes);
211
212 /* 
213  *XXX todo: add a GDK_DROP_ENTER which can look at actual data
214  */
215 void gdk_window_dnd_drop_set (GdkWindow  *window,
216                               guint8      drop_enable,
217                               gchar     **typelist,
218                               guint       numtypes,
219                               guint8      destructive_op);
220
221 /* 
222  * This is used by the GDK_DRAG_BEGIN handler. An example of usage would be a
223  * file manager where multiple icons were selected and the drag began.
224  * The icon that the drag actually began on would gdk_dnd_drag_addwindow
225  * for all the other icons that were being dragged... 
226  */
227 void gdk_dnd_drag_addwindow  (GdkWindow  *window);
228 void gdk_window_dnd_data_set (GdkWindow  *window,
229                               GdkEvent   *event,
230                               gpointer    data,
231                               gulong      data_numbytes);
232 void gdk_dnd_set_drag_cursors(GdkCursor *default_cursor,
233                               GdkCursor *goahead_cursor);
234 void gdk_dnd_set_drag_shape(GdkWindow *default_pixmapwin,
235                             GdkPoint *default_hotspot,
236                             GdkWindow *goahead_pixmapwin,
237                             GdkPoint *goahead_hotspot);
238
239 void          gdk_window_set_hints       (GdkWindow       *window,
240                                           gint             x,
241                                           gint             y,
242                                           gint             min_width,
243                                           gint             min_height,
244                                           gint             max_width,
245                                           gint             max_height,
246                                           gint             flags);
247 void          gdk_window_set_title       (GdkWindow       *window,
248                                           const gchar     *title);
249 void          gdk_window_set_background  (GdkWindow       *window,
250                                           GdkColor        *color);
251 void          gdk_window_set_back_pixmap (GdkWindow       *window,
252                                           GdkPixmap       *pixmap,
253                                           gint             parent_relative);
254 void          gdk_window_set_cursor      (GdkWindow       *window,
255                                           GdkCursor       *cursor);
256 void          gdk_window_set_colormap    (GdkWindow       *window,
257                                           GdkColormap     *colormap);
258 void          gdk_window_get_user_data   (GdkWindow       *window,
259                                           gpointer        *data);
260 void          gdk_window_get_geometry    (GdkWindow       *window,
261                                           gint            *x,
262                                           gint            *y,
263                                           gint            *width,
264                                           gint            *height,
265                                           gint            *depth);
266 void          gdk_window_get_position    (GdkWindow       *window,
267                                           gint            *x,
268                                           gint            *y);
269 void          gdk_window_get_size        (GdkWindow       *window,
270                                           gint            *width,
271                                           gint            *height);
272 GdkVisual*    gdk_window_get_visual      (GdkWindow       *window);
273 GdkColormap*  gdk_window_get_colormap    (GdkWindow       *window);
274 GdkWindowType gdk_window_get_type        (GdkWindow       *window);
275 gint          gdk_window_get_origin      (GdkWindow       *window,
276                                           gint            *x,
277                                           gint            *y);
278 GdkWindow*    gdk_window_get_pointer     (GdkWindow       *window,
279                                           gint            *x,
280                                           gint            *y,
281                                           GdkModifierType *mask);
282 GdkWindow*    gdk_window_get_parent      (GdkWindow       *window);
283 GdkWindow*    gdk_window_get_toplevel    (GdkWindow       *window);
284 GList*        gdk_window_get_children    (GdkWindow       *window);
285 GdkEventMask  gdk_window_get_events      (GdkWindow       *window);
286 void          gdk_window_set_events      (GdkWindow       *window,
287                                           GdkEventMask     event_mask);
288
289 /* Cursors
290  */
291 GdkCursor* gdk_cursor_new                (GdkCursorType   cursor_type);
292 GdkCursor* gdk_cursor_new_from_pixmap    (GdkPixmap       *source,
293                                           GdkPixmap       *mask,
294                                           GdkColor        *fg,
295                                           GdkColor        *bg,
296                                           int             x,
297                                           int             y);
298 void       gdk_cursor_destroy            (GdkCursor      *cursor);
299
300
301 /* GCs
302  */
303 GdkGC* gdk_gc_new                 (GdkWindow        *window);
304 GdkGC* gdk_gc_new_with_values     (GdkWindow        *window,
305                                    GdkGCValues      *values,
306                                    GdkGCValuesMask   values_mask);
307 GdkGC* gdk_gc_ref                 (GdkGC            *gc);
308 void   gdk_gc_unref               (GdkGC            *gc);
309 void   gdk_gc_destroy             (GdkGC            *gc);
310 void   gdk_gc_get_values          (GdkGC            *gc,
311                                    GdkGCValues      *values);
312 void   gdk_gc_set_foreground      (GdkGC            *gc,
313                                    GdkColor         *color);
314 void   gdk_gc_set_background      (GdkGC            *gc,
315                                    GdkColor         *color);
316 void   gdk_gc_set_font            (GdkGC            *gc,
317                                    GdkFont          *font);
318 void   gdk_gc_set_function        (GdkGC            *gc,
319                                    GdkFunction       function);
320 void   gdk_gc_set_fill            (GdkGC            *gc,
321                                    GdkFill           fill);
322 void   gdk_gc_set_tile            (GdkGC            *gc,
323                                    GdkPixmap        *tile);
324 void   gdk_gc_set_stipple         (GdkGC            *gc,
325                                    GdkPixmap        *stipple);
326 void   gdk_gc_set_ts_origin       (GdkGC            *gc,
327                                    gint              x,
328                                    gint              y);
329 void   gdk_gc_set_clip_origin     (GdkGC            *gc,
330                                    gint              x,
331                                    gint              y);
332 void   gdk_gc_set_clip_mask       (GdkGC            *gc,
333                                    GdkBitmap        *mask);
334 void   gdk_gc_set_clip_rectangle  (GdkGC            *gc,
335                                    GdkRectangle     *rectangle);
336 void   gdk_gc_set_subwindow       (GdkGC            *gc,
337                                    GdkSubwindowMode  mode);
338 void   gdk_gc_set_exposures       (GdkGC            *gc,
339                                    gint              exposures);
340 void   gdk_gc_set_line_attributes (GdkGC            *gc,
341                                    gint              line_width,
342                                    GdkLineStyle      line_style,
343                                    GdkCapStyle       cap_style,
344                                    GdkJoinStyle      join_style);
345 void   gdk_gc_copy                (GdkGC             *dst_gc,
346                                    GdkGC             *src_gc);
347
348
349 /* Pixmaps
350  */
351 GdkPixmap* gdk_pixmap_new               (GdkWindow  *window,
352                                          gint        width,
353                                          gint        height,
354                                          gint        depth);
355 GdkBitmap* gdk_bitmap_create_from_data  (GdkWindow  *window,
356                                          gchar      *data,
357                                          gint        width,
358                                          gint        height);
359 GdkPixmap* gdk_pixmap_create_from_data  (GdkWindow  *window,
360                                          gchar      *data,
361                                          gint        width,
362                                          gint        height,
363                                          gint        depth,
364                                          GdkColor   *fg,
365                                          GdkColor   *bg);
366 GdkPixmap* gdk_pixmap_create_from_xpm   (GdkWindow  *window,
367                                          GdkBitmap **mask,
368                                          GdkColor   *transparent_color,
369                                          const gchar *filename);
370 GdkPixmap* gdk_pixmap_create_from_xpm_d (GdkWindow  *window,
371                                          GdkBitmap **mask,
372                                          GdkColor   *transparent_color,
373                                          gchar     **data);
374 GdkPixmap *gdk_pixmap_ref               (GdkPixmap  *pixmap);
375 void       gdk_pixmap_unref             (GdkPixmap  *pixmap);
376
377 GdkBitmap *gdk_bitmap_ref               (GdkBitmap  *pixmap);
378 void       gdk_bitmap_unref             (GdkBitmap  *pixmap);
379
380
381 /* Images
382  */
383 GdkImage* gdk_image_new_bitmap(GdkVisual *,
384                                 gpointer,
385                                 gint,
386                                 gint);
387 GdkImage*  gdk_image_new       (GdkImageType  type,
388                                 GdkVisual    *visual,
389                                 gint          width,
390                                 gint          height);
391 GdkImage*  gdk_image_get       (GdkWindow    *window,
392                                 gint          x,
393                                 gint          y,
394                                 gint          width,
395                                 gint          height);
396 void       gdk_image_put_pixel (GdkImage     *image,
397                                 gint          x,
398                                 gint          y,
399                                 guint32       pixel);
400 guint32    gdk_image_get_pixel (GdkImage     *image,
401                                 gint          x,
402                                 gint          y);
403 void       gdk_image_destroy   (GdkImage     *image);
404
405
406 /* Color
407  */
408 GdkColormap* gdk_colormap_new     (GdkVisual   *visual,
409                                    gint         allocate);
410 GdkColormap* gdk_colormap_ref     (GdkColormap *cmap);
411 void         gdk_colormap_unref   (GdkColormap *cmap);
412
413 GdkColormap* gdk_colormap_get_system       (void);
414 gint         gdk_colormap_get_system_size  (void);
415
416 void gdk_colormap_change (GdkColormap   *colormap,
417                           gint           ncolors);
418 void gdk_colors_store    (GdkColormap   *colormap,
419                           GdkColor      *colors,
420                           gint           ncolors);
421 gint gdk_colors_alloc    (GdkColormap   *colormap,
422                           gint           contiguous,
423                           gulong        *planes,
424                           gint           nplanes,
425                           gulong        *pixels,
426                           gint           npixels);
427 void gdk_colors_free     (GdkColormap   *colormap,
428                           gulong        *pixels,
429                           gint           npixels,
430                           gulong         planes);
431 gint gdk_color_white     (GdkColormap   *colormap,
432                           GdkColor      *color);
433 gint gdk_color_black     (GdkColormap   *colormap,
434                           GdkColor      *color);
435 gint gdk_color_parse     (const gchar   *spec,
436                           GdkColor      *color);
437 gint gdk_color_alloc     (GdkColormap   *colormap,
438                           GdkColor      *color);
439 gint gdk_color_change    (GdkColormap   *colormap,
440                           GdkColor      *color);
441 gint gdk_color_equal     (GdkColor      *colora,
442                           GdkColor      *colorb);
443
444
445 /* Fonts
446  */
447 GdkFont* gdk_font_load      (const gchar    *font_name);
448 GdkFont* gdk_fontset_load   (gchar    *fontset_name);
449 GdkFont* gdk_font_ref       (GdkFont  *font);
450 void     gdk_font_unref     (GdkFont  *font);
451 gint     gdk_font_id        (GdkFont  *font);
452 gint     gdk_font_equal     (GdkFont  *fonta,
453                              GdkFont  *fontb);
454 gint     gdk_string_width   (GdkFont  *font,
455                              const gchar    *string);
456 gint     gdk_text_width     (GdkFont  *font,
457                              const gchar    *text,
458                              gint      text_length);
459 gint     gdk_char_width     (GdkFont  *font,
460                              gchar     character);
461 gint     gdk_string_measure (GdkFont  *font,
462                              const gchar    *string);
463 gint     gdk_text_measure   (GdkFont  *font,
464                              const gchar    *text,
465                              gint      text_length);
466 gint     gdk_char_measure   (GdkFont  *font,
467                              gchar     character);
468
469
470 /* Drawing
471  */
472 void gdk_draw_point      (GdkDrawable  *drawable,
473                           GdkGC        *gc,
474                           gint          x,
475                           gint          y);
476 void gdk_draw_line       (GdkDrawable  *drawable,
477                           GdkGC        *gc,
478                           gint          x1,
479                           gint          y1,
480                           gint          x2,
481                           gint          y2);
482 void gdk_draw_rectangle  (GdkDrawable  *drawable,
483                           GdkGC        *gc,
484                           gint          filled,
485                           gint          x,
486                           gint          y,
487                           gint          width,
488                           gint          height);
489 void gdk_draw_arc        (GdkDrawable  *drawable,
490                           GdkGC        *gc,
491                           gint          filled,
492                           gint          x,
493                           gint          y,
494                           gint          width,
495                           gint          height,
496                           gint          angle1,
497                           gint          angle2);
498 void gdk_draw_polygon    (GdkDrawable  *drawable,
499                           GdkGC        *gc,
500                           gint          filled,
501                           GdkPoint     *points,
502                           gint          npoints);
503 void gdk_draw_string     (GdkDrawable  *drawable,
504                           GdkFont      *font,
505                           GdkGC        *gc,
506                           gint          x,
507                           gint          y,
508                           const gchar        *string);
509 void gdk_draw_text       (GdkDrawable  *drawable,
510                           GdkFont      *font,
511                           GdkGC        *gc,
512                           gint          x,
513                           gint          y,
514                           const gchar        *text,
515                           gint          text_length);
516 void gdk_draw_pixmap     (GdkDrawable  *drawable,
517                           GdkGC        *gc,
518                           GdkDrawable  *src,
519                           gint          xsrc,
520                           gint          ysrc,
521                           gint          xdest,
522                           gint          ydest,
523                           gint          width,
524                           gint          height);
525 void gdk_draw_bitmap     (GdkDrawable  *drawable,
526                           GdkGC        *gc,
527                           GdkDrawable  *src,
528                           gint          xsrc,
529                           gint          ysrc,
530                           gint          xdest,
531                           gint          ydest,
532                           gint          width,
533                           gint          height);
534 void gdk_draw_image      (GdkDrawable  *drawable,
535                           GdkGC        *gc,
536                           GdkImage     *image,
537                           gint          xsrc,
538                           gint          ysrc,
539                           gint          xdest,
540                           gint          ydest,
541                           gint          width,
542                           gint          height);
543 void gdk_draw_points     (GdkDrawable  *drawable,
544                           GdkGC        *gc,
545                           GdkPoint     *points,
546                           gint          npoints);
547 void gdk_draw_segments   (GdkDrawable  *drawable,
548                           GdkGC        *gc,
549                           GdkSegment   *segs,
550                           gint          nsegs);
551
552
553 /* Selections
554  */
555 gint       gdk_selection_owner_set (GdkWindow    *owner,
556                                     GdkAtom       selection,
557                                     guint32       time,
558                                     gint          send_event);
559 GdkWindow* gdk_selection_owner_get (GdkAtom       selection);
560 void       gdk_selection_convert   (GdkWindow    *requestor,
561                                     GdkAtom       selection,
562                                     GdkAtom       target,
563                                     guint32       time);
564 gint       gdk_selection_property_get (GdkWindow  *requestor,
565                                        guchar    **data,
566                                        GdkAtom    *prop_type,
567                                        gint       *prop_format);
568 void       gdk_selection_send_notify (guint32       requestor,
569                                       GdkAtom       selection,
570                                       GdkAtom       target,
571                                       GdkAtom       property,
572                                       guint32       time);
573
574 gint       gdk_text_property_to_text_list (GdkAtom encoding, gint format,
575                                            guchar *text, gint length,
576                                            gchar ***list);
577 void       gdk_free_text_list             (gchar **list);
578 gint       gdk_string_to_compound_text    (gchar *str,
579                                            GdkAtom *encoding, gint *format,
580                                            guchar **ctext, gint *length);
581 void       gdk_free_compound_text         (guchar *ctext);
582
583 /* Properties
584  */
585 GdkAtom gdk_atom_intern     (const gchar *atom_name,
586                              gint         only_if_exists);
587 gchar*  gdk_atom_name       (GdkAtom atom);
588 gint    gdk_property_get    (GdkWindow   *window,
589                              GdkAtom      property,
590                              GdkAtom      type,
591                              gulong       offset,
592                              gulong       length,
593                              gint         pdelete,
594                              GdkAtom     *actual_property_type,
595                              gint        *actual_format,
596                              gint        *actual_length,
597                              guchar     **data);
598
599 void    gdk_property_change (GdkWindow   *window,
600                              GdkAtom      property,
601                              GdkAtom      type,
602                              gint         format,
603                              GdkPropMode  mode,
604                              guchar      *data,
605                              gint         nelements);
606 void    gdk_property_delete (GdkWindow   *window,
607                              GdkAtom      property);
608
609
610 /* Rectangle utilities
611  */
612 gint gdk_rectangle_intersect (GdkRectangle *src1,
613                               GdkRectangle *src2,
614                               GdkRectangle *dest);
615
616 /* XInput support
617  */
618
619 void gdk_input_init                         (void);
620 void gdk_input_exit                         (void);
621 GList *gdk_input_list_devices               (void);
622 void gdk_input_set_extension_events         (GdkWindow *window,
623                                              gint mask,
624                                              GdkExtensionMode mode);
625 void gdk_input_set_source                   (guint32 deviceid,
626                                              GdkInputSource source);
627 gint gdk_input_set_mode                     (guint32 deviceid,
628                                              GdkInputMode mode);
629 void gdk_input_set_axes                     (guint32 deviceid,
630                                              GdkAxisUse *axes);
631 void gdk_input_set_key                      (guint32 deviceid,
632                                              guint   index,
633                                              guint   keyval,
634                                              GdkModifierType modifiers);
635 void gdk_input_window_get_pointer     (GdkWindow       *window,
636                                        guint32         deviceid,
637                                        gdouble         *x,
638                                        gdouble         *y,
639                                        gdouble         *pressure,
640                                        gdouble         *xtilt,
641                                        gdouble         *ytilt,
642                                        GdkModifierType *mask);
643
644 GdkTimeCoord *gdk_input_motion_events (GdkWindow *window,
645                                        guint32 deviceid,
646                                        guint32 start,
647                                        guint32 stop,
648                                        gint *nevents_return);
649
650 /* International Input Method Support Functions
651  */
652
653 gint   gdk_im_ready             (void);
654
655 void   gdk_im_begin             (GdkIC ic, GdkWindow* window);
656 void   gdk_im_end               (void);
657 GdkIMStyle gdk_im_decide_style  (GdkIMStyle supported_style);
658 GdkIMStyle gdk_im_set_best_style (GdkIMStyle best_allowed_style);
659 GdkIC  gdk_ic_new               (GdkWindow* client_window,
660                                  GdkWindow* focus_window,
661                                  GdkIMStyle style, ...);
662 void   gdk_ic_destroy           (GdkIC ic);
663 GdkIMStyle   gdk_ic_get_style   (GdkIC ic);
664 void   gdk_ic_set_values        (GdkIC ic, ...);
665 void   gdk_ic_get_values        (GdkIC ic, ...);
666 void   gdk_ic_set_attr          (GdkIC ic, const char *target, ...);
667 void   gdk_ic_get_attr          (GdkIC ic, const char *target, ...);
668 GdkEventMask gdk_ic_get_events  (GdkIC ic);
669
670 /* Miscellaneous */
671 void gdk_event_send_clientmessage_toall(GdkEvent *event);
672
673 /* Color Context */
674
675 GdkColorContext *gdk_color_context_new                    (GdkVisual   *visual,
676                                                            GdkColormap *colormap);
677
678 GdkColorContext *gdk_color_context_new_mono               (GdkVisual   *visual,
679                                                            GdkColormap *colormap);
680
681 void             gdk_color_context_free                   (GdkColorContext *cc);
682
683 gulong           gdk_color_context_get_pixel              (GdkColorContext *cc,
684                                                            gushort          red,
685                                                            gushort          green,
686                                                            gushort          blue,
687                                                            gint            *failed);
688 void             gdk_color_context_get_pixels             (GdkColorContext *cc,
689                                                            gushort         *reds,
690                                                            gushort         *greens,
691                                                            gushort         *blues,
692                                                            gint             ncolors,
693                                                            gulong          *colors,
694                                                            gint            *nallocated);
695 void             gdk_color_context_get_pixels_incremental (GdkColorContext *cc,
696                                                            gushort         *reds,
697                                                            gushort         *greens,
698                                                            gushort         *blues,
699                                                            gint             ncolors,
700                                                            gint            *used,
701                                                            gulong          *colors,
702                                                            gint            *nallocated);
703
704 gint             gdk_color_context_query_color            (GdkColorContext *cc,
705                                                            GdkColor        *color);
706 gint             gdk_color_context_query_colors           (GdkColorContext *cc,
707                                                            GdkColor        *colors,
708                                                            gint             num_colors);
709
710 gint             gdk_color_context_add_palette            (GdkColorContext *cc,
711                                                            GdkColor        *palette,
712                                                            gint             num_palette);
713
714 void             gdk_color_context_init_dither            (GdkColorContext *cc);
715 void             gdk_color_context_free_dither            (GdkColorContext *cc);
716
717 gulong           gdk_color_context_get_pixel_from_palette (GdkColorContext *cc,
718                                                            gushort         *red,
719                                                            gushort         *green,
720                                                            gushort         *blue,
721                                                            gint            *failed);
722 guchar           gdk_color_context_get_index_from_palette (GdkColorContext *cc,
723                                                            gint            *red,
724                                                            gint            *green,
725                                                            gint            *blue,
726                                                            gint            *failed);
727
728
729 #ifdef __cplusplus
730 }
731 #endif /* __cplusplus */
732
733
734 #endif /* __GDK_H__ */