Project

General

Profile

Statistics
| Revision:

root / branches / wireless / docs / libdragonfly / html / group__encoders.html @ 1578

History | View | Annotate | Download (18.9 KB)

1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2
<html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
3
<title>Colony: Encoders</title>
4
<link href="tabs.css" rel="stylesheet" type="text/css">
5
<link href="doxygen.css" rel="stylesheet" type="text/css">
6
</head><body>
7
<!-- Generated by Doxygen 1.5.8 -->
8
<div class="navigation" id="top">
9
  <div class="tabs">
10
    <ul>
11
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
12
      <li><a href="pages.html"><span>Related&nbsp;Pages</span></a></li>
13
      <li><a href="modules.html"><span>Modules</span></a></li>
14
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
15
      <li><a href="files.html"><span>Files</span></a></li>
16
    </ul>
17
  </div>
18
</div>
19
<div class="contents">
20
<h1>Encoders</h1><table border="0" cellpadding="0" cellspacing="0">
21
<tr><td></td></tr>
22
<tr><td colspan="2"><br><h2>Defines</h2></td></tr>
23
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g437ef08681e7210d6678427030446a54"></a><!-- doxytag: member="encoders::LEFT" ref="g437ef08681e7210d6678427030446a54" args="" -->
24
#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__encoders.html#g437ef08681e7210d6678427030446a54">LEFT</a>&nbsp;&nbsp;&nbsp;0</td></tr>
25

    
26
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Left wheel. <br></td></tr>
27
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g80fb826a684cf3f0d306b22aa100ddac"></a><!-- doxytag: member="encoders::RIGHT" ref="g80fb826a684cf3f0d306b22aa100ddac" args="" -->
28
#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__encoders.html#g80fb826a684cf3f0d306b22aa100ddac">RIGHT</a>&nbsp;&nbsp;&nbsp;1</td></tr>
29

    
30
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Right wheel. <br></td></tr>
31
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g1f12cd2d377e62c56999d46dc6bb7cfc"></a><!-- doxytag: member="encoders::ENCODER_MAX" ref="g1f12cd2d377e62c56999d46dc6bb7cfc" args="" -->
32
#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__encoders.html#g1f12cd2d377e62c56999d46dc6bb7cfc">ENCODER_MAX</a>&nbsp;&nbsp;&nbsp;1024</td></tr>
33

    
34
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Max value of valid encoder reading. <br></td></tr>
35
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="ga7c882763d1877f0000be3e73f93d08a"></a><!-- doxytag: member="encoders::ENCODER_MAGNET_FAILURE" ref="ga7c882763d1877f0000be3e73f93d08a" args="" -->
36
#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__encoders.html#ga7c882763d1877f0000be3e73f93d08a">ENCODER_MAGNET_FAILURE</a>&nbsp;&nbsp;&nbsp;1025</td></tr>
37

    
38
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Magnet misaligned - likely distance from encoder problem. <br></td></tr>
39
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g461113043ab113b6dc7d56619a1a15f4"></a><!-- doxytag: member="encoders::ENCODER_MISALIGNED" ref="g461113043ab113b6dc7d56619a1a15f4" args="" -->
40
#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__encoders.html#g461113043ab113b6dc7d56619a1a15f4">ENCODER_MISALIGNED</a>&nbsp;&nbsp;&nbsp;1027</td></tr>
41

    
42
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Encoder misaligned - likely on XY plane. <br></td></tr>
43
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g0a5cb25278a57b19a46264d134033f7b"></a><!-- doxytag: member="encoders::ENCODER_DATA_NOT_READY" ref="g0a5cb25278a57b19a46264d134033f7b" args="" -->
44
#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__encoders.html#g0a5cb25278a57b19a46264d134033f7b">ENCODER_DATA_NOT_READY</a>&nbsp;&nbsp;&nbsp;1026</td></tr>
45

    
46
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Not enough time has passed - encoders not initialized in hardware. <br></td></tr>
47
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g5ff35c79ce306ac5c3580b96dea4e653"></a><!-- doxytag: member="encoders::ENCODER_DELAY" ref="g5ff35c79ce306ac5c3580b96dea4e653" args="" -->
48
#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__encoders.html#g5ff35c79ce306ac5c3580b96dea4e653">ENCODER_DELAY</a>&nbsp;&nbsp;&nbsp;20</td></tr>
49

    
50
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">delay_ms argument after a full read is complete <br></td></tr>
51
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g9173b4a556a38fffd9336138830ebfa0"></a><!-- doxytag: member="encoders::OCF" ref="g9173b4a556a38fffd9336138830ebfa0" args="" -->
52
#define&nbsp;</td><td class="memItemRight" valign="bottom"><b>OCF</b>&nbsp;&nbsp;&nbsp;_BV(4)</td></tr>
53

    
54
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="gdfb416b9855f4d6cc2153044a681509e"></a><!-- doxytag: member="encoders::COF" ref="gdfb416b9855f4d6cc2153044a681509e" args="" -->
55
#define&nbsp;</td><td class="memItemRight" valign="bottom"><b>COF</b>&nbsp;&nbsp;&nbsp;_BV(3)</td></tr>
56

    
57
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="gfbb57dfc13455b39716c3bb5c55eaa06"></a><!-- doxytag: member="encoders::LIN" ref="gfbb57dfc13455b39716c3bb5c55eaa06" args="" -->
58
#define&nbsp;</td><td class="memItemRight" valign="bottom"><b>LIN</b>&nbsp;&nbsp;&nbsp;_BV(2)</td></tr>
59

    
60
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="gdc67b4ce01de99b63b3639f03c03a05b"></a><!-- doxytag: member="encoders::MagINCn" ref="gdc67b4ce01de99b63b3639f03c03a05b" args="" -->
61
#define&nbsp;</td><td class="memItemRight" valign="bottom"><b>MagINCn</b>&nbsp;&nbsp;&nbsp;_BV(1)</td></tr>
62

    
63
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="gdc7fd147cd970830e275f0ed9ebff00a"></a><!-- doxytag: member="encoders::MagDECn" ref="gdc7fd147cd970830e275f0ed9ebff00a" args="" -->
64
#define&nbsp;</td><td class="memItemRight" valign="bottom"><b>MagDECn</b>&nbsp;&nbsp;&nbsp;_BV(0)</td></tr>
65

    
66
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g6b20d41d6252e9871430c242cb1a56e7"></a><!-- doxytag: member="encoders::BUFFER_SIZE" ref="g6b20d41d6252e9871430c242cb1a56e7" args="" -->
67
#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__encoders.html#g6b20d41d6252e9871430c242cb1a56e7">BUFFER_SIZE</a>&nbsp;&nbsp;&nbsp;46</td></tr>
68

    
69
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Buffer size. <br></td></tr>
70
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g4bd797b3c049b5b2b8653b7a59b29e0d"></a><!-- doxytag: member="encoders::ERR_VEL" ref="g4bd797b3c049b5b2b8653b7a59b29e0d" args="" -->
71
#define&nbsp;</td><td class="memItemRight" valign="bottom"><b>ERR_VEL</b>&nbsp;&nbsp;&nbsp;1024</td></tr>
72

    
73
<tr><td colspan="2"><br><h2>Functions</h2></td></tr>
74
<tr><td class="memItemLeft" nowrap align="right" valign="top"><a class="anchor" name="g517df1c739bb887e39630553f3f10951"></a><!-- doxytag: member="encoders::encoders_init" ref="g517df1c739bb887e39630553f3f10951" args="(void)" -->
75
int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__encoders.html#g517df1c739bb887e39630553f3f10951">encoders_init</a> (void)</td></tr>
76

    
77
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Initialize encoders. <br></td></tr>
78
<tr><td class="memItemLeft" nowrap align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__encoders.html#g9abc8e86fe64bcf4c3862ed12d913530">encoder_read</a> (char encoder)</td></tr>
79

    
80
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Read instantaneous encoder value.  <a href="#g9abc8e86fe64bcf4c3862ed12d913530"></a><br></td></tr>
81
<tr><td class="memItemLeft" nowrap align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__encoders.html#g68d8fd95c78ac910e6a62940451088d4">encoder_get_x</a> (char encoder)</td></tr>
82

    
83
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Get total distance traveled.  <a href="#g68d8fd95c78ac910e6a62940451088d4"></a><br></td></tr>
84
<tr><td class="memItemLeft" nowrap align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__encoders.html#gdfa15a962856217c49d8a7eb326867d2">encoder_get_v</a> (char encoder)</td></tr>
85

    
86
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Get instantaneous velocity.  <a href="#gdfa15a962856217c49d8a7eb326867d2"></a><br></td></tr>
87
<tr><td class="memItemLeft" nowrap align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__encoders.html#gd73643bd46dbc459cc0dfa8dd90b4992">encoder_get_dx</a> (char encoder)</td></tr>
88

    
89
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Get total distance traveled.  <a href="#gd73643bd46dbc459cc0dfa8dd90b4992"></a><br></td></tr>
90
<tr><td class="memItemLeft" nowrap align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__encoders.html#g2f00a2c3cc26610bdd80aeca032845bf">encoder_rst_dx</a> (char encoder)</td></tr>
91

    
92
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Reset distance counter.  <a href="#g2f00a2c3cc26610bdd80aeca032845bf"></a><br></td></tr>
93
<tr><td class="memItemLeft" nowrap align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__encoders.html#g8ad080c3e41790edd7e7ccbc91060fec">encoder_get_tc</a> (void)</td></tr>
94

    
95
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Get time count: The number of encoder reads that have occurred.  <a href="#g8ad080c3e41790edd7e7ccbc91060fec"></a><br></td></tr>
96
<tr><td class="memItemLeft" nowrap align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__encoders.html#g28710b1699c65f3bb0ceac2cb456113f">encoder_rst_tc</a> (void)</td></tr>
97

    
98
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Reset the time count.  <a href="#g28710b1699c65f3bb0ceac2cb456113f"></a><br></td></tr>
99
<tr><td class="memItemLeft" nowrap align="right" valign="top">int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="group__encoders.html#g858be4d7af3a488e9cbd630a4c9bc7cd">encoder_wait</a> (int nReadings)</td></tr>
100

    
101
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Waits for the next n encoder reading, then returns.  <a href="#g858be4d7af3a488e9cbd630a4c9bc7cd"></a><br></td></tr>
102
</table>
103
<hr><h2>Function Documentation</h2>
104
<a class="anchor" name="gd73643bd46dbc459cc0dfa8dd90b4992"></a><!-- doxytag: member="encoders.h::encoder_get_dx" ref="gd73643bd46dbc459cc0dfa8dd90b4992" args="(char encoder)" -->
105
<div class="memitem">
106
<div class="memproto">
107
      <table class="memname">
108
        <tr>
109
          <td class="memname">int encoder_get_dx           </td>
110
          <td>(</td>
111
          <td class="paramtype">char&nbsp;</td>
112
          <td class="paramname"> <em>encoder</em>          </td>
113
          <td>&nbsp;)&nbsp;</td>
114
          <td></td>
115
        </tr>
116
      </table>
117
</div>
118
<div class="memdoc">
119

    
120
<p>
121
Get total distance traveled. 
122
<p>
123
Gets the total distance covered by the specified encoder (in encoder clicks)<p>
124
<dl compact><dt><b>Parameters:</b></dt><dd>
125
  <table border="0" cellspacing="2" cellpadding="0">
126
    <tr><td valign="top"></td><td valign="top"><em>encoder</em>&nbsp;</td><td>the encoder that you want to read, use LEFT or RIGHT</td></tr>
127
  </table>
128
</dl>
129
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The distance covered by the specified encoder, -2 if the library is not initialized </dd></dl>
130

    
131
</div>
132
</div><p>
133
<a class="anchor" name="g8ad080c3e41790edd7e7ccbc91060fec"></a><!-- doxytag: member="encoders.h::encoder_get_tc" ref="g8ad080c3e41790edd7e7ccbc91060fec" args="(void)" -->
134
<div class="memitem">
135
<div class="memproto">
136
      <table class="memname">
137
        <tr>
138
          <td class="memname">int encoder_get_tc           </td>
139
          <td>(</td>
140
          <td class="paramtype">void&nbsp;</td>
141
          <td class="paramname">          </td>
142
          <td>&nbsp;)&nbsp;</td>
143
          <td></td>
144
        </tr>
145
      </table>
146
</div>
147
<div class="memdoc">
148

    
149
<p>
150
Get time count: The number of encoder reads that have occurred. 
151
<p>
152
Get time count: The number of encoder reads that have occurred.<p>
153
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The time count. </dd></dl>
154

    
155
</div>
156
</div><p>
157
<a class="anchor" name="gdfa15a962856217c49d8a7eb326867d2"></a><!-- doxytag: member="encoders.h::encoder_get_v" ref="gdfa15a962856217c49d8a7eb326867d2" args="(char encoder)" -->
158
<div class="memitem">
159
<div class="memproto">
160
      <table class="memname">
161
        <tr>
162
          <td class="memname">int encoder_get_v           </td>
163
          <td>(</td>
164
          <td class="paramtype">char&nbsp;</td>
165
          <td class="paramname"> <em>encoder</em>          </td>
166
          <td>&nbsp;)&nbsp;</td>
167
          <td></td>
168
        </tr>
169
      </table>
170
</div>
171
<div class="memdoc">
172

    
173
<p>
174
Get instantaneous velocity. 
175
<p>
176
Get instantaneous velocity.<p>
177
<dl compact><dt><b>Parameters:</b></dt><dd>
178
  <table border="0" cellspacing="2" cellpadding="0">
179
    <tr><td valign="top"></td><td valign="top"><em>encoder</em>&nbsp;</td><td>RIGHT or LEFT - the wheel you want the velocity for.</td></tr>
180
  </table>
181
</dl>
182
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The instantaneous velocity for the given wheel or twice the ERR_VEL if an error occurs (1024 * 2 = 2048)</dd></dl>
183
<dl compact><dt><b><a class="el" href="bug.html#_bug000005">Bug:</a></b></dt><dd>This uses hard coded values and results are inconsistent. Use at your own risk. </dd></dl>
184

    
185
</div>
186
</div><p>
187
<a class="anchor" name="g68d8fd95c78ac910e6a62940451088d4"></a><!-- doxytag: member="encoders.h::encoder_get_x" ref="g68d8fd95c78ac910e6a62940451088d4" args="(char encoder)" -->
188
<div class="memitem">
189
<div class="memproto">
190
      <table class="memname">
191
        <tr>
192
          <td class="memname">int encoder_get_x           </td>
193
          <td>(</td>
194
          <td class="paramtype">char&nbsp;</td>
195
          <td class="paramname"> <em>encoder</em>          </td>
196
          <td>&nbsp;)&nbsp;</td>
197
          <td></td>
198
        </tr>
199
      </table>
200
</div>
201
<div class="memdoc">
202

    
203
<p>
204
Get total distance traveled. 
205
<p>
206
<dl class="note" compact><dt><b>Note:</b></dt><dd>Simply calls encoder_get_dx.</dd></dl>
207
Get total distance traveled.<p>
208
<dl compact><dt><b>Parameters:</b></dt><dd>
209
  <table border="0" cellspacing="2" cellpadding="0">
210
    <tr><td valign="top"></td><td valign="top"><em>encoder</em>&nbsp;</td><td>the encoder that you want to read, either LEFT or RIGHT</td></tr>
211
  </table>
212
</dl>
213
<dl class="return" compact><dt><b>Returns:</b></dt><dd>The distance covered by the specified encoder.</dd></dl>
214
<dl class="note" compact><dt><b>Note:</b></dt><dd>Simply calls encoder_get_dx. </dd></dl>
215

    
216
</div>
217
</div><p>
218
<a class="anchor" name="g9abc8e86fe64bcf4c3862ed12d913530"></a><!-- doxytag: member="encoders.h::encoder_read" ref="g9abc8e86fe64bcf4c3862ed12d913530" args="(char encoder)" -->
219
<div class="memitem">
220
<div class="memproto">
221
      <table class="memname">
222
        <tr>
223
          <td class="memname">int encoder_read           </td>
224
          <td>(</td>
225
          <td class="paramtype">char&nbsp;</td>
226
          <td class="paramname"> <em>encoder</em>          </td>
227
          <td>&nbsp;)&nbsp;</td>
228
          <td></td>
229
        </tr>
230
      </table>
231
</div>
232
<div class="memdoc">
233

    
234
<p>
235
Read instantaneous encoder value. 
236
<p>
237
Read instantaneous encoder value.<p>
238
<dl compact><dt><b>Parameters:</b></dt><dd>
239
  <table border="0" cellspacing="2" cellpadding="0">
240
    <tr><td valign="top"></td><td valign="top"><em>encoder</em>&nbsp;</td><td>this is the encoder that you want to read. Valid arguments are LEFT and RIGHT</td></tr>
241
  </table>
242
</dl>
243
<dl class="return" compact><dt><b>Returns:</b></dt><dd>the value of the specified encoder. -1 usually means low battery. -2 means the library was not properly initialized values above ENCODER_MAX usually means phyiscal problems with the encoder. </dd></dl>
244

    
245
</div>
246
</div><p>
247
<a class="anchor" name="g2f00a2c3cc26610bdd80aeca032845bf"></a><!-- doxytag: member="encoders.h::encoder_rst_dx" ref="g2f00a2c3cc26610bdd80aeca032845bf" args="(char encoder)" -->
248
<div class="memitem">
249
<div class="memproto">
250
      <table class="memname">
251
        <tr>
252
          <td class="memname">int encoder_rst_dx           </td>
253
          <td>(</td>
254
          <td class="paramtype">char&nbsp;</td>
255
          <td class="paramname"> <em>encoder</em>          </td>
256
          <td>&nbsp;)&nbsp;</td>
257
          <td></td>
258
        </tr>
259
      </table>
260
</div>
261
<div class="memdoc">
262

    
263
<p>
264
Reset distance counter. 
265
<p>
266
Resets the distance accumulator for the specified encoder.<p>
267
<dl compact><dt><b>Parameters:</b></dt><dd>
268
  <table border="0" cellspacing="2" cellpadding="0">
269
    <tr><td valign="top"></td><td valign="top"><em>encoder</em>&nbsp;</td><td>the encoder that you want to reset distance for </td></tr>
270
  </table>
271
</dl>
272

    
273
</div>
274
</div><p>
275
<a class="anchor" name="g28710b1699c65f3bb0ceac2cb456113f"></a><!-- doxytag: member="encoders.h::encoder_rst_tc" ref="g28710b1699c65f3bb0ceac2cb456113f" args="(void)" -->
276
<div class="memitem">
277
<div class="memproto">
278
      <table class="memname">
279
        <tr>
280
          <td class="memname">int encoder_rst_tc           </td>
281
          <td>(</td>
282
          <td class="paramtype">void&nbsp;</td>
283
          <td class="paramname">          </td>
284
          <td>&nbsp;)&nbsp;</td>
285
          <td></td>
286
        </tr>
287
      </table>
288
</div>
289
<div class="memdoc">
290

    
291
<p>
292
Reset the time count. 
293
<p>
294
Reset the time count.<p>
295
<dl class="return" compact><dt><b>Returns:</b></dt><dd>0 if init succesfull, an error code otherwise </dd></dl>
296

    
297
</div>
298
</div><p>
299
<a class="anchor" name="g858be4d7af3a488e9cbd630a4c9bc7cd"></a><!-- doxytag: member="encoders.h::encoder_wait" ref="g858be4d7af3a488e9cbd630a4c9bc7cd" args="(int nReadings)" -->
300
<div class="memitem">
301
<div class="memproto">
302
      <table class="memname">
303
        <tr>
304
          <td class="memname">int encoder_wait           </td>
305
          <td>(</td>
306
          <td class="paramtype">int&nbsp;</td>
307
          <td class="paramname"> <em>n</em>          </td>
308
          <td>&nbsp;)&nbsp;</td>
309
          <td></td>
310
        </tr>
311
      </table>
312
</div>
313
<div class="memdoc">
314

    
315
<p>
316
Waits for the next n encoder reading, then returns. 
317
<p>
318
Waits for the next n encoder reading, then returns.<p>
319
<dl compact><dt><b>Parameters:</b></dt><dd>
320
  <table border="0" cellspacing="2" cellpadding="0">
321
    <tr><td valign="top"></td><td valign="top"><em>n</em>&nbsp;</td><td></td></tr>
322
  </table>
323
</dl>
324
<dl class="return" compact><dt><b>Returns:</b></dt><dd>0 if init succesfull, an error code otherwise </dd></dl>
325

    
326
</div>
327
</div><p>
328
</div>
329
<hr size="1"><address style="text-align: right;"><small>Generated on Fri Nov 20 21:51:59 2009 for Colony by&nbsp;
330
<a href="http://www.doxygen.org/index.html">
331
<img src="doxygen.png" alt="doxygen" align="middle" border="0"></a> 1.5.8 </small></address>
332
</body>
333
</html>