download(1) [opensolaris man page]
download(1) User Commands download(1) NAME
download - host resident PostScript font downloader SYNOPSIS
download [-f] [-p printer] [-m name] [-H directory] [file]... /usr/lib/lp/postscript/download DESCRIPTION
download prepends host resident fonts to files and writes the results on the standard output. If no files are specified, or if - is one of the input files, the standard input is read. download assumes the input files make up a single PostScript job and that requested fonts can be included at the start of each input file. Requested fonts are named in a comment (marked with %%DocumentFonts:) in the input files. Available fonts are the ones listed in the map table selected using the -m option. The map table consists of fontname-file pairs. The fontname is the full name of the PostScript font, exactly as it would appear in a %%Doc- umentFonts: comment. The file is the pathname of the host resident font. A file that begins with a / is used as is. Otherwise the pathname is relative to the host font directory. Comments are introduced by % (as in PostScript) and extend to the end of the line. The only candidates for downloading are fonts listed in the map table that point download to readable files. A font is downloaded once, at most. Requests for unlisted fonts or inaccessible files are ignored. All requests are ignored if the map table can not be read. OPTIONS
-f Force a complete scan of each input file. In the absence of an explicit comment pointing download to the end of the file, the default scan stops immediately after the PostScript header comments. -p printer Check the list of printer-resident fonts in /etc/lp/printers/printer/residentfonts before downloading. -m name Use name as the font map table. A name that begins with / is the full pathname of the map table and is used as is. Other- wise name is appended to the pathname of the host font directory. -H directory Use dir as the host font directory. The default is /usr/lib/lp/postscript. EXAMPLES
Example 1 Examples of the download command. The following map table could be used to control the downloading of the Bookman font family: % % The first string is the full PostScript font name. The second string % is the file name - relative to the host font directory unless it begins % with a /. % Bookman-Light bookman/light Bookman-LightItalic bookman/lightitalic Bookman-Demi bookman/demi Bookman-DemiItalic bookman/demiitalic Using the file myprinter/map (in the default host font directory) as the map table, you could download fonts by issuing the following command: example% download -m myprinter/map file EXIT STATUS
The following exit values are returned: 0 Successful completion. non-zero An error occurred. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWpsf | +-----------------------------+-----------------------------+ SEE ALSO
dpost(1), postdaisy(1), postdmd(1), postio(1), postmd(1), postprint(1), posttek(1), attributes(5) NOTES
The download program should be part of a more general program. download does not look for %%PageFonts: comments and there is no way to force multiple downloads of a particular font. Using full pathnames in either map tables or the names of map tables is not recommended. SunOS 5.11 9 Sep 1996 download(1)
Check Out this Related Man Page
dpost(1) User Commands dpost(1) NAME
dpost - troff postprocessor for PostScript printers SYNOPSIS
dpost [-c num] [-e num] [-m num] [-n num] [-o list] [-w num] [-x num] [-y num] [-F dir] [-H dir] [-L file] [-O] [-T name] [file...] /usr/lib/lp/postscript/dpost DESCRIPTION
dpost translates files created by troff(1) into PostScript and writes the results on the standard output. If no files are specified, or if - is one of the input files, the standard input is read. The files should be prepared by troff. The default font files in /usr/lib/font/devpost produce the best and most efficient output. They assume a resolution of 720 dpi, and can be used to format files by adding the -Tpost option to the troff call. Older versions of the eqn and pic preprocessors need to know the resolution that troff will be using to format the files. If those are the versions installed on your system, use the -r720 option with eqn and -T720 with pic. dpost makes no assumptions about resolutions. The first x res command sets the resolution used to translate the input files, the DESC.out file, usually /usr/lib/font/devpost/DESC.out, defines the resolution used in the binary font files, and the PostScript prologue is respon- sible for setting up an appropriate user coordinate system. OPTIONS
-c num Print num copies of each page. By default only one copy is printed. -e num Sets the text encoding level to num. The recognized choices are 0, 1, and 2. The size of the output file and print time should decrease as num increases. Level 2 encoding will typically be about 20 percent faster than level 0, which is the default and produces output essentially identical to previous versions of dpost. -m num Magnify each logical page by the factor num. Pages are scaled uniformly about the origin, which is located near the upper left corner of each page. The default magnification is 1.0. -n num Print num logical pages on each piece of paper, where num can be any positive integer. By default, num is set to 1. -o list Print those pages for which numbers are given in the comma-separated list. The list contains single numbers N and ranges N1-N2. A missing N1 means the lowest numbered page, a missing N2 means the highest. The page range is an expression of log- ical pages rather than physical sheets of paper. For example, if you are printing two logical pages to a sheet, and you specified a range of 4, then two sheets of paper would print, containing four page layouts. If you specified a page range of 3-4, when requesting two logical pages to a sheet; then only page 3 and page 4 layouts would print, and they would appear on one physical sheet of paper. -p mode Print files in either portrait or landscape mode. Only the first character of mode is significant. The default mode is por- trait. -w num Set the line width used to implement troff graphics commands to num points, where a point is approximately 1/72 of an inch. By default, num is set to 0.3 points. -x num Translate the origin num inches along the positive x axis. The default coordinate system has the origin fixed near the upper left corner of the page, with positive x to the right and positive y down the page. Positive num moves everything right. The default offset is 0 inches. -y num Translate the origin num inches along the positive y axis. Positive num moves text up the page. The default offset is 0. -F dir Use dir as the font directory. The default dir is /usr/lib/font, and dpost reads binary font files from directory /usr/lib/font/devpost. -H dir Use dir as the host resident font directory. Files in this directory should be complete PostScript font descriptions, and must be assigned a name that corresponds to the appropriate two-character troff font name. Each font file is copied to the output file only when needed and at most once during each job. There is no default directory. -L file Use file as the PostScript prologue which, by default, is /usr/lib/lp/postscript/dpost.ps. -O Disables PostScript picture inclusion. A recommended option when dpost is run by a spooler in a networked environment. -T name Use font files for device name as the best description of available PostScript fonts. By default, name is set to post and dpost reads binary files from /usr/lib/font/devpost. EXAMPLES
Example 1: Examples of the dpost command. If the old versions of eqn and pic are installed on your system, you can obtain the best possible looking output by issuing a command line such as the following: example% pic -T720 file | tbl | eqn -r720 | troff -mm -Tpost | dpost Otherwise, example% pic file | tbl | eqn | troff -mm -Tpost | dpost should give the best results. EXIT STATUS
The following exit values are returned: 0 Successful completion. non-zero An error occurred. FILES
/usr/lib/font/devpost/*.out /usr/lib/font/devpost/charlib/* /usr/lib/lp/postscript/color.ps /usr/lib/lp/postscript/draw.ps /usr/lib/lp/postscript/forms.ps /usr/lib/lp/postscript/ps.requests /usr/lib/macros/pictures /usr/lib/macros/color ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWpsf | +-----------------------------+-----------------------------+ SEE ALSO
download(1), postdaisy(1), postdmd(1), postio(1), postmd(1), postprint(1), postreverse(1), posttek(1), troff(1), attributes(5) NOTES
Output files often do not conform to Adobe's file structuring conventions. Piping the output of dpost through postreverse(1) should produce a minimally conforming PostScript file. Although dpost can handle files formatted for any device, emulation is expensive and can easily double the print time and the size of the output file. No attempt has been made to implement the character sets or fonts available on all devices supported by troff. Missing charac- ters will be replaced by white space, and unrecognized fonts will usually default to one of the Times fonts (that is, R, I, B, or BI). An x res command must precede the first x init command, and all the input files should have been prepared for the same output device. Use of the -T option is not encouraged. Its only purpose is to enable the use of other PostScript font and device description files, that perhaps use different resolutions, character sets, or fonts. Although level 0 encoding is the only scheme that has been thoroughly tested, level 2 is fast and may be worth a try. SunOS 5.10 9 Sep 1996 dpost(1)