summaryrefslogtreecommitdiff
path: root/Build/source/utils/tpic2pdftex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2009-12-24 19:31:33 +0000
committerKarl Berry <karl@freefriends.org>2009-12-24 19:31:33 +0000
commitc2dd86cbb06beec73db6c69875dc4a265a1529d5 (patch)
tree541b65aaa0a3bc1f3b6cd282742953963903a35e /Build/source/utils/tpic2pdftex
parentff50243846dfc599e894ee1d19f5eb4b1feba949 (diff)
add README and example.pdf from CTAN
git-svn-id: svn://tug.org/texlive/trunk@16505 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/utils/tpic2pdftex')
-rw-r--r--Build/source/utils/tpic2pdftex/README103
-rw-r--r--Build/source/utils/tpic2pdftex/example.pdfbin0 -> 23965 bytes
2 files changed, 103 insertions, 0 deletions
diff --git a/Build/source/utils/tpic2pdftex/README b/Build/source/utils/tpic2pdftex/README
new file mode 100644
index 00000000000..f69e904ccd4
--- /dev/null
+++ b/Build/source/utils/tpic2pdftex/README
@@ -0,0 +1,103 @@
+Converting tpic \special's into \pdfliteral's by awk
+====================================================
+
+The experimental awk-script tpic2pdftex.awk builds one bridge between the
+"pic" graphics language and pdfTeX.
+
+What tpic2pdftex.awk does:
+
+We start from one or more graphics described by the venerable pic language
+(see e. g. file example.pic), embedded inline within pdfTeX or pdfLaTeX
+code, and limited by classical .PS and .PE markers as known from groff.
+The pic graphics might be annotated by TeX or LaTeX text. This pic/TeX
+language-mix file is piped through the (groff-)pic preprocessor and
+the tpic2pdftex.awk script. The result is a TeX file with inline
+\pdfliteral{} sections, for further processing by pdftex or pdflatex.
+
+
+Usage
+-----
+
+$ export LANG="C"
+$ pic -t somefile.pic | awk -f tpic2pdftex.awk > somefile.tex
+
+Process somefile.tex by pdftex or pdflatex.
+
+
+Files
+-----
+
+tpic2pdftex.awk
+ The awk script for converting tpic specials into pdfliterals for
+ further processing by pdftex. For usage see head of this file.
+
+example.pic
+ A small pic sample file (plain-TeX), as input.
+
+example.pdf
+ The resulting example PDF file (the dotted and dashed ellipses are
+ part of gpic from version 1.19.1 on).
+
+beamerexample.pic
+ Another small pic sample file (pdfLaTeX), which shows that images
+ created by pic can be incrementally built up in the beamer class.
+
+Makefile
+ The Makefile used to produce file example.pdf and beamerexample.pdf
+ from the input files.
+
+README
+ This file.
+
+
+Portability
+-----------
+
+This awk-script should be useable on all systems on which a working awk
+program (e. g. awk, gawk, mawk) is installed.
+
+The script has been tested with GNU pic (groff), versions 1.18.1 and
+1.19.1, and pdftex, versions 1.11b and 1.20a on a debian woody (3.0)
+i686 PC.
+
+
+Remarks
+-------
+
+1. If more than a single .pic file provide the source for the .tex file,
+there are two options: Either separately run all .pic files through the
+pic -t | awk -f tpic2pdftex.awk pipe and combine them by TeX's \input
+statements as usual. Or make one big .pic file by using the soelim
+program from groff (with option -t), and then run the resulting .pic file
+through pic, tpic2pdftex, and TeX. File embedding by soelim is done by
+the request:
+
+.so somefile.pic
+
+The process call then could look like e. g.:
+
+$ soelim -t somefile.pic | pic -t | awk -f tpic2pdftex.awk > somefile.tex
+
+2. Depending on the awk version, "locale" settings might have influence
+on the separator in floating point numbers. PDF requires decimal _dots_
+(e. g. 3.14 rather than 3,14) which is checked by tpic2pdftex.awk at
+the begin of the run. If you get an ERROR message, set LANG="C", so that
+decimal dots are used as float separators.
+
+
+Literature
+----------
+
+Brian W. Kernighan: PIC -- A Graphics Language for Typesetting, User
+Manual, Revised, May, 1991. File cstr116.ps.
+
+Eric S. Raymond: Making Pictures With GNU PIC. File gpic.raymond.ps.
+
+Both files are available online from various places.
+
+
+Comments welcome. Have fun!
+
+Hartmut
+
+$Id: README,v 1.7 2004/04/09 20:28:49 hahe Exp hahe $
diff --git a/Build/source/utils/tpic2pdftex/example.pdf b/Build/source/utils/tpic2pdftex/example.pdf
new file mode 100644
index 00000000000..9736b5bffcb
--- /dev/null
+++ b/Build/source/utils/tpic2pdftex/example.pdf
Binary files differ