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

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