]> git.saurik.com Git - wxWidgets.git/blob - docs/doxygen/overviews/unixprinting.h
first round, connecting overviews properly to main page
[wxWidgets.git] / 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 overview_unixprinting 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