------------------------------------------------------
ps2img: the PostScript to bitmap image conversion tool
------------------------------------------------------

This tool has been tested as of today only on Linux. There are chances that
it compiles on other unices, and to compile it on other platforms some minimal
changes will be needed (like getting rid of fork() in syslib.cpp). However,
all the system-dependent code has been carefully separated from the main
code, which is (I hope) ANSI C++, thus porting to new platforms should be
a fairly easy task.

To get a description of the tool and for usage info look in the manual page.
In several words it is a tool that post-processes the output of GhostScript
to get high-quality antialiased images with transparency from PostScript files
(in particular useful to get better images for latex2html converted documents).

To compile the tool just run "make". You should have GNU Make, or it won't
work.

To install type "make install" as root.

The ps2img tool itself is GPL'ed. The libraries under libs/ and include/
are LGPL'ed. The corresponding licenses are in COPYING.GPL and COPYING.LGPL
respectively.

Example makefile for converting latex documents to html format using latex2html
tool and ps2img for images:

-------------------------------------------------------- cat here
# These are document names to be converted without extension
TARGETS = doc1 doc2 doc3 doc4

all: $(TARGETS)

ifndef TARGET
.PHONY: $(TARGETS)
$(TARGETS):
	$(MAKE) TARGET=$@
else
$(TARGET): $(TARGET)/$(TARGET).html
endif

$(TARGET)/$(TARGET).html: $(TARGET).tex
	latex2html -no_images $<
	cd $(TARGET) && \
	pslatex images.tex && \
	dvips -o images.ps images.dvi -mode toshiba -D180 && \
	ps2img -fgt -r144 -a2 -b#a0c0e0 images.ps
-------------------------------------------------------- cat there

That's all that has to be said.

Andrew Zabolotny,
    <bit@eltech.ru>
