diff options
| author | Matthias Melcher <fltk@matthiasm.com> | 2018-06-23 16:47:40 +0000 |
|---|---|---|
| committer | Matthias Melcher <fltk@matthiasm.com> | 2018-06-23 16:47:40 +0000 |
| commit | a9fd08ff5ab8bbf3838200ceace671a72627d212 (patch) | |
| tree | b7821c8f82a8ab75c682d9175c24bfaaf2993501 /FL/Fl_Graphics_Driver.H | |
| parent | 8c993648dbb568e35271ad4c8bd346d7eb97e69b (diff) | |
Doxygen: created Group to document drivers, disabled by default
Uncomment `ENABLED_SECTIONS += DriverDev` in documentation/Doxyfile.in
to enable driver documentation.
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.4@12968 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
Diffstat (limited to 'FL/Fl_Graphics_Driver.H')
| -rw-r--r-- | FL/Fl_Graphics_Driver.H | 18 |
1 files changed, 15 insertions, 3 deletions
diff --git a/FL/Fl_Graphics_Driver.H b/FL/Fl_Graphics_Driver.H index 96aed31b5..f80934bce 100644 --- a/FL/Fl_Graphics_Driver.H +++ b/FL/Fl_Graphics_Driver.H @@ -17,6 +17,12 @@ // http://www.fltk.org/str.php // +/** + * @cond DriverDev + * @addtogroup DriverDeveloper + * @{ + */ + /** \file Fl_Graphics_Driver.H \brief declaration of class Fl_Graphics_Driver. */ @@ -51,6 +57,7 @@ struct Fl_Fontdesc; #define FL_REGION_STACK_SIZE 10 #define FL_MATRIX_STACK_SIZE 32 + /** An abstract class subclassed for each graphics driver FLTK uses. Typically, FLTK applications do not use directly objects from this class. Rather, they perform @@ -58,14 +65,14 @@ struct Fl_Fontdesc; Drawing operations are functionally presented in \ref drawing and as function lists in the \ref fl_drawings and \ref fl_attributes modules. - \p <tt>Fl_Surface_Device::surface()->driver()</tt> + <tt>Fl_Surface_Device::surface()->driver()</tt> gives at any time the graphics driver used by all drawing operations. For compatibility with older FLTK versions, the \ref fl_graphics_driver global variable gives the same result. Its value changes when drawing operations are directed to another drawing surface by Fl_Surface_Device::push_current() / Fl_Surface_Device::pop_current() / Fl_Surface_Device::set_current(). - \p The Fl_Graphics_Driver class is of interest if one wants to perform new kinds of drawing operations. + The Fl_Graphics_Driver class is of interest if one wants to perform new kinds of drawing operations. An example would be to draw to an SVG file. This would require to create a new class, say SVG_Graphics_Driver, derived from class Fl_Graphics_Driver, and another new class, say SVG_Surface, derived from class Fl_Surface_Device. The new SVG_Graphics_Driver class should @@ -73,7 +80,7 @@ struct Fl_Fontdesc; and have them draw into SVG files. Alternatively, class SVG_Graphics_Driver could implement only some virtual methods, and only part of FLTK drawing functions would be usable when drawing to SVG files. - \p The Fl_Graphics_Driver class is essential for developers of the FLTK library. + The Fl_Graphics_Driver class is essential for developers of the FLTK library. Each platform supported by FLTK requires to create a derived class of Fl_Graphics_Driver that implements all its virtual member functions according to the platform. */ @@ -550,6 +557,11 @@ protected: #endif // FL_GRAPHICS_DRIVER_H +/** + * @} + * @endcond + */ + // // End of "$Id$". // |
