diff options
Diffstat (limited to 'obsolete/macros/inrstex/inrsdoc/thpagsiz.tex')
-rw-r--r-- | obsolete/macros/inrstex/inrsdoc/thpagsiz.tex | 156 |
1 files changed, 156 insertions, 0 deletions
diff --git a/obsolete/macros/inrstex/inrsdoc/thpagsiz.tex b/obsolete/macros/inrstex/inrsdoc/thpagsiz.tex new file mode 100644 index 0000000000..460fee3027 --- /dev/null +++ b/obsolete/macros/inrstex/inrsdoc/thpagsiz.tex @@ -0,0 +1,156 @@ +%-*-tex-*- +\ifundefined{writestatus} \input status \relax \fi % +\chcode{pagsiz} + +\def\cqu{\cquote{It is when I am struggling to be brief that +I become unintelligible.}{Ars Poetica, Horace (65-8~BC)} +} + +\chapterhead{pagsiz}{PAGES:\cr SIZES\cr MAGNIFICATION} +\intex\ has a number of page size parameters that are set to make the output +possible on different devices, and to facilitate special formats. +All page size +parameter changes are made in assignment fashion with an optional |[=]| sign. +All page size changes must be made inside a +\@|\documentstyle| list in order to insure that they take effect. +Figure~\ref{pagdiag} diagrams the various dimensions. + +\input pagdiag +\beginpageinsert +\figureform{pagdiag}{Diagram of the various page dimensions.\captionbody{ + The actual printing area is determined by the computed dimensions +{\tt \1hinnerpagesize} and {\tt \1vinnerpagesize}. The {\tt outer} dimensions +are normally specified. The {\tt \1firstcolumnoffset} is normally +0pt.}}{\centergraph{ \pagdiag sc:.8 }} +\endpageinsert + +\shead{pagecomlist}{Command List} +\beginthreecolumn +\hfuzz=20pt +\ext\@|\documentstyle| +\ext\@|\houterpagesize| +\ext\@|\hpapersize| +\ext\@|\leftmarginsize| +\ext\@|\leftmarginskip| +\pri|\mag| +\pla|\magstep| +\ext\@|\topmarginsize| +\ext\@|\topmarginskip| +\ext\@|\vouterpagesize| +\ext\@|\vpapersize| +\endthreecolumn + +\shead{pagesandmargins}{Page Size Setting and Margins} +These commands define and set the various page sizes. Only the |outer| and +|header|, and |paper| commands should be changed. +\intex\ also has some |inner| and |column| sizes. These are computed and +should not be modified -- although they are accessible. See +Section~{\ref{inner}}, page \pref{inner} for details. +{\bf All dimension changes must be made inside a |\documentstyle| command or +they will not necessarily take effect.} + +This section details the various parameters used to +name and describe the parts of the printed page that can be varied. +The general convention is that |\h<name>| names a horizontal dimension +and |\v<name>| names the corresponding vertical dimension. The various +|<name>|s are +\bshortcomlist +|outerpagesize|&{this is the extent of the area allowed + for printing. It includes all headers, + footers, footnotes \dots\ + \@|\vouterpagesize| and \@|\houterpagesize| + are the vertical and horizontal + forms}\cr +|papersize|&{this is the ``physical'' size of the paper and includes all + the |outerpagesizes| plus + margins. The actual + vertical extent of the paper + is \@|\vpapersize| and + the actual width of the + paper is is the size of \@|\hpapersize|. +The default values are correct for +11in by 8.5in paper but must be increased for +14in by 8.5in (Legal size) paper.}\cr +\@|\vsize|&the actual verticalsize of the present page. This is set at the time when the +first material is submitted for putting on the page. In \intex\ it is usually +the |\vcolumnsize|. It should be changed only with knowledge.\cr +\@|\hsize|&the actual horizontal size of the present {\bf box} in which \tex\ is +working. This may be a page or some box that is to be eventually placed on +the page. +This is set at the time when +first material is submitted for putting on the page. In \intex\ |\hsize| is +usually +the |\hcolumnsize|. \cr + +\eshortcomlist + +Assignments are made in the normal way. The general form is + +\@|\<dimen name> [=] <dimen>| +\noindent +where |<dimen>| is a dimension. Thus the papersize, margins, +and outer page sizes are set in \intex\ by +\begintt +\documentstyle{\vpapersize = 11in + \hpapersize = 8.5in + \vouterpagesize=9in + \houterpagesize=6.5in + \leftmarginsize=1.25in + \topmarginsize=1in} +\endtt +These values are actually set for the paper style in {\tt papersty.tex}. + +\shead{magnification}{Magnification} +\tex\ is able to magnify an entire document through its +|\magnification| parameter. The form is +\beginblockmode +\mbr +\pri\@|\mag [=] <1000 times scale factor>| +\nbr +The document is magnified by the |<scale factor>|, times any |texprint| +magnification. It can appear only once and should appear at the beginning of +the document. {\bf It should be used with extreme caution. The results may +be too big for the output device.} The {\it plain} form |\magnification| has +been defined to be the same as |\mag|. The reason is that |\magnification| in +{\it plain} also sets page sizes which is inappropriate here. \TeX Graph will +scale correctly when using |\mag|. + +\mbr +\pri\@|\magstep<integer>| +\nbr +This is a valid magnification scaling for the |\magnification| command. The +actual magnification is $1.2^{\langle{\rm integer}\rangle}$. +Thus |<integer>=3| implies a +magnification of 1.728. +\endblockmode + +In fact there are two points at which +magnification can occur. The first is in the \tex\ document and the second is +when it is printed. All that is important is the final magnification. A +magnified document may be printed only if all the fonts are available at the +magnifications requested. In general, magnification should be controlled by +\intex\ so that \TeX Graph will operate correctly. + +\shead{inner}{Internal and Computed Sizes} +\intex\ is actually in multicolumn mode at all times. The default though is +just one column. In order to live in this world \intex\ understands |inner| +and |column| sizes. The |column| sizes are the actual sizes that are used to +for the text. The |inner| horizontal size is the sum of the column widths and +the intercolumn spacing. To this is added a \@|\leftcolumnoffset| (twice) to +obtain the |\houterpagesize|. Normally the |\leftcolumnoffset| is zero. The +effect of a left column offset is to inset the pages with respect to the +header/footer boxes whose width is the |\houterpagesize|. Thus + +\bshortcomlist +|columnsize|&this is the actual size of the column + where the text is printed. Footnotes + are inside the column. In single + column format columnsize and innerpagesize + are the same + (\@|\vcolumnsize|, \@|\hcolumnsize|) \cr +|innerpagesize|&this is the size of the page left after + the headers and footers have been removed + (\@|\vinnerpagesize|, \@|\hinnerpagesize|) \cr +\eshortcomlist +\ejectpage +\done |