⟦44633c46e⟧

TextFile

\InputD{../psfig/psfig.tex}
\input tpic-control.tex

\chapter{{\tt Tpic}}
% =================
\label{c-tpic}

\section{What is {\tt Tpic}?}
% ===========================
Below find a reprint of a message which was submitted to the {\tt TeXhax}
mailing list on February~1, 1990, by Tim Morgan ({\tt morgan@ICS.UCI.EDU}).
This message reads as follows:

\subsection{Introduction}
% ======================
{\tt Tpic} is derived from the pic preprocessor which is part of the
Device Independent Troff distribution from AT\&T Bell Labs.
Unfortunately, this means that you may have {\tt tpic} only if you are
source licensed for {\tt pic}.  {\tt Tpic} diverged from {\tt pic} around 1984.
I understand that there is a newer version of {\tt pic}, but I haven't
seen it so most of its features are not included in {\tt tpic2}.

{\tt Tpic}'s output consists of \verb+\special+ and other \TeX{} commands.  The
\verb+\special+ commands are passed by \TeX{} into the .dvi file, so any
dvi processing software must support the {\tt tpic} \verb+\special+'s in order
for you to get any useful output.  {\tt Tpic} is mainly of interest
to those who already use {\tt pic} and wish to use the same text-based
graphical language to describe figures to be included in \TeX{} or
\LaTeX{} documents.  Many of the changes in {\tt tpic} which have been made
over the last couple of years were suggested or implemented by
others, too many to name here, but all the feedback is certainly
appreciated.

\subsection{How do you get {\tt tpic}?}
% =====================================
If you got {\tt tpic} from {\tt ics.uci.edu} via ftp, you may obtain
{\tt tpic2} in the same way.  If you received {\tt tpic} on tape, or
you don't have {\tt tpic} at all right now, I would ask you
to wait awhile before requesting the new version, so
that I have time to receive bug fixes or improvements from
other users and incorporate the changes into the distribution.
If you don't have {\tt tpic} and want to get it, I request that you
mail me a photocopy of the first page of your DWB or {\tt Ditroff}
license from AT\&T to verify your source license.  If you've
previously sent this to me, then I should still have it on
file and you should note this in your request.

\subsection{What's New in {\tt tpic2}?}
% =====================================
The bad news, as some preliminary users have already discovered, is
that I've had to extend the set of \verb+\special+ commands that {\tt tpic}
generates.  This requires slightly modifying existing dvi
drivers that understand {\tt tpic1}'s \verb+\special+'s.  The change is
fairly simple, however; dvi driver writers who are interested
should contact me for further information.  Here is a list
of some of the more important improvements:

There is a new version of the manual in {\tt tpic}/\LaTeX{} format instead
of {\tt pic}/{\tt ditroff} format.  It contains almost all of the {\tt pic} manual,
plus discussions of the extensions that {\tt tpic} makes beyond {\tt pic}.

Shading is now done with a new attribute of each object called ``fill,''
which takes an optional argument between~0 and~1.  0~implies completely
white, and 1 implies completely black.  The default is a new predefined
variable called ``{\tt fillval}'' which defaults to~0.5, for a medium gray shading.
The keywords ``{\tt shaded}'', ``{\tt white},'' and ``{\tt black}'' have been retained for
backward compatibility.

Invisible objects can now be shaded: only the shading shows up in the
output.

Circles, ellipses, and arcs can now be dotted or dashed.  Dotted or dashed
circles, ellipses, and boxes can now be shaded.  Splines can also be dotted
or dashed, but this takes special driver support.

Calculation of arrowheads on arcs in most cases has been improved.
Arrowheads are now solid triangles instead of just two lines.

The .ps and .baseline commands can now be given without an argument, in
which case the corresponding parameter reverts to its previous value.

You can now use \verb+{}+ like {\tt []}, but it doesn't push a new lexical level.
Thus, things defined inside \verb+{}+ can be referenced from outside.

You can now do conditional subpictures like this:

\btex
	if <e> then | picture | else $ fpicture $
\etex
where \verb+|+ and {\tt \$} are arbitrary characters, as with define.  \verb+<e>+ is an
expression using C relational operators, constants, variables, and
functions.  There is a host of new unary and binary functions, such
as sin(), cos(), pow(), etc., from the C math library.

{\tt Tpic} is now compatible with output from grap (I'm told).

Invisible objects now contribute to \TeX's idea of the size of the picture.
This makes it easy to center text inside invisible boxes, for example.

The radius of an arc is now accessible as XX.rad, where XX is the symbol
for some arc.

\noindent Tim Morgan\hfil\break
UC Irvine ICS Dept.

\section{Other Address Information}
% =================================
Adam Hammer is also a very useful source {\tt hammer@cs.purdue.edu}.

% =====================
\ifnum\TpicControl = 1
% =====================

\section{{\tt tpic} Example 1}
% ===============================
		I will now now show a brief example of the application of \verb+tpic+.
	First the {\tt pic} source code file of this example:
 	\ListVerb{tpic-example-1.pic}

	This source code generates the following output in this document:

 	\input {tpic-example-1.tex}

\section{{\tt tpic} Example 2}
% ===============================
	Here is the {\tt pic} source code of the second example:

	\ListVerb{tpic-example-2.pic}

		This {\tt pic} source code generates the following \TeX{} source code
	if processed by {\tt tpic}:
	\ListVerb{tpic-example-2.tex}

	This source code generates the following figure in this document:

		\input {tpic-example-2.tex}

\else
	No {\tt tpic} example is enclosed here, because you specified that {\tt tpic}
	is not available on your machine.
\fi
DataMuseum.dk

DKUUG/EUUG Conference tapes

⟦44633c46e⟧ TextFile

Derivation

TextFile
