git.sur5r.net Git - glabels/blob - docs/libglbarcode/html/libglbarcode-3.0-lgl-barcode-create.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>LibGlbarcode 3.0 Reference Manual: Barcode Factory</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
   7 <link rel="home" href="index.html" title="LibGlbarcode 3.0 Reference Manual">
   8 <link rel="up" href="api.html" title="API Reference">
   9 <link rel="prev" href="libglbarcode-3.0-lgl-barcode.html" title="lglBarcode">
  10 <link rel="next" href="libglbarcode-3.0-lgl-barcode-render-to-cairo.html" title="Cairo Renderer">
  11 <meta name="generator" content="GTK-Doc V1.20 (XML mode)">
  12 <link rel="stylesheet" href="style.css" type="text/css">
  13 </head>
  14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="10"><tr valign="middle">
  16 <td width="100%" align="left" class="shortcuts">
  17 <a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span>
  18                   <a href="#libglbarcode-3.0-lgl-barcode-create.description" class="shortcut">Description</a></span><span id="nav_hierarchy"> <span class="dim">|</span>
  19                   <a href="#libglbarcode-3.0-lgl-barcode-create.object-hierarchy" class="shortcut">Object Hierarchy</a></span>
  20 </td>
  21 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
  22 <td><a accesskey="u" href="api.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
  23 <td><a accesskey="p" href="libglbarcode-3.0-lgl-barcode.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
  24 <td><a accesskey="n" href="libglbarcode-3.0-lgl-barcode-render-to-cairo.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
  25 </tr></table>
  26 <div class="refentry">
  27 <a name="libglbarcode-3.0-lgl-barcode-create"></a><div class="titlepage"></div>
  28 <div class="refnamediv"><table width="100%"><tr>
  29 <td valign="top">
  30 <h2><span class="refentrytitle"><a name="libglbarcode-3.0-lgl-barcode-create.top_of_page"></a>Barcode Factory</span></h2>
  31 <p>Barcode Factory — Basic end-user barcode creation API</p>
  32 </td>
  33 <td class="gallery_image" valign="top" align="right"></td>
  34 </tr></table></div>
  35 <div class="refsect1">
  36 <a name="libglbarcode-3.0-lgl-barcode-create.functions"></a><h2>Functions</h2>
  37 <div class="informaltable"><table width="100%" border="0">
  38 <colgroup>
  39 <col width="150px" class="functions_return">
  40 <col class="functions_name">
  41 </colgroup>
  42 <tbody><tr>
  43 <td class="function_type">
  44 <a class="link" href="libglbarcode-3.0-lgl-barcode.html#lglBarcode" title="lglBarcode"><span class="returnvalue">lglBarcode</span></a> *
  45 </td>
  46 <td class="function_name">
  47 <a class="link" href="libglbarcode-3.0-lgl-barcode-create.html#lgl-barcode-create" title="lgl_barcode_create ()">lgl_barcode_create</a> <span class="c_punctuation">()</span>
  48 </td>
  49 </tr></tbody>
  50 </table></div>
  51 </div>
  52 <div class="refsect1">
  53 <a name="libglbarcode-3.0-lgl-barcode-create.object-hierarchy"></a><h2>Object Hierarchy</h2>
  54 <pre class="screen">
  55 </pre>
  56 </div>
  57 <div class="refsect1">
  58 <a name="libglbarcode-3.0-lgl-barcode-create.includes"></a><h2>Includes</h2>
  59 <pre class="synopsis">#include &lt;libglbarcode/lgl-barcode-create.h&gt;
  60 </pre>
  61 </div>
  62 <div class="refsect1">
  63 <a name="libglbarcode-3.0-lgl-barcode-create.description"></a><h2>Description</h2>
  64 <p>
  65 This section describes a simple API to select and create <span class="type">glBarcode</span> structures using a built-in
  66 barcode backend.
  67 </p>
  68 </div>
  69 <div class="refsect1">
  70 <a name="libglbarcode-3.0-lgl-barcode-create.functions_details"></a><h2>Functions</h2>
  71 <div class="refsect2">
  72 <a name="lgl-barcode-create"></a><h3>lgl_barcode_create ()</h3>
  73 <pre class="programlisting"><a class="link" href="libglbarcode-3.0-lgl-barcode.html#lglBarcode" title="lglBarcode"><span class="returnvalue">lglBarcode</span></a> *
  74 lgl_barcode_create (<em class="parameter"><code><a class="link" href="libglbarcode-3.0-lgl-barcode-type.html#lglBarcodeType" title="enum lglBarcodeType"><span class="type">lglBarcodeType</span></a> type</code></em>,
  75                     <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> text_flag</code></em>,
  76                     <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> checksum_flag</code></em>,
  77                     <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> w</code></em>,
  78                     <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gdouble"><span class="type">gdouble</span></a> h</code></em>,
  79                     <em class="parameter"><code>const <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="type">gchar</span></a> *data</code></em>);</pre>
  80 <p>Create a new barcode structure, encoding <em class="parameter"><code>data</code></em>
  81  with selected barcode type and
  82 characteristics.</p>
  83 <p>Barcode dimensions (<em class="parameter"><code>w</code></em>
  84  and <em class="parameter"><code>h</code></em>
  85 ) are in points ( 1 point = 1/72 inch ).
  86 If either <em class="parameter"><code>w</code></em>
  87  or <em class="parameter"><code>h</code></em>
  88  are zero, the barcode will be rendered in a nominal size
  89 appropriate for the barcode type and data.  The actual size of the resulting
  90 barcode may also be limited by required tolerances of line sizes and spacing
  91 for the given barcode type.</p>
  92 <div class="refsect3">
  93 <a name="id-1.3.3.7.2.6"></a><h4>Parameters</h4>
  94 <div class="informaltable"><table width="100%" border="0">
  95 <colgroup>
  96 <col width="150px" class="parameters_name">
  97 <col class="parameters_description">
  98 <col width="200px" class="parameters_annotations">
  99 </colgroup>
 100 <tbody>
 101 <tr>
 102 <td class="parameter_name"><p>type</p></td>
 103 <td class="parameter_description"><p>Barcode type selection (<a class="link" href="libglbarcode-3.0-lgl-barcode-type.html#lglBarcodeType" title="enum lglBarcodeType"><span class="type">lglBarcodeType</span></a>)</p></td>
 104 <td class="parameter_annotations"> </td>
 105 </tr>
 106 <tr>
 107 <td class="parameter_name"><p>text_flag</p></td>
 108 <td class="parameter_description"><p><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to show text, if supported by barcode type</p></td>
 109 <td class="parameter_annotations"> </td>
 110 </tr>
 111 <tr>
 112 <td class="parameter_name"><p>checksum_flag</p></td>
 113 <td class="parameter_description"><p><a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to include checksum, if supported or optional for barcode type</p></td>
 114 <td class="parameter_annotations"> </td>
 115 </tr>
 116 <tr>
 117 <td class="parameter_name"><p>w</p></td>
 118 <td class="parameter_description"><p>Suggested width of barcode</p></td>
 119 <td class="parameter_annotations"> </td>
 120 </tr>
 121 <tr>
 122 <td class="parameter_name"><p>h</p></td>
 123 <td class="parameter_description"><p>Suggested height of barcode</p></td>
 124 <td class="parameter_annotations"> </td>
 125 </tr>
 126 <tr>
 127 <td class="parameter_name"><p>data</p></td>
 128 <td class="parameter_description"><p>Data to encode into barcode</p></td>
 129 <td class="parameter_annotations"> </td>
 130 </tr>
 131 </tbody>
 132 </table></div>
 133 </div>
 134 <div class="refsect3">
 135 <a name="id-1.3.3.7.2.7"></a><h4>Returns</h4>
 136 <p> A newly allocated <a class="link" href="libglbarcode-3.0-lgl-barcode.html#lglBarcode" title="lglBarcode"><span class="type">lglBarcode</span></a> structure.  Use <a class="link" href="libglbarcode-3.0-lgl-barcode.html#lgl-barcode-free" title="lgl_barcode_free ()"><code class="function">lgl_barcode_free()</code></a> to
 137 free it.</p>
 138 <p></p>
 139 </div>
 140 </div>
 141 </div>
 142 <div class="refsect1">
 143 <a name="libglbarcode-3.0-lgl-barcode-create.other_details"></a><h2>Types and Values</h2>
 144 </div>
 145 </div>
 146 <div class="footer">
 147 <hr>
 148           Generated by GTK-Doc V1.20</div>
 149 </body>
 150 </html>