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)
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)
int	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.

---

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:

int paps_postscript_points_to_pango (  double  points  )

Utility function that translates from postscript points to pango units. Parameters: points  Returns:

---