Menu
CTAN
Comprehensive TeX Archive Network
Home Upload Browse

Direc­tory tex-archive/graphics/gapfill

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

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 'Mac_OS_only' 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 Mac OS 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.

Added in 2009: A new Perl filter program 'OOopict.pl' is added for the powerful free drawing software OpenOffice.org 3 Draw which has its own PostScript generator not depending on the operating systems supplied by OpenOffice.org, namely Linux, Mac OS, Unix and Windows.

(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,
  Mac_OS_only/CABebez.pl -- Perl filter for Cabri-g�om�tre II and the LaTeX package 'ebezier',
  Mac_OS_only/CABpict.pl -- Perl filter for Cabri-g�om�tre II and the LaTeX packages 'ebezier' and 'pict2e'.
  
  Added in 2009:
  GaPDoc2.tex -- tex file of the GaPFilL documentation for OpenOffice.org 3 Draw,
  GaPDoc2.pdf -- pdf file of the GaPFilL documentation for OpenOffice.org 3 Draw,
  Various_OSs/OOopict.pl -- Perl filter for OpenOffice.org 3 Draw and the LaTeX package 'pict2e' (2008) or the packages 'ebezier' and 'pict2e' (2003).

(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.

Added in 2009: With OOopict.pl you have to use the table of colours on page 6 of the documentation GaPDoc2.pdf.

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

With Mac OS 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.

If there are difficulties between 64-bit Windows 7 and the text editor you may use the command line of Windows with the eps-file as parameter.

(6) CHANGES
-----------
April 2006: The German documentation has been substituded by an English translation of it.

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

August 2009: In the Perl filter Mac_OS_only/CABpict.pl the subprocedure 'best' is corrected taking into account that Perl has a greatest integer.

April 2011: In the PostScript file of OpenOffice.org 3 Draw rectangles consist of five lines. These are reduced to the ordinary four ones. The length of arrow shafts is corrected. Dotted lines and curves are shifted half a dot to the left. The letter 'D' in the subprocedure 'best' is replaced by 'd'.

June 2011: The subprocedure 'best' of OOopict.pl is simplified on lines 269 to 300. 

(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
=============

Direc­to­ries

Name Notes
Mac_OS_only
Various_OSs

Files

Name Size Date Notes
GaPDoc1.pdf 621485 2006-04-01 05:46:42
GaPDoc1.tex 67812 2006-03-31 09:51:50
GaPDoc2.pdf 148778 2009-08-17 06:58:36
GaPDoc2.tex 23174 2009-08-17 06:58:36
README 5293 2011-06-18 10:59:30

Down­load the con­tents of this pack­age in one zip archive (772.5k).

gap­fill – Gen­er­ate LaTeX pic­ture en­vi­ron­ments from PostScript out­put of draw­ing pro­grams

GaPFilL ("Graph­ics as PostScript Fil­tered for LaTeX") is a method for the gen­er­a­tion of LaTeX pic­ture en­vi­ron­ments in four steps:

  • Con­struct the de­sired fig­ure with a draw­ing pro­gram;
  • Ex­port as a PostScript file;
  • Ap­ply a Perl fil­ter pro­gram to the PostScript text;
  • Trans­fer the re­sult­ing code into a LaTeX doc­u­ment.

Doc­u­men­ta­tion
Ver­sion1.5
Li­censeThe LaTeX Project Public Li­cense
Main­tainerHer­bert Möller
Con­tained inMikTeX as gap­fill
Topics pre­pare graph­ics for use with *TeX
Guest Book Sitemap Contact 2014-04-24 18:18 CEST