docs/doxygen/overviews/unixprinting.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        unixprinting
   3 // Purpose:     topic overview
   4 // Author:      wxWidgets team
   5 // RCS-ID:      $Id$
   6 // Licence:     wxWindows license
   7 /////////////////////////////////////////////////////////////////////////////
   8
   9 /*!
  10
  11  @page unixprinting_overview Printing under Unix (GTK+)
  12
  13  Printing under Unix has always been a cause of problems as Unix
  14  does not provide a standard way to display text and graphics
  15  on screen and print it to a printer using the same application
  16  programming interface - instead, displaying on screen is done
  17  via the X11 library while printing has to be done with using
  18  PostScript commands. This was particularly difficult to handle
  19  for the case of fonts with the result that only a selected
  20  number of application could offer WYSIWYG under Unix. Equally,
  21  wxWidgets offered its own printing implementation using PostScript
  22  which never really matched the screen display.
  23  Starting with version 2.8.X, the GNOME project provides printing
  24  support through the libgnomeprint and libgnomeprintui libraries
  25  by which especially the font problem is mostly solved. Beginning
  26  with version 2.5.4, the GTK+ port of wxWidgets can make use of
  27  these libraries if wxWidgets is configured accordingly and if the
  28  libraries are present. You need to configure wxWidgets with the
  29  @e configure --with-gnomeprint switch and your application will
  30  then search for the GNOME print libraries at runtime. If they
  31  are found, printing will be done through these, otherwise the
  32  application will fall back to the old PostScript printing code.
  33  Note that the application will not require the GNOME print libraries
  34  to be installed in order to run (there will be no dependency on
  35  these libraries).
  36  In version GTK+ 2.10, support for printing has been added to GTK+
  37  itself. Beginning with version wxWidgets 2.9.X, the GTK+ port of
  38  wxWidgets can make use of this feature
  39  if wxWidgets is configured accordingly and if the GTK+ version is = 2.10.
  40  You need to configure wxWidgets with the @e configure --with-gtkprint
  41  switch and your application will then search for the GTK+ print support
  42  at runtime. If it is found, printing will be done through GTK+, otherwise the
  43  application will fall back to GNOME printing support if it is available or,
  44  if it isn't, to the old PostScript printing code.
  45  Note that the application will not require a GTK+ version = 2.10
  46  to be installed in order to run (there will be no dependency on
  47  this version).
  48
  49  */
  50
  51