Author: manolo
Date: 2010-10-12 02:25:37 -0700 (Tue, 12 Oct 2010)
New Revision: 7719
Log:
Improved Doxygen doc of classes Fl_Graphics_Driver, Fl_PostScript_Printer,
Fl_System_Printer, Fl_PostScript_Graphics_Driver.
Modified:
branches/branch-1.3/FL/Fl_Device.H
branches/branch-1.3/FL/Fl_PostScript.H
branches/branch-1.3/FL/Fl_Printer.H
Modified: branches/branch-1.3/FL/Fl_Device.H
===================================================================
--- branches/branch-1.3/FL/Fl_Device.H 2010-10-12 08:12:44 UTC (rev 7718)
+++ branches/branch-1.3/FL/Fl_Device.H 2010-10-12 09:25:37 UTC (rev 7719)
@@ -94,16 +94,8 @@
*
The protected virtual methods of this class are those that a graphics driver
should implement to
support all of FLTK drawing functions.
- <br> The preferred FLTK API for drawing operations is the function collection
of the
- \ref fl_drawings and \ref fl_attributes modules.
- <br> Alternatively, methods of the Fl_Graphics_Driver class can be called
- using the global variable Fl_Graphics_Driver * \ref fl_graphics_driver that
points at all time to
- the single driver (an instance of an Fl_Graphics_Driver subclass) that's
currently receiving graphics
- requests. For example:
- \code fl_graphics_driver->rect(x, y, w, h); \endcode
- <br>Each protected method of the Fl_Graphics_Driver class has the same effect
as the
- function of the \ref fl_drawings and \ref fl_attributes modules which bears
the same name
- prefixed with fl_ and has the same parameter list.
+ <br> The public API for drawing operations is functionally presented in \ref
drawing and as function lists
+ in the \ref fl_drawings and \ref fl_attributes modules.
*/
class Fl_Graphics_Driver : public Fl_Device {
protected:
Modified: branches/branch-1.3/FL/Fl_PostScript.H
===================================================================
--- branches/branch-1.3/FL/Fl_PostScript.H 2010-10-12 08:12:44 UTC (rev
7718)
+++ branches/branch-1.3/FL/Fl_PostScript.H 2010-10-12 09:25:37 UTC (rev
7719)
@@ -243,11 +243,7 @@
void draw_image_mono(const uchar* d, int x,int y,int w,int h, int delta=1,
int ld=0){draw_scaled_image_mono(d,x,y,w,h,w,h,delta,ld);};
void draw_image(Fl_Draw_Image_Cb call, void* data, int x,int y, int w, int
h, int delta=3){draw_scaled_image(call,data, x, y, w, h, w, h, delta);};
void draw_image_mono(Fl_Draw_Image_Cb call, void* data, int x,int y, int w,
int h, int delta=1){draw_scaled_image_mono(call, data, x, y, w, h, w, h,
delta);};
-
- void draw(Fl_Pixmap * pxm,int XP, int YP, int WP, int HP, int cx, int cy);
- void draw(Fl_RGB_Image * rgb,int XP, int YP, int WP, int HP, int cx, int cy);
- void draw(Fl_Bitmap * bitmap,int XP, int YP, int WP, int HP, int cx, int cy);
-
+
public:
void page_policy(int p);
int page_policy(){return page_policy_;};
@@ -265,6 +261,9 @@
void place(double x, double y, double tx, double ty, double scale = 1);
#endif // FL_DOXYGEN
Fl_PostScript_Graphics_Driver();
+ void draw(Fl_Pixmap * pxm,int XP, int YP, int WP, int HP, int cx, int cy);
+ void draw(Fl_Bitmap * bitmap,int XP, int YP, int WP, int HP, int cx, int cy);
+ void draw(Fl_RGB_Image * rgb,int XP, int YP, int WP, int HP, int cx, int cy);
~Fl_PostScript_Graphics_Driver();
};
Modified: branches/branch-1.3/FL/Fl_Printer.H
===================================================================
--- branches/branch-1.3/FL/Fl_Printer.H 2010-10-12 08:12:44 UTC (rev 7718)
+++ branches/branch-1.3/FL/Fl_Printer.H 2010-10-12 09:25:37 UTC (rev 7719)
@@ -45,6 +45,7 @@
/**
\brief Print support under MSWindows and Mac OS X.
*
+ Class Fl_System_Printer is implemented only on the MSWindows and Mac OS X
platforms.
Use Fl_Printer instead that is cross-platform and has the same API.
Fl_Printer is typedef'ed to Fl_System_Printer under MSWindows and Mac OS X.
*/
@@ -123,6 +124,7 @@
/**
\brief Print support under Unix/Linux.
*
+ Class Fl_PostScript_Printer is implemented only on the Unix/Linux platform.
Use Fl_Printer instead that is cross-platform and has the same API.
Fl_Printer is typedef'ed to Fl_PostScript_Printer under Unix/Linux.
*/
@@ -168,7 +170,7 @@
<ul><li>Print any widget (standard, custom, Fl_Window, Fl_Gl_Window) as it
appears
on screen, with optional translation, scaling and rotation. This is done by
calling print_widget()
or print_window_part().
- <li>Use a series of FLTK graphics commands (e.g., font, text, lines, colors,
clip) to
+ <li>Use a series of FLTK graphics commands (e.g., font, text, lines, colors,
clip, image) to
compose a page appropriately shaped for printing.
</ul>
In both cases, begin by start_job(), start_page(), printable_rect() and
origin() calls
@@ -179,7 +181,7 @@
<ul>
<li>Unix/Linux platforms:
Class Fl_RGB_Image prints but loses its transparency if it has one.
- PostScript text output is presently restricted to the Latin alphabet.
+ See class Fl_PostScript_Graphics_Driver for a description of how UTF-8
strings appear in print.
Use the static public attributes of this class to set the print dialog to
other languages
than English. For example, the "Printer:" dialog item
Fl_Printer::dialog_printer can be set to French with:
\code
_______________________________________________
fltk-commit mailing list
[email protected]
http://lists.easysw.com/mailman/listinfo/fltk-commit
