-*- text -*-
FrontLine
GUI FRONT end for autotrace that extracts outLINE from images
What is frontline?
------------------
Frontline provides a gtk+/gnome based GUI front end for
autotrace (http://autotrace.sourceforge.net) in 4 ways.
1. Stand alone program. A command `frontline' runs as a stand alone
program. It will work well with Gnome desktop and nautilus.
2. Reusable library. A library `libfrontline.a' could be used as a
building block of your application that needs the autotrace function.
APIs are listed in frontline.h. The stand alone program frontline
itself uses libfrontline.a.
3. Sodipodi, a drawing editor add-on module. add-on module uses the
libfrontline.a. See below.
4. The Gimp plug-in, You can launch frontline from the Gimp's menu.
Select "<Image>/Filters/Trace/Trace..." . See "the Gimp plug-in".
You can open trace result on sodipodi with DnD operation: dragging
from the trace result window of frontline to sodipodi toolbox.
Requirements
------------
- Autotrace 0.31.1(http://autotrace.sourceforge.net) or higher
- Gnome 1.4 environment
Gnome 1.4 might include popt and Imlib.
- libart_lgpl-2.3.8 or higher(ftp://ftp.gnome.org/pub/gnome/pre-gnome2/sources/libart_lgpl/)
libart_lgpl in Gnome 1.4 has a bug that hangs up frontline.
- The Gimp 1.2(optional) to use as gimp plug-in. Even if you have the Gimp,
check whether gimptool command and libgimp.{so|a} are also installed.
In Some of GNU/Linux distributions, gimp package includes gimp command only;
and only gimp package is installed by default. gimptool and/or libgimp
might be in gimp-devel package in such case. You have to install gimp-devel
package.
Install
-------
See INSTALL.
The Gimp plug-in
----------------
To get better tracing result in frontline, you might want to apply a
filter to original image as prepossess. The Gimp much helps you to do
so. Most useful filter is Filter->Enhance->Sharpen. This filter
improves the trace results for anti-aliased images.
Sodipodi add-on module
----------------------
- How to setup:
0. Build and Install frontline
1. Build and Install sodipodi-0.27 or higher.
sodipodi's configure will detect frontline.
Sometimes two versions of libxml will conflict when
building sodipodi with frontline; sodipodi uses libxml
and Imagemagick linked to autotrace uses libxml2. In
such case, you should disable libxml function in Imagemagick
with passing --without-xml to configure of Imagemagick.
Here is the dependency:
sodipodi -> frontline -> autotrace -> Imagemagick
V V
libxml libxml2
- How to use:
0. run newly built sodipodi
1. Create a new document window from the menu
2. Import an image into the document (something jpeg or png)
3. Show a context menu with pressing right mouse button on the
imported image; and select Image->Trace item. You'll find
Trace dialog.
4. Change the parameters on the dialog if you need.
5. Press the Trace button on the dialog.
6. You'll get the trace result as a new document of sodipodi.
Mailing list and Web site
-------------------------
We discussed on autotrace mailing list.
See http://groups.yahoo.com/group/autotrace/.
The latest version will be available from:
http://autotrace.sourceforge.net/frontline/
Known Bugs and TODO
-------------------
- Bugs: See BUGS file.
- TODO: See TODO file.
Contact
-------
Masatake YAMATO<jet@gyve.org>