Codebase list splix / 0051000e-0a7e-4ec5-b171-d2e010da7f32/main INSTALL
0051000e-0a7e-4ec5-b171-d2e010da7f32/main

Tree @0051000e-0a7e-4ec5-b171-d2e010da7f32/main (Download .tar.gz)

INSTALL @0051000e-0a7e-4ec5-b171-d2e010da7f32/mainraw · history · blame

HOW-TO INSTALL AND USE THIS DRIVER:
===================================



Introduction:
------------

	This driver is usable by all printer devices which understand the QPDL
(Quick Page Description Language) language. It covers several _Samsung_, 
_Xerox_, _Dell_ and _Ricoh_ printers like the ML-2250 which uses it as a native 
printer language (Check the technical documentation for more information).



Requested:
----------

	To use this driver you need.... a QPDL printer! Last but not least you
need CUPS. It has been tested with CUPS V. 1.1.23, 1.3.0  and works fine of 
course..

	If you're using a distribution with a real package manager you need to
install the cups developement package (libcups...-devel or something like that).
To finish the libjbig is needed if the JBIG algorithm compilation isn't 
disabled.

Summary:
	* CUPS
	* libcups
	* libjbig (If the JBIG algorithm compilation isn't disabled)



Installation:
-------------

  +=======================================================================+
  |                  !!!      IMPORTANT NOTICE      !!!                   |
  +=======================================================================+
  |      If you are upgrading your current version, you MUST delete       |
  |     your printer in the CUPS interface and install it again. This     |
  |   operation MUST be done since CUPS make a copy of the PPD file and   |
  |                this file is modified between versions.                |
  +=======================================================================+

	Perform the compilation by doing (It is possible to customize some 
compilation options. Please check at the end of this file):

		$ make

	If no errors appear you can install the filter and the drivers in the
super user environment:

		$ su
		Password: (Enter the root password and try again if it fails :)
		# make install

	To finish you have to visit http://localhost:631 with your favourite
browser and add a new printer by selecting the correct printer in the list.

	and HAVE FUN ;-)



Installation of the color profile for color printers:
-----------------------------------------------------

	Color printers needs color profile files to get better results. These
files are provided by your printer manufacturer and you have to install them
manually. To do that, download the linux official drivers and locate the "cms"
directory. Install them with the command:

		# make installcms CMSDIR=/path/to/cms/directory \
			MANUFACTURER=samsung or xerox or dell

	Samsung color profile files are available at:
		(Then use MANUFACTURER=samsung)

		http://splix.ap2c.org/samsung_cms.tar.bz2



Compilation options:
--------------------

	SpliX code can be tuned by using specific make options. All these
options are:

		* DISABLE_JBIG=1 [0 by default]:
			Since some of the JBIG algorithm may patented, this
			option disable the use of this algorithm. Unfortunatly
			_JBIG printers_ (such as CLP-600) won't work with SpliX.
		* DISABLE_THREADS=1 [0 by default]:
			This option will disable the use of threads in the SpliX
			code. If it is disabled, _manual duplex_ will no longer 
			work.
		* DISABLE_BLACKOPTIM=1 [0 by default]:
			A black correction algorithm is used to optimize the use
			of black and color toner on color printers. This option
			will disable the use of this algorithm. Colors of a 
			printed page will be different, more toner may be used
			and black may not be dark.
		* THREADS=XX [2 by default]:
			Specify the number of _compression_ threads to use. Note
			that compression is a full CPU time job. Specify more
			than physical CPU core avaiable may be stupid.
			For instance quad core owners should use THREADS=4.
		* CACHESIZE=XX [30 by default]:
			Specify the number of _compressed_ kept into memory
			waiting for the rendering. This option is important with
			the use of manual duplex. Note that a standard
			compressed A4 paper is about 300ko. So 30 pages into
			memory will use an average of 9Mo of RAM. Other pages
			are swapped into the disk. A little CACHESIZE value will
			increase disk access and increase the job rendering time.
		* DRV_ONLY=1 [0 by default]:
			Don't install PPD files at all, only DRV
			(driver information file) files.

	Example:

		$ make DISABLE_JBIG=1 THREADS=4 CACHESIZE=100

	This will disable the use of the JBIG algorithm. Threads and black
optimization algorithm will be compiled. Then, manual duplex will be available.
The number of compression threads will be 4 and the maximum number of compressed
pages which will be kept into the memory will be 100 (with a maximum average of
memory of 30Mo)


	=== PLEASE GIVE THESE OPTIONS TO MAKE AND MAKE INSTALL RULES ===