Main Page

Fugenschnitzer— Overview For Experts And Developers

What Is Fugenschnitzer?

Fugenschnitzer is a Seam Carving program library and an application program basing on it, written 2008/2009 in C and Python by David Eckardt, and published under the terms and conditions of the GNU General Public License (GPL) 3 and the GNU Lesser General Public License (LGPL) 3.
Fugenschnitzer is a Source-Forge-Projekt: http://fugenschnitzer.sourceforge.net
More information can be found on the main page.

Program Components

Fugenschnitzer consists of these components:

1. Fugenschnitzer Program Library
2. Fugenschnitzer-Application Program
   • with graphic user interface (GUI)
   • for the command line (CLI)

What Is Seam Carving?

Seam Carving is a method for resizing images (bitmap graphics). Seam Carving was introduced in 2007 by Ariel Shamir and Shai Avidan. A comprehensive explanation of this method can be found on http://www.seamcarving.com.

What Are Fugenschnitzer's Special Features?

Fugenschnitzer is

• small and fast: The Fugenschnitzer Program Library is written in C and does not use any libraries except the C stdlib. The executable is 30 – 50 kB in size. The computation routines are suitable for accelerated execution on multi core CPU systems.
• flexible and easy to integrate: The Fugenschnitzer Program Library provides a conveniant programming interface and can be invoked by application programs with few effort. Furthermore, the library functions do not specify a certain image file format.
• portable: The Fugenschnitzer Program Library and Application Programs are written in portable, cross-platform langues—C and Python—and use libraries and toolkits which are available for many platforms.
  Especially the Fugenschnitzer Program Library only uses the C Standard Library and no platform or machine specifiy extensions.
• free Software: Fugenschnitzer is published under the terms and conditions of the GNU GPL/LGPL 3 and therefore may freely be used and further developed by everyone. The Fugenschnitzer Program Library may be included into non-free software under the terms and conditions of the GNU LGPL 3.

The Fugenschnitzer Program Library

The Fugenschnitzer Program Library contails the actual Seam Carving implementation. Its functions contain the routines which neccessary to resize a loaded image and a couple of useful tools.
The library is written in plain C (C99) and contains about 3000 lines of source code. The source code intentionally does not contain any machine or platform specific instructions or assumptions in order to archieve a high portability. (The only exception from this is the image data byte order (endianness).) Furthermore, the program library depends only on the C99 standard library.
The Fugenschnitzer Program Library is invoked by an application program as a dynamic run-time library.

The Fugenschnitzer Application Programs

Two Fugenschnitzer Application Programs are available: One with a graphic user interface (GUI) and another one command line based (CLI). Both represent a user interface to control the Fugenschnitzer library functions and to load and save an image. The command line program additionally serves as example how to invoke and use the Fugenschnitzer-Bibliothek with a C program.

GUI Version

The GUI version is written in Python 2.6 and uses the GUI Toolkit wxPython 2.8.9. Invocation of the Fugenschnitzer library is done through the Python ctypes module.

CLI-Version

Like the Fugenschnitzer library, the CLI Version is written in C99 and uses the libpng to load and save images in the PNG format.

Where To Get Fugenschnitzer?

You can retrieve Fugenschnitzer via these links:

• Front page
• Main page with downloads overview
• SourceForge.net download main page

Compiling

Compiling The Fugenschnitzer Program Library with GCC

Prerequisites

To compile the Fugenschnitzer Program Library, GCC 4 or higher is reqired.

• Windows: A recommendable GNU/GCC Windows port is Minimalist GNU for Windows (MinGW). The Twilight Dragon Media (TDM) project offers the newest GCC Windows ports.
  • MinGW: http://www.mingw.org
  • GCC ports at TDM: http://www.tdragon.net/recentgcc
• OS X: GCC 4 is included in the Apple Developer Tools:
  • http://developer.apple.com/mac

Preparing The Source Code

First download the source code package and extract it into any directory. Then open the Makefile with a text editor and remove the comment characters in the section of the target platform. For more information see the Makefile.

Compiling The Library

After editing the Makefile, enter
> make
to compile the library.

Compiling The Fugenschnitzer CLI Application with GCC

Prerequisites

This also requires GCC 4 or higher and additionally:

• the Fugenschnitzer Program Library
• the libpng: http://www.libpng.org
• on Windows also:
  • the zlib: http://www.zlib.net
  • pthreads: http://sourceware.org/pthreads-win32

Preparing The Source Code

Here applies same as for compiling the library. Additionally, the Fugenschnitzer library must be placed in the source code directory or in the search path for external libraries. The library is a single file named as follows:

The include header seamcarv.h must also be placed in the include search path or in the source code directory.

Compiling The Application

This is also done by
> make
.