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>LibGlabels 3.0 Reference Manual: The lglTemplate Structure</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.78.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.20 (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="10"><tr valign="middle">
  16 <td width="100%" align="left" class="shortcuts">
  17 <a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span>
  18                   <a href="#libglabels-3.0-template.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span>
  19                   <a href="#libglabels-3.0-template.object-hierarchy" class="shortcut">Object Hierarchy</a></span>
  20 </td>
  21 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
  22 <td><a accesskey="u" href="ch01.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
  23 <td><a accesskey="p" href="libglabels-3.0-db.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
  24 <td><a accesskey="n" href="libglabels-3.0-paper.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
  25 </tr></table>
  26 <div class="refentry">
  27 <a name="libglabels-3.0-template"></a><div class="titlepage"></div>
  28 <div class="refnamediv"><table width="100%"><tr>
  29 <td valign="top">
  30 <h2><span class="refentrytitle"><a name="libglabels-3.0-template.top_of_page"></a>The lglTemplate Structure</span></h2>
  31 <p>The lglTemplate Structure — How templates are represented in memory</p>
  32 </td>
  33 <td class="gallery_image" valign="top" align="right"></td>
  34 </tr></table></div>
  35 <div class="refsect1">
  36 <a name="libglabels-3.0-template.functions"></a><h2>Functions</h2>
  37 <div class="informaltable"><table width="100%" border="0">
  38 <colgroup>
  39 <col width="150px" class="functions_return">
  40 <col class="functions_name">
  41 </colgroup>
  42 <tbody>
  43 <tr>
  44 <td class="function_type">
  45 <a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="returnvalue">lglTemplate</span></a> *
  46 </td>
  47 <td class="function_name">
  48 <a class="link" href="libglabels-3.0-template.html#lgl-template-new" title="lgl_template_new ()">lgl_template_new</a> <span class="c_punctuation">()</span>
  49 </td>
  50 </tr>
  51 <tr>
  52 <td class="function_type">
  53 <a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="returnvalue">lglTemplate</span></a> *
  54 </td>
  55 <td class="function_name">
  56 <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> <span class="c_punctuation">()</span>
  57 </td>
  58 </tr>
  59 <tr>
  60 <td class="function_type">
  61 <a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="returnvalue">lglTemplate</span></a> *
  62 </td>
  63 <td class="function_name">
  64 <a class="link" href="libglabels-3.0-template.html#lgl-template-dup" title="lgl_template_dup ()">lgl_template_dup</a> <span class="c_punctuation">()</span>
  65 </td>
  66 </tr>
  67 <tr>
  68 <td class="function_type">
  69 <span class="returnvalue">void</span>
  70 </td>
  71 <td class="function_name">
  72 <a class="link" href="libglabels-3.0-template.html#lgl-template-free" title="lgl_template_free ()">lgl_template_free</a> <span class="c_punctuation">()</span>
  73 </td>
  74 </tr>
  75 <tr>
  76 <td class="function_type">
  77 <span class="returnvalue">void</span>
  78 </td>
  79 <td class="function_name">
  80 <a class="link" href="libglabels-3.0-template.html#lgl-template-add-category" title="lgl_template_add_category ()">lgl_template_add_category</a> <span class="c_punctuation">()</span>
  81 </td>
  82 </tr>
  83 <tr>
  84 <td class="function_type">
  85 <span class="returnvalue">void</span>
  86 </td>
  87 <td class="function_name">
  88 <a class="link" href="libglabels-3.0-template.html#lgl-template-add-frame" title="lgl_template_add_frame ()">lgl_template_add_frame</a> <span class="c_punctuation">()</span>
  89 </td>
  90 </tr>
  91 <tr>
  92 <td class="function_type">
  93 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
  94 </td>
  95 <td class="function_name">
  96 <a class="link" href="libglabels-3.0-template.html#lgl-template-get-name" title="lgl_template_get_name ()">lgl_template_get_name</a> <span class="c_punctuation">()</span>
  97 </td>
  98 </tr>
  99 <tr>
 100 <td class="function_type">
 101 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 102 </td>
 103 <td class="function_name">
 104 <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> <span class="c_punctuation">()</span>
 105 </td>
 106 </tr>
 107 <tr>
 108 <td class="function_type">
 109 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 110 </td>
 111 <td class="function_name">
 112 <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> <span class="c_punctuation">()</span>
 113 </td>
 114 </tr>
 115 <tr>
 116 <td class="function_type">
 117 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 118 </td>
 119 <td class="function_name">
 120 <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> <span class="c_punctuation">()</span>
 121 </td>
 122 </tr>
 123 <tr>
 124 <td class="function_type">
 125 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 126 </td>
 127 <td class="function_name">
 128 <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> <span class="c_punctuation">()</span>
 129 </td>
 130 </tr>
 131 <tr>
 132 <td class="function_type">
 133 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 134 </td>
 135 <td class="function_name">
 136 <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> <span class="c_punctuation">()</span>
 137 </td>
 138 </tr>
 139 <tr>
 140 <td class="function_type">
 141 <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="returnvalue">lglTemplateFrame</span></a> *
 142 </td>
 143 <td class="function_name">
 144 <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> <span class="c_punctuation">()</span>
 145 </td>
 146 </tr>
 147 <tr>
 148 <td class="function_type">
 149 <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="returnvalue">lglTemplateFrame</span></a> *
 150 </td>
 151 <td class="function_name">
 152 <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> <span class="c_punctuation">()</span>
 153 </td>
 154 </tr>
 155 <tr>
 156 <td class="function_type">
 157 <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="returnvalue">lglTemplateFrame</span></a> *
 158 </td>
 159 <td class="function_name">
 160 <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> <span class="c_punctuation">()</span>
 161 </td>
 162 </tr>
 163 <tr>
 164 <td class="function_type">
 165 <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="returnvalue">lglTemplateFrame</span></a> *
 166 </td>
 167 <td class="function_name">
 168 <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> <span class="c_punctuation">()</span>
 169 </td>
 170 </tr>
 171 <tr>
 172 <td class="function_type">
 173 <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="returnvalue">lglTemplateFrame</span></a> *
 174 </td>
 175 <td class="function_name">
 176 <a class="link" href="libglabels-3.0-template.html#lgl-template-frame-dup" title="lgl_template_frame_dup ()">lgl_template_frame_dup</a> <span class="c_punctuation">()</span>
 177 </td>
 178 </tr>
 179 <tr>
 180 <td class="function_type">
 181 <span class="returnvalue">void</span>
 182 </td>
 183 <td class="function_name">
 184 <a class="link" href="libglabels-3.0-template.html#lgl-template-frame-free" title="lgl_template_frame_free ()">lgl_template_frame_free</a> <span class="c_punctuation">()</span>
 185 </td>
 186 </tr>
 187 <tr>
 188 <td class="function_type">
 189 <span class="returnvalue">void</span>
 190 </td>
 191 <td class="function_name">
 192 <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> <span class="c_punctuation">()</span>
 193 </td>
 194 </tr>
 195 <tr>
 196 <td class="function_type">
 197 <span class="returnvalue">void</span>
 198 </td>
 199 <td class="function_name">
 200 <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> <span class="c_punctuation">()</span>
 201 </td>
 202 </tr>
 203 <tr>
 204 <td class="function_type">
 205 <span class="returnvalue">void</span>
 206 </td>
 207 <td class="function_name">
 208 <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> <span class="c_punctuation">()</span>
 209 </td>
 210 </tr>
 211 <tr>
 212 <td class="function_type">
 213 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
 214 </td>
 215 <td class="function_name">
 216 <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> <span class="c_punctuation">()</span>
 217 </td>
 218 </tr>
 219 <tr>
 220 <td class="function_type">
 221 <a class="link" href="libglabels-3.0-template.html#lglTemplateOrigin" title="struct lglTemplateOrigin"><span class="returnvalue">lglTemplateOrigin</span></a> *
 222 </td>
 223 <td class="function_name">
 224 <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> <span class="c_punctuation">()</span>
 225 </td>
 226 </tr>
 227 <tr>
 228 <td class="function_type">
 229 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
 230 </td>
 231 <td class="function_name">
 232 <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> <span class="c_punctuation">()</span>
 233 </td>
 234 </tr>
 235 <tr>
 236 <td class="function_type">
 237 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
 238 </td>
 239 <td class="function_name">
 240 <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> <span class="c_punctuation">()</span>
 241 </td>
 242 </tr>
 243 <tr>
 244 <td class="function_type">
 245 <a class="link" href="libglabels-3.0-template.html#lglTemplateLayout" title="struct lglTemplateLayout"><span class="returnvalue">lglTemplateLayout</span></a> *
 246 </td>
 247 <td class="function_name">
 248 <a class="link" href="libglabels-3.0-template.html#lgl-template-layout-new" title="lgl_template_layout_new ()">lgl_template_layout_new</a> <span class="c_punctuation">()</span>
 249 </td>
 250 </tr>
 251 <tr>
 252 <td class="function_type">
 253 <a class="link" href="libglabels-3.0-template.html#lglTemplateLayout" title="struct lglTemplateLayout"><span class="returnvalue">lglTemplateLayout</span></a> *
 254 </td>
 255 <td class="function_name">
 256 <a class="link" href="libglabels-3.0-template.html#lgl-template-layout-dup" title="lgl_template_layout_dup ()">lgl_template_layout_dup</a> <span class="c_punctuation">()</span>
 257 </td>
 258 </tr>
 259 <tr>
 260 <td class="function_type">
 261 <span class="returnvalue">void</span>
 262 </td>
 263 <td class="function_name">
 264 <a class="link" href="libglabels-3.0-template.html#lgl-template-layout-free" title="lgl_template_layout_free ()">lgl_template_layout_free</a> <span class="c_punctuation">()</span>
 265 </td>
 266 </tr>
 267 <tr>
 268 <td class="function_type">
 269 <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="returnvalue">lglTemplateMarkup</span></a> *
 270 </td>
 271 <td class="function_name">
 272 <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> <span class="c_punctuation">()</span>
 273 </td>
 274 </tr>
 275 <tr>
 276 <td class="function_type">
 277 <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="returnvalue">lglTemplateMarkup</span></a> *
 278 </td>
 279 <td class="function_name">
 280 <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> <span class="c_punctuation">()</span>
 281 </td>
 282 </tr>
 283 <tr>
 284 <td class="function_type">
 285 <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="returnvalue">lglTemplateMarkup</span></a> *
 286 </td>
 287 <td class="function_name">
 288 <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> <span class="c_punctuation">()</span>
 289 </td>
 290 </tr>
 291 <tr>
 292 <td class="function_type">
 293 <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="returnvalue">lglTemplateMarkup</span></a> *
 294 </td>
 295 <td class="function_name">
 296 <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> <span class="c_punctuation">()</span>
 297 </td>
 298 </tr>
 299 <tr>
 300 <td class="function_type">
 301 <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="returnvalue">lglTemplateMarkup</span></a> *
 302 </td>
 303 <td class="function_name">
 304 <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> <span class="c_punctuation">()</span>
 305 </td>
 306 </tr>
 307 <tr>
 308 <td class="function_type">
 309 <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="returnvalue">lglTemplateMarkup</span></a> *
 310 </td>
 311 <td class="function_name">
 312 <a class="link" href="libglabels-3.0-template.html#lgl-template-markup-dup" title="lgl_template_markup_dup ()">lgl_template_markup_dup</a> <span class="c_punctuation">()</span>
 313 </td>
 314 </tr>
 315 <tr>
 316 <td class="function_type">
 317 <span class="returnvalue">void</span>
 318 </td>
 319 <td class="function_name">
 320 <a class="link" href="libglabels-3.0-template.html#lgl-template-markup-free" title="lgl_template_markup_free ()">lgl_template_markup_free</a> <span class="c_punctuation">()</span>
 321 </td>
 322 </tr>
 323 <tr>
 324 <td class="function_type">
 325 <span class="returnvalue">void</span>
 326 </td>
 327 <td class="function_name">
 328 <a class="link" href="libglabels-3.0-template.html#lgl-template-print" title="lgl_template_print ()">lgl_template_print</a> <span class="c_punctuation">()</span>
 329 </td>
 330 </tr>
 331 </tbody>
 332 </table></div>
 333 </div>
 334 <div class="refsect1">
 335 <a name="libglabels-3.0-template.other"></a><h2>Types and Values</h2>
 336 <div class="informaltable"><table width="100%" border="0">
 337 <colgroup>
 338 <col width="150px" class="name">
 339 <col class="description">
 340 </colgroup>
 341 <tbody>
 342 <tr>
 343 <td class="datatype_keyword">struct</td>
 344 <td class="function_name"><a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate">lglTemplate</a></td>
 345 </tr>
 346 <tr>
 347 <td class="datatype_keyword">enum</td>
 348 <td class="function_name"><a class="link" href="libglabels-3.0-template.html#lglTemplateFrameShape" title="enum lglTemplateFrameShape">lglTemplateFrameShape</a></td>
 349 </tr>
 350 <tr>
 351 <td class="datatype_keyword">union</td>
 352 <td class="function_name"><a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame">lglTemplateFrame</a></td>
 353 </tr>
 354 <tr>
 355 <td class="datatype_keyword">struct</td>
 356 <td class="function_name"><a class="link" href="libglabels-3.0-template.html#lglTemplateFrameAll" title="struct lglTemplateFrameAll">lglTemplateFrameAll</a></td>
 357 </tr>
 358 <tr>
 359 <td class="datatype_keyword">struct</td>
 360 <td class="function_name"><a class="link" href="libglabels-3.0-template.html#lglTemplateFrameRect" title="struct lglTemplateFrameRect">lglTemplateFrameRect</a></td>
 361 </tr>
 362 <tr>
 363 <td class="datatype_keyword">struct</td>
 364 <td class="function_name"><a class="link" href="libglabels-3.0-template.html#lglTemplateFrameEllipse" title="struct lglTemplateFrameEllipse">lglTemplateFrameEllipse</a></td>
 365 </tr>
 366 <tr>
 367 <td class="datatype_keyword">struct</td>
 368 <td class="function_name"><a class="link" href="libglabels-3.0-template.html#lglTemplateFrameRound" title="struct lglTemplateFrameRound">lglTemplateFrameRound</a></td>
 369 </tr>
 370 <tr>
 371 <td class="datatype_keyword">struct</td>
 372 <td class="function_name"><a class="link" href="libglabels-3.0-template.html#lglTemplateFrameCD" title="struct lglTemplateFrameCD">lglTemplateFrameCD</a></td>
 373 </tr>
 374 <tr>
 375 <td class="datatype_keyword">struct</td>
 376 <td class="function_name"><a class="link" href="libglabels-3.0-template.html#lglTemplateLayout" title="struct lglTemplateLayout">lglTemplateLayout</a></td>
 377 </tr>
 378 <tr>
 379 <td class="datatype_keyword">enum</td>
 380 <td class="function_name"><a class="link" href="libglabels-3.0-template.html#lglTemplateMarkupType" title="enum lglTemplateMarkupType">lglTemplateMarkupType</a></td>
 381 </tr>
 382 <tr>
 383 <td class="datatype_keyword">union</td>
 384 <td class="function_name"><a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup">lglTemplateMarkup</a></td>
 385 </tr>
 386 <tr>
 387 <td class="datatype_keyword">struct</td>
 388 <td class="function_name"><a class="link" href="libglabels-3.0-template.html#lglTemplateMarkupMargin" title="struct lglTemplateMarkupMargin">lglTemplateMarkupMargin</a></td>
 389 </tr>
 390 <tr>
 391 <td class="datatype_keyword">struct</td>
 392 <td class="function_name"><a class="link" href="libglabels-3.0-template.html#lglTemplateMarkupLine" title="struct lglTemplateMarkupLine">lglTemplateMarkupLine</a></td>
 393 </tr>
 394 <tr>
 395 <td class="datatype_keyword">struct</td>
 396 <td class="function_name"><a class="link" href="libglabels-3.0-template.html#lglTemplateMarkupCircle" title="struct lglTemplateMarkupCircle">lglTemplateMarkupCircle</a></td>
 397 </tr>
 398 <tr>
 399 <td class="datatype_keyword">struct</td>
 400 <td class="function_name"><a class="link" href="libglabels-3.0-template.html#lglTemplateMarkupRect" title="struct lglTemplateMarkupRect">lglTemplateMarkupRect</a></td>
 401 </tr>
 402 <tr>
 403 <td class="datatype_keyword">struct</td>
 404 <td class="function_name"><a class="link" href="libglabels-3.0-template.html#lglTemplateMarkupEllipse" title="struct lglTemplateMarkupEllipse">lglTemplateMarkupEllipse</a></td>
 405 </tr>
 406 <tr>
 407 <td class="datatype_keyword">struct</td>
 408 <td class="function_name"><a class="link" href="libglabels-3.0-template.html#lglTemplateOrigin" title="struct lglTemplateOrigin">lglTemplateOrigin</a></td>
 409 </tr>
 410 </tbody>
 411 </table></div>
 412 </div>
 413 <div class="refsect1">
 414 <a name="libglabels-3.0-template.object-hierarchy"></a><h2>Object Hierarchy</h2>
 415 <pre class="screen">
 416 </pre>
 417 </div>
 418 <div class="refsect1">
 419 <a name="libglabels-3.0-template.includes"></a><h2>Includes</h2>
 420 <pre class="synopsis">#include &lt;libglabels/lgl-template.h&gt;
 421 </pre>
 422 </div>
 423 <div class="refsect1">
 424 <a name="libglabels-3.0-template.description"></a><h2>Description</h2>
 425 <p>
 426 This section describes a set of structures that represent a template in memory.  It also
 427 describes functions to help create and interpret these structures.
 428 </p>
 429 </div>
 430 <div class="refsect1">
 431 <a name="libglabels-3.0-template.functions_details"></a><h2>Functions</h2>
 432 <div class="refsect2">
 433 <a name="lgl-template-new"></a><h3>lgl_template_new ()</h3>
 434 <pre class="programlisting"><a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="returnvalue">lglTemplate</span></a> *
 435 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>,
 436                   <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>,
 437                   <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>,
 438                   <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>,
 439                   <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>,
 440                   <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>
 441 <p>Create a new template structure, with the given top-level attributes.  The
 442 created template will have no initial categories, or frames associated with
 443 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
 444 these.</p>
 445 <div class="refsect3">
 446 <a name="id-1.2.3.8.2.5"></a><h4>Parameters</h4>
 447 <div class="informaltable"><table width="100%" border="0">
 448 <colgroup>
 449 <col width="150px" class="parameters_name">
 450 <col class="parameters_description">
 451 <col width="200px" class="parameters_annotations">
 452 </colgroup>
 453 <tbody>
 454 <tr>
 455 <td class="parameter_name"><p>brand</p></td>
 456 <td class="parameter_description"><p>Template brand</p></td>
 457 <td class="parameter_annotations"> </td>
 458 </tr>
 459 <tr>
 460 <td class="parameter_name"><p>part</p></td>
 461 <td class="parameter_description"><p>Template part name/number</p></td>
 462 <td class="parameter_annotations"> </td>
 463 </tr>
 464 <tr>
 465 <td class="parameter_name"><p>description</p></td>
 466 <td class="parameter_description"><p>Template descriptions</p></td>
 467 <td class="parameter_annotations"> </td>
 468 </tr>
 469 <tr>
 470 <td class="parameter_name"><p>paper_id</p></td>
 471 <td class="parameter_description"><p>Page size id</p></td>
 472 <td class="parameter_annotations"> </td>
 473 </tr>
 474 <tr>
 475 <td class="parameter_name"><p>page_width</p></td>
 476 <td class="parameter_description"><p>Page width in points, set to zero unless paper_id="Other"</p></td>
 477 <td class="parameter_annotations"> </td>
 478 </tr>
 479 <tr>
 480 <td class="parameter_name"><p>page_height</p></td>
 481 <td class="parameter_description"><p>Page height in points, set to zero unless paper_id="Other"</p></td>
 482 <td class="parameter_annotations"> </td>
 483 </tr>
 484 </tbody>
 485 </table></div>
 486 </div>
 487 <div class="refsect3">
 488 <a name="id-1.2.3.8.2.6"></a><h4>Returns</h4>
 489 <p> 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.</p>
 490 <p></p>
 491 </div>
 492 </div>
 493 <hr>
 494 <div class="refsect2">
 495 <a name="lgl-template-new-from-equiv"></a><h3>lgl_template_new_from_equiv ()</h3>
 496 <pre class="programlisting"><a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="returnvalue">lglTemplate</span></a> *
 497 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>,
 498                              <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>,
 499                              <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>
 500 <p>Create a new template structure based on an existing template.  The
 501 created template will be a duplicate of the original template, except with
 502 the new part name/number.</p>
 503 <div class="refsect3">
 504 <a name="id-1.2.3.8.3.5"></a><h4>Parameters</h4>
 505 <div class="informaltable"><table width="100%" border="0">
 506 <colgroup>
 507 <col width="150px" class="parameters_name">
 508 <col class="parameters_description">
 509 <col width="200px" class="parameters_annotations">
 510 </colgroup>
 511 <tbody>
 512 <tr>
 513 <td class="parameter_name"><p>brand</p></td>
 514 <td class="parameter_description"><p>Template brand</p></td>
 515 <td class="parameter_annotations"> </td>
 516 </tr>
 517 <tr>
 518 <td class="parameter_name"><p>part</p></td>
 519 <td class="parameter_description"><p>Template part name/number</p></td>
 520 <td class="parameter_annotations"> </td>
 521 </tr>
 522 <tr>
 523 <td class="parameter_name"><p>equiv_part</p></td>
 524 <td class="parameter_description"><p>Name of equivalent part to base template on</p></td>
 525 <td class="parameter_annotations"> </td>
 526 </tr>
 527 </tbody>
 528 </table></div>
 529 </div>
 530 <div class="refsect3">
 531 <a name="id-1.2.3.8.3.6"></a><h4>Returns</h4>
 532 <p> 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.</p>
 533 <p></p>
 534 </div>
 535 </div>
 536 <hr>
 537 <div class="refsect2">
 538 <a name="lgl-template-dup"></a><h3>lgl_template_dup ()</h3>
 539 <pre class="programlisting"><a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="returnvalue">lglTemplate</span></a> *
 540 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>
 541 <p>This function duplicates a template structure.</p>
 542 <div class="refsect3">
 543 <a name="id-1.2.3.8.4.5"></a><h4>Parameters</h4>
 544 <div class="informaltable"><table width="100%" border="0">
 545 <colgroup>
 546 <col width="150px" class="parameters_name">
 547 <col class="parameters_description">
 548 <col width="200px" class="parameters_annotations">
 549 </colgroup>
 550 <tbody><tr>
 551 <td class="parameter_name"><p>orig_template</p></td>
 552 <td class="parameter_description"><p>Template to duplicate.</p></td>
 553 <td class="parameter_annotations"> </td>
 554 </tr></tbody>
 555 </table></div>
 556 </div>
 557 <div class="refsect3">
 558 <a name="id-1.2.3.8.4.6"></a><h4>Returns</h4>
 559 <p>  a newly allocated <a class="link" href="libglabels-3.0-template.html#lglTemplate" title="struct lglTemplate"><span class="type">lglTemplate</span></a> structure.</p>
 560 <p></p>
 561 </div>
 562 </div>
 563 <hr>
 564 <div class="refsect2">
 565 <a name="lgl-template-free"></a><h3>lgl_template_free ()</h3>
 566 <pre class="programlisting"><span class="returnvalue">void</span>
 567 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>
 568 <p>This function frees all memory associated with given template structure.</p>
 569 <div class="refsect3">
 570 <a name="id-1.2.3.8.5.5"></a><h4>Parameters</h4>
 571 <div class="informaltable"><table width="100%" border="0">
 572 <colgroup>
 573 <col width="150px" class="parameters_name">
 574 <col class="parameters_description">
 575 <col width="200px" class="parameters_annotations">
 576 </colgroup>
 577 <tbody><tr>
 578 <td class="parameter_name"><p>template</p></td>
 579 <td class="parameter_description"><p>Template to free.</p></td>
 580 <td class="parameter_annotations"> </td>
 581 </tr></tbody>
 582 </table></div>
 583 </div>
 584 </div>
 585 <hr>
 586 <div class="refsect2">
 587 <a name="lgl-template-add-category"></a><h3>lgl_template_add_category ()</h3>
 588 <pre class="programlisting"><span class="returnvalue">void</span>
 589 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>,
 590                            <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>
 591 <p>This function adds the given category ID to a templates category list.</p>
 592 <div class="refsect3">
 593 <a name="id-1.2.3.8.6.5"></a><h4>Parameters</h4>
 594 <div class="informaltable"><table width="100%" border="0">
 595 <colgroup>
 596 <col width="150px" class="parameters_name">
 597 <col class="parameters_description">
 598 <col width="200px" class="parameters_annotations">
 599 </colgroup>
 600 <tbody>
 601 <tr>
 602 <td class="parameter_name"><p>template</p></td>
 603 <td class="parameter_description"><p>Pointer to template structure</p></td>
 604 <td class="parameter_annotations"> </td>
 605 </tr>
 606 <tr>
 607 <td class="parameter_name"><p>category_id</p></td>
 608 <td class="parameter_description"><p>Category ID string</p></td>
 609 <td class="parameter_annotations"> </td>
 610 </tr>
 611 </tbody>
 612 </table></div>
 613 </div>
 614 </div>
 615 <hr>
 616 <div class="refsect2">
 617 <a name="lgl-template-add-frame"></a><h3>lgl_template_add_frame ()</h3>
 618 <pre class="programlisting"><span class="returnvalue">void</span>
 619 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>,
 620                         <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>
 621 <p>This function adds the given frame structure to the template.  Once added,
 622 the frame structure belongs to the given template; do not attempt to free
 623 it.</p>
 624 <p>Note: Currently glabels only supports a single frame per template.</p>
 625 <div class="refsect3">
 626 <a name="id-1.2.3.8.7.6"></a><h4>Parameters</h4>
 627 <div class="informaltable"><table width="100%" border="0">
 628 <colgroup>
 629 <col width="150px" class="parameters_name">
 630 <col class="parameters_description">
 631 <col width="200px" class="parameters_annotations">
 632 </colgroup>
 633 <tbody>
 634 <tr>
 635 <td class="parameter_name"><p>template</p></td>
 636 <td class="parameter_description"><p>Pointer to template structure</p></td>
 637 <td class="parameter_annotations"> </td>
 638 </tr>
 639 <tr>
 640 <td class="parameter_name"><p>frame</p></td>
 641 <td class="parameter_description"><p>Pointer to frame structure</p></td>
 642 <td class="parameter_annotations"> </td>
 643 </tr>
 644 </tbody>
 645 </table></div>
 646 </div>
 647 </div>
 648 <hr>
 649 <div class="refsect2">
 650 <a name="lgl-template-get-name"></a><h3>lgl_template_get_name ()</h3>
 651 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
 652 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>
 653 <p>This function returns the name of the given template.  The name is the concetenation
 654 of the brand and part name/number.</p>
 655 <div class="refsect3">
 656 <a name="id-1.2.3.8.8.5"></a><h4>Parameters</h4>
 657 <div class="informaltable"><table width="100%" border="0">
 658 <colgroup>
 659 <col width="150px" class="parameters_name">
 660 <col class="parameters_description">
 661 <col width="200px" class="parameters_annotations">
 662 </colgroup>
 663 <tbody><tr>
 664 <td class="parameter_name"><p>template</p></td>
 665 <td class="parameter_description"><p>Pointer to template structure to test</p></td>
 666 <td class="parameter_annotations"> </td>
 667 </tr></tbody>
 668 </table></div>
 669 </div>
 670 <div class="refsect3">
 671 <a name="id-1.2.3.8.8.6"></a><h4>Returns</h4>
 672 <p>  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>.</p>
 673 <p></p>
 674 </div>
 675 </div>
 676 <hr>
 677 <div class="refsect2">
 678 <a name="lgl-template-do-templates-match"></a><h3>lgl_template_do_templates_match ()</h3>
 679 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 680 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>,
 681                                  <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>
 682 <p>This function tests if the given templates match.  This is a simple test that only tests
 683 the brand and part name/number. It does not test if they are actually identical.</p>
 684 <div class="refsect3">
 685 <a name="id-1.2.3.8.9.5"></a><h4>Parameters</h4>
 686 <div class="informaltable"><table width="100%" border="0">
 687 <colgroup>
 688 <col width="150px" class="parameters_name">
 689 <col class="parameters_description">
 690 <col width="200px" class="parameters_annotations">
 691 </colgroup>
 692 <tbody>
 693 <tr>
 694 <td class="parameter_name"><p>template1</p></td>
 695 <td class="parameter_description"><p>Pointer to 1st template structure to test</p></td>
 696 <td class="parameter_annotations"> </td>
 697 </tr>
 698 <tr>
 699 <td class="parameter_name"><p>template2</p></td>
 700 <td class="parameter_description"><p>Pointer to 2nd template structure to test</p></td>
 701 <td class="parameter_annotations"> </td>
 702 </tr>
 703 </tbody>
 704 </table></div>
 705 </div>
 706 <div class="refsect3">
 707 <a name="id-1.2.3.8.9.6"></a><h4>Returns</h4>
 708 <p>  TRUE if the two templates match.</p>
 709 <p></p>
 710 </div>
 711 </div>
 712 <hr>
 713 <div class="refsect2">
 714 <a name="lgl-template-does-brand-match"></a><h3>lgl_template_does_brand_match ()</h3>
 715 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 716 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>,
 717                                <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>
 718 <p>This function tests if the brand of the template matches the given brand.</p>
 719 <div class="refsect3">
 720 <a name="id-1.2.3.8.10.5"></a><h4>Parameters</h4>
 721 <div class="informaltable"><table width="100%" border="0">
 722 <colgroup>
 723 <col width="150px" class="parameters_name">
 724 <col class="parameters_description">
 725 <col width="200px" class="parameters_annotations">
 726 </colgroup>
 727 <tbody>
 728 <tr>
 729 <td class="parameter_name"><p>template</p></td>
 730 <td class="parameter_description"><p>Pointer to template structure to test</p></td>
 731 <td class="parameter_annotations"> </td>
 732 </tr>
 733 <tr>
 734 <td class="parameter_name"><p>brand</p></td>
 735 <td class="parameter_description"><p>Brand string</p></td>
 736 <td class="parameter_annotations"> </td>
 737 </tr>
 738 </tbody>
 739 </table></div>
 740 </div>
 741 <div class="refsect3">
 742 <a name="id-1.2.3.8.10.6"></a><h4>Returns</h4>
 743 <p>  TRUE if the template matches the given brand.</p>
 744 <p></p>
 745 </div>
 746 </div>
 747 <hr>
 748 <div class="refsect2">
 749 <a name="lgl-template-does-page-size-match"></a><h3>lgl_template_does_page_size_match ()</h3>
 750 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 751 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>,
 752                                    <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>
 753 <p>This function tests if the page size of the template matches the given ID.</p>
 754 <div class="refsect3">
 755 <a name="id-1.2.3.8.11.5"></a><h4>Parameters</h4>
 756 <div class="informaltable"><table width="100%" border="0">
 757 <colgroup>
 758 <col width="150px" class="parameters_name">
 759 <col class="parameters_description">
 760 <col width="200px" class="parameters_annotations">
 761 </colgroup>
 762 <tbody>
 763 <tr>
 764 <td class="parameter_name"><p>template</p></td>
 765 <td class="parameter_description"><p>Pointer to template structure to test</p></td>
 766 <td class="parameter_annotations"> </td>
 767 </tr>
 768 <tr>
 769 <td class="parameter_name"><p>paper_id</p></td>
 770 <td class="parameter_description"><p>Page size ID string</p></td>
 771 <td class="parameter_annotations"> </td>
 772 </tr>
 773 </tbody>
 774 </table></div>
 775 </div>
 776 <div class="refsect3">
 777 <a name="id-1.2.3.8.11.6"></a><h4>Returns</h4>
 778 <p>  TRUE if the template matches the given page size ID.</p>
 779 <p></p>
 780 </div>
 781 </div>
 782 <hr>
 783 <div class="refsect2">
 784 <a name="lgl-template-does-category-match"></a><h3>lgl_template_does_category_match ()</h3>
 785 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 786 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>,
 787                                   <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>
 788 <p>This function tests if the given template belongs to the given category ID.</p>
 789 <div class="refsect3">
 790 <a name="id-1.2.3.8.12.5"></a><h4>Parameters</h4>
 791 <div class="informaltable"><table width="100%" border="0">
 792 <colgroup>
 793 <col width="150px" class="parameters_name">
 794 <col class="parameters_description">
 795 <col width="200px" class="parameters_annotations">
 796 </colgroup>
 797 <tbody>
 798 <tr>
 799 <td class="parameter_name"><p>template</p></td>
 800 <td class="parameter_description"><p>Pointer to template structure to test</p></td>
 801 <td class="parameter_annotations"> </td>
 802 </tr>
 803 <tr>
 804 <td class="parameter_name"><p>category_id</p></td>
 805 <td class="parameter_description"><p>Category ID string</p></td>
 806 <td class="parameter_annotations"> </td>
 807 </tr>
 808 </tbody>
 809 </table></div>
 810 </div>
 811 <div class="refsect3">
 812 <a name="id-1.2.3.8.12.6"></a><h4>Returns</h4>
 813 <p>  TRUE if the template matches the given category ID.</p>
 814 <p></p>
 815 </div>
 816 </div>
 817 <hr>
 818 <div class="refsect2">
 819 <a name="lgl-template-are-templates-identical"></a><h3>lgl_template_are_templates_identical ()</h3>
 820 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>
 821 lgl_template_are_templates_identical (<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>,
 822                                       <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>
 823 <p>This function tests if the given templates have identical size and layout properties.</p>
 824 <div class="refsect3">
 825 <a name="id-1.2.3.8.13.5"></a><h4>Parameters</h4>
 826 <div class="informaltable"><table width="100%" border="0">
 827 <colgroup>
 828 <col width="150px" class="parameters_name">
 829 <col class="parameters_description">
 830 <col width="200px" class="parameters_annotations">
 831 </colgroup>
 832 <tbody>
 833 <tr>
 834 <td class="parameter_name"><p>template1</p></td>
 835 <td class="parameter_description"><p>Pointer to 1st template structure to test</p></td>
 836 <td class="parameter_annotations"> </td>
 837 </tr>
 838 <tr>
 839 <td class="parameter_name"><p>template2</p></td>
 840 <td class="parameter_description"><p>Pointer to 2nd template structure to test</p></td>
 841 <td class="parameter_annotations"> </td>
 842 </tr>
 843 </tbody>
 844 </table></div>
 845 </div>
 846 <div class="refsect3">
 847 <a name="id-1.2.3.8.13.6"></a><h4>Returns</h4>
 848 <p>  TRUE if the two templates are identical.</p>
 849 <p></p>
 850 </div>
 851 </div>
 852 <hr>
 853 <div class="refsect2">
 854 <a name="lgl-template-frame-rect-new"></a><h3>lgl_template_frame_rect_new ()</h3>
 855 <pre class="programlisting"><a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="returnvalue">lglTemplateFrame</span></a> *
 856 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>,
 857                              <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>,
 858                              <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>,
 859                              <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>,
 860                              <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>,
 861                              <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>
 862 <p>This function creates a new template frame for a rectangular label or card.</p>
 863 <div class="refsect3">
 864 <a name="id-1.2.3.8.14.5"></a><h4>Parameters</h4>
 865 <div class="informaltable"><table width="100%" border="0">
 866 <colgroup>
 867 <col width="150px" class="parameters_name">
 868 <col class="parameters_description">
 869 <col width="200px" class="parameters_annotations">
 870 </colgroup>
 871 <tbody>
 872 <tr>
 873 <td class="parameter_name"><p>id</p></td>
 874 <td class="parameter_description"><p>ID of frame.  (This should currently always be "0").</p></td>
 875 <td class="parameter_annotations"> </td>
 876 </tr>
 877 <tr>
 878 <td class="parameter_name"><p>w</p></td>
 879 <td class="parameter_description"><p>width of frame in points.</p></td>
 880 <td class="parameter_annotations"> </td>
 881 </tr>
 882 <tr>
 883 <td class="parameter_name"><p>h</p></td>
 884 <td class="parameter_description"><p>height of frame in points.</p></td>
 885 <td class="parameter_annotations"> </td>
 886 </tr>
 887 <tr>
 888 <td class="parameter_name"><p>r</p></td>
 889 <td class="parameter_description"><p>radius of rounded corners in points.  (Should be 0 for square corners.)</p></td>
 890 <td class="parameter_annotations"> </td>
 891 </tr>
 892 <tr>
 893 <td class="parameter_name"><p>x_waste</p></td>
 894 <td class="parameter_description"><p>Amount of overprint to allow in the horizontal direction.</p></td>
 895 <td class="parameter_annotations"> </td>
 896 </tr>
 897 <tr>
 898 <td class="parameter_name"><p>y_waste</p></td>
 899 <td class="parameter_description"><p>Amount of overprint to allow in the vertical direction.</p></td>
 900 <td class="parameter_annotations"> </td>
 901 </tr>
 902 </tbody>
 903 </table></div>
 904 </div>
 905 <div class="refsect3">
 906 <a name="id-1.2.3.8.14.6"></a><h4>Returns</h4>
 907 <p> Pointer to newly allocated <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> structure.</p>
 908 <p></p>
 909 </div>
 910 </div>
 911 <hr>
 912 <div class="refsect2">
 913 <a name="lgl-template-frame-ellipse-new"></a><h3>lgl_template_frame_ellipse_new ()</h3>
 914 <pre class="programlisting"><a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="returnvalue">lglTemplateFrame</span></a> *
 915 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>,
 916                                 <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>,
 917                                 <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>,
 918                                 <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>
 919 <p>This function creates a new template frame for an elliptical label or card.</p>
 920 <div class="refsect3">
 921 <a name="id-1.2.3.8.15.5"></a><h4>Parameters</h4>
 922 <div class="informaltable"><table width="100%" border="0">
 923 <colgroup>
 924 <col width="150px" class="parameters_name">
 925 <col class="parameters_description">
 926 <col width="200px" class="parameters_annotations">
 927 </colgroup>
 928 <tbody>
 929 <tr>
 930 <td class="parameter_name"><p>id</p></td>
 931 <td class="parameter_description"><p>ID of frame.  (This should currently always be "0").</p></td>
 932 <td class="parameter_annotations"> </td>
 933 </tr>
 934 <tr>
 935 <td class="parameter_name"><p>w</p></td>
 936 <td class="parameter_description"><p>width of frame in points.</p></td>
 937 <td class="parameter_annotations"> </td>
 938 </tr>
 939 <tr>
 940 <td class="parameter_name"><p>h</p></td>
 941 <td class="parameter_description"><p>height of frame in points.</p></td>
 942 <td class="parameter_annotations"> </td>
 943 </tr>
 944 <tr>
 945 <td class="parameter_name"><p>waste</p></td>
 946 <td class="parameter_description"><p>Amount of overprint to allow in points.</p></td>
 947 <td class="parameter_annotations"> </td>
 948 </tr>
 949 </tbody>
 950 </table></div>
 951 </div>
 952 <div class="refsect3">
 953 <a name="id-1.2.3.8.15.6"></a><h4>Returns</h4>
 954 <p> Pointer to newly allocated <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> structure.</p>
 955 <p></p>
 956 </div>
 957 </div>
 958 <hr>
 959 <div class="refsect2">
 960 <a name="lgl-template-frame-round-new"></a><h3>lgl_template_frame_round_new ()</h3>
 961 <pre class="programlisting"><a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="returnvalue">lglTemplateFrame</span></a> *
 962 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>,
 963                               <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>,
 964                               <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>
 965 <p>This function creates a new template frame for a round label.</p>
 966 <div class="refsect3">
 967 <a name="id-1.2.3.8.16.5"></a><h4>Parameters</h4>
 968 <div class="informaltable"><table width="100%" border="0">
 969 <colgroup>
 970 <col width="150px" class="parameters_name">
 971 <col class="parameters_description">
 972 <col width="200px" class="parameters_annotations">
 973 </colgroup>
 974 <tbody>
 975 <tr>
 976 <td class="parameter_name"><p>id</p></td>
 977 <td class="parameter_description"><p>ID of frame.  (This should currently always be "0").</p></td>
 978 <td class="parameter_annotations"> </td>
 979 </tr>
 980 <tr>
 981 <td class="parameter_name"><p>r</p></td>
 982 <td class="parameter_description"><p>radius of label in points.</p></td>
 983 <td class="parameter_annotations"> </td>
 984 </tr>
 985 <tr>
 986 <td class="parameter_name"><p>waste</p></td>
 987 <td class="parameter_description"><p>Amount of overprint to allow.</p></td>
 988 <td class="parameter_annotations"> </td>
 989 </tr>
 990 </tbody>
 991 </table></div>
 992 </div>
 993 <div class="refsect3">
 994 <a name="id-1.2.3.8.16.6"></a><h4>Returns</h4>
 995 <p> Pointer to newly allocated <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> structure.</p>
 996 <p></p>
 997 </div>
 998 </div>
 999 <hr>
1000 <div class="refsect2">
1001 <a name="lgl-template-frame-cd-new"></a><h3>lgl_template_frame_cd_new ()</h3>
1002 <pre class="programlisting"><a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="returnvalue">lglTemplateFrame</span></a> *
1003 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>,
1004                            <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>,
1005                            <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>,
1006                            <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>,
1007                            <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>,
1008                            <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>
1009 <p>This function creates a new template frame for a CD/DVD label.</p>
1010 <div class="refsect3">
1011 <a name="id-1.2.3.8.17.5"></a><h4>Parameters</h4>
1012 <div class="informaltable"><table width="100%" border="0">
1013 <colgroup>
1014 <col width="150px" class="parameters_name">
1015 <col class="parameters_description">
1016 <col width="200px" class="parameters_annotations">
1017 </colgroup>
1018 <tbody>
1019 <tr>
1020 <td class="parameter_name"><p>id</p></td>
1021 <td class="parameter_description"><p>ID of frame.  (This should currently always be "0").</p></td>
1022 <td class="parameter_annotations"> </td>
1023 </tr>
1024 <tr>
1025 <td class="parameter_name"><p>r1</p></td>
1026 <td class="parameter_description"><p>outer radius of label in points.</p></td>
1027 <td class="parameter_annotations"> </td>
1028 </tr>
1029 <tr>
1030 <td class="parameter_name"><p>r2</p></td>
1031 <td class="parameter_description"><p>radius of center hole in points.</p></td>
1032 <td class="parameter_annotations"> </td>
1033 </tr>
1034 <tr>
1035 <td class="parameter_name"><p>w</p></td>
1036 <td class="parameter_description"><p>clip width of frame in points for business card CDs.  Should be 0 for no clipping.</p></td>
1037 <td class="parameter_annotations"> </td>
1038 </tr>
1039 <tr>
1040 <td class="parameter_name"><p>h</p></td>
1041 <td class="parameter_description"><p>clip height of frame in points for business card CDs.  Should be 0 for no clipping.</p></td>
1042 <td class="parameter_annotations"> </td>
1043 </tr>
1044 <tr>
1045 <td class="parameter_name"><p>waste</p></td>
1046 <td class="parameter_description"><p>Amount of overprint to allow.</p></td>
1047 <td class="parameter_annotations"> </td>
1048 </tr>
1049 </tbody>
1050 </table></div>
1051 </div>
1052 <div class="refsect3">
1053 <a name="id-1.2.3.8.17.6"></a><h4>Returns</h4>
1054 <p> Pointer to newly allocated <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> structure.</p>
1055 <p></p>
1056 </div>
1057 </div>
1058 <hr>
1059 <div class="refsect2">
1060 <a name="lgl-template-frame-dup"></a><h3>lgl_template_frame_dup ()</h3>
1061 <pre class="programlisting"><a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="returnvalue">lglTemplateFrame</span></a> *
1062 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>
1063 <p>This function duplicates a template frame structure.</p>
1064 <div class="refsect3">
1065 <a name="id-1.2.3.8.18.5"></a><h4>Parameters</h4>
1066 <div class="informaltable"><table width="100%" border="0">
1067 <colgroup>
1068 <col width="150px" class="parameters_name">
1069 <col class="parameters_description">
1070 <col width="200px" class="parameters_annotations">
1071 </colgroup>
1072 <tbody><tr>
1073 <td class="parameter_name"><p>orig_frame</p></td>
1074 <td class="parameter_description"><p>Frame to duplicate.</p></td>
1075 <td class="parameter_annotations"> </td>
1076 </tr></tbody>
1077 </table></div>
1078 </div>
1079 <div class="refsect3">
1080 <a name="id-1.2.3.8.18.6"></a><h4>Returns</h4>
1081 <p>  a newly allocated <a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> structure.</p>
1082 <p></p>
1083 </div>
1084 </div>
1085 <hr>
1086 <div class="refsect2">
1087 <a name="lgl-template-frame-free"></a><h3>lgl_template_frame_free ()</h3>
1088 <pre class="programlisting"><span class="returnvalue">void</span>
1089 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>
1090 <p>This function frees all memory associated with given template frame structure.</p>
1091 <div class="refsect3">
1092 <a name="id-1.2.3.8.19.5"></a><h4>Parameters</h4>
1093 <div class="informaltable"><table width="100%" border="0">
1094 <colgroup>
1095 <col width="150px" class="parameters_name">
1096 <col class="parameters_description">
1097 <col width="200px" class="parameters_annotations">
1098 </colgroup>
1099 <tbody><tr>
1100 <td class="parameter_name"><p>frame</p></td>
1101 <td class="parameter_description"><p>Frame to free.</p></td>
1102 <td class="parameter_annotations"> </td>
1103 </tr></tbody>
1104 </table></div>
1105 </div>
1106 </div>
1107 <hr>
1108 <div class="refsect2">
1109 <a name="lgl-template-frame-add-layout"></a><h3>lgl_template_frame_add_layout ()</h3>
1110 <pre class="programlisting"><span class="returnvalue">void</span>
1111 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>,
1112                                <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>
1113 <p>This function adds a layout structure to the given template frame.</p>
1114 <div class="refsect3">
1115 <a name="id-1.2.3.8.20.5"></a><h4>Parameters</h4>
1116 <div class="informaltable"><table width="100%" border="0">
1117 <colgroup>
1118 <col width="150px" class="parameters_name">
1119 <col class="parameters_description">
1120 <col width="200px" class="parameters_annotations">
1121 </colgroup>
1122 <tbody>
1123 <tr>
1124 <td class="parameter_name"><p>frame</p></td>
1125 <td class="parameter_description"><p>Pointer to template frame to add layout to.</p></td>
1126 <td class="parameter_annotations"> </td>
1127 </tr>
1128 <tr>
1129 <td class="parameter_name"><p>layout</p></td>
1130 <td class="parameter_description"><p>Pointer to layout structure to add to frame.</p></td>
1131 <td class="parameter_annotations"> </td>
1132 </tr>
1133 </tbody>
1134 </table></div>
1135 </div>
1136 </div>
1137 <hr>
1138 <div class="refsect2">
1139 <a name="lgl-template-frame-add-markup"></a><h3>lgl_template_frame_add_markup ()</h3>
1140 <pre class="programlisting"><span class="returnvalue">void</span>
1141 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>,
1142                                <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>
1143 <p>This function adds a markup structure to the given template frame.</p>
1144 <div class="refsect3">
1145 <a name="id-1.2.3.8.21.5"></a><h4>Parameters</h4>
1146 <div class="informaltable"><table width="100%" border="0">
1147 <colgroup>
1148 <col width="150px" class="parameters_name">
1149 <col class="parameters_description">
1150 <col width="200px" class="parameters_annotations">
1151 </colgroup>
1152 <tbody>
1153 <tr>
1154 <td class="parameter_name"><p>frame</p></td>
1155 <td class="parameter_description"><p>Pointer to template frame to add markup to.</p></td>
1156 <td class="parameter_annotations"> </td>
1157 </tr>
1158 <tr>
1159 <td class="parameter_name"><p>markup</p></td>
1160 <td class="parameter_description"><p>Pointer to markup structure to add to frame.</p></td>
1161 <td class="parameter_annotations"> </td>
1162 </tr>
1163 </tbody>
1164 </table></div>
1165 </div>
1166 </div>
1167 <hr>
1168 <div class="refsect2">
1169 <a name="lgl-template-frame-get-size"></a><h3>lgl_template_frame_get_size ()</h3>
1170 <pre class="programlisting"><span class="returnvalue">void</span>
1171 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>,
1172                              <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>,
1173                              <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>
1174 <p>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.</p>
1175 <div class="refsect3">
1176 <a name="id-1.2.3.8.22.5"></a><h4>Parameters</h4>
1177 <div class="informaltable"><table width="100%" border="0">
1178 <colgroup>
1179 <col width="150px" class="parameters_name">
1180 <col class="parameters_description">
1181 <col width="200px" class="parameters_annotations">
1182 </colgroup>
1183 <tbody>
1184 <tr>
1185 <td class="parameter_name"><p>frame</p></td>
1186 <td class="parameter_description"><p><a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> structure to query</p></td>
1187 <td class="parameter_annotations"> </td>
1188 </tr>
1189 <tr>
1190 <td class="parameter_name"><p>w</p></td>
1191 <td class="parameter_description"><p>pointer to location to receive width of frame</p></td>
1192 <td class="parameter_annotations"> </td>
1193 </tr>
1194 <tr>
1195 <td class="parameter_name"><p>h</p></td>
1196 <td class="parameter_description"><p>pointer to location to receive height of frame</p></td>
1197 <td class="parameter_annotations"> </td>
1198 </tr>
1199 </tbody>
1200 </table></div>
1201 </div>
1202 </div>
1203 <hr>
1204 <div class="refsect2">
1205 <a name="lgl-template-frame-get-n-labels"></a><h3>lgl_template_frame_get_n_labels ()</h3>
1206 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gint"><span class="returnvalue">gint</span></a>
1207 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>
1208 <p>Get total number of labels per sheet corresponding to the given frame.</p>
1209 <div class="refsect3">
1210 <a name="id-1.2.3.8.23.5"></a><h4>Parameters</h4>
1211 <div class="informaltable"><table width="100%" border="0">
1212 <colgroup>
1213 <col width="150px" class="parameters_name">
1214 <col class="parameters_description">
1215 <col width="200px" class="parameters_annotations">
1216 </colgroup>
1217 <tbody><tr>
1218 <td class="parameter_name"><p>frame</p></td>
1219 <td class="parameter_description"><p><a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> structure to query</p></td>
1220 <td class="parameter_annotations"> </td>
1221 </tr></tbody>
1222 </table></div>
1223 </div>
1224 <div class="refsect3">
1225 <a name="id-1.2.3.8.23.6"></a><h4>Returns</h4>
1226 <p> number of labels per sheet.</p>
1227 <p></p>
1228 </div>
1229 </div>
1230 <hr>
1231 <div class="refsect2">
1232 <a name="lgl-template-frame-get-origins"></a><h3>lgl_template_frame_get_origins ()</h3>
1233 <pre class="programlisting"><a class="link" href="libglabels-3.0-template.html#lglTemplateOrigin" title="struct lglTemplateOrigin"><span class="returnvalue">lglTemplateOrigin</span></a> *
1234 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>
1235 <p>Get an array of label origins for the given frame.  These origins represent the
1236 upper left hand corner of each label on a page corresponding to the given frame.
1237 The origins will be ordered geometrically left to right and then top to bottom.
1238 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>.</p>
1239 <div class="refsect3">
1240 <a name="id-1.2.3.8.24.5"></a><h4>Parameters</h4>
1241 <div class="informaltable"><table width="100%" border="0">
1242 <colgroup>
1243 <col width="150px" class="parameters_name">
1244 <col class="parameters_description">
1245 <col width="200px" class="parameters_annotations">
1246 </colgroup>
1247 <tbody><tr>
1248 <td class="parameter_name"><p>frame</p></td>
1249 <td class="parameter_description"><p><a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> structure to query</p></td>
1250 <td class="parameter_annotations"> </td>
1251 </tr></tbody>
1252 </table></div>
1253 </div>
1254 <div class="refsect3">
1255 <a name="id-1.2.3.8.24.6"></a><h4>Returns</h4>
1256 <p> 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.</p>
1257 <p></p>
1258 </div>
1259 </div>
1260 <hr>
1261 <div class="refsect2">
1262 <a name="lgl-template-frame-get-layout-description"></a><h3>lgl_template_frame_get_layout_description ()</h3>
1263 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1264 lgl_template_frame_get_layout_description
1265                                (<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>
1266 <p>Get a description of the label layout including number of labels per sheet.</p>
1267 <div class="refsect3">
1268 <a name="id-1.2.3.8.25.5"></a><h4>Parameters</h4>
1269 <div class="informaltable"><table width="100%" border="0">
1270 <colgroup>
1271 <col width="150px" class="parameters_name">
1272 <col class="parameters_description">
1273 <col width="200px" class="parameters_annotations">
1274 </colgroup>
1275 <tbody><tr>
1276 <td class="parameter_name"><p>frame</p></td>
1277 <td class="parameter_description"><p><a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> structure to query</p></td>
1278 <td class="parameter_annotations"> </td>
1279 </tr></tbody>
1280 </table></div>
1281 </div>
1282 <div class="refsect3">
1283 <a name="id-1.2.3.8.25.6"></a><h4>Returns</h4>
1284 <p> a newly allocation description string.</p>
1285 <p></p>
1286 </div>
1287 </div>
1288 <hr>
1289 <div class="refsect2">
1290 <a name="lgl-template-frame-get-size-description"></a><h3>lgl_template_frame_get_size_description ()</h3>
1291 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> *
1292 lgl_template_frame_get_size_description
1293                                (<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>,
1294                                 <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>
1295 <p>Get a description of the label size.</p>
1296 <div class="refsect3">
1297 <a name="id-1.2.3.8.26.5"></a><h4>Parameters</h4>
1298 <div class="informaltable"><table width="100%" border="0">
1299 <colgroup>
1300 <col width="150px" class="parameters_name">
1301 <col class="parameters_description">
1302 <col width="200px" class="parameters_annotations">
1303 </colgroup>
1304 <tbody>
1305 <tr>
1306 <td class="parameter_name"><p>frame</p></td>
1307 <td class="parameter_description"><p><a class="link" href="libglabels-3.0-template.html#lglTemplateFrame" title="union lglTemplateFrame"><span class="type">lglTemplateFrame</span></a> structure to query</p></td>
1308 <td class="parameter_annotations"> </td>
1309 </tr>
1310 <tr>
1311 <td class="parameter_name"><p>units</p></td>
1312 <td class="parameter_description"><p><a class="link" href="libglabels-3.0-units.html#lglUnits" title="enum lglUnits"><span class="type">lglUnits</span></a></p></td>
1313 <td class="parameter_annotations"> </td>
1314 </tr>
1315 </tbody>
1316 </table></div>
1317 </div>
1318 <div class="refsect3">
1319 <a name="id-1.2.3.8.26.6"></a><h4>Returns</h4>
1320 <p> a newly allocation description string.</p>
1321 <p></p>
1322 </div>
1323 </div>
1324 <hr>
1325 <div class="refsect2">
1326 <a name="lgl-template-layout-new"></a><h3>lgl_template_layout_new ()</h3>
1327 <pre class="programlisting"><a class="link" href="libglabels-3.0-template.html#lglTemplateLayout" title="struct lglTemplateLayout"><span class="returnvalue">lglTemplateLayout</span></a> *
1328 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>,
1329                          <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>,
1330                          <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>,
1331                          <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>,
1332                          <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>,
1333                          <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>
1334 <p>This function creates a new layout structure with the given parameters.</p>
1335 <div class="refsect3">
1336 <a name="id-1.2.3.8.27.5"></a><h4>Parameters</h4>
1337 <div class="informaltable"><table width="100%" border="0">
1338 <colgroup>
1339 <col width="150px" class="parameters_name">
1340 <col class="parameters_description">
1341 <col width="200px" class="parameters_annotations">
1342 </colgroup>
1343 <tbody>
1344 <tr>
1345 <td class="parameter_name"><p>nx</p></td>
1346 <td class="parameter_description"><p>Number of labels across.</p></td>
1347 <td class="parameter_annotations"> </td>
1348 </tr>
1349 <tr>
1350 <td class="parameter_name"><p>ny</p></td>
1351 <td class="parameter_description"><p>Number of labels down.</p></td>
1352 <td class="parameter_annotations"> </td>
1353 </tr>
1354 <tr>
1355 <td class="parameter_name"><p>x0</p></td>
1356 <td class="parameter_description"><p>X coordinate of the top-left corner of the top-left label in the layout in points.</p></td>
1357 <td class="parameter_annotations"> </td>
1358 </tr>
1359 <tr>
1360 <td class="parameter_name"><p>y0</p></td>
1361 <td class="parameter_description"><p>Y coordinate of the top-left corner of the top-left label in the layout in points.</p></td>
1362 <td class="parameter_annotations"> </td>
1363 </tr>
1364 <tr>
1365 <td class="parameter_name"><p>dx</p></td>
1366 <td class="parameter_description"><p>Horizontal pitch in points.  This is the distance from left-edge to left-edge.</p></td>
1367 <td class="parameter_annotations"> </td>
1368 </tr>
1369 <tr>
1370 <td class="parameter_name"><p>dy</p></td>
1371 <td class="parameter_description"><p>Vertical pitch in points.  This is the distance from top-edge to top-edge.</p></td>
1372 <td class="parameter_annotations"> </td>
1373 </tr>
1374 </tbody>
1375 </table></div>
1376 </div>
1377 <div class="refsect3">
1378 <a name="id-1.2.3.8.27.6"></a><h4>Returns</h4>
1379 <p> a newly allocated <a class="link" href="libglabels-3.0-template.html#lglTemplateLayout" title="struct lglTemplateLayout"><span class="type">lglTemplateLayout</span></a> structure.</p>
1380 <p></p>
1381 </div>
1382 </div>
1383 <hr>
1384 <div class="refsect2">
1385 <a name="lgl-template-layout-dup"></a><h3>lgl_template_layout_dup ()</h3>
1386 <pre class="programlisting"><a class="link" href="libglabels-3.0-template.html#lglTemplateLayout" title="struct lglTemplateLayout"><span class="returnvalue">lglTemplateLayout</span></a> *
1387 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>
1388 <p>This function duplicates a template layout structure.</p>
1389 <div class="refsect3">
1390 <a name="id-1.2.3.8.28.5"></a><h4>Parameters</h4>
1391 <div class="informaltable"><table width="100%" border="0">
1392 <colgroup>
1393 <col width="150px" class="parameters_name">
1394 <col class="parameters_description">
1395 <col width="200px" class="parameters_annotations">
1396 </colgroup>
1397 <tbody><tr>
1398 <td class="parameter_name"><p>orig_layout</p></td>
1399 <td class="parameter_description"><p>Layout to duplicate.</p></td>
1400 <td class="parameter_annotations"> </td>
1401 </tr></tbody>
1402 </table></div>
1403 </div>
1404 <div class="refsect3">
1405 <a name="id-1.2.3.8.28.6"></a><h4>Returns</h4>
1406 <p>  a newly allocated <a class="link" href="libglabels-3.0-template.html#lglTemplateLayout" title="struct lglTemplateLayout"><span class="type">lglTemplateLayout</span></a> structure.</p>
1407 <p></p>
1408 </div>
1409 </div>
1410 <hr>
1411 <div class="refsect2">
1412 <a name="lgl-template-layout-free"></a><h3>lgl_template_layout_free ()</h3>
1413 <pre class="programlisting"><span class="returnvalue">void</span>
1414 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>
1415 <p>This function frees all memory associated with given template layout structure.</p>
1416 <div class="refsect3">
1417 <a name="id-1.2.3.8.29.5"></a><h4>Parameters</h4>
1418 <div class="informaltable"><table width="100%" border="0">
1419 <colgroup>
1420 <col width="150px" class="parameters_name">
1421 <col class="parameters_description">
1422 <col width="200px" class="parameters_annotations">
1423 </colgroup>
1424 <tbody><tr>
1425 <td class="parameter_name"><p>layout</p></td>
1426 <td class="parameter_description"><p>Layout to free.</p></td>
1427 <td class="parameter_annotations"> </td>
1428 </tr></tbody>
1429 </table></div>
1430 </div>
1431 </div>
1432 <hr>
1433 <div class="refsect2">
1434 <a name="lgl-template-markup-margin-new"></a><h3>lgl_template_markup_margin_new ()</h3>
1435 <pre class="programlisting"><a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="returnvalue">lglTemplateMarkup</span></a> *
1436 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>
1437 <p>This function creates a new margin markup structure.</p>
1438 <div class="refsect3">
1439 <a name="id-1.2.3.8.30.5"></a><h4>Parameters</h4>
1440 <div class="informaltable"><table width="100%" border="0">
1441 <colgroup>
1442 <col width="150px" class="parameters_name">
1443 <col class="parameters_description">
1444 <col width="200px" class="parameters_annotations">
1445 </colgroup>
1446 <tbody><tr>
1447 <td class="parameter_name"><p>size</p></td>
1448 <td class="parameter_description"><p>margin size in points.</p></td>
1449 <td class="parameter_annotations"> </td>
1450 </tr></tbody>
1451 </table></div>
1452 </div>
1453 <div class="refsect3">
1454 <a name="id-1.2.3.8.30.6"></a><h4>Returns</h4>
1455 <p> a newly allocated <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="type">lglTemplateMarkup</span></a> structure.</p>
1456 <p></p>
1457 </div>
1458 </div>
1459 <hr>
1460 <div class="refsect2">
1461 <a name="lgl-template-markup-line-new"></a><h3>lgl_template_markup_line_new ()</h3>
1462 <pre class="programlisting"><a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="returnvalue">lglTemplateMarkup</span></a> *
1463 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>,
1464                               <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>,
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> x2</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> y2</code></em>);</pre>
1467 <p>This function creates a new line markup structure.</p>
1468 <div class="refsect3">
1469 <a name="id-1.2.3.8.31.5"></a><h4>Parameters</h4>
1470 <div class="informaltable"><table width="100%" border="0">
1471 <colgroup>
1472 <col width="150px" class="parameters_name">
1473 <col class="parameters_description">
1474 <col width="200px" class="parameters_annotations">
1475 </colgroup>
1476 <tbody>
1477 <tr>
1478 <td class="parameter_name"><p>x1</p></td>
1479 <td class="parameter_description"><p>x coordinate of first endpoint.</p></td>
1480 <td class="parameter_annotations"> </td>
1481 </tr>
1482 <tr>
1483 <td class="parameter_name"><p>y1</p></td>
1484 <td class="parameter_description"><p>y coordinate of first endpoint.</p></td>
1485 <td class="parameter_annotations"> </td>
1486 </tr>
1487 <tr>
1488 <td class="parameter_name"><p>x2</p></td>
1489 <td class="parameter_description"><p>x coordinate of second endpoint.</p></td>
1490 <td class="parameter_annotations"> </td>
1491 </tr>
1492 <tr>
1493 <td class="parameter_name"><p>y2</p></td>
1494 <td class="parameter_description"><p>y coordinate of second endpoint.</p></td>
1495 <td class="parameter_annotations"> </td>
1496 </tr>
1497 </tbody>
1498 </table></div>
1499 </div>
1500 <div class="refsect3">
1501 <a name="id-1.2.3.8.31.6"></a><h4>Returns</h4>
1502 <p> a newly allocated <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="type">lglTemplateMarkup</span></a> structure.</p>
1503 <p></p>
1504 </div>
1505 </div>
1506 <hr>
1507 <div class="refsect2">
1508 <a name="lgl-template-markup-circle-new"></a><h3>lgl_template_markup_circle_new ()</h3>
1509 <pre class="programlisting"><a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="returnvalue">lglTemplateMarkup</span></a> *
1510 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>,
1511                                 <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>,
1512                                 <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>
1513 <p>This function creates a new circle markup structure.</p>
1514 <div class="refsect3">
1515 <a name="id-1.2.3.8.32.5"></a><h4>Parameters</h4>
1516 <div class="informaltable"><table width="100%" border="0">
1517 <colgroup>
1518 <col width="150px" class="parameters_name">
1519 <col class="parameters_description">
1520 <col width="200px" class="parameters_annotations">
1521 </colgroup>
1522 <tbody>
1523 <tr>
1524 <td class="parameter_name"><p>x0</p></td>
1525 <td class="parameter_description"><p>x coordinate of center of circle.</p></td>
1526 <td class="parameter_annotations"> </td>
1527 </tr>
1528 <tr>
1529 <td class="parameter_name"><p>y0</p></td>
1530 <td class="parameter_description"><p>y coordinate of center of circle.</p></td>
1531 <td class="parameter_annotations"> </td>
1532 </tr>
1533 <tr>
1534 <td class="parameter_name"><p>r</p></td>
1535 <td class="parameter_description"><p>radius of circle.</p></td>
1536 <td class="parameter_annotations"> </td>
1537 </tr>
1538 </tbody>
1539 </table></div>
1540 </div>
1541 <div class="refsect3">
1542 <a name="id-1.2.3.8.32.6"></a><h4>Returns</h4>
1543 <p> a newly allocated <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="type">lglTemplateMarkup</span></a> structure.</p>
1544 <p></p>
1545 </div>
1546 </div>
1547 <hr>
1548 <div class="refsect2">
1549 <a name="lgl-template-markup-rect-new"></a><h3>lgl_template_markup_rect_new ()</h3>
1550 <pre class="programlisting"><a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="returnvalue">lglTemplateMarkup</span></a> *
1551 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>,
1552                               <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>,
1553                               <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>,
1554                               <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>,
1555                               <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>
1556 <p>This function creates a new rectangle markup structure.</p>
1557 <div class="refsect3">
1558 <a name="id-1.2.3.8.33.5"></a><h4>Parameters</h4>
1559 <div class="informaltable"><table width="100%" border="0">
1560 <colgroup>
1561 <col width="150px" class="parameters_name">
1562 <col class="parameters_description">
1563 <col width="200px" class="parameters_annotations">
1564 </colgroup>
1565 <tbody>
1566 <tr>
1567 <td class="parameter_name"><p>x1</p></td>
1568 <td class="parameter_description"><p>x coordinate of top-left corner of rectangle.</p></td>
1569 <td class="parameter_annotations"> </td>
1570 </tr>
1571 <tr>
1572 <td class="parameter_name"><p>y1</p></td>
1573 <td class="parameter_description"><p>y coordinate of top-left corner of rectangle.</p></td>
1574 <td class="parameter_annotations"> </td>
1575 </tr>
1576 <tr>
1577 <td class="parameter_name"><p>w</p></td>
1578 <td class="parameter_description"><p>width of rectangle.</p></td>
1579 <td class="parameter_annotations"> </td>
1580 </tr>
1581 <tr>
1582 <td class="parameter_name"><p>h</p></td>
1583 <td class="parameter_description"><p>height of rectangle.</p></td>
1584 <td class="parameter_annotations"> </td>
1585 </tr>
1586 <tr>
1587 <td class="parameter_name"><p>r</p></td>
1588 <td class="parameter_description"><p>radius of rounded corner.</p></td>
1589 <td class="parameter_annotations"> </td>
1590 </tr>
1591 </tbody>
1592 </table></div>
1593 </div>
1594 <div class="refsect3">
1595 <a name="id-1.2.3.8.33.6"></a><h4>Returns</h4>
1596 <p> a newly allocated <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="type">lglTemplateMarkup</span></a> structure.</p>
1597 <p></p>
1598 </div>
1599 </div>
1600 <hr>
1601 <div class="refsect2">
1602 <a name="lgl-template-markup-ellipse-new"></a><h3>lgl_template_markup_ellipse_new ()</h3>
1603 <pre class="programlisting"><a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="returnvalue">lglTemplateMarkup</span></a> *
1604 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>,
1605                                  <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>,
1606                                  <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>,
1607                                  <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>
1608 <p>This function creates a new ellipse markup structure.</p>
1609 <div class="refsect3">
1610 <a name="id-1.2.3.8.34.5"></a><h4>Parameters</h4>
1611 <div class="informaltable"><table width="100%" border="0">
1612 <colgroup>
1613 <col width="150px" class="parameters_name">
1614 <col class="parameters_description">
1615 <col width="200px" class="parameters_annotations">
1616 </colgroup>
1617 <tbody>
1618 <tr>
1619 <td class="parameter_name"><p>x1</p></td>
1620 <td class="parameter_description"><p>x coordinate of top-left corner of ellipse.</p></td>
1621 <td class="parameter_annotations"> </td>
1622 </tr>
1623 <tr>
1624 <td class="parameter_name"><p>y1</p></td>
1625 <td class="parameter_description"><p>y coordinate of top-left corner of ellipse.</p></td>
1626 <td class="parameter_annotations"> </td>
1627 </tr>
1628 <tr>
1629 <td class="parameter_name"><p>w</p></td>
1630 <td class="parameter_description"><p>width of ellipse.</p></td>
1631 <td class="parameter_annotations"> </td>
1632 </tr>
1633 <tr>
1634 <td class="parameter_name"><p>h</p></td>
1635 <td class="parameter_description"><p>height of ellipse.</p></td>
1636 <td class="parameter_annotations"> </td>
1637 </tr>
1638 </tbody>
1639 </table></div>
1640 </div>
1641 <div class="refsect3">
1642 <a name="id-1.2.3.8.34.6"></a><h4>Returns</h4>
1643 <p> a newly allocated <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="type">lglTemplateMarkup</span></a> structure.</p>
1644 <p></p>
1645 </div>
1646 </div>
1647 <hr>
1648 <div class="refsect2">
1649 <a name="lgl-template-markup-dup"></a><h3>lgl_template_markup_dup ()</h3>
1650 <pre class="programlisting"><a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="returnvalue">lglTemplateMarkup</span></a> *
1651 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>
1652 <p>This function duplicates a template markup structure.</p>
1653 <div class="refsect3">
1654 <a name="id-1.2.3.8.35.5"></a><h4>Parameters</h4>
1655 <div class="informaltable"><table width="100%" border="0">
1656 <colgroup>
1657 <col width="150px" class="parameters_name">
1658 <col class="parameters_description">
1659 <col width="200px" class="parameters_annotations">
1660 </colgroup>
1661 <tbody><tr>
1662 <td class="parameter_name"><p>orig_markup</p></td>
1663 <td class="parameter_description"><p>Markup to duplicate.</p></td>
1664 <td class="parameter_annotations"> </td>
1665 </tr></tbody>
1666 </table></div>
1667 </div>
1668 <div class="refsect3">
1669 <a name="id-1.2.3.8.35.6"></a><h4>Returns</h4>
1670 <p>  a newly allocated <a class="link" href="libglabels-3.0-template.html#lglTemplateMarkup" title="union lglTemplateMarkup"><span class="type">lglTemplateMarkup</span></a> structure.</p>
1671 <p></p>
1672 </div>
1673 </div>
1674 <hr>
1675 <div class="refsect2">
1676 <a name="lgl-template-markup-free"></a><h3>lgl_template_markup_free ()</h3>
1677 <pre class="programlisting"><span class="returnvalue">void</span>
1678 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>
1679 <p>This function frees all memory associated with given template markup structure.</p>
1680 <div class="refsect3">
1681 <a name="id-1.2.3.8.36.5"></a><h4>Parameters</h4>
1682 <div class="informaltable"><table width="100%" border="0">
1683 <colgroup>
1684 <col width="150px" class="parameters_name">
1685 <col class="parameters_description">
1686 <col width="200px" class="parameters_annotations">
1687 </colgroup>
1688 <tbody><tr>
1689 <td class="parameter_name"><p>markup</p></td>
1690 <td class="parameter_description"><p>Markup to free.</p></td>
1691 <td class="parameter_annotations"> </td>
1692 </tr></tbody>
1693 </table></div>
1694 </div>
1695 </div>
1696 <hr>
1697 <div class="refsect2">
1698 <a name="lgl-template-print"></a><h3>lgl_template_print ()</h3>
1699 <pre class="programlisting"><span class="returnvalue">void</span>
1700 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>
1701 <p>Print template details (for debugging purposes).</p>
1702 <div class="refsect3">
1703 <a name="id-1.2.3.8.37.5"></a><h4>Parameters</h4>
1704 <div class="informaltable"><table width="100%" border="0">
1705 <colgroup>
1706 <col width="150px" class="parameters_name">
1707 <col class="parameters_description">
1708 <col width="200px" class="parameters_annotations">
1709 </colgroup>
1710 <tbody><tr>
1711 <td class="parameter_name"><p>template</p></td>
1712 <td class="parameter_description"><p>template</p></td>
1713 <td class="parameter_annotations"> </td>
1714 </tr></tbody>
1715 </table></div>
1716 </div>
1717 </div>
1718 </div>
1719 <div class="refsect1">
1720 <a name="libglabels-3.0-template.other_details"></a><h2>Types and Values</h2>
1721 <div class="refsect2">
1722 <a name="lglTemplate"></a><h3>struct lglTemplate</h3>
1723 <pre class="programlisting">struct lglTemplate {
1724         gchar               *brand;
1725         gchar               *part;
1726         gchar               *equiv_part;
1727
1728         gchar               *description;
1729         gchar               *paper_id;
1730         gdouble              page_width;
1731         gdouble              page_height;
1732
1733         /* Meta information. */
1734         gchar               *product_url;   /* URL to manufacturer's product website. */
1735         GList               *category_ids;  /* List of (gchar *) category ids. */
1736
1737         /* List of (lglTemplateFrame *) label frame structures.
1738          * Currently glabels only supports a single label frame per
1739          * template. */
1740         GList               *frames;
1741 };
1742 </pre>
1743 <p>
1744 This is the main structure of a libglabels template.  A template represents a single sheet
1745 of peel-off labels or cards.
1746 </p>
1747 <div class="refsect3">
1748 <a name="id-1.2.3.9.2.5"></a><h4>Members</h4>
1749 <div class="informaltable"><table width="100%" border="0">
1750 <colgroup>
1751 <col width="300px" class="struct_members_name">
1752 <col class="struct_members_description">
1753 <col width="200px" class="struct_members_annotations">
1754 </colgroup>
1755 <tbody>
1756 <tr>
1757 <td class="struct_member_name"><p><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>;</p></td>
1758 <td class="struct_member_description"><p>Vendor or brand name of label or card.  E.g. "Avery."</p></td>
1759 <td class="struct_member_annotations"> </td>
1760 </tr>
1761 <tr>
1762 <td class="struct_member_name"><p><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>;</p></td>
1763 <td class="struct_member_description"><p>Part name or number of label or card.  E.g. "8160."</p></td>
1764 <td class="struct_member_annotations"> </td>
1765 </tr>
1766 <tr>
1767 <td class="struct_member_name"><p><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>;</p></td>
1768 <td class="struct_member_description"><p>Part name or number of a part with identical layout.  Must be from same vendor.</p></td>
1769 <td class="struct_member_annotations"> </td>
1770 </tr>
1771 <tr>
1772 <td class="struct_member_name"><p><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>;</p></td>
1773 <td class="struct_member_description"><p>A description of the template.  E.g. "Mailing labels."</p></td>
1774 <td class="struct_member_annotations"> </td>
1775 </tr>
1776 <tr>
1777 <td class="struct_member_name"><p><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>;</p></td>
1778 <td class="struct_member_description"><p>A paper ID.  E.g. "A4" or "US-Letter."</p></td>
1779 <td class="struct_member_annotations"> </td>
1780 </tr>
1781 <tr>
1782 <td class="struct_member_name"><p><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>;</p></td>
1783 <td class="struct_member_description"><p>Page width in points.  Used only if paper_id is "Other."</p></td>
1784 <td class="struct_member_annotations"> </td>
1785 </tr>
1786 <tr>
1787 <td class="struct_member_name"><p><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>;</p></td>
1788 <td class="struct_member_description"><p>Page height in points.  Used only if paper_id is "Other."</p></td>
1789 <td class="struct_member_annotations"> </td>
1790 </tr>
1791 <tr>
1792 <td class="struct_member_name"><p><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>;</p></td>
1793 <td class="struct_member_description"><p>URL to a webpage describing product.</p></td>
1794 <td class="struct_member_annotations"> </td>
1795 </tr>
1796 <tr>
1797 <td class="struct_member_name"><p><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>;</p></td>
1798 <td class="struct_member_description"><p>A list of category IDs that this template belongs to.</p></td>
1799 <td class="struct_member_annotations"> </td>
1800 </tr>
1801 <tr>
1802 <td class="struct_member_name"><p><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>;</p></td>
1803 <td class="struct_member_description"><p>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
1804 per template -- future versions may support multiple frames per template.</p></td>
1805 <td class="struct_member_annotations"> </td>
1806 </tr>
1807 </tbody>
1808 </table></div>
1809 </div>
1810 </div>
1811 <hr>
1812 <div class="refsect2">
1813 <a name="lglTemplateFrameShape"></a><h3>enum lglTemplateFrameShape</h3>
1814 <p>
1815 This enumeration defines frame types that are supported by libglabels
1816 </p>
1817 <div class="refsect3">
1818 <a name="id-1.2.3.9.3.4"></a><h4>Members</h4>
1819 <div class="informaltable"><table width="100%" border="0">
1820 <colgroup>
1821 <col width="300px" class="enum_members_name">
1822 <col class="enum_members_description">
1823 <col width="200px" class="enum_members_annotations">
1824 </colgroup>
1825 <tbody>
1826 <tr>
1827 <td class="enum_member_name"><p><a name="LGL-TEMPLATE-FRAME-SHAPE-RECT:CAPS"></a>LGL_TEMPLATE_FRAME_SHAPE_RECT</p></td>
1828 <td class="enum_member_description">
1829 <p>A rectangular frame.  (May have rounded corners.)</p>
1830 </td>
1831 <td class="enum_member_annotations"> </td>
1832 </tr>
1833 <tr>
1834 <td class="enum_member_name"><p><a name="LGL-TEMPLATE-FRAME-SHAPE-ELLIPSE:CAPS"></a>LGL_TEMPLATE_FRAME_SHAPE_ELLIPSE</p></td>
1835 <td class="enum_member_description">
1836 <p>An elliptical frame.</p>
1837 </td>
1838 <td class="enum_member_annotations"> </td>
1839 </tr>
1840 <tr>
1841 <td class="enum_member_name"><p><a name="LGL-TEMPLATE-FRAME-SHAPE-ROUND:CAPS"></a>LGL_TEMPLATE_FRAME_SHAPE_ROUND</p></td>
1842 <td class="enum_member_description">
1843 <p>A round frame.</p>
1844 </td>
1845 <td class="enum_member_annotations"> </td>
1846 </tr>
1847 <tr>
1848 <td class="enum_member_name"><p><a name="LGL-TEMPLATE-FRAME-SHAPE-CD:CAPS"></a>LGL_TEMPLATE_FRAME_SHAPE_CD</p></td>
1849 <td class="enum_member_description">
1850 <p>A CD or DVD frame.  (Includes credit-card style CDs.)</p>
1851 </td>
1852 <td class="enum_member_annotations"> </td>
1853 </tr>
1854 </tbody>
1855 </table></div>
1856 </div>
1857 </div>
1858 <hr>
1859 <div class="refsect2">
1860 <a name="lglTemplateFrame"></a><h3>union lglTemplateFrame</h3>
1861 <p>
1862 A union of all possible frame structures.  The type of structure is indicated by the shape
1863 member, which overlays the first field of all other member structures.
1864 </p>
1865 </div>
1866 <hr>
1867 <div class="refsect2">
1868 <a name="lglTemplateFrameAll"></a><h3>struct lglTemplateFrameAll</h3>
1869 <pre class="programlisting">struct lglTemplateFrameAll {
1870         /* Begin Common Fields */
1871         lglTemplateFrameShape shape;
1872
1873         gchar                *id;       /* Id, currently always "0" */
1874         GList                *layouts;  /* List of lglTemplateLayouts */
1875         GList                *markups;  /* List of lglTemplateMarkups */
1876         /* End Common Fields */
1877 };
1878 </pre>
1879 <p>
1880 This structure is composed of a set of fields common to all frame structures.  All frame types
1881 can be cast to this structure.
1882 </p>
1883 <div class="refsect3">
1884 <a name="id-1.2.3.9.5.5"></a><h4>Members</h4>
1885 <div class="informaltable"><table width="100%" border="0">
1886 <colgroup>
1887 <col width="300px" class="struct_members_name">
1888 <col class="struct_members_description">
1889 <col width="200px" class="struct_members_annotations">
1890 </colgroup>
1891 <tbody>
1892 <tr>
1893 <td class="struct_member_name"><p><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>;</p></td>
1894 <td class="struct_member_description"><p>The shape of the frame.</p></td>
1895 <td class="struct_member_annotations"> </td>
1896 </tr>
1897 <tr>
1898 <td class="struct_member_name"><p><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>;</p></td>
1899 <td class="struct_member_description"><p>Reserved for future use.  Should always be zero.</p></td>
1900 <td class="struct_member_annotations"> </td>
1901 </tr>
1902 <tr>
1903 <td class="struct_member_name"><p><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>;</p></td>
1904 <td class="struct_member_description"><p>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
1905 layout, representing a simple grid of labels or cards.  If the layout of labels or cards is
1906 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.</p></td>
1907 <td class="struct_member_annotations"> </td>
1908 </tr>
1909 <tr>
1910 <td class="struct_member_name"><p><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>;</p></td>
1911 <td class="struct_member_description"><p>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.</p></td>
1912 <td class="struct_member_annotations"> </td>
1913 </tr>
1914 </tbody>
1915 </table></div>
1916 </div>
1917 </div>
1918 <hr>
1919 <div class="refsect2">
1920 <a name="lglTemplateFrameRect"></a><h3>struct lglTemplateFrameRect</h3>
1921 <pre class="programlisting">struct lglTemplateFrameRect {
1922         /* Begin Common Fields */
1923         lglTemplateFrameShape shape;    /* Always LGL_TEMPLATE_FRAME_SHAPE_RECT. */
1924
1925         gchar                *id;       /* Id, currently always "0" */
1926         GList                *layouts;  /* List of lglTemplateLayouts */
1927         GList                *markups;  /* List of lglTemplateMarkups */
1928         /* End Common Fields */
1929
1930         gdouble               w;        /* Width */
1931         gdouble               h;        /* Height */
1932         gdouble               r;        /* Corner radius */
1933         gdouble               x_waste;  /* Amount of horiz overprint allowed. */
1934         gdouble               y_waste;  /* Amount of vert overprint allowed. */
1935 };
1936 </pre>
1937 <p>
1938 This structure defines the frame for a rectangular label or card.
1939 </p>
1940 <div class="refsect3">
1941 <a name="id-1.2.3.9.6.5"></a><h4>Members</h4>
1942 <div class="informaltable"><table width="100%" border="0">
1943 <colgroup>
1944 <col width="300px" class="struct_members_name">
1945 <col class="struct_members_description">
1946 <col width="200px" class="struct_members_annotations">
1947 </colgroup>
1948 <tbody>
1949 <tr>
1950 <td class="struct_member_name"><p><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>;</p></td>
1951 <td class="struct_member_description"><p>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>.</p></td>
1952 <td class="struct_member_annotations"> </td>
1953 </tr>
1954 <tr>
1955 <td class="struct_member_name"><p><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>;</p></td>
1956 <td class="struct_member_description"><p>Common field.  See <a class="link" href="libglabels-3.0-template.html#lglTemplateFrameAll" title="struct lglTemplateFrameAll"><span class="type">lglTemplateFrameAll</span></a>.</p></td>
1957 <td class="struct_member_annotations"> </td>
1958 </tr>
1959 <tr>
1960 <td class="struct_member_name"><p><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>;</p></td>
1961 <td class="struct_member_description"><p> Common field.  See <a class="link" href="libglabels-3.0-template.html#lglTemplateFrameAll" title="struct lglTemplateFrameAll"><span class="type">lglTemplateFrameAll</span></a>.</p></td>
1962 <td class="struct_member_annotations"> </td>
1963 </tr>
1964 <tr>
1965 <td class="struct_member_name"><p><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>;</p></td>
1966 <td class="struct_member_description"><p> Common field.  See <a class="link" href="libglabels-3.0-template.html#lglTemplateFrameAll" title="struct lglTemplateFrameAll"><span class="type">lglTemplateFrameAll</span></a>.</p></td>
1967 <td class="struct_member_annotations"> </td>
1968 </tr>
1969 <tr>
1970 <td class="struct_member_name"><p><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>;</p></td>
1971 <td class="struct_member_description"><p>Width of label or card in points.</p></td>
1972 <td class="struct_member_annotations"> </td>
1973 </tr>
1974 <tr>
1975 <td class="struct_member_name"><p><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>;</p></td>
1976 <td class="struct_member_description"><p>Height of label or card in points.</p></td>
1977 <td class="struct_member_annotations"> </td>
1978 </tr>
1979 <tr>
1980 <td class="struct_member_name"><p><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>;</p></td>
1981 <td class="struct_member_description"><p>Radius of corners in points.</p></td>
1982 <td class="struct_member_annotations"> </td>
1983 </tr>
1984 <tr>
1985 <td class="struct_member_name"><p><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>;</p></td>
1986 <td class="struct_member_description"><p>Amount of horizontal over-print to allow in points.</p></td>
1987 <td class="struct_member_annotations"> </td>
1988 </tr>
1989 <tr>
1990 <td class="struct_member_name"><p><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>;</p></td>
1991 <td class="struct_member_description"><p>Amount of vertical over-print to allow in points.</p></td>
1992 <td class="struct_member_annotations"> </td>
1993 </tr>
1994 </tbody>
1995 </table></div>
1996 </div>
1997 </div>
1998 <hr>
1999 <div class="refsect2">
2000 <a name="lglTemplateFrameEllipse"></a><h3>struct lglTemplateFrameEllipse</h3>
2001 <pre class="programlisting">struct lglTemplateFrameEllipse {
2002         /* Begin Common Fields */
2003         lglTemplateFrameShape shape;    /* Always LGL_TEMPLATE_FRAME_SHAPE_ELLIPSE. */
2004
2005         gchar                *id;       /* Id, currently always "0" */
2006         GList                *layouts;  /* List of lglTemplateLayouts */
2007         GList                *markups;  /* List of lglTemplateMarkups */
2008         /* End Common Fields */
2009
2010         gdouble               w;        /* Width */
2011         gdouble               h;        /* Height */
2012         gdouble               waste;    /* Amount of overprint allowed. */
2013 };
2014 </pre>
2015 <p>
2016 This structure defines the frame for an elliptical label or card.
2017 </p>
2018 <div class="refsect3">
2019 <a name="id-1.2.3.9.7.5"></a><h4>Members</h4>
2020 <div class="informaltable"><table width="100%" border="0">
2021 <colgroup>
2022 <col width="300px" class="struct_members_name">
2023 <col class="struct_members_description">
2024 <col width="200px" class="struct_members_annotations">
2025 </colgroup>
2026 <tbody>
2027 <tr>
2028 <td class="struct_member_name"><p><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>;</p></td>
2029 <td class="struct_member_description"><p>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>.</p></td>
2030 <td class="struct_member_annotations"> </td>
2031 </tr>
2032 <tr>
2033 <td class="struct_member_name"><p><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>;</p></td>
2034 <td class="struct_member_description"><p>Common field.  See <a class="link" href="libglabels-3.0-template.html#lglTemplateFrameAll" title="struct lglTemplateFrameAll"><span class="type">lglTemplateFrameAll</span></a>.</p></td>
2035 <td class="struct_member_annotations"> </td>
2036 </tr>
2037 <tr>
2038 <td class="struct_member_name"><p><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>;</p></td>
2039 <td class="struct_member_description"><p> Common field.  See <a class="link" href="libglabels-3.0-template.html#lglTemplateFrameAll" title="struct lglTemplateFrameAll"><span class="type">lglTemplateFrameAll</span></a>.</p></td>
2040 <td class="struct_member_annotations"> </td>
2041 </tr>
2042 <tr>
2043 <td class="struct_member_name"><p><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>;</p></td>
2044 <td class="struct_member_description"><p> Common field.  See <a class="link" href="libglabels-3.0-template.html#lglTemplateFrameAll" title="struct lglTemplateFrameAll"><span class="type">lglTemplateFrameAll</span></a>.</p></td>
2045 <td class="struct_member_annotations"> </td>
2046 </tr>
2047 <tr>
2048 <td class="struct_member_name"><p><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>;</p></td>
2049 <td class="struct_member_description"><p>Width of label or card in points.</p></td>
2050 <td class="struct_member_annotations"> </td>
2051 </tr>
2052 <tr>
2053 <td class="struct_member_name"><p><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>;</p></td>
2054 <td class="struct_member_description"><p>Height of label or card in points.</p></td>
2055 <td class="struct_member_annotations"> </td>
2056 </tr>
2057 <tr>
2058 <td class="struct_member_name"><p><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>;</p></td>
2059 <td class="struct_member_description"><p>Amount of over-print to allow in points.</p></td>
2060 <td class="struct_member_annotations"> </td>
2061 </tr>
2062 </tbody>
2063 </table></div>
2064 </div>
2065 </div>
2066 <hr>
2067 <div class="refsect2">
2068 <a name="lglTemplateFrameRound"></a><h3>struct lglTemplateFrameRound</h3>
2069 <pre class="programlisting">struct lglTemplateFrameRound {
2070         /* Begin Common Fields */
2071         lglTemplateFrameShape shape;    /* Always LGL_TEMPLATE_FRAME_SHAPE_ROUND. */
2072
2073         gchar                *id;       /* Id, currently always "0" */
2074         GList                *layouts;  /* List of lglTemplateLayouts */
2075         GList                *markups;  /* List of lglTemplateMarkups */
2076         /* End Common Fields */
2077
2078         gdouble               r;      /* Radius */
2079         gdouble               waste;  /* Amount of overprint allowed. */
2080 };
2081 </pre>
2082 <p>
2083 This structure defines the frame for a round label or card.
2084 </p>
2085 <div class="refsect3">
2086 <a name="id-1.2.3.9.8.5"></a><h4>Members</h4>
2087 <div class="informaltable"><table width="100%" border="0">
2088 <colgroup>
2089 <col width="300px" class="struct_members_name">
2090 <col class="struct_members_description">
2091 <col width="200px" class="struct_members_annotations">
2092 </colgroup>
2093 <tbody>
2094 <tr>
2095 <td class="struct_member_name"><p><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>;</p></td>
2096 <td class="struct_member_description"><p>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>.</p></td>
2097 <td class="struct_member_annotations"> </td>
2098 </tr>
2099 <tr>
2100 <td class="struct_member_name"><p><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>;</p></td>
2101 <td class="struct_member_description"><p>Common field.  See <a class="link" href="libglabels-3.0-template.html#lglTemplateFrameAll" title="struct lglTemplateFrameAll"><span class="type">lglTemplateFrameAll</span></a>.</p></td>
2102 <td class="struct_member_annotations"> </td>
2103 </tr>
2104 <tr>
2105 <td class="struct_member_name"><p><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>;</p></td>
2106 <td class="struct_member_description"><p>Common field.  See <a class="link" href="libglabels-3.0-template.html#lglTemplateFrameAll" title="struct lglTemplateFrameAll"><span class="type">lglTemplateFrameAll</span></a>.</p></td>
2107 <td class="struct_member_annotations"> </td>
2108 </tr>
2109 <tr>
2110 <td class="struct_member_name"><p><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>;</p></td>
2111 <td class="struct_member_description"><p>Common field.  See <a class="link" href="libglabels-3.0-template.html#lglTemplateFrameAll" title="struct lglTemplateFrameAll"><span class="type">lglTemplateFrameAll</span></a>.</p></td>
2112 <td class="struct_member_annotations"> </td>
2113 </tr>
2114 <tr>
2115 <td class="struct_member_name"><p><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>;</p></td>
2116 <td class="struct_member_description"><p>Radius of label or card in points.</p></td>
2117 <td class="struct_member_annotations"> </td>
2118 </tr>
2119 <tr>
2120 <td class="struct_member_name"><p><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>;</p></td>
2121 <td class="struct_member_description"><p>Amount of over-print to allow in points.</p></td>
2122 <td class="struct_member_annotations"> </td>
2123 </tr>
2124 </tbody>
2125 </table></div>
2126 </div>
2127 </div>
2128 <hr>
2129 <div class="refsect2">
2130 <a name="lglTemplateFrameCD"></a><h3>struct lglTemplateFrameCD</h3>
2131 <pre class="programlisting">struct lglTemplateFrameCD {
2132         /* Begin Common Fields */
2133         lglTemplateFrameShape shape;    /* Always LGL_TEMPLATE_FRAME_SHAPE_CD. */
2134
2135         gchar                *id;       /* Id, currently always "0" */
2136         GList                *layouts;  /* List of lglTemplateLayouts */
2137         GList                *markups;  /* List of lglTemplateMarkups */
2138         /* End Common Fields */
2139
2140         gdouble               r1;     /* Outer radius */
2141         gdouble               r2;     /* Inner radius (hole) */
2142         gdouble               w;      /* Clip width, business card CDs */
2143         gdouble               h;      /* Clip height, business card CDs */
2144         gdouble               waste;  /* Amount of overprint allowed. */
2145 };
2146 </pre>
2147 <p>
2148 This structure defines the frame for a CD or DVD label.  This structure also supports
2149 credit-card CD labels.
2150 </p>
2151 <div class="refsect3">
2152 <a name="id-1.2.3.9.9.5"></a><h4>Members</h4>
2153 <div class="informaltable"><table width="100%" border="0">
2154 <colgroup>
2155 <col width="300px" class="struct_members_name">
2156 <col class="struct_members_description">
2157 <col width="200px" class="struct_members_annotations">
2158 </colgroup>
2159 <tbody>
2160 <tr>
2161 <td class="struct_member_name"><p><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>;</p></td>
2162 <td class="struct_member_description"><p>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>.</p></td>
2163 <td class="struct_member_annotations"> </td>
2164 </tr>
2165 <tr>
2166 <td class="struct_member_name"><p><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>;</p></td>
2167 <td class="struct_member_description"><p>Common field.  See <a class="link" href="libglabels-3.0-template.html#lglTemplateFrameAll" title="struct lglTemplateFrameAll"><span class="type">lglTemplateFrameAll</span></a>.</p></td>
2168 <td class="struct_member_annotations"> </td>
2169 </tr>
2170 <tr>
2171 <td class="struct_member_name"><p><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>;</p></td>
2172 <td class="struct_member_description"><p>Common field.  See <a class="link" href="libglabels-3.0-template.html#lglTemplateFrameAll" title="struct lglTemplateFrameAll"><span class="type">lglTemplateFrameAll</span></a>.</p></td>
2173 <td class="struct_member_annotations"> </td>
2174 </tr>
2175 <tr>
2176 <td class="struct_member_name"><p><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>;</p></td>
2177 <td class="struct_member_description"><p>Common field.  See <a class="link" href="libglabels-3.0-template.html#lglTemplateFrameAll" title="struct lglTemplateFrameAll"><span class="type">lglTemplateFrameAll</span></a>.</p></td>
2178 <td class="struct_member_annotations"> </td>
2179 </tr>
2180 <tr>
2181 <td class="struct_member_name"><p><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>;</p></td>
2182 <td class="struct_member_description"><p>Outer radius of label in points.</p></td>
2183 <td class="struct_member_annotations"> </td>
2184 </tr>
2185 <tr>
2186 <td class="struct_member_name"><p><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>;</p></td>
2187 <td class="struct_member_description"><p>Radius of center hole in points.</p></td>
2188 <td class="struct_member_annotations"> </td>
2189 </tr>
2190 <tr>
2191 <td class="struct_member_name"><p><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>;</p></td>
2192 <td class="struct_member_description"><p>Clip width in points.  Used for credit-card CD labels.  This field is ignored if zero.</p></td>
2193 <td class="struct_member_annotations"> </td>
2194 </tr>
2195 <tr>
2196 <td class="struct_member_name"><p><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>;</p></td>
2197 <td class="struct_member_description"><p>Clip height in points.  Used for credit-card CD labels.  This field is ignored if zero.</p></td>
2198 <td class="struct_member_annotations"> </td>
2199 </tr>
2200 <tr>
2201 <td class="struct_member_name"><p><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>;</p></td>
2202 <td class="struct_member_description"><p>Amount of over-print to allow in points.</p></td>
2203 <td class="struct_member_annotations"> </td>
2204 </tr>
2205 </tbody>
2206 </table></div>
2207 </div>
2208 </div>
2209 <hr>
2210 <div class="refsect2">
2211 <a name="lglTemplateLayout"></a><h3>struct lglTemplateLayout</h3>
2212 <pre class="programlisting">struct lglTemplateLayout {
2213         gint                  nx;  /* Number of labels across */
2214         gint                  ny;  /* Number of labels up and down */
2215
2216         gdouble               x0;  /* Left of grid from left edge of paper */
2217         gdouble               y0;  /* Top of grid from top edge of paper */
2218
2219         gdouble               dx;  /* Horizontal pitch of grid */
2220         gdouble               dy;  /* Vertical pitch of grid */
2221 };
2222 </pre>
2223 <p>
2224 This structure defines a simple grid layout of labels or cards.
2225 </p>
2226 <div class="refsect3">
2227 <a name="id-1.2.3.9.10.5"></a><h4>Members</h4>
2228 <div class="informaltable"><table width="100%" border="0">
2229 <colgroup>
2230 <col width="300px" class="struct_members_name">
2231 <col class="struct_members_description">
2232 <col width="200px" class="struct_members_annotations">
2233 </colgroup>
2234 <tbody>
2235 <tr>
2236 <td class="struct_member_name"><p><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>;</p></td>
2237 <td class="struct_member_description"><p>Number of labels or cards across in the grid (horizontal).</p></td>
2238 <td class="struct_member_annotations"> </td>
2239 </tr>
2240 <tr>
2241 <td class="struct_member_name"><p><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>;</p></td>
2242 <td class="struct_member_description"><p>Number of labels or cards down in the grid (vertical).</p></td>
2243 <td class="struct_member_annotations"> </td>
2244 </tr>
2245 <tr>
2246 <td class="struct_member_name"><p><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>;</p></td>
2247 <td class="struct_member_description"><p>Distance (in points) from the left edge of page to the left edge of the left column of
2248 cards or labels in the layout.</p></td>
2249 <td class="struct_member_annotations"> </td>
2250 </tr>
2251 <tr>
2252 <td class="struct_member_name"><p><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>;</p></td>
2253 <td class="struct_member_description"><p>Distance (in points) from the top edge of page to the top edge of the top row of
2254 cards or labels in the layout.</p></td>
2255 <td class="struct_member_annotations"> </td>
2256 </tr>
2257 <tr>
2258 <td class="struct_member_name"><p><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>;</p></td>
2259 <td class="struct_member_description"><p>Horizontal pitch of grid in points.  This is the distance from left edge to left edge
2260 (not the gap between labels or cards).</p></td>
2261 <td class="struct_member_annotations"> </td>
2262 </tr>
2263 <tr>
2264 <td class="struct_member_name"><p><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>;</p></td>
2265 <td class="struct_member_description"><p>Vertical pitch of grid in points.  This is the distance from top edge to top edge
2266 (not the gap between labels or cards).</p></td>
2267 <td class="struct_member_annotations"> </td>
2268 </tr>
2269 </tbody>
2270 </table></div>
2271 </div>
2272 </div>
2273 <hr>
2274 <div class="refsect2">
2275 <a name="lglTemplateMarkupType"></a><h3>enum lglTemplateMarkupType</h3>
2276 <p>
2277 This enumeration defines markup types that are supported by libglabels
2278 </p>
2279 <div class="refsect3">
2280 <a name="id-1.2.3.9.11.4"></a><h4>Members</h4>
2281 <div class="informaltable"><table width="100%" border="0">
2282 <colgroup>
2283 <col width="300px" class="enum_members_name">
2284 <col class="enum_members_description">
2285 <col width="200px" class="enum_members_annotations">
2286 </colgroup>
2287 <tbody>
2288 <tr>
2289 <td class="enum_member_name"><p><a name="LGL-TEMPLATE-MARKUP-MARGIN:CAPS"></a>LGL_TEMPLATE_MARKUP_MARGIN</p></td>
2290 <td class="enum_member_description">
2291 <p>A margin line around perimeter of label or card.</p>
2292 </td>
2293 <td class="enum_member_annotations"> </td>
2294 </tr>
2295 <tr>
2296 <td class="enum_member_name"><p><a name="LGL-TEMPLATE-MARKUP-LINE:CAPS"></a>LGL_TEMPLATE_MARKUP_LINE</p></td>
2297 <td class="enum_member_description">
2298 <p>A simple line segment.</p>
2299 </td>
2300 <td class="enum_member_annotations"> </td>
2301 </tr>
2302 <tr>
2303 <td class="enum_member_name"><p><a name="LGL-TEMPLATE-MARKUP-CIRCLE:CAPS"></a>LGL_TEMPLATE_MARKUP_CIRCLE</p></td>
2304 <td class="enum_member_description">
2305 <p>A circle.</p>
2306 </td>
2307 <td class="enum_member_annotations"> </td>
2308 </tr>
2309 <tr>
2310 <td class="enum_member_name"><p><a name="LGL-TEMPLATE-MARKUP-RECT:CAPS"></a>LGL_TEMPLATE_MARKUP_RECT</p></td>
2311 <td class="enum_member_description">
2312 <p>A rectangle.  Possibly with rounded corners.</p>
2313 </td>
2314 <td class="enum_member_annotations"> </td>
2315 </tr>
2316 <tr>
2317 <td class="enum_member_name"><p><a name="LGL-TEMPLATE-MARKUP-ELLIPSE:CAPS"></a>LGL_TEMPLATE_MARKUP_ELLIPSE</p></td>
2318 <td class="enum_member_description">
2319 <p>An ellipse.</p>
2320 </td>
2321 <td class="enum_member_annotations"> </td>
2322 </tr>
2323 </tbody>
2324 </table></div>
2325 </div>
2326 </div>
2327 <hr>
2328 <div class="refsect2">
2329 <a name="lglTemplateMarkup"></a><h3>union lglTemplateMarkup</h3>
2330 <p>
2331 A union of all possible markup structures.  The type of structure is indicated by the type
2332 member, which overlays the first field of all other member structures.
2333 </p>
2334 </div>
2335 <hr>
2336 <div class="refsect2">
2337 <a name="lglTemplateMarkupMargin"></a><h3>struct lglTemplateMarkupMargin</h3>
2338 <pre class="programlisting">struct lglTemplateMarkupMargin {
2339         lglTemplateMarkupType  type;  /* Always LGL_TEMPLATE_MARKUP_MARGIN */
2340
2341         gdouble                size;  /* Margin size */
2342 };
2343 </pre>
2344 <p>
2345 This structure defines a simple margin markup around the perimeter of a label or card.
2346 </p>
2347 <div class="refsect3">
2348 <a name="id-1.2.3.9.13.5"></a><h4>Members</h4>
2349 <div class="informaltable"><table width="100%" border="0">
2350 <colgroup>
2351 <col width="300px" class="struct_members_name">
2352 <col class="struct_members_description">
2353 <col width="200px" class="struct_members_annotations">
2354 </colgroup>
2355 <tbody>
2356 <tr>
2357 <td class="struct_member_name"><p><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>;</p></td>
2358 <td class="struct_member_description"><p>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>.</p></td>
2359 <td class="struct_member_annotations"> </td>
2360 </tr>
2361 <tr>
2362 <td class="struct_member_name"><p><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>;</p></td>
2363 <td class="struct_member_description"><p>Distance of margin from edge of label or card.</p></td>
2364 <td class="struct_member_annotations"> </td>
2365 </tr>
2366 </tbody>
2367 </table></div>
2368 </div>
2369 </div>
2370 <hr>
2371 <div class="refsect2">
2372 <a name="lglTemplateMarkupLine"></a><h3>struct lglTemplateMarkupLine</h3>
2373 <pre class="programlisting">struct lglTemplateMarkupLine {
2374         lglTemplateMarkupType  type;   /* Always LGL_TEMPLATE_MARKUP_LINE */
2375
2376         gdouble                x1, y1; /* 1st endpoint */
2377         gdouble                x2, y2; /* 2nd endpoint */
2378 };
2379 </pre>
2380 <p>
2381 This structure defines a simple line segment markup.
2382 </p>
2383 <div class="refsect3">
2384 <a name="id-1.2.3.9.14.5"></a><h4>Members</h4>
2385 <div class="informaltable"><table width="100%" border="0">
2386 <colgroup>
2387 <col width="300px" class="struct_members_name">
2388 <col class="struct_members_description">
2389 <col width="200px" class="struct_members_annotations">
2390 </colgroup>
2391 <tbody>
2392 <tr>
2393 <td class="struct_member_name"><p><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>;</p></td>
2394 <td class="struct_member_description"><p>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>.</p></td>
2395 <td class="struct_member_annotations"> </td>
2396 </tr>
2397 <tr>
2398 <td class="struct_member_name"><p><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>;</p></td>
2399 <td class="struct_member_description"><p>Distance (in points) of first endpoint from left edge of label or card.</p></td>
2400 <td class="struct_member_annotations"> </td>
2401 </tr>
2402 <tr>
2403 <td class="struct_member_name"><p><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>;</p></td>
2404 <td class="struct_member_description"><p>Distance (in points) of first endpoint from top edge of label or card.</p></td>
2405 <td class="struct_member_annotations"> </td>
2406 </tr>
2407 <tr>
2408 <td class="struct_member_name"><p><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>;</p></td>
2409 <td class="struct_member_description"><p>Distance (in points) of second endpoint from left edge of label or card.</p></td>
2410 <td class="struct_member_annotations"> </td>
2411 </tr>
2412 <tr>
2413 <td class="struct_member_name"><p><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>;</p></td>
2414 <td class="struct_member_description"><p>Distance (in points) of second endpoint from top edge of label or card.</p></td>
2415 <td class="struct_member_annotations"> </td>
2416 </tr>
2417 </tbody>
2418 </table></div>
2419 </div>
2420 </div>
2421 <hr>
2422 <div class="refsect2">
2423 <a name="lglTemplateMarkupCircle"></a><h3>struct lglTemplateMarkupCircle</h3>
2424 <pre class="programlisting">struct lglTemplateMarkupCircle {
2425         lglTemplateMarkupType  type;   /* Always LGL_TEMPLATE_MARKUP_CIRCLE */
2426
2427         gdouble                x0, y0; /* Center of circle */
2428         gdouble                r;      /* Radius of circle */
2429 };
2430 </pre>
2431 <p>
2432 This structure defines a simple circle markup.
2433 </p>
2434 <div class="refsect3">
2435 <a name="id-1.2.3.9.15.5"></a><h4>Members</h4>
2436 <div class="informaltable"><table width="100%" border="0">
2437 <colgroup>
2438 <col width="300px" class="struct_members_name">
2439 <col class="struct_members_description">
2440 <col width="200px" class="struct_members_annotations">
2441 </colgroup>
2442 <tbody>
2443 <tr>
2444 <td class="struct_member_name"><p><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>;</p></td>
2445 <td class="struct_member_description"><p>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>.</p></td>
2446 <td class="struct_member_annotations"> </td>
2447 </tr>
2448 <tr>
2449 <td class="struct_member_name"><p><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>;</p></td>
2450 <td class="struct_member_description"><p>Distance (in points) of vertex from left edge of label or card.</p></td>
2451 <td class="struct_member_annotations"> </td>
2452 </tr>
2453 <tr>
2454 <td class="struct_member_name"><p><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>;</p></td>
2455 <td class="struct_member_description"><p>Distance (in points) of vertex from top edge of label or card.</p></td>
2456 <td class="struct_member_annotations"> </td>
2457 </tr>
2458 <tr>
2459 <td class="struct_member_name"><p><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>;</p></td>
2460 <td class="struct_member_description"><p>Radius of circle in points.</p></td>
2461 <td class="struct_member_annotations"> </td>
2462 </tr>
2463 </tbody>
2464 </table></div>
2465 </div>
2466 </div>
2467 <hr>
2468 <div class="refsect2">
2469 <a name="lglTemplateMarkupRect"></a><h3>struct lglTemplateMarkupRect</h3>
2470 <pre class="programlisting">struct lglTemplateMarkupRect {
2471         lglTemplateMarkupType  type;   /* Always LGL_TEMPLATE_MARKUP_RECT */
2472
2473         gdouble                x1, y1; /* Upper left corner */
2474         gdouble                w, h;   /* Width and height. */
2475         gdouble                r;      /* Radius of corners. */
2476 };
2477 </pre>
2478 <p>
2479 This structure defines a simple rectangle markup.  The rectangle can have rounded corners.
2480 </p>
2481 <div class="refsect3">
2482 <a name="id-1.2.3.9.16.5"></a><h4>Members</h4>
2483 <div class="informaltable"><table width="100%" border="0">
2484 <colgroup>
2485 <col width="300px" class="struct_members_name">
2486 <col class="struct_members_description">
2487 <col width="200px" class="struct_members_annotations">
2488 </colgroup>
2489 <tbody>
2490 <tr>
2491 <td class="struct_member_name"><p><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>;</p></td>
2492 <td class="struct_member_description"><p>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>.</p></td>
2493 <td class="struct_member_annotations"> </td>
2494 </tr>
2495 <tr>
2496 <td class="struct_member_name"><p><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>;</p></td>
2497 <td class="struct_member_description"><p>Distance (in points) of left edge of markup from left edge of label or card.</p></td>
2498 <td class="struct_member_annotations"> </td>
2499 </tr>
2500 <tr>
2501 <td class="struct_member_name"><p><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>;</p></td>
2502 <td class="struct_member_description"><p>Distance (in points) of top edge of markup from top edge of label or card.</p></td>
2503 <td class="struct_member_annotations"> </td>
2504 </tr>
2505 <tr>
2506 <td class="struct_member_name"><p><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>;</p></td>
2507 <td class="struct_member_description"><p>Width of rectangle in points.</p></td>
2508 <td class="struct_member_annotations"> </td>
2509 </tr>
2510 <tr>
2511 <td class="struct_member_name"><p><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>;</p></td>
2512 <td class="struct_member_description"><p>Height of rectangle in points.</p></td>
2513 <td class="struct_member_annotations"> </td>
2514 </tr>
2515 <tr>
2516 <td class="struct_member_name"><p><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>;</p></td>
2517 <td class="struct_member_description"><p>Radius of corners in points.  Should be zero for sharp corners.</p></td>
2518 <td class="struct_member_annotations"> </td>
2519 </tr>
2520 </tbody>
2521 </table></div>
2522 </div>
2523 </div>
2524 <hr>
2525 <div class="refsect2">
2526 <a name="lglTemplateMarkupEllipse"></a><h3>struct lglTemplateMarkupEllipse</h3>
2527 <pre class="programlisting">struct lglTemplateMarkupEllipse {
2528         lglTemplateMarkupType  type;   /* Always LGL_TEMPLATE_MARKUP_ELLIPSE */
2529
2530         gdouble                x1, y1; /* Upper left corner */
2531         gdouble                w, h;   /* Width and height. */
2532 };
2533 </pre>
2534 <p>
2535 This structure defines a simple elliptical markup.
2536 </p>
2537 <div class="refsect3">
2538 <a name="id-1.2.3.9.17.5"></a><h4>Members</h4>
2539 <div class="informaltable"><table width="100%" border="0">
2540 <colgroup>
2541 <col width="300px" class="struct_members_name">
2542 <col class="struct_members_description">
2543 <col width="200px" class="struct_members_annotations">
2544 </colgroup>
2545 <tbody>
2546 <tr>
2547 <td class="struct_member_name"><p><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>;</p></td>
2548 <td class="struct_member_description"><p>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>.</p></td>
2549 <td class="struct_member_annotations"> </td>
2550 </tr>
2551 <tr>
2552 <td class="struct_member_name"><p><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>;</p></td>
2553 <td class="struct_member_description"><p>Distance (in points) of left edge of markup from left edge of label or card.</p></td>
2554 <td class="struct_member_annotations"> </td>
2555 </tr>
2556 <tr>
2557 <td class="struct_member_name"><p><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>;</p></td>
2558 <td class="struct_member_description"><p>Distance (in points) of top edge of markup from top edge of label or card.</p></td>
2559 <td class="struct_member_annotations"> </td>
2560 </tr>
2561 <tr>
2562 <td class="struct_member_name"><p><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>;</p></td>
2563 <td class="struct_member_description"><p>Width of rectangle in points.</p></td>
2564 <td class="struct_member_annotations"> </td>
2565 </tr>
2566 <tr>
2567 <td class="struct_member_name"><p><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>;</p></td>
2568 <td class="struct_member_description"><p>Height of rectangle in points.</p></td>
2569 <td class="struct_member_annotations"> </td>
2570 </tr>
2571 </tbody>
2572 </table></div>
2573 </div>
2574 </div>
2575 <hr>
2576 <div class="refsect2">
2577 <a name="lglTemplateOrigin"></a><h3>struct lglTemplateOrigin</h3>
2578 <pre class="programlisting">struct lglTemplateOrigin {
2579         gdouble               x, y; /* Label origin relative to upper
2580                                      * upper left hand corner of paper */
2581 };
2582 </pre>
2583 <p>
2584 This structure represents the cartesian coordinates of the origin of a label or card on the page.
2585 The orign is the upper left corner of the extent of the label or card.  These coordinates are
2586 relative to the upper left corner of the page.
2587 </p>
2588 <div class="refsect3">
2589 <a name="id-1.2.3.9.18.5"></a><h4>Members</h4>
2590 <div class="informaltable"><table width="100%" border="0">
2591 <colgroup>
2592 <col width="300px" class="struct_members_name">
2593 <col class="struct_members_description">
2594 <col width="200px" class="struct_members_annotations">
2595 </colgroup>
2596 <tbody>
2597 <tr>
2598 <td class="struct_member_name"><p><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>;</p></td>
2599 <td class="struct_member_description"><p>Distance in points from top edge of page.</p></td>
2600 <td class="struct_member_annotations"> </td>
2601 </tr>
2602 <tr>
2603 <td class="struct_member_name"><p><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>;</p></td>
2604 <td class="struct_member_description"><p>Distance in points from left edge of page.</p></td>
2605 <td class="struct_member_annotations"> </td>
2606 </tr>
2607 </tbody>
2608 </table></div>
2609 </div>
2610 </div>
2611 </div>
2612 </div>
2613 <div class="footer">
2614 <hr>
2615           Generated by GTK-Doc V1.20</div>
2616 </body>
2617 </html>