summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/shapepar/shapepar.ltx
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/generic/shapepar/shapepar.ltx')
-rw-r--r--Master/texmf-dist/doc/generic/shapepar/shapepar.ltx140
1 files changed, 76 insertions, 64 deletions
diff --git a/Master/texmf-dist/doc/generic/shapepar/shapepar.ltx b/Master/texmf-dist/doc/generic/shapepar/shapepar.ltx
index a583ad0d4a5..59919d795e6 100644
--- a/Master/texmf-dist/doc/generic/shapepar/shapepar.ltx
+++ b/Master/texmf-dist/doc/generic/shapepar/shapepar.ltx
@@ -1,14 +1,14 @@
% shapepar.ltx Manual for shapepar.sty
%
-% Version 2.0 (Dec 2002)
+% Version 2.1 (September 2006)
%
-% Copyright (c) 1993,2002 Donald Arseneau
+% Copyright (c) 1993,2002,2006 Donald Arseneau
% These definitions may be freely transmitted, reproduced, or modified
% provided that any modifications are clearly identified and this notice
% is left intact.
%
-\documentclass[draft]{article}
+\documentclass{article}
\usepackage{shapepar}
@@ -18,6 +18,8 @@
\renewcommand{\floatpagefraction}{.66}
\renewcommand{\dbltopfraction}{.66}
\renewcommand{\dblfloatpagefraction}{.66}
+
+\sloppy
\raggedbottom
\addtolength{\topskip}{0pt plus 8pt}
@@ -74,7 +76,7 @@
\title{shapepar.sty}
\author{Donald Arseneau\\ Vancouver, Canada\\ asnd@triumf.ca}
-\date{v 2.0 \ Dec 2002}
+\date{v 2.1 \ September 2006}
\begin{document}
@@ -123,7 +125,7 @@ intended for cards, invitations etc., not for whole books! Although
short paragraphs process much faster, only long paragraphs accurately
fill complex shapes.
-These macros work for both \LaTeX\ and plain \TeX. For \LaTeX, specify
+These macros work for both \LaTeX\ and Plain \TeX. For \LaTeX, specify
"\usepackage""{shapepar}", or for Plain, "\input" "shapepar.sty".
The command "\shapepar" should be used at the beginning of a paragraph,
@@ -262,8 +264,8 @@ will usually be needed to position a shaped paragraph precisely.
\section{Shapes}
-There are some shapes predefined in shapepar.sty (square, circle,
-circle-with-hole, diamond, heart, star and hex-nut) which are used as
+There are some shapes predefined in shapepar.sty (square, rectangle, circle,
+circle-with-hole, diamond, heart, star, hexagon and hex-nut) which are used as
examples in the instructions below. Each of these shapes is stored in
a macro, and there is a command to use that shape:
\begin{flushleft}
@@ -275,18 +277,23 @@ a macro, and there is a command to use that shape:
"\diamondshape" & "\diamondpar" & Rhomboid `diamond' ($\diamondsuit$)\\
"\heartshape" & "\heartpar" & Heart (symbolic shape $\heartsuit$)\\
"\starshape" & "\starpar" & Five-point star\\
-"\nutshape" & "\nutpar" & Nut for bolt (hexagon with circular hole)
+"\hexagonshape"&"\hexagonpar"& Hexagon\\
+"\nutshape" & "\nutpar" & Nut for bolt (hexagon with circular hole)\\
+\multicolumn{2}{l}{"\rectangleshape"\texttt{\string{<height>\string}\string{<width>\string}}} &
+ Rectangle shapes
\end{tabular}
\end{flushleft}
For example, "\heartpar{"<text>"}" performs
"\shapepar" "{\heartshape}" <text>"\ \ $""\heartsuit""$""\par"
-(ending the text with a heart symbol).
+(ending the text with a heart symbol).
More shape definitions are provided in separate files named
$*$shape.def. Look on your disk to be sure, but the
list should include:
\begin{flushleft}
\begin{tabular}{ll}
+dropshape & Rain drop\\
+triangleshapes & Triangles in different orientations\\
candleshape & A burning candle\\
TeXshape & The \TeX\ logo\\
Canflagshape & The Canadian flag
@@ -299,55 +306,6 @@ Please contribute your shapes!
Although defining shapes by hand can be difficult, there are
programs to aid you.
-\subsection{proshap.py by Man\-uel Gu\-ti\-er\-rez Al\-ga\-ba}
-\gdef\bassshape{{9.4}{0}b{9.4}
-\\{0}t{7.6}{6.8}
-\\{0.8}t{5.2}{11.6}
-\\{1.6}t{4.4}{13.2}
-\\{2.4}t{4.0}{14.0}
-\\{3.2}t{3.6}{4.933333}st{8.533333}{4.933333}st{13.46666}{4.933333}
-\\{4.0}t{3.6}{2.4}t{9.6}{2.8}t{16.4}{2.4}
-\\{6.4}t{3.6}{2.0}t{10.0}{2.0}t{16.8}{2.0}
-\\{8.8}t{3.6}{2.4}t{9.6}{1.4}st{11.0}{1.4}t{16.4}{2.0}
-\\{11.2}t{3.6}{3.4}jt{7.0}{3.4}t{11.6}{3.4}jt{15.0}{3.4}
-\\{12.8}t{4.0}{6.0}t{12.0}{6.0}
-\\{14.4}t{4.4}{5.2}t{12.4}{5.2}
-\\{16.0}t{4.8}{6.0}jt{10.8}{6.0}
-\\{16.8}t{5.2}{5.6}st{10.8}{5.6}
-\\{17.6}t{5.6}{0.8}t{14.8}{1.2}
-\\{19.2}t{6.0}{2.4}t{12.0}{3.6}
-\\{20.8}t{6.4}{4.4}jt{10.8}{4.4}
-\\{22.4}e{9.4}}
-
-
-\shapepar\bassshape
-proshap.py (ver 1.1) is a python script written by Man\-uel
-Gu\-ti\-er\-rez Al\-ga\-ba to produce shape definitions from rough
-`ascii art'. There is no instruction manual, so here are Donald
-Arseneau's observations. There is not much of a user interface; look
-in proshap.py (which is a plain text file) and see how the various
-`test' shapes are defined (note the triple-double quotes). Choose
-one of them, or add a new one, then change the line `test = test3' to select
-the desired picture. Execute `python proshap.py' which will output a
-definition of "\bassshape" to the screen and to the file `result.tex'.
-The goul\-ish face you see here is the test3 shape. You should be
-aware that the characters in the ascii input are treated as square,
-even though they are taller than they are wide, so the output shape
-specification will be taller and thinner than the input text. There
-also seems to be a problem with all `bottoms': flat bottoms of text
-blocks and of holes are expanded downwards to end at a point. Compare
-this face to the original face in proshap.py. Warning: These
-instructions and observations are probably wrong; the author does not
-program in python so can't even read the code properly. For now, look
-for proshap.py bundled with shapepar.sty.
-
-\vspace{0pt plus 5cm}
-\penalty 0
-\vspace{0pt plus -5cm}
-\vspace{5cm}
-\penalty 9999
-\vspace{-5cm}
-
\subsection{ShapePatch by Christian Gollwitzer}
\def\faceshape{%
@@ -444,12 +402,10 @@ convert it to a shapepar shape definition, either by manually running
fig2dev (a component of transfig), or by choosing `Export/Shape' in
Xfig. Its odd name is indicative of its implementation: it is an
upgrade or `patch' to both the Xfig program and the transfig tool-set.
-ShapePatch can be found on \textsc{ctan} under
-"graphics/""trans""fig-shape""patch", and includes instructions
+ShapePatch is included with transfig, or can be found on \textsc{ctan} under
+"graphics/""trans""fig-shape""patch", which includes instructions
(\textsc{readme}) and sample shapes besides the patch itself. This
-smiley face is one of the sample shapes. In the future, the
-ShapePatch utility will be included in transfig, so there will be no
-need to install the patch. Besides enabling a graphical utility
+smiley face is one of the sample shapes. Besides enabling a graphical utility
(Xfig) to produce shapepar specifications, the ShapePatch upgrade
opens up great libraries of existing Fig clip-art to be used for
paragraph shapes. For example, a Canadian flag taken from the Xfig
@@ -457,8 +413,64 @@ flag library is one of the examples provided with ShapePatch, for
comparison with the hand-coded one bundled with shapepar.sty. (I
prefer my own version because there is an error in the maple leaf
shape on the Xfig flag library version. The error is not the fault of
-ShapePatch, but ShapePatch faithfully reproduces the faulty shape.)
+ShapePatch, but ShapePatch faithfully reproduces the faulty shape!)
+
+
+\vspace{0pt plus 5cm}
+\penalty 0
+\vspace{0pt plus -5cm}
+\vspace{5cm}
+\penalty 9999
+\vspace{-5cm}
+\subsection{proshap.py by Man\-uel Gu\-ti\-er\-rez Al\-ga\-ba}
+\gdef\bassshape{{9.4}{0}b{9.4}
+\\{0}t{7.6}{6.8}
+\\{0.8}t{5.2}{11.6}
+\\{1.6}t{4.4}{13.2}
+\\{2.4}t{4.0}{14.0}
+\\{3.2}t{3.6}{4.933333}st{8.533333}{4.933333}st{13.46666}{4.933333}
+\\{4.0}t{3.6}{2.4}t{9.6}{2.8}t{16.4}{2.4}
+\\{6.4}t{3.6}{2.0}t{10.0}{2.0}t{16.8}{2.0}
+\\{8.8}t{3.6}{2.4}t{9.6}{1.4}st{11.0}{1.4}t{16.4}{2.0}
+\\{11.2}t{3.6}{3.4}jt{7.0}{3.4}t{11.6}{3.4}jt{15.0}{3.4}
+\\{12.8}t{4.0}{6.0}t{12.0}{6.0}
+\\{14.4}t{4.4}{5.2}t{12.4}{5.2}
+\\{16.0}t{4.8}{6.0}jt{10.8}{6.0}
+\\{16.8}t{5.2}{5.6}st{10.8}{5.6}
+\\{17.6}t{5.6}{0.8}t{14.8}{1.2}
+\\{19.2}t{6.0}{2.4}t{12.0}{3.6}
+\\{20.8}t{6.4}{4.4}jt{10.8}{4.4}
+\\{22.4}e{9.4}}
+
+
+\shapepar\bassshape
+proshap.py (ver 1.1) is a python script written by Man\-uel
+Gu\-ti\-er\-rez Al\-ga\-ba to produce shape definitions from rough
+`ascii art'. There is no instruction manual, so here are Donald
+Arseneau's observations. There is not much of a user interface; look
+in proshap.py (which is a plain text file) and see how the various
+`test' shapes are defined (note the triple-double quotes). Choose
+one of them, or add a new one, then change the line `test = test3' to select
+the desired picture. Execute `python proshap.py' which will output a
+definition of "\bassshape" to the screen and to the file `result.tex'.
+The goul\-ish face you see here is the test3 shape. You should be
+aware that the characters in the ascii input are treated as square,
+even though they are taller than they are wide, so the output shape
+specification will be taller and thinner than the input text. There
+also seems to be a problem with all `bottoms': flat bottoms of text
+blocks and of holes are expanded downwards to end at a point. Compare
+this face to the original face in proshap.py. Warning: These
+instructions and observations are probably wrong; the author does not
+program in python so can't even read the code properly. For now, look
+for proshap.py bundled with shapepar.sty.
+
+\vspace{0pt plus 5cm}
+\penalty 0
+\vspace{0pt plus -5cm}
+\vspace{5cm}
+\penalty 9999
+\vspace{-5cm}