#include <string.h>
#include "allheaders.h"

Functions
l_ok	convertFilesToPS (const char dirin, const char substr, l_int32 res, const char *fileout)

l_ok	sarrayConvertFilesToPS (SARRAY sa, l_int32 res, const char fileout)

l_ok	convertFilesFittedToPS (const char dirin, const char substr, l_float32 xpts, l_float32 ypts, const char *fileout)

l_ok	sarrayConvertFilesFittedToPS (SARRAY sa, l_float32 xpts, l_float32 ypts, const char fileout)

l_ok	writeImageCompressedToPSFile (const char filein, const char fileout, l_int32 res, l_int32 *pindex)

l_ok	convertSegmentedPagesToPS (const char pagedir, const char pagestr, l_int32 page_numpre, const char maskdir, const char maskstr, l_int32 mask_numpre, l_int32 numpost, l_int32 maxnum, l_float32 textscale, l_float32 imagescale, l_int32 threshold, const char *fileout)

l_ok	pixWriteSegmentedPageToPS (PIX pixs, PIX pixm, l_float32 textscale, l_float32 imagescale, l_int32 threshold, l_int32 pageno, const char *fileout)

l_ok	pixWriteMixedToPS (PIX pixb, PIX pixc, l_float32 scale, l_int32 pageno, const char *fileout)

l_ok	convertToPSEmbed (const char filein, const char fileout, l_int32 level)

l_ok	pixaWriteCompressedToPS (PIXA pixa, const char fileout, l_int32 res, l_int32 level)

l_ok	pixWriteCompressedToPS (PIX pix, const char fileout, l_int32 res, l_int32 level, l_int32 *pindex)

Detailed Description


   |=============================================================|
   |                         Important note                      |
   |=============================================================|
   | Some of these functions require I/O libraries such as       |
   | libtiff, libjpeg, and libz.  If you do not have these       |
   | libraries, some calls will fail.                            |
   |                                                             |
   | You can manually deactivate all PostScript writing by       |
   | setting this in environ.h:                                  |
   | |
  |     #define  USE_PSIO     0                                 |
  | 
                                                    |
   | in environ.h.  This will link psio1stub.c                   |
   |=============================================================|

    This is a PostScript "device driver" for wrapping images
    in PostScript.  The images can be rendered by a PostScript
    interpreter for viewing, using evince or gv.  They can also be
    rasterized for printing, using gs or an embedded interpreter
    in a PostScript printer.  And they can be converted to a pdf
    using gs (ps2pdf).

    Convert specified files to PS
         l_int32          convertFilesToPS()
         l_int32          sarrayConvertFilesToPS()
         l_int32          convertFilesFittedToPS()
         l_int32          sarrayConvertFilesFittedToPS()
         l_int32          writeImageCompressedToPSFile()

    Convert mixed text/image files to PS
         l_int32          convertSegmentedPagesToPS()
         l_int32          pixWriteSegmentedPageToPS()
         l_int32          pixWriteMixedToPS()

    Convert any image file to PS for embedding
         l_int32          convertToPSEmbed()

    Write all images in a pixa out to PS
         l_int32          pixaWriteCompressedToPS()
         l_int32          pixWriteCompressedToPS()

 These PostScript converters are used in three different ways.

 (1) For embedding a PS file in a program like TeX.
     convertToPSEmbed() handles this for levels 1, 2 and 3 output,
     and prog/converttops wraps this in an executable.
     converttops is a generalization of Thomas Merz's jpeg2ps wrapper,
     in that it works for all types (formats, depth, colormap)
     of input images and gives PS output in one of these formats
       * level 1 (uncompressed)
       * level 2 (compressed ccittg4 or dct)
       * level 3 (compressed flate)

 (2) For composing a set of pages with any number of images
     painted on them, in either level 2 or level 3 formats.

 (3) For printing a page image or a set of page images, at a
     resolution that optimally fills the page, using
     convertFilesFittedToPS().

 The top-level calls of utilities in category 2, which can compose
 multiple images on a page, and which generate a PostScript file for
 printing or display (e.g., conversion to pdf), are:
     convertFilesToPS()
     convertFilesFittedToPS()
     convertSegmentedPagesToPS()

 All images are output with page numbers.  Bounding box hints are
 more subtle.  They must be included for embeding images in
 TeX, for example, and the low-level writers include bounding
 box hints by default.  However, these hints should not be included for
 multi-page PostScript that is composed of a sequence of images;
 consequently, they are not written when calling higher level
 functions such as convertFilesToPS(), convertFilesFittedToPS()
 and convertSegmentedPagesToPS().  The function l_psWriteBoundingBox()
 sets a flag to give low-level control over this.

Definition in file psio1.c.

Function Documentation

◆ convertFilesFittedToPS()

l_ok convertFilesFittedToPS	(	const char *	dirin,
		const char *	substr,
		l_float32	xpts,
		l_float32	ypts,
		const char *	fileout )

Definition at line 273 of file psio1.c.

◆ convertFilesToPS()

l_ok convertFilesToPS	(	const char *	dirin,
		const char *	substr,
		l_int32	res,
		const char *	fileout )

Definition at line 163 of file psio1.c.

◆ convertSegmentedPagesToPS()

l_ok convertSegmentedPagesToPS	(	const char *	pagedir,
		const char *	pagestr,
		l_int32	page_numpre,
		const char *	maskdir,
		const char *	maskstr,
		l_int32	mask_numpre,
		l_int32	numpost,
		l_int32	maxnum,
		l_float32	textscale,
		l_float32	imagescale,
		l_int32	threshold,
		const char *	fileout )

Definition at line 482 of file psio1.c.

◆ convertToPSEmbed()

l_ok convertToPSEmbed	(	const char *	filein,
		const char *	fileout,
		l_int32	level )

Definition at line 812 of file psio1.c.

◆ pixaWriteCompressedToPS()

l_ok pixaWriteCompressedToPS	(	PIXA *	pixa,
		const char *	fileout,
		l_int32	res,
		l_int32	level )

Definition at line 914 of file psio1.c.

◆ pixWriteCompressedToPS()

l_ok pixWriteCompressedToPS	(	PIX *	pix,
		const char *	fileout,
		l_int32	res,
		l_int32	level,
		l_int32 *	pindex )

Definition at line 986 of file psio1.c.

◆ pixWriteMixedToPS()

l_ok pixWriteMixedToPS	(	PIX *	pixb,
		PIX *	pixc,
		l_float32	scale,
		l_int32	pageno,
		const char *	fileout )

Definition at line 727 of file psio1.c.

◆ pixWriteSegmentedPageToPS()

l_ok pixWriteSegmentedPageToPS	(	PIX *	pixs,
		PIX *	pixm,
		l_float32	textscale,
		l_float32	imagescale,
		l_int32	threshold,
		l_int32	pageno,
		const char *	fileout )

Definition at line 578 of file psio1.c.

◆ sarrayConvertFilesFittedToPS()

l_ok sarrayConvertFilesFittedToPS	(	SARRAY *	sa,
		l_float32	xpts,
		l_float32	ypts,
		const char *	fileout )

Definition at line 323 of file psio1.c.

◆ sarrayConvertFilesToPS()

l_ok sarrayConvertFilesToPS	(	SARRAY *	sa,
		l_int32	res,
		const char *	fileout )

Definition at line 208 of file psio1.c.

◆ writeImageCompressedToPSFile()

l_ok writeImageCompressedToPSFile	(	const char *	filein,
		const char *	fileout,
		l_int32	res,
		l_int32 *	pindex )

Definition at line 389 of file psio1.c.

Functions