************************************************************************** * Turboprint for Linux - a printer driver system for Linux * (c) ZEDOnet GmbH 2000-2004 all rights reserved * * ZEDOnet * Meinrad-Spieß-Platz 2 * D-87660 Irsee * 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 & color settings* printing printing *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: - 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".