From c2dd86cbb06beec73db6c69875dc4a265a1529d5 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Thu, 24 Dec 2009 19:31:33 +0000 Subject: add README and example.pdf from CTAN git-svn-id: svn://tug.org/texlive/trunk@16505 c570f23f-e606-0410-a88d-b1316a301751 --- Build/source/utils/tpic2pdftex/README | 103 +++++++++++++++++++++++++++++ Build/source/utils/tpic2pdftex/example.pdf | Bin 0 -> 23965 bytes 2 files changed, 103 insertions(+) create mode 100644 Build/source/utils/tpic2pdftex/README create mode 100644 Build/source/utils/tpic2pdftex/example.pdf (limited to 'Build') 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 Binary files /dev/null and b/Build/source/utils/tpic2pdftex/example.pdf differ -- cgit v1.2.3