mirror of
https://gitlab.gnome.org/GNOME/gtk.git
synced 2024-11-18 17:30:10 +00:00
e9b6bfcc01
Mon Nov 8 14:47:04 1999 Owen Taylor <otaylor@redhat.com>
Move all X specific code into the x11/ directory.
Aside from shuffling things around, did the following:
* gdk/gdkprivate.h gdk/gdk.h gdk/x11/gdkmain-x11.h: Add
gdk_arg_context_* - a simple argument parsing system
in the style of popt.
* gdk/gdkdrawable.[ch] gdk/gdkprivate.h gdk/gdkwindow.[ch]
gdk/x11/gdkprivate-x11.h:
Remove X specific stuff from GdkDrawable and GdkWindowPrivate -
add ->klass and ->klass_data fields. The klass_data
field points to an auxilliary structure that is
windowing system dependent.
* gdk/gdkfont.c: Make most of the measurement functions
simply wrappers around gdk_text_extents().
* gdk/gdkfont.c gdk/gdkprivate.h gdk/x11/gdkfont-x11.c: Add a
_gdk_font_strlen() function that hides the weird
behavior in gtk+-1.[02] where a string is interpreted
differently for 8-bit and 16-bit fonts.
* gdk/gdkevents.c: Add a new function gdk_event_button_generate()
to store common code for synthesizing double/triple
press events.
* gdk/gdkgc.[ch]: Virtualize in the same way as gdkdrawable.h.
Make all the function that modify an existing GC
simply wrappers around gdk_gc_set_values().
* gdk/gdkcc.[ch]: Moved into x11/ directory in preparation
for throwing out later.
* gdk/gdkfont.c gdk/gdkimage.c gdk/gdkcolor.c: Change GdkFontPrivate,
GdkImagePrivate and GdkColormapPrivate to have a
windowing system dependent part (GdkFontPrivateX etc.)
that "derives" from the system-independent part.
* configure.in gdk/x11/Makefile.in gdk/x11/gdkinput*.c:
Got rid of the included-source-files for XInput in
favor of automake conditionals. (Which didn't exist
when XInput support was originally added.)
* gdk/gdkrgb.c: Remove the visual id from the debugging
statements since that is X11 specific; print out
type/depth info instead.
343 lines
9.3 KiB
Plaintext
343 lines
9.3 KiB
Plaintext
General
|
|
=======
|
|
|
|
- gdk_pointer_grab() and gdk_keyboard_grab() are logically member
|
|
functions of GdkWindow.
|
|
|
|
X specific Functions that need to be moved out of the common header files
|
|
=========================================================================
|
|
|
|
|
|
Dir structure for ports
|
|
=======================
|
|
|
|
The directory structure here is:
|
|
|
|
gdk/
|
|
gdk/x11
|
|
gdk/win32
|
|
...
|
|
|
|
The gdk/ directory directly contains all public
|
|
header files (that are not specific to one
|
|
windowing system).
|
|
|
|
There, in general should be no system dependency
|
|
|
|
For each set of functionality, there are the following
|
|
files:
|
|
|
|
gdkwindow.h: public header file
|
|
gdkwindow.c: common implementation
|
|
x11/gdkwindow.i: functionality specific to X11
|
|
win32/gdkwindow.i: functionality specific to win32
|
|
|
|
The gdkwindow.c file looks like:
|
|
|
|
====
|
|
#include "gdkwindow.h"
|
|
|
|
#ifdef GDK_WINDOWING_X11
|
|
#include "x11/gdkwindow.i"
|
|
#elif defined(GDK_WINDOW_WIN32)
|
|
#include "win32/gdkwindow.i"
|
|
fo#endif
|
|
|
|
[ generic implementation bits ]
|
|
====
|
|
|
|
x11/gdkwindow.i should only assume that gdkwindow.h has been
|
|
included and included all other dependencies explicitely.
|
|
|
|
The x11/ directory will contain:
|
|
|
|
.i files
|
|
.c files specific to X
|
|
.h files specific to X
|
|
|
|
And a Makefile.am that takes care of distributing the
|
|
files in the directory, and also for building any
|
|
X-specific utilities. (Such as the gxid daemon).
|
|
|
|
|
|
Port Status for Files
|
|
=====================
|
|
|
|
gdk
|
|
|
|
Much of the contents have been moved to x11/gtkmain.c.
|
|
I've added a little argument-parsing abstraction.
|
|
(Currently called gdk_arg_context_*) that allows
|
|
arguments from multiple places to be combined - that
|
|
probably needs to be either fixed up and moved into
|
|
GLib or replaced with some existing solution like
|
|
popt.
|
|
|
|
gdkcc
|
|
|
|
This will be removed for GTK+-1.4. Right now, it has been moved
|
|
completely into the x11/ directory to avoid having to port it.
|
|
|
|
gdkcolor
|
|
|
|
There are a few common utility functions, and the rest
|
|
is in the port-specific files.
|
|
|
|
gdkcursor
|
|
|
|
No shared code - completely port-specific.
|
|
|
|
gdkdnd
|
|
|
|
No shared code - completely arch-specific. It's possible that some
|
|
common code for handling GdkDragContext could exist, but the
|
|
GdkDragContextPrivate will be different on each port.
|
|
|
|
gdkdrawable
|
|
|
|
Pretty much done. GdkDrawable is completely virtualized.
|
|
|
|
gdkevents
|
|
|
|
There are a few common utility functions, and the rest
|
|
is in the port-specific files.
|
|
|
|
gdkfont
|
|
|
|
Pretty much done for now - gdkfont.c contains a number of functions
|
|
reimplemented as utility functions, and the rest is
|
|
ports-specific. It will be obsoleted by pango before 1.4.
|
|
|
|
gdkgc
|
|
|
|
GdkGC is virtualized to go along with GdkDrawable. There are
|
|
a couple of functions I punted on for now and moved into the
|
|
port-specific files - the clipmask functions (because gdkregion
|
|
is not finalized) and also gdk_gc_copy, which I'm not sure
|
|
I like enough to put into the vtable.
|
|
|
|
gdkim
|
|
|
|
All in the port-specific directories. The abstraction here probably
|
|
will be changed at some point to something more convenient and
|
|
more Unicode-based.
|
|
|
|
gdkimage
|
|
|
|
GdkImage is virtualized - all of the code except for ref/unref
|
|
is in the port-specific files.
|
|
|
|
gdkinput
|
|
|
|
Right now all the code is port-specific. It should be possible
|
|
to share the code in gdkinputnone.c, but probably not worth it;
|
|
I'd like to get rid of the gdk_input_vtable in X11 code -
|
|
it doesn't make sense since you can't switch the type of input
|
|
on the fly.
|
|
|
|
gdkpixmap
|
|
|
|
All moved into the port-specific file for now. The xpm loader
|
|
should be changed to render with GdkRGB, and thus be
|
|
windowing-system independent, but that requires
|
|
first making GdkRGB able to render onto any arbitrary visual.
|
|
|
|
gdkproperty
|
|
|
|
All port-specific. Possibly should be X-specific with a higher-level
|
|
clipboard API on top of it.
|
|
|
|
gdkregion
|
|
|
|
Right now punted to being port-specific, but that probably needs
|
|
to change with the virtualized drawables and GC's.
|
|
|
|
gdkrgb
|
|
|
|
With a few changes to debugging code, it was already port-independent.
|
|
|
|
gdkselection
|
|
|
|
Completely port specific. (In fact, really doesn't make sense
|
|
on anything other than X; a higher-level clipboard facility
|
|
should be provided somewhere, though.)
|
|
|
|
gdkvisual
|
|
|
|
Completely port-specific. (The concepts are rather X-specific)
|
|
|
|
gdkwindow
|
|
|
|
The window-private data is split between windowing-system independent
|
|
parts and windowing system dependent parts. There are a few
|
|
functions in gdk/gdkwindow.c and the rest is moved off
|
|
into x11/gdkwindow-x11.c
|
|
|
|
Virtualization
|
|
==============
|
|
|
|
The concept of virtualization is that calls to draw
|
|
on a drawable are dispatched through a function table.
|
|
This potentially allows for:
|
|
|
|
Postscript drawables
|
|
metafiles
|
|
|
|
It also provides a nice clean framework for multi-windowing
|
|
support - instead of reimplementing a whole bunch of function
|
|
calls, one provides an implementaiton for the vtables.
|
|
|
|
X works in this way internally - per-screen functions are
|
|
virtualized inside a screen structure, and drawing functions
|
|
are virtualized inside the GC structure.
|
|
|
|
For the virtualization of drawing, clearly GdkDrawable needs
|
|
to be virtualized. Beyond that, one has to decide on
|
|
a case-by-case basis whether a particular structure is
|
|
drawing-mode independent (like GdkRectangle) or not.
|
|
|
|
The most important GDK structures that are involved drawing are:
|
|
|
|
GdkColor
|
|
GdkGC
|
|
GdkFont
|
|
GdkRegion
|
|
|
|
The whole font aspect of Gdk is going to get heavily
|
|
reworked with the introduction of "Pango".
|
|
GdkRegion almost certainly needs to be virtualized,
|
|
if you, way, want to do postscript drawables.
|
|
|
|
While doing so, the API of GdkRegion should be
|
|
changed so that the region operations take 3 parameters
|
|
instead of returning a newly created region.
|
|
|
|
|
|
Drawable operations:
|
|
destroy
|
|
create_gc
|
|
get_values
|
|
set_values
|
|
set_dashes
|
|
copy
|
|
|
|
GC Operations:
|
|
draw_point
|
|
draw_line
|
|
draw_rectangle
|
|
draw_arc
|
|
draw_polygon
|
|
draw_string
|
|
draw_text
|
|
draw_text_wc
|
|
draw_pixmap
|
|
draw_bitmap
|
|
draw_image
|
|
draw_points
|
|
draw_segments
|
|
draw_lines
|
|
|
|
|
|
Adding multi-screen, display support.
|
|
=====================================
|
|
|
|
The following functions need to have per-display variants:
|
|
|
|
void gdk_pointer_ungrab (guint32 time);
|
|
void gdk_keyboard_ungrab (guint32 time);
|
|
gint gdk_pointer_is_grabbed (void);
|
|
|
|
gint gdk_screen_width (void);
|
|
gint gdk_screen_height (void);
|
|
|
|
gint gdk_screen_width_mm (void);
|
|
gint gdk_screen_height_mm (void);
|
|
|
|
void gdk_beep (void);
|
|
|
|
void gdk_key_repeat_disable (void);
|
|
void gdk_key_repeat_restore (void);
|
|
|
|
gint gdk_visual_get_best_depth (void);
|
|
GdkVisualType gdk_visual_get_best_type (void);
|
|
GdkVisual* gdk_visual_get_system (void);
|
|
GdkVisual* gdk_visual_get_best (void);
|
|
GdkVisual* gdk_visual_get_best_with_depth (gint depth);
|
|
GdkVisual* gdk_visual_get_best_with_type (GdkVisualType visual_type);
|
|
GdkVisual* gdk_visual_get_best_with_both (gint depth,
|
|
GdkVisualType visual_type);
|
|
|
|
void gdk_query_depths (gint **depths,
|
|
gint *count);
|
|
void gdk_query_visual_types (GdkVisualType **visual_types,
|
|
gint *count);
|
|
|
|
GList* gdk_list_visuals (void);
|
|
|
|
void gdk_add_client_message_filter (GdkAtom message_type,
|
|
GdkFilterFunc func,
|
|
gpointer data);
|
|
|
|
guint32 gdk_drag_get_protocol (guint32 xid,
|
|
GdkDragProtocol *protocol);
|
|
|
|
GdkCursor* gdk_cursor_new (GdkCursorType cursor_type);
|
|
GdkCursor* gdk_cursor_new_from_pixmap (GdkPixmap *source,
|
|
GdkPixmap *mask,
|
|
GdkColor *fg,
|
|
GdkColor *bg,
|
|
gint x,
|
|
gint y);
|
|
GdkColormap* gdk_colormap_get_system (void);
|
|
gint gdk_colormap_get_system_size (void);
|
|
|
|
GdkFont* gdk_font_load (const gchar *font_name);
|
|
GdkFont* gdk_fontset_load (gchar *fontset_name);
|
|
|
|
gint gdk_selection_owner_set (GdkWindow *owner,
|
|
GdkAtom selection,
|
|
guint32 time,
|
|
gint send_event);
|
|
GdkWindow* gdk_selection_owner_get (GdkAtom selection);
|
|
|
|
void gdk_selection_send_notify (guint32 requestor,
|
|
GdkAtom selection,
|
|
GdkAtom target,
|
|
GdkAtom property,
|
|
guint32 time);
|
|
gint gdk_text_property_to_text_list (GdkAtom encoding, gint format,
|
|
guchar *text, gint length,
|
|
gchar ***list);
|
|
void gdk_free_text_list (gchar **list);
|
|
gint gdk_string_to_compound_text (gchar *str,
|
|
GdkAtom *encoding, gint *format,
|
|
guchar **ctext, gint *length);
|
|
void gdk_free_compound_text (guchar *ctext);
|
|
GdkAtom gdk_atom_intern (const gchar *atom_name,
|
|
gint only_if_exists);
|
|
gchar* gdk_atom_name (GdkAtom atom);
|
|
GList *gdk_input_list_devices (void);
|
|
void gdk_input_set_source (guint32 deviceid,
|
|
GdkInputSource source);
|
|
gint gdk_input_set_mode (guint32 deviceid,
|
|
GdkInputMode mode);
|
|
void gdk_input_set_axes (guint32 deviceid,
|
|
GdkAxisUse *axes);
|
|
void gdk_input_set_key (guint32 deviceid,
|
|
guint index,
|
|
guint keyval,
|
|
GdkModifierType modifiers);
|
|
gint gdk_im_ready (void);
|
|
void gdk_im_end (void);
|
|
GdkIC* gdk_ic_new (GdkICAttr *attr,
|
|
GdkICAttributesType mask);
|
|
GdkRegion* gdk_region_new (void);
|
|
void gdk_event_send_clientmessage_toall (GdkEvent *event);
|
|
gboolean gdk_event_send_client_message (GdkEvent *event,
|
|
guint32 xid);
|
|
|
|
And maybe:
|
|
|
|
void gdk_error_trap_push (void);
|
|
gint gdk_error_trap_pop (void);
|