Added platform-specific information to Fl_Printer doc.

git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@7364 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
This commit is contained in:
Manolo Gouy 2010-03-30 12:09:09 +00:00
parent 0eae439b66
commit 065dfed2c3
2 changed files with 13 additions and 10 deletions

View File

@ -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:

View File

@ -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 @@ void Fl_Abstract_Printer::scale (float scale_x, float scale_y) {}
/**
@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) {}