From 995a48dd003b51291bb1f2c5513c529a1ad8dfed Mon Sep 17 00:00:00 2001 From: ManoloFLTK <41016272+ManoloFLTK@users.noreply.github.com> Date: Sun, 31 Oct 2021 14:20:04 +0100 Subject: Consistently make Fl_Paged_Device::begin_page call Fl_Surface_Device::push_current. --- FL/Fl_Device.H | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) (limited to 'FL') diff --git a/FL/Fl_Device.H b/FL/Fl_Device.H index 6bf7cb675..890d4f744 100644 --- a/FL/Fl_Device.H +++ b/FL/Fl_Device.H @@ -38,14 +38,15 @@ class Fl_Widget; A drawing surface other than the computer's display, is typically used as follows:
  1. Create \c surface, an object from a particular Fl_Surface_Device derived class (e.g., Fl_Copy_Surface, Fl_Printer). -
  2. Call \c Fl_Surface_Device::push_current(surface); 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::begin_job()). +
  3. Call \c Fl_Surface_Device::push_current(surface); to redirect all graphics requests to + \c surface which becomes the new current drawing surface (not necessary with classes Fl_Printer / Fl_PostScript_File_Device + because it is done by Fl_Paged_Device::begin_page()).
  4. At this point all 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()) operate on the new current drawing surface. Drawing surfaces from Fl_Widget_Surface derived classes allow additional ways to draw to them (e.g., Fl_Printer::print_widget(), Fl_Image_Surface::draw()).
  5. After all drawing requests have been performed, redirect graphics requests back to their previous destination - with \c Fl_Surface_Device::pop_current();. + with \c Fl_Surface_Device::pop_current(); (not necessary with classes Fl_Printer / Fl_PostScript_File_Device).
  6. Delete \c surface.
For back-compatibility, it is also possible to use the Fl_Surface_Device::set_current() member function -- cgit v1.2.3