From 92b02ddce00dec2787514568fa9d644d4f0350e9 Mon Sep 17 00:00:00 2001 From: Roger Leigh Date: Sun, 26 Oct 2008 16:16:44 +0000 Subject: Imported Upstream version 5.0.0 --- man/Makefile.in | 2 + man/ijsgutenprint.1.in | 225 +++++-------------------------------------------- 2 files changed, 23 insertions(+), 204 deletions(-) (limited to 'man') diff --git a/man/Makefile.in b/man/Makefile.in index f17d1db..fd110f0 100644 --- a/man/Makefile.in +++ b/man/Makefile.in @@ -93,6 +93,8 @@ BUILD_GENPPD_STATIC_FALSE = @BUILD_GENPPD_STATIC_FALSE@ BUILD_GENPPD_STATIC_TRUE = @BUILD_GENPPD_STATIC_TRUE@ BUILD_GHOSTSCRIPT_FALSE = @BUILD_GHOSTSCRIPT_FALSE@ BUILD_GHOSTSCRIPT_TRUE = @BUILD_GHOSTSCRIPT_TRUE@ +BUILD_GIMP2_AS_GUTENPRINT_FALSE = @BUILD_GIMP2_AS_GUTENPRINT_FALSE@ +BUILD_GIMP2_AS_GUTENPRINT_TRUE = @BUILD_GIMP2_AS_GUTENPRINT_TRUE@ BUILD_GIMP2_FALSE = @BUILD_GIMP2_FALSE@ BUILD_GIMP2_TRUE = @BUILD_GIMP2_TRUE@ BUILD_GIMP_FALSE = @BUILD_GIMP_FALSE@ diff --git a/man/ijsgutenprint.1.in b/man/ijsgutenprint.1.in index 0b3f73d..1f7a0f9 100644 --- a/man/ijsgutenprint.1.in +++ b/man/ijsgutenprint.1.in @@ -1,5 +1,5 @@ .\" t -.\" $Id: ijsgutenprint.1.in,v 1.2 2005/04/18 10:54:56 rleigh Exp $ +.\" $Id: ijsgutenprint.1.in,v 1.4 2006/05/24 11:25:42 rlk Exp $ .\" Copyright (C) 2000-2002 Robert Krawitz .\" Roger Leigh .\" @@ -35,19 +35,18 @@ ijsgutenprint \- Ghostscript driver for Gutenprint provides Ghostscript with a Gutenprint driver, supporting all printers supported by libgutenprint. .PP -IJS is an initiative to improve the quality and ease of use of printing with -Ghostscript. It permits adding or upgrading drivers without recompiling -Ghostscript. An IJS driver runs in a separate process that communicates with -Ghostscript via an IPC channel. The Gutenprint IJS driver may be used with -AFPL Ghostscript, as it runs in a separate process. +.B NOTE: +ijsgutenprint should never be called directly. Ghostscript will run it if the +IjsServer parameter is set to IjsServer=ijsgutenprint when invoking the IJS +driver. .PP -The options for this driver are very complex. We strongly recommend -use of a printer management system such as Foomatic rather than -configuring a spooler manually with this driver. The driver name used -by Foomatic is \fIgutenprint\-ijs\fP. +.B NOTE: +The only \fIsupported\fP method of running ijsgutenprint is via Foomatic. +Users running ghostscript directly will not be supported. The driver name used +by Foomatic is \fIgutenprint\-ijs.@GUTENPRINT_MAJOR_VERSION@.@GUTENPRINT_MINOR_VERSION@\fP. .SH OPTIONS -\fIijsgutenprint\fP accepts the following options: -.SS Ghostscript IJS options +\fIijsgutenprint\fP accepts the following Ghostscript IJS options. The +Gutenprint-specific options are not documented here. .TP .B \-dIjsUseOutputFD This option should be specified whenever output from Ghostscript will go to @@ -61,205 +60,23 @@ sub-options. \fB\-sDeviceManufacturer\fP=\fIvendor\fP \fB\-sDeviceModel\fP=\fIname\fP This option must be supplied. There is no default. The IJS driver requires the \fIvendor\fP (it's part of the protocol), but the ijsgutenprint driver -ignores it. It should be CANON, EPSON, LEXMARK, or HEWLETT\-PACKARD. The value -of the \-sDeviceModel parameter is the same as the value of the \-sModel -parameter in the old stp driver. -.IP -Most or all of the Epson Stylus printers are fully functional. The others -vary. In particular, all of the listed Epson Stylus Photo printers print in -full 6-color photo mode; most of the others do not. The color output has also -been better tuned for Epson Stylus printers than for others. -.SS Gutenprint IJS options -These options are all used in the \-sIjsParams options, except where mentioned -otherwise. Due to their complicated nature, the options are explained in -detail in their own sections. -.SH PRINT RESOLUTION -.TP -\fBQuality\fP=\fIquality\fP -The meaning of this is model-specific. Each printer has its own -default value; for most printers, this is a reasonable 300 or 360 DPI -resolution. -.SH INK TYPES -.TP -\fBInkType\fP=\fIinktype\fP -.PP -This is printer type specific. The option names are case sensitive. -.SH MEDIA TYPES -.TP -\fBMediaType\fP=\fImediatype\fP -.PP -This is printer type specific. The option names are case sensitive. -.SH MEDIA SOURCES -.TP -\fBMediaSource\fP=\fImediasource\fP -.PP -This is printer type specific. The option names are case sensitive. -.PP -.SH MEDIA SIZES -.TP -\fB\-sPAPERSIZE\fP=\fIpapersize\fP -for known Ghostscript paper sizes. -.TP -\fB\-dDEVICEWIDTHPOINTS\fP=\fIx\fP \fB\-dDEVICEHEIGHTPOINTS\fP=\fIy\fP -where \fIx\fP and \fIy\fP are the width and height of the paper respectively, -in points (1/72"). Note this is a normal gs option, \fInot\fP an IJS option. -.PP -This is printer-specific; we cannot list the correct values for each printer -here. The option names are case-sensitive. This option does not set -GhostScript up to use a paper size other than the default; it only tells the -driver to set up the printer for a different paper size. The default paper -size is "Letter". -.SH COLOR BALANCING -.TP -\fBCyan\fP=\fIval\fP -.TP -\fBMagenta\fP=\fIval\fP -.TP -\fBYellow\fP=\fIval\fP -.TP -\fBBrightness\fP=\fIval\fP -.TP -\fBContrast\fP=\fIval\fP -.TP -\fBGamma\fP=\fIval\fP -.TP -\fBDensity\fP=\fIval\fP -.TP -\fBSaturation\fP=\fIval\fP -.SH DITHERING ALGORITHMS -.TP -\fBDitherAlgorithm\fP=\fIalgorithm\fP -.SH OUTPUT TYPE -.TP -\fB\-sProcessColorModel\fP=\fIDeviceGray\fP \fB\-dBitsPerSample\fP=1 -Black and white -.TP -\fB\-sProcessColorModel\fP=\fIDeviceGray\fP -Greyscale -.TP -\fB\-sProcessColorModel\fP=\fIDeviceRGB\fP -Color (RGB) -.TP -\fB\-sProcessColorModel\fP=\fIDeviceCMYK\fP -Color (CMYK) -.PP -Note these are gs options, \fInot\fP IJS options. Choose color vs. grayscale -output. Color output is the default. Choosing \fIDeviceGrey\fP and -\-dBitsPerSample=1 results in only black ink (no color ink) being used, which is -faster and usually results in the most accurate grayscale, but at the expense -of smoothness. This prints only black and white (thresholding). This option -always uses Fast dithering unless you specify Very Fast. If you want composite -color (using a mixture of color and black inks to produce gray), use -\fIDeviceGrey\fP. -.PP -In addition, using \fIDeviceGrey\fP uses luminance (perceived brightness) of -red, green, and blue to choose output levels. Blue of a given intensity is -perceived to be much darker than red, which in turn appears darker than green. -\fIDeviceRGB\fP, \fIDeviceCYMK\fP and Saturation=0.0 (see "Saturation" above) -do not use luminance. -.PP -CMYK output may be used with the IJS driver only. It is useful if -you're printing a CMYK graphic and want explicit control over the -inks. Generally it yields inferior quality, as Gutenprint has good -algorithms for converting RGB (screen) into CMYK (inks) that take -into account paper type, ink type, and other variables. In CMYK -mode, the brightness, contrast, and saturation controls do not -function. -.SH IMAGE TYPE -This option can be used to optimize the dither. -.TP -\fBImageType\fP=\fIval\fP -Possible values are: -.IP -.TS -li li -lb lw(4i). -Value Description -_ -1 T{ -.na -Line art (color or gray scale) -T} -2 T{ -Primarily solid colors or smooth gradients (color or gray scale) -T} -3 T{ -Continuous-tone photographs (color or gray scale) -T} -.TE -.IP -Option \fI0\fP is the fastest. It generates strong, but not particularly -accurate, colors. There may be some fairly sharp color transitions in this -mode. -.IP -Option \fI1\fP generates more accurate colors, but is slower. -.IP -Option \fI2\fP generates the most accurate colors, but is considerably slower. -.PP -Note that any of the modes may be used with either color or black & white -output. If black and white output is requested, but a color mode used, -composite color will be printed. This generally offers smoother tone, but less -purity of gray or black, than pure black ink. Furthermore, it is possible to -tune the color of the gray (to achieve warmer or cooler effects) using the -color controls in this fashion. -.PP -Specifying a lower GhostScript resolution (with \-r) results in faster color -conversion. For example, if you print at 1440x720 DPI, but specify a -Ghostscript resolution of 360 DPI (with \-r360), output will be significantly -faster and there will be much less difference in performance between the three -image type options. -.SH EXAMPLES -Note that a lot of these options are used for demonstration; generally -adjusting the density is a bad idea! -.SS Example 1 -Print charts to file, using A4 paper, color, 360 dpi: -.IP -.B gs \-sDEVICE=ijs \-sIjsServer=@prefix@/bin/ijsgutenprint -.br -.B \-sDeviceManufacturer=EPSON \-sDeviceModel=escp2\-ex -.br -.B \-sPAPERSIZE=a4 \-sOutputFile=itsyourchoice.prn -.br -.B \-sIjsParams=Density=1.6,Gamma=1.5,Saturation=0.9,\(rs -.br -.B Brightness=0.4,ImageType=1 foo.ps -.SS Example 2 -Print color photograph to /dev/lp0 at maximum quality: -.IP -.B gs \-sDEVICE=ijs \-sIjsServer=@prefix@/bin/ijsgutenprint -.br -.B \-sDeviceManufacturer=EPSON \-sDeviceModel=escp2\-870 -.br -.B \-sOutputFile=/dev/lp0 -.br -.B \-sIjsParams='Quality=1440x720hq,MediaType=GlossyPhoto,\(rs -.br -.B Density=0.8,ImageType=2' foo.ps -.SS Example 3 -Print pure black text to stdout: -.IP -.B gs \-sDEVICE=ijs \-sIjsServer=@prefix@/bin/ijsgutenprint -.br -.B \-sDeviceManufacturer=EPSON \-sDeviceModel=escp2\-660 -.br -.B \-dIjsUseOutputFD \-sProcessColorModel=DeviceGray -.br -.B \-dBitsPerSample=1 \-sOutputFile=\- -.br -.B \-sIjsParams='Quality=720sw,Density=0.8' foo.ps +ignores it. .SH HISTORY -The Ghostscript stp driver was originally written by Henryk Richter +The Ghostscript \fBstp\fP driver was originally written by Henryk Richter (buggs@comlab.uni\-rostock.de), and was integrated into Gutenprint during the -3.1 development series. Gutenprint itself was originally written by Michael -Sweet , who released up to version 2.0; Robert Krawitz -released version 3.0. The Gutenprint development team -(http://gimp\-print.sourceforge.net) now maintains the entire package. +3.1 development series. Gutenprint (which was named Gimp-Print prior to +release 5.0) itself was originally written by Michael Sweet , +who released up to version 2.0; Robert Krawitz released version 3.0. The +Gutenprint development team (http://gimp\-print.sourceforge.net) now maintains +the entire package. .PP The IJS driver was originally written by Russell Lang, and incorporated into Gutenprint (known then as Gimp-Print) in early 2002. This driver corresponds with the IJS protocol 0.32. +.PP +The \fBstp\fP driver is no longer supported as of Gutenprint 5.0. .SH COPYRIGHT -Copyright \(co 2001\-2002 Robert Krawitz (rlk@alum.mit.edu) +Copyright \(co 2001\-2006 Robert Krawitz (rlk@alum.mit.edu) .PP This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software -- cgit v1.2.3