diff options
author | Karl Berry <karl@freefriends.org> | 2009-11-27 18:53:34 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2009-11-27 18:53:34 +0000 |
commit | b2ca732dee27faa563c88f7bbb49f0b86f76d4ed (patch) | |
tree | cfb6d63ffddbc61149bd840522fb57304943b4f9 /Master/texmf-dist/tex/latex/relsize | |
parent | 4e77d990cd9e623c9db4b4bd9a8a0fff579057b8 (diff) |
separate relsize into its own package
git-svn-id: svn://tug.org/texlive/trunk@16203 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/tex/latex/relsize')
-rw-r--r-- | Master/texmf-dist/tex/latex/relsize/relsize.sty | 393 |
1 files changed, 393 insertions, 0 deletions
diff --git a/Master/texmf-dist/tex/latex/relsize/relsize.sty b/Master/texmf-dist/tex/latex/relsize/relsize.sty new file mode 100644 index 00000000000..febbf0ac7a8 --- /dev/null +++ b/Master/texmf-dist/tex/latex/relsize/relsize.sty @@ -0,0 +1,393 @@ +% relsize.sty 3.1 July 4, 2003 +% This software is contributed to the public domain. + +% LaTex2e version by Donald Arseneau <asnd@triumf.ca> and +% Matt Swift <swift@bu.edu>. +% Original LaTex2.09 smaller.sty author: Bernie Cosell <cosell@WILMA.BBN.COM> +% +% Setting the font size relative to the current size +% +% commands are: +% \relsize{n} where n gives the number of steps ("mag-step" = factor of 1.2) +% to change the size by; n = 3 changes from \normalsize to +% \LARGE size. Negative n selects smaller fonts. +% \smaller == \relsize{-1} +% \larger == \relsize{1} +% \textsmaller{text}, \textlarger{text} - versions that take an argument +% +% \relscale{f} is equivalent to \relsize, but instead of scale-steps, +% the parameter is a scale factor, such as .75 +% \textscale{f}{text} +% +% The font-size command nearest the requested size will be used, and if +% the size error is more than \RSpercentTolerance, then the size will +% be adjusted more precisely. (The default empty \RSpercentTolerance +% signals automatic handling, choosing the tolerance based on the +% font declarations.) +% +% \mathsmaller{A}, \mathlarger{B} - math versions +% (The math versions are entirely different from the text versions.) +% +% There are more instructions at the end of this file (after \endinput). + +\ProvidesPackage{relsize}[2003/07/04 ver 3.1] + +% The next two aren't the real initializations! The real ones are done +% in \@tempb below. The user can change them afterwards. + +\def\RSsmallest{999pt} +\def\RSlargest{1pt} + +% First, right now, we assemble a list of the font sizes + +\def\rs@size{\noexpand\rs@size\noexpand} +\def\rs@fontsizes{} +\def\@tempa#1{\ifx\@undefined#1\else + \expandafter\@tempb#1\delimiter{#1}\fi} +\def\@absVal#1{\ifnum#1<\z@-\fi#1} +% parse definition of font-size command (like \large) +% #1 = \@setfontsize #2 = the command (\large) #3 = size #4 = rest +\def\@tempb#1#2#3#4\delimiter#5{% + \@tempdimb\z@ + \ifx\@setfontsize#1\relax\ifx#5#2\@firstofone\relax + \afterassignment\strip@prefix \@tempdimb #3pt>% + \fi\fi + \ifdim\@tempdimb=\z@ + \def\rs@fontsizes{}% + \let\@tempa\@gobble + \else + \edef\rs@fontsizes{\rs@fontsizes\rs@size#2{\the\@tempdimb}}% + \ifdim\@tempdimb<\RSsmallest \edef\RSsmallest{\the\@tempdimb}\fi + \ifdim\@tempdimb>\RSlargest \edef\RSlargest{\the\@tempdimb}\fi + \fi} + +% examine each (expected) pre-defined font size +\@tempa\normalsize +\@tempa\small +\@tempa\footnotesize +\@tempa\large +\@tempa\Large +\@tempa\LARGE +\@tempa\scriptsize +\@tempa\tiny +\@tempa\huge +\@tempa\Huge +\@tempa\HUGE % moresize.sty +\@tempa\ssmall + +\ifx\rs@fontsizes\@empty % ---------------------------------------------- + +\PackageWarning{relsize}{Failed to get list of font sizes.\MessageBreak + Falling back to old definition.} + +\DeclareRobustCommand\relsize[1]{% +\ifmmode \@nomath\relsize\else + \begingroup + \@tempcnta % assign number representing current font size + \ifx\@currsize\normalsize 4\else % funny order is to have most ... + \ifx\@currsize\small 3\else % ...likely sizes checked first + \ifx\@currsize\footnotesize 2\else + \ifx\@currsize\large 5\else + \ifx\@currsize\Large 6\else + \ifx\@currsize\LARGE 7\else + \ifx\@currsize\scriptsize 1\else + \ifx\@currsize\tiny 0\else + \ifx\@currsize\huge 8\else + \ifx\@currsize\Huge 9\else + 4\rs@unknown@warning % unknown state: \normalsize as starting point + \fi\fi\fi\fi\fi\fi\fi\fi\fi\fi +% Change the number by the given increment: + \advance\@tempcnta#1\relax +% watch out for size underflow: + \ifnum\@tempcnta<\z@ \rs@size@warning{small}{\string\tiny}\@tempcnta\z@ \fi + \expandafter\endgroup + \ifcase\@tempcnta % set new size based on altered number + \tiny \or \scriptsize \or \footnotesize \or \small \or \normalsize \or + \large \or \Large \or \LARGE \or \huge \or \Huge \else + \rs@size@warning{large}{\string\Huge}\Huge +\fi\fi} + +\else % ---------------------------------------------- + +\DeclareRobustCommand\relsize[1]{% +\ifmmode \@nomath\relsize\else + \begingroup + % number of demi-magsteps -> \@tempcnta + \@tempdima#1\p@ \@tempdima2.0002\@tempdima \divide\@tempdima\p@ + \@tempcnta\@tempdima + % \message{^^JChange \the\@tempcnta\space half-magsteps from \f@size. }% + % calculate desired target size -> \@tempdimb + \@tempdimb\f@size\p@ + \ifnum\@tempcnta<\z@ + \def\@tempa{.912871}\@tempcnta=-\@tempcnta + \else + \def\@tempa{1.09545}% + \fi + \@whilenum {\@tempcnta>\z@}\do {% + \advance\@tempcnta\m@ne + \@tempdimb\@tempa\@tempdimb}% + % \message{ target size \the\@tempdimb. }% + \rs@scaleToB +\fi} + +\DeclareRobustCommand\relscale[1]{% +\ifmmode \@nomath\relscale\else + \begingroup + \@tempdimb\f@size\p@ \@tempdimb#1\@tempdimb + \rs@scaleToB +\fi} + +\DeclareRobustCommand\textscale[2]{\leavevmode + \begingroup\relscale{#1}#2\endgroup} + +% Change font size to \@tempdimb. Follows from \relsize or \relscale +\def\rs@scaleToB{% + % perform automatic tolerance adjustment, if requested + \ifx\RSpercentTolerance\@empty \rs@autoTol \fi + % apply limits + \ifdim\@tempdimb<\RSsmallest \@tempdimb=\RSsmallest + \rs@size@warning{small}{\RSsmallest}\fi + \ifdim\@tempdimb>\RSlargest \@tempdimb=\RSlargest + \rs@size@warning{large}{\RSlargest}\fi + % look up that size in list of pre-defined sizes. Puts error of + % closest match in \@tempdima + \let\@tempa\relax \@tempdima\maxdimen + \let\rs@size\rs@lookup \rs@fontsizes + % \message{ Look up best as \expandafter\string\@tempa\space + % (off by \the\@tempdima}% + % See how close match was (abs difference -> \@tempdima) + \ifdim\@tempdima<\z@ \@tempdima-\@tempdima\fi + % ... percentage error in \@tempdima (as a count) + \@tempdima 100\@tempdima \divide\@tempdima\@tempdimb + % if error is beyond tolerance, append \fontsize adjustment + % \message{ or \number\@tempdima \expandafter\@gobble\string\%). }% + \ifnum\@tempdima>\RSpercentTolerance + % \message{ adjust size to \strip@pt\@tempdimb. }% + \@tempdima1.2\@tempdimb % baselineskip + \edef\@tempa{\expandafter\noexpand\@tempa \noexpand\fontsize + {\strip@pt\@tempdimb}{\strip@pt\@tempdima}\noexpand\selectfont}\fi + % Now execute size-change command \@tempa + \expandafter\endgroup\@tempa} + +% For each defined font size, compare its actual size to the desired +% size (\@tempdimb) and the error of the best previous match (\@tempdima). +% Record this command (\@tempa) if it is closer. +\def\rs@lookup#1#2{% #1=command #2=size + \begingroup + \advance\@tempdimb-#2\relax + \ifdim\@absVal\@tempdimb<\@absVal\@tempdima % improvement + \endgroup + \def\@tempa{#1}% + \@tempdima#2\relax \advance\@tempdima-\@tempdimb + \else + \endgroup + \fi} + +\fi % ---------------------------------------------- + + +% Tolerance for size mis-match (%). The empty definition triggers +% automatic selection: 5 for scalable fonts, 30 otherwise. + +\def\RSpercentTolerance{} + +\def\rs@autoTol{% + \expandafter\expandafter\expandafter\rs@autoTOL + \expandafter\meaning + \csname\f@encoding/\f@family/\f@series/\f@shape\endcsname-\delimiter +} +\def\rs@autoTOL#1>#2-#3\delimiter{% + \ifx\delimiter#3\delimiter % no - + \def\RSpercentTolerance{30}% + \else % font size def has -, assume it covers continuum + \def\RSpercentTolerance{5}% + \fi + % \message{ Automatic tolerance is \RSpercentTolerance. }% +} + +% Warning messages + +\newcommand\rs@size@warning[2]{\PackageWarning{relsize}{% + Size requested is too #1.\MessageBreak Using #2 instead}} + +\newcommand\rs@unknown@warning{\PackageWarning{relsize}{Current font size + is unknown! (Why?!?)\MessageBreak Assuming \string\normalsize}} + +% derived commands + +\DeclareRobustCommand\larger[1][\@ne]{\relsize{+#1}} +\DeclareRobustCommand\smaller[1][\@ne]{\relsize{-#1}} +\DeclareRobustCommand\textlarger[2][\@ne]{{\relsize{+#1}#2}} +\DeclareRobustCommand\textsmaller[2][\@ne]{{\relsize{-#1}#2}} + +% math commands (completely different) + +\DeclareRobustCommand\mathsmaller[1]{\bgroup + \let\rs@makechoice\rs@makesmallerchoice + \def\rs@mathatom{#1}% + \futurelet\@tempa\rs@collect@decor +} +\DeclareRobustCommand\mathlarger[1]{\bgroup + \let\rs@makechoice\rs@makelargerchoice + \def\rs@mathatom{#1}% + \futurelet\@tempa\rs@collect@decor +} + +% math so far is in \rs@mathatom; next tok is \@tempa; continuation is \@tempb +% Don't nest \ifs because token may be \if or \fi or \or... +\def\rs@collect@decor{% + \let\@tempb\rs@makechoice + \ifx\@tempa\limits \let\@tempb\rs@collect@one@decor \fi + \ifx\@tempa\displaylimits \let\@tempb\rs@collect@one@decor \fi + \ifx\@tempa\nolimits \let\@tempb\rs@collect@one@decor \fi + \if\noexpand\@tempa^\let\@tempb\rs@collect@two@decor \fi + \if\noexpand\@tempa_\let\@tempb\rs@collect@two@decor \fi + \ifx\@tempa\sp \let\@tempb\rs@collect@two@decor \fi + \ifx\@tempa\sb \let\@tempb\rs@collect@two@decor \fi + \@tempb} +\def\rs@collect@one@decor#1{% + \expandafter\def\expandafter\rs@mathatom\expandafter{\rs@mathatom#1}% + \futurelet\@tempa\rs@collect@decor} +\def\rs@collect@two@decor#1#2{\expandafter + \def\expandafter\rs@mathatom\expandafter{\rs@mathatom#1{\rs@sstyle{#2}}}% + \futurelet\@tempa\rs@collect@decor} +\let\rs@sstyle\@firstofone + +\def\rs@makesmallerchoice{\mathchoice + {\textstyle \let\rs@sstyle\scriptstyle \rs@mathatom}% + {\scriptstyle \let\rs@sstyle\scriptstyle \rs@mathatom}% + {\scriptscriptstyle \let\rs@sstyle\scriptscriptstyle \rs@mathatom}% + {\scriptscriptstyle \let\rs@sstyle\scriptscriptstyle \rs@mathatom}% + \egroup} +\def\rs@makelargerchoice{\mathchoice + {\protected@edef\rs@sstyle##1{% + \protect\set@fontsize {1}{\f@size}{\f@baselineskip}\protect\selectfont + \hbox{$\scriptstyle ##1\m@th$}}% + \mbox{\larger$\displaystyle\rs@mathatom\m@th$}}% + {\displaystyle \let\rs@sstyle\scriptstyle \rs@mathatom}% + {\textstyle \let\rs@sstyle\scriptscriptstyle \rs@mathatom}% + {\scriptstyle \let\rs@sstyle\scriptscriptstyle \rs@mathatom}% + \egroup} + +\endinput +========================================================== + +R E L S I Z E . S T Y ver 3.1 July 4, 2003 + +by Donald Arseneau, asnd@triumf.ca, Vancouver, Canada +origianally based on smaller.sty by Bernie Cosell, cosell@WILMA.BBN.COM, +and combined with the version by Matt Swift, swift@bu.edu. + + +It is frequently the case that something should be typeset somewhat larger +or smaller than the surrounding text, whatever that size happens to be. +Specifying such sizing commands explicitly makes it difficult to modify the +font sizes of a document at a later time, and makes it hard to write macros +that work at arbitrary sizes. Relsize.sty defines several commands for LaTeX +to set font sizes relative to the current size. + +To refresh your memory, the font sizing commands in LaTeX are, in order: +\tiny, \scriptsize, \footnotesize, \small, \normalsize, \large, \Large, +\LARGE, \huge, \Huge (package moresize adds \ssmall and \HUGE). The main +new command provided by relsize.sty is \relsize, which takes one (positive +or negative) number as its argument; the number specifies how many "steps" +by which to change the font size, where each step is a scaling factor of +1.2, corresponding to the usual difference between the size commands. For +example, if "{\relsize{-2} smaller}" appears in normal sized text, the word +"smaller" is printed in script size type. If the same command appears in a +\Large section title, then "smaller" is printed in normal size. + +There are also the commands \larger and \smaller, which normally change the +font size by one step in the obvious direction; \larger is an abbreviation +for \relsize{+1}, and \smaller is an abbreviation for \relsize{-1}. For +example, {\large... \larger{WOW!}} prints "WOW" in \Large type. You can +also specify bigger steps as an optional argument for \larger and \smaller: +\larger[3] is equivalent to \relsize{3}; \smaller[2] is \relsize{-2}. +Both \larger and \smaller accept negative arguments, but please don't make +things so obscure! If you want to change size by several steps it is +much better to give an increment than to string several \larger commands +together; i.e., \relsize{3} or \larger[3], but not \larger\larger\larger. + +All of the \relsize, \larger, and \smaller commands are "switches" just +like the regular sizing commands. That is, they change the size for all +following text until the scope is ended by a closing brace. There are +alternate versions called \textlarger and \textsmaller that take some text +as an argument and apply the size change to only that text: +\textlarger{big}. + +Using the number of "magnification steps" to indicate font size can +be confusing to some people, and limiting in certain uses. There are +commands with syntax \textscale{factor}{text} and \relscale{factor} to +select the size based on a scale factor, like {0.75}. + +If the size requested is too small or too large, a warning is given, and +the size will only change as far as appropriate, typically \tiny or \Huge. +These limits are controlled by the commands \RSsmallest and \RSlargest, which +get set automatically when relsize.sty is loaded, but you can redefine them +to other length values: \renewcommand\RSlargest{50pt}. + +Fine point: The combination \relsize{n}\relsize{-n} is not guaranteed to +restore the current font size! That is because the increment "n" may be +enough to overflow the range of sizes. Say you are in \huge text already, +and you do \relsize{4}. There is nothing bigger than \Huge so that is the +size you get. Then an ensuing \relsize{-4} will take four steps smaller +and change the size to \large. You should use grouping to undo relative +size changes because it is unsafe to counteract one change with an "equal" +change in the opposite direction. + +Typically, the font-size commands do not select fonts at regular size +intervals. \relsize (and the others) will select, and execute, the command +for the size closest to the desired size. Then, if the relative difference +from the target size is more than \RSpercentTolerance a further font-size +selection is made. By default, \RSpercentTolerance is an empty macro, which +causes automatic selection: "30" (30%) when the current "fontshape" definition +is composed of only discrete sizes, and "5" when the fontshape definition +covers ranges of sizes. The higher setting for discrete fonts ensures +only the pre-defined sizes get used. (By default LaTeX uses Computer +Modern fonts at discrete sizes; you get full coverage of sizes by using +\usepackage{type1cm}.) For special uses, or when the font shape definitions +are not parsed properly, you can redefine the percent tolerance: +\renewcommand\RSpercentTolerance{10}. + +All of the commands described above are text commands; they cannot be used +in math mode. There are special \mathsmaller and \mathlarger commands +provided, but these do not use the same sizes that the text versions use. +Instead, they step between the usual math "styles" which you can explicitly +set using the commands \displaystyle, \textstyle, \scriptstyle, and +\scriptscriptstyle [see Lamport, LaTeX/Manual (1st ed, p.54); GMS The LaTeX +Companion, p.255]. However, the \mathlarger command will also increase the +size beyond regular \displaystyle by selecting a larger regular font size +(using \larger). (Yes, this is a kludge, and doesn't work very well, but +it can still be useful.) If you want to use this to create big integral +signs, then you must also load the package "exscale" so that math symbols +can change size. The sizes selected are: + +Current style \mathsmaller gives \mathlarger gives +--------------- ---------------------- ------------------------ +\displaystyle \textstyle (almost same) \displaystyle in a \larger font +\textstyle \scriptstyle \displaystyle (almost same) +\scriptstyle \scriptscriptstyle \textstyle +\scriptscriptstyle \scriptscriptstyle (same) \scriptstyle + +For example, try $\frac{\mathlarger{E}}{E}$. Note that, for most symbols, +\displaystyle and \textstyle are the same size, so $N \mathlarger{N}$ +gives two identical N's, but \sum and \int do get bigger in display style: +$\int\mathlarger{\int}$, and fractions are treated differently too: +$\frac{1}{2} \mathlarger{\frac{1}{2}}$. As you might have guessed, +\mathlarger and \mathsmaller should only be used in math mode. + +These commands will attempt to attach superscripts and subscripts to the +symbol as if the symbol were used alone: $\mathlarger{\int}_{0}^{\infty}$ +but math accents and the math spacing behave as if the symbol is enclosed +in braces (which it is). Comparing +\[ +| \times | {\times} | \mathlarger{\times} | \mathbin{\mathlarger{\times}} | +\] +shows that operators must be explicitly declared to use the right operator +type (\mathrel, \mathbin, \mathop) to get the correct spacing. + +Due to their oddities, the math larger/smaller commands should not be +trusted blindly, and they will not be useful in every instance. + + +Donald Arseneau asnd@triumf.ca |