Installation |
PDF manual "bmeps.pdf" available |
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
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 installto 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 installto 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
Rundvips --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.
Rundvips --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).