Gecko [ 122.154.134.11 ]

Name	Size	Permission
accounting.html	2.53 KB	-r--r--r--
api-array.html	32.95 KB	-r--r--r--
api-cgi.html	32.93 KB	-r--r--r--
api-cups.html	88.38 KB	-r--r--r--
api-driver.html	35.72 KB	-r--r--r--
api-filedir.html	32.22 KB	-r--r--r--
api-filter.html	46.11 KB	-r--r--r--
api-httpipp.html	160.97 KB	-r--r--r--
api-mime.html	21.68 KB	-r--r--r--
api-overview.html	11.27 KB	-r--r--r--
api-ppd.html	82.86 KB	-r--r--r--
api-ppdc.html	63.67 KB	-r--r--r--
api-raster.html	50.05 KB	-r--r--r--
cgi.html	2.46 KB	-r--r--r--
glossary.html	2.72 KB	-r--r--r--
kerberos.html	4.17 KB	-r--r--r--
license.html	48.75 KB	-r--r--r--
man-backend.html	5.71 KB	-r--r--r--
man-cancel.html	2.17 KB	-r--r--r--
man-cups-config.html	2.49 KB	-r--r--r--
man-cups-lpd.html	4.41 KB	-r--r--r--
man-cups-polld.html	1.37 KB	-r--r--r--
man-cupsaccept.html	2.51 KB	-r--r--r--
man-cupsaddsmb.html	6.65 KB	-r--r--r--
man-cupsd.html	2.58 KB	-r--r--r--
man-cupsenable.html	2.84 KB	-r--r--r--
man-cupstestdsc.html	1.72 KB	-r--r--r--
man-cupstestppd.html	3.93 KB	-r--r--r--
man-drv.html	1.31 KB	-r--r--r--
man-filter.html	7.47 KB	-r--r--r--
man-lp.html	6.96 KB	-r--r--r--
man-lpadmin.html	6.87 KB	-r--r--r--
man-lpc.html	2.4 KB	-r--r--r--
man-lpinfo.html	2.91 KB	-r--r--r--
man-lpmove.html	1.59 KB	-r--r--r--
man-lpoptions.html	3.61 KB	-r--r--r--
man-lppasswd.html	2.14 KB	-r--r--r--
man-lpq.html	1.96 KB	-r--r--r--
man-lpr.html	3.49 KB	-r--r--r--
man-lprm.html	1.9 KB	-r--r--r--
man-lpstat.html	3.86 KB	-r--r--r--
man-mime.convs.html	1.69 KB	-r--r--r--
man-mime.types.html	4.09 KB	-r--r--r--
man-notifier.html	4.29 KB	-r--r--r--
man-ppdc.html	2.59 KB	-r--r--r--
man-ppdhtml.html	1.27 KB	-r--r--r--
man-ppdi.html	1.34 KB	-r--r--r--
man-ppdmerge.html	1.32 KB	-r--r--r--
man-ppdpo.html	1.48 KB	-r--r--r--
network.html	26.99 KB	-r--r--r--
options.html	23.18 KB	-r--r--r--
overview.html	3.46 KB	-r--r--r--
policies.html	20.83 KB	-r--r--r--
postscript-driver.html	21.14 KB	-r--r--r--
ppd-compiler.html	42.79 KB	-r--r--r--
raster-driver.html	18.22 KB	-r--r--r--
ref-access_log.html	4.38 KB	-r--r--r--
ref-classes-conf.html	13.72 KB	-r--r--r--
ref-client-conf.html	2.08 KB	-r--r--r--
ref-cupsd-conf.html	83.53 KB	-r--r--r--
ref-error_log.html	1.6 KB	-r--r--r--
ref-mailto-conf.html	2.67 KB	-r--r--r--
ref-page_log.html	2.66 KB	-r--r--r--
ref-ppdcfile.html	69.38 KB	-r--r--r--
ref-printers-conf.html	17.88 KB	-r--r--r--
ref-snmp-conf.html	3.77 KB	-r--r--r--
ref-subscriptions-conf.html	8.26 KB	-r--r--r--
security.html	5.96 KB	-r--r--r--
sharing.html	6.64 KB	-r--r--r--
spec-banner.html	4.39 KB	-r--r--r--
spec-browsing.html	4.44 KB	-r--r--r--
spec-cmp.html	37.95 KB	-r--r--r--
spec-command.html	6.42 KB	-r--r--r--
spec-design.html	13.05 KB	-r--r--r--
spec-ipp.html	81.86 KB	-r--r--r--
spec-pdf.html	861 B	-r--r--r--
spec-postscript.html	5.05 KB	-r--r--r--
spec-ppd.html	66.86 KB	-r--r--r--
spec-raster.html	18.77 KB	-r--r--r--
spec-stp.html	3.79 KB	-r--r--r--
standard.html	5.22 KB	-r--r--r--
translation.html	22.96 KB	-r--r--r--
whatsnew.html	11.12 KB	-r--r--r--

Code Editor : spec-postscript.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>

<head>
	<title>Generating PostScript for CUPS</title>
	<meta name='keywords' content='Programming, PostScript, Document Structuring Conventions'>
	<link rel='stylesheet' type='text/css' href='../cups-printable.css'>
</head>
<body>
<!--
  "$Id: spec-postscript.html 8653 2009-05-16 23:53:28Z mike $"

CUPS PostScript file specification for the Common UNIX Printing System (CUPS).

These coded instructions, statements, and computer programs are the
  property of Apple Inc. and are protected by Federal copyright
  law.  Distribution and use rights are outlined in the file "LICENSE.txt"
  which should have been included with this file.  If this file is
  file is missing or damaged, see the license at "http://www.cups.org/".
-->

<H1 CLASS="title">Generating PostScript for CUPS</H1>

<h2 class='title'><a name='INTRODUCTION'>Introduction</a></h2>

<p>This document describes how to generate PostScript output for
CUPS and is largely based on the <a
href="http://partners.adobe.com/public/developer/en/ps/5001.DSC_Spec.pdf">
Adobe TechNote #5001: PostScript Language Document Structuring
Conventions Specification Version 3.0</a>. While CUPS can
generally print any PostScript file, following the rules in the
Adobe TechNote and this document will ensure that your PostScript
output will work reliably.</p>

<blockquote><b>Note:</b> While PostScript is currently the
defacto-standard print job file format/language for UNIX-based
applications, it is slowly being phased out in favor of Adobe's
Portable Document Format ("PDF") which offers many advantages
over PostScript. Mac OS X uses PDF as the primary print job file
format and Linux is making the transition. Both PostScript and
PDF are complex formats, and we highly recommend using high-level
toolkits whenever possible to create your print jobs.</blockquote>

<h3>Anatomy of a PostScript File</h3>

<p>PostScript files are ASCII text files starting with a header
line (<tt>%!PS-Adobe-3.0</tt>) followed by a combination of
comment lines starting with the percent sign (<tt>%</tt>) and
PostScript code lines. The lines themselves should not exceed 255
characters to conform to the DSC. The following short PostScript
file produces a box with a smiley face in it:</p>

<pre class="command">
%!PS-Adobe-3.0
%%BoundingBox: 36 36 576 756
%%Pages: 1
%%LanguageLevel: 2
%%EndComments
%%BeginSetup
% this is where fonts would be embedded
%%EndSetup
%%Page: (1) 1
%%BeginPageSetup
% this is where page-specific features would be specified
%%EndPageSetup
% Draw a black box around the page
0 setgray
1 setlinewidth
36 36 540 720 rectstroke

% Draw a two inch blue circle in the middle of the page
0 0 1 setrgbcolor
306 396 144 0 360 arc closepath fill

% Draw two half inch yellow circles for eyes
1 1 0 setrgbcolor
252 432 36 0 360 arc closepath fill
360 432 36 0 360 arc closepath fill

% Draw the smile
1 setlinecap
18 setlinewidth
306 396 99 200 340 arc stroke

% Print it!
showpage
%%EOF
</pre>

<div class="figure"><table summary="Sample PostScript File Output">
<caption>Figure 1: <a name="FIGURE_1">Sample PostScript File Output</a></caption>
<tr><td align="center"><img src="../images/smiley.jpg"
width="445" height="570" alt="Sample PostScript File Output"></td></tr>
</table></div>

<h2><a name='OPTIONS'>Embedding Printer Options</a></h2>

<p>There are two main strategies for embedding printer options in PostScript
files. The first is to list CUPS options using the <code>%cupsJobTicket</code>
comment:</p>

<pre>
%!PS-Adobe-3.0
%cupsJobTicket: media=A4 sides=two-sided-long-edge
%cupsJobTicket: PrinterOption=foo PrinterOption2=bar
...
%%EndComments
</pre>

<p>CUPS options apply to the entire job. To apply options to individual pages,
use the <code>%%IncludeFeature</code> comment instead:</p>

<pre>
%%Page: label 123
%%BeginPageSetup
%%IncludeFeature: *PageSize A4
%%IncludeFeature: *PrinterOption Foo
%%IncludeFeature: *PrinterOption2 Bar
%%EndPageSetup
...
</pre>

<h2><a name='FONTS'>Embedding Fonts and Text</a></h2>

<p>Always embed the fonts used by your print job, and for best performance
embed the fonts and character encodings in the setup section of the PostScript
file. Type 1 and Type 3 fonts are supported by all PostScript printers, while
Type 42 (TrueType) and CID fonts are supported by most level 2 and all level 3
PostScript printers. Binary font files should always be converted to the
corresponding ASCII (hex) encoding to avoid problems when printing over
interfaces that do not support binary PostScript.</p>

<h2><a name='IMAGES'>Embedding Images</a></h2>

<p>The <code>image</code> operator should be used to embed images in PostScript
files. Always use ASCII hex or Base-85 encoding for the image data to avoid
problems when printing over interfaces that do not support binary PostScript.
In most cases, the Base-85 encoding and compression filters can be used to
embed images with very little, if any, increase in data size.</p>

</body>
</html>

${this.title}

Code Editor : spec-postscript.html