summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2013-03-21 23:23:45 +0000
committerKarl Berry <karl@freefriends.org>2013-03-21 23:23:45 +0000
commitcc6a974dc0c0e376fea2434265b38e70a55ad562 (patch)
treeaf90ad840794081feb19a49e277a0e6dcab926b5 /Master/texmf-dist/doc
parent98b8c4f7f2824b0dc06866cb6ccb2668088c9a27 (diff)
scalerel (21mar13)
git-svn-id: svn://tug.org/texlive/trunk@29465 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/latex/scalerel/scalerel.pdfbin233706 -> 234908 bytes
-rw-r--r--Master/texmf-dist/doc/latex/scalerel/scalerel.tex45
2 files changed, 43 insertions, 2 deletions
diff --git a/Master/texmf-dist/doc/latex/scalerel/scalerel.pdf b/Master/texmf-dist/doc/latex/scalerel/scalerel.pdf
index 64e455e4b8b..1e081a9877c 100644
--- a/Master/texmf-dist/doc/latex/scalerel/scalerel.pdf
+++ b/Master/texmf-dist/doc/latex/scalerel/scalerel.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/scalerel/scalerel.tex b/Master/texmf-dist/doc/latex/scalerel/scalerel.tex
index 45e1673116c..ec38c1b77c8 100644
--- a/Master/texmf-dist/doc/latex/scalerel/scalerel.tex
+++ b/Master/texmf-dist/doc/latex/scalerel/scalerel.tex
@@ -1,5 +1,5 @@
\documentclass{article}
-\def\version{1.2}
+\def\version{1.3}
%% Copyright 2013 Steven B. Segletes
%
% This work may be distributed and/or modified under the
@@ -18,6 +18,8 @@
% V1.1 Corrected usepackage dependencies; Significant doc rewrite.
% V1.11 Corrected typo in documentation
% V1.2 Added \scaleleftright and \stretchleftright; revised docs.
+% V1.3 Corrected missing % in stretch routines, added \hstretch and
+% \vstretch commands; fixed version number in .sty file
\parskip 1em
\parindent 0em
\newcommand\rl{\rule{3em}{0in}}
@@ -55,11 +57,13 @@ of which have star variants:
\scaleto[max_width]{object}{height}
\stretchto[min_aspect]{object}{height}
\end{verbatim}
-In addition, there are two added commands that have been implemented as
+In addition, there are four added commands that have been implemented as
composites of the four basic commands, they are
\begin{verbatim}
\scaleleftright[max_width]{left-obj.}{reference}{right-obj.}
\stretchleftright[min_aspect]{left-obj.}{reference}{right-obj.}
+ \hstretch{scale}{object}
+ \vstretch{scale}{object}
\end{verbatim}
In all cases, \verb|object| is the object to be scaled or vertically
@@ -111,6 +115,12 @@ intended to provide the functional capability of the \verb|\left| and
\verb|\right| commands in math mode, for delimiting symbols not
otherwise supported by those commands.
+The \verb|\hstretch| and \verb|\vstretch commands| merely take the
+second argument and either horizontally or vertically stretch it by a
+scale factor given by the first argument. The scale is not given in
+percent, like some aforementioned commands. Remember also, that these
+commands are, by default processed in math mode.
+
\section{Usage Examples}
Now for a few examples. Let us define
@@ -261,6 +271,21 @@ $\scaleleftright[3ex]{\prod}{\blob}{\coprod}$
\rl\verb|$\stretchleftright[450]{.}{\blob}{\in}$ |
$\stretchleftright[450]{.}{\blob}{\in}$
+\subsection{The $\backslash$\texttt{hstretch} and
+ $\backslash$\texttt{vstretch} Commands}
+
+These commands simply perform horizontal or vertical stretching,
+respectively. They use a scale factor, rather than an absolute length.
+If the stretch factor is greater than 1, the stretched length is larger
+than the original. If less than one, it is compressed with respect to
+the original.
+
+\rl\verb|$\otimes\hstretch{3}{\otimes}\hstretch{0.5}{\otimes}$ |
+$\otimes\hstretch{3}{\otimes}\hstretch{0.5}{\otimes}$
+
+\rl\verb|$\otimes\vstretch{3}{\otimes}\vstretch{0.5}{\otimes}$ |
+$\otimes\vstretch{3}{\otimes}\vstretch{0.5}{\otimes}$
+
\section{Real World Application}
\subsection{White Curly Brackets}
@@ -330,6 +355,22 @@ both normal size and tiny size:
Note that the brace is the properly formed scale of the normal-sized
brace in both cases, even as the $x$ adjusts to the fontsize reduction.
+If one wanted the default braces narrower (to match the look of the
+comparable symbols in the literature), one could use
+\verb|\hstretch| in the definitions to achieve that quickly as
+\begin{verbatim}
+\def\lxbrace{%
+ \hstretch{0.6}{\scalerel*{\usebox{\lXbrace}}{\llbrace}}}
+\def\rxbrace{%
+ \hstretch{0.6}{\scalerel*{\usebox{\rXbrace}}{\rrbrace}}}
+\end{verbatim}
+
+to give the following
+
+\def\lxbrace{\hstretch{0.6}{\scalerel*{\usebox{\lXbrace}}{\llbrace}}}
+\def\rxbrace{\hstretch{0.6}{\scalerel*{\usebox{\rXbrace}}{\rrbrace}}}
+\indent$\scalerel*{\lxbrace x\rxbrace$\tiny$\lxbrace x\rxbrace}{\wbrace}$
+
Likewise, the \verb|\left| and \verb|\right| features of equation mode
cannot be used with the white braces,