|
|
% Copyright (C) 2001-2023 Artifex Software, Inc.
% All Rights Reserved.
%
% This software is provided AS-IS with no warranty, either express or
% implied.
%
% This software is distributed under license and may not be copied,
% modified or distributed except as expressly authorized under the terms
% of the license contained in the file LICENSE in this distribution.
%
% Refer to licensing information at http://www.artifex.com or contact
% Artifex Software, Inc., 39 Mesa Street, Suite 108A, San Francisco,
% CA 94129, USA, for further information.
%
% gslp.ps - format and print text
% This utility provides functionality approximately equivalent to the Unix
% `enscript' program. It prints plain text files using a single font.
% It currently handles tabs and formfeeds, but not backspaces.
% It will line-wrap when using fixed-pitch fonts.
% It will also do kerning and width adjustment.
% Standard switches implemented:
% -12BclqRr -b<header> -f<font> -F<hfont> -L<lines> -p<outfile>
% Sun switches implemented:
% -T<n> set tab width
% Switches ignored:
% -GghKkmow -# -C -d -J -n -P -S -s -t -v
% Switches added:
% --add-to-space <units>
% add the given number of 1/72" units to the width of each
% space (may be negative)
% --add-to-width <units>
% add the given number of 1/72" units to the width of each
% character (may be negative)
% --columns <n>
% print in <n> columns
% --detect
% treat the file as PostScript if it starts with %!
% --first-page <n>
% --duplex(|-long-edge|-short-edge)
% use duplex if available; if not specified, select long edge
% for portrait printing, short edge for landscape
% start printing at page <n>
% --encoding <encodingname> default ISOLatin1Encoding
% Note this only takes effect during -f or -F option thus the
% body text and header text can use different encodings.
% --kern <file.afm>
% kern using information from the given .AFM file
% --last-page <n>
% stop printing after page <n>
% --(heading|footing)-(left|center|right) <string>
% set the heading/footing fields; use -B first to clear
% --margin-(top|bottom|left|right) <inches>
% set a margin
% --no-eject-(file|formfeed)
% end-of-file/FF only starts a new column, not a new sheet
% --spacing <n>
% use double (n=2), triple (n=3), etc. spacing
% Also, the string %# in a heading or footing is replaced with the page #.
/PageNumberString (%#) def
/lpdict 150 dict deflpdict begin
/encoding /ISOLatin1Encoding def % the default encoding
% build a version of the font with the requested encoding (default ISOLatin1)
/font-to-encoding { % <font> font-to-encoding <font>
%% reencode for iso latin1; from the 2nd edition red book, sec 5.6.1
dup length dict begin {1 index /FID ne {def} {pop pop} ifelse} forall /Encoding encoding /Encoding findresource readonly def currentdict end % strip off the "Encoding" part of the encoding (if present)
dup /FontName get 80 string cvs encoding 256 string cvs (Encoding) search { exch pop exch pop } if exch (-) concatstrings exch concatstrings cvn exch definefont} def
/find-latin-font { % <name> find-latin-font <font>
findfont font-to-encoding} def
% Define the initial values of the printing parameters.
/AddToSpace 0 def/AddToWidth 0 def/BodyFont null def % use default
/defaultBodyFontPortrait /Courier find-latin-font 10 scalefont def /defaultBodyFontLandscape /Courier find-latin-font 7 scalefont def /defaultBodyFont { Landscape { defaultBodyFontLandscape } { defaultBodyFontPortrait } ifelse } def/Columns 1 def/DetectFileType false def/Duplex null def/EjectEOF true def/EjectFF true def/Footers false def/FootingLeft () def/FootingCenter () def/FootingRight () def/Headers true def/HeadingLeft () def/HeadingCenter () def/HeadingRight (page ) PageNumberString concatstrings def/HeadingFont null def % use default
/defaultHeadingFont /Courier-Bold find-latin-font 10 scalefont def/Kern 0 dict def % no kerning
/Landscape false def/MarginBottom 36 def % 1/2"
/MarginLeft 36 def % 1/2"
/MarginRight 36 def % 1/2"
/MarginTop 36 def % 1/2"
/MaxLines 9999 def % max lines per page
/Noisy true def % i.e., not quiet
/OutFile null def % null = write directly to device
/PageFirst 1 def/PageLast 99999 def/Spacing 1 def/Tab 8 def/Truncate false def % wrap long lines, don't truncate
% When writing to a file, we want to write out PostScript;
% when writing to the printer, we want to execute it;
% some commands should be executed regardless.
% lpexec provides for all this.
/lpdef { % <name> <value> lpdef -
/def 2 true lpexec} def
/lpexec { % <arg1> ... <argn> </op> <n> <do_always> lpexec -
OutFile null eq { pop 1 add true } { /t exch def 1 add /n exch def cvx n -1 roll dup wo n 1 sub { n -1 roll dup wosp } repeat (\n) ws n t } ifelse { pop load exec } { { pop } repeat } ifelse} def
/lpmoveto { % <x> <y> lpmoveto -
% Round the coordinates for smaller output.
2 { exch 100 mul round 100 div dup dup cvi eq { cvi } if } repeat 1 index X eq { neg exch pop /V 1 } { neg /M 2 } ifelse true lpexec} def/lpshow { % <string> lpshow -
dup length 0 ne { addspace 0 ne { addspace 0 32 addwidth 0 ne { addwidth 0 6 -1 roll /awidthshow 6 true lpexec } { 4 -1 roll /widthshow 4 true lpexec } ifelse } { addwidth 0 ne { addwidth 0 3 -1 roll /ashow 3 true lpexec } { OutFile null ne { dup dup length =string length gt { /show 1 false lpexec } { (S ) ws ws (\n) ws } ifelse } if show } ifelse } ifelse } { pop } ifelse} def/lpsetmyfont { dup load setfont OutFile null ne { cvx /setfont 1 false lpexec } { pop } ifelse} def
% Define some utility procedures.
/banner % ypos left center right
{ /HFont lpsetmyfont /addspace 0 def /addwidth 0 def /pairkern 0 dict def 3 -1 roll bannerstring pop 0 4 index pwidth showline2 pop exch bannerstring pwidth exch sub 2 div 3 index pwidth showline2 pop bannerstring % Prevent the last character of the heading from grazing
% the right margin.
% ****** WHY DOES IT REQUIRE SO MUCH PADDING? ******
( ) stringwidth pop 2 mul add pwidth exch sub 3 -1 roll pwidth showline2 pop } def
/bannerstring % string -> string width
{ PageNumberString search { exch pop pindex 4 string cvs concatstrings exch concatstrings } if dup stringwidth pop } def
/beginpage { /lindex 0 def /skipping pindex PageFirst ge pindex PageLast le and not def pagex pagey Landscape {/BL} {/B} ifelse 2 true lpexec /pagesave exch def skipping { nulldevice /OutFile null def } if Headers { lheight hdescent add HeadingLeft HeadingCenter HeadingRight banner } if /BFont lpsetmyfont /pairkern Kern def /addspace AddToSpace def /addwidth AddToWidth def pairkern length 0 ne { /addspace AddToSpace lpdef /addwidth AddToWidth lpdef } if } def
/endpage { lindex 0 ne { Footers { topskip plength sub hdescent add FootingLeft FootingCenter FootingRight banner } if /E } { /restore } ifelse pagesave exch 0 true lpexec /pindex pindex 1 add def} def
/endcolumn { lindex colines 1 sub add colines idiv colines mul dup llength ge { pop endpage beginpage } { /lindex exch def } ifelse } def
/fontheight % <font> fontheight <ascent> <height>
{ gsave setfont newpath 0 0 moveto (|^_j) false charpath pathbbox exch pop dup 2 index sub 4 -2 roll pop pop grestore exch 1.25 mul exch 1.25 mul } def
/wdict { dup length wosp ( dict\n) ws { (dup) ws exch wosp wosp ( put\n) ws } forall} def/wosp { ( ) ws wo } def/wo { dup type /dicttype eq { wdict } { OutFile exch write==only } ifelse} def/ws { OutFile exch writestring} def
/outfont { % <name> <font> outfont -
OutFile null ne { exch wo dup /FontName get dup wosp (-ISOLatin1) ws wosp ( RE) ws /FontMatrix get 0 get 1000 mul round cvi wosp ( scalefont def\n) ws } { pop pop }ifelse} def
/StringFF (\f) def/CharFF StringFF 0 get def/StringTAB (\t) def/CharTAB StringTAB 0 get def
/showline { % line -> leftover_line (handles \f)
{ showline1 dup length 0 eq { exit } if dup 0 get CharFF ne { Truncate { pop () } if exit } if EjectFF { endpage beginpage } { endcolumn } ifelse skip1 } loop} def
/showline1 % line -> leftover_line (handles page break)
{ lindex llength eq { endpage beginpage } if lindex colines idiv cowidth mul % x
lindex colines mod 1 add lheight mul neg fascent sub % y
1 index cowidth add showline2 /lindex lindex 1 add def } def
/setxy { /ty exch def /tx exch def} def
/showline2 { % string x y xlimit -> leftover_string (handles tabs)
2 index exch 5 2 roll setxy { % Stack: xinit xlimit string
showline3 dup length 0 eq { exit } if dup 0 get CharTAB ne { exit } if tx 3 index sub tabwx div 0.05 add ceiling tabwx mul 3 index add ty setxy skip1 tx 2 index ge { exit } if } loop exch pop exch pop} def
/showline3 { % xlimit string -> xlimit leftover_string
% (finds line break / tab / formfeed)
1 index tx sub cwx div 0.1 add cvi 0 .max 1 index length .min 1 index 0 3 -1 roll getinterval % look for \f or \t
StringFF search { exch pop exch pop } if StringTAB search { exch pop exch pop } if dup length 0 ne { tx ty lpmoveto dup pairkern length 0 eq { lpshow } { { kproc } exch /kshow 2 true lpexec } ifelse currentpoint setxy } if length dup 2 index length exch sub getinterval} def
/kproc { % <char1> <char2> kproc -
pairkern currentfont /Encoding get 3 index get 2 copy known { get currentfont /Encoding get 2 index get 2 copy known { get currentfont /FontMatrix get 0 get mul } { pop pop 0 } ifelse } { pop pop 0 } ifelse addwidth add 2 index 32 eq { addspace add } if dup 0 eq { pop } { 0 rmoveto } ifelse pop pop} def
/skip1 { dup length 1 sub 1 exch getinterval } def
/e== { % <object> e== - -- print an object to stderr
(%stderr) (w) file dup 3 -1 roll write==only flushfile} def
/eprint { % <string> eprint - -- print a string to stderr
(%stderr) (w) file dup 3 -1 roll writestring flushfile} def
% Read kerning information from a .AFM file.
/readkern { % <afmfile> readkern <pairkerndict>
/mfilename 1 index def (r) file /mfile exch def mfile =string readline pop (StartFontMetrics ) anchorsearch { pop pop /kdict 256 dict def { mfile =string readline pop (EndFontMetrics) anchorsearch { pop pop exit } if (KPX ) anchorsearch { pop token pop cvlit /char1 exch def token pop cvlit /char2 exch def token pop /kern exch def pop kdict char1 .knownget not { 5 dict kdict char1 2 index .growput } if char2 kern .growput } { pop } ifelse } loop kdict } { pop mfilename eprint ( does not begin with StartFontMetrics.\n) eprint 0 dict } ifelse mfile closefile} def
% The main printing procedure
/doFirst true def/prevBFont null def/prevHFont null def
/lpfirst { % - lpfirst -
% If writing to file we need to emit the definition of 'encoding' or it will
% produce non-working PostScript. If we are executing directly then encoding is
% already defined. This defines encoding as an array instead of a name, but it will work OK
% and avoids changing the /RE procedure.
OutFile null eq not { OutFile (/encoding /) writestring OutFile encoding 256 string cvs writestring OutFile ( /Encoding findresource def\n) writestring } if% Define some abbreviating procedures.
/B {save 3 1 roll translate /X 0 def} lpdef /BL {save 3 1 roll 90 rotate translate /X 0 def} lpdef /P {/setpagedevice where {pop % <key> <value> P
5 dict begin 2 copy def /Policies 2 dict dup 4 index 1 put def currentdict end setpagedevice } {pop pop} ifelse} lpdef /E {showpage restore} lpdef /V {neg X exch moveto} lpdef /M {/X 2 index def neg moveto} lpdef /S {currentfile =string readline pop show} lpdef /RE { % <isoname> <fontname> RE <font>
findfont %% reencode for current 'encoding' from the 2nd edition red book, sec 5.6.1
dup length dict begin {1 index /FID ne {def} {pop pop} ifelse} forall /Encoding encoding def currentdict end definefont } lpdef} def
/lp { % file initial_chars ->
/lpline exch def /lpfile exch def
doFirst { lpfirst /doFirst false def } if
% Initialize the device and fonts.
/BFont BodyFont null eq { defaultBodyFont } { BodyFont } ifelse def BFont prevBFont ne { /BFont BFont outfont /prevBFont BFont def } if Headers Footers or { /HFont HeadingFont null eq { defaultHeadingFont } { HeadingFont } ifelse def HFont prevHFont ne { /HFont HFont outfont /prevHFont HFont def } if } if save
% Get the layout parameters.
clippath gsave % for possible rotation
Landscape { 90 rotate } if BFont setfont ( ) stringwidth pop /cwx exch def cwx Tab mul /tabwx exch def BFont fontheight /fheight exch def /fascent exch def Headers Footers or { HFont fontheight } { 0 0 } ifelse /hheight exch def /hascent exch def /hdescent hheight hascent sub def fheight Spacing mul /lheight exch def Headers { hheight lheight add } { 0 } ifelse /topskip exch def Footers { hheight lheight add } { 0 } ifelse /botskip exch def /pskip topskip botskip add def % Translate the page so that (0,0) corresponds to
% the top of the topmost body line.
pathbbox 2 index sub MarginBottom MarginTop add sub /plength exch def 2 index sub MarginLeft MarginRight add sub /pwidth exch def pwidth Columns div /cowidth exch def exch MarginLeft add exch MarginBottom add plength add topskip sub /pagey exch def /pagex exch def plength pskip sub lheight div cvi MaxLines .min dup /colines exch def Columns mul /llength exch def grestore OutFile null ne { nulldevice } if
% Print layout
Noisy { (Page height = ) eprint llength e== (.\n) eprint flush } if
colines 1 lt cowidth 1 lt or { (Page too small, it must be large to hold at least one line of text\n) eprint (please specify a page size using for example -sPAPERSIZE=(a4|letter)\n) eprint /gslp.ps cvx /limitcheck signalerror } if
% Set duplex if requested.
Duplex null ne { /Duplex true /P 2 false lpexec /Tumble Duplex /P 2 false lpexec } if
% Write the kerning table, if relevant.
OutFile null ne Kern length 0 ne and { (/kproc) ws /kproc load wosp ( def\n) ws (/pairkern) ws Kern wosp ( def\n) ws } if
% Disable stack recording so we can use stopped with readline.
$error /recordstacks false put
% Initialize for the first page.
/lbuf 64000 string def /pindex 1 def beginpage
% Iterate through the file.
lpline % First handle new-lines in the initial string (--detect mode)
(\n) search { showline % output up to the first new-line
pop pop % done with that string and the new-line
(\n) search { showline % output the second new-line
pop pop % done
} if } if { dup length /pos exch def lbuf exch 0 exch putinterval { lpfile lbuf pos lbuf length pos sub getinterval readline } stopped { % Filled the line before a CR or EOF.
exch pop showline } { % Reached CR and/or EOF first.
exch length pos add lbuf exch 0 exch getinterval 1 index { showline } if % omit final empty line
{ dup length 0 eq { pop () exit } if showline } loop exch not { exit } if } ifelse pindex PageLast gt { exit } if } loop pop
% Wrap up.
%**************** WHY IS THIS COMMENTED OUT? ****************
% EjectEOF { endpage } { endcolumn } ifelse
endpage restore
} def
end
% Usage: <file> lp
% prints <file> using the current parameter settings.
% Usage: [ <arg1> ... <argn> ] lpcommand
% interprets args like a command line.
/lp { save lpdict begin () lp end restore } def
lpdict begin
/splitfn % (FontNN.NN) -> <font>
{ dup /arg exch def length { dup 0 le { exit } if dup 1 sub arg exch get dup 48 ge 1 index 59 le and exch 46 eq or not { exit } if 1 sub } loop arg exch 0 exch getinterval dup cvn find-latin-font exch arg exch anchorsearch pop pop cvr scalefont } def
% Parse the command line switches.
/doswitch % argn ... arg1 (-?) restofswitch ->
{ exch dup cvn lpdict exch known { cvn load exec } { exch pop (Unknown switch: ) eprint eprint (\n) eprint } ifelse } def
/more % argn ... arg1 restofswitch ->
{ dup length 0 ne { (- ) dup 1 3 index 0 get put exch dup length 1 sub 1 exch getinterval doswitch } { pop } ifelse } def
/-- { (--) exch concatstrings dup cvn lpdict exch known { cvn load exec } { (Unknown switch: ) eprint eprint (\n) eprint } ifelse } def/--add-to-space { cvr /AddToSpace exch def } def/--add-to-width { cvr /AddToWidth exch def } def/--columns { cvi 1 .max /Columns exch def } def/--detect { /DetectFileType true def } def/--duplex { /Duplex {Landscape} def } def/--duplex-long-edge { /Duplex false def } def/--duplex-short-edge { /Duplex true def } def/--encoding { cvn /encoding exch def %% If we changed the encoding, then we need to remake the default fonts with the correct encoding
/defaultBodyFontPortrait /Courier find-latin-font 10 scalefont def /defaultBodyFontLandscape /Courier find-latin-font 7 scalefont def /defaultBodyFont { Landscape { defaultBodyFontLandscape } { defaultBodyFontPortrait } ifelse } def} def/--first-page { cvi /PageFirst exch def } def/--footing-center { /FootingCenter exch def /Footers true def } def/--footing-left { /FootingLeft exch def /Footers true def } def/--footing-right { /FootingRight exch def /Footers true def} def/--heading-center { /HeadingCenter exch def /Headers true def } def/--heading-left { /HeadingLeft exch def /Headers true def } def/--heading-right { /HeadingRight exch def /Headers true def } def/--kern { readkern /Kern exch def } def/--last-page { cvi /PageLast exch def } def/--margin-bottom { cvr 72.0 mul /MarginBottom exch def } def/--margin-left { cvr 72.0 mul /MarginLeft exch def } def/--margin-right { cvr 72.0 mul /MarginRight exch def } def/--margin-top { cvr 72.0 mul /MarginTop exch def } def/--no-eject-file { /EjectEOF false def } def/--no-eject-formfeed { /EjectFF false def } def/--spacing { cvr /Spacing exch def } def
/-# { pop } def % ignore
/-+ { -- } def(-1)cvn { /Columns 1 def more } def(-2)cvn { /Columns 2 def more } def/-b { /HeadingLeft exch def /HeadingCenter () def /HeadingRight PageNumberString def /Headers true def /break true def } def/-B { /HeadingLeft () def /HeadingCenter () def /HeadingRight () def /Headers false def /FootingLeft () def /FootingCenter () def /FootingRight () def /Footers false def /break true def more } def/-C { pop } def % ignore
/-c { /Truncate true def more } def/-d { pop } def % ignore
/-f { splitfn /BodyFont exch def } def/-F { splitfn /HeadingFont exch def } def/-G { more } def % ignore
/-g { more } def % ignore
/-h { more } def % ignore
/-J { pop } def % ignore
/-K { more } def % ignore
/-k { more } def % ignore
/-l { 66 -L -B } def/-L { cvi /MaxLines exch def } def/-m { more } def % ignore
/-n { pop } def % ignore
/-o { more } def % ignore
/-p { (w) file /OutFile exch def OutFile (%!\n) writestring } def/-P { pop } def % ignore
/-q { /Noisy false def more } def/-r { /Landscape true def more } def/-R { /Landscape false def more } def/-S { pop } def % ignore
/-s { pop } def % ignore
/-T { cvi /Tab exch def } def/-v { pop } def % ignore
/-w { more } def % ignore
/lp1 % filename ->
{ break not { dup /HeadingLeft exch def } if Noisy { (Printing ) eprint dup eprint (\n) eprint } if (r) file % If requested, check for a PostScript file.
DetectFileType { dup 2 string readstring pop dup (%!) eq { % Yes, it's a PostScript file.
pop dup 80 string readline pop pop cvx exec } { lp } ifelse } { () lp } ifelse } bind def
/lpcstring 8192 string def
end
/lpcommand % <[arg1 ... argn]> lpcommand <any_printed>
{ % Push the commands on the stack in reverse order
mark exch dup length 1 sub -1 0 { 1 index exch get exch } for pop lpdict begin /any false def /break false def { dup mark eq { pop exit } if dup length 2 ge { dup 0 get (-) 0 get eq } { false } ifelse { dup 0 2 getinterval exch dup length 2 sub 2 exch getinterval doswitch } { dup /matched false def { /matched true def /any true def lp1 } lpcstring filenameforall matched { pop } { lp1 } ifelse % let the error happen
} ifelse } loop OutFile null ne { OutFile (%stdout) (w) file ne { OutFile closefile } if /OutFile null def } if any end } def
[ .shellarguments { ] dup length 0 ne { lpcommand } { false } ifelse not { (%stderr) (w) file [ (Usage: ) /PROGNAME where { pop PROGNAME } { (gslp) } ifelse ( [-12BclqRr] [-b<header>] [-f<font>] [-F<hfont>]\n) ( [-L<lines>] [-p<outfile>] [-T<tabwidth>]\n) ( [--add-to-(space|width) <units>] [--columns <n>]\n) ( [--detect] [--first-page <page#>] [--last-page <page#>]\n) ( [--(heading|footing)-(left|right|center) <string>]\n) ( [--kern <afmfile>] [--margin-(top|bottom|left|right) <inches>]\n) ( [--no-eject-(file|formfeed)] [--spacing <n>] file1 ... filen\n) ] { 2 copy writestring pop } forall dup flushfile closefile } if } { pop }ifelse
|
