+ Cairo branch merged after successful testing on Mac OS X 10.5.4, Linux Ubuntu 8.04,Windows XPSP2.

  This integration is minimum as discussed, in particular it does not feature any fltk cairo drawing substitution
  as in fltk2.
  Still it provides all the fundations to go further even in next 1.4 ... 
  By default *no* cairo features are implemented nor linked, it can only be activated by --enable-cairo
  whose default is false.
  Please visit the README.cairo for complete description.

+ fixed UTF8 compilation pb on linux ubuntu

+ minor comments fixes on the fly



git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@6350 ea41ed52-d2ee-0310-a9c1-e6b18d33e121

1 files changed, 151 insertions, 0 deletions

diff --git a/src/Fl_Cairo.cxx b/src/Fl_Cairo.cxx
new file mode 100644
index 000000000..6a87d3c8c
--- /dev/null
+++ b/src/Fl_Cairo.cxx
@@ -0,0 +1,151 @@
+//
+// "$Id$"
+//
+// Main header file for the Fast Light Tool Kit (FLTK).
+//
+// Copyright 1998-2008 by Bill Spitzak and others.
+//
+// This library is free software; you can redistribute it and/or
+// modify it under the terms of the GNU Library General Public
+// License as published by the Free Software Foundation; either
+// version 2 of the License, or (at your option) any later version.
+//
+// This library 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
+// Library General Public License for more details.
+//
+// You should have received a copy of the GNU Library General Public
+// License along with this library; if not, write to the Free Software
+// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
+// USA.
+//
+// Please report all bugs and problems on the following page:
+//
+//     http://www.fltk.org/str.php
+//
+
+#include <config.h>
+
+#ifdef HAVE_CAIRO
+#include <FL/Fl.H>
+#include <FL/x.H>
+#include <FL/Fl_Window.H>
+
+// static Fl module initialization :
+Fl_Cairo_State Fl::cairo_state_;	///< contains all necesary info for current cairo context mapping
+// Fl cairo features implementation
+
+/** 
+    Provides a corresponding cairo context for Window \a w.
+    This is needed in a draw() override if Fl::cairo_autolink_context() 
+    returns false, which is the default.
+    The cairo_context() does not need to be freed as it is freed every time 
+    a new cairo context is created. When the program terminates,
+    a call to Fl::cairo_make_current(0) will destroy any residual context.
+    \note A new cairo context is not always re-created when this method
+    is used. In particular, if the current graphical context and the current 
+    window didn't change between two calls, the previous gc is internally kept,
+    thus optimizing the drawing performances.
+    Also, after this call, Fl::cairo_gc() is adequately updated with this 
+    cairo  context.
+    \note Only available when configure has the --enable-cairo option
+    \return the valid cairo_t* cairo context associated to this window.
+*/
+cairo_t * Fl::cairo_make_current(Fl_Window* wi) {
+    if (!wi) return NULL; // Precondition
+    
+    if (fl_gc==0) { // means remove current cc
+	Fl::cairo_cc(0); // destroy any previous cc
+	cairo_state_.window(0);
+	return 0;
+    }
+
+    // don't re-create a context if it's the same gc/window couple
+    if (fl_gc==Fl::cairo_state_.gc() && fl_xid(wi) == (Window) Fl::cairo_state_.window())
+	return Fl::cairo_cc();
+
+    cairo_state_.window(wi);
+
+#if defined(USE_X11)
+    return Fl::cairo_make_current(0, wi->w(), wi->h());
+#else
+    return Fl::cairo_make_current(fl_gc, wi->w(), wi->h());
+#endif
+}
+
+/* 
+    Creates transparently a cairo_surface_t object.
+    gc is an HDC context in  WIN32, a CGContext* in Quartz, a display on X11
+ */
+static cairo_surface_t * cairo_create_surface(void * gc, int W, int H) {
+# if defined(USE_X11) // X11
+    return cairo_xlib_surface_create(fl_display, fl_window, fl_visual->visual, W, H);
+# elif   defined(WIN32)
+    return cairo_win32_surface_create((HDC) gc);
+# elif defined(__APPLE_QUARTZ__)
+    return cairo_quartz_surface_create_for_cg_context((CGContext*) gc, W, H);
+# elif defined(__APPLE_QD__)
+#  error Cairo is not supported under Apple Quickdraw, please use Apple Quartz.
+# else
+#  error Cairo is not supported under this platform.
+# endif
+}
+
+/** 
+  Creates a cairo context from a \a gc only, get its window size  or offscreen size if fl_window is null 
+   \note Only available when configure has the --enable-cairo option
+*/
+cairo_t * Fl::cairo_make_current(void *gc) {
+    int W=0,H=0;
+#if defined(USE_X11)
+    //FIXME X11 get W,H
+    // gc will be the window handle here
+# warning FIXME get W,H for cairo_make_current(void*)
+#elif defined(__APPLE_QUARTZ__) 
+    if (fl_window) {
+      Rect portRect; 
+      GetPortBounds(GetWindowPort( fl_window ), &portRect);
+      W = portRect.right-portRect.left;
+      H = portRect.bottom-portRect.top;
+    } 
+    else {
+      W = CGBitmapContextGetHeight(fl_gc);
+      H = CGBitmapContextGetHeight(fl_gc);
+    }
+#elif defined(WIN32)
+    // we don't need any W,H for WIN32
+#else
+# error Cairo is not supported under this platform.
+#endif
+    if (!gc) {
+	Fl::cairo_cc(0);
+	cairo_state_.gc(0); // keep track for next time
+	return 0;
+    }
+    if (gc==Fl::cairo_state_.gc() && fl_window== (Window) Fl::cairo_state_.window())
+	return Fl::cairo_cc();
+    cairo_state_.gc(fl_gc); // keep track for next time
+    cairo_surface_t * s = cairo_create_surface(gc, W, H);
+    cairo_t * c = cairo_create(s);
+    cairo_surface_destroy(s);
+    Fl::cairo_cc(c);
+    return c;
+}
+
+/** 
+   Creates a cairo context from a \a gc and its size 
+   \note Only available when configure has the --enable-cairo option
+*/
+cairo_t * Fl::cairo_make_current(void *gc, int W, int H) {
+  cairo_surface_t * s = cairo_create_surface(gc, W, H);
+    cairo_t * c = cairo_create(s);
+    cairo_surface_destroy(s);
+    Fl::cairo_cc(c);
+    return c;
+}
+#endif // HAVE_CAIRO
+
+//
+// End of "$Id$" .
+//