Fixed unfinished edit of xlib.H
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3-porting@11030 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
This commit is contained in:
Matthias Melcher
parent
cdf6493d95
commit
b44086efb7
@ -84,103 +84,6 @@ protected:
|
|||||||
void restore_clip();
|
void restore_clip();
|
||||||
};
|
};
|
||||||
|
|
||||||
#endif
|
|
||||||
|
|
||||||
/**
|
|
||||||
A drawing surface that's susceptible to receive graphical output.
|
|
||||||
Any FLTK application has at any time a current drawing surface to which all drawing requests are directed.
|
|
||||||
The current surface is given by Fl_Surface_Device::surface().
|
|
||||||
When main() begins running, the current drawing surface has been set to the computer's display,
|
|
||||||
an instance of the Fl_Display_Device class.
|
|
||||||
|
|
||||||
A drawing surface other than the computer's display, is typically used as follows:
|
|
||||||
<ol><li> Create \c surface, an object from a particular Fl_Surface_Device derived class (e.g., Fl_Copy_Surface, Fl_Printer).
|
|
||||||
<li> Memorize what is the current drawing surface with <tt> Fl_Surface_Device *old_current = Fl_Surface_Device::surface();</tt>
|
|
||||||
<li> Call \c surface->set_current(); to redirect all graphics requests to \c surface which becomes the new
|
|
||||||
current drawing surface (not necessary with class Fl_Printer because it is done by Fl_Printer::start_job()).
|
|
||||||
<li> At this point any of the \ref fl_drawings (e.g., fl_rect()) or the \ref fl_attributes or \ref drawing_images functions
|
|
||||||
(e.g., fl_draw_image(), Fl_Image::draw()) operates on the new current drawing surface.
|
|
||||||
Certain drawing surfaces allow additional ways to draw to them (e.g., Fl_Printer::print_widget(), Fl_Image_Surface::draw()).
|
|
||||||
<li> After all drawing requests have been performed, redirect graphics requests back to their previous destination
|
|
||||||
with \c old_current->set_current();.
|
|
||||||
<li> Delete \c surface.
|
|
||||||
</ol>
|
|
||||||
*/
|
|
||||||
class FL_EXPORT Fl_Surface_Device : public Fl_Device {
|
|
||||||
/** \brief The graphics driver in use by this surface. */
|
|
||||||
Fl_Graphics_Driver *_driver;
|
|
||||||
static Fl_Surface_Device *_surface; // the surface that currently receives graphics output
|
|
||||||
static Fl_Surface_Device *default_surface(); // create surface is none exists yet
|
|
||||||
protected:
|
|
||||||
/** \brief Constructor that sets the graphics driver to use for the created surface. */
|
|
||||||
Fl_Surface_Device(Fl_Graphics_Driver *graphics_driver) {_driver = graphics_driver; };
|
|
||||||
public:
|
|
||||||
static const char *class_id;
|
|
||||||
const char *class_name() {return class_id;};
|
|
||||||
virtual void set_current(void);
|
|
||||||
/** \brief Sets the graphics driver of this drawing surface. */
|
|
||||||
inline void driver(Fl_Graphics_Driver *graphics_driver) {_driver = graphics_driver;};
|
|
||||||
/** \brief Returns the graphics driver of this drawing surface. */
|
|
||||||
inline Fl_Graphics_Driver *driver() {return _driver; };
|
|
||||||
/** The current drawing surface.
|
|
||||||
In other words, the Fl_Surface_Device object that currently receives all graphics output */
|
|
||||||
static inline Fl_Surface_Device *surface() {
|
|
||||||
return _surface ? _surface : default_surface();
|
|
||||||
};
|
|
||||||
/** \brief The destructor. */
|
|
||||||
virtual ~Fl_Surface_Device() {}
|
|
||||||
};
|
|
||||||
|
|
||||||
/**
|
|
||||||
A display to which the computer can draw.
|
|
||||||
When the program begins running, an Fl_Display_Device instance has been created and made the current drawing surface.
|
|
||||||
There is no need to create any other object of this class.
|
|
||||||
*/
|
|
||||||
class FL_EXPORT Fl_Display_Device : public Fl_Surface_Device {
|
|
||||||
friend class Fl_Quartz_Graphics_Driver;
|
|
||||||
static Fl_Display_Device *_display; // the platform display device
|
|
||||||
#ifdef __APPLE__
|
|
||||||
friend class Fl_X;
|
|
||||||
friend class Fl_Graphics_Driver;
|
|
||||||
static bool high_res_window_; //< true when drawing to a window of a retina display (Mac OS X only)
|
|
||||||
static bool high_resolution() {return high_res_window_;}
|
|
||||||
#elif defined(WIN32)
|
|
||||||
#elif defined(FL_PORTING)
|
|
||||||
# pragma message "FL_PORTING: implement functions for extra high res drawing if your platform supports it"
|
|
||||||
#else
|
|
||||||
#endif
|
|
||||||
public:
|
|
||||||
static const char *class_id;
|
|
||||||
const char *class_name() {return class_id;};
|
|
||||||
Fl_Display_Device(Fl_Graphics_Driver *graphics_driver);
|
|
||||||
static Fl_Display_Device *display_device();
|
|
||||||
};
|
|
||||||
|
|
||||||
/**
|
|
||||||
This plugin socket allows the integration of new device drivers for special
|
|
||||||
window or screen types. It is currently used to provide an automated printing
|
|
||||||
service and screen capture for OpenGL windows, if linked with fltk_gl.
|
|
||||||
*/
|
|
||||||
class FL_EXPORT Fl_Device_Plugin : public Fl_Plugin {
|
|
||||||
public:
|
|
||||||
/** \brief The constructor */
|
|
||||||
Fl_Device_Plugin(const char *pluginName)
|
|
||||||
: Fl_Plugin(klass(), pluginName) { }
|
|
||||||
/** \brief Returns the class name */
|
|
||||||
virtual const char *klass() { return "fltk:device"; }
|
|
||||||
/** \brief Returns the plugin name */
|
|
||||||
virtual const char *name() = 0;
|
|
||||||
/** \brief Prints a widget
|
|
||||||
\param w the widget
|
|
||||||
\param x,y offsets where to print relatively to coordinates origin
|
|
||||||
\param height height of the current drawing area
|
|
||||||
*/
|
|
||||||
virtual int print(Fl_Widget* w, int x, int y, int height) = 0;
|
|
||||||
/** captures a rectangle of a widget as an image
|
|
||||||
\return The captured pixels as an RGB image
|
|
||||||
*/
|
|
||||||
virtual Fl_RGB_Image* rectangle_capture(Fl_Widget *widget, int x, int y, int w, int h) = 0;
|
|
||||||
};
|
|
||||||
|
|
||||||
#endif // FL_CFG_GFX_XLIB_H
|
#endif // FL_CFG_GFX_XLIB_H
|
||||||
|
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user