bmeps - convert PNG/JPEG/NetPBM to EPS

# bmeps |
Convert PNG/JPEG/NetPBM to EPS

Overview / Installation / Usage / FAQ / Change Log

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

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

### 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

### Install the bmeps package (required)

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.

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