Index of /tex-archive/graphics/texdraw
This file describes the contents of the distribution for TeXdraw
$Id: README,v 2.0 1995/12/18 texdraw-V2R0 $
The TeXdraw package consists of a set of macro definitions for the TeX
typesetting program. These macros allow the user to produce PostScript
drawings from within TeX and LaTeX.
The main benefits of TeXdraw accrue from the ability to produce drawings
from <within> TeX, using TeX fonts for labelling the drawing.
Basic drawing features include:
(1) moves, lines and arrow vectors
- selectable gray level, line width pattern, arrowhead size and type
(2) circles, ellipses, arcs, and Bezier curves
(3) general fill command to fill a region defined by lines and Bezier
curves (selectable gray level)
(4) TeX text, including mathematics, can be positioned and superimposed
on the drawing
TeXdraw has been designed to be extensible. Drawing "segments" are
relocatable, self-contained units. Using a combination of the begingroup/
endgroup mechanism in TeX and the gsave/grestore mechanism in PostScript,
drawing segments allow for local changes to the scaling and line
parameters. Using TeX's macro definition capability, new drawing commands
can be constructed from drawing segments.
The extensibility features include,
(1) relocatable drawing segments to keep changes local
(2) local segment scaling
(3) saving and restoring positions using symbolic positions
The compressed file texdraw-V2R0.tar.Z is available for anonymous ftp on
ftp.TSP.EE.McGill.CA in directory /pub/tsp/texdraw.
Peter Kabal kabal@TSP.EE.McGill.CA
Department of Electrical Engineering
The distribution consists of the TeXdraw macros themselves, files with
auxiliary macros, and the TeXdraw manual (texinfo format, also as a
README - this file
ChangeLog - log of changes to TeXdraw
TeXdraw macros (main directory):
texdraw.tex - TeXdraw macros for TeX
texdraw.sty - LaTeX2e interface to TeXdraw
txdtools.tex - TeXdraw toolbox for extending TeXdraw
txdps.tex - TeXdraw macros for accessing PostScript macros
blockdiagram.tex - Block diagram macros for TeXdraw
txdexamp.tex - plain TeX code for the examples in the manual
txdexamp.latex - LaTeX2e code for the examples in the manual
compacted TeXdraw macros (directory compact/):
TeXdraw documentation (directory manual/):
texdraw.ps - PostScript version of the manual
texdraw.texi - Texinfo source file for the TeXdraw manual
texdraw.aux - cross-references (generated by an earlier run, used
as input when TeX'ing the manual)
texdraw.cps - concept index (generated by an earlier run, used as
input when TeX'ing the manual)
texdraw.fns - sorted functon index (generated by an earlier run,
used as input when TeX'ing the manual).
GNU Texinfo utilities (directory manual/):
texindex.c - Source for the texindex program
getopt.h - Include file for texindex.c
texinfo.tex - Texinfo macros used to make manuals and on-line
texi2dvi - Script to run TeX and texindex
The following notes on setup are for Unix systems.
(1) Print the PostScript version of the manual ("texdraw.ps") to see the
capabilities of TeXdraw.
(2) Try TeX'ing the examples file. Assuming plain TeX is invoked with the
command "tex" and LaTeX2e is invoked with the command "latex"
% tex txdexamp
... or ...
% latex texdexamp.latex
(3) Printing the examples using the appropriate printer driver program (only
dvips can be used with the plain TeX version of the examples),
% dvips txdexamp
Compact source files:
In the subdirectory "compact", there are versions of the macro files
with most comments and white space removed.
(1) Private copy of TeXdraw.
Move the TeXdraw sources files ("texdraw.sty", texdraw.tex",
"txdtools.tex" and "txdps.tex") to an appropriate directory. If you are
keeping private versions of the files, consider using the directory
~mylogin/tex . With many versions of TeX, including this directory in
the TeX input path variable (the environment variable TEXINPUTS) allows
you to refer to the files in TeX without specifying the full pathname.
With the C-cshell, a line in the ".login" file sets the environment
% setenv TEXINPUTS ".:$HOME/tex:".
The last part of the path string should terminate with a colon to have
the default directory of TeX files available.
(2) Public copy of TeXdraw.
Move the TeXdraw source files ("texdraw.sty", "texdraw.tex",
"txdtools.tex" and "txdps.tex") to a directory that TeX searches by
default. This might be a directory such as "/usr/local/lib/tex/inputs".
Newer versions of TeX allow subdirectory searching - in that case, use
the directory "/usr/local/lib/tex/inputs/TeXdraw".
The following instructions pertain to installing the ability to use the
Texinfo system for any texinfo type manual.
(1) The GNU program "texindex" should built using
% cc texindex.c -o texindex
Move the program to an appropriate place such as "/usr/local/bin".
(2) The GNU script "texi2dvi" runs TeX and texindex for a texinfo file.
Move this script to an appropriate place such as "/usr/local/bin".
(3) The GNU "texinfo.tex" file should go into the public directories
searched by TeX, for instance "/usr/local/lib/tex/inputs", or
Creating a TeXdraw manual from the sources:
(1) Make sure "texdraw.tex", "txdtools.tex" and "texinfo.tex" will be found
(2) To create the manual, you have to TeX the manual twice - the second
time to access the sorted indices and the cross-references. The
program "texindex" sorts the indices. (The distribution includes pre-
sorted indices that can be used). The three steps can be replaced by
an invokation of the script "texi2dvi".
% tex texdraw.texinfo
% texindex texdraw
% tex texdraw.texinfo
(3) If you have the printer driver program dvips, a PostScript version of the
manual is created as follows.
% dvips texdraw -o texdraw.ps
On-line info manual:
Consider building an info version of the manual. For this you need the
GNU program "makeinfo" (available by anonymous ftp from prep.ai.mit.edu
as part of texinfo-XXX.tar.gz). After running "makeinfo texdraw", the top
level info directory file "dir" in /usr/local/emacs/info needs to be
updated to include a menu entry for TeXdraw. This entry is of the form
* TeXdraw: (texdraw).
TeXdraw is a collection of macros that allow drawings to be
created from within TeX.
Also the files produced by makeinfo (texdraw, texdraw-1, texdraw-2, and
texdraw-3) need to be moved there. The info file can be read from within
the emacs editor, or with the info reader program "info" (also part of the