196430b016
Elaborated on Fl_Cairo_Window's use of FLTK style coordinates,
and how this differs from cairo's default native normalized
coordinate system, and shows how to switch from one to the other.
Also, small comment fix to the cairo example regarding the "X" color.
124 lines
4.4 KiB
C++
124 lines
4.4 KiB
C++
//
|
|
// Cairo Window header file for the Fast Light Tool Kit (FLTK).
|
|
//
|
|
// Copyright 1998-2021 by Bill Spitzak and others.
|
|
//
|
|
// This library is free software. Distribution and use rights are outlined in
|
|
// the file "COPYING" which should have been included with this file. If this
|
|
// file is missing or damaged, see the license at:
|
|
//
|
|
// https://www.fltk.org/COPYING.php
|
|
//
|
|
// Please see the following page on how to report bugs and issues:
|
|
//
|
|
// https://www.fltk.org/bugs.php
|
|
//
|
|
|
|
/* \file
|
|
Fl_Cairo_Window Handling transparently a FLTK window incorporating a cairo draw callback.
|
|
*/
|
|
|
|
#ifndef FL_CAIRO_WINDOW_H
|
|
# define FL_CAIRO_WINDOW_H
|
|
|
|
#include <FL/fl_config.h>
|
|
|
|
# ifdef FLTK_HAVE_CAIRO
|
|
|
|
// Cairo is currently supported for the following platforms:
|
|
// Win32, Apple Quartz, X11
|
|
# include <FL/Fl.H>
|
|
# include <FL/Fl_Double_Window.H>
|
|
|
|
/**
|
|
\addtogroup group_cairo
|
|
@{
|
|
*/
|
|
|
|
/**
|
|
This defines a FLTK window with cairo support.
|
|
|
|
This class overloads the virtual draw() method for you,
|
|
so that the only thing you have to do is to provide your cairo code.
|
|
All cairo context handling is achieved transparently.
|
|
|
|
The default coordinate system for cairo drawing commands within Fl_Cario_Window
|
|
is FLTK's coordinate system, where the `x,y,w,h` values are releative to the
|
|
top/left corner of the Fl_Cairo_Window, as one would expect with regular
|
|
FLTK drawing commands, e.g.: `(0≤x≤w-1),(0≤y≤h-1)`. \b Example:
|
|
\code
|
|
static void my_cairo_draw_cb(Fl_Cairo_Window *window, cairo_t *cr) {
|
|
// Draw an "X"
|
|
const double xmax = (window->w() - 1);
|
|
const double ymax = (window->h() - 1);
|
|
cairo_set_line_width(cr, 1.00); // line width for drawing
|
|
cairo_set_source_rgb(cr, 1.0, 0.5, 0.0); // orange
|
|
cairo_move_to(cr, 0.0, 0.0); cairo_line_to(cr, xmax, ymax); // draw diagonal "\"
|
|
cairo_move_to(cr, 0.0, ymax); cairo_line_to(cr, xmax, 0.0); // draw diagonal "/"
|
|
cairo_stroke(cr); // stroke the lines
|
|
}
|
|
\endcode
|
|
|
|
The FLTK coordinate system differs from the default native cairo coordinate system
|
|
which uses normalized `(0.0…1.0)` values for x and y, e.g.: `(0≤x≤1.0),(0≤y≤1.0)`.
|
|
So beware of this when copy/pasting cairo example programs that assume normalized values.
|
|
If need be, you can revert to the cairo coordinate system by simply calling `cairo_scale()`
|
|
with the widget's `w()` and `h()` values. \b Example:
|
|
|
|
\code
|
|
static void my_cairo_draw_cb(Fl_Cairo_Window *window, cairo_t *cr) {
|
|
cairo_scale(cr, window->w(), window->h()); // use cairo's default coordinate system
|
|
[..use 0.0 to 1.0 values from here on..]
|
|
}
|
|
\endcode
|
|
|
|
\see examples/cairo-draw-x.cxx
|
|
\see test/cairo_test.cxx
|
|
|
|
\note You can alternatively define your custom cairo FLTK window,
|
|
and thus at least override the draw() method to provide custom cairo
|
|
support. In this case you will probably use Fl::cairo_make_current(Fl_Window*)
|
|
to attach a context to your window. You should do it only when your window is
|
|
the current window. \see Fl_Window::current()
|
|
*/
|
|
class FL_EXPORT Fl_Cairo_Window : public Fl_Double_Window {
|
|
|
|
public:
|
|
Fl_Cairo_Window(int W, int H, const char *L = 0)
|
|
: Fl_Double_Window(W, H, L), draw_cb_(0) {}
|
|
Fl_Cairo_Window(int X, int Y, int W, int H, const char *L = 0)
|
|
: Fl_Double_Window(X, Y, W, H, L), draw_cb_(0) {}
|
|
|
|
protected:
|
|
/** Overloaded to provide cairo callback support */
|
|
void draw() {
|
|
Fl_Double_Window::draw();
|
|
if (draw_cb_) { // call the Cairo draw callback
|
|
// manual method ? if yes explicitly get a cairo_context here
|
|
if (!Fl::cairo_autolink_context())
|
|
Fl::cairo_make_current(this);
|
|
draw_cb_(this, Fl::cairo_cc());
|
|
// flush cairo drawings: necessary at least for Windows
|
|
cairo_surface_t *s = cairo_get_target(Fl::cairo_cc());
|
|
cairo_surface_flush(s);
|
|
}
|
|
}
|
|
|
|
public:
|
|
/** This defines the cairo draw callback prototype that you must further */
|
|
typedef void (*cairo_draw_cb) (Fl_Cairo_Window* self, cairo_t* def);
|
|
/**
|
|
You must provide a draw callback which will implement your cairo rendering.
|
|
This method will permit you to set your cairo callback to \p cb.
|
|
*/
|
|
void set_draw_cb(cairo_draw_cb cb) { draw_cb_ = cb; }
|
|
private:
|
|
cairo_draw_cb draw_cb_;
|
|
};
|
|
|
|
|
|
/** @} */
|
|
|
|
# endif // FLTK_HAVE_CAIRO
|
|
#endif // FL_CAIRO_WINDOW_H
|