Source code for FlowframTk and associated libraries and applications

Nicola L.C. Talbot
http://www.dickimaw-books.com/

FlowframTk Home page: http://www.dickimaw-books.com/software/flowframtk/

REQUIREMENTS: 
============

The Java Platform, Standard Edition (J2SE). This can be downloaded from:
http://java.sun.com/j2se/1.5.0/download.jsp

DEPENDENT PACKAGES:
==================

JavaHelp (http://java.sun.com/products/javahelp/)

COMPILING SOURCE:
================

Although Java is platform independent, the Makefiles and
associated Perl scripts have only been tested under Linux.
There is no guarantee that they will work on other systems.

Set the environment variable JDRSRC to this directory and run make

"make all": make all applications

"make clean": remove all generated files


LICENCE:
=======

This material is subject to the GNU General Public License. 
See the file LICENSE for details.

The jh.jar package is part of JavaHelp,
see http://java.sun.com/products/javahelp/ for details of that
licence.

ABOUT FlowframTk:
==============

FlowframTk is a graphics application written in Java. 

You can use FlowframTk to:

* Construct shapes using lines, moves and cubic Bezier segments

* Edit shapes by changing the defining control points

* Incorporate text and bitmap images (for annotation and 
background effects)

* Extract the parameters for TeX's \parshape command
and for \shapepar (defined in the shapepar package)

* Construct frames for use with the flowfram package

* Pictures can be saved in FlowframTk's native binary format
or can be exported as:

   - pgfpicture environments for use in LaTeX documents

   - LaTeX2e package based on the flowfram package

   - PNG image files

   - SVG image files

ABOUT Jdrview:
=============

Jdrview is a Java application for viewing JDR or AJR files.
It is primarily intended as a convenient way of viewing images
created when developing applications that create JDR or AJR files.

ABOUT jdrutils:
==============

jdrutils is a suite of command line applications for converting
to or from AJR or JDR files. This consists of:

ajr2jdr	: AJR to JDR converter
ajr2tex	: AJR to TeX converter (creates pgfpicture environment)
eps2jdr	: EPS to JDR converter (still highly experimental)
jdr2ajr	: JDR to AJR converter
jdr2eps	: JDR to EPS converter
jdr2png	: JDR to PNG converter
jdr2svg	: JDR to SVG converter
jdr2tex	: JDR to TeX converter (creates pgfpicture environment)

There currently isn't a command line tool to convert AJR/JDR files
to a LaTeX package based on the flowfram package. This can only
be done via FlowframTk's export tool.

Important Note For KDE Users
============================

Please note the following bugs:

http://bugs.kde.org/show_bug.cgi?id=135146
http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6449451

They are beyond my control, so if you use flowframtk (or indeed
any Java application) running on KDE, please save your work
regularly in the event that you have to kill the application.
I have only tested with Java version 1.5.0_09. It is possible
the latest version of Java has fixed these problems.
