xref: /plan9/sys/src/cmd/gs/doc/Psfiles.htm (revision 593dc095aefb2a85c828727bbfa9da139a49bdf4)
1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2<html>
3<head>
4<title>.ps files distributed with Ghostscript</title>
5<!-- $Id: Psfiles.htm,v 1.68 2005/10/20 19:46:23 ray Exp $ -->
6<!-- Originally: psfiles.txt -->
7<link rel="stylesheet" type="text/css" href="gs.css" title="Ghostscript Style">
8</head>
9
10<body>
11<!-- [1.0 begin visible header] ============================================ -->
12
13<!-- [1.1 begin headline] ================================================== -->
14
15<h1>PostScript files distributed with Ghostscript</h1>
16
17<!-- [1.1 end headline] ==================================================== -->
18
19<!-- [1.2 begin table of contents] ========================================= -->
20
21<h2>Table of contents</h2>
22
23<blockquote><ul>
24<li><a href="#General">Generally used system files</a>
25<li><a href="#Obscure">More obscure system files</a>
26<li><a href="#Config">Configuration files</a>
27<li><a href="#PDF_specific">PDF-specific system files</a>
28<li><a href="#DPS_specific">Display PostScript-specific system files</a>
29<li><a href="#Art">Art and examples</a>
30<li><a href="#Utilities">Utilities</a>
31<li><a href="#Development_tools">Development tools</a>
32<li><a href="#Miscellany">Odds and ends</a>
33</ul></blockquote>
34
35<!-- [1.2 end table of contents] =========================================== -->
36
37<!-- [1.3 begin hint] ====================================================== -->
38
39<p>For other information, see the <a href="Readme.htm">Ghostscript
40overview</a>.
41
42<!-- [1.3 end hint] ======================================================== -->
43
44<hr>
45
46<!-- [1.0 end visible header] ============================================== -->
47
48<!-- [2.0 begin contents] ================================================== -->
49
50<h2><a name="General"></a>Generally used system files</h2>
51
52<p>
53These files are found in the <b><tt>lib</tt></b> subdirectory of
54the Ghostscript source distribution.
55
56<dl>
57<dt><tt>gs_*_e.ps</tt>
58<dd><p>
59These files define the Encodings known to Ghostscript.  All of
60them except <b><tt>gs_std_e.ps</tt></b> and <b><tt>gs_il1_e.ps</tt></b>
61are loaded only if referred to.
62
63<dl>
64
65<dt>
66PostScript Encodings:
67<dd>
68<a href="../lib/gs_ce_e.ps"><tt>gs_ce_e.ps</tt></a>,
69<a href="../lib/gs_il1_e.ps"><tt>gs_il1_e.ps</tt></a>,
70<a href="../lib/gs_std_e.ps"><tt>gs_std_e.ps</tt></a>,
71<a href="../lib/gs_sym_e.ps"><tt>gs_sym_e.ps</tt></a>.
72
73<dt>
74PDF Encodings:
75<dd>
76<a href="../lib/gs_mex_e.ps"><tt>gs_mex_e.ps</tt></a>,
77<a href="../lib/gs_mro_e.ps"><tt>gs_mro_e.ps</tt></a>,
78<a href="../lib/gs_pdf_e.ps"><tt>gs_pdf_e.ps</tt></a>,
79<a href="../lib/gs_wan_e.ps"><tt>gs_wan_e.ps</tt></a>.
80
81<dt>
82Non-standard Encodings:
83<dd>
84<a href="../lib/gs_dbt_e.ps"><tt>gs_dbt_e.ps</tt></a>,
85<a href="../lib/gs_il2_e.ps"><tt>gs_il2_e.ps</tt></a>,
86<a href="../lib/gs_ksb_e.ps"><tt>gs_ksb_e.ps</tt></a>,
87<a href="../lib/gs_wl1_e.ps"><tt>gs_wl1_e.ps</tt></a>,
88<a href="../lib/gs_wl2_e.ps"><tt>gs_wl2_e.ps</tt></a>,
89<a href="../lib/gs_wl5_e.ps"><tt>gs_wl5_e.ps</tt></a>.
90
91<dt>
92Pseudo-encodings:
93<dd>
94<a href="../lib/gs_css_e.ps"><tt>gs_css_e.ps</tt></a>,
95<a href="../lib/gs_lgo_e.ps"><tt>gs_lgo_e.ps</tt></a>,
96<a href="../lib/gs_lgx_e.ps"><tt>gs_lgx_e.ps</tt></a>,
97<a href="../lib/gs_mgl_e.ps"><tt>gs_mgl_e.ps</tt></a>.
98
99</dl>
100</dl>
101
102<dl>
103<dt><a href="../lib/gs_btokn.ps"><tt>gs_btokn.ps</tt></a>
104<dd><b><tt>gs_init.ps</tt></b> reads this in if the <b><tt>btoken</tt></b>
105feature is included in the configuration.  It provides support for binary
106tokens.
107</dl>
108
109<dl>
110<dt><a href="../lib/gs_ccfnt.ps"><tt>gs_ccfnt.ps</tt></a>
111<dd><b><tt>gs_init.ps</tt></b> reads this in if the <b><tt>ccfonts</tt></b>
112feature is included in the configuration.  It provides support for compiled
113fonts.
114</dl>
115
116<dl>
117<dt><a href="../lib/gs_cff.ps"><tt>gs_cff.ps</tt></a>
118<dd>Load CFF (compressed) fonts.
119</dl>
120
121<dl>
122<dt><a href="../lib/gs_fntem.ps"><tt>gs_fntem.ps</tt></a>
123<dd>Code for emulating PostScript fonts with non-PostScript font technologies.
124</dl>
125
126<dl>
127<dt><a href="../lib/gs_cidtt.ps"><tt>gs_cidtt.ps</tt></a>
128<dd>Code for emulating CID fonts with TrueType fonts.
129</dl>
130
131<dl>
132<dt><a href="../lib/gs_cidcm.ps"><tt>gs_cidcm.ps</tt></a>
133<dd>Code for recognizing font names of the form CIDFont-CMap (or
134CIDFont--CMap) and creating the font automatically.
135</dl>
136
137<dl>
138<dt><a href="../lib/gs_ciddc.ps"><tt>gs_ciddc.ps</tt></a>
139<dd>Defines Decoding and CIDDecoding resource categories and related procsets.
140Used for for emulating PostScript fonts with non-PostScript font technologies.
141</dl>
142
143<dl>
144<dt><a href="../lib/gs_cidfm.ps"><tt>gs_cidfm.ps</tt></a>
145<dd>Provides resource mapping for CIDFont category.
146</dl>
147
148<dl>
149<dt><a href="../lib/gs_cidfn.ps"><tt>gs_cidfn.ps</tt></a>
150<dd><b><tt>ProcSet</tt></b> for implementing <b><tt>CIDFont</tt></b> and
151<b><tt>CIDMap</tt></b> resources.
152</dl>
153
154<dl>
155<dt><a href="../lib/gs_ciecs2.ps"><tt>gs_ciecs2.ps</tt></a>
156<dd>Implementation of the LangaugeLevel 2 CIEBased color spaces: CIEBasedA and CIEBasedABC.
157</dl>
158
159<dl>
160<dt><a href="../lib/gs_ciecs3.ps"><tt>gs_ciecs3.ps</tt></a>
161<dd>Implementation of the LangaugeLevel 3 CIEBased color spaces: CIEBasedA and CIEBasedABC.
162</dl>
163
164<dl>
165<dt><a href="../lib/gs_cmap.ps"><tt>gs_cmap.ps</tt></a>
166<dd><b><tt>ProcSet</tt></b> for implementing <b><tt>CMap</tt></b> resources.
167</dl>
168
169<dl>
170<dt><a href="../lib/gs_cspace.ps"><tt>gs_cspace.ps</tt></a>
171<dd> PostScript portion of the basic color space handling;
172see the extensive comment at the head of the file
173for information. Note that color space substitution
174and the hue-saturation-brightness (HSB) color space
175are now fully implemented in the PostScript code;
176the interpreter and the graphic library are no longer
177involved in or even aware of these features.
178</dl>
179
180<dl>
181<dt><a href="../lib/gs_devcs.ps"><tt>gs_devcs.ps</tt></a>
182<dd>Implementation of the DeviceGray, DeviceRGB, and DeviceCMYK color spaces.
183</dl>
184
185<dl>
186  <dt><a href="../lib/gs_devn.ps"><tt>gs_devn.ps</tt></a>
187  <dd>Implementation of the DeviceN color space.
188</dl>
189
190<dl>
191  <dt><a href="../lib/gs_devpxl.ps"><tt>gs_devpxl.ps</tt></a>
192  <dd>Implementation of the DevicePixel color space.
193</dl>
194
195<dl>
196<dt><a href="../lib/gs_dscp.ps"><tt>gs_dscp.ps</tt></a>
197<dd>Code to compensate for badly written PostScript files by setting
198Orientation according to the DSC comments.
199</dl>
200
201<dl>
202<dt><a href="../lib/gs_epsf.ps"><tt>gs_epsf.ps</tt></a>
203<dd>Allow the interpreter to recognize DOS EPSF file headers, and skip to the
204PostScript section of the file.
205</dl>
206
207<dl>
208<dt><a href="../lib/gs_fapi.ps"><tt>gs_fapi.ps</tt></a>
209<dd>Font API support.
210</dl>
211
212<dl>
213<dt><a href="../lib/gs_fonts.ps"><tt>gs_fonts.ps</tt></a>
214<dd><b><tt>gs_init.ps</tt></b> reads this in.  It initializes Ghostscript's
215font machinery and provides some utility procedures that work with fonts.
216</dl>
217
218<dl>
219<dt><a href="../lib/gs_frsd.ps"><tt>gs_frsd.ps</tt></a>
220<dd>Support for the PostScript LanguageLevel 3
221<b><tt>ReusableStreamDecode</tt></b> filter.
222</dl>
223
224<dl>
225<dt><a href="../lib/gs_img.ps"><tt>gs_img.ps</tt></a>
226<dd>Implementation of the traditional (non-dictionary)
227form of the image and imagemask operators, and the
228colorimage operator (including the Next alphaimage
229facility).
230</dl>
231
232<dl>
233<dt><a href="../lib/gs_indxd.ps"><tt>gs_indxd.ps</tt></a>
234<dd>Implementation of the Indexed color space.
235</dl>
236
237<dl>
238<dt><a href="../lib/gs_init.ps"><tt>gs_init.ps</tt></a>
239<dd>Ghostscript reads this automatically when it starts up.  It contains
240definitions of many standard procedures and initialization for a wide
241variety of things.
242</dl>
243
244<dl>
245<dt><a href="../lib/gs_lev2.ps"><tt>gs_lev2.ps</tt></a>
246<dd><b><tt>gs_init.ps</tt></b> reads this in if the Ghostscript interpreter
247includes Level 2 PostScript functions.  It contains definitions of
248procedures and miscellaneous initialization for the Level 2 functions.
249</dl>
250
251<dl>
252<dt><a href="../lib/gs_ll3.ps"><tt>gs_ll3.ps</tt></a>
253<dd>Initialize PostScript LanguageLevel 3 functions.
254</dl>
255
256<dl>
257<dt><a href="../lib/gs_patrn.ps"><tt>gs_patrn.ps</tt></a>
258<dd>Implementation of the Pattern color space.
259</dl>
260
261<dl>
262<dt><a href="../lib/gs_resmp.ps"><tt>gs_resmp.ps</tt></a>
263<dd>A procset for redefining resource categories with a resource map.
264</dl>
265
266<dl>
267<dt><a href="../lib/gs_resst.ps"><tt>gs_resst.ps</tt></a>
268<dd>A procset which allow to put resource files into static data segment
269of Ghostscript executable.
270</dl>
271
272<dl>
273<dt><a href="../lib/gs_stres.ps"><tt>gs_stres.ps</tt></a>
274<dd>A map for generating the static data segment with including
275resource files, and for retrieving resources from there.
276</dl>
277
278<dl>
279<dt><a href="../lib/gs_res.ps"><tt>gs_res.ps</tt></a>
280<dd><b><tt>gs_init.ps</tt></b> reads this in if the Level 2 resource
281machinery is included.  Currently, this is the case for all Level 2
282configurations.
283</dl>
284
285<dl>
286<dt><a href="../lib/gs_sepr.ps"><tt>gs_sepr.ps</tt></a>
287<dd>Implementaton of the Separation color space.
288</dl>
289
290<dl>
291<dt><a href="../lib/gs_setpd.ps"><tt>gs_setpd.ps</tt></a>
292<dd>Implementation of the <b><tt>setpagedevice</tt></b> operator.
293</dl>
294
295<dl>
296<dt><a href="../lib/gs_statd.ps"><tt>gs_statd.ps</tt></a>
297<dd><b><tt>gs_init.ps</tt></b> reads this in.  It creates a dummy
298<b><tt>statusdict</tt></b> and some other environmental odds and ends for
299the benefit of PostScript files that really want to be printed on a
300LaserWriter.
301</dl>
302
303<dl>
304<dt><a href="../lib/gs_trap.ps"><tt>gs_trap.ps</tt></a>
305<dd>Stub support for the PostScript LanguageLevel 3 "In-RIP trapping"
306feature.
307</dl>
308
309<dl>
310<dt><a href="../lib/gs_ttf.ps"><tt>gs_ttf.ps</tt></a>
311<dd>Support code for direct use of TrueType fonts.
312</dl>
313
314<dl>
315<dt><a href="../lib/gs_typ32.ps"><tt>gs_typ32.ps</tt></a>
316<dd>Initialization file for Type 32 fonts.
317</dl>
318
319<dl>
320<dt><a href="../lib/gs_typ42.ps"><tt>gs_typ42.ps</tt></a>
321<dd>Support code for Type 42 fonts (TrueType font in a PostScript "wrapper").
322</dl>
323
324<dl>
325<dt><a href="../lib/gs_type1.ps"><tt>gs_type1.ps</tt></a>
326<dd><b><tt>gs_init.ps</tt></b> reads this in if the Ghostscript interpreter
327includes Type 1 font capability (which it normally does).
328</dl>
329
330<hr>
331
332<h2><a name="Config"></a>Configuration files</h2>
333
334<p>
335These files are found in the <b><tt>lib</tt></b> subdirectory of
336the Ghostscript source distribution. Users are allowed to modify them
337to configure Ghostscript.
338
339<dl>
340<dt><a href="../lib/Fontmap"><tt>Fontmap</tt></a>
341<dd>Font mapping table.
342</dl>
343
344<dl>
345<dt><a href="../lib/cidfmap"><tt>cidfmap</tt></a>
346<dd>CID font mapping table. Allows substitution of a CID font for another CID font or
347a TrueType font for a CID font.
348</dl>
349
350<dl>
351<dt><a href="../lib/FAPIconfig"><tt>FAPIconfig</tt></a>
352<dd>A configuration file for Font API client.
353</dl>
354
355<dl>
356<dt><a href="../lib/FAPIfontmap"><tt>FAPIfontmap</tt></a>
357<dd>Font mapping table for Font-API-handled fonts.
358</dl>
359
360<dl>
361<dt><a href="../lib/FAPIcidfmap"><tt>FAPIcidfmap</tt></a>
362<dd>Font mapping table for Font-API-handled CID fonts.
363</dl>
364
365<hr>
366
367<h2><a name="Obscure"></a>More obscure system files</h2>
368
369<p>
370These files are found in the <b><tt>lib</tt></b> subdirectory of
371the Ghostscript source distribution.
372
373<dl>
374<dt><a href="../lib/font2c.ps"><tt>font2c.ps</tt></a>
375<dd>Convert a PostScript Type 0 or Type 1 font to C code that can be compiled
376and linked into Ghostscript; see the documentation on fonts for <a
377href="Fonts.htm#Precompiling">how to do this</a>.
378</dl>
379
380<dl>
381<dt><a href="../lib/gs_agl.ps"><tt>gs_agl.ps</tt></a>
382<dd>Contains the mapping from Adobe glyph names to Unicode values, used to
383support TrueType fonts.
384</dl>
385
386<dl>
387<dt><a href="../lib/gs_cmdl.ps"><tt>gs_cmdl.ps</tt></a>
388<dd>This file is not used yet.  Eventually it will replace C code that
389parses the Ghostscript command line.
390</dl>
391
392<dl>
393<dt><a href="../lib/gs_diskf.ps"><tt>gs_diskf.ps</tt></a>
394<dd>This file implements the <b><tt>-dDISKFONTS</tt></b> feature
395(<b><tt>diskfont.dev</tt></b>).  See the the usage documentation for <a
396href="Use.htm#DISKFONTS">a description of this feature</a>.
397</dl>
398
399<dl>
400<dt><a href="../lib/gs_diskn.ps"><tt>gs_diskn.ps</tt></a>
401<dd>This file implements the <b><tt>%disk</tt></b> IODevice
402(<b><tt>diskn.dev</tt></b> feature).  See the the language documentation
403for information on the use of the %disk# devices. These PostScript
404modifications primarily perform the searching of all Searchable file
405systems in a defined SearchOrder when a file reference does not contain
406an explicit %device% specifier (such as <b><tt>%os%</tt></b> or
407<b><tt>%disk0</tt></b>%). This is required to emulate undocumented
408behaviour of Adobe PostScript printers that have a disk and was
409experimentally determined.
410</dl>
411
412<dl>
413<dt><a href="../lib/gs_fform.ps"><tt>gs_fform.ps</tt></a>
414<dd>A usable but imperfect PostScript implementation of Form caching.
415</dl>
416
417<dl>
418<dt><a href="../lib/gs_kanji.ps"><tt>gs_kanji.ps</tt></a>
419<dd>This file provides support for the Wadalab free Kanji font.  It is not
420included automatically in any configuration.
421</dl>
422
423<dl>
424<dt><a href="../lib/gs_pdfwr.ps"><tt>gs_pdfwr.ps</tt></a>
425<dd>This file contains some patches for providing information to the
426<b><tt>pdfwrite</tt></b> driver.  It is included only if the
427<b><tt>pdfwrite</tt></b> driver is included.
428</dl>
429
430<dl>
431<dt><a href="../lib/gs_pfile.ps"><tt>gs_pfile.ps</tt></a>
432<dd>This file provides runtime support for packed fonts.  It is not
433included automatically in any configuration.
434</dl>
435
436<dl>
437<dt><a href="../lib/gs_rdlin.ps"><tt>gs_rdlin.ps</tt></a>
438<dd>A tiny patch for systems with built-in readline support.
439</dl>
440
441<dl>
442<dt><a href="../lib/ht_ccsto.ps"><tt>ht_ccsto.ps</tt></a>
443<dd>A default stochastic CMYK halftone.  This file is in the public domain.
444</dl>
445
446<dl>
447<dt><a href="../lib/stcolor.ps"><tt>stcolor.ps</tt></a>
448<dd>Configure the (Epson) <b><tt>stcolor</tt></b> driver
449</dl>
450
451<hr>
452
453<h2><a name="PDF_specific"></a>PDF-specific system files</h2>
454
455<p>
456These files are found in the <b><tt>lib</tt></b> subdirectory of
457the Ghostscript source distribution.
458
459<dl>
460<dt><a href="../lib/gs_l2img.ps"><tt>gs_l2img.ps</tt></a>
461<dd>The <b><tt>ProcSet</tt></b> that emulates the PostScript Level 2
462"<b><tt>image</tt></b>" operator on Level 1 systems.
463</dl>
464
465<dl>
466<dt><a href="../lib/pdf_base.ps"><tt>pdf_base.ps</tt></a>
467<dd>Utilities for interpreting PDF objects and streams.
468</dl>
469
470<dl>
471<dt><a href="../lib/pdf_draw.ps"><tt>pdf_draw.ps</tt></a>
472<dd>The interpreter for drawing-related PDF operations.
473</dl>
474
475<dl>
476<dt><a href="../lib/pdf_font.ps"><tt>pdf_font.ps</tt></a>
477<dd>Code for handling fonts in PDF files.
478</dl>
479
480<dl>
481<dt><a href="../lib/pdf_main.ps"><tt>pdf_main.ps</tt></a>
482<dd>Document- and page-level control for interpreting PDF files.
483</dl>
484
485<dl>
486<dt><a href="../lib/pdf_ops.ps"><tt>pdf_ops.ps</tt></a>
487<dd>Definitions for most of the PDF operators.
488</dl>
489
490<dl>
491<dt><a href="../lib/pdf_rbld.ps"><tt>pdf_rbld.ps</tt></a>
492<dd>Contains procedures for bebuilding damaged PDF files.
493</dl>
494
495<dl>
496<dt><a href="../lib/pdf_sec.ps"><tt>pdf_sec.ps</tt></a>
497<dd>PDF security (encryption) code.
498</dl>
499
500<dl>
501<dt><a href="../lib/pdfopt.ps"><tt>pdfopt.ps</tt></a>
502<dd>A PDF linearizer ("optimizer").
503</dl>
504
505<dl>
506<dt><a href="../lib/pdfwrite.ps"><tt>pdfwrite.ps</tt></a>
507<dd>Support for writing PDF files.  Currently used only by the linearizer,
508but potentially useful for other kinds of PDF-processing utilities.
509</dl>
510
511<dl>
512<dt><a href="../lib/gs_icc.ps"><tt>gs_icc.ps</tt></a> <dd>Support for
513ICC color profiles. These are not a standard PostScript feature, but
514are used in the PDF interpreter, as ICC profiles may be embedded in
515PDF files.
516</dl>
517
518<dl>
519<dt><a href="../lib/opdfread.ps"><tt>opdfread.ps</tt></a>
520<dd>Postscript procset for reading an ordered PDF file. This
521is used by the <tt><b>ps2ps</tt></b>, <tt><b>ps2ps2</tt></b> scripts.
522</dl>
523
524<dl>
525<dt><a href="../lib/EndOfTask.ps"><tt>EndOfTask.ps</tt></a>
526<dd>An auxiliary file used by the <tt><b>ps2write</tt></b> script.
527</dl>
528
529<dl>
530<dt><a href="../lib/PDFX_def.ps"><tt>PDFX_def.ps</tt></a>
531<dd>This is a sample prefix file for creating a PDF/X-3 document
532with the <tt><b>pdfwrite</tt></b> device.
533</dl>
534
535<hr>
536
537<h2><a name="DPS_specific"></a>Display PostScript-specific system files</h2>
538
539<p>
540These files are found in the <b><tt>lib</tt></b> subdirectory of
541the Ghostscript source distribution.
542
543<dl>
544<dt><a href="../lib/gs_dpnxt.ps"><tt>gs_dpnxt.ps</tt></a>
545<dd>NeXT Display PostScript extensions.
546</dl>
547
548<dl>
549<dt><a href="../lib/gs_dps.ps"><tt>gs_dps.ps</tt></a>,
550<a href="../lib/gs_dps1.ps"><tt>gs_dps1.ps</tt></a>,
551<a href="../lib/gs_dps2.ps"><tt>gs_dps2.ps</tt></a>
552<dd><b><tt>gs_init.ps</tt></b> reads these in if the <b><tt>dps</tt></b>
553feature is included in the configuration.  They provide support for various
554Display PostScript and Level 2 features.
555</dl>
556
557<hr>
558
559<h2><a name="Art"></a>Art and examples</h2>
560
561<p>
562These files are found in the <b><tt>examples</tt></b> subdirectory of
563the Ghostscript source distribution.
564
565<dl>
566<dt><a href="../examples/alphabet.ps"><tt>alphabet.ps</tt></a>
567<dd>Prints a sample alphabet at several different sizes.
568</dl>
569
570<dl>
571<dt><a href="../examples/annots.pdf"><tt>annots.pdf</tt></a>
572<dd>A sample file with a wide variety of PDF "annotations".
573</dl>
574
575<dl>
576<dt><a href="../examples/cheq.ps"><tt>cheq.ps</tt></a>
577<dd>A chessboard "font" used by chess.ps (obtained from Adobe).
578</dl>
579
580<dl>
581<dt><a href="../examples/chess.ps"><tt>chess.ps</tt></a>
582<dd>A black-and-white chessboard.
583</dl>
584
585<dl>
586<dt><a href="../examples/colorcir.ps"><tt>colorcir.ps</tt></a>
587<dd>A set of nested ellipses made up of colored bars.
588</dl>
589
590<dl>
591<dt><a href="../examples/doretree.ps"><tt>doretree.ps</tt></a>
592<dd>A 3-D image produced by a modeling program.  This file is in the public
593domain.
594</dl>
595
596<dl>
597<dt><a href="../examples/escher.ps"><tt>escher.ps</tt></a>
598<dd>A colored version of a hexagonally symmetric Escher drawing of
599interlocking butterflies.  Can be printed on monochrome devices, with
600somewhat less dramatic results.
601</dl>
602
603<dl>
604<dt><a href="../examples/golfer.eps"><tt>golfer.eps</tt></a>
605<dd>A gray-scale picture of a stylishly dressed woman swinging a golf club.
606</dl>
607
608<dl>
609<dt><a href="../examples/grayalph.ps"><tt>grayalph.ps</tt></a>
610<dd>Grayscaled text test pattern.
611</dl>
612
613<dl>
614<dt><a href="../examples/ridt91.eps"><tt>ridt91.eps</tt></a>
615<dd>The RIDT '91 logo.  Note that since this is an EPS file, you will have
616to add "<b><tt>-c&nbsp;showpage</tt></b>" at the end of the command line to
617print it or convert it to a raster file.
618</dl>
619
620<dl>
621<dt><a href="../examples/snowflak.ps"><tt>snowflak.ps</tt></a>
622<dd>A rectangular grid of intricate colored snowflakes.  (May render very
623slowly.)
624</dl>
625
626<dl>
627<dt><a href="../examples/tiger.eps"><tt>tiger.eps</tt></a>
628<dd>A dramatic colored picture of a tiger's head.
629</dl>
630
631<dl>
632<dt><a href="../examples/vasarely.ps"><tt>vasarely.ps</tt></a>
633<dd>Colored rectangles and ellipses inspired by Victor Vasarely's experiments
634with tilting circles and squares.
635</dl>
636
637<dl>
638<dt><a href="../examples/waterfal.ps"><tt>waterfal.ps</tt></a>
639<dd>Prints text in a variety of different sizes, to help evaluate the
640quality of text rendering.
641</dl>
642
643<hr>
644
645<h2><a name="Utilities"></a>Utilities</h2>
646
647<p>
648For more information on these utility programs, see the comments at the
649beginnings of the files.  The ones marked (*) have batch files or shell
650scripts of the same name (like <b><tt>bdftops</tt></b> and
651<b><tt>bdftops.bat</tt></b>) to invoke them conveniently.
652
653<p>
654These files are found in the <b><tt>lib</tt></b> subdirectory of
655the Ghostscript source distribution.
656
657<dl>
658<dt><a href="../lib/addxchar.ps"><tt>addxchar.ps</tt></a>
659<dd>A utility to add Central European and other Adobe extended Latin
660characters to a Type 1 font.
661</dl>
662
663<dl>
664<dt><a href="../lib/align.ps"><tt>align.ps</tt></a>
665<dd>A test page for determining the proper margin and offset parameters for
666your printer.
667</dl>
668
669<dl>
670<dt><a href="../lib/bdftops.ps"><tt>bdftops.ps</tt></a> *
671<dd>A utility for converting BDF fonts to outline form: see the <a
672href="Fonts.htm">documentation on fonts</a>.
673</dl>
674
675<dl>
676<dt><a href="../lib/bench.ps"><tt>bench.ps</tt></a>
677<dd>A file useful for running benchmarks.
678</dl>
679
680<dl>
681<dt><a href="../lib/caption.ps"><tt>caption.ps</tt></a>
682<dd>A file for putting a caption in a box at the bottom of each page,
683useful for trade show demos.
684</dl>
685
686<dl>
687<dt><a href="../lib/cid2code.ps"><tt>cid2code.ps</tt></a>
688<dd>A utility for creating maps from CIDs to Unicode, useful when
689substituting a TrueType font for an Adobe font.
690</dl>
691
692<dl>
693<dt><a href="../lib/docie.ps"><tt>docie.ps</tt></a>
694<dd>An emulation of the CIE color mapping algorithms.
695</dl>
696
697<dl>
698<dt><a href="../lib/errpage.ps"><tt>errpage.ps</tt></a>
699<dd>A file that you can put in front of your own files to make Ghostscript
700(or a PostScript printer) produce an informative error page if something
701goes wrong during the processing of your file(s).
702</dl>
703
704<dl>
705<dt><a href="../lib/font2pcl.ps"><tt>font2pcl.ps</tt></a>
706<dd>A utility to write a font as a PCL bitmap font.
707</dl>
708
709<dl>
710<dt><a href="../lib/gslp.ps"><tt>gslp.ps</tt></a> *
711<dd>A utility for doing "line printing" of plain text files.
712</dl>
713
714<dl>
715<dt><a href="../lib/gsnup.ps"><tt>gsnup.ps</tt></a>
716<dd>A file that you can concatenate in front of (very well-behaved)
717PostScript files to do N-up printing.  It is deliberately simple and naive:
718for more generality, use <b><tt>psnup</tt></b> (which, however, requires DSC
719comments).
720</dl>
721
722<dl>
723<dt><a href="../lib/jispaper.ps"><tt>jispaper.ps</tt></a>
724<dd>A file that makes the <b><tt>b0</tt></b> through <b><tt>b6</tt></b>
725procedures refer to JIS B paper sizes rather than ISO B.
726</dl>
727
728
729<dl>
730<dt><a href="../lib/impath.ps"><tt>impath.ps</tt></a>
731<dd>A utility for reconstructing outlines from bitmap images, used by
732<b><tt>bdftops</tt></b>.
733</dl>
734
735<dl>
736<dt><a href="../lib/landscap.ps"><tt>landscap.ps</tt></a>
737<dd>A file that you can put in front of your own files to get them rendered
738in landscape mode.
739</dl>
740
741<dl>
742<dt><a href="../lib/level1.ps"><tt>level1.ps</tt></a>
743<dd>A file that turns off any Level 2 features.
744</dl>
745
746<dl>
747<dt><a href="../lib/mkcidfm.ps"><tt>mkcidfm.ps</tt></a>
748<dd>A utility for creating a CID font mapping table <b><tt>cidfmap</tt></b>
749from fonts found in a specified directory.
750</dl>
751
752<dl>
753<dt><a href="../lib/packfile.ps"><tt>packfile.ps</tt></a>
754<dd>A utility for compressing fonts into a single file.
755</dl>
756
757<dl>
758<dt><a href="../lib/pdf2dsc.ps"><tt>pdf2dsc.ps</tt></a>
759<dd>A utility to read a PDF file and produce a DSC "index" file.
760</dl>
761
762<dl>
763<dt><a href="../lib/pf2afm.ps"><tt>pf2afm.ps</tt></a> *
764<dd>A utility for producing AFM files from PFA, PFB, and optionally PFM
765files.
766</dl>
767
768<dl>
769<dt><a href="../lib/pfbtopfa.ps"><tt>pfbtopfa.ps</tt></a> *
770<dd>A utility to convert PFB (binary) font files to PFA (text) format.
771</dl>
772
773<dl>
774<dt><a href="../lib/prfont.ps"><tt>prfont.ps</tt></a>
775<dd>A utility to print a font catalog.
776</dl>
777
778<dl>
779<dt><a href="../lib/printafm.ps"><tt>printafm.ps</tt></a>
780<dd>A utility to print an AFM file on standard output.
781</dl>
782
783<dl>
784<dt><a href="../lib/ps2ai.ps"><tt>ps2ai.ps</tt></a>
785<dd>A utility for converting an arbitrary PostScript file into a form
786compatible with Adobe Illustrator.  NOTE: <b><tt>ps2ai</tt></b> doesn't
787work properly with Adobe's Helvetica-Oblique font, and other fonts whose
788original <b><tt>FontMatrix</tt></b> involves skewing or rotation.
789</dl>
790
791<dl>
792<dt><a href="../lib/ps2ascii.ps"><tt>ps2ascii.ps</tt></a> *
793<dd>A utility for extracting the ASCII text from PostScript source files.
794It redefines many operators.  For more information, see the comments in the
795file.
796</dl>
797
798<dl>
799<dt><a href="../lib/ps2epsi.ps"><tt>ps2epsi.ps</tt></a> *
800<dd>A utility for converting an arbitrary PostScript file into EPSI form.
801</dl>
802
803<dl>
804<dt><a href="../lib/quit.ps"><tt>quit.ps</tt></a>
805<dd>A file containing just the word "<b><tt>quit</tt></b>".  (The
806<b><tt>-c</tt></b> switch now makes this unnecessary; this file exists for
807backward compatibility.)
808</dl>
809
810<dl>
811<dt><a href="../lib/rollconv.ps"><tt>rollconv.ps</tt></a>
812<dd>A utility for converting files produced by Macromedia's
813<b><tt>Rollup</tt></b> program to a Type 0 form directly usable by
814Ghostscript.
815</dl>
816
817<dl>
818<dt><a href="../lib/showpage.ps"><tt>showpage.ps</tt></a>
819<dd>A file containing just the word "<b><tt>showpage</tt></b>".  (The
820<b><tt>-c</tt></b> switch now makes this unnecessary; this file exists for
821backward compatibility.)
822</dl>
823
824<dl>
825<dt><a href="../lib/stocht.ps"><tt>stocht.ps</tt></a>
826<dd>A file that installs the StochasticDefault halftone as the default,
827which may improve output quality on inkjet printers.  See the file for more
828information.
829</dl>
830
831<dl>
832<dt><a href="../lib/viewcmyk.ps"><tt>viewcmyk.ps</tt></a>
833<dd>A utility for displaying CMYK files.
834</dl>
835
836<dl>
837<dt><a href="../lib/viewgif.ps"><tt>viewgif.ps</tt></a>
838<dd>A utility for displaying GIF files.
839</dl>
840
841<dl>
842<dt><a href="../lib/viewjpeg.ps"><tt>viewjpeg.ps</tt></a>
843<dd>A utility for displaying JPEG files.
844</dl>
845
846<dl>
847<dt><a href="../lib/viewmiff.ps"><tt>viewmiff.ps</tt></a>
848<dd>A utility for displaying MIFF files.
849</dl>
850
851<dl>
852<dt><a href="../lib/viewpbm.ps"><tt>viewpbm.ps</tt></a>
853<dd>A utility for displaying PBM/PGM/PPM files.
854</dl>
855
856<dl>
857<dt><a href="../lib/viewpcx.ps"><tt>viewpcx.ps</tt></a>
858<dd>A utility for displaying PCX files.
859</dl>
860
861<dl>
862<dt><a href="../lib/waterfal.ps"><tt>waterfal.ps</tt></a>
863<dd>A utility to print a "waterfall" of fonts at different sizes.
864</dl>
865
866<hr>
867
868<h2><a name="Development_tools"></a>Development tools</h2>
869
870<p>
871These files are found in the <b><tt>lib</tt></b> subdirectory of
872the Ghostscript source distribution.
873
874<dl>
875<dt><a href="../lib/acctest.ps"><tt>acctest.ps</tt></a>
876<dd>A utility that checks whether the interpreter enforces access
877restrictions.
878</dl>
879
880<dl>
881<dt><a href="../lib/decrypt.ps"><tt>decrypt.ps</tt></a>
882<dd>A utility for decrypting the <b><tt>eexec</tt></b> section of a font.
883</dl>
884
885<dl>
886<dt><a href="../lib/dumphint.ps"><tt>dumphint.ps</tt></a>
887<dd>A utility for printing (to stdout) linearized PDF hint tables in
888an easy to read form. Scripts
889<a href="../lib/dumphint"><tt>dumphint</tt></a> and
890<a href="../lib/dumphint.bat"><tt>dumphint.bat</tt></a>
891are provided for the user's convenience.
892</dl>
893
894<dl>
895<dt><a href="../lib/image-qa.ps"><tt>image-qa.ps</tt></a>
896<dd>A comprehensive test of the image display operators.
897</dl>
898
899<dl>
900<dt><a href="../lib/markpath.ps"><tt>markpath.ps</tt></a>
901<dd>A utility for showing the points on a path.
902</dl>
903
904<dl>
905<dt><a href="../lib/pcharstr.ps"><tt>pcharstr.ps</tt></a>
906<dd>A utility for printing out the <b><tt>CharStrings</tt></b> and
907<b><tt>Subrs</tt></b> in a Type 1 font.
908</dl>
909
910<dl>
911<dt><a href="../lib/ppath.ps"><tt>ppath.ps</tt></a>
912<dd>A couple of utilities for printing out the current path, for debugging.
913</dl>
914
915<dl>
916<dt><a href="../lib/pphs.ps"><tt>pphs.ps</tt></a>
917<dd>A utility to print the Primary Hint Stream of a linearized PDF file.
918</dl>
919
920<dl>
921<dt><a href="../lib/traceimg.ps"><tt>traceimg.ps</tt></a>
922<dd>Trace the data supplied to the <b><tt>image</tt></b> operator.
923</dl>
924
925<dl>
926<dt><a href="../lib/traceop.ps"><tt>traceop.ps</tt></a>
927<dd>A utility for tracing uses of any procedure or operator for debugging.
928</dl>
929
930<dl>
931<dt><a href="../lib/type1enc.ps"><tt>type1enc.ps</tt></a>
932<dd>The Type 1 font format encryption and decryption algorithms, written in
933PostScript.
934</dl>
935
936<dl>
937<dt><a href="../lib/uninfo.ps"><tt>uninfo.ps</tt></a>
938<dd>Some utilities for printing out PostScript data structures.
939</dl>
940
941<dl>
942<dt><a href="../lib/unprot.ps"><tt>unprot.ps</tt></a>
943<dd>A prologue to disable access checking.
944</dl>
945
946<dl>
947<dt><a href="../lib/viewps2a.ps"><tt>viewps2a.ps</tt></a>
948<dd>A utility for displaying the output of <b><tt>ps2ascii.ps</tt></b>.
949</dl>
950
951<dl>
952<dt><a href="../lib/wftopfa.ps"><tt>wftopfa.ps</tt></a>
953<dd>Convert a Wadalab (Japanese) base font to <b><tt>.PFA</tt></b> (or
954<b><tt>.PFB</tt></b>) format.
955</dl>
956
957<dl>
958<dt><a href="../lib/winmaps.ps"><tt>winmaps.ps</tt></a>
959<dd>A utility for creating mappings between the Adobe encodings and the
960Microsoft Windows character sets.
961</dl>
962
963<dl>
964<dt><a href="../lib/wrfont.ps"><tt>wrfont.ps</tt></a>
965<dd>A utility for writing out an unprotected Type 1 font, such as the
966standard Ghostscript fonts.
967</dl>
968
969<dl>
970<dt><a href="../lib/zeroline.ps"><tt>zeroline.ps</tt></a>
971<dd>A utility for testing how interpreters handle zero-width lines.
972</dl>
973
974<hr>
975
976<h2><a name="Miscellany"></a>Odds and ends</h2>
977
978<p>
979These files are found in the <b><tt>lib</tt></b> subdirectory of
980the Ghostscript source distribution.
981
982<dl>
983<dt><a href="../lib/lines.ps"><tt>lines.ps</tt></a>
984<dd>A test program for line joins and caps.
985</dl>
986
987<dl>
988<dt><a href="../lib/markhint.ps"><tt>markhint.ps</tt></a>
989<dd>Draw the hints for a Type 1 font.
990</dl>
991
992<dl>
993<dt><a href="../lib/showchar.ps"><tt>showchar.ps</tt></a>
994<dd>Show a character's outline and rasterized forms.
995</dl>
996
997<dl>
998<dt><a href="../lib/stcinfo.ps"><tt>stcinfo.ps</tt></a>
999<dd>Print and show parameters of the (Epson) <b><tt>stcolor</tt></b> driver.
1000</dl>
1001
1002<dl>
1003<dt><a href="../lib/type1ops.ps"><tt>type1ops.ps</tt></a>
1004<dd>The Type 1 font format opcodes.
1005</dl>
1006
1007<!-- [2.0 end contents] ==================================================== -->
1008
1009<!-- [3.0 begin visible trailer] =========================================== -->
1010<hr>
1011
1012<p>
1013<small>Copyright &copy; 1996, 2000 Aladdin Enterprises.  All rights
1014reserved.</small>
1015
1016<p>
1017This software is provided AS-IS with no warranty, either express or
1018implied.
1019
1020This software is distributed under license and may not be copied,
1021modified or distributed except as expressly authorized under the terms
1022of the license contained in the file LICENSE in this distribution.
1023
1024For more information about licensing, please refer to
1025http://www.ghostscript.com/licensing/. For information on
1026commercial licensing, go to http://www.artifex.com/licensing/ or
1027contact Artifex Software, Inc., 101 Lucas Valley Road #110,
1028San Rafael, CA  94903, U.S.A., +1(415)492-9861.
1029
1030<p>
1031<small>Ghostscript version 8.53, 20 October 2005
1032
1033<!-- [3.0 end visible trailer] ============================================= -->
1034
1035</small></body>
1036</html>
1037