**************************************************************************
* Turboprint for Linux - a printer driver system for Linux
* (c) ZEDOnet GmbH 2000-2017 all rights reserved
*
* ZEDOnet
* Sedanstrae 8
* D-87600 Kaufbeuren
* Germany
* WEB: http://www.turboprint.de
* EMAIL: mail turboprint.de
**************************************************************************

tpconfig - a printer configuration tool for turboprint
======================================================

The menu structure of tpconfig:

                      main menu
                          |
                   printer settings
                          |
   ------------------------------------------------------------------------
   |          |         |          |        |          |        |         |
toolbox  brightness ghostscript  image    ascii     printer   custom    color
          & color    settings*  printing printing  specific  pagesizes profiles

*Note: Some settings depend on the printer spooler that is installed
on your computer. E.g. the ghostscript settings menu is not
available if you are using CUPS as printer spooler.

The main menu
=============

The main menu shows a list of the printers that were set up
by tpsetup.

The term "printer" in this document is actually a
"printer configuration" (or in LINUX terms a "printer queue"):
several printer configurations for the same physical printer can exist
(e.g. one for draft and one for photo quality printing).

If no printers have been set up yet, the list is empty.
New printers can be added using the "tpsetup" tool.

For each printer, the following entries are displayed:

Nr.     - a reference number for the printer
          An asterisk (*) is shown after the number if turboconf
          is in user mode and the default settings for this
          printer have been changed by the user.
Def.    - "lp" is shown here, if the printer is the default printer
Short   - a short name for the printer
Configuration - a long name for the printer
Device  - the device that the printer is attached to
          (or the name of a remote printer)
Paper   - the paper that is currently used
Quality - the selected print quality
Mode    - the color mode (b&w / grayscale / color)

Below the printer list there is a list of the available
options that can be selected by entering the listed
character or number:

<number> - change settings for a printer
----------------------------------------
Calls the printer settings menu for a printer. The printer
numbers are shown at the beginning of each line in the printer
list.

S - Save changes & exit
-----------------------
Use this to save all changes and quit tpconfig.

Q - Quit without saving
-----------------------
All changes that were made since tpconfig has been started
are discarded.


The Printer Settings Menu
=========================

The printer settings menu shows the current settings.

C - Cartridge
-------------
(only for printers that have exchangeable cartridges)
The cartridge currently insterted in the printer, e.g.
Black, Color or Photo.

M - Medium
----------
The kind of paper used, e.g. plain paper, coated inkjet paper,
glossy photo paper, transpareny, etc. Depending on the printer,
different choices are available.

Y - Quality
-----------
The print quality. Depending on the printer,
different choices are available.

P - Pagesize
------------
The paper size, e.g. Letter, A4, etc.

L - Landscape (only with CUPS printing system)
-------------
Select the page orientation for application programs:

0: Portrait mode (default)
1: Landscape

If CUPS is not installed, please select the page orientation
in the application program.

O - Colormode
-------------
The color depth in that the page is rendered:
Black & White  - 1bit black&white (grayscales are generated
                                   by ghostscript;
                                   default for b/w printers)
Grayscale      - 256 levels of gray
Truecolor      - 24bit color (default for color printers)
256 Colors     - 8bit color

X - Copies
----------
The number of copies that should be printed (1..99).
Copies are currently supported only for laser printers!

F - Feed
--------
The input feed (e.g. manual or automatic).

R - Tray
--------
The output tray (for printers that support different
output trays).

N - N-Up printing (only with CUPS printing system)
-----------------
With N-Up printing it is possible to print several scaled down
pages onto one sheet of paper.

1: one page per sheet (default)
2: print two pages on one sheet; printout is rotated by 90 degrees
4: print four pages on one sheet

U - Duplex
----------
For printers with a duplex option.

Off - no duplex printing
On (portrait) - duplex with long edge binding
On (landscape) - duplex with short edge binding

For HP Deskjet printers, an adjustment for the reverse side is
requested:

Original printout position - a part of the printout may be cut off at the top
Shift printout position (nothing cut off) - printout is shifted down a bit

Z - Mirror
----------
Print mirror image. Default for backprint and t-shirt transfer papers.

T - Toolbox
-----------
Enters the "Toolbox" submenu.

B - Brightness&Color
--------------------
Enters the "Brighntess & Color Settings" submenu.

G - Ghostscript
---------------
Enters the "Ghostscript Settings" submenu.

I - Image printing
------------------
Enters the "Image Printing" submenu.

A - ASCII printing
------------------
Enters the "ASCII Printing" submenu.


The Toolbox Menu
================
The toolbox is used to carry out printer maintenance tasks like
nozzle check, head cleaning, head alignment, ink quantity,
etc.

The following options are available:

T - Testpage
------------
Print a testpage. This is useful to check if the printer is
working and properly connected to the computer.

A - Alignment
-------------
Align the black & color print heads and/or align bidirectional
printing. The alignment procedure depends on the printer
manufacturer and model. Usually a page with several lines of
test patterns (lines, crosshairs) is printed.
For each line, the number of the pattern with the best alignment
must be entered (e.g.the pattern where two lines align best).

Please follow the directions given by tpconfig.

N - Nozzle check
----------------
Print a nozzle check pattern. This requires one page
of paper. For each color a "staircase pattern" is printed.
If one or several steps of the "staircase" is missing or
smeared, the heads should be cleaned.

C - Clean print heads
---------------------
Clean the print heads. This consumes some ink (like printing
one or several pages), so cleaning should only be done if
necessary.

I - Get ink quanitity
---------------------
Show the remaining quantity of ink in the cartridges.
The amount is displayed separately for all ink colors.
100% means that the cartridge is full.

Limitations of the current version:

* The "ink quantity" function requires direct port access -
  you must be logged in as "root".
* Ink quantity doesn't work with printers connected to USB port.
* HP printers don't support ink status. (?)

K - Change ink cartridge
------------------------
This is available only for some printers that require a
control program for cartridge exchange (Epson Stylus Color 480,580,
C20,40).

Please follow the directions given by tpconfig.

The Brightness & Color Settings Menu
====================================
The brightness & color settings menu contains adjustments
for the reproduction of brightness & color.

D - Dithering
-------------
The dithering method:
Error Diffusion - high quality, like floyd-steinberg
Ordered         - high speed

U - User settings active
------------------------
This is for switching on (1) or off (0) all subsequent
adjustments.

G - Screen Gamma
----------------
Attention: Use only if you want to adjust the brightness of
printouts to the currently used monitor and / or scanner!

Here you can set the gamma value of your monitor. The default
value is 180 (gamma=1.8) which is also the default for most
scanners.
 higher gamma value -> darker printouts
 lower gamma value  -> brighter printouts

B - Brightness
--------------
Change the brightness of printouts (range -50..50, default 0).
  higher brightness -> brighter printouts
  lower brightness  -> darker printouts

O - Contrast
------------
Change the contrast of printouts (range -50..50, default 0).
  higher contrast -> dark colors get darker, bright colors get brighter
  lower contrast  -> the other way round

I - Ink Volume
--------------
Change the amount of ink applied (range -50..50, default 0).
  higher ink volume -> use more ink
  lower ink volume  -> use less ink
Attention: If too much ink is applied, ink won't dry properly and
may smear.

S - Color Saturation
--------------------
Change the color saturation (range -50..50, default 0).
  higher color saturation -> more vibrant colors
  lower color saturation  -> less vibrant colors

Y - Yellow
----------
The amount of yellow ink applied (range -50..50, default 0).
  higher value -> use more yellow
  lower value  -> use less yellow

M - Magenta
-----------
The amount of magenta ink applied (range -50..50, default 0).
  higher value -> use more magenta
  lower value  -> use less magenta

C - Cyan
--------
The amount of cyan ink applied (range -50..50, default 0).
  higher value -> use more cyan
  lower value  -> use less cyan

K - Black
---------
The amount of black ink applied (range -50..50, default 0).
  higher value -> use more black
  lower value  -> use less black


The Ghostscript Settings Menu
=============================
This menu is not available if you are using the CUPS printing
system.

The ghostscript settings affect all print jobs that are not
bitmap images (see "Image Printing Menu" for bitmap images).

Zoom and offsets are relative to the bottom left corner -
the origin of the postscript coordinate system:

Z - Zoom
--------
Zoom size of printout. 100% = original size.
  .........
 /|\      .
  |       .
  |   printout is zoomed to the right & top
  |       .
  |       .
  o-------> bottom left corner is fixed

X - X offset
------------
Change position of printout, unit = 1/1000 inches.
Positive values: move printout to the right.
Negative values: move printout to the left.

       +

      /|\
       |
 - <---o---> +
       |
      \|/

       -

Y - Y offset
------------
Change position of printout, unit = 1/1000 inches.
Positive values: move printout to the top.
Negative values: move printout to the bottom.

D - Dot Size
------------
Specify the "screen size" measured in lines per inch,
which determines the size of the dots for halftones.
A value of zero means use ghostscript defaults.

 This is relevant only for black&white printouts, where
 grayscales are generated by ghostscript and not the
 Turboprint driver.

B - Buffer
----------
This determines the maximum amount of memory that ghostscript
uses for image rendering. More memory usually means quicker
printing. However, if more than the physical available memory
is used, performance will be drastically reduced.
A value of zero means use ghostscript defaults (1MB in
version 5.x).


The Image Printing Menu
=======================
The settings in this menu determine the print size and position
of bitmap images.

If the CUPS printing system is installed, the CUPS specific
settings for image printing will be available (see below).

Image Menu with LPR / LPRng spooler
===================================

B - Ignoremargins
-----------------

   1------------ page edge
   |             <- unprintable area
   |   0........ border of printable area
   |   .
   |   .


0 (default) : The position is measured from the top left
              edge of the printable area
1           : The image position is measured from the top left
              page edge

L - Left
--------
Print position from the left, measured in 1/1000 inches.

T - Top
-------
Print position from the top, measured in 1/1000 inches.

W - Width
---------
Print with in 1/1000 inches.

H - Height
----------
Print height in 1/1000 inches. If height is set to zero,
it will be calculated from the image proportions.

X - Center X
------------
0 : use left print position
1 : center image on page in x direction.

Y - Center Y
------------
0 : use top print position
1 : center image on page in y direction.


A - Aspect
----------
1 (default) : respect the original image aspect by reducing
              either with or height if necessary.
0           : ignore image aspect, printout size will be exactly
              as specified

Image Menu with CUPS
====================

By default the print size of an image is determined from
the "dots per inch" information that is stored in the image file:

width (in inches) = image width in pixels  / horizontal dots per inch
height (  -"-  )  = image height in pixels / vertical dots per inch

Note: Some file formats don't contain DPI information, e.g. PBM / PPM.

It is possible to specify a different printsize with either the
"Scaling" or the "Image DPI" setting.

The image can be rotated by setting "Landscape=1" in the main menu.

S - Scaling
-----------
Specify the print size in percent of the printable area of the page.
If "Scaling" is enabled, the image may be rotated to be printed
as large as possible.

E - Enable Scaling
------------------
0: Disable image scaling, the DPI values are used instead (default)
1: Enable image scaling

D - Image DPI
-------------
Specify a "dots per inch" value that should be used instead of the
information stored in the image file.

U - Use Image DPI
-----------------
0: Don't use image dpi, the DPI values of the image are used
   instead (default)
1: Use the specified image dpi

X - X Position
--------------
Specify the horizontal print position of the image:

0: Left
1: Center
2: Right

Y - Y Position
--------------
Specify the vertical print position of the image:

0: Top
1: Center
2: Bottom


The ASCII printing Menu
=======================
These are settings for the layout of simple ASCII text documents.
a2ps is used for formating ASCII text. If a2ps is not installed,
enscript will be used instead.

If the CUPS printing system is installed, the CUPS specific
settings for text printing will be available (see below).

ASCII Menu with LPR / LPRng spooler
===================================

D - Defaults
------------
0 : Use the settings below.
1 : Use the defaults of a2ps (or enscript), the settings
    landscape and columns are ignored.

L - Landscape
-------------
0 : portrait = normal orientation
1 : landscape = printout rotated by 90 degrees

N - Columns
-----------
Specify the number of text columns on the page.

B - Borders
-----------
0 : Don't print borders around columns.
1 : Print borders around columns

H - Headers
-----------
0 : Don't print page headers
1 : Print page headers (file name, login name, page numbers)

ASCII Menu with CUPS
====================

C - Characters per inch
-----------------------
Specify the font width in characters per inch (default = 10 CPI).

L - Lines per inch
------------------
Specify the font height in lines per inch (default = 6 LPI).

N - Numbers of columns
----------------------
Specify the number of text columns on the page (default = 1).

P - Prettyprint mode
--------------------
0 : print just the text
1 : add page headers (file name, page number) and highlight key words
   such as "and", "or".

Printer Specific Settings
=========================

Menu for changing printer specific settings, e.g. unidirectional
or bidirectional print mode for Epson printers.


Custom Pagesizes
================

Menu for adding/editing custom pagesizes for a printer.

A - Add a new page size
-----------------------
Adds a new page size that can be renamed and edited later.

W - Write
---------
Write back list of page sizes for a printer.

Q - Quit page size menu
-----------------------
Changes are discarded if the list of page sizes has not been written using "W".

<Number> - Edit a page size
---------------------------
The following options are available in the "edit" menu:

D - Remove size
---------------
Delete a custom page size of a printer

E - Choose page size type 
-------------------------
Choose page size type (regular, borderless, CD).

W / H - Specify page width / height
-----------------------------------
Enter paper dimensions.

L / R / T / B - Specify page borders
------------------------------------
Only available for regular page sizes.

U / V - Specify x/y offset
--------------------------
Adjust print position on the page.

X / Y - Specify x/y scaling factor
----------------------------------
Enlarge / reduce the print size - currently only the X factor is used
as zoom factor for both X and Y.

I / O - Specify inner / outer radius for CDs
--------------------------------------------
Adjust size of center hole and CD size.

N - Rename page size
--------------------
Change name of a custom page format.

Color Profiles
==============

Color profile administration menu.

A - Add color space from ICC profile
------------------------------------
Import an ICC profile to be used as document color space (for all printers).
Either the icc file must be present in the current directory or the
complete path + file name must be entered.

N - Create a new profile entry
------------------------------
Create a color profile entry for the currently selected printer which
can be used to print a color measurement chart and import an ICC or ZEDOnet
color profile later.

As a result a new "media type" is added for this printer 
(same name as profile).

The following options are available in the "Create new profile" menu:

C - Cartridge
-------------
The cartridge or print mode that should be used for this profile.

M - Media class
---------------
The type of paper, e.g. plain paper, inkjet paper, glossy paper.

Y - Print quality
-----------------
The print quality for this profile.

L - Ink limit
-------------
The maximum amount of ink for this profile - can be determined using
the "F" command (see below).

F - Print ink limit test page
-----------------------------
Prints color patches with different amounts of ink. Choose the patch 
with the highest number where colors don't bleed and don't remain wet. 
Enter the number using the "L" command.

N / K / I / J / P / Q - Information on this profile
---------------------------------------------------
Text only, will not affect printing.

G - Create profile entry
------------------------
The "G" command must be executed before leaving the "Create new profile" menu.
Otherwise all changes will be lost.


<Number> - Edit profile or import profile data
----------------------------------------------

The following commands are available in the "Edit profile" menu:

N - Rename profile
------------------
Change name of profile.

R - Remove profile
------------------
Delete profile.

P - Print color chart for ZEDOnet profile
-----------------------------------------
Print a color chart page to be mailed to ZEDOnet's profile creation service.

I - Import profile
------------------
Import profile data from ZEDOnet or import an ICC profile.
(ICC profile must have been created specifically for TurboPrint using
a spectrometer or calibrated scanner and profile creation software.)
Either the file must be present in the current directory or a
complete path + file name must be entered.


