Rastertoezpl - This is prerelease version
=========================================
version 0.5, 2009-11-23


Specification
=============

Prerequisite
~~~~~~~~~~~~
CUPS (http://cups.org)

Rastertoezpl - filter for CUPS
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
This package contain filter (rastertoezpl) and PostScript Printer Description
files (PPD) for Godex thermotransfer label printers for CUPS.

This filter allow set this items on the printer:
  - Media Size
  - Type of media: (see text under list)
    - plain paper
    - labels with gap
    - black mark on back
  - Darkness
  - After Print
    - Rewind
    - Stripper
    - Applicator (for printer with an applicator)
    - Cut page (for printer with a cutter)
    - Cut set (for printer with a cutter)
  - Mirror
  - Negative
  - Rotate 180deg 
  - Print mode
    - Thermal Transfer
    - Direct Thermal
  - Print speed
  - Resolution
  - Stop Position setting
  - Top margin
  - Left margin

Type of media: When item "Black Mark Length" is set to "No Black Mark", then
type of media is set by item "Label Gap Length" and item "Black Mark Position"
is ignored. If item "Black Mark Length" is set to some length, then type of
media is set to black mark. Item "Black Mark Position" set distance between
start of label and start of a black mark, and "Label Gap Length" is ignored.

Rastertoezpl source code is based on source code of CUPS filter.

It is necessary to install CUPS system for process of filter. It is necessary
to have available additional CUPS DDK including header files and basic
utilities for compilation, build and install (C compiler, make, install, ...)
this package. The CUPS Driver Development Kit (DDK) is bundled with CUPS 1.4
and higher. For CUPS 1.2.x and 1.3.x, download and install the DDK separately.

If you install CUPS from any package system, CUPS is probably distributed in
more packages. There are some packages necessary to build filter that are not
installed automatically. They are development files for CUPS and libraries for
raster printers "libcupsimage".


Configuration - customize PPD files
===================================
Link to rastertoezpl filter and all values of items for setting are in PPD
files.

PPD files for Godex printers are generated from source file ppds/godex.drv.
Initial values for most items are available in configuration of printer in
CUPS. Some items have range of values restricted by choice from list. Those
items are: size of label, stop position, top margin, left margin and position
and length of black mark.

If you need any value of item that is not in choice available, you have to
change the list of choice. You can change this list directly in installed file
for the appropriate printer in /etc/cups/ppd (only for expert; file is without
notes, the syntax is exact, some values of item are on more places and is it
necessary to respond!) or in the source file ppds/godex.drv.

In source file we find the list of values that we want to change. If range of
value of item is limited by printer, this limit is in a note above value of
item. If we want to add a value to list, we find similar value and copy it and
edit the title (first parameter after "Choice") and a value (second
parameter).

All label sizes usable in PPD files are defined on one place with formula
"#media ...". This defined name of label size that is used with formula
"MediaSize ...", every name of label size is used only once, although is
used in more printers.

If you want to add a label size, first you have to defined name of label size
(#media), and then you have to use this name (MediaSize).

After you make above described changes, clean and build PPD files:
 $ make clean-ppd
 $ make build-ppd
, and reinstall PPD files only:
 # make install-data-local

After installation, the changed files will be available for CUPS. It is
necessary to reinstall PPD (Modify printer) in installed printer for use the
changed PPD file.


Installation
============

Description of directories structure in package
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
src/ -- sources for filter
ppds/ -- sources for PPD
ppds/ppd/ -- PPD files for Godex printers

Building
~~~~~~~~
Compilation and installation of filter and PPD are typical. After extracting
archive execute:
 $ ./configure
 $ make
 # make install

PPD files are distributed in the final format. For rebuilding see section
Configuration.

Installation directories
~~~~~~~~~~~~~~~~~~~~~~~~
Installation directories are generated by script "./configure". Default they
are:
 /usr/lib/cups/filter/ -- (from cups-config) for symbolic link to filter
 /usr/local/libexec/rastertoezpl/ -- for filter rastertoezpl
 /usr/local/doc/rastertoezpl/ -- for documentation
 /usr/local/share/ppd/godex -- for PPD files

You can set another prefix (default is /usr/local/) with command:
 $ ./configure --prefix=/you/location/

You can set another install directory for PPD files with command:
 $ ./configure PPDDIR=/you/PPD/location/


Add a Godex printer to CUPS
===========================
After filter and PPD files are compiled and installed, you can add a new
printer to CUPS. The default administration of CUPS is on
http://localhost:631.

Some systems use for administration CUPS not only http://localhost:631, but
another software as well. You can use it too, of course.

