Compile fix for GTK 3.18: avoid gtk_adjustment_changed().

[PuTTY.git] / unix / gtkfont.h

diff --git a/unix/gtkfont.h b/unix/gtkfont.h
index 72f1f6bf6a56dc43864f7534f168680bac3288e5..6aa8ce2eb302d662fe4936aafbd77694dd401f82 100644 (file)
--- a/unix/gtkfont.h
+++ b/unix/gtkfont.h
@@ -7,6 +7,45 @@
 #ifndef PUTTY_GTKFONT_H
 #define PUTTY_GTKFONT_H
 
+/*
+ * We support two entirely different drawing systems: the old
+ * GDK1/GDK2 one which works on server-side X drawables, and the
+ * new-style Cairo one. GTK1 only supports GDK drawing; GTK3 only
+ * supports Cairo; GTK2 supports both, but deprecates GTK, so we only
+ * enable it if we aren't trying on purpose to compile without the
+ * deprecated functions.
+ *
+ * Our different font classes may prefer different drawing systems: X
+ * server-side fonts are a lot faster to draw with GDK, but for
+ * everything else we prefer Cairo, on general grounds of modernness
+ * and also in particular because its matrix-based scaling system
+ * gives much nicer results for double-width and double-height text
+ * when a scalable font is in use.
+ */
+#if !GTK_CHECK_VERSION(3,0,0) && !defined GDK_DISABLE_DEPRECATED
+#define DRAW_TEXT_GDK
+#endif
+#if GTK_CHECK_VERSION(2,8,0)
+#define DRAW_TEXT_CAIRO
+#endif
+
+#if GTK_CHECK_VERSION(3,0,0) || defined GDK_DISABLE_DEPRECATED
+/*
+ * Where the facility is available, we prefer to render text on to a
+ * persistent server-side pixmap, and redraw windows by simply
+ * blitting rectangles of that pixmap into them as needed. This is
+ * better for performance since we avoid expensive font rendering
+ * calls where possible, and it's particularly good over a non-local X
+ * connection because the response to an expose event can now be a
+ * very simple rectangle-copy operation rather than a lot of fiddly
+ * drawing or bitmap transfer.
+ *
+ * However, GTK is deprecating the use of server-side pixmaps, so we
+ * have to disable this mode under some circumstances.
+ */
+#define NO_BACKING_PIXMAPS
+#endif
+
 /*
  * Exports from gtkfont.c.
  */
@@ -28,15 +67,93 @@ typedef struct unifont {
      * Font dimensions needed by clients.
      */
     int width, height, ascent, descent;
+
+    /*
+     * Indicates whether this font is capable of handling all glyphs
+     * (Pango fonts can do this because Pango automatically supplies
+     * missing glyphs from other fonts), or whether it would like a
+     * fallback font to cope with missing glyphs.
+     */
+    int want_fallback;
+
+    /*
+     * Preferred drawing API to use when this class of font is active.
+     * (See the enum below, in unifont_drawctx.)
+     */
+    int preferred_drawtype;
 } unifont;
 
+/* A default drawtype, for the case where no font exists to make the
+ * decision with. */
+#ifdef DRAW_TEXT_CAIRO
+#define DRAW_DEFAULT_CAIRO
+#define DRAWTYPE_DEFAULT DRAWTYPE_CAIRO
+#elif defined DRAW_TEXT_GDK
+#define DRAW_DEFAULT_GDK
+#define DRAWTYPE_DEFAULT DRAWTYPE_GDK
+#else
+#error No drawtype available at all
+#endif
+
+/*
+ * Drawing context passed in to unifont_draw_text, which contains
+ * everything required to know where and how to draw the requested
+ * text.
+ */
+typedef struct unifont_drawctx {
+    enum {
+#ifdef DRAW_TEXT_GDK
+        DRAWTYPE_GDK,
+#endif
+#ifdef DRAW_TEXT_CAIRO
+        DRAWTYPE_CAIRO,
+#endif
+        DRAWTYPE_NTYPES
+    } type;
+    union {
+#ifdef DRAW_TEXT_GDK
+        struct {
+            GdkDrawable *target;
+            GdkGC *gc;
+        } gdk;
+#endif
+#ifdef DRAW_TEXT_CAIRO
+        struct {
+            /* Need an actual widget, in order to backtrack to its X
+             * screen number when creating server-side pixmaps */
+            GtkWidget *widget;
+            cairo_t *cr;
+            cairo_matrix_t origmatrix;
+        } cairo;
+#endif
+    } u;
+} unifont_drawctx;
+
 unifont *unifont_create(GtkWidget *widget, const char *name,
                        int wide, int bold,
                        int shadowoffset, int shadowalways);
 void unifont_destroy(unifont *font);
-void unifont_draw_text(GdkDrawable *target, GdkGC *gc, unifont *font,
-                      int x, int y, const wchar_t *string, int len,
-                      int wide, int bold, int cellwidth);
+void unifont_draw_text(unifont_drawctx *ctx, unifont *font,
+                       int x, int y, const wchar_t *string, int len,
+                       int wide, int bold, int cellwidth);
+/* Same as unifont_draw_text, but expects 'string' to contain one
+ * normal char plus combining chars, and overdraws them all in the
+ * same character cell. */
+void unifont_draw_combining(unifont_drawctx *ctx, unifont *font,
+                            int x, int y, const wchar_t *string, int len,
+                            int wide, int bold, int cellwidth);
+
+/*
+ * This function behaves exactly like the low-level unifont_create,
+ * except that as well as the requested font it also allocates (if
+ * necessary) a fallback font for filling in replacement glyphs.
+ *
+ * Return value is usable with unifont_destroy and unifont_draw_text
+ * as if it were an ordinary unifont.
+ */
+unifont *multifont_create(GtkWidget *widget, const char *name,
+                          int wide, int bold,
+                          int shadowoffset, int shadowalways);
 
 /*
  * Unified font selector dialog. I can't be bothered to do a