git.sur5r.net Git - glabels/blob - docs/libglabels/html/libglabels-3.0-template.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html>
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   5 <title>The lglTemplate Structure</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
   7 <link rel="home" href="index.html" title="LibGlabels 3.0 Reference Manual">
   8 <link rel="up" href="ch01.html" title="Basic LibGlabels Usage">
   9 <link rel="prev" href="libglabels-3.0-db.html" title="Database">
  10 <link rel="next" href="libglabels-3.0-paper.html" title="The lglPaper Structure">
  11 <meta name="generator" content="GTK-Doc V1.17 (XML mode)">
  12 <link rel="stylesheet" href="style.css" type="text/css">
  13 </head>
  14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
  16 <tr valign="middle">
  17 <td><a accesskey="p" href="libglabels-3.0-db.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  18 <td><a accesskey="u" href="ch01.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
  19 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
  20 <th width="100%" align="center">LibGlabels 3.0 Reference Manual</th>
  21 <td><a accesskey="n" href="libglabels-3.0-paper.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
  22 </tr>
  23 <tr><td colspan="5" class="shortcuts">
  24 <a href="#libglabels-3.0-template.synopsis" class="shortcut">Top</a>
  25                    |
  26                   <a href="#libglabels-3.0-template.description" class="shortcut">Description</a>
  27 </td></tr>
  28 </table>
  29 <div class="refentry">
  30 <a name="libglabels-3.0-template"></a><div class="titlepage"></div>
  31 <div class="refnamediv"><table width="100%"><tr>
  32 <td valign="top">
  33 <h2><span class="refentrytitle"><a name="libglabels-3.0-template.top_of_page"></a>The lglTemplate Structure</span></h2>
  34 <p>The lglTemplate Structure — How templates are represented in memory</p>
  35 </td>
  36 <td valign="top" align="right"></td>
  37 </tr></table></div>
  38 <div class="refsynopsisdiv">
  39 <a name="libglabels-3.0-template.synopsis"></a><h2>Synopsis</h2>
  40 <pre class="synopsis">
  41 #include &lt;libglabels/lgl-template.h&gt;
  42
  43 struct              <a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate">lglTemplate</a>;
  44
  45 enum                <a class="link" href="libglabels-3.0-template.html#lglTemplateFrameShape" title="enum lglTemplateFrameShape">lglTemplateFrameShape</a>;
  46 union               <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame">lglTemplateFrame</a>;
  47 struct              <a class="link" href="libglabels-3.0-template.html#lglTemplateFrameAll" title="struct lglTemplateFrameAll">lglTemplateFrameAll</a>;
  48 struct              <a class="link" href="libglabels-3.0-template.html#lglTemplateFrameRect" title="struct lglTemplateFrameRect">lglTemplateFrameRect</a>;
  49 struct              <a class="link" href="libglabels-3.0-template.html#lglTemplateFrameEllipse" title="struct lglTemplateFrameEllipse">lglTemplateFrameEllipse</a>;
  50 struct              <a class="link" href="libglabels-3.0-template.html#lglTemplateFrameRound" title="struct lglTemplateFrameRound">lglTemplateFrameRound</a>;
  51 struct              <a class="link" href="libglabels-3.0-template.html#lglTemplateFrameCD" title="struct lglTemplateFrameCD">lglTemplateFrameCD</a>;
  52
  53 struct              <a class="link" href="libglabels-3.0-template.html#lglTemplateLayout" title="struct lglTemplateLayout">lglTemplateLayout</a>;
  54
  55 enum                <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkupType" title="enum lglTemplateMarkupType">lglTemplateMarkupType</a>;
  56 union               <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup">lglTemplateMarkup</a>;
  57 struct              <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkupMargin" title="struct lglTemplateMarkupMargin">lglTemplateMarkupMargin</a>;
  58 struct              <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkupLine" title="struct lglTemplateMarkupLine">lglTemplateMarkupLine</a>;
  59 struct              <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkupCircle" title="struct lglTemplateMarkupCircle">lglTemplateMarkupCircle</a>;
  60 struct              <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkupRect" title="struct lglTemplateMarkupRect">lglTemplateMarkupRect</a>;
  61 struct              <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkupEllipse" title="struct lglTemplateMarkupEllipse">lglTemplateMarkupEllipse</a>;
  62
  63 struct              <a class="link" href="libglabels-3.0-template.html#lglTemplateOrigin" title="struct lglTemplateOrigin">lglTemplateOrigin</a>;
  64
  65 <a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="returnvalue">lglTemplate</span></a> *       <a class="link" href="libglabels-3.0-template.html#lgl-template-new" title="lgl_template_new ()">lgl_template_new</a>                    (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *brand</code></em>,
  66                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *part</code></em>,
  67                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *description</code></em>,
  68                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *paper_id</code></em>,
  69                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> page_width</code></em>,
  70                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> page_height</code></em>);
  71 <a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="returnvalue">lglTemplate</span></a> *       <a class="link" href="libglabels-3.0-template.html#lgl-template-new-from-equiv" title="lgl_template_new_from_equiv ()">lgl_template_new_from_equiv</a>         (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *brand</code></em>,
  72                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *part</code></em>,
  73                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *equiv_part</code></em>);
  74 <a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="returnvalue">lglTemplate</span></a> *       <a class="link" href="libglabels-3.0-template.html#lgl-template-dup" title="lgl_template_dup ()">lgl_template_dup</a>                    (<em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="type">lglTemplate</span></a> *orig_template</code></em>);
  75 <span class="returnvalue">void</span>                <a class="link" href="libglabels-3.0-template.html#lgl-template-free" title="lgl_template_free ()">lgl_template_free</a>                   (<em class="parameter"><code><a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="type">lglTemplate</span></a> *template</code></em>);
  76 <span class="returnvalue">void</span>                <a class="link" href="libglabels-3.0-template.html#lgl-template-add-category" title="lgl_template_add_category ()">lgl_template_add_category</a>           (<em class="parameter"><code><a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="type">lglTemplate</span></a> *template</code></em>,
  77                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *category_id</code></em>);
  78 <span class="returnvalue">void</span>                <a class="link" href="libglabels-3.0-template.html#lgl-template-add-frame" title="lgl_template_add_frame ()">lgl_template_add_frame</a>              (<em class="parameter"><code><a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="type">lglTemplate</span></a> *template</code></em>,
  79                                                          <em class="parameter"><code><a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> *frame</code></em>);
  80
  81 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="libglabels-3.0-template.html#lgl-template-get-name" title="lgl_template_get_name ()">lgl_template_get_name</a>               (<em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="type">lglTemplate</span></a> *template</code></em>);
  82 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libglabels-3.0-template.html#lgl-template-do-templates-match" title="lgl_template_do_templates_match ()">lgl_template_do_templates_match</a>     (<em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="type">lglTemplate</span></a> *template1</code></em>,
  83                                                          <em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="type">lglTemplate</span></a> *template2</code></em>);
  84 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libglabels-3.0-template.html#lgl-template-does-brand-match" title="lgl_template_does_brand_match ()">lgl_template_does_brand_match</a>       (<em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="type">lglTemplate</span></a> *template</code></em>,
  85                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *brand</code></em>);
  86 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libglabels-3.0-template.html#lgl-template-does-page-size-match" title="lgl_template_does_page_size_match ()">lgl_template_does_page_size_match</a>   (<em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="type">lglTemplate</span></a> *template</code></em>,
  87                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *paper_id</code></em>);
  88 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libglabels-3.0-template.html#lgl-template-does-category-match" title="lgl_template_does_category_match ()">lgl_template_does_category_match</a>    (<em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="type">lglTemplate</span></a> *template</code></em>,
  89                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *category_id</code></em>);
  90 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="libglabels-3.0-template.html#lgl-template-are-templates-identical" title="lgl_template_are_templates_identical ()">lgl_template_are_templates_identical</a>
  91                                                         (<em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="type">lglTemplate</span></a> *template1</code></em>,
  92                                                          <em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="type">lglTemplate</span></a> *template2</code></em>);
  93
  94 <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="returnvalue">lglTemplateFrame</span></a> *  <a class="link" href="libglabels-3.0-template.html#lgl-template-frame-rect-new" title="lgl_template_frame_rect_new ()">lgl_template_frame_rect_new</a>         (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>,
  95                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> w</code></em>,
  96                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> h</code></em>,
  97                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> r</code></em>,
  98                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> x_waste</code></em>,
  99                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> y_waste</code></em>);
 100 <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="returnvalue">lglTemplateFrame</span></a> *  <a class="link" href="libglabels-3.0-template.html#lgl-template-frame-ellipse-new" title="lgl_template_frame_ellipse_new ()">lgl_template_frame_ellipse_new</a>      (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>,
 101                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> w</code></em>,
 102                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> h</code></em>,
 103                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> waste</code></em>);
 104 <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="returnvalue">lglTemplateFrame</span></a> *  <a class="link" href="libglabels-3.0-template.html#lgl-template-frame-round-new" title="lgl_template_frame_round_new ()">lgl_template_frame_round_new</a>        (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>,
 105                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> r</code></em>,
 106                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> waste</code></em>);
 107 <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="returnvalue">lglTemplateFrame</span></a> *  <a class="link" href="libglabels-3.0-template.html#lgl-template-frame-cd-new" title="lgl_template_frame_cd_new ()">lgl_template_frame_cd_new</a>           (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>,
 108                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> r1</code></em>,
 109                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> r2</code></em>,
 110                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> w</code></em>,
 111                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> h</code></em>,
 112                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> waste</code></em>);
 113 <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="returnvalue">lglTemplateFrame</span></a> *  <a class="link" href="libglabels-3.0-template.html#lgl-template-frame-dup" title="lgl_template_frame_dup ()">lgl_template_frame_dup</a>              (<em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> *orig_frame</code></em>);
 114 <span class="returnvalue">void</span>                <a class="link" href="libglabels-3.0-template.html#lgl-template-frame-free" title="lgl_template_frame_free ()">lgl_template_frame_free</a>             (<em class="parameter"><code><a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> *frame</code></em>);
 115 <span class="returnvalue">void</span>                <a class="link" href="libglabels-3.0-template.html#lgl-template-frame-add-layout" title="lgl_template_frame_add_layout ()">lgl_template_frame_add_layout</a>       (<em class="parameter"><code><a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> *frame</code></em>,
 116                                                          <em class="parameter"><code><a class="link" href="libglabels-3.0-template.html#lglTemplateLayout" title="struct lglTemplateLayout"><span class="type">lglTemplateLayout</span></a> *layout</code></em>);
 117 <span class="returnvalue">void</span>                <a class="link" href="libglabels-3.0-template.html#lgl-template-frame-add-markup" title="lgl_template_frame_add_markup ()">lgl_template_frame_add_markup</a>       (<em class="parameter"><code><a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> *frame</code></em>,
 118                                                          <em class="parameter"><code><a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="type">lglTemplateMarkup</span></a> *markup</code></em>);
 119
 120 <span class="returnvalue">void</span>                <a class="link" href="libglabels-3.0-template.html#lgl-template-frame-get-size" title="lgl_template_frame_get_size ()">lgl_template_frame_get_size</a>         (<em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> *frame</code></em>,
 121                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *w</code></em>,
 122                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *h</code></em>);
 123 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                <a class="link" href="libglabels-3.0-template.html#lgl-template-frame-get-n-labels" title="lgl_template_frame_get_n_labels ()">lgl_template_frame_get_n_labels</a>     (<em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> *frame</code></em>);
 124 <a class="link" href="libglabels-3.0-template.html#lglTemplateOrigin" title="struct lglTemplateOrigin"><span class="returnvalue">lglTemplateOrigin</span></a> * <a class="link" href="libglabels-3.0-template.html#lgl-template-frame-get-origins" title="lgl_template_frame_get_origins ()">lgl_template_frame_get_origins</a>      (<em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> *frame</code></em>);
 125 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="libglabels-3.0-template.html#lgl-template-frame-get-layout-description" title="lgl_template_frame_get_layout_description ()">lgl_template_frame_get_layout_description</a>
 126                                                         (<em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> *frame</code></em>);
 127 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             <a class="link" href="libglabels-3.0-template.html#lgl-template-frame-get-size-description" title="lgl_template_frame_get_size_description ()">lgl_template_frame_get_size_description</a>
 128                                                         (<em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> *frame</code></em>,
 129                                                          <em class="parameter"><code><a class="link" href="libglabels-3.0-units.html#lglUnits" title="enum lglUnits"><span class="type">lglUnits</span></a> units</code></em>);
 130
 131 <a class="link" href="libglabels-3.0-template.html#lglTemplateLayout" title="struct lglTemplateLayout"><span class="returnvalue">lglTemplateLayout</span></a> * <a class="link" href="libglabels-3.0-template.html#lgl-template-layout-new" title="lgl_template_layout_new ()">lgl_template_layout_new</a>             (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> nx</code></em>,
 132                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> ny</code></em>,
 133                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> x0</code></em>,
 134                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> y0</code></em>,
 135                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> dx</code></em>,
 136                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> dy</code></em>);
 137 <a class="link" href="libglabels-3.0-template.html#lglTemplateLayout" title="struct lglTemplateLayout"><span class="returnvalue">lglTemplateLayout</span></a> * <a class="link" href="libglabels-3.0-template.html#lgl-template-layout-dup" title="lgl_template_layout_dup ()">lgl_template_layout_dup</a>             (<em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplateLayout" title="struct lglTemplateLayout"><span class="type">lglTemplateLayout</span></a> *orig_layout</code></em>);
 138 <span class="returnvalue">void</span>                <a class="link" href="libglabels-3.0-template.html#lgl-template-layout-free" title="lgl_template_layout_free ()">lgl_template_layout_free</a>            (<em class="parameter"><code><a class="link" href="libglabels-3.0-template.html#lglTemplateLayout" title="struct lglTemplateLayout"><span class="type">lglTemplateLayout</span></a> *layout</code></em>);
 139
 140 <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="returnvalue">lglTemplateMarkup</span></a> * <a class="link" href="libglabels-3.0-template.html#lgl-template-markup-margin-new" title="lgl_template_markup_margin_new ()">lgl_template_markup_margin_new</a>      (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> size</code></em>);
 141 <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="returnvalue">lglTemplateMarkup</span></a> * <a class="link" href="libglabels-3.0-template.html#lgl-template-markup-line-new" title="lgl_template_markup_line_new ()">lgl_template_markup_line_new</a>        (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> x1</code></em>,
 142                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> y1</code></em>,
 143                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> x2</code></em>,
 144                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> y2</code></em>);
 145 <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="returnvalue">lglTemplateMarkup</span></a> * <a class="link" href="libglabels-3.0-template.html#lgl-template-markup-circle-new" title="lgl_template_markup_circle_new ()">lgl_template_markup_circle_new</a>      (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> x0</code></em>,
 146                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> y0</code></em>,
 147                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> r</code></em>);
 148 <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="returnvalue">lglTemplateMarkup</span></a> * <a class="link" href="libglabels-3.0-template.html#lgl-template-markup-rect-new" title="lgl_template_markup_rect_new ()">lgl_template_markup_rect_new</a>        (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> x1</code></em>,
 149                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> y1</code></em>,
 150                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> w</code></em>,
 151                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> h</code></em>,
 152                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> r</code></em>);
 153 <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="returnvalue">lglTemplateMarkup</span></a> * <a class="link" href="libglabels-3.0-template.html#lgl-template-markup-ellipse-new" title="lgl_template_markup_ellipse_new ()">lgl_template_markup_ellipse_new</a>     (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> x1</code></em>,
 154                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> y1</code></em>,
 155                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> w</code></em>,
 156                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> h</code></em>);
 157 <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="returnvalue">lglTemplateMarkup</span></a> * <a class="link" href="libglabels-3.0-template.html#lgl-template-markup-dup" title="lgl_template_markup_dup ()">lgl_template_markup_dup</a>             (<em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="type">lglTemplateMarkup</span></a> *orig_markup</code></em>);
 158 <span class="returnvalue">void</span>                <a class="link" href="libglabels-3.0-template.html#lgl-template-markup-free" title="lgl_template_markup_free ()">lgl_template_markup_free</a>            (<em class="parameter"><code><a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="type">lglTemplateMarkup</span></a> *markup</code></em>);
 159
 160 <span class="returnvalue">void</span>                <a class="link" href="libglabels-3.0-template.html#lgl-template-print" title="lgl_template_print ()">lgl_template_print</a>                  (<em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="type">lglTemplate</span></a> *template</code></em>);
 161 </pre>
 162 </div>
 163 <div class="refsect1">
 164 <a name="libglabels-3.0-template.description"></a><h2>Description</h2>
 165 <p>
 166 This section describes a set of structures that represent a template in memory.  It also
 167 describes functions to help create and interpret these structures.
 168 </p>
 169 </div>
 170 <div class="refsect1">
 171 <a name="libglabels-3.0-template.details"></a><h2>Details</h2>
 172 <div class="refsect2">
 173 <a name="lglTemplate"></a><h3>struct lglTemplate</h3>
 174 <pre class="programlisting">struct lglTemplate {
 175         gchar               *brand;
 176         gchar               *part;
 177         gchar               *equiv_part;
 178
 179         gchar               *description;
 180         gchar               *paper_id;
 181         gdouble              page_width;
 182         gdouble              page_height;
 183
 184         /* Meta information. */
 185         gchar               *product_url;   /* URL to manufacturer's product website. */
 186         GList               *category_ids;  /* List of (gchar *) category ids. */
 187
 188         /* List of (lglTemplateFrame *) label frame structures.
 189          * Currently glabels only supports a single label frame per
 190          * template. */
 191         GList               *frames;
 192 };
 193 </pre>
 194 <p>
 195 This is the main structure of a libglabels template.  A template represents a single sheet
 196 of peel-off labels or cards.
 197 </p>
 198 <div class="variablelist"><table border="0">
 199 <col align="left" valign="top">
 200 <tbody>
 201 <tr>
 202 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="lglTemplate.brand"></a>brand</code></em>;</span></p></td>
 203 <td>Vendor or brand name of label or card.  E.g. "Avery."</td>
 204 </tr>
 205 <tr>
 206 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="lglTemplate.part"></a>part</code></em>;</span></p></td>
 207 <td>Part name or number of label or card.  E.g. "8160."</td>
 208 </tr>
 209 <tr>
 210 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="lglTemplate.equiv-part"></a>equiv_part</code></em>;</span></p></td>
 211 <td>Part name or number of a part with identical layout.  Must be from same vendor.</td>
 212 </tr>
 213 <tr>
 214 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="lglTemplate.description"></a>description</code></em>;</span></p></td>
 215 <td>A description of the template.  E.g. "Mailing labels."</td>
 216 </tr>
 217 <tr>
 218 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="lglTemplate.paper-id"></a>paper_id</code></em>;</span></p></td>
 219 <td>A paper ID.  E.g. "A4" or "US-Letter."</td>
 220 </tr>
 221 <tr>
 222 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplate.page-width"></a>page_width</code></em>;</span></p></td>
 223 <td>Page width in points.  Used only if paper_id is "Other."</td>
 224 </tr>
 225 <tr>
 226 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplate.page-height"></a>page_height</code></em>;</span></p></td>
 227 <td>Page height in points.  Used only if paper_id is "Other."</td>
 228 </tr>
 229 <tr>
 230 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="lglTemplate.product-url"></a>product_url</code></em>;</span></p></td>
 231 <td>URL to a webpage describing product.</td>
 232 </tr>
 233 <tr>
 234 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *<em class="structfield"><code><a name="lglTemplate.category-ids"></a>category_ids</code></em>;</span></p></td>
 235 <td>A list of category IDs that this template belongs to.</td>
 236 </tr>
 237 <tr>
 238 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *<em class="structfield"><code><a name="lglTemplate.frames"></a>frames</code></em>;</span></p></td>
 239 <td>A list of (<a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> *) structures.  GLabels currently only supports one frame
 240 per template -- future versions may support multiple frames per template.</td>
 241 </tr>
 242 </tbody>
 243 </table></div>
 244 </div>
 245 <hr>
 246 <div class="refsect2">
 247 <a name="lglTemplateFrameShape"></a><h3>enum lglTemplateFrameShape</h3>
 248 <pre class="programlisting">typedef enum {
 249         LGL_TEMPLATE_FRAME_SHAPE_RECT,
 250         LGL_TEMPLATE_FRAME_SHAPE_ELLIPSE,
 251         LGL_TEMPLATE_FRAME_SHAPE_ROUND,
 252         LGL_TEMPLATE_FRAME_SHAPE_CD
 253 } lglTemplateFrameShape;
 254 </pre>
 255 <p>
 256 This enumeration defines frame types that are supported by libglabels
 257 </p>
 258 <div class="variablelist"><table border="0">
 259 <col align="left" valign="top">
 260 <tbody>
 261 <tr>
 262 <td><p><a name="LGL-TEMPLATE-FRAME-SHAPE-RECT:CAPS"></a><span class="term"><code class="literal">LGL_TEMPLATE_FRAME_SHAPE_RECT</code></span></p></td>
 263 <td>A rectangular frame.  (May have rounded corners.)
 264 </td>
 265 </tr>
 266 <tr>
 267 <td><p><a name="LGL-TEMPLATE-FRAME-SHAPE-ELLIPSE:CAPS"></a><span class="term"><code class="literal">LGL_TEMPLATE_FRAME_SHAPE_ELLIPSE</code></span></p></td>
 268 <td>An elliptical frame.
 269 </td>
 270 </tr>
 271 <tr>
 272 <td><p><a name="LGL-TEMPLATE-FRAME-SHAPE-ROUND:CAPS"></a><span class="term"><code class="literal">LGL_TEMPLATE_FRAME_SHAPE_ROUND</code></span></p></td>
 273 <td>A round frame.
 274 </td>
 275 </tr>
 276 <tr>
 277 <td><p><a name="LGL-TEMPLATE-FRAME-SHAPE-CD:CAPS"></a><span class="term"><code class="literal">LGL_TEMPLATE_FRAME_SHAPE_CD</code></span></p></td>
 278 <td>A CD or DVD frame.  (Includes credit-card style CDs.)
 279 </td>
 280 </tr>
 281 </tbody>
 282 </table></div>
 283 </div>
 284 <hr>
 285 <div class="refsect2">
 286 <a name="lglTemplateFrame"></a><h3>union lglTemplateFrame</h3>
 287 <pre class="programlisting">union _lglTemplateFrame{
 288
 289         lglTemplateFrameShape   shape;
 290
 291         lglTemplateFrameAll     all;
 292         lglTemplateFrameRect    rect;
 293         lglTemplateFrameEllipse ellipse;
 294         lglTemplateFrameRound   round;
 295         lglTemplateFrameCD      cd;
 296 };
 297 </pre>
 298 <p>
 299 A union of all possible frame structures.  The type of structure is indicated by the shape
 300 member, which overlays the first field of all other member structures.
 301 </p>
 302 </div>
 303 <hr>
 304 <div class="refsect2">
 305 <a name="lglTemplateFrameAll"></a><h3>struct lglTemplateFrameAll</h3>
 306 <pre class="programlisting">struct lglTemplateFrameAll {
 307         /* Begin Common Fields */
 308         lglTemplateFrameShape shape;
 309
 310         gchar                *id;       /* Id, currently always "0" */
 311         GList                *layouts;  /* List of lglTemplateLayouts */
 312         GList                *markups;  /* List of lglTemplateMarkups */
 313         /* End Common Fields */
 314 };
 315 </pre>
 316 <p>
 317 This structure is composed of a set of fields common to all frame structures.  All frame types
 318 can be cast to this structure.
 319 </p>
 320 <div class="variablelist"><table border="0">
 321 <col align="left" valign="top">
 322 <tbody>
 323 <tr>
 324 <td><p><span class="term"><a class="link" href="libglabels-3.0-template.html#lglTemplateFrameShape" title="enum lglTemplateFrameShape"><span class="type">lglTemplateFrameShape</span></a> <em class="structfield"><code><a name="lglTemplateFrameAll.shape"></a>shape</code></em>;</span></p></td>
 325 <td>The shape of the frame.</td>
 326 </tr>
 327 <tr>
 328 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="lglTemplateFrameAll.id"></a>id</code></em>;</span></p></td>
 329 <td>Reserved for future use.  Should always be zero.</td>
 330 </tr>
 331 <tr>
 332 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *<em class="structfield"><code><a name="lglTemplateFrameAll.layouts"></a>layouts</code></em>;</span></p></td>
 333 <td>A list of (<a class="link" href="libglabels-3.0-template.html#lglTemplateLayout" title="struct lglTemplateLayout"><span class="type">lglTemplateLayout</span></a> *) structures.  Typically a frame will have a single
 334 layout, representing a simple grid of labels or cards.  If the layout of labels or cards is
 335 more complex, multiple (<a class="link" href="libglabels-3.0-template.html#lglTemplateLayout" title="struct lglTemplateLayout"><span class="type">lglTemplateLayout</span></a> *) structures may be needed.</td>
 336 </tr>
 337 <tr>
 338 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *<em class="structfield"><code><a name="lglTemplateFrameAll.markups"></a>markups</code></em>;</span></p></td>
 339 <td>A list of (<a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="type">lglTemplateMarkup</span></a> *) structures, which represent non-printing markup lines.</td>
 340 </tr>
 341 </tbody>
 342 </table></div>
 343 </div>
 344 <hr>
 345 <div class="refsect2">
 346 <a name="lglTemplateFrameRect"></a><h3>struct lglTemplateFrameRect</h3>
 347 <pre class="programlisting">struct lglTemplateFrameRect {
 348         /* Begin Common Fields */
 349         lglTemplateFrameShape shape;    /* Always LGL_TEMPLATE_FRAME_SHAPE_RECT. */
 350
 351         gchar                *id;       /* Id, currently always "0" */
 352         GList                *layouts;  /* List of lglTemplateLayouts */
 353         GList                *markups;  /* List of lglTemplateMarkups */
 354         /* End Common Fields */
 355
 356         gdouble               w;        /* Width */
 357         gdouble               h;        /* Height */
 358         gdouble               r;        /* Corner radius */
 359         gdouble               x_waste;  /* Amount of horiz overprint allowed. */
 360         gdouble               y_waste;  /* Amount of vert overprint allowed. */
 361 };
 362 </pre>
 363 <p>
 364 This structure defines the frame for a rectangular label or card.
 365 </p>
 366 <div class="variablelist"><table border="0">
 367 <col align="left" valign="top">
 368 <tbody>
 369 <tr>
 370 <td><p><span class="term"><a class="link" href="libglabels-3.0-template.html#lglTemplateFrameShape" title="enum lglTemplateFrameShape"><span class="type">lglTemplateFrameShape</span></a> <em class="structfield"><code><a name="lglTemplateFrameRect.shape"></a>shape</code></em>;</span></p></td>
 371 <td>Common field.  Always <a class="link" href="libglabels-3.0-template.html#LGL-TEMPLATE-FRAME-SHAPE-RECT:CAPS"><span class="type">LGL_TEMPLATE_FRAME_SHAPE_RECT</span></a> for <a class="link" href="libglabels-3.0-template.html#lglTemplateFrameRect" title="struct lglTemplateFrameRect"><span class="type">lglTemplateFrameRect</span></a>.</td>
 372 </tr>
 373 <tr>
 374 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="lglTemplateFrameRect.id"></a>id</code></em>;</span></p></td>
 375 <td>Common field.  See <a class="link" href="libglabels-3.0-template.html#lglTemplateFrameAll" title="struct lglTemplateFrameAll"><span class="type">lglTemplateFrameAll</span></a>.</td>
 376 </tr>
 377 <tr>
 378 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *<em class="structfield"><code><a name="lglTemplateFrameRect.layouts"></a>layouts</code></em>;</span></p></td>
 379 <td>Common field.  See <a class="link" href="libglabels-3.0-template.html#lglTemplateFrameAll" title="struct lglTemplateFrameAll"><span class="type">lglTemplateFrameAll</span></a>.</td>
 380 </tr>
 381 <tr>
 382 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *<em class="structfield"><code><a name="lglTemplateFrameRect.markups"></a>markups</code></em>;</span></p></td>
 383 <td>Common field.  See <a class="link" href="libglabels-3.0-template.html#lglTemplateFrameAll" title="struct lglTemplateFrameAll"><span class="type">lglTemplateFrameAll</span></a>.</td>
 384 </tr>
 385 <tr>
 386 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateFrameRect.w"></a>w</code></em>;</span></p></td>
 387 <td>Width of label or card in points.</td>
 388 </tr>
 389 <tr>
 390 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateFrameRect.h"></a>h</code></em>;</span></p></td>
 391 <td>Height of label or card in points.</td>
 392 </tr>
 393 <tr>
 394 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateFrameRect.r"></a>r</code></em>;</span></p></td>
 395 <td>Radius of corners in points.</td>
 396 </tr>
 397 <tr>
 398 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateFrameRect.x-waste"></a>x_waste</code></em>;</span></p></td>
 399 <td>Amount of horizontal over-print to allow in points.</td>
 400 </tr>
 401 <tr>
 402 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateFrameRect.y-waste"></a>y_waste</code></em>;</span></p></td>
 403 <td>Amount of vertical over-print to allow in points.</td>
 404 </tr>
 405 </tbody>
 406 </table></div>
 407 </div>
 408 <hr>
 409 <div class="refsect2">
 410 <a name="lglTemplateFrameEllipse"></a><h3>struct lglTemplateFrameEllipse</h3>
 411 <pre class="programlisting">struct lglTemplateFrameEllipse {
 412         /* Begin Common Fields */
 413         lglTemplateFrameShape shape;    /* Always LGL_TEMPLATE_FRAME_SHAPE_ELLIPSE. */
 414
 415         gchar                *id;       /* Id, currently always "0" */
 416         GList                *layouts;  /* List of lglTemplateLayouts */
 417         GList                *markups;  /* List of lglTemplateMarkups */
 418         /* End Common Fields */
 419
 420         gdouble               w;        /* Width */
 421         gdouble               h;        /* Height */
 422         gdouble               waste;    /* Amount of overprint allowed. */
 423 };
 424 </pre>
 425 <p>
 426 This structure defines the frame for an elliptical label or card.
 427 </p>
 428 <div class="variablelist"><table border="0">
 429 <col align="left" valign="top">
 430 <tbody>
 431 <tr>
 432 <td><p><span class="term"><a class="link" href="libglabels-3.0-template.html#lglTemplateFrameShape" title="enum lglTemplateFrameShape"><span class="type">lglTemplateFrameShape</span></a> <em class="structfield"><code><a name="lglTemplateFrameEllipse.shape"></a>shape</code></em>;</span></p></td>
 433 <td>Common field.  Always <a class="link" href="libglabels-3.0-template.html#LGL-TEMPLATE-FRAME-SHAPE-ELLIPSE:CAPS"><span class="type">LGL_TEMPLATE_FRAME_SHAPE_ELLIPSE</span></a> for <a class="link" href="libglabels-3.0-template.html#lglTemplateFrameEllipse" title="struct lglTemplateFrameEllipse"><span class="type">lglTemplateFrameEllipse</span></a>.</td>
 434 </tr>
 435 <tr>
 436 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="lglTemplateFrameEllipse.id"></a>id</code></em>;</span></p></td>
 437 <td>Common field.  See <a class="link" href="libglabels-3.0-template.html#lglTemplateFrameAll" title="struct lglTemplateFrameAll"><span class="type">lglTemplateFrameAll</span></a>.</td>
 438 </tr>
 439 <tr>
 440 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *<em class="structfield"><code><a name="lglTemplateFrameEllipse.layouts"></a>layouts</code></em>;</span></p></td>
 441 <td>Common field.  See <a class="link" href="libglabels-3.0-template.html#lglTemplateFrameAll" title="struct lglTemplateFrameAll"><span class="type">lglTemplateFrameAll</span></a>.</td>
 442 </tr>
 443 <tr>
 444 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *<em class="structfield"><code><a name="lglTemplateFrameEllipse.markups"></a>markups</code></em>;</span></p></td>
 445 <td>Common field.  See <a class="link" href="libglabels-3.0-template.html#lglTemplateFrameAll" title="struct lglTemplateFrameAll"><span class="type">lglTemplateFrameAll</span></a>.</td>
 446 </tr>
 447 <tr>
 448 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateFrameEllipse.w"></a>w</code></em>;</span></p></td>
 449 <td>Width of label or card in points.</td>
 450 </tr>
 451 <tr>
 452 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateFrameEllipse.h"></a>h</code></em>;</span></p></td>
 453 <td>Height of label or card in points.</td>
 454 </tr>
 455 <tr>
 456 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateFrameEllipse.waste"></a>waste</code></em>;</span></p></td>
 457 <td>Amount of over-print to allow in points.</td>
 458 </tr>
 459 </tbody>
 460 </table></div>
 461 </div>
 462 <hr>
 463 <div class="refsect2">
 464 <a name="lglTemplateFrameRound"></a><h3>struct lglTemplateFrameRound</h3>
 465 <pre class="programlisting">struct lglTemplateFrameRound {
 466         /* Begin Common Fields */
 467         lglTemplateFrameShape shape;    /* Always LGL_TEMPLATE_FRAME_SHAPE_ROUND. */
 468
 469         gchar                *id;       /* Id, currently always "0" */
 470         GList                *layouts;  /* List of lglTemplateLayouts */
 471         GList                *markups;  /* List of lglTemplateMarkups */
 472         /* End Common Fields */
 473
 474         gdouble               r;      /* Radius */
 475         gdouble               waste;  /* Amount of overprint allowed. */
 476 };
 477 </pre>
 478 <p>
 479 This structure defines the frame for a round label or card.
 480 </p>
 481 <div class="variablelist"><table border="0">
 482 <col align="left" valign="top">
 483 <tbody>
 484 <tr>
 485 <td><p><span class="term"><a class="link" href="libglabels-3.0-template.html#lglTemplateFrameShape" title="enum lglTemplateFrameShape"><span class="type">lglTemplateFrameShape</span></a> <em class="structfield"><code><a name="lglTemplateFrameRound.shape"></a>shape</code></em>;</span></p></td>
 486 <td>Common field.  Always <a class="link" href="libglabels-3.0-template.html#LGL-TEMPLATE-FRAME-SHAPE-ROUND:CAPS"><span class="type">LGL_TEMPLATE_FRAME_SHAPE_ROUND</span></a> for <a class="link" href="libglabels-3.0-template.html#lglTemplateFrameRound" title="struct lglTemplateFrameRound"><span class="type">lglTemplateFrameRound</span></a>.</td>
 487 </tr>
 488 <tr>
 489 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="lglTemplateFrameRound.id"></a>id</code></em>;</span></p></td>
 490 <td>Common field.  See <a class="link" href="libglabels-3.0-template.html#lglTemplateFrameAll" title="struct lglTemplateFrameAll"><span class="type">lglTemplateFrameAll</span></a>.</td>
 491 </tr>
 492 <tr>
 493 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *<em class="structfield"><code><a name="lglTemplateFrameRound.layouts"></a>layouts</code></em>;</span></p></td>
 494 <td>Common field.  See <a class="link" href="libglabels-3.0-template.html#lglTemplateFrameAll" title="struct lglTemplateFrameAll"><span class="type">lglTemplateFrameAll</span></a>.</td>
 495 </tr>
 496 <tr>
 497 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *<em class="structfield"><code><a name="lglTemplateFrameRound.markups"></a>markups</code></em>;</span></p></td>
 498 <td>Common field.  See <a class="link" href="libglabels-3.0-template.html#lglTemplateFrameAll" title="struct lglTemplateFrameAll"><span class="type">lglTemplateFrameAll</span></a>.</td>
 499 </tr>
 500 <tr>
 501 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateFrameRound.r"></a>r</code></em>;</span></p></td>
 502 <td>Radius of label or card in points.</td>
 503 </tr>
 504 <tr>
 505 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateFrameRound.waste"></a>waste</code></em>;</span></p></td>
 506 <td>Amount of over-print to allow in points.</td>
 507 </tr>
 508 </tbody>
 509 </table></div>
 510 </div>
 511 <hr>
 512 <div class="refsect2">
 513 <a name="lglTemplateFrameCD"></a><h3>struct lglTemplateFrameCD</h3>
 514 <pre class="programlisting">struct lglTemplateFrameCD {
 515         /* Begin Common Fields */
 516         lglTemplateFrameShape shape;    /* Always LGL_TEMPLATE_FRAME_SHAPE_CD. */
 517
 518         gchar                *id;       /* Id, currently always "0" */
 519         GList                *layouts;  /* List of lglTemplateLayouts */
 520         GList                *markups;  /* List of lglTemplateMarkups */
 521         /* End Common Fields */
 522
 523         gdouble               r1;     /* Outer radius */
 524         gdouble               r2;     /* Inner radius (hole) */
 525         gdouble               w;      /* Clip width, business card CDs */
 526         gdouble               h;      /* Clip height, business card CDs */
 527         gdouble               waste;  /* Amount of overprint allowed. */
 528 };
 529 </pre>
 530 <p>
 531 This structure defines the frame for a CD or DVD label.  This structure also supports
 532 credit-card CD labels.
 533 </p>
 534 <div class="variablelist"><table border="0">
 535 <col align="left" valign="top">
 536 <tbody>
 537 <tr>
 538 <td><p><span class="term"><a class="link" href="libglabels-3.0-template.html#lglTemplateFrameShape" title="enum lglTemplateFrameShape"><span class="type">lglTemplateFrameShape</span></a> <em class="structfield"><code><a name="lglTemplateFrameCD.shape"></a>shape</code></em>;</span></p></td>
 539 <td>Common field.  Always <a class="link" href="libglabels-3.0-template.html#LGL-TEMPLATE-FRAME-SHAPE-CD:CAPS"><span class="type">LGL_TEMPLATE_FRAME_SHAPE_CD</span></a> for <a class="link" href="libglabels-3.0-template.html#lglTemplateFrameCD" title="struct lglTemplateFrameCD"><span class="type">lglTemplateFrameCD</span></a>.</td>
 540 </tr>
 541 <tr>
 542 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *<em class="structfield"><code><a name="lglTemplateFrameCD.id"></a>id</code></em>;</span></p></td>
 543 <td>Common field.  See <a class="link" href="libglabels-3.0-template.html#lglTemplateFrameAll" title="struct lglTemplateFrameAll"><span class="type">lglTemplateFrameAll</span></a>.</td>
 544 </tr>
 545 <tr>
 546 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *<em class="structfield"><code><a name="lglTemplateFrameCD.layouts"></a>layouts</code></em>;</span></p></td>
 547 <td>Common field.  See <a class="link" href="libglabels-3.0-template.html#lglTemplateFrameAll" title="struct lglTemplateFrameAll"><span class="type">lglTemplateFrameAll</span></a>.</td>
 548 </tr>
 549 <tr>
 550 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> *<em class="structfield"><code><a name="lglTemplateFrameCD.markups"></a>markups</code></em>;</span></p></td>
 551 <td>Common field.  See <a class="link" href="libglabels-3.0-template.html#lglTemplateFrameAll" title="struct lglTemplateFrameAll"><span class="type">lglTemplateFrameAll</span></a>.</td>
 552 </tr>
 553 <tr>
 554 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateFrameCD.r1"></a>r1</code></em>;</span></p></td>
 555 <td>Outer radius of label in points.</td>
 556 </tr>
 557 <tr>
 558 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateFrameCD.r2"></a>r2</code></em>;</span></p></td>
 559 <td>Radius of center hole in points.</td>
 560 </tr>
 561 <tr>
 562 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateFrameCD.w"></a>w</code></em>;</span></p></td>
 563 <td>Clip width in points.  Used for credit-card CD labels.  This field is ignored if zero.</td>
 564 </tr>
 565 <tr>
 566 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateFrameCD.h"></a>h</code></em>;</span></p></td>
 567 <td>Clip height in points.  Used for credit-card CD labels.  This field is ignored if zero.</td>
 568 </tr>
 569 <tr>
 570 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateFrameCD.waste"></a>waste</code></em>;</span></p></td>
 571 <td>Amount of over-print to allow in points.</td>
 572 </tr>
 573 </tbody>
 574 </table></div>
 575 </div>
 576 <hr>
 577 <div class="refsect2">
 578 <a name="lglTemplateLayout"></a><h3>struct lglTemplateLayout</h3>
 579 <pre class="programlisting">struct lglTemplateLayout {
 580         gint                  nx;  /* Number of labels across */
 581         gint                  ny;  /* Number of labels up and down */
 582
 583         gdouble               x0;  /* Left of grid from left edge of paper */
 584         gdouble               y0;  /* Top of grid from top edge of paper */
 585
 586         gdouble               dx;  /* Horizontal pitch of grid */
 587         gdouble               dy;  /* Vertical pitch of grid */
 588 };
 589 </pre>
 590 <p>
 591 This structure defines a simple grid layout of labels or cards.
 592 </p>
 593 <div class="variablelist"><table border="0">
 594 <col align="left" valign="top">
 595 <tbody>
 596 <tr>
 597 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> <em class="structfield"><code><a name="lglTemplateLayout.nx"></a>nx</code></em>;</span></p></td>
 598 <td>Number of labels or cards across in the grid (horizontal).</td>
 599 </tr>
 600 <tr>
 601 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> <em class="structfield"><code><a name="lglTemplateLayout.ny"></a>ny</code></em>;</span></p></td>
 602 <td>Number of labels or cards down in the grid (vertical).</td>
 603 </tr>
 604 <tr>
 605 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateLayout.x0"></a>x0</code></em>;</span></p></td>
 606 <td>Distance (in points) from the left edge of page to the left edge of the left column of
 607 cards or labels in the layout.</td>
 608 </tr>
 609 <tr>
 610 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateLayout.y0"></a>y0</code></em>;</span></p></td>
 611 <td>Distance (in points) from the top edge of page to the top edge of the top row of
 612 cards or labels in the layout.</td>
 613 </tr>
 614 <tr>
 615 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateLayout.dx"></a>dx</code></em>;</span></p></td>
 616 <td>Horizontal pitch of grid in points.  This is the distance from left edge to left edge
 617 (not the gap between labels or cards).</td>
 618 </tr>
 619 <tr>
 620 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateLayout.dy"></a>dy</code></em>;</span></p></td>
 621 <td>Vertical pitch of grid in points.  This is the distance from top edge to top edge
 622 (not the gap between labels or cards).</td>
 623 </tr>
 624 </tbody>
 625 </table></div>
 626 </div>
 627 <hr>
 628 <div class="refsect2">
 629 <a name="lglTemplateMarkupType"></a><h3>enum lglTemplateMarkupType</h3>
 630 <pre class="programlisting">typedef enum {
 631         LGL_TEMPLATE_MARKUP_MARGIN,
 632         LGL_TEMPLATE_MARKUP_LINE,
 633         LGL_TEMPLATE_MARKUP_CIRCLE,
 634         LGL_TEMPLATE_MARKUP_RECT,
 635         LGL_TEMPLATE_MARKUP_ELLIPSE
 636 } lglTemplateMarkupType;
 637 </pre>
 638 <p>
 639 This enumeration defines markup types that are supported by libglabels
 640 </p>
 641 <div class="variablelist"><table border="0">
 642 <col align="left" valign="top">
 643 <tbody>
 644 <tr>
 645 <td><p><a name="LGL-TEMPLATE-MARKUP-MARGIN:CAPS"></a><span class="term"><code class="literal">LGL_TEMPLATE_MARKUP_MARGIN</code></span></p></td>
 646 <td>A margin line around perimeter of label or card.
 647 </td>
 648 </tr>
 649 <tr>
 650 <td><p><a name="LGL-TEMPLATE-MARKUP-LINE:CAPS"></a><span class="term"><code class="literal">LGL_TEMPLATE_MARKUP_LINE</code></span></p></td>
 651 <td>A simple line segment.
 652 </td>
 653 </tr>
 654 <tr>
 655 <td><p><a name="LGL-TEMPLATE-MARKUP-CIRCLE:CAPS"></a><span class="term"><code class="literal">LGL_TEMPLATE_MARKUP_CIRCLE</code></span></p></td>
 656 <td>A circle.
 657 </td>
 658 </tr>
 659 <tr>
 660 <td><p><a name="LGL-TEMPLATE-MARKUP-RECT:CAPS"></a><span class="term"><code class="literal">LGL_TEMPLATE_MARKUP_RECT</code></span></p></td>
 661 <td>A rectangle.  Possibly with rounded corners.
 662 </td>
 663 </tr>
 664 <tr>
 665 <td><p><a name="LGL-TEMPLATE-MARKUP-ELLIPSE:CAPS"></a><span class="term"><code class="literal">LGL_TEMPLATE_MARKUP_ELLIPSE</code></span></p></td>
 666 <td>An ellipse.
 667 </td>
 668 </tr>
 669 </tbody>
 670 </table></div>
 671 </div>
 672 <hr>
 673 <div class="refsect2">
 674 <a name="lglTemplateMarkup"></a><h3>union lglTemplateMarkup</h3>
 675 <pre class="programlisting">union _lglTemplateMarkup {
 676
 677         lglTemplateMarkupType    type;
 678
 679         lglTemplateMarkupMargin  margin;
 680         lglTemplateMarkupLine    line;
 681         lglTemplateMarkupCircle  circle;
 682         lglTemplateMarkupRect    rect;
 683         lglTemplateMarkupEllipse ellipse;
 684 };
 685 </pre>
 686 <p>
 687 A union of all possible markup structures.  The type of structure is indicated by the type
 688 member, which overlays the first field of all other member structures.
 689 </p>
 690 </div>
 691 <hr>
 692 <div class="refsect2">
 693 <a name="lglTemplateMarkupMargin"></a><h3>struct lglTemplateMarkupMargin</h3>
 694 <pre class="programlisting">struct lglTemplateMarkupMargin {
 695         lglTemplateMarkupType  type;  /* Always LGL_TEMPLATE_MARKUP_MARGIN */
 696
 697         gdouble                size;  /* Margin size */
 698 };
 699 </pre>
 700 <p>
 701 This structure defines a simple margin markup around the perimeter of a label or card.
 702 </p>
 703 <div class="variablelist"><table border="0">
 704 <col align="left" valign="top">
 705 <tbody>
 706 <tr>
 707 <td><p><span class="term"><a class="link" href="libglabels-3.0-template.html#lglTemplateMarkupType" title="enum lglTemplateMarkupType"><span class="type">lglTemplateMarkupType</span></a> <em class="structfield"><code><a name="lglTemplateMarkupMargin.type"></a>type</code></em>;</span></p></td>
 708 <td>Common field.  Always <a class="link" href="libglabels-3.0-template.html#LGL-TEMPLATE-MARKUP-MARGIN:CAPS"><span class="type">LGL_TEMPLATE_MARKUP_MARGIN</span></a> for <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkupMargin" title="struct lglTemplateMarkupMargin"><span class="type">lglTemplateMarkupMargin</span></a>.</td>
 709 </tr>
 710 <tr>
 711 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateMarkupMargin.size"></a>size</code></em>;</span></p></td>
 712 <td>Distance of margin from edge of label or card.</td>
 713 </tr>
 714 </tbody>
 715 </table></div>
 716 </div>
 717 <hr>
 718 <div class="refsect2">
 719 <a name="lglTemplateMarkupLine"></a><h3>struct lglTemplateMarkupLine</h3>
 720 <pre class="programlisting">struct lglTemplateMarkupLine {
 721         lglTemplateMarkupType  type;   /* Always LGL_TEMPLATE_MARKUP_LINE */
 722
 723         gdouble                x1, y1; /* 1st endpoint */
 724         gdouble                x2, y2; /* 2nd endpoint */
 725 };
 726 </pre>
 727 <p>
 728 This structure defines a simple line segment markup.
 729 </p>
 730 <div class="variablelist"><table border="0">
 731 <col align="left" valign="top">
 732 <tbody>
 733 <tr>
 734 <td><p><span class="term"><a class="link" href="libglabels-3.0-template.html#lglTemplateMarkupType" title="enum lglTemplateMarkupType"><span class="type">lglTemplateMarkupType</span></a> <em class="structfield"><code><a name="lglTemplateMarkupLine.type"></a>type</code></em>;</span></p></td>
 735 <td>Common field.  Always <a class="link" href="libglabels-3.0-template.html#LGL-TEMPLATE-MARKUP-LINE:CAPS"><span class="type">LGL_TEMPLATE_MARKUP_LINE</span></a> for <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkupLine" title="struct lglTemplateMarkupLine"><span class="type">lglTemplateMarkupLine</span></a>.</td>
 736 </tr>
 737 <tr>
 738 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateMarkupLine.x1"></a>x1</code></em>;</span></p></td>
 739 <td>Distance (in points) of first endpoint from left edge of label or card.</td>
 740 </tr>
 741 <tr>
 742 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateMarkupLine.y1"></a>y1</code></em>;</span></p></td>
 743 <td>Distance (in points) of first endpoint from top edge of label or card.</td>
 744 </tr>
 745 <tr>
 746 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateMarkupLine.x2"></a>x2</code></em>;</span></p></td>
 747 <td>Distance (in points) of second endpoint from left edge of label or card.</td>
 748 </tr>
 749 <tr>
 750 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateMarkupLine.y2"></a>y2</code></em>;</span></p></td>
 751 <td>Distance (in points) of second endpoint from top edge of label or card.</td>
 752 </tr>
 753 </tbody>
 754 </table></div>
 755 </div>
 756 <hr>
 757 <div class="refsect2">
 758 <a name="lglTemplateMarkupCircle"></a><h3>struct lglTemplateMarkupCircle</h3>
 759 <pre class="programlisting">struct lglTemplateMarkupCircle {
 760         lglTemplateMarkupType  type;   /* Always LGL_TEMPLATE_MARKUP_CIRCLE */
 761
 762         gdouble                x0, y0; /* Center of circle */
 763         gdouble                r;      /* Radius of circle */
 764 };
 765 </pre>
 766 <p>
 767 This structure defines a simple circle markup.
 768 </p>
 769 <div class="variablelist"><table border="0">
 770 <col align="left" valign="top">
 771 <tbody>
 772 <tr>
 773 <td><p><span class="term"><a class="link" href="libglabels-3.0-template.html#lglTemplateMarkupType" title="enum lglTemplateMarkupType"><span class="type">lglTemplateMarkupType</span></a> <em class="structfield"><code><a name="lglTemplateMarkupCircle.type"></a>type</code></em>;</span></p></td>
 774 <td>Common field.  Always <a class="link" href="libglabels-3.0-template.html#LGL-TEMPLATE-MARKUP-CIRCLE:CAPS"><span class="type">LGL_TEMPLATE_MARKUP_CIRCLE</span></a> for <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkupCircle" title="struct lglTemplateMarkupCircle"><span class="type">lglTemplateMarkupCircle</span></a>.</td>
 775 </tr>
 776 <tr>
 777 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateMarkupCircle.x0"></a>x0</code></em>;</span></p></td>
 778 <td>Distance (in points) of vertex from left edge of label or card.</td>
 779 </tr>
 780 <tr>
 781 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateMarkupCircle.y0"></a>y0</code></em>;</span></p></td>
 782 <td>Distance (in points) of vertex from top edge of label or card.</td>
 783 </tr>
 784 <tr>
 785 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateMarkupCircle.r"></a>r</code></em>;</span></p></td>
 786 <td>Radius of circle in points.</td>
 787 </tr>
 788 </tbody>
 789 </table></div>
 790 </div>
 791 <hr>
 792 <div class="refsect2">
 793 <a name="lglTemplateMarkupRect"></a><h3>struct lglTemplateMarkupRect</h3>
 794 <pre class="programlisting">struct lglTemplateMarkupRect {
 795         lglTemplateMarkupType  type;   /* Always LGL_TEMPLATE_MARKUP_RECT */
 796
 797         gdouble                x1, y1; /* Upper left corner */
 798         gdouble                w, h;   /* Width and height. */
 799         gdouble                r;      /* Radius of corners. */
 800 };
 801 </pre>
 802 <p>
 803 This structure defines a simple rectangle markup.  The rectangle can have rounded corners.
 804 </p>
 805 <div class="variablelist"><table border="0">
 806 <col align="left" valign="top">
 807 <tbody>
 808 <tr>
 809 <td><p><span class="term"><a class="link" href="libglabels-3.0-template.html#lglTemplateMarkupType" title="enum lglTemplateMarkupType"><span class="type">lglTemplateMarkupType</span></a> <em class="structfield"><code><a name="lglTemplateMarkupRect.type"></a>type</code></em>;</span></p></td>
 810 <td>Common field.  Always <a class="link" href="libglabels-3.0-template.html#LGL-TEMPLATE-MARKUP-RECT:CAPS"><span class="type">LGL_TEMPLATE_MARKUP_RECT</span></a> for <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkupRect" title="struct lglTemplateMarkupRect"><span class="type">lglTemplateMarkupRect</span></a>.</td>
 811 </tr>
 812 <tr>
 813 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateMarkupRect.x1"></a>x1</code></em>;</span></p></td>
 814 <td>Distance (in points) of left edge of markup from left edge of label or card.</td>
 815 </tr>
 816 <tr>
 817 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateMarkupRect.y1"></a>y1</code></em>;</span></p></td>
 818 <td>Distance (in points) of top edge of markup from top edge of label or card.</td>
 819 </tr>
 820 <tr>
 821 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateMarkupRect.w"></a>w</code></em>;</span></p></td>
 822 <td>Width of rectangle in points.</td>
 823 </tr>
 824 <tr>
 825 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateMarkupRect.h"></a>h</code></em>;</span></p></td>
 826 <td>Height of rectangle in points.</td>
 827 </tr>
 828 <tr>
 829 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateMarkupRect.r"></a>r</code></em>;</span></p></td>
 830 <td>Radius of corners in points.  Should be zero for sharp corners.</td>
 831 </tr>
 832 </tbody>
 833 </table></div>
 834 </div>
 835 <hr>
 836 <div class="refsect2">
 837 <a name="lglTemplateMarkupEllipse"></a><h3>struct lglTemplateMarkupEllipse</h3>
 838 <pre class="programlisting">struct lglTemplateMarkupEllipse {
 839         lglTemplateMarkupType  type;   /* Always LGL_TEMPLATE_MARKUP_ELLIPSE */
 840
 841         gdouble                x1, y1; /* Upper left corner */
 842         gdouble                w, h;   /* Width and height. */
 843 };
 844 </pre>
 845 <p>
 846 This structure defines a simple elliptical markup.
 847 </p>
 848 <div class="variablelist"><table border="0">
 849 <col align="left" valign="top">
 850 <tbody>
 851 <tr>
 852 <td><p><span class="term"><a class="link" href="libglabels-3.0-template.html#lglTemplateMarkupType" title="enum lglTemplateMarkupType"><span class="type">lglTemplateMarkupType</span></a> <em class="structfield"><code><a name="lglTemplateMarkupEllipse.type"></a>type</code></em>;</span></p></td>
 853 <td>Common field.  Always <a class="link" href="libglabels-3.0-template.html#LGL-TEMPLATE-MARKUP-ELLIPSE:CAPS"><span class="type">LGL_TEMPLATE_MARKUP_ELLIPSE</span></a> for <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkupEllipse" title="struct lglTemplateMarkupEllipse"><span class="type">lglTemplateMarkupEllipse</span></a>.</td>
 854 </tr>
 855 <tr>
 856 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateMarkupEllipse.x1"></a>x1</code></em>;</span></p></td>
 857 <td>Distance (in points) of left edge of markup from left edge of label or card.</td>
 858 </tr>
 859 <tr>
 860 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateMarkupEllipse.y1"></a>y1</code></em>;</span></p></td>
 861 <td>Distance (in points) of top edge of markup from top edge of label or card.</td>
 862 </tr>
 863 <tr>
 864 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateMarkupEllipse.w"></a>w</code></em>;</span></p></td>
 865 <td>Width of rectangle in points.</td>
 866 </tr>
 867 <tr>
 868 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateMarkupEllipse.h"></a>h</code></em>;</span></p></td>
 869 <td>Height of rectangle in points.</td>
 870 </tr>
 871 </tbody>
 872 </table></div>
 873 </div>
 874 <hr>
 875 <div class="refsect2">
 876 <a name="lglTemplateOrigin"></a><h3>struct lglTemplateOrigin</h3>
 877 <pre class="programlisting">struct lglTemplateOrigin {
 878         gdouble               x, y; /* Label origin relative to upper
 879                                      * upper left hand corner of paper */
 880 };
 881 </pre>
 882 <p>
 883 This structure represents the cartesian coordinates of the origin of a label or card on the page.
 884 The orign is the upper left corner of the extent of the label or card.  These coordinates are
 885 relative to the upper left corner of the page.
 886 </p>
 887 <div class="variablelist"><table border="0">
 888 <col align="left" valign="top">
 889 <tbody>
 890 <tr>
 891 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateOrigin.x"></a>x</code></em>;</span></p></td>
 892 <td>Distance in points from top edge of page.</td>
 893 </tr>
 894 <tr>
 895 <td><p><span class="term"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> <em class="structfield"><code><a name="lglTemplateOrigin.y"></a>y</code></em>;</span></p></td>
 896 <td>Distance in points from left edge of page.</td>
 897 </tr>
 898 </tbody>
 899 </table></div>
 900 </div>
 901 <hr>
 902 <div class="refsect2">
 903 <a name="lgl-template-new"></a><h3>lgl_template_new ()</h3>
 904 <pre class="programlisting"><a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="returnvalue">lglTemplate</span></a> *       lgl_template_new                    (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *brand</code></em>,
 905                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *part</code></em>,
 906                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *description</code></em>,
 907                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *paper_id</code></em>,
 908                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> page_width</code></em>,
 909                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> page_height</code></em>);</pre>
 910 <p>
 911 Create a new template structure, with the given top-level attributes.  The
 912 created template will have no initial categories, or frames associated with
 913 it.  See <a class="link" href="libglabels-3.0-template.html#lgl-template-add-category" title="lgl_template_add_category ()"><code class="function">lgl_template_add_category()</code></a> and <a class="link" href="libglabels-3.0-template.html#lgl-template-add-frame" title="lgl_template_add_frame ()"><code class="function">lgl_template_add_frame()</code></a> to add
 914 these.
 915 </p>
 916 <div class="variablelist"><table border="0">
 917 <col align="left" valign="top">
 918 <tbody>
 919 <tr>
 920 <td><p><span class="term"><em class="parameter"><code>brand</code></em> :</span></p></td>
 921 <td>Template brand</td>
 922 </tr>
 923 <tr>
 924 <td><p><span class="term"><em class="parameter"><code>part</code></em> :</span></p></td>
 925 <td>Template part name/number</td>
 926 </tr>
 927 <tr>
 928 <td><p><span class="term"><em class="parameter"><code>description</code></em> :</span></p></td>
 929 <td>Template descriptions</td>
 930 </tr>
 931 <tr>
 932 <td><p><span class="term"><em class="parameter"><code>paper_id</code></em> :</span></p></td>
 933 <td>Page size id</td>
 934 </tr>
 935 <tr>
 936 <td><p><span class="term"><em class="parameter"><code>page_width</code></em> :</span></p></td>
 937 <td>Page width in points, set to zero unless paper_id="Other"</td>
 938 </tr>
 939 <tr>
 940 <td><p><span class="term"><em class="parameter"><code>page_height</code></em> :</span></p></td>
 941 <td>Page height in points, set to zero unless paper_id="Other"</td>
 942 </tr>
 943 <tr>
 944 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 945 <td>pointer to a newly allocated <a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="type">lglTemplate</span></a> structure.</td>
 946 </tr>
 947 </tbody>
 948 </table></div>
 949 </div>
 950 <hr>
 951 <div class="refsect2">
 952 <a name="lgl-template-new-from-equiv"></a><h3>lgl_template_new_from_equiv ()</h3>
 953 <pre class="programlisting"><a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="returnvalue">lglTemplate</span></a> *       lgl_template_new_from_equiv         (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *brand</code></em>,
 954                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *part</code></em>,
 955                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *equiv_part</code></em>);</pre>
 956 <p>
 957 Create a new template structure based on an existing template.  The
 958 created template will be a duplicate of the original template, except with
 959 the new part name/number.
 960 </p>
 961 <div class="variablelist"><table border="0">
 962 <col align="left" valign="top">
 963 <tbody>
 964 <tr>
 965 <td><p><span class="term"><em class="parameter"><code>brand</code></em> :</span></p></td>
 966 <td>Template brand</td>
 967 </tr>
 968 <tr>
 969 <td><p><span class="term"><em class="parameter"><code>part</code></em> :</span></p></td>
 970 <td>Template part name/number</td>
 971 </tr>
 972 <tr>
 973 <td><p><span class="term"><em class="parameter"><code>equiv_part</code></em> :</span></p></td>
 974 <td>Name of equivalent part to base template on</td>
 975 </tr>
 976 <tr>
 977 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 978 <td>pointer to a newly allocated <a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="type">lglTemplate</span></a> structure.</td>
 979 </tr>
 980 </tbody>
 981 </table></div>
 982 </div>
 983 <hr>
 984 <div class="refsect2">
 985 <a name="lgl-template-dup"></a><h3>lgl_template_dup ()</h3>
 986 <pre class="programlisting"><a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="returnvalue">lglTemplate</span></a> *       lgl_template_dup                    (<em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="type">lglTemplate</span></a> *orig_template</code></em>);</pre>
 987 <p>
 988 This function duplicates a template structure.
 989 </p>
 990 <div class="variablelist"><table border="0">
 991 <col align="left" valign="top">
 992 <tbody>
 993 <tr>
 994 <td><p><span class="term"><em class="parameter"><code>orig_template</code></em> :</span></p></td>
 995 <td>Template to duplicate.</td>
 996 </tr>
 997 <tr>
 998 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 999 <td>a newly allocated <a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="type">lglTemplate</span></a> structure.</td>
1000 </tr>
1001 </tbody>
1002 </table></div>
1003 </div>
1004 <hr>
1005 <div class="refsect2">
1006 <a name="lgl-template-free"></a><h3>lgl_template_free ()</h3>
1007 <pre class="programlisting"><span class="returnvalue">void</span>                lgl_template_free                   (<em class="parameter"><code><a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="type">lglTemplate</span></a> *template</code></em>);</pre>
1008 <p>
1009 This function frees all memory associated with given template structure.
1010 </p>
1011 <div class="variablelist"><table border="0">
1012 <col align="left" valign="top">
1013 <tbody><tr>
1014 <td><p><span class="term"><em class="parameter"><code>template</code></em> :</span></p></td>
1015 <td>Template to free.</td>
1016 </tr></tbody>
1017 </table></div>
1018 </div>
1019 <hr>
1020 <div class="refsect2">
1021 <a name="lgl-template-add-category"></a><h3>lgl_template_add_category ()</h3>
1022 <pre class="programlisting"><span class="returnvalue">void</span>                lgl_template_add_category           (<em class="parameter"><code><a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="type">lglTemplate</span></a> *template</code></em>,
1023                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *category_id</code></em>);</pre>
1024 <p>
1025 This function adds the given category ID to a templates category list.
1026 </p>
1027 <div class="variablelist"><table border="0">
1028 <col align="left" valign="top">
1029 <tbody>
1030 <tr>
1031 <td><p><span class="term"><em class="parameter"><code>template</code></em> :</span></p></td>
1032 <td>Pointer to template structure</td>
1033 </tr>
1034 <tr>
1035 <td><p><span class="term"><em class="parameter"><code>category_id</code></em> :</span></p></td>
1036 <td>Category ID string</td>
1037 </tr>
1038 </tbody>
1039 </table></div>
1040 </div>
1041 <hr>
1042 <div class="refsect2">
1043 <a name="lgl-template-add-frame"></a><h3>lgl_template_add_frame ()</h3>
1044 <pre class="programlisting"><span class="returnvalue">void</span>                lgl_template_add_frame              (<em class="parameter"><code><a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="type">lglTemplate</span></a> *template</code></em>,
1045                                                          <em class="parameter"><code><a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> *frame</code></em>);</pre>
1046 <p>
1047 This function adds the given frame structure to the template.  Once added,
1048 the frame structure belongs to the given template; do not attempt to free
1049 it.
1050 </p>
1051 <p>
1052 Note: Currently glabels only supports a single frame per template.
1053 </p>
1054 <div class="variablelist"><table border="0">
1055 <col align="left" valign="top">
1056 <tbody>
1057 <tr>
1058 <td><p><span class="term"><em class="parameter"><code>template</code></em> :</span></p></td>
1059 <td>Pointer to template structure</td>
1060 </tr>
1061 <tr>
1062 <td><p><span class="term"><em class="parameter"><code>frame</code></em> :</span></p></td>
1063 <td>Pointer to frame structure</td>
1064 </tr>
1065 </tbody>
1066 </table></div>
1067 </div>
1068 <hr>
1069 <div class="refsect2">
1070 <a name="lgl-template-get-name"></a><h3>lgl_template_get_name ()</h3>
1071 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             lgl_template_get_name               (<em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="type">lglTemplate</span></a> *template</code></em>);</pre>
1072 <p>
1073 This function returns the name of the given template.  The name is the concetenation
1074 of the brand and part name/number.
1075 </p>
1076 <div class="variablelist"><table border="0">
1077 <col align="left" valign="top">
1078 <tbody>
1079 <tr>
1080 <td><p><span class="term"><em class="parameter"><code>template</code></em> :</span></p></td>
1081 <td>Pointer to template structure to test</td>
1082 </tr>
1083 <tr>
1084 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1085 <td>A pointer to a newly allocated name string.  Should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.</td>
1086 </tr>
1087 </tbody>
1088 </table></div>
1089 </div>
1090 <hr>
1091 <div class="refsect2">
1092 <a name="lgl-template-do-templates-match"></a><h3>lgl_template_do_templates_match ()</h3>
1093 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            lgl_template_do_templates_match     (<em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="type">lglTemplate</span></a> *template1</code></em>,
1094                                                          <em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="type">lglTemplate</span></a> *template2</code></em>);</pre>
1095 <p>
1096 This function tests if the given templates match.  This is a simple test that only tests
1097 the brand and part name/number. It does not test if they are actually identical.
1098 </p>
1099 <div class="variablelist"><table border="0">
1100 <col align="left" valign="top">
1101 <tbody>
1102 <tr>
1103 <td><p><span class="term"><em class="parameter"><code>template1</code></em> :</span></p></td>
1104 <td>Pointer to 1st template structure to test</td>
1105 </tr>
1106 <tr>
1107 <td><p><span class="term"><em class="parameter"><code>template2</code></em> :</span></p></td>
1108 <td>Pointer to 2nd template structure to test</td>
1109 </tr>
1110 <tr>
1111 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1112 <td>TRUE if the two templates match.</td>
1113 </tr>
1114 </tbody>
1115 </table></div>
1116 </div>
1117 <hr>
1118 <div class="refsect2">
1119 <a name="lgl-template-does-brand-match"></a><h3>lgl_template_does_brand_match ()</h3>
1120 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            lgl_template_does_brand_match       (<em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="type">lglTemplate</span></a> *template</code></em>,
1121                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *brand</code></em>);</pre>
1122 <p>
1123 This function tests if the brand of the template matches the given brand.
1124 </p>
1125 <div class="variablelist"><table border="0">
1126 <col align="left" valign="top">
1127 <tbody>
1128 <tr>
1129 <td><p><span class="term"><em class="parameter"><code>template</code></em> :</span></p></td>
1130 <td>Pointer to template structure to test</td>
1131 </tr>
1132 <tr>
1133 <td><p><span class="term"><em class="parameter"><code>brand</code></em> :</span></p></td>
1134 <td>Brand string</td>
1135 </tr>
1136 <tr>
1137 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1138 <td>TRUE if the template matches the given brand.</td>
1139 </tr>
1140 </tbody>
1141 </table></div>
1142 </div>
1143 <hr>
1144 <div class="refsect2">
1145 <a name="lgl-template-does-page-size-match"></a><h3>lgl_template_does_page_size_match ()</h3>
1146 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            lgl_template_does_page_size_match   (<em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="type">lglTemplate</span></a> *template</code></em>,
1147                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *paper_id</code></em>);</pre>
1148 <p>
1149 This function tests if the page size of the template matches the given ID.
1150 </p>
1151 <div class="variablelist"><table border="0">
1152 <col align="left" valign="top">
1153 <tbody>
1154 <tr>
1155 <td><p><span class="term"><em class="parameter"><code>template</code></em> :</span></p></td>
1156 <td>Pointer to template structure to test</td>
1157 </tr>
1158 <tr>
1159 <td><p><span class="term"><em class="parameter"><code>paper_id</code></em> :</span></p></td>
1160 <td>Page size ID string</td>
1161 </tr>
1162 <tr>
1163 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1164 <td>TRUE if the template matches the given page size ID.</td>
1165 </tr>
1166 </tbody>
1167 </table></div>
1168 </div>
1169 <hr>
1170 <div class="refsect2">
1171 <a name="lgl-template-does-category-match"></a><h3>lgl_template_does_category_match ()</h3>
1172 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            lgl_template_does_category_match    (<em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="type">lglTemplate</span></a> *template</code></em>,
1173                                                          <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *category_id</code></em>);</pre>
1174 <p>
1175 This function tests if the given template belongs to the given category ID.
1176 </p>
1177 <div class="variablelist"><table border="0">
1178 <col align="left" valign="top">
1179 <tbody>
1180 <tr>
1181 <td><p><span class="term"><em class="parameter"><code>template</code></em> :</span></p></td>
1182 <td>Pointer to template structure to test</td>
1183 </tr>
1184 <tr>
1185 <td><p><span class="term"><em class="parameter"><code>category_id</code></em> :</span></p></td>
1186 <td>Category ID string</td>
1187 </tr>
1188 <tr>
1189 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1190 <td>TRUE if the template matches the given category ID.</td>
1191 </tr>
1192 </tbody>
1193 </table></div>
1194 </div>
1195 <hr>
1196 <div class="refsect2">
1197 <a name="lgl-template-are-templates-identical"></a><h3>lgl_template_are_templates_identical ()</h3>
1198 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            lgl_template_are_templates_identical
1199                                                         (<em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="type">lglTemplate</span></a> *template1</code></em>,
1200                                                          <em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="type">lglTemplate</span></a> *template2</code></em>);</pre>
1201 <p>
1202 This function tests if the given templates have identical size and layout properties.
1203 </p>
1204 <div class="variablelist"><table border="0">
1205 <col align="left" valign="top">
1206 <tbody>
1207 <tr>
1208 <td><p><span class="term"><em class="parameter"><code>template1</code></em> :</span></p></td>
1209 <td>Pointer to 1st template structure to test</td>
1210 </tr>
1211 <tr>
1212 <td><p><span class="term"><em class="parameter"><code>template2</code></em> :</span></p></td>
1213 <td>Pointer to 2nd template structure to test</td>
1214 </tr>
1215 <tr>
1216 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1217 <td>TRUE if the two templates are identical.</td>
1218 </tr>
1219 </tbody>
1220 </table></div>
1221 </div>
1222 <hr>
1223 <div class="refsect2">
1224 <a name="lgl-template-frame-rect-new"></a><h3>lgl_template_frame_rect_new ()</h3>
1225 <pre class="programlisting"><a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="returnvalue">lglTemplateFrame</span></a> *  lgl_template_frame_rect_new         (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>,
1226                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> w</code></em>,
1227                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> h</code></em>,
1228                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> r</code></em>,
1229                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> x_waste</code></em>,
1230                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> y_waste</code></em>);</pre>
1231 <p>
1232 This function creates a new template frame for a rectangular label or card.
1233 </p>
1234 <div class="variablelist"><table border="0">
1235 <col align="left" valign="top">
1236 <tbody>
1237 <tr>
1238 <td><p><span class="term"><em class="parameter"><code>id</code></em> :</span></p></td>
1239 <td>ID of frame.  (This should currently always be "0").</td>
1240 </tr>
1241 <tr>
1242 <td><p><span class="term"><em class="parameter"><code>w</code></em> :</span></p></td>
1243 <td>width of frame in points.</td>
1244 </tr>
1245 <tr>
1246 <td><p><span class="term"><em class="parameter"><code>h</code></em> :</span></p></td>
1247 <td>height of frame in points.</td>
1248 </tr>
1249 <tr>
1250 <td><p><span class="term"><em class="parameter"><code>r</code></em> :</span></p></td>
1251 <td>radius of rounded corners in points.  (Should be 0 for square corners.)</td>
1252 </tr>
1253 <tr>
1254 <td><p><span class="term"><em class="parameter"><code>x_waste</code></em> :</span></p></td>
1255 <td>Amount of overprint to allow in the horizontal direction.</td>
1256 </tr>
1257 <tr>
1258 <td><p><span class="term"><em class="parameter"><code>y_waste</code></em> :</span></p></td>
1259 <td>Amount of overprint to allow in the vertical direction.</td>
1260 </tr>
1261 <tr>
1262 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1263 <td>Pointer to newly allocated <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> structure.</td>
1264 </tr>
1265 </tbody>
1266 </table></div>
1267 </div>
1268 <hr>
1269 <div class="refsect2">
1270 <a name="lgl-template-frame-ellipse-new"></a><h3>lgl_template_frame_ellipse_new ()</h3>
1271 <pre class="programlisting"><a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="returnvalue">lglTemplateFrame</span></a> *  lgl_template_frame_ellipse_new      (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>,
1272                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> w</code></em>,
1273                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> h</code></em>,
1274                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> waste</code></em>);</pre>
1275 <p>
1276 This function creates a new template frame for an elliptical label or card.
1277 </p>
1278 <div class="variablelist"><table border="0">
1279 <col align="left" valign="top">
1280 <tbody>
1281 <tr>
1282 <td><p><span class="term"><em class="parameter"><code>id</code></em> :</span></p></td>
1283 <td>ID of frame.  (This should currently always be "0").</td>
1284 </tr>
1285 <tr>
1286 <td><p><span class="term"><em class="parameter"><code>w</code></em> :</span></p></td>
1287 <td>width of frame in points.</td>
1288 </tr>
1289 <tr>
1290 <td><p><span class="term"><em class="parameter"><code>h</code></em> :</span></p></td>
1291 <td>height of frame in points.</td>
1292 </tr>
1293 <tr>
1294 <td><p><span class="term"><em class="parameter"><code>waste</code></em> :</span></p></td>
1295 <td>Amount of overprint to allow in points.</td>
1296 </tr>
1297 <tr>
1298 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1299 <td>Pointer to newly allocated <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> structure.</td>
1300 </tr>
1301 </tbody>
1302 </table></div>
1303 </div>
1304 <hr>
1305 <div class="refsect2">
1306 <a name="lgl-template-frame-round-new"></a><h3>lgl_template_frame_round_new ()</h3>
1307 <pre class="programlisting"><a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="returnvalue">lglTemplateFrame</span></a> *  lgl_template_frame_round_new        (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>,
1308                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> r</code></em>,
1309                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> waste</code></em>);</pre>
1310 <p>
1311 This function creates a new template frame for a round label.
1312 </p>
1313 <div class="variablelist"><table border="0">
1314 <col align="left" valign="top">
1315 <tbody>
1316 <tr>
1317 <td><p><span class="term"><em class="parameter"><code>id</code></em> :</span></p></td>
1318 <td>ID of frame.  (This should currently always be "0").</td>
1319 </tr>
1320 <tr>
1321 <td><p><span class="term"><em class="parameter"><code>r</code></em> :</span></p></td>
1322 <td>radius of label in points.</td>
1323 </tr>
1324 <tr>
1325 <td><p><span class="term"><em class="parameter"><code>waste</code></em> :</span></p></td>
1326 <td>Amount of overprint to allow.</td>
1327 </tr>
1328 <tr>
1329 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1330 <td>Pointer to newly allocated <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> structure.</td>
1331 </tr>
1332 </tbody>
1333 </table></div>
1334 </div>
1335 <hr>
1336 <div class="refsect2">
1337 <a name="lgl-template-frame-cd-new"></a><h3>lgl_template_frame_cd_new ()</h3>
1338 <pre class="programlisting"><a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="returnvalue">lglTemplateFrame</span></a> *  lgl_template_frame_cd_new           (<em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *id</code></em>,
1339                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> r1</code></em>,
1340                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> r2</code></em>,
1341                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> w</code></em>,
1342                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> h</code></em>,
1343                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> waste</code></em>);</pre>
1344 <p>
1345 This function creates a new template frame for a CD/DVD label.
1346 </p>
1347 <div class="variablelist"><table border="0">
1348 <col align="left" valign="top">
1349 <tbody>
1350 <tr>
1351 <td><p><span class="term"><em class="parameter"><code>id</code></em> :</span></p></td>
1352 <td>ID of frame.  (This should currently always be "0").</td>
1353 </tr>
1354 <tr>
1355 <td><p><span class="term"><em class="parameter"><code>r1</code></em> :</span></p></td>
1356 <td>outer radius of label in points.</td>
1357 </tr>
1358 <tr>
1359 <td><p><span class="term"><em class="parameter"><code>r2</code></em> :</span></p></td>
1360 <td>radius of center hole in points.</td>
1361 </tr>
1362 <tr>
1363 <td><p><span class="term"><em class="parameter"><code>w</code></em> :</span></p></td>
1364 <td>clip width of frame in points for business card CDs.  Should be 0 for no clipping.</td>
1365 </tr>
1366 <tr>
1367 <td><p><span class="term"><em class="parameter"><code>h</code></em> :</span></p></td>
1368 <td>clip height of frame in points for business card CDs.  Should be 0 for no clipping.</td>
1369 </tr>
1370 <tr>
1371 <td><p><span class="term"><em class="parameter"><code>waste</code></em> :</span></p></td>
1372 <td>Amount of overprint to allow.</td>
1373 </tr>
1374 <tr>
1375 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1376 <td>Pointer to newly allocated <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> structure.</td>
1377 </tr>
1378 </tbody>
1379 </table></div>
1380 </div>
1381 <hr>
1382 <div class="refsect2">
1383 <a name="lgl-template-frame-dup"></a><h3>lgl_template_frame_dup ()</h3>
1384 <pre class="programlisting"><a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="returnvalue">lglTemplateFrame</span></a> *  lgl_template_frame_dup              (<em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> *orig_frame</code></em>);</pre>
1385 <p>
1386 This function duplicates a template frame structure.
1387 </p>
1388 <div class="variablelist"><table border="0">
1389 <col align="left" valign="top">
1390 <tbody>
1391 <tr>
1392 <td><p><span class="term"><em class="parameter"><code>orig_frame</code></em> :</span></p></td>
1393 <td>Frame to duplicate.</td>
1394 </tr>
1395 <tr>
1396 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1397 <td>a newly allocated <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> structure.</td>
1398 </tr>
1399 </tbody>
1400 </table></div>
1401 </div>
1402 <hr>
1403 <div class="refsect2">
1404 <a name="lgl-template-frame-free"></a><h3>lgl_template_frame_free ()</h3>
1405 <pre class="programlisting"><span class="returnvalue">void</span>                lgl_template_frame_free             (<em class="parameter"><code><a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> *frame</code></em>);</pre>
1406 <p>
1407 This function frees all memory associated with given template frame structure.
1408 </p>
1409 <div class="variablelist"><table border="0">
1410 <col align="left" valign="top">
1411 <tbody><tr>
1412 <td><p><span class="term"><em class="parameter"><code>frame</code></em> :</span></p></td>
1413 <td>Frame to free.</td>
1414 </tr></tbody>
1415 </table></div>
1416 </div>
1417 <hr>
1418 <div class="refsect2">
1419 <a name="lgl-template-frame-add-layout"></a><h3>lgl_template_frame_add_layout ()</h3>
1420 <pre class="programlisting"><span class="returnvalue">void</span>                lgl_template_frame_add_layout       (<em class="parameter"><code><a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> *frame</code></em>,
1421                                                          <em class="parameter"><code><a class="link" href="libglabels-3.0-template.html#lglTemplateLayout" title="struct lglTemplateLayout"><span class="type">lglTemplateLayout</span></a> *layout</code></em>);</pre>
1422 <p>
1423 This function adds a layout structure to the given template frame.
1424 </p>
1425 <div class="variablelist"><table border="0">
1426 <col align="left" valign="top">
1427 <tbody>
1428 <tr>
1429 <td><p><span class="term"><em class="parameter"><code>frame</code></em> :</span></p></td>
1430 <td>Pointer to template frame to add layout to.</td>
1431 </tr>
1432 <tr>
1433 <td><p><span class="term"><em class="parameter"><code>layout</code></em> :</span></p></td>
1434 <td>Pointer to layout structure to add to frame.</td>
1435 </tr>
1436 </tbody>
1437 </table></div>
1438 </div>
1439 <hr>
1440 <div class="refsect2">
1441 <a name="lgl-template-frame-add-markup"></a><h3>lgl_template_frame_add_markup ()</h3>
1442 <pre class="programlisting"><span class="returnvalue">void</span>                lgl_template_frame_add_markup       (<em class="parameter"><code><a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> *frame</code></em>,
1443                                                          <em class="parameter"><code><a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="type">lglTemplateMarkup</span></a> *markup</code></em>);</pre>
1444 <p>
1445 This function adds a markup structure to the given template frame.
1446 </p>
1447 <div class="variablelist"><table border="0">
1448 <col align="left" valign="top">
1449 <tbody>
1450 <tr>
1451 <td><p><span class="term"><em class="parameter"><code>frame</code></em> :</span></p></td>
1452 <td>Pointer to template frame to add markup to.</td>
1453 </tr>
1454 <tr>
1455 <td><p><span class="term"><em class="parameter"><code>markup</code></em> :</span></p></td>
1456 <td>Pointer to markup structure to add to frame.</td>
1457 </tr>
1458 </tbody>
1459 </table></div>
1460 </div>
1461 <hr>
1462 <div class="refsect2">
1463 <a name="lgl-template-frame-get-size"></a><h3>lgl_template_frame_get_size ()</h3>
1464 <pre class="programlisting"><span class="returnvalue">void</span>                lgl_template_frame_get_size         (<em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> *frame</code></em>,
1465                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *w</code></em>,
1466                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> *h</code></em>);</pre>
1467 <p>
1468 Get size (width and height) of given <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> in points.
1469 </p>
1470 <div class="variablelist"><table border="0">
1471 <col align="left" valign="top">
1472 <tbody>
1473 <tr>
1474 <td><p><span class="term"><em class="parameter"><code>frame</code></em> :</span></p></td>
1475 <td>
1476 <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> structure to query</td>
1477 </tr>
1478 <tr>
1479 <td><p><span class="term"><em class="parameter"><code>w</code></em> :</span></p></td>
1480 <td>pointer to location to receive width of frame</td>
1481 </tr>
1482 <tr>
1483 <td><p><span class="term"><em class="parameter"><code>h</code></em> :</span></p></td>
1484 <td>pointer to location to receive height of frame</td>
1485 </tr>
1486 </tbody>
1487 </table></div>
1488 </div>
1489 <hr>
1490 <div class="refsect2">
1491 <a name="lgl-template-frame-get-n-labels"></a><h3>lgl_template_frame_get_n_labels ()</h3>
1492 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>                lgl_template_frame_get_n_labels     (<em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> *frame</code></em>);</pre>
1493 <p>
1494 Get total number of labels per sheet corresponding to the given frame.
1495 </p>
1496 <div class="variablelist"><table border="0">
1497 <col align="left" valign="top">
1498 <tbody>
1499 <tr>
1500 <td><p><span class="term"><em class="parameter"><code>frame</code></em> :</span></p></td>
1501 <td>
1502 <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> structure to query</td>
1503 </tr>
1504 <tr>
1505 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1506 <td>number of labels per sheet.</td>
1507 </tr>
1508 </tbody>
1509 </table></div>
1510 </div>
1511 <hr>
1512 <div class="refsect2">
1513 <a name="lgl-template-frame-get-origins"></a><h3>lgl_template_frame_get_origins ()</h3>
1514 <pre class="programlisting"><a class="link" href="libglabels-3.0-template.html#lglTemplateOrigin" title="struct lglTemplateOrigin"><span class="returnvalue">lglTemplateOrigin</span></a> * lgl_template_frame_get_origins      (<em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> *frame</code></em>);</pre>
1515 <p>
1516 Get an array of label origins for the given frame.  These origins represent the
1517 upper left hand corner of each label on a page corresponding to the given frame.
1518 The origins will be ordered geometrically left to right and then top to bottom.
1519 The array should be freed using <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>.
1520 </p>
1521 <div class="variablelist"><table border="0">
1522 <col align="left" valign="top">
1523 <tbody>
1524 <tr>
1525 <td><p><span class="term"><em class="parameter"><code>frame</code></em> :</span></p></td>
1526 <td>
1527 <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> structure to query</td>
1528 </tr>
1529 <tr>
1530 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1531 <td>A newly allocated array of <a class="link" href="libglabels-3.0-template.html#lglTemplateOrigin" title="struct lglTemplateOrigin"><span class="type">lglTemplateOrigin</span></a> structures.</td>
1532 </tr>
1533 </tbody>
1534 </table></div>
1535 </div>
1536 <hr>
1537 <div class="refsect2">
1538 <a name="lgl-template-frame-get-layout-description"></a><h3>lgl_template_frame_get_layout_description ()</h3>
1539 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             lgl_template_frame_get_layout_description
1540                                                         (<em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> *frame</code></em>);</pre>
1541 <p>
1542 Get a description of the label layout including number of labels per sheet.
1543 </p>
1544 <div class="variablelist"><table border="0">
1545 <col align="left" valign="top">
1546 <tbody>
1547 <tr>
1548 <td><p><span class="term"><em class="parameter"><code>frame</code></em> :</span></p></td>
1549 <td>
1550 <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> structure to query</td>
1551 </tr>
1552 <tr>
1553 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1554 <td>a newly allocation description string.</td>
1555 </tr>
1556 </tbody>
1557 </table></div>
1558 </div>
1559 <hr>
1560 <div class="refsect2">
1561 <a name="lgl-template-frame-get-size-description"></a><h3>lgl_template_frame_get_size_description ()</h3>
1562 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *             lgl_template_frame_get_size_description
1563                                                         (<em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> *frame</code></em>,
1564                                                          <em class="parameter"><code><a class="link" href="libglabels-3.0-units.html#lglUnits" title="enum lglUnits"><span class="type">lglUnits</span></a> units</code></em>);</pre>
1565 <p>
1566 Get a description of the label size.
1567 </p>
1568 <div class="variablelist"><table border="0">
1569 <col align="left" valign="top">
1570 <tbody>
1571 <tr>
1572 <td><p><span class="term"><em class="parameter"><code>frame</code></em> :</span></p></td>
1573 <td>
1574 <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> structure to query</td>
1575 </tr>
1576 <tr>
1577 <td><p><span class="term"><em class="parameter"><code>units</code></em> :</span></p></td>
1578 <td><a class="link" href="libglabels-3.0-units.html#lglUnits" title="enum lglUnits"><span class="type">lglUnits</span></a></td>
1579 </tr>
1580 <tr>
1581 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1582 <td>a newly allocation description string.</td>
1583 </tr>
1584 </tbody>
1585 </table></div>
1586 </div>
1587 <hr>
1588 <div class="refsect2">
1589 <a name="lgl-template-layout-new"></a><h3>lgl_template_layout_new ()</h3>
1590 <pre class="programlisting"><a class="link" href="libglabels-3.0-template.html#lglTemplateLayout" title="struct lglTemplateLayout"><span class="returnvalue">lglTemplateLayout</span></a> * lgl_template_layout_new             (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> nx</code></em>,
1591                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="type">gint</span></a> ny</code></em>,
1592                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> x0</code></em>,
1593                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> y0</code></em>,
1594                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> dx</code></em>,
1595                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> dy</code></em>);</pre>
1596 <p>
1597 This function creates a new layout structure with the given parameters.
1598 </p>
1599 <div class="variablelist"><table border="0">
1600 <col align="left" valign="top">
1601 <tbody>
1602 <tr>
1603 <td><p><span class="term"><em class="parameter"><code>nx</code></em> :</span></p></td>
1604 <td>Number of labels across.</td>
1605 </tr>
1606 <tr>
1607 <td><p><span class="term"><em class="parameter"><code>ny</code></em> :</span></p></td>
1608 <td>Number of labels down.</td>
1609 </tr>
1610 <tr>
1611 <td><p><span class="term"><em class="parameter"><code>x0</code></em> :</span></p></td>
1612 <td>X coordinate of the top-left corner of the top-left label in the layout in points.</td>
1613 </tr>
1614 <tr>
1615 <td><p><span class="term"><em class="parameter"><code>y0</code></em> :</span></p></td>
1616 <td>Y coordinate of the top-left corner of the top-left label in the layout in points.</td>
1617 </tr>
1618 <tr>
1619 <td><p><span class="term"><em class="parameter"><code>dx</code></em> :</span></p></td>
1620 <td>Horizontal pitch in points.  This is the distance from left-edge to left-edge.</td>
1621 </tr>
1622 <tr>
1623 <td><p><span class="term"><em class="parameter"><code>dy</code></em> :</span></p></td>
1624 <td>Vertical pitch in points.  This is the distance from top-edge to top-edge.</td>
1625 </tr>
1626 <tr>
1627 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1628 <td>a newly allocated <a class="link" href="libglabels-3.0-template.html#lglTemplateLayout" title="struct lglTemplateLayout"><span class="type">lglTemplateLayout</span></a> structure.</td>
1629 </tr>
1630 </tbody>
1631 </table></div>
1632 </div>
1633 <hr>
1634 <div class="refsect2">
1635 <a name="lgl-template-layout-dup"></a><h3>lgl_template_layout_dup ()</h3>
1636 <pre class="programlisting"><a class="link" href="libglabels-3.0-template.html#lglTemplateLayout" title="struct lglTemplateLayout"><span class="returnvalue">lglTemplateLayout</span></a> * lgl_template_layout_dup             (<em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplateLayout" title="struct lglTemplateLayout"><span class="type">lglTemplateLayout</span></a> *orig_layout</code></em>);</pre>
1637 <p>
1638 This function duplicates a template layout structure.
1639 </p>
1640 <div class="variablelist"><table border="0">
1641 <col align="left" valign="top">
1642 <tbody>
1643 <tr>
1644 <td><p><span class="term"><em class="parameter"><code>orig_layout</code></em> :</span></p></td>
1645 <td>Layout to duplicate.</td>
1646 </tr>
1647 <tr>
1648 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1649 <td>a newly allocated <a class="link" href="libglabels-3.0-template.html#lglTemplateLayout" title="struct lglTemplateLayout"><span class="type">lglTemplateLayout</span></a> structure.</td>
1650 </tr>
1651 </tbody>
1652 </table></div>
1653 </div>
1654 <hr>
1655 <div class="refsect2">
1656 <a name="lgl-template-layout-free"></a><h3>lgl_template_layout_free ()</h3>
1657 <pre class="programlisting"><span class="returnvalue">void</span>                lgl_template_layout_free            (<em class="parameter"><code><a class="link" href="libglabels-3.0-template.html#lglTemplateLayout" title="struct lglTemplateLayout"><span class="type">lglTemplateLayout</span></a> *layout</code></em>);</pre>
1658 <p>
1659 This function frees all memory associated with given template layout structure.
1660 </p>
1661 <div class="variablelist"><table border="0">
1662 <col align="left" valign="top">
1663 <tbody><tr>
1664 <td><p><span class="term"><em class="parameter"><code>layout</code></em> :</span></p></td>
1665 <td>Layout to free.</td>
1666 </tr></tbody>
1667 </table></div>
1668 </div>
1669 <hr>
1670 <div class="refsect2">
1671 <a name="lgl-template-markup-margin-new"></a><h3>lgl_template_markup_margin_new ()</h3>
1672 <pre class="programlisting"><a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="returnvalue">lglTemplateMarkup</span></a> * lgl_template_markup_margin_new      (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> size</code></em>);</pre>
1673 <p>
1674 This function creates a new margin markup structure.
1675 </p>
1676 <div class="variablelist"><table border="0">
1677 <col align="left" valign="top">
1678 <tbody>
1679 <tr>
1680 <td><p><span class="term"><em class="parameter"><code>size</code></em> :</span></p></td>
1681 <td>margin size in points.</td>
1682 </tr>
1683 <tr>
1684 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1685 <td>a newly allocated <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="type">lglTemplateMarkup</span></a> structure.</td>
1686 </tr>
1687 </tbody>
1688 </table></div>
1689 </div>
1690 <hr>
1691 <div class="refsect2">
1692 <a name="lgl-template-markup-line-new"></a><h3>lgl_template_markup_line_new ()</h3>
1693 <pre class="programlisting"><a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="returnvalue">lglTemplateMarkup</span></a> * lgl_template_markup_line_new        (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> x1</code></em>,
1694                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> y1</code></em>,
1695                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> x2</code></em>,
1696                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> y2</code></em>);</pre>
1697 <p>
1698 This function creates a new line markup structure.
1699 </p>
1700 <div class="variablelist"><table border="0">
1701 <col align="left" valign="top">
1702 <tbody>
1703 <tr>
1704 <td><p><span class="term"><em class="parameter"><code>x1</code></em> :</span></p></td>
1705 <td>x coordinate of first endpoint.</td>
1706 </tr>
1707 <tr>
1708 <td><p><span class="term"><em class="parameter"><code>y1</code></em> :</span></p></td>
1709 <td>y coordinate of first endpoint.</td>
1710 </tr>
1711 <tr>
1712 <td><p><span class="term"><em class="parameter"><code>x2</code></em> :</span></p></td>
1713 <td>x coordinate of second endpoint.</td>
1714 </tr>
1715 <tr>
1716 <td><p><span class="term"><em class="parameter"><code>y2</code></em> :</span></p></td>
1717 <td>y coordinate of second endpoint.</td>
1718 </tr>
1719 <tr>
1720 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1721 <td>a newly allocated <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="type">lglTemplateMarkup</span></a> structure.</td>
1722 </tr>
1723 </tbody>
1724 </table></div>
1725 </div>
1726 <hr>
1727 <div class="refsect2">
1728 <a name="lgl-template-markup-circle-new"></a><h3>lgl_template_markup_circle_new ()</h3>
1729 <pre class="programlisting"><a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="returnvalue">lglTemplateMarkup</span></a> * lgl_template_markup_circle_new      (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> x0</code></em>,
1730                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> y0</code></em>,
1731                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> r</code></em>);</pre>
1732 <p>
1733 This function creates a new circle markup structure.
1734 </p>
1735 <div class="variablelist"><table border="0">
1736 <col align="left" valign="top">
1737 <tbody>
1738 <tr>
1739 <td><p><span class="term"><em class="parameter"><code>x0</code></em> :</span></p></td>
1740 <td>x coordinate of center of circle.</td>
1741 </tr>
1742 <tr>
1743 <td><p><span class="term"><em class="parameter"><code>y0</code></em> :</span></p></td>
1744 <td>y coordinate of center of circle.</td>
1745 </tr>
1746 <tr>
1747 <td><p><span class="term"><em class="parameter"><code>r</code></em> :</span></p></td>
1748 <td>radius of circle.</td>
1749 </tr>
1750 <tr>
1751 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1752 <td>a newly allocated <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="type">lglTemplateMarkup</span></a> structure.</td>
1753 </tr>
1754 </tbody>
1755 </table></div>
1756 </div>
1757 <hr>
1758 <div class="refsect2">
1759 <a name="lgl-template-markup-rect-new"></a><h3>lgl_template_markup_rect_new ()</h3>
1760 <pre class="programlisting"><a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="returnvalue">lglTemplateMarkup</span></a> * lgl_template_markup_rect_new        (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> x1</code></em>,
1761                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> y1</code></em>,
1762                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> w</code></em>,
1763                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> h</code></em>,
1764                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> r</code></em>);</pre>
1765 <p>
1766 This function creates a new rectangle markup structure.
1767 </p>
1768 <div class="variablelist"><table border="0">
1769 <col align="left" valign="top">
1770 <tbody>
1771 <tr>
1772 <td><p><span class="term"><em class="parameter"><code>x1</code></em> :</span></p></td>
1773 <td>x coordinate of top-left corner of rectangle.</td>
1774 </tr>
1775 <tr>
1776 <td><p><span class="term"><em class="parameter"><code>y1</code></em> :</span></p></td>
1777 <td>y coordinate of top-left corner of rectangle.</td>
1778 </tr>
1779 <tr>
1780 <td><p><span class="term"><em class="parameter"><code>w</code></em> :</span></p></td>
1781 <td>width of rectangle.</td>
1782 </tr>
1783 <tr>
1784 <td><p><span class="term"><em class="parameter"><code>h</code></em> :</span></p></td>
1785 <td>height of rectangle.</td>
1786 </tr>
1787 <tr>
1788 <td><p><span class="term"><em class="parameter"><code>r</code></em> :</span></p></td>
1789 <td>radius of rounded corner.</td>
1790 </tr>
1791 <tr>
1792 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1793 <td>a newly allocated <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="type">lglTemplateMarkup</span></a> structure.</td>
1794 </tr>
1795 </tbody>
1796 </table></div>
1797 </div>
1798 <hr>
1799 <div class="refsect2">
1800 <a name="lgl-template-markup-ellipse-new"></a><h3>lgl_template_markup_ellipse_new ()</h3>
1801 <pre class="programlisting"><a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="returnvalue">lglTemplateMarkup</span></a> * lgl_template_markup_ellipse_new     (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> x1</code></em>,
1802                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> y1</code></em>,
1803                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> w</code></em>,
1804                                                          <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> h</code></em>);</pre>
1805 <p>
1806 This function creates a new ellipse markup structure.
1807 </p>
1808 <div class="variablelist"><table border="0">
1809 <col align="left" valign="top">
1810 <tbody>
1811 <tr>
1812 <td><p><span class="term"><em class="parameter"><code>x1</code></em> :</span></p></td>
1813 <td>x coordinate of top-left corner of ellipse.</td>
1814 </tr>
1815 <tr>
1816 <td><p><span class="term"><em class="parameter"><code>y1</code></em> :</span></p></td>
1817 <td>y coordinate of top-left corner of ellipse.</td>
1818 </tr>
1819 <tr>
1820 <td><p><span class="term"><em class="parameter"><code>w</code></em> :</span></p></td>
1821 <td>width of ellipse.</td>
1822 </tr>
1823 <tr>
1824 <td><p><span class="term"><em class="parameter"><code>h</code></em> :</span></p></td>
1825 <td>height of ellipse.</td>
1826 </tr>
1827 <tr>
1828 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1829 <td>a newly allocated <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="type">lglTemplateMarkup</span></a> structure.</td>
1830 </tr>
1831 </tbody>
1832 </table></div>
1833 </div>
1834 <hr>
1835 <div class="refsect2">
1836 <a name="lgl-template-markup-dup"></a><h3>lgl_template_markup_dup ()</h3>
1837 <pre class="programlisting"><a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="returnvalue">lglTemplateMarkup</span></a> * lgl_template_markup_dup             (<em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="type">lglTemplateMarkup</span></a> *orig_markup</code></em>);</pre>
1838 <p>
1839 This function duplicates a template markup structure.
1840 </p>
1841 <div class="variablelist"><table border="0">
1842 <col align="left" valign="top">
1843 <tbody>
1844 <tr>
1845 <td><p><span class="term"><em class="parameter"><code>orig_markup</code></em> :</span></p></td>
1846 <td>Markup to duplicate.</td>
1847 </tr>
1848 <tr>
1849 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1850 <td>a newly allocated <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="type">lglTemplateMarkup</span></a> structure.</td>
1851 </tr>
1852 </tbody>
1853 </table></div>
1854 </div>
1855 <hr>
1856 <div class="refsect2">
1857 <a name="lgl-template-markup-free"></a><h3>lgl_template_markup_free ()</h3>
1858 <pre class="programlisting"><span class="returnvalue">void</span>                lgl_template_markup_free            (<em class="parameter"><code><a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="type">lglTemplateMarkup</span></a> *markup</code></em>);</pre>
1859 <p>
1860 This function frees all memory associated with given template markup structure.
1861 </p>
1862 <div class="variablelist"><table border="0">
1863 <col align="left" valign="top">
1864 <tbody><tr>
1865 <td><p><span class="term"><em class="parameter"><code>markup</code></em> :</span></p></td>
1866 <td>Markup to free.</td>
1867 </tr></tbody>
1868 </table></div>
1869 </div>
1870 <hr>
1871 <div class="refsect2">
1872 <a name="lgl-template-print"></a><h3>lgl_template_print ()</h3>
1873 <pre class="programlisting"><span class="returnvalue">void</span>                lgl_template_print                  (<em class="parameter"><code>const <a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="type">lglTemplate</span></a> *template</code></em>);</pre>
1874 <p>
1875 Print template details (for debugging purposes).
1876 </p>
1877 <div class="variablelist"><table border="0">
1878 <col align="left" valign="top">
1879 <tbody><tr>
1880 <td><p><span class="term"><em class="parameter"><code>template</code></em> :</span></p></td>
1881 <td>template</td>
1882 </tr></tbody>
1883 </table></div>
1884 </div>
1885 </div>
1886 </div>
1887 <div class="footer">
1888 <hr>
1889           Generated by GTK-Doc V1.17</div>
1890 </body>
1891 </html>