If the installation script lists missing shared libraries, you need to update your linux installation. The GUI configuration programs "xtpsetup" and "xtpconfig" are based on GTK+1.2. If GTK+1.2 is not present on your system, your LINUX installation is either incomplete or very old.
You can either install GTK+ from your LINUX distribution CDs or download it from www.gtk.org.
The installation will probably list some filter programs that are not present on your LINUX installation. In most cases a few of them are absolutely necessary:
Ghostscript is absolutely necessary and is installed by default by almost every LINUX distribution. If not, please install it from your LINUX distribution CDs.
Either a2ps or enscript must be installed to print plain ASCII text. Both programs convert ASCII text to a postscript file, which is then processed by ghostscript.
TurboPrint could not find a keyfile and is installed as FreeEdition. To use TurboPrint as full version please purchase a license with a personal keyfile at www.turboprint.de.
Should you already have bought a license, please follow the instructions that came with the keyfile and reinstall.
It is no problem to use TurboPrint without X Windoes. Installation of the RPM package can be done with
rpm --install turboprint-1.xx.i386.rpm
For the .tgz archive, use the command "./setup" from the archive.
Printer installation is done with the command line tool "tpsetup", configuration with "tpconfig. A description can be found under
/usr/share/turboprint/doc/tpsetup.txt
/usr/share/turboprint/doc/tpconfig.txt
Borderless printing is enabled by choosing a "borderless" page size in xtpconfig, e.g. "A4 borderless".
Note that the borderless size is larger than the regular page size because an overprint margin is added (this is different from printer drivers under Windows which don't change the page size but scale up the output instead).
In the application program also the larger page borderless page size must be chosen (and the document may have to be adjusted) in order to produce a borderless printout.
KDE applications can query the printer's page size directly, other applications like GIMP must load the PPD file of the TurboPrint driver - details can be found in chapter Printing from applications.
On certain printers TurboPrint can print directly onto printable CDs. The setting in xtpconfig must be as follows:
Paper = "CD printable"
Page size = "CD printable" or "A4"
Feed = "CD tray" (Canon only)
You can design the CD layout using e.g. OpenOffice Draw - see also section OpenOffice.
The CD center must be positioned on the page as follows (page size in OpenOffice and print size in xtpconfig must be set to "A4"):
Canon (e.g. i865,i965,PIXMA):
2.55 inches / 6.5cm from the left page edge
5.75 inches / 16.6cm from page top
Epson (e.g. Stylus Photo R200,R300):
2.95 inches / 7.5cm from the left page edge
2.65 inches / 6.75cm from page top
Make sure that the graphics
does not exceed the edge and center hole of the CD.
Template documents for OpenOffice Draw can be found in the directory
/usr/share/turboprint/doc.
If you print from GIMP please choose in the GIMP print dialog page size = "CD printable" and size = 100%. The image will be positioned correctly and edge and center will be masked out automatically.
Please insert the CD tray into the printer before starting the print job - otherwise you will have to press the "paper feed" button on the printer. If the printer doesn't react to the "paper feed" button the print queue may be stalled - please check in TurboPrint Setup (command line: xtpsetup) if the print queue is "started" and "accepting jobs".
Check your printer configuration in xtpsetup, especially
if the printer port is chosen correctly. For parallel printers the
device name entry should be "/dev/lp0", for USB printers it should be
"usb://manufacturer/model" , e.g.
usb://canon/i865
If everything is correct, check the printer status in the KDE Control center (stopped?).
Please see the sections Monitoring print jobs and troubleshooting for details.
For printing problems with the GIMP read the section GIMP in the previous chapter.
lp: unable to print file: server-error-service-unavailable
A spool system system is required by TurboPrint. Normally the CUPS printing system is used, in some cases also the older LPR(ng) spooler. Please make sure that one of these packages is installed on your Linux system.
lp: unable to print file: client-error-not-found
The print queue does not exist - please check if the name of the print queue (e.g. "tp0") was specified correctly.
lp: command not found
In some Linux distributions, e.g. Debian, the shell commands for printing (which are also used from other applications) must be installed separately. Under Debian Linux installation can be done with
apt-get install cupsys-client
The button "Check ink level" is only acessible in xtpconfig if you are logged in as user "root" (this is required because direct access to the printer port is required). The ink level is also not available for network printers.
If the button "Check in level" can be pressed but an error message comes up (timeout - no response from printer), the reason may be that the port driver of your Linux distribution does not support bidirectional port access properly.
Please check your settings in xtpconfig (page size, paper type, quality, etc.). Also make sure that the correct printer driver has been chosen in xtpsetup.
For landscape printing you must choose "landscape" format in the page setup of you application (e.g. in OpenOffice).
The setting "landscape" in xtpconfig is only effective for printing ASCII text or pictures from command line.
Settings in xtpconfig only apply to the current user and some applications also discard user settings.
Solution: Start xtpconfig as root user to make your changes so the default settings for all users and applications will be changed.
Important for users of LPRng spooler:
If you're not logged in as root, always the default (root) settings are used. In the current version of TurboPrint, the printer driver (running as user "lp" or "daemon") must have access to your home directory. To achieve this, you'll have to enable read access to all other users:
chmod +rx /home/your_login_name
chmod +rx /home/your_login_name/.turboprint
Of course you may disable read access to all other subdirectories in your home directory.
If instead of the source code, the "final" screen or print version is printed, you should use a2ps or enscript manually:
a2ps --output=- --delegate=0 myfile.html | lpr -Ptp0
enscript --output=- myfile.html | lpr -Ptp0
"--delegate=0" means send output to stdout,
"--delegate=0" means that a2ps must not call
other applications (like netscape).
Alternatively, lpr may be called directly by a2ps / enscript:
a2ps --delegate=0 --printer=tp0 myfile.html
enscript --printer=tp0 myfile.html
You should fill in the form BUGREPORT from the installation directory and e-mail it to bug@turboprint.de.
Please include the logfiles
/var/log/turboprint.log
/var/log/turboprint_lpr.log (if CUPS is not installed)
/var/log/turboprint_cups.log (if CUPS is installed)
/var/log/cups/error_log (-"-)
For short reports that don't require any logfiles, you can also use feedback form http://www.turboprint.de/feedback.html.