Author: manolo
Date: 2010-03-20 01:31:19 -0700 (Sat, 20 Mar 2010)
New Revision: 7306
Log:
Created FL/Fl_PSfile_Device.H to reduce size of FL/Fl_Printer.H
Added:
branches/branch-1.3/FL/Fl_PSfile_Device.H
Modified:
branches/branch-1.3/FL/Fl_Device.H
branches/branch-1.3/FL/Fl_Printer.H
branches/branch-1.3/src/Fl_GDI_Printer.cxx
branches/branch-1.3/src/Fl_PS_Printer.cxx
branches/branch-1.3/src/Fl_Quartz_Printer.mm
branches/branch-1.3/src/ps_image.cxx
Modified: branches/branch-1.3/FL/Fl_Device.H
===================================================================
--- branches/branch-1.3/FL/Fl_Device.H 2010-03-19 21:40:12 UTC (rev 7305)
+++ branches/branch-1.3/FL/Fl_Device.H 2010-03-20 08:31:19 UTC (rev 7306)
@@ -161,16 +161,23 @@
virtual void draw(Fl_Bitmap * bmp,int XP, int YP, int WP, int HP, int cx,
int cy);
public:
+ /**
+ @brief All implemented graphics output devices.
+ */
enum device_types {
- xlib_display = 0, quartz_display, gdi_display,
- gdi_printer = 256, quartz_printer, postscript_device
+ xlib_display = 0, /**< The X11 display. */
+ quartz_display, /**< The Mac OS X display. */
+ gdi_display, /**< The MSWindows display. */
+ gdi_printer = 256, /**< The MSWindows printer. */
+ quartz_printer, /**< The Mac OS X printer. */
+ postscript_device /**< The PostScript device. */
};
/**
- @brief An RTTI emulation of device classes. It returns values < 256 if it
is a screen device
+ @brief An RTTI emulation of device classes. It returns values < 256 if it
is a display device
*/
int type() {return type_;};
/**
- @brief Sets this device (display, local file, printer) as the target of
future graphics calls.
+ @brief Sets this device (display, printer, local file) as the target of
future graphics calls.
*
@return The current target device of graphics calls.
*/
@@ -195,7 +202,7 @@
@brief A virtual class subclassed for OS-specific display graphics.
*/
class Fl_Display : public Fl_Device {
- friend class Fl_PSfile_Device; //RK: temporary hack for font sizes
+ friend class Fl_PSfile_Device;
};
#if defined(__APPLE__) || defined(FL_DOXYGEN)
Added: branches/branch-1.3/FL/Fl_PSfile_Device.H
===================================================================
--- branches/branch-1.3/FL/Fl_PSfile_Device.H (rev 0)
+++ branches/branch-1.3/FL/Fl_PSfile_Device.H 2010-03-20 08:31:19 UTC (rev
7306)
@@ -0,0 +1,293 @@
+//
+// "$Id:$"
+//
+// Support for graphics output to PostScript file for the Fast Light Tool Kit
(FLTK).
+//
+// Copyright 2010 by Bill Spitzak and others.
+//
+// This library is free software; you can redistribute it and/or
+// modify it under the terms of the GNU Library General Public
+// License as published by the Free Software Foundation; either
+// version 2 of the License, or (at your option) any later version.
+//
+// This library is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+// Library General Public License for more details.
+//
+// You should have received a copy of the GNU Library General Public
+// License along with this library; if not, write to the Free Software
+// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
+// USA.
+//
+// Please report all bugs and problems on the following page:
+//
+// http://www.fltk.org/str.php
+//
+
+#include <FL/Fl_Printer.H>
+
+#ifndef Fl_PSfile_Device_H
+#define Fl_PSfile_Device_H
+
+/**
+ \brief Sends all graphics to a local PostScript file; same API as Fl_Printer
class.
+ *
+ This class has the same API as class Fl_Printer except for start_job() member
function.
+ \see class Fl_Printer.
+ */
+class Fl_PSfile_Device : public Fl_Abstract_Printer {
+ public:
+ /**
+ @brief Possible page formats.
+ */
+ enum Page_Format{
+ A0 = 0,
+ A1,
+ A2,
+ A3,
+ A4,
+ A5,
+ A6,
+ A7,
+ A8,
+ A9,
+ B0,
+ B1,
+ B2,
+ B3,
+ B4,
+ B5,
+ B6,
+ B7,
+ B8,
+ B9,
+ B10,
+ C5E,
+ DLE,
+ EXECUTIVE,
+ FOLIO,
+ LEDGER,
+ LEGAL,
+ LETTER,
+ TABLOID,
+ ENVELOPE,
+ MEDIA = 0x1000
+ };
+
+ /**
+ @brief Possible page layouts.
+ */
+ enum Page_Layout {PORTRAIT = 0, LANDSCAPE = 0x100, REVERSED = 0x200,
ORIENTATION = 0x300};
+
+#ifndef FL_DOXYGEN
+ private:
+ enum SHAPE{NONE=0, LINE, LOOP, POLYGON, POINTS};
+
+ class Clip{
+ public:
+ int x, y, w, h;
+ Clip *prev;
+ };
+ Clip * clip_;
+
+ int lang_level_;
+ int font_;
+ int size_;
+ Fl_Color color_;
+ int gap_;
+ int pages_;
+
+ double width_;
+ double height_;
+
+ int shape_;
+ int linewidth_;// need for clipping, lang level 1-2
+ int linestyle_;//
+ int interpolate_; //interpolation of images
+ unsigned char cr_,cg_,cb_;
+ char linedash_[256];//should be enought
+ void concat(); // transform ror scalable dradings...
+ void reconcat(); //invert
+ void recover(); //recovers the state afrer grestore (such as line
styles...)
+ void reset();
+
+ uchar * mask;
+ int mx; // width of mask;
+ int my; // mask lines
+ //Fl_Color bg_;
+ int (*close_cmd_)(FILE *);
+ int page_policy_;
+ int nPages;
+ int orientation_;
+
+ float scale_x;
+ float scale_y;
+ float angle;
+ int left_margin;
+ int top_margin;
+
+ protected:
+ struct page_format {
+ int width;
+ int height;
+ const char *name;
+ };
+
+ FILE *output;
+ double pw_, ph_;
+ static const int NO_PAGE_FORMATS=30;
+ static const struct page_format page_formats[NO_PAGE_FORMATS];
+
+ uchar bg_r, bg_g, bg_b;
+ int start_postscript (int pagecount, enum Page_Format format, enum
Page_Layout layout);
+ /* int alpha_mask(const uchar * data, int w, int h, int D, int LD=0);
+ */
+ void draw(const char* s, int n, int x, int y) {transformed_draw(s,n,x,y);
};
+ void draw(int angle, const char *str, int n, int x, int y);
+ void transformed_draw(const char* s, int n, double x, double y); //precise
text placing
+ void transformed_draw(const char* s, double x, double y);
+ int alpha_mask(const uchar * data, int w, int h, int D, int LD=0);
+ void draw_scaled_image(const uchar *data, double x, double y, double w,
double h, int iw, int ih, int D=3, int LD=0);
+ void draw_scaled_image_mono(const uchar *data, double x, double y, double
w, double h, int iw, int ih, int D=3, int LD=0);
+ void draw_scaled_image(Fl_Draw_Image_Cb call, void *data, double x, double
y, double w, double h, int iw, int ih, int D);
+ void draw_scaled_image_mono(Fl_Draw_Image_Cb call, void *data, double x,
double y, double w, double h, int iw, int ih, int D);
+
+ enum Page_Format page_format_;
+ char *ps_filename_;
+ // implementation of drawing methods
+ void color(Fl_Color c);
+ //void bg_color(Fl_Color bg);
+ void color(uchar r, uchar g, uchar b);
+ Fl_Color color(){return color_;};
+
+ void push_clip(int x, int y, int w, int h);
+ int clip_box(int x, int y, int w, int h, int &X, int &Y, int &W, int &H);
+ int not_clipped(int x, int y, int w, int h);
+ void push_no_clip();
+ void pop_clip();
+
+ void line_style(int style, int width=0, char* dashes=0);
+
+ void rect(int x, int y, int w, int h);
+ void rectf(int x, int y, int w, int h);
+
+ void xyline(int x, int y, int x1);
+ void xyline(int x, int y, int x1, int y2);
+ void xyline(int x, int y, int x1, int y2, int x3);
+
+ void yxline(int x, int y, int y1);
+ void yxline(int x, int y, int y1, int x2);
+ void yxline(int x, int y, int y1, int x2, int y3);
+
+ void line(int x1, int y1, int x2, int y2);
+ void line(int x1, int y1, int x2, int y2, int x3, int y3);
+
+ void loop(int x0, int y0, int x1, int y1, int x2, int y2);
+ void loop(int x0, int y0, int x1, int y1, int x2, int y2, int x3, int y3);
+ void polygon(int x0, int y0, int x1, int y1, int x2, int y2);
+ void polygon(int x0, int y0, int x1, int y1, int x2, int y2, int x3, int
y3);
+ void point(int x, int y);
+
+ void begin_points();
+ void begin_line();
+ void begin_loop();
+ void begin_polygon();
+ void vertex(double x, double y);
+ void curve(double x, double y, double x1, double y1, double x2, double y2,
double x3, double y3);
+ void circle(double x, double y, double r);
+ void arc(double x, double y, double r, double start, double a);
+ void arc(int x, int y, int w, int h, double a1, double a2);
+ void pie(int x, int y, int w, int h, double a1, double a2);
+ void end_points();
+ void end_line();
+ void end_loop();
+ void end_polygon();
+ void begin_complex_polygon(){begin_polygon();};
+ void gap(){gap_=1;};
+ void end_complex_polygon(){end_polygon();};
+ void transformed_vertex(double x, double y);
+
+ void font(int face, int size);
+ int font(){return font_;};
+ int size(){return size_;};
+ double width(unsigned c);
+ double width(const char* s, int n);
+ int descent();
+ int height();
+
+ void draw_image(const uchar* d, int x,int y,int w,int h, int delta=3, int
ldelta=0){draw_scaled_image(d,x,y,w,h,w,h,delta,ldelta);};
+ 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_;};
+ void close_command( int (*cmd)(FILE *)){close_cmd_=cmd;};
+ FILE * file() {return output;};
+ //void orientation (int o);
+ //Fl_PSfile_Device(FILE *o, int lang_level, int pages = 0); // ps (also
multi-page) constructor
+ //Fl_PSfile_Device(FILE *o, int lang_level, int x, int y, int w, int h);
//eps constructor
+ void interpolate(int i){interpolate_=i;};
+ int interpolate(){return interpolate_;}
+
+ void page(double pw, double ph, int media = 0);
+ void page(int format);
+
+ void place(double x, double y, double tx, double ty, double scale = 1);
+ int start_page (void);
+ int printable_rect(int *w, int *h);
+ void margins(int *left, int *top, int *right, int *bottom);
+ void origin(int x, int y);
+ void scale (float scale_x, float scale_y);
+ void rotate(float angle);
+ void translate(int x, int y);
+ void untranslate(void);
+ int end_page (void);
+ void end_job (void);
+
+#endif // FL_DOXYGEN
+
+ /**
+ @brief The constructor.
+ */
+ Fl_PSfile_Device(void);
+
+ /**
+ @brief Begins the session where all graphics will go to a local PostScript
file.
+ *
+ Opens a file dialog to select an output PostScript file.
+ @param pagecount The total number of pages to be created.
+ @param format Desired page format.
+ @param layout Desired page layout.
+ @return 0 iff OK
+ */
+ int start_job(int pagecount, enum Page_Format format = A4, enum Page_Layout
layout = PORTRAIT);
+
+ /**
+ @brief Begins the session where all graphics will go to named PostScript
file.
+ *
+ @param fname The name of the output local PostScript file.
+ @param pagecount The total number of pages to be created.
+ @param format Desired page format.
+ @param layout Desired page layout.
+ @return 0 iff OK
+ */
+ int start_job(const char *fname, int pagecount, enum Page_Format format =
A4, enum Page_Layout layout = PORTRAIT);
+
+ /**
+ @brief The destructor.
+ */
+ virtual ~Fl_PSfile_Device();
+};
+
+#endif // Fl_PSfile_Device_H
+
+//
+// End of "$Id:$"
+//
Modified: branches/branch-1.3/FL/Fl_Printer.H
===================================================================
--- branches/branch-1.3/FL/Fl_Printer.H 2010-03-19 21:40:12 UTC (rev 7305)
+++ branches/branch-1.3/FL/Fl_Printer.H 2010-03-20 08:31:19 UTC (rev 7306)
@@ -3,7 +3,7 @@
//
// Printing support for the Fast Light Tool Kit (FLTK).
//
-// Copyright 1998-2010 by Bill Spitzak and others.
+// Copyright 2010 by Bill Spitzak and others.
//
// This library is free software; you can redistribute it and/or
// modify it under the terms of the GNU Library General Public
@@ -36,29 +36,15 @@
#include <stdio.h>
/**
- * @brief Provides an OS-independent interface to printing.
+ \brief A virtual class for print support with several platform-dependent
implementations.
*
- It allows to use all FLTK drawing, color, text, and clip functions, and to
have them operate
- on printed page(s). There are two main, non exclusive, ways to use it.
- <ul><li>Print any widget (standard, custom, Fl_Window, Fl_Gl_Window) as it
appears
- on screen, with optional translation and scaling. 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
- compose a page appropriately shaped for printing.
- </ul>
- In both cases, begin by start_job(), start_page(), printable_rect() and
origin() calls
- and finish by end_page() and end_job() calls.
+ This class has no public constructor: don't instantiate it; use Fl_Printer
instead.
+ \see class Fl_Printer for most member functions documentation.
*/
-class
-#ifndef FL_DOXYGEN
- Fl_Abstract_Printer
-#else
- Fl_Printer
-#endif
- : public Fl_Device {
- friend class Fl_Pixmap;
- friend class Fl_RGB_Image;
- friend class Fl_Bitmap;
+class Fl_Abstract_Printer : public Fl_Device {
+ friend class Fl_Pixmap;
+ friend class Fl_RGB_Image;
+ friend class Fl_Bitmap;
private:
struct chain_elt {
Fl_Image *image;
@@ -68,199 +54,65 @@
void add_image(Fl_Image *image, const uchar *data); // adds an image to the
page image list
void traverse(Fl_Widget *widget); // finds subwindows of widget and prints
them
protected:
- int y_offset;
+ /** \brief horizontal offset to the origin of graphics coordinates */
int x_offset;
- struct chain_elt *image_list_; // chained list of Fl_Image's used in this
page
- void *gc; // the printer's graphics context, if there's one, NULL otherwise
- void delete_image_list(); // deletes the page image list
-#ifndef FL_DOXYGEN
- Fl_Abstract_Printer(void) { gc = NULL; bg_r_ = bg_g_ = bg_b_ = 0; };
-#endif
+ /** \brief vertical offset to the origin of graphics coordinates */
+ int y_offset;
+ /** \brief chained list of Fl_Image's used in this page */
+ struct chain_elt *image_list_;
+ /** \brief the printer's graphics context, if there's one, NULL otherwise */
+ void *gc;
+ /** \brief the constructor */
+ Fl_Abstract_Printer(void) { gc = NULL; bg_r_ = bg_g_ = bg_b_ = 0; };
+ /** \brief deletes the page image list */
+ void delete_image_list();
public:
-#ifdef FL_DOXYGEN
- /**
- @brief The constructor.
- */
- Fl_Printer(void);
+ /**
+ @brief Sets this printer as the target of future graphics calls.
+ @return The current target device of graphics calls.
+ */
+ Fl_Device *set_current(void);
+ virtual int start_job(int pagecount, int *frompage = NULL, int *topage =
NULL);
+ virtual int start_page(void);
+ virtual int printable_rect(int *w, int *h);
+ virtual void margins(int *left, int *top, int *right, int *bottom);
+ virtual void origin(int x, int y);
+ void origin(int *x, int *y);
+ virtual void scale (float scale_x, float scale_y);
+ virtual void rotate(float angle);
+ virtual void translate(int x, int y);
+ virtual void untranslate(void);
+ void print_widget(Fl_Widget* widget, int delta_x = 0, int delta_y = 0);
+ void print_window_part(Fl_Window *win, int x, int y, int w, int h, int
delta_x = 0, int delta_y = 0);
+ virtual int end_page (void);
+ virtual void end_job (void);
+};
- /**
- @brief The destructor.
- */
- ~Fl_Printer(void);
-#endif
-
- /**
- @brief Starts a print job.
- *
- @param[in] pagecount the total number of pages of the job
- @param[out] frompage if non-null, *frompage is set to the first page the
user wants printed
- @param[out] topage if non-null, *topage is set to the last page the user
wants printed
- @return 0 iff OK
- */
- virtual int start_job(int pagecount, int *frompage = NULL, int *topage =
NULL);
-
- /**
- @brief Starts a new printed page
- *
- The page coordinates are initially in points, i.e., 1/72 inch,
- and with origin at the top left of the printable page area.
- @return 0 iff OK
- */
- virtual int start_page(void);
-
- /**
- @brief Computes the width and height of the printable area of the page.
- *
- Values are in the same unit as that used by FLTK drawing functions,
- are unchanged by calls to origin(), but are changed by scale() calls.
- Values account for the user-selected paper type and print orientation.
- @return 0 iff OK.
- */
- virtual int printable_rect(int *w, int *h);
-
- /**
- @brief Computes the dimensions of margins that lie between the printable
page area and
- the full page.
- *
- Values are in the same unit as that used by FLTK drawing functions. They
are changed
- by scale() calls.
- @param[out] left If non-null, *left is set to the left margin size.
- @param[out] top If non-null, *top is set to the top margin size.
- @param[out] right If non-null, *right is set to the right margin size.
- @param[out] bottom If non-null, *bottom is set to the bottom margin size.
- */
- virtual void margins(int *left, int *top, int *right, int *bottom);
-
- /**
- @brief Sets the position in page coordinates of the origin of graphics
functions.
- *
- Arguments should be expressed relatively to the result of a previous
printable_rect() call.
- That is, <tt>printable_rect(&w, &h); origin(w/2, 0);</tt> sets the
graphics origin at the
- top center of the page printable area.
- Origin() calls are not affected by rotate() calls.
- Successive origin() calls don't combine their effects.
- @param[in] x Horizontal position in page coordinates of the desired
origin of graphics functions.
- @param[in] y Same as above, vertically.
- */
- virtual void origin(int x, int y);
-
- /**
- @brief Computes the page coordinates of the current origin of graphics
functions.
- *
- @param[out] x If non-null, *x is set to the horizontal page offset of
graphics origin.
- @param[out] y Same as above, vertically.
- */
- void origin(int *x, int *y);
-
- /**
- @brief Changes the scaling of page coordinates.
- *
- This function also resets the origin of graphics functions at top left
of printable page area.
- After a scale() call, do a printable_rect() call to get the new
dimensions of the printable page area.
- Successive scale() calls don't combine their effects.
- @param scale_x Horizontal dimensions of plot are multiplied by this
quantity.
- @param scale_y Same as above, vertically.
- */
- virtual void 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.
- @param angle Rotation angle in counterclockwise degrees.
- */
- virtual void rotate(float angle);
-
- /**
- @brief Translates the current graphics origin accounting for the current
rotation.
- *
- This function is only useful after a rotate() call.
- Each translate() call must be matched by an untranslate() call.
- Successive translate() calls add up their effects.
- */
- virtual void translate(int x, int y);
-
- /**
- @brief Undoes the effect of a previous translate() call.
- */
- virtual void untranslate(void);
-
- /**
- @brief Draws the widget on the printed page.
- *
- 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, 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.
- @param[in] delta_y Same as above, vertically.
- */
- void print_widget(Fl_Widget* widget, int delta_x = 0, int delta_y = 0);
-
- /**
- @brief Prints a rectangular part of an on-screen window.
- *
- @param win The window from where to capture.
- @param x The rectangle left
- @param y The rectangle top
- @param w The rectangle width
- @param h The rectangle height
- @param delta_x Optional horizontal offset from current graphics origin
where to print the captured rectangle.
- @param delta_y As above, vertically.
- */
- void print_window_part(Fl_Window *win, int x, int y, int w, int h, int
delta_x = 0, int delta_y = 0);
-
- /**
- @brief To be called at the end of each page.
- *
- @return 0 iff OK.
- */
- virtual int end_page (void);
-
- /**
- @brief To be called at the end of a print job.
- */
- virtual void end_job (void);
-
- /**
- @brief Sets this printer as the target of future graphics calls.
- @return The current target device of graphics calls.
- */
- Fl_Device *set_current(void);
- };
-
-#ifdef __APPLE__
-class Fl_Quartz_Printer : public Fl_Abstract_Printer {
+#if defined(__APPLE__) || defined(WIN32) || defined(FL_DOXYGEN)
+/**
+ * @brief Provides an OS-independent interface to printing.
+ *
+ It allows to use all FLTK drawing, color, text, and clip functions, and to
have them operate
+ on printed page(s). There are two main, non exclusive, ways to use it.
+ <ul><li>Print any widget (standard, custom, Fl_Window, Fl_Gl_Window) as it
appears
+ on screen, with optional translation and scaling. 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
+ compose a page appropriately shaped for printing.
+ </ul>
+ In both cases, begin by start_job(), start_page(), printable_rect() and
origin() calls
+ and finish by end_page() and end_job() calls.
+ */
+class Fl_Printer : public Fl_Abstract_Printer {
private:
+#ifdef __APPLE__
float scale_x;
float scale_y;
float angle; // rotation angle in radians
PMPrintSession printSession;
PMPageFormat pageFormat;
PMPrintSettings printSettings;
-public:
- Fl_Quartz_Printer(void);
- int start_job(int pagecount, int *frompage = NULL, int *topage = NULL);
- int start_page (void);
- int printable_rect(int *w, int *h);
- void margins(int *left, int *top, int *right, int *bottom);
- void origin(int x, int y);
- void scale (float scale_x, float scale_y);
- void rotate(float angle);
- void translate(int x, int y);
- void untranslate(void);
- int end_page (void);
- void end_job (void);
-};
-#endif
-
-#ifdef WIN32
-class Fl_GDI_Printer : public Fl_Abstract_Printer {
-private:
+#elif defined(WIN32)
int abortPrint;
PRINTDLG pd;
HDC hPr;
@@ -268,305 +120,163 @@
int left_margin;
int top_margin;
void absolute_printable_rect(int *x, int *y, int *w, int *h);
+#endif
public:
- Fl_GDI_Printer(void);
+ /**
+ @brief The constructor.
+ */
+ Fl_Printer(void);
+
+ /**
+ @brief Starts a print job.
+ *
+ @param[in] pagecount the total number of pages of the job
+ @param[out] frompage if non-null, *frompage is set to the first page the
user wants printed
+ @param[out] topage if non-null, *topage is set to the last page the user
wants printed
+ @return 0 iff OK
+ */
int start_job(int pagecount, int *frompage = NULL, int *topage = NULL);
+
+ /**
+ @brief Starts a new printed page
+ *
+ The page coordinates are initially in points, i.e., 1/72 inch,
+ and with origin at the top left of the printable page area.
+ @return 0 iff OK
+ */
int start_page (void);
+
+ /**
+ @brief Computes the width and height of the printable area of the page.
+ *
+ Values are in the same unit as that used by FLTK drawing functions,
+ are unchanged by calls to origin(), but are changed by scale() calls.
+ Values account for the user-selected paper type and print orientation.
+ @return 0 iff OK.
+ */
int printable_rect(int *w, int *h);
+
+ /**
+ @brief Computes the dimensions of margins that lie between the printable
page area and
+ the full page.
+ *
+ Values are in the same unit as that used by FLTK drawing functions. They
are changed
+ by scale() calls.
+ @param[out] left If non-null, *left is set to the left margin size.
+ @param[out] top If non-null, *top is set to the top margin size.
+ @param[out] right If non-null, *right is set to the right margin size.
+ @param[out] bottom If non-null, *bottom is set to the bottom margin size.
+ */
void margins(int *left, int *top, int *right, int *bottom);
+
+ /**
+ @brief Sets the position in page coordinates of the origin of graphics
functions.
+ *
+ Arguments should be expressed relatively to the result of a previous
printable_rect() call.
+ That is, <tt>printable_rect(&w, &h); origin(w/2, 0);</tt> sets the graphics
origin at the
+ top center of the page printable area.
+ Origin() calls are not affected by rotate() calls.
+ Successive origin() calls don't combine their effects.
+ @param[in] x Horizontal position in page coordinates of the desired origin
of graphics functions.
+ @param[in] y Same as above, vertically.
+ */
void origin(int x, int y);
+#ifdef FL_DOXYGEN
+ /**
+ @brief Computes the page coordinates of the current origin of graphics
functions.
+ *
+ @param[out] x If non-null, *x is set to the horizontal page offset of
graphics origin.
+ @param[out] y Same as above, vertically.
+ */
+ void origin(int *x, int *y);
+#endif
+ /**
+ @brief Changes the scaling of page coordinates.
+ *
+ This function also resets the origin of graphics functions at top left of
printable page area.
+ After a scale() call, do a printable_rect() call to get the new dimensions
of the printable page area.
+ Successive scale() calls don't combine their effects.
+ @param scale_x Horizontal dimensions of plot are multiplied by this
quantity.
+ @param scale_y Same as above, vertically.
+ */
void 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.
+ @param angle Rotation angle in counterclockwise degrees.
+ */
void rotate(float angle);
+
+ /**
+ @brief Translates the current graphics origin accounting for the current
rotation.
+ *
+ This function is only useful after a rotate() call.
+ Each translate() call must be matched by an untranslate() call.
+ Successive translate() calls add up their effects.
+ */
void translate(int x, int y);
+
+ /**
+ @brief Undoes the effect of a previous translate() call.
+ */
void untranslate(void);
+#ifdef FL_DOXYGEN
+ /**
+ @brief Draws the widget on the printed page.
+ *
+ 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, 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.
+ @param[in] delta_y Same as above, vertically.
+ */
+ void print_widget(Fl_Widget* widget, int delta_x = 0, int delta_y = 0);
+
+ /**
+ @brief Prints a rectangular part of an on-screen window.
+ *
+ @param win The window from where to capture.
+ @param x The rectangle left
+ @param y The rectangle top
+ @param w The rectangle width
+ @param h The rectangle height
+ @param delta_x Optional horizontal offset from current graphics origin
where to print the captured rectangle.
+ @param delta_y As above, vertically.
+ */
+ void print_window_part(Fl_Window *win, int x, int y, int w, int h, int
delta_x = 0, int delta_y = 0);
+#endif
+ /**
+ @brief To be called at the end of each page.
+ *
+ @return 0 iff OK.
+ */
int end_page (void);
+
+ /**
+ @brief To be called at the end of a print job.
+ */
void end_job (void);
};
-#endif
-
-/**
- @brief Creates a session where all graphics will go to a local PostScript
file. Same API as Fl_Printer class.
- *
- This class has the same API as class Fl_Printer except for start_job() member
function.
- \see class Fl_Printer.
- */
-class Fl_PSfile_Device : public
-#ifndef FL_DOXYGEN
- Fl_Abstract_Printer
#else
- Fl_Device
-#endif
- { // defined for all 3 platforms
-public:
- /**
- @brief Possible page formats.
- */
- enum Page_Format{
- A0 = 0,
- A1,
- A2,
- A3,
- A4,
- A5,
- A6,
- A7,
- A8,
- A9,
- B0,
- B1,
- B2,
- B3,
- B4,
- B5,
- B6,
- B7,
- B8,
- B9,
- B10,
- C5E,
- DLE,
- EXECUTIVE,
- FOLIO,
- LEDGER,
- LEGAL,
- LETTER,
- TABLOID,
- ENVELOPE,
- MEDIA = 0x1000
- };
-
- /**
- @brief Possible page layouts.
- */
- enum Page_Layout {PORTRAIT = 0, LANDSCAPE = 0x100, REVERSED = 0x200,
ORIENTATION = 0x300};
-#ifndef FL_DOXYGEN
-private:
- enum SHAPE{NONE=0, LINE, LOOP, POLYGON, POINTS};
-
- class Clip{
- public:
- int x, y, w, h;
- Clip *prev;
- };
- Clip * clip_;
-
- int lang_level_;
- int font_;
- int size_;
- Fl_Color color_;
- int gap_;
- int pages_;
-
- double width_;
- double height_;
-
- int shape_;
- int linewidth_;// need for clipping, lang level 1-2
- int linestyle_;//
- int interpolate_; //interpolation of images
- unsigned char cr_,cg_,cb_;
- char linedash_[256];//should be enought
- void concat(); // transform ror scalable dradings...
- void reconcat(); //invert
- void recover(); //recovers the state afrer grestore (such as line styles...)
- void reset();
-
- uchar * mask;
- int mx; // width of mask;
- int my; // mask lines
- //Fl_Color bg_;
- int (*close_cmd_)(FILE *);
- int page_policy_;
- int nPages;
- int orientation_;
-
- float scale_x;
- float scale_y;
- float angle;
- int left_margin;
- int top_margin;
+#include <FL/Fl_PSfile_Device.H>
-protected:
- struct page_format {
- int width;
- int height;
- const char *name;
- };
-
- FILE *output;
- double pw_, ph_;
- static const int NO_PAGE_FORMATS=30;
- static const struct page_format page_formats[NO_PAGE_FORMATS];
-
- uchar bg_r, bg_g, bg_b;
- int start_postscript (int pagecount, enum Page_Format format, enum
Page_Layout layout);
- /* int alpha_mask(const uchar * data, int w, int h, int D, int LD=0);
- */
- void draw(const char* s, int n, int x, int y) {transformed_draw(s,n,x,y); };
- void draw(int angle, const char *str, int n, int x, int y);
- void transformed_draw(const char* s, int n, double x, double y); //precise
text placing
- void transformed_draw(const char* s, double x, double y);
- int alpha_mask(const uchar * data, int w, int h, int D, int LD=0);
- void draw_scaled_image(const uchar *data, double x, double y, double w,
double h, int iw, int ih, int D=3, int LD=0);
- void draw_scaled_image_mono(const uchar *data, double x, double y, double w,
double h, int iw, int ih, int D=3, int LD=0);
- void draw_scaled_image(Fl_Draw_Image_Cb call, void *data, double x, double
y, double w, double h, int iw, int ih, int D);
- void draw_scaled_image_mono(Fl_Draw_Image_Cb call, void *data, double x,
double y, double w, double h, int iw, int ih, int D);
-
- enum Page_Format page_format_;
- char *ps_filename_;
- // implementation of drawing methods
- void color(Fl_Color c);
- //void bg_color(Fl_Color bg);
- void color(uchar r, uchar g, uchar b);
- Fl_Color color(){return color_;};
-
- void push_clip(int x, int y, int w, int h);
- int clip_box(int x, int y, int w, int h, int &X, int &Y, int &W, int &H);
- int not_clipped(int x, int y, int w, int h);
- void push_no_clip();
- void pop_clip();
-
- void line_style(int style, int width=0, char* dashes=0);
-
- void rect(int x, int y, int w, int h);
- void rectf(int x, int y, int w, int h);
-
- void xyline(int x, int y, int x1);
- void xyline(int x, int y, int x1, int y2);
- void xyline(int x, int y, int x1, int y2, int x3);
-
- void yxline(int x, int y, int y1);
- void yxline(int x, int y, int y1, int x2);
- void yxline(int x, int y, int y1, int x2, int y3);
-
- void line(int x1, int y1, int x2, int y2);
- void line(int x1, int y1, int x2, int y2, int x3, int y3);
-
- void loop(int x0, int y0, int x1, int y1, int x2, int y2);
- void loop(int x0, int y0, int x1, int y1, int x2, int y2, int x3, int y3);
- void polygon(int x0, int y0, int x1, int y1, int x2, int y2);
- void polygon(int x0, int y0, int x1, int y1, int x2, int y2, int x3, int y3);
- void point(int x, int y);
-
- void begin_points();
- void begin_line();
- void begin_loop();
- void begin_polygon();
- void vertex(double x, double y);
- void curve(double x, double y, double x1, double y1, double x2, double y2,
double x3, double y3);
- void circle(double x, double y, double r);
- void arc(double x, double y, double r, double start, double a);
- void arc(int x, int y, int w, int h, double a1, double a2);
- void pie(int x, int y, int w, int h, double a1, double a2);
- void end_points();
- void end_line();
- void end_loop();
- void end_polygon();
- void begin_complex_polygon(){begin_polygon();};
- void gap(){gap_=1;};
- void end_complex_polygon(){end_polygon();};
- void transformed_vertex(double x, double y);
-
- void font(int face, int size);
- int font(){return font_;};
- int size(){return size_;};
- double width(unsigned c);
- double width(const char* s, int n);
- int descent();
- int height();
-
- void draw_image(const uchar* d, int x,int y,int w,int h, int delta=3, int
ldelta=0){draw_scaled_image(d,x,y,w,h,w,h,delta,ldelta);};
- 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);
-
+class Fl_Printer : public Fl_PSfile_Device {
public:
- void page_policy(int p);
- int page_policy(){return page_policy_;};
- void close_command( int (*cmd)(FILE *)){close_cmd_=cmd;};
- FILE * file() {return output;};
- //void orientation (int o);
- //Fl_PSfile_Device(FILE *o, int lang_level, int pages = 0); // ps (also
multi-page) constructor
- //Fl_PSfile_Device(FILE *o, int lang_level, int x, int y, int w, int h);
//eps constructor
- void interpolate(int i){interpolate_=i;};
- int interpolate(){return interpolate_;}
-
- void page(double pw, double ph, int media = 0);
- void page(int format);
-
- void place(double x, double y, double tx, double ty, double scale = 1);
- int start_page (void);
- int printable_rect(int *w, int *h);
- void margins(int *left, int *top, int *right, int *bottom);
- void origin(int x, int y);
- void scale (float scale_x, float scale_y);
- void rotate(float angle);
- void translate(int x, int y);
- void untranslate(void);
- int end_page (void);
- void end_job (void);
-
-#endif // FL_DOXYGEN
-
- /**
- @brief The constructor.
- */
- Fl_PSfile_Device(void);
-
- /**
- @brief The destructor.
- */
- virtual ~Fl_PSfile_Device();
-
- /**
- @brief Begins the session where all graphics will go to a local
PostScript file.
- *
- Opens a file dialog to select an output PostScript file.
- @param pagecount The total number of pages to be created.
- @param format Desired page format.
- @param layout Desired page layout.
- @return 0 iff OK
- */
- int start_job(int pagecount, enum Page_Format format = A4, enum
Page_Layout layout = PORTRAIT);
-
- /**
- @brief Begins the session where all graphics will go to named PostScript
file.
- *
- @param fname The name of the output local PostScript file.
- @param pagecount The total number of pages to be created.
- @param format Desired page format.
- @param layout Desired page layout.
- @return 0 iff OK
- */
- int start_job(const char *fname, int pagecount, enum Page_Format format =
A4, enum Page_Layout layout = PORTRAIT);
-
- };
-
-#ifndef FL_DOXYGEN
-
-#ifdef __APPLE__
-typedef Fl_Quartz_Printer Fl_Printer;
-#elif defined(WIN32)
-typedef Fl_GDI_Printer Fl_Printer;
-#else
-class Fl_PS_Printer : public Fl_PSfile_Device {
-public:
- Fl_PS_Printer(void) {};
- ~Fl_PS_Printer(void) {};
+ Fl_Printer(void) {};
+ ~Fl_Printer(void) {};
int start_job(int pages, int *firstpage = NULL, int *lastpage = NULL);
};
-typedef Fl_PS_Printer Fl_Printer;
+#endif
-#endif // __APPLE__
-
-#endif // FL_DOXYGEN
-
#endif // Fl_Printer_H
//
Modified: branches/branch-1.3/src/Fl_GDI_Printer.cxx
===================================================================
--- branches/branch-1.3/src/Fl_GDI_Printer.cxx 2010-03-19 21:40:12 UTC (rev
7305)
+++ branches/branch-1.3/src/Fl_GDI_Printer.cxx 2010-03-20 08:31:19 UTC (rev
7306)
@@ -34,7 +34,7 @@
extern HWND fl_window;
-Fl_GDI_Printer::Fl_GDI_Printer(void) : Fl_Abstract_Printer() {
+Fl_Printer::Fl_Printer(void) : Fl_Abstract_Printer() {
hPr = NULL;
type_ = gdi_printer;
}
@@ -56,7 +56,7 @@
}
-int Fl_GDI_Printer::start_job (int pagecount, int *frompage, int *topage)
+int Fl_Printer::start_job (int pagecount, int *frompage, int *topage)
// returns 0 iff OK
{
DWORD commdlgerr;
@@ -109,7 +109,7 @@
return err;
}
-void Fl_GDI_Printer::end_job (void)
+void Fl_Printer::end_job (void)
{
Fl_Device::display_device()->set_current();
if (hPr != NULL) {
@@ -129,7 +129,7 @@
}
}
-void Fl_GDI_Printer::absolute_printable_rect(int *x, int *y, int *w, int *h)
+void Fl_Printer::absolute_printable_rect(int *x, int *y, int *w, int *h)
{
POINT physPageSize;
POINT pixelsPerInch;
@@ -155,7 +155,7 @@
origin(x_offset, y_offset);
}
-void Fl_GDI_Printer::margins(int *left, int *top, int *right, int *bottom)
+void Fl_Printer::margins(int *left, int *top, int *right, int *bottom)
{
int x, y, w, h;
absolute_printable_rect(&x, &y, &w, &h);
@@ -165,14 +165,14 @@
if (bottom) *bottom = y;
}
-int Fl_GDI_Printer::printable_rect(int *w, int *h)
+int Fl_Printer::printable_rect(int *w, int *h)
{
int x, y;
absolute_printable_rect(&x, &y, w, h);
return 0;
}
-int Fl_GDI_Printer::start_page (void)
+int Fl_Printer::start_page (void)
{
int rsult, w, h;
@@ -193,14 +193,14 @@
return rsult;
}
-void Fl_GDI_Printer::origin (int deltax, int deltay)
+void Fl_Printer::origin (int deltax, int deltay)
{
SetWindowOrgEx(fl_gc, - left_margin - deltax, - top_margin - deltay, NULL);
x_offset = deltax;
y_offset = deltay;
}
-void Fl_GDI_Printer::scale (float scalex, float scaley)
+void Fl_Printer::scale (float scalex, float scaley)
{
int w, h;
SetWindowExtEx(fl_gc, (int)(720 / scalex + 0.5), (int)(720 / scaley + 0.5),
NULL);
@@ -208,7 +208,7 @@
origin(0, 0);
}
-void Fl_GDI_Printer::rotate (float rot_angle)
+void Fl_Printer::rotate (float rot_angle)
{
XFORM mat;
float angle;
@@ -221,7 +221,7 @@
SetWorldTransform(fl_gc, &mat);
}
-int Fl_GDI_Printer::end_page (void)
+int Fl_Printer::end_page (void)
{
int rsult;
@@ -254,7 +254,7 @@
ModifyWorldTransform(fl_gc, &tr, MWT_LEFTMULTIPLY);
}
-void Fl_GDI_Printer::translate (int x, int y)
+void Fl_Printer::translate (int x, int y)
{
do_translate(x, y);
if (translate_stack_depth < translate_stack_max) {
@@ -264,7 +264,7 @@
}
}
-void Fl_GDI_Printer::untranslate (void)
+void Fl_Printer::untranslate (void)
{
if (translate_stack_depth > 0) {
translate_stack_depth--;
Modified: branches/branch-1.3/src/Fl_PS_Printer.cxx
===================================================================
--- branches/branch-1.3/src/Fl_PS_Printer.cxx 2010-03-19 21:40:12 UTC (rev
7305)
+++ branches/branch-1.3/src/Fl_PS_Printer.cxx 2010-03-20 08:31:19 UTC (rev
7306)
@@ -25,7 +25,7 @@
// http://www.fltk.org/str.php
//
-#include <FL/Fl_Device.H>
+#include <FL/Fl_PSfile_Device.H>
#include <FL/Fl.H>
#include <FL/fl_ask.H>
@@ -1248,7 +1248,7 @@
}
#if ! (defined(__APPLE__) || defined(WIN32) )
-int Fl_PS_Printer::start_job(int pages, int *firstpage, int *lastpage) {
+int Fl_Printer::start_job(int pages, int *firstpage, int *lastpage) {
enum Page_Format format;
enum Page_Layout layout;
Modified: branches/branch-1.3/src/Fl_Quartz_Printer.mm
===================================================================
--- branches/branch-1.3/src/Fl_Quartz_Printer.mm 2010-03-19 21:40:12 UTC
(rev 7305)
+++ branches/branch-1.3/src/Fl_Quartz_Printer.mm 2010-03-20 08:31:19 UTC
(rev 7306)
@@ -37,14 +37,14 @@
extern void fl_quartz_restore_line_style_();
-Fl_Quartz_Printer::Fl_Quartz_Printer(void)
+Fl_Printer::Fl_Printer(void)
{
x_offset = 0;
y_offset = 0;
type_ = quartz_printer;
}
-int Fl_Quartz_Printer::start_job (int pagecount, int *frompage, int *topage)
+int Fl_Printer::start_job (int pagecount, int *frompage, int *topage)
//printing using a Quartz graphics context
//returns 0 iff OK
{
@@ -128,7 +128,7 @@
return 0;
}
-void Fl_Quartz_Printer::margins(int *left, int *top, int *right, int *bottom)
+void Fl_Printer::margins(int *left, int *top, int *right, int *bottom)
{
PMPaper paper;
PMGetPageFormatPaper(pageFormat, &paper);
@@ -150,7 +150,7 @@
}
}
-int Fl_Quartz_Printer::printable_rect(int *w, int *h)
+int Fl_Printer::printable_rect(int *w, int *h)
//returns 0 iff OK
{
OSStatus status;
@@ -167,7 +167,7 @@
return 0;
}
-void Fl_Quartz_Printer::origin(int x, int y)
+void Fl_Printer::origin(int x, int y)
{
x_offset = x;
y_offset = y;
@@ -180,7 +180,7 @@
CGContextSaveGState(fl_gc);
}
-void Fl_Quartz_Printer::scale (float s_x, float s_y)
+void Fl_Printer::scale (float s_x, float s_y)
{
scale_x = s_x;
scale_y = s_y;
@@ -193,7 +193,7 @@
CGContextSaveGState(fl_gc);
}
-void Fl_Quartz_Printer::rotate (float rot_angle)
+void Fl_Printer::rotate (float rot_angle)
{
angle = - rot_angle * M_PI / 180.;
CGContextRestoreGState(fl_gc);
@@ -205,20 +205,20 @@
CGContextSaveGState(fl_gc);
}
-void Fl_Quartz_Printer::translate(int x, int y)
+void Fl_Printer::translate(int x, int y)
{
CGContextSaveGState(fl_gc);
CGContextTranslateCTM(fl_gc, x, y );
CGContextSaveGState(fl_gc);
}
-void Fl_Quartz_Printer::untranslate(void)
+void Fl_Printer::untranslate(void)
{
CGContextRestoreGState(fl_gc);
CGContextRestoreGState(fl_gc);
}
-int Fl_Quartz_Printer::start_page (void)
+int Fl_Printer::start_page (void)
{
OSStatus status = PMSessionBeginPageNoDialog(printSession, pageFormat, NULL);
#if MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_4
@@ -267,7 +267,7 @@
return status != noErr;
}
-int Fl_Quartz_Printer::end_page (void)
+int Fl_Printer::end_page (void)
{
CGContextFlush(fl_gc);
CGContextRestoreGState(fl_gc);
@@ -278,7 +278,7 @@
return status != noErr;
}
-void Fl_Quartz_Printer::end_job (void)
+void Fl_Printer::end_job (void)
{
OSStatus status;
Modified: branches/branch-1.3/src/ps_image.cxx
===================================================================
--- branches/branch-1.3/src/ps_image.cxx 2010-03-19 21:40:12 UTC (rev
7305)
+++ branches/branch-1.3/src/ps_image.cxx 2010-03-20 08:31:19 UTC (rev
7306)
@@ -29,13 +29,11 @@
#include <math.h>
#include <string.h>
-#include <FL/Fl_Printer.H>
+#include <FL/Fl_PSfile_Device.H>
#include <FL/Fl.H>
#include <FL/Fl_Pixmap.H>
#include <FL/Fl_Bitmap.H>
-
-
int Fl_PSfile_Device::alpha_mask(const uchar * data, int w, int h, int D, int
LD){
mask = 0;
_______________________________________________
fltk-commit mailing list
[email protected]
http://lists.easysw.com/mailman/listinfo/fltk-commit
