Author: manolo
Date: 2010-03-30 05:09:09 -0700 (Tue, 30 Mar 2010)
New Revision: 7364
Log:
Added platform-specific information to Fl_Printer doc.

Modified:
   branches/branch-1.3/FL/Fl_Printer.H
   branches/branch-1.3/src/Fl_Abstract_Printer.cxx

Modified: branches/branch-1.3/FL/Fl_Printer.H
===================================================================
--- branches/branch-1.3/FL/Fl_Printer.H	2010-03-30 11:18:45 UTC (rev 7363)
+++ branches/branch-1.3/FL/Fl_Printer.H	2010-03-30 12:09:09 UTC (rev 7364)
@@ -52,19 +52,24 @@
  </ul>
  In both cases, begin by start_job(), start_page(), printable_rect() and origin() calls
  and finish by end_page() and end_job() calls.
- <p>On Xlib-based platforms (<i>e.g.</i>, Linux, Unix), this class is implemented as
+ <p><b>Platform specifics</b>
+ <ul>
+ <li>Xlib-based platforms (<i>e.g.</i>, Linux, Unix): this class is implemented as
  a subclass of Fl_PSfile_Device.
- <p>On Xlib-based platforms, the static public attributes of this class
- can be used 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:
+ 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
  Fl_Printer::dialog_printer = "Imprimante:";
  Fl_Printer myprinter;
  myprinter.start_job();
  \endcode
  Use Fl_PSfile_Device::file_chooser_title to customize the title of the file chooser dialog that opens
- when using the "Print To File" option of the print dialog.
- \see Fl_PSfile_Device.
+ when using the "Print To File" option of the print dialog. 
+ Class Fl_RGB_Image prints but looses its transparency if it has one.
+ <li>MSWindows platform: class Fl_RGB_Image looses its transparency if it has one, and doesn't rotate() well.
+ A workaround is to use the print_window_part() call. 
+ <li>Mac OS X platform: all graphics requests print as on display.
+ </ul>
  */
 class Fl_Printer : public Fl_Abstract_Printer {
 private:

Modified: branches/branch-1.3/src/Fl_Abstract_Printer.cxx
===================================================================
--- branches/branch-1.3/src/Fl_Abstract_Printer.cxx	2010-03-30 11:18:45 UTC (rev 7363)
+++ branches/branch-1.3/src/Fl_Abstract_Printer.cxx	2010-03-30 12:09:09 UTC (rev 7364)
@@ -37,8 +37,6 @@
  The widget's position on the printed page is determined by the last call to origin()
  and by the optional delta_x and delta_y arguments.
  Its dimensions are in points unless there was a previous call to scale().
- <br>Under MSWindows and X11, Fl_RGB_Image's are printed without transparency.
- A workaround is to use the print_window_part() call. 
  @param[in] widget Any FLTK widget (e.g., standard, custom, window).
  @param[in] delta_x Optional horizontal offset for positioning the widget relatively
  to the current origin of graphics functions.
@@ -259,8 +257,8 @@
 /**
  @brief Rotates the graphics operations relatively to paper.
  *
- The rotation is centered on the current graphics origin. Successive rotate() calls don't combine their effects.
- On MSWindows, Fl_RGB_Image's don't rotate well; print_window_part() is an efficient workaround.
+ The rotation is centered on the current graphics origin. 
+ Successive rotate() calls don't combine their effects.
  @param angle Rotation angle in counterclockwise degrees.
  */
 void Fl_Abstract_Printer::rotate(float angle) {}