summaryrefslogtreecommitdiff
path: root/dviware/dvitops/dvitops.1
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /dviware/dvitops/dvitops.1
Initial commit
Diffstat (limited to 'dviware/dvitops/dvitops.1')
-rw-r--r--dviware/dvitops/dvitops.1398
1 files changed, 398 insertions, 0 deletions
diff --git a/dviware/dvitops/dvitops.1 b/dviware/dvitops/dvitops.1
new file mode 100644
index 0000000000..bc55ac49e2
--- /dev/null
+++ b/dviware/dvitops/dvitops.1
@@ -0,0 +1,398 @@
+'\" e
+.\" $Header: /usr/jjc/dvitops/RCS/dvitops.1,v 1.5 90/08/14 13:31:17 jjc Rel $
+.TH DVITOPS L
+.SH NAME
+dvitops \- convert the output of TeX to PostScript
+.SH SYNOPSIS
+.B dvitops
+[
+.B \-qrs
+] [
+.BI \-c ncopies
+] [
+.BI \-f firstpage
+] [
+.BI \-n npages
+]
+.if n .ti +0.5i
+[
+.BI \-m magnification
+] [
+.BI \-y kmem
+] [
+.BI \-h hoffset
+]
+.if n .ti +0.5i
+.if t .ti +0.5i
+[
+.BI \-v voffset
+] [
+.BI \-p papersize
+] [
+.BI \-d dpi
+] [
+.I dvifile
+]
+.SH DESCRIPTION
+.B dvitops
+converts a dvi file produced by TeX into PostScript.
+If the
+.I dvifile
+argument is not present,
+.B dvitops
+reads the standard input. In this case the standard input must be a file
+rather than a pipe.
+The extension
+.B .dvi
+may be omitted.
+The output is written on the standard output, and is normally piped
+into
+.BR lpr .
+Either bitmap fonts in pk format, or ordinary PostScript fonts
+may be used. If PostScript fonts are used which are not
+resident in the printer, the output of
+.B dvitops
+must be passed through a filter or spooler that can handle
+font downloading.
+.SH OPTIONS
+.TP
+.B \-q
+Quiet mode. Don't print the numbers of pages as they are printed.
+.TP
+.B \-r
+Output pages in reverse order.
+.TP
+.B \-s
+Sort pages by their
+.B \ecount0
+values.
+.TP
+.BI \-c ncopies
+Print
+.I ncopies
+of each page. The copies will not be collated. The default is 1.
+.TP
+.BI \-f firstpage
+The first page to be output will be
+.I firstpage.
+This is specified in the same way as in
+.BR dvitype :
+a sequence of one to ten numbers or asterisks separated by periods.
+For example,
+.B \-1.*.3
+will match the first page whose
+.B \ecount0
+value is \-1, and whose
+.B \ecount2
+value is 3. The default is
+.BR * ,
+which will match any page.
+.TP
+.BI \-n npages
+Output at most
+.I npages
+pages. The default is a large number.
+.TP
+.BI \-m magnification
+Replace the magnification in the input file by
+.IR magnification .
+A magnification of 1000 means no magnification; a magnification to 2000
+means magnification by a factor of 2.
+.TP
+.BI \-y kmem
+Use at most
+.IR kmem k
+bytes of printer memory for preloading bitmap fonts.
+In order to improve performance,
+.B dvitops
+puts the bitmap fonts that are most used in the document at the
+beginning of the output; other fonts have to be output for each page
+on which they are used. The default value is 100, which is suitable for
+the oldest PostScript printers. Newer printers with more memory will
+give better performance with a higher value.
+.TP
+.BI \-h hoffset
+Position the left hand edge of the output
+.I hoffset
+away from the left edge of the paper.
+.I hoffset
+is given as a number with an optional decimal point followed by one
+of the units of measure recognised by TeX.
+The default value is 1 inch, which is the value assumed by most macro
+packages.
+.TP
+.BI \-v voffset
+Position the top edge of the output
+.I voffset
+away from the top edge of the paper.
+.I voffset
+is given as a number with an optional decimal point followed by one
+of the units of measure recognised by TeX.
+The default value is 1 inch, which is the value assumed by most macro
+packages.
+.TP
+.BI \-p papersize
+Produce output suitable for
+.I papersize
+paper.
+.I papersize
+is one of the standard PostScript paper types:
+.BR a4 ,
+.BR letter ,
+.BR legal ,
+.BR b5 ,
+.BR b4 ,
+.BR tabloid ,
+.BR ledger ,
+.BR statement ,
+.BR executive ,
+.BR a3 ,
+.BR a5 ,
+.BR folio ,
+.B quarto
+or
+.BR 10x17 .
+The default is
+.BR letter .
+.B dvitops
+uses the paper dimensions to position the output correctly.
+Non-standard paper sizes can be accommodated using the
+.B \-h
+or
+.B \-v
+options.
+.TP
+.BI \-d dpi
+Choose bitmap fonts suitable for a printer with a resolution
+of
+.I dpi
+dots per inch. The default is 300.
+.SH USAGE
+.B dvitops
+supports the use of TeX's
+.B \especial
+primitive to take advantage of some of PostScript's advanced facilities.
+.B dvitops
+recognises only
+.B \especial
+commands whose arguments start with a
+.B dvitops:\&
+tag.
+The following
+.B \especial
+commands are available:
+.TP
+\fB\especial{dvitops: landscape}\fP
+Print the current page in landscape mode,
+with its top along the long side of the paper.
+.TP
+\fB\especial{dvitops: import \fIfilename width height \
+\fR[ \fIoption\fR\|.\|.\|. ] \fB}\fR
+This is used to include a picture in the output.
+.I filename
+must contain PostScript code.
+The picture will be positioned with its
+lower left hand corner at the current position.
+The
+.I width
+and
+.I height
+arguments
+give the desired height and width of the illustration in the output;
+these are given as numbers with an optional decimal point followed
+by one of the units of measure recognised by TeX.
+.B dvitops
+will scale the picture to fit this space.
+Usually
+.B dvitops
+will scale the picture by the same amount vertically as horizontally,
+so that the picture retains its original proportions, and
+will center the picture in any surplus horizontal or vertical white space.
+An option of
+.BR top ,
+.BR bottom ,
+.B left
+or
+.B right
+will cause the picture to be positioned at the top, bottom, left or
+right of the specified space, rather than being centered.
+An option of
+.B fill
+will cause the picture to be scaled to fit the specified space both
+horizontally and vertically. The imported file must
+comply with the Adobe Document Structuring Conventions. In particular
+it must contain a
+.B %%BoundingBox:
+comment in an appropriate place. Additionally, the file should
+comply with the guidelines given in the specification of EPSF
+(Encapsulated PostScript Format). A file beginning with the line
+.br
+.B "%!PS-Adobe-2.0 EPSF-1.2"
+.br
+is likely to meet these requirements.
+.TP
+\fB\especial{dvitops: inline \fIanything\fB}\fR
+Include the arbitrary PostScript code
+.I anything
+in the output.
+When this code is executed, the coordinate system in effect will
+be TeX's: units are scaled points (65536 in a point) with the origin
+1 inch down from and 1 inch to the right of the top left corner of
+the page; currentpoint will be set to the currrent position
+in the dvi file. All
+.B inline
+commands occurring on a given page will be collected together and output
+at the end of page in the order in which they appeared.
+.TP
+\fB\especial{dvitops: prolog \fIfilename\fB}\fR
+Make the PostScript definitions contained in
+.I filename
+available at this point in the file.
+An extension of
+.B .ps
+may be omitted from
+.IR filename .
+This command is intended for use with the
+.B inline
+command. The
+.B inline
+command should be used simply to invoke procedures defined in other files
+and made available by the
+.B prolog
+command.
+The
+.B prolog
+command must be given at each place that the definitions that it contains
+are required. This ensures that the definitions will be available even
+if not all pages are output. The file will be downloaded at most once,
+however many times it appears.
+.TP
+\fB\especial{dvitops: begin \fIregion\fB}\fR
+.PD 0
+.TP
+\fB\especial{dvitops: end}\fR
+Delimit a region of the dvi file to which
+some geometric transformation is to be applied; the
+.I region
+argument serves to identify the region.
+Regions cannot be nested, nor can they extend over more than one
+output page. There can be multiple
+.B begin
+and
+.B end
+commands for each region.
+.PD
+.TP
+\fB\especial{dvitops: origin \fIregion\fB}\fR
+Make the current position the origin for transformations to be applied to
+.IR region .
+By default the origin is TeX's origin, 1 inch down from and 1 inch to
+the right of the top left hand corner of the page.
+.TP
+\fB\especial{dvitops: rotate \fIregion \(*h\fB}\fR
+Rotate
+.I region
+clockwise about its origin by \(*h degrees.
+.TP
+\fB\especial{dvitops: transform \fIregion a b c d\fB}\fR
+Apply the affine transformation represented by the matrix
+.EQ
+left [ matrix {
+ccol { a above c }
+ccol { b above d }
+} right ].
+.EN
+to
+.IR region .
+Arbitrarily many transformations may be applied to each region.
+They will be applied in the order in which they are given.
+.TP
+\fB\especial{dvitops: gray \fIregion shade\fB}\fR
+Use the gray shade corresponding to
+.IR shade ,
+which must be a number between 0 and 1, for
+.IR region .
+0 corresponds to black and 1 corresponds to white.
+.TP
+\fB\especial{dvitops: rgbcolor \fIregion red green blue\fB}\fR
+Use the color described by the parameters
+.IR red ,
+.IR green ,
+and
+.IR blue ,
+each of which must be numbers between 0 and 1, for
+.IR region .
+.TP
+\fB\especial{dvitops: hsbcolor \fIregion hue saturation brightness\fB}\fR
+Use the color described by the parameters
+.IR hue ,
+.IR saturation ,
+and
+.IR brightness ,
+each of which must be numbers between 0 and 1, for
+.IR region .
+.SH ENVIRONMENT
+.B dvitops
+uses various environment variables in order to find the files
+it requires. They each contain lists separated by colons.
+.TP 15
+.B
+.SM TEXINPUTS
+A list of directories in which to search for text input files.
+.TP
+.B
+.SM TEXFONTS
+A list of directories in which to search for tfm files.
+.TP
+.B
+.SM TEXPK
+A list of prototypes of names of pk files.
+When a particular font is being searched for, a
+.B %d
+in the prototype will be replaced by the magnification of
+the font in dots per inch, and a
+.B %f
+will be replaced by the name of the font.
+.TP
+.B
+.SM TEXMAGS
+A list of all the magnifications for which there is some pk file.
+The magnifications are expressed in dots per inch.
+.B dvitops
+will only look for pk files at these magnifications. If a font
+is required at some other magnification, a scaled version of the
+font at one of the listed magnifications will be used.
+.TP
+.B
+.SM DVITOPS
+The value of this variable will be interpreted as if it had been typed in
+at the beginning of the command line. For example, if it is set to
+.B \-r
+all output from
+.B dvitops
+will appear in reverse order (unless overridden by a second occurrence of
+.BR \-r ).
+.SH FILES
+.PD 0
+.TP 30
+.B /usr/local/tex/inputs/dvitops.pro
+PostScript definitions used by dvitops
+.TP
+.B /usr/local/tex/input/dvitops.fnt
+list of the TeX and PostScript names of PostScript fonts
+.TP
+.B /usr/local/tex/pk/*.*pk
+pk files
+.TP
+.B /usr/local/tex/fonts/*.tfm
+tfm files
+.TP
+.B /usr/local/tex/fonts/*.enc
+encoding files
+.PD
+.SH "SEE ALSO"
+.LP
+.\" IR "DVITOPS User Manual" ,
+.BR tex (L)
+.SH AUTHOR
+James Clark <jjc@jclark.uucp>