libpaps.h File Reference

Interface for converting pango layouts into postscript. More...

#include <glib.h>
#include <pango/pango.h>

Go to the source code of this file.

Typedefs
typedef void	paps_t
Functions
paps_t *	paps_new ()
void	paps_free (paps_t *paps)
void	paps_set_scale (paps_t *paps, gdouble scale_x, gdouble scale_y)
PangoContext *	paps_get_pango_context ()
gchar *	paps_get_postscript_header_strdup (paps_t *paps)
gchar *	paps_layout_to_postscript_strdup (paps_t *paps, double pos_x, double pos_y, PangoLayout *layout)
gchar *	paps_layout_line_to_postscript_strdup (paps_t *paps, double pos_x, double pos_y, PangoLayoutLine *layout_line)
double	paps_postscript_points_to_pango (double points)

---

Detailed Description

Interface for converting pango layouts into postscript.

The library is used by first creating a paps object through paps_new(). The paps object is then used to generate PostScript for one or more pango layouts through paps_layout_to_postscript_strdup() or paps_layout_line_to_postscript_strdup(). Once all the layouts have been processed, the system may generate the PostScript header through paps_get_postscript_header_strdup(). It is the responsibility of the caller to place the PostScript header in front of the renderings of the pango layouts.

The PostScript of the rendered layouts is relocatable in all sense so any postscript operators may be used to change their colors, transformations etc.

---

Typedef Documentation

typedef void paps_t

The paps handle taht is used in all interactions with the paps library.

---

Function Documentation

void paps_free

(

paps_t *

paps

)

Delete the paps object and free any allocated memory associated with it.

Parameters:

paps

PangoContext* paps_get_pango_context

(

)

libpaps may currently be used only with a PangoContext that it is creating. The context returned may of course be changed though by any routines related to a PangoContext.

Returns:

gchar* paps_get_postscript_header_strdup

(

paps_t *

paps

)

paps_get_postscript_header_strdup() returns the header and the font definitions related to the glyphs being used. This routine must only be called after the processing of all the strings is over.

Parameters:

paps

Paps object

Returns:

A newly allocated string containing the postscript prologue needed for the postscript strings created by libpaps.

gchar* paps_layout_line_to_postscript_strdup	(	paps_t *	paps,
		double	pos_x,
		double	pos_y,
		PangoLayoutLine *	layout_line
	)

Create postscript related to a single PangoLayout line at position pos_x, pos_y (postscript coordinates). The related font definitions are stored internally and will be returned when doing paps_get_postscript_header_strdup.

Parameters:

	paps	Paps object
	pos_x	x-position
	pos_y	y-position
	layout_line	Layout line to render

Returns:

gchar* paps_layout_to_postscript_strdup	(	paps_t *	paps,
		double	pos_x,
		double	pos_y,
		PangoLayout *	layout
	)

Create postscript related to a PangoLayout at position pos_x, pos_y (postscript coordinates). The related font definitions are stored internally and will be returned when doing paps_get_postscript_header_strdup.

Parameters:

	paps	Paps object
	pos_x	x-position
	pos_y	y-position
	layout	Layout to render

Returns:

paps_t* paps_new

(

)

Create a new paps object that may subsequently be used for generating postscript strings.

Returns:

double paps_postscript_points_to_pango

(

double

points

)

Utility function that translates from postscript points to pango units.

Parameters:

points

Returns:

void paps_set_scale	(	paps_t *	paps,
		gdouble	scale_x,
		gdouble	scale_y
	)

Set the scales for characters.

Parameters:

	paps	Paps object
	scale_x	x-coordinate scale
	scale_y	y-coordinate scale

---