680cb7dba9
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.4@12921 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
128 lines
4.8 KiB
C++
128 lines
4.8 KiB
C++
//
|
|
// "$Id$"
|
|
//
|
|
// implementation of classes Fl_Surface_Device and Fl_Display_Device for the Fast Light Tool Kit (FLTK).
|
|
//
|
|
// Copyright 2010-2017 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:
|
|
//
|
|
// http://www.fltk.org/COPYING.php
|
|
//
|
|
// Please report all bugs and problems to:
|
|
//
|
|
// http://www.fltk.org/str.php
|
|
//
|
|
|
|
#include <FL/Fl.H>
|
|
#include "config_lib.h"
|
|
#include <FL/Fl_Device.H>
|
|
#include <FL/Fl_Graphics_Driver.H>
|
|
|
|
/* Inheritance diagram.
|
|
|
|
+- Fl_Surface_Device: any kind of surface that we can draw onto -> uses an Fl_Graphics_Driver
|
|
|
|
|
+- Fl_Display_Device: some kind of video device (one object per app)
|
|
+- Fl_Widget_Surface: any FLTK widget can be drawn to it
|
|
|
|
|
+- Fl_Copy_Surface: draw into the clipboard (in vectorial form if the platform supports it)
|
|
+- Fl_Copy_Surface_Driver: helper class interfacing FLTK with draw-to-clipboard operations
|
|
|
|
|
+- Fl_..._Copy_Surface_Driver: platform-specific implementation of Fl_Copy_Surface_Driver
|
|
+- Fl_Image_Surface: draw into an RGB Image
|
|
+- Fl_Image_Surface_Driver: helper class interfacing FLTK with draw-to-image operations
|
|
|
|
|
+- Fl_..._Image_Surface_Driver: platform-specific implementation of Fl_Image_Surface_Driver
|
|
+- Fl_Paged_Device: output to a page-structured surface
|
|
|
|
|
+- Fl_Printer: user can instantiate this to gain access to a printer
|
|
+- Fl_..._Printer_Driver: platform-specific helper class interfacing FLTK with print operations
|
|
+- Fl_PostScript_File_Device: draw into a PostScript file
|
|
|
|
|
+- Fl_Posix_Printer_Driver: Fl_Printer uses that under Posix platforms
|
|
|
|
+- Fl_Graphics_Driver -> directed to an Fl_Surface_Device object
|
|
|
|
|
+- Fl_PostScript_Graphics_Driver: platform-independent graphics driver for PostScript drawing
|
|
+- Fl_..._Graphics_Driver: platform-specific graphics driver (MacOS, Android, Pico)
|
|
+- Fl_Quartz_Printer_Graphics_Driver: MacOS-specific, for drawing to printers
|
|
+- Fl_Scalable_Graphics_Driver: helper class to support GUI scaling
|
|
+- Fl_Xlib_Graphics_Driver: X11-specific graphics driver
|
|
+- Fl_GDI_Graphics_Driver: Windows-specific graphics driver
|
|
+- Fl_GDI_Printer_Graphics_Driver: re-implements a few member functions especially for output to printer
|
|
+- Fl_OpenGL_Graphics_Driver: draw to an Fl_Gl_Window (only very partial implementation)
|
|
|
|
*/
|
|
|
|
/** Make this surface the current drawing surface.
|
|
This surface will receive all future graphics requests.
|
|
\p Starting from FLTK 1.4.0, another convenient API to set/unset the current drawing surface
|
|
is Fl_Surface_Device::push_current( ) / Fl_Surface_Device::pop_current().*/
|
|
void Fl_Surface_Device::set_current(void)
|
|
{
|
|
if (surface_) surface_->end_current_();
|
|
fl_graphics_driver = pGraphicsDriver;
|
|
surface_ = this;
|
|
pGraphicsDriver->global_gc();
|
|
driver()->set_current_();
|
|
}
|
|
|
|
Fl_Surface_Device* Fl_Surface_Device::surface_; // the current target surface of graphics operations
|
|
|
|
|
|
Fl_Surface_Device::~Fl_Surface_Device()
|
|
{
|
|
if (surface_ == this) surface_ = NULL;
|
|
}
|
|
|
|
|
|
/** A constructor that sets the graphics driver used by the display */
|
|
Fl_Display_Device::Fl_Display_Device(Fl_Graphics_Driver *graphics_driver) : Fl_Surface_Device(graphics_driver) {
|
|
this->set_current();
|
|
};
|
|
|
|
|
|
/** Returns a pointer to the unique display device */
|
|
Fl_Display_Device *Fl_Display_Device::display_device() {
|
|
static Fl_Display_Device *display = new Fl_Display_Device(Fl_Graphics_Driver::newMainGraphicsDriver());
|
|
return display;
|
|
};
|
|
|
|
|
|
Fl_Surface_Device *Fl_Surface_Device::default_surface()
|
|
{
|
|
return Fl_Display_Device::display_device();
|
|
}
|
|
|
|
static unsigned int surface_stack_height = 0;
|
|
static Fl_Surface_Device *surface_stack[16];
|
|
|
|
/** Pushes \p new_current on top of the stack of current drawing surfaces, and makes it current.
|
|
\p new_current will receive all future graphics requests.
|
|
\version 1.4.0 */
|
|
void Fl_Surface_Device::push_current(Fl_Surface_Device *new_current)
|
|
{
|
|
if (surface_stack_height < sizeof(surface_stack)/sizeof(void*)) {
|
|
surface_stack[surface_stack_height++] = surface();
|
|
} else {
|
|
fprintf(stderr, "FLTK Fl_Surface_Device::push_current Stack overflow error\n");
|
|
}
|
|
new_current->set_current();
|
|
}
|
|
|
|
/** Removes the top element from the current drawing surface stack, and makes the new top element current.
|
|
\return A pointer to the new current drawing surface.
|
|
\version 1.4.0 */
|
|
Fl_Surface_Device *Fl_Surface_Device::pop_current()
|
|
{
|
|
if (surface_stack_height > 0) surface_stack[--surface_stack_height]->set_current();
|
|
return surface_;
|
|
}
|
|
|
|
//
|
|
// End of "$Id$".
|
|
//
|