bmeps - convert PNG/JPEG/NetPBM to EPS

# bmeps |
Convert PNG/JPEG/NetPBM to EPS

Overview / Installation / Usage / FAQ / Change Log / Other Projects

## Installation | PDF manual "bmeps.pdf" available

| Install required and recommended libraries
|  | Required libraries
|  | Recommended optional libraries
| Download and install the bmeps package (required)
| Add bmeps support to dvips (optional)
| Windows installation

### Install required and recommended libraries

#### Required libraries

The following libraries are required to install the bmeps package:

- zlib (compression library)
  http://www.gzip.org/zlib
- libpng (PNG reference library)
  http://www.libpng.org/pub/png/libpng.html

#### Recommended optional libraries

The following libraries are optional, but recommended:

- jpeglib (Independent JPEG Group's free JPEG software)
  ftp://ftp.uu.net/graphics/jpeg/jpegsrc.v6b.tar.gz
- NetPBM
  ftp://ftp.metalab.unc.edu/pub/Linux/apps/graphics/convert/netpbm-10.11.10.tgz

Note: If you installed these packages using your OS vendors package management software make sure the header files... are also installed.
Some systems have separated packages: one for binaries and shared libraries and an additional one (mostly called "xxx developer support") containing C header files and other material needed to compile programs using the library.

### Download and install the bmeps package (required)

The software is available via the SourceForge.net project page at http://sourceforge.net/projects/bmeps.
After unpacking the source package use

      ./configure
      make
      make install

to build and install the the bmeps package. Make sure to have the environment variables `CC`, `CPPFLAGS`, `CFLAGS`, `LD` and `LDFLAGS` set properly.
Experienced users on Linux can use

      ./configure
      make -f Makefile-shared-linux
      make -f Makefile-shared-linux install

to build a shared library libbmeps.so and a binary bmeps using this shared library. But this is not recommended for the wide majority of users, only experienced users, developers and people creating binary installation packages for Linux distributions or LaTeX distributions should do so. You need to make sure that libbmeps.so is found when the bmeps program is run. You may either add the directory where libbmeps.so is installed to LD_LIBRARY_PATH environment variable or list the directory in the /etc/ld.so.conf file. Please consult your systems manuals for details about placing shared libraries and configuring library search.

### Add bmeps support to dvips (optional)

Adding bmeps support to dvips is not a simple task. It requires knowledge about using your development tools, the TeX directory structure and how to compile parts of your LaTeX distribution.
Furthermore you need the source code for the kpathsea library and dvipsk.

- Create a backup copy of your working kpathsea library and dvips executable.
- Build the kpathsea library and the unmodified dvips.
  Unpack the kpathsea source code, change into the source directory and run

        ./configure
        make
        make install

  Unpack the dvipsk source code, change into the source directory and run

        ./configure
        make
        make install

  Note: For both packages you may need to specify options to configure. These options depend on the OS and LaTeX distribution you use.
  The options are mainly provided to define directory locations, i.e. prefix, sysconfdir...
  You need to consult the documentation for your OS/Linux distribution/LaTeX distribution.
- Test the new unmodified dvips.
  After installing the unmodified dvips you should test, whether it works as expected.
- Build the modified dvips
  Run

        dvips --version

  to find the version number for your dvips. The dvips-mods directory contains subdirectories for different versions. From the subdirectory matching your version number copy all the contents into the dvipsk source directory.
  Change into the dvipsk source directory and run

        ./configure
        make
        make install

  You have to specify the same arguments to configure as before when building the unmodified dvips.
- Test the modified dvips.
  Run

        dvips --version

  and check for the text "modified for bitmap grapics support".
  Make tests whether the new binary works as expected.

### Windows installation

Building the libraries and the programs using the libraries on Windows systems from source requires manual changes in makefiles. Good skills in using the development tools and a significant amount of time is needed to do that.
So it is recommended to use the setup program in dklibs-win32-*-setup.exe from http://sourceforge.net/projects/dklibs.
This program installs dklibs, dktools, bmeps, png2pdf, yanolc and genau.
There are two different setup programs:

- A small executable dklibs_win32-*-user-setup.exe to install software for users (binaries and documentation) and
- a larger executable dklibs-win32-*-dev-setup.exe to install the software for developers (binaries, documentation, libraries, used libraries and sources).

For both executables you can choose either english or german language.