Files in this directory

Name	Date	Size		Description
GaPDoc1.pdf	2006-04-01	606 Kbyte	download
GaPDoc1.tex	2006-03-31	66 Kbyte	download
README	2006-10-02	3 Kbyte	download	Shown below

---

Contents of the README file

% README
% for the GaPFilL method ("Graphics as PostScript Filtered for LaTeX"),
% Version 1.1, January 2006
% Changes: October 2006

Author: H. Moeller
E-Mail: mollerh@math.uni-muenster.de
Address: Department of Mathematics and Computer Science
         University of Muenster
         Einsteinstr. 62
         D-48149 Muenster
         Germany

(1) INTRODUCTION
-----------------

Using geometry software or a drawing program ("geometry program") LaTeX picture environments may be constructed in the following way:

  i) Generating the desired figure with the geometry program;
  ii) "Printing" (or exporting) the construction as a PostScript file;
  iii) Applying a Perl filter program to the PostScript text;
  iv) Copying the resulting code or parts of it into a LaTeX document.

On account of this structure the method is called "GaPFilL" (Graphics as PostScript Filtered for LaTeX).

Since the steps i) and ii) and the packages used in the LaTeX document may vary, it is necessary to apply different filter programs.

Therefore the GaPFilL folder in the CTAN may collect open-source Perl filter programs for many combinations of geometry programs, PostScript versions, and LaTeX packages on different platforms.

The first two Perl filter programs in the folder 'MacOS' are written for the "dynamic" geometry software 'Cabri-g�om�tre II', the PostScript driver 'Virtual Printer', and the LaTeX packages 'ebezier' and 'pict2e'.

Both have been well tested using a Macintosh G4 and MacOS 9.2. The package pict2e with LaTeX code generated by 'CABpict.pl' could only be used with PDFTeX.

Together with the documentation 'GaPDoc1.pdf' these programs may serve as prototypes for those who will write or modify Perl filter programs for GaPFilL.

(2) REQUIRED SYSTEMS
--------------------

  i) A geometry program,
  ii) a PostScript driver (http://www.adobe.com/support/downloads/main.html),
  iii) the Perl interpreter (http://www.Perl.com/CPAN/ports/index.html),
  iv) a TeX/LaTeX installation.

(3) PACKAGE FILES
------------------

  README -- this file,
  GaPDoc1.tex -- tex file of the GaPFilL documentation,
  GaPDoc1.pdf -- pdf version of the GaPFilL documentation,
  MacOS/CABebez.pl -- Perl filter for Cabri-g�om�tre II and the LaTeX package 'ebezier',
  MacOS/CABpict.pl -- Perl filter for Cabri-g�om�tre II and the LaTeX packages 'ebezier' and 'pict2e'.

(4) INSTALLATION
----------------

Each of the four systems in (2) has its own installation mode depending on the platform. In general with the respective software you get an installer or an explanation how to install it.

(5) USAGE
---------

If you are familiar with your geometry program you are able to generate even complicated drawings without using any manual. For the assignment of colours you only need the two tables on pages 4 and 5 of the documentation GaPDoc1.pdf.

The Perl filter programs need to be placed where your Perl interpreter can find them.

With MacOS you may select the PostScript text in your text editor and run the desired filter of the Perl filters list.

The use of Perl filter programs in Unix/Linux and with MS-Windows is explained for example in the README.TXT of CTAN/graphics/pictex/mathspic/Perl.

(6) CHANGES
-----------

October 2006: In the Perl filter MacOS/CABebez.pl on line 111 "and ($co0 ne $violet)) " has been added.

(7) LICENSE (LPPL)
------------------

These programs are free software; you can redistribute them and/or modify them under the conditions of the LaTeX Project Public License.

These programs are distributed in the hope that they will be useful, but WITHOUT ANY WARRANTY, without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
-------------

End of README
=============

Small print: This listing is regenerated periodically so there is a small chance that the directory has changed from what is shown here; to be sure, check the FTP listing.