~ubuntu-branches/ubuntu/raring/scilab/raring-proposed

« back to all changes in this revision

Viewing changes to modules/xcos/help/en_US/palettes/Integer_pal/EXTRACTBITS.xml

  • Committer: Package Import Robot
  • Author(s): Sylvestre Ledru
  • Date: 2012-08-30 14:42:38 UTC
  • mfrom: (1.4.7)
  • Revision ID: package-import@ubuntu.com-20120830144238-c1y2og7dbm7m9nig
Tags: 5.4.0-beta-3-1~exp1
* New upstream release
* Update the scirenderer dep
* Get ride of libjhdf5-java dependency

Show diffs side-by-side

added added

removed removed

Lines of Context:
24
24
 *
25
25
 -->
26
26
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml" xmlns:db="http://docbook.org/ns/docbook" version="5.0-subset Scilab" xml:id="EXTRACTBITS" xmln.mml="http://www.w3.org/1998/Math/MathML">
27
 
  <refnamediv>
28
 
    <refname>EXTRACTBITS</refname>
29
 
    <refpurpose>Bits Extraction</refpurpose>
30
 
  </refnamediv>
31
 
  <refsection>
32
 
    <title>Block Screenshot</title>
33
 
    <para>
34
 
      <inlinemediaobject>
35
 
        <imageobject>
36
 
          <imagedata fileref="../../../../images/palettes/EXTRACTBITS.png" align="center" valign="middle"/>
37
 
        </imageobject>
38
 
      </inlinemediaobject>
39
 
    </para>
40
 
  </refsection>
41
 
  <refsection id="Contents_EXTRACTBITS">
42
 
    <title>Contents</title>
43
 
    <itemizedlist>
44
 
      <listitem>
45
 
        <para>
46
 
          <link linkend="EXTRACTBITS">Bits extraction </link>
47
 
        </para>
48
 
      </listitem>
49
 
      <listitem>
50
 
        <itemizedlist>
51
 
          <listitem>
52
 
            <para>
53
 
              <xref linkend="Palette_EXTRACTBITS">Palette</xref>
54
 
            </para>
55
 
          </listitem>
56
 
          <listitem>
57
 
            <para>
58
 
              <xref linkend="Description_EXTRACTBITS">Description</xref>
59
 
            </para>
60
 
          </listitem>
61
 
          <listitem>
62
 
            <para>
63
 
              <xref linkend="Data_Type_BITCLEAR">Data types</xref>
64
 
            </para>
65
 
          </listitem>
66
 
          <listitem>
67
 
            <para>
68
 
              <xref linkend="Dialogbox_EXTRACTBITS">Dialog box</xref>
69
 
            </para>
70
 
          </listitem>
71
 
          <listitem>
72
 
            <para>
73
 
              <xref linkend="Defaultproperties_EXTRACTBITS">Default properties</xref>
74
 
            </para>
75
 
          </listitem>
76
 
          <listitem>
77
 
            <para>
78
 
              <xref linkend="Example_EXTRACTBITS">Example</xref>
79
 
            </para>
80
 
          </listitem>
81
 
          <listitem>
82
 
            <para>
83
 
              <xref linkend="Interfacingfunction_EXTRACTBITS">Interfacing function</xref>
84
 
            </para>
85
 
          </listitem>
86
 
          <listitem>
87
 
            <para>
88
 
              <xref linkend="Computationalfunction_EXTRACTBITS">Computational function</xref>
89
 
            </para>
90
 
          </listitem>
91
 
          <listitem>
92
 
            <para>
93
 
              <xref linkend="Seealso_EXTRACTBITS">See also</xref>
94
 
            </para>
95
 
          </listitem>
96
 
        </itemizedlist>
97
 
      </listitem>
98
 
    </itemizedlist>
99
 
  </refsection>
100
 
  <refsection id="Palette_EXTRACTBITS">
101
 
    <title>Palette</title>
102
 
    <itemizedlist>
103
 
      <listitem>
104
 
        <para>
105
 
          <link linkend="Integer_pal">Integer palette</link>
106
 
        </para>
107
 
      </listitem>
108
 
    </itemizedlist>
109
 
  </refsection>
110
 
  <refsection id="Description_EXTRACTBITS">
111
 
    <title>Description</title>
112
 
    <para>
113
 
      For an integer input this block outputs a contiguous selection of bits. The operation can be
114
 
      summarized by this expression:
115
 
    </para>
116
 
    <para>
117
 
      <latex><![CDATA[ Output=Input \wedge Mask]]></latex>
118
 
    </para>
119
 
    <para>
120
 
      i.e. a bitwise <literal>AND</literal> between <literal>Input</literal> and
121
 
      <literal>Mask</literal> an integer of the same length as input with the bits to extract
122
 
      set to <literal>1</literal> and the other bits set to <literal>0</literal>.
123
 
      <emphasis role="bold">Bits to Extract</emphasis> parameter defines the method by which the
124
 
      user selects the output bits as summarized by the following table with index
125
 
      <literal>0</literal>, as that of the least significant bit :
126
 
    </para>
127
 
    <para/>
128
 
    <informaltable border="1" cellpadding="2">
129
 
      <tr>
130
 
        <td align="left">
131
 
          <emphasis role="bold">Bits to Extract</emphasis>
132
 
        </td>
133
 
        <td align="left">
134
 
          <emphasis role="bold">Output</emphasis>
135
 
        </td>
136
 
        <td align="left">
137
 
          <emphasis role="bold">Number of Bits or Index of Bit</emphasis>
138
 
        </td>
139
 
      </tr>
140
 
      <tr>
141
 
        <td align="left">
142
 
          <emphasis role="bold">Upper Half</emphasis>
143
 
        </td>
144
 
        <td align="left">Half of the input that contain the most significant bit</td>
145
 
        <td align="left">Ignored</td>
146
 
      </tr>
147
 
      <tr>
148
 
        <td align="left">
149
 
          <emphasis role="bold">Lower Half</emphasis>
150
 
        </td>
151
 
        <td align="left">Half of the input that contain the least significant bit</td>
152
 
        <td align="left">Ignored</td>
153
 
      </tr>
154
 
      <tr>
155
 
        <td align="left">
156
 
          <emphasis role="bold">Range from MSB</emphasis>
157
 
        </td>
158
 
        <td align="left">
159
 
          <emphasis role="bold">Number of Bits or Index of Bit</emphasis> bits of the input that
160
 
          contain the most significant bit (MSB)
161
 
        </td>
162
 
        <td align="left">
163
 
          Number of bits to extract.
164
 
        </td>
165
 
      </tr>
166
 
      <tr>
167
 
        <td align="left">
168
 
          <emphasis role="bold">Range to LSB</emphasis>
169
 
        </td>
170
 
        <td align="left">
171
 
          <emphasis role="bold">Number of Bits or Index of Bit</emphasis> bits of the input that
172
 
          contain the least significant bit (LSB)
173
 
        </td>
174
 
        <td align="left">
175
 
          Number of bits to extract.
176
 
        </td>
177
 
      </tr>
178
 
      <tr>
179
 
        <td align="left">
180
 
          <emphasis role="bold">Range of bits</emphasis>
181
 
        </td>
182
 
        <td align="left">
183
 
          Range of bits of the input between the indexes of the bits <literal>Start</literal> and
184
 
          <literal>End</literal> of <emphasis role="bold">Number of Bits or Index of Bit</emphasis> parameter.
185
 
        </td>
186
 
        <td align="left">
187
 
          Vector with the format <literal>[Start, End]</literal> where <literal>start</literal>
188
 
          the first bit index and <literal>end</literal> the last bit index.
189
 
        </td>
190
 
      </tr>
191
 
    </informaltable>
192
 
    <para>
193
 
      The output value depends also on the forth parameter
194
 
      <emphasis role="bold">Treat Bit Field as an Integer</emphasis> :
195
 
    </para>
196
 
    <itemizedlist>
197
 
      <listitem>
198
 
        <para>
199
 
          <emphasis role="bold">0</emphasis> : the output is directly the result of extraction.
200
 
        </para>
201
 
        <para/>
202
 
      </listitem>
203
 
      <listitem>
204
 
        <para>
205
 
          <emphasis role="bold">1</emphasis> : the output is the integer conversion of the extraction
206
 
          result according to the signed or non-signed status of the input.
207
 
        </para>
208
 
      </listitem>
209
 
    </itemizedlist>
210
 
  </refsection>
211
 
  <refsection id="Data_Type_EXTRACTBITS">
212
 
    <title>Data types</title>
213
 
    <para>
214
 
      The block supports the following types :
215
 
    </para>
216
 
    <itemizedlist>
217
 
      <listitem>
218
 
        <para>
219
 
          Input : scalar. All Scilab's integer type (<emphasis role="bold">Data Type</emphasis> parameter).
220
 
        </para>
221
 
        <para/>
222
 
      </listitem>
223
 
      <listitem>
224
 
        <para>
225
 
          Output : same type than input.
226
 
        </para>
227
 
      </listitem>
228
 
    </itemizedlist>
229
 
  </refsection>
230
 
  <refsection id="Dialogbox_EXTRACTBITS">
231
 
    <title>Dialog box</title>
232
 
    <para>
233
 
      <inlinemediaobject>
234
 
        <imageobject>
235
 
          <imagedata fileref="../../../gui/integer_pal/en_US/EXTRACTBITS_gui.png" align="center" valign="middle"/>
236
 
        </imageobject>
237
 
      </inlinemediaobject>
238
 
    </para>
239
 
    <para/>
240
 
    <itemizedlist>
241
 
      <listitem>
242
 
        <para>
243
 
          <emphasis role="bold">Data Type (3:int32, 4:int16, 5:int8, ...)</emphasis>
244
 
        </para>
245
 
        <para>
246
 
          It indicates the integer type on input: Between 3 and 8.
247
 
        </para>
248
 
        <para> Properties : Type 'vec' of size 1. </para>
249
 
      </listitem>
250
 
      <listitem>
251
 
        <para>
252
 
          <emphasis role="bold">Bits to Extract</emphasis>
253
 
        </para>
254
 
        <para>
255
 
          It indicates the mode used to extract bits from the input data : Between 1 and 5 (1:Upper Half,
256
 
          2:Lower Half, 3:Range from MSB, 4:Range to LSB, 5:Range of bits)
257
 
        </para>
258
 
        <para> Properties : Type 'vec' of size 1. </para>
259
 
      </listitem>
260
 
      <listitem>
261
 
        <para>
262
 
          <emphasis role="bold">Number of Bits or Index of Bit</emphasis>
263
 
        </para>
264
 
        <para>
265
 
          When the <emphasis role="bold">Bits to Extract</emphasis> field is set to :
266
 
        </para>
267
 
        <itemizedlist>
268
 
          <listitem>
269
 
            <para>
270
 
              1 or 2, this parameter is ignored.
271
 
            </para>
272
 
          </listitem>
273
 
          <listitem>
274
 
            <para>
275
 
              3 or 4, this parameter is used to determine the number of bits to extract. This number
276
 
              must be if the type is :
277
 
            </para>
278
 
            <itemizedlist>
279
 
              <listitem>
280
 
                <para>
281
 
                  int32 or uint32:  positive and less than 32.
282
 
                </para>
283
 
              </listitem>
284
 
              <listitem>
285
 
                <para>
286
 
                  int16 or uint16: positive and less than 16.
287
 
                </para>
288
 
              </listitem>
289
 
              <listitem>
290
 
                <para>
291
 
                  int8 or uint8: positive and less than 8.
292
 
                </para>
293
 
              </listitem>
294
 
            </itemizedlist>
295
 
          </listitem>
296
 
          <listitem>
297
 
            <para>
298
 
              5, this parameter is used to determine range of bits to extract and it must have the <literal>[Start, End]</literal> form vector. <literal>Start</literal> must be less than <literal>End</literal>. 
299
 
              These values must be, if the type is:
300
 
            </para>
301
 
            <itemizedlist>
302
 
              <listitem>
303
 
                <para>
304
 
                  int32 or uint32:  positive and less than 32.
305
 
                </para>
306
 
              </listitem>
307
 
              <listitem>
308
 
                <para>
309
 
                  int16 or uint16: positive and less than 16.
310
 
                </para>
311
 
              </listitem>
312
 
              <listitem>
313
 
                <para>
314
 
                  int8 or uint8: positive and less than 8.
315
 
                </para>
316
 
              </listitem>
317
 
            </itemizedlist>
318
 
          </listitem>
319
 
        </itemizedlist>
320
 
        <para>See description for more information</para>
321
 
        <para> Properties : Type 'vec' of size -1. </para>
322
 
      </listitem>
323
 
      <listitem>
324
 
        <para>
325
 
          <emphasis role="bold">Treat Bit Field as an Integer (0:No, 1:Yes)</emphasis>
326
 
        </para>
327
 
        <para>
328
 
          0 or 1. It indicates the scaling mode to use on the output bits selection.
329
 
          See description for more explanation.
330
 
        </para>
331
 
        <para> Properties : Type 'vec' of size 1.</para>
332
 
      </listitem>
333
 
    </itemizedlist>
334
 
  </refsection>
335
 
  <refsection id="Defaultproperties_EXTRACTBITS">
336
 
    <title>Default properties</title>
337
 
    <itemizedlist>
338
 
      <listitem>
339
 
        <para>
340
 
          <emphasis role="bold">always active:</emphasis> no
341
 
        </para>
342
 
      </listitem>
343
 
      <listitem>
344
 
        <para>
345
 
          <emphasis role="bold">direct-feedthrough:</emphasis> yes
346
 
        </para>
347
 
      </listitem>
348
 
      <listitem>
349
 
        <para>
350
 
          <emphasis role="bold">zero-crossing:</emphasis> no
351
 
        </para>
352
 
      </listitem>
353
 
      <listitem>
354
 
        <para>
355
 
          <emphasis role="bold">mode:</emphasis> no
356
 
        </para>
357
 
      </listitem>
358
 
      <listitem>
359
 
        <para>
360
 
          <emphasis role="bold">regular inputs:</emphasis>
361
 
        </para>
362
 
        <para>
363
 
          <emphasis role="bold">- port 1 : size [1,1] / type 3</emphasis>
364
 
        </para>
365
 
      </listitem>
366
 
      <listitem>
367
 
        <para>
368
 
          <emphasis role="bold">regular outputs:</emphasis>
369
 
        </para>
370
 
        <para>
371
 
          <emphasis role="bold">- port 1 : size [1,1] / type 3</emphasis>
372
 
        </para>
373
 
      </listitem>
374
 
      <listitem>
375
 
        <para>
376
 
          <emphasis role="bold">number/sizes of activation inputs:</emphasis> 0
377
 
        </para>
378
 
      </listitem>
379
 
      <listitem>
380
 
        <para>
381
 
          <emphasis role="bold">number/sizes of activation outputs:</emphasis> 0
382
 
        </para>
383
 
      </listitem>
384
 
      <listitem>
385
 
        <para>
386
 
          <emphasis role="bold">continuous-time state:</emphasis> no
387
 
        </para>
388
 
      </listitem>
389
 
      <listitem>
390
 
        <para>
391
 
          <emphasis role="bold">discrete-time state:</emphasis> no
392
 
        </para>
393
 
      </listitem>
394
 
      <listitem>
395
 
        <para>
396
 
          <emphasis role="bold">object discrete-time state:</emphasis> no
397
 
        </para>
398
 
      </listitem>
399
 
      <listitem>
400
 
        <para>
401
 
          <emphasis role="bold">name of computational function:</emphasis>
402
 
          <emphasis role="italic">extract_bit_32_UH0</emphasis>
403
 
        </para>
404
 
      </listitem>
405
 
    </itemizedlist>
406
 
  </refsection>
407
 
  <refsection id="Example_EXTRACTBITS">
408
 
    <title>Example</title>
409
 
    <para>
410
 
      In the following table, we present the results obtained for the number 215 according to several
411
 
      combinations of the parameters.
412
 
    </para>
413
 
    <para/>
414
 
    <informaltable border="1" cellpadding="3">
415
 
      <tr>
416
 
        <td>
417
 
          <emphasis role="bold">Input</emphasis>
418
 
        </td>
419
 
        <td>
420
 
          <emphasis role="bold">Bits to Extract</emphasis>
421
 
        </td>
422
 
        <td>
423
 
          <emphasis role="bold">Number of Bits or Index of Bit</emphasis>
424
 
        </td>
425
 
        <td>
426
 
          <emphasis role="bold">Treat Bit Field as an Integer</emphasis>
427
 
        </td>
428
 
        <td>
429
 
          <emphasis role="bold">Output</emphasis>
430
 
        </td>
431
 
      </tr>
432
 
      <tr>
433
 
        <td>11010111 (215)</td>
434
 
        <td>Upper Half</td>
435
 
        <td>Ignored</td>
436
 
        <td>no</td>
437
 
        <td>01100000 (208)</td>
438
 
      </tr>
439
 
      <tr>
440
 
        <td>11010111 (215)</td>
441
 
        <td>Upper Half</td>
442
 
        <td>Ignored</td>
443
 
        <td>yes</td>
444
 
        <td>00001101 (13)</td>
445
 
      </tr>
446
 
      <tr>
447
 
        <td>11010111 (215)</td>
448
 
        <td>Lower Half</td>
449
 
        <td>Ignored</td>
450
 
        <td>no</td>
451
 
        <td>00000111 (7)</td>
452
 
      </tr>
453
 
      <tr>
454
 
        <td>11010111 (215)</td>
455
 
        <td>Lower Half</td>
456
 
        <td>Ignored</td>
457
 
        <td>yes</td>
458
 
        <td>00000111 (7)</td>
459
 
      </tr>
460
 
      <tr>
461
 
        <td>11010111 (215)</td>
462
 
        <td>Range starting with MSB</td>
463
 
        <td>6</td>
464
 
        <td>no</td>
465
 
        <td>11010100 (212)</td>
466
 
      </tr>
467
 
      <tr>
468
 
        <td>11010111 (215)</td>
469
 
        <td>Range starting with MSB</td>
470
 
        <td>6</td>
471
 
        <td>yes</td>
472
 
        <td>00110101 (53)</td>
473
 
      </tr>
474
 
      <tr>
475
 
        <td>11010111 (215)</td>
476
 
        <td>Range starting with LSB</td>
477
 
        <td>6</td>
478
 
        <td>no</td>
479
 
        <td>00010111 (23)</td>
480
 
      </tr>
481
 
      <tr>
482
 
        <td>11010111 (215)</td>
483
 
        <td>Range starting with LSB</td>
484
 
        <td>6</td>
485
 
        <td>yes</td>
486
 
        <td>00010111 (23)</td>
487
 
      </tr>
488
 
      <tr>
489
 
        <td>11010111 (215)</td>
490
 
        <td>Range of bits</td>
491
 
        <td>[ 2, 5 ]</td>
492
 
        <td>no</td>
493
 
        <td>00010100 (20)</td>
494
 
      </tr>
495
 
      <tr>
496
 
        <td>11010111 (215)</td>
497
 
        <td>Range of bits</td>
498
 
        <td>[ 2, 5 ]</td>
499
 
        <td>yes</td>
500
 
        <td>00000101 (5)</td>
501
 
      </tr>
502
 
      <tr>
503
 
        <td>11010111 (-41)</td>
504
 
        <td>Upper half</td>
505
 
        <td>Ignored</td>
506
 
        <td>no</td>
507
 
        <td>11010000 (-48)</td>
508
 
      </tr>
509
 
      <tr>
510
 
        <td>11010111 (-48)</td>
511
 
        <td>Upper half</td>
512
 
        <td>Ingnored</td>
513
 
        <td>yes</td>
514
 
        <td>11111101 (-3)</td>
515
 
      </tr>
516
 
    </informaltable>
517
 
    <para>
518
 
      In the  following diagram, two decimal digit numbers are coded on an only byte.
519
 
      The diagram decode the input to obtain two separate digits.
520
 
      <link type="scilab" linkend="scilab.xcos/xcos/examples/integer_pal/en_US/EXTRACTBITS_en_US.xcos">
521
 
        Open this example in Xcos
522
 
      </link>
523
 
    </para>
524
 
    <para/>
525
 
    <mediaobject>
526
 
      <imageobject>
527
 
        <imagedata align="center" fileref="../../../examples/integer_pal/en_US/extractbits_diagram_en_US.png"/>
528
 
      </imageobject>
529
 
    </mediaobject>
530
 
  </refsection>
531
 
  <refsection id="Interfacingfunction_EXTRACTBITS">
532
 
    <title>Interfacing function</title>
533
 
    <itemizedlist>
534
 
      <listitem>
535
 
        <para>
536
 
          <link type="scilab" linkend="scilab.scinotes/scicos_blocks/macros/IntegerOp/EXTRACTBITS.sci">SCI/modules/scicos_blocks/macros/IntegerOp/EXTRACTBITS.sci</link>
537
 
        </para>
538
 
      </listitem>
539
 
    </itemizedlist>
540
 
  </refsection>
541
 
  <refsection id="Computationalfunction_EXTRACTBITS">
542
 
    <title>Computational function</title>
543
 
    <itemizedlist>
544
 
      <listitem>
545
 
        <para> SCI/modules/scicos_blocks/src/c/extract_bit_32_UH0.c</para>
546
 
      </listitem>
547
 
      <listitem>
548
 
        <para> SCI/modules/scicos_blocks/src/c/extract_bit_32_UH1.c</para>
549
 
      </listitem>
550
 
      <listitem>
551
 
        <para> SCI/modules/scicos_blocks/src/c/extract_bit_u32_UH1.c</para>
552
 
      </listitem>
553
 
      <listitem>
554
 
        <para> SCI/modules/scicos_blocks/src/c/extract_bit_32_LH.c</para>
555
 
      </listitem>
556
 
      <listitem>
557
 
        <para> SCI/modules/scicos_blocks/src/c/extract_bit_32_MSB0.c</para>
558
 
      </listitem>
559
 
      <listitem>
560
 
        <para> SCI/modules/scicos_blocks/src/c/extract_bit_32_MSB1.c</para>
561
 
      </listitem>
562
 
      <listitem>
563
 
        <para> SCI/modules/scicos_blocks/src/c/extract_bit_u32_MSB1.c</para>
564
 
      </listitem>
565
 
      <listitem>
566
 
        <para> SCI/modules/scicos_blocks/src/c/extract_bit_32_LSB.c</para>
567
 
      </listitem>
568
 
      <listitem>
569
 
        <para> SCI/modules/scicos_blocks/src/c/extract_bit_32_RB0.c</para>
570
 
      </listitem>
571
 
      <listitem>
572
 
        <para> SCI/modules/scicos_blocks/src/c/extract_bit_32_RB1.c</para>
573
 
      </listitem>
574
 
      <listitem>
575
 
        <para> SCI/modules/scicos_blocks/src/c/extract_bit_u32_RB1.c</para>
576
 
      </listitem>
577
 
      <listitem>
578
 
        <para> SCI/modules/scicos_blocks/src/c/extract_bit_16_UH0.c</para>
579
 
      </listitem>
580
 
      <listitem>
581
 
        <para> SCI/modules/scicos_blocks/src/c/extract_bit_16_UH1.c</para>
582
 
      </listitem>
583
 
      <listitem>
584
 
        <para> SCI/modules/scicos_blocks/src/c/extract_bit_u16_UH1.c</para>
585
 
      </listitem>
586
 
      <listitem>
587
 
        <para> SCI/modules/scicos_blocks/src/c/extract_bit_16_LH.c</para>
588
 
      </listitem>
589
 
      <listitem>
590
 
        <para> SCI/modules/scicos_blocks/src/c/extract_bit_16_MSB0.c</para>
591
 
      </listitem>
592
 
      <listitem>
593
 
        <para> SCI/modules/scicos_blocks/src/c/extract_bit_16_MSB1.c</para>
594
 
      </listitem>
595
 
      <listitem>
596
 
        <para> SCI/modules/scicos_blocks/src/c/extract_bit_u16_MSB1.c</para>
597
 
      </listitem>
598
 
      <listitem>
599
 
        <para> SCI/modules/scicos_blocks/src/c/extract_bit_16_LSB.c</para>
600
 
      </listitem>
601
 
      <listitem>
602
 
        <para> SCI/modules/scicos_blocks/src/c/extract_bit_16_RB0.c</para>
603
 
      </listitem>
604
 
      <listitem>
605
 
        <para> SCI/modules/scicos_blocks/src/c/extract_bit_16_RB1.c</para>
606
 
      </listitem>
607
 
      <listitem>
608
 
        <para> SCI/modules/scicos_blocks/src/c/extract_bit_u16_RB1.c</para>
609
 
      </listitem>
610
 
      <listitem>
611
 
        <para> SCI/modules/scicos_blocks/src/c/extract_bit_8_UH0.c</para>
612
 
      </listitem>
613
 
      <listitem>
614
 
        <para> SCI/modules/scicos_blocks/src/c/extract_bit_8_UH1.c</para>
615
 
      </listitem>
616
 
      <listitem>
617
 
        <para> SCI/modules/scicos_blocks/src/c/extract_bit_u8_UH1.c</para>
618
 
      </listitem>
619
 
      <listitem>
620
 
        <para> SCI/modules/scicos_blocks/src/c/extract_bit_8_LH.c</para>
621
 
      </listitem>
622
 
      <listitem>
623
 
        <para> SCI/modules/scicos_blocks/src/c/extract_bit_8_MSB0.c</para>
624
 
      </listitem>
625
 
      <listitem>
626
 
        <para> SCI/modules/scicos_blocks/src/c/extract_bit_8_MSB1.c</para>
627
 
      </listitem>
628
 
      <listitem>
629
 
        <para> SCI/modules/scicos_blocks/src/c/extract_bit_u8_MSB1.c</para>
630
 
      </listitem>
631
 
      <listitem>
632
 
        <para> SCI/modules/scicos_blocks/src/c/extract_bit_8_LSB.c</para>
633
 
      </listitem>
634
 
      <listitem>
635
 
        <para> SCI/modules/scicos_blocks/src/c/extract_bit_8_RB0.c</para>
636
 
      </listitem>
637
 
      <listitem>
638
 
        <para> SCI/modules/scicos_blocks/src/c/extract_bit_8_RB1.c</para>
639
 
      </listitem>
640
 
      <listitem>
641
 
        <para> SCI/modules/scicos_blocks/src/c/extract_bit_u8_RB1.c</para>
642
 
      </listitem>
643
 
    </itemizedlist>
644
 
  </refsection>
645
 
  <refsection role="see also" id="Seealso_EXTRACTBITS">
646
 
    <title>See also</title>
647
 
    <itemizedlist>
648
 
      <listitem>
649
 
        <link linkend="BITSET">BITSET</link>
650
 
      </listitem>
651
 
      <listitem>
652
 
        <link linkend="BITCLEAR">BITCLEAR</link>
653
 
      </listitem>
654
 
      <listitem>
655
 
        <link linkend="LOGICAL_OP">LOGICAL_OP</link>
656
 
      </listitem>
657
 
    </itemizedlist>
658
 
  </refsection>
 
27
    <refnamediv>
 
28
        <refname>EXTRACTBITS</refname>
 
29
        <refpurpose>Bits Extraction</refpurpose>
 
30
    </refnamediv>
 
31
    <refsection>
 
32
        <title>Block Screenshot</title>
 
33
        <para>
 
34
            <inlinemediaobject>
 
35
                <imageobject>
 
36
                    <imagedata fileref="../../../../images/palettes/EXTRACTBITS.png" align="center" valign="middle"/>
 
37
                </imageobject>
 
38
            </inlinemediaobject>
 
39
        </para>
 
40
    </refsection>
 
41
    <refsection id="Contents_EXTRACTBITS">
 
42
        <title>Contents</title>
 
43
        <itemizedlist>
 
44
            <listitem>
 
45
                <para>
 
46
                    <link linkend="EXTRACTBITS">Bits extraction </link>
 
47
                </para>
 
48
            </listitem>
 
49
            <listitem>
 
50
                <itemizedlist>
 
51
                    <listitem>
 
52
                        <para>
 
53
                            <xref linkend="Palette_EXTRACTBITS">Palette</xref>
 
54
                        </para>
 
55
                    </listitem>
 
56
                    <listitem>
 
57
                        <para>
 
58
                            <xref linkend="Description_EXTRACTBITS">Description</xref>
 
59
                        </para>
 
60
                    </listitem>
 
61
                    <listitem>
 
62
                        <para>
 
63
                            <xref linkend="Data_Type_BITCLEAR">Data types</xref>
 
64
                        </para>
 
65
                    </listitem>
 
66
                    <listitem>
 
67
                        <para>
 
68
                            <xref linkend="Dialogbox_EXTRACTBITS">Dialog box</xref>
 
69
                        </para>
 
70
                    </listitem>
 
71
                    <listitem>
 
72
                        <para>
 
73
                            <xref linkend="Defaultproperties_EXTRACTBITS">Default properties</xref>
 
74
                        </para>
 
75
                    </listitem>
 
76
                    <listitem>
 
77
                        <para>
 
78
                            <xref linkend="Example_EXTRACTBITS">Example</xref>
 
79
                        </para>
 
80
                    </listitem>
 
81
                    <listitem>
 
82
                        <para>
 
83
                            <xref linkend="Interfacingfunction_EXTRACTBITS">Interfacing function</xref>
 
84
                        </para>
 
85
                    </listitem>
 
86
                    <listitem>
 
87
                        <para>
 
88
                            <xref linkend="Computationalfunction_EXTRACTBITS">Computational function</xref>
 
89
                        </para>
 
90
                    </listitem>
 
91
                    <listitem>
 
92
                        <para>
 
93
                            <xref linkend="Seealso_EXTRACTBITS">See also</xref>
 
94
                        </para>
 
95
                    </listitem>
 
96
                </itemizedlist>
 
97
            </listitem>
 
98
        </itemizedlist>
 
99
    </refsection>
 
100
    <refsection id="Palette_EXTRACTBITS">
 
101
        <title>Palette</title>
 
102
        <itemizedlist>
 
103
            <listitem>
 
104
                <para>
 
105
                    <link linkend="Integer_pal">Integer palette</link>
 
106
                </para>
 
107
            </listitem>
 
108
        </itemizedlist>
 
109
    </refsection>
 
110
    <refsection id="Description_EXTRACTBITS">
 
111
        <title>Description</title>
 
112
        <para>
 
113
            For an integer input this block outputs a contiguous selection of bits. The operation can be
 
114
            summarized by this expression:
 
115
        </para>
 
116
        <para>
 
117
            <latex><![CDATA[ Output=Input \wedge Mask]]></latex>
 
118
        </para>
 
119
        <para>
 
120
            i.e. a bitwise <literal>AND</literal> between <literal>Input</literal> and
 
121
            <literal>Mask</literal> an integer of the same length as input with the bits to extract
 
122
            set to <literal>1</literal> and the other bits set to <literal>0</literal>.
 
123
            <emphasis role="bold">Bits to Extract</emphasis> parameter defines the method by which the
 
124
            user selects the output bits as summarized by the following table with index
 
125
            <literal>0</literal>, as that of the least significant bit :
 
126
        </para>
 
127
        <para/>
 
128
        <informaltable border="1" cellpadding="2">
 
129
            <tr>
 
130
                <td align="left">
 
131
                    <emphasis role="bold">Bits to Extract</emphasis>
 
132
                </td>
 
133
                <td align="left">
 
134
                    <emphasis role="bold">Output</emphasis>
 
135
                </td>
 
136
                <td align="left">
 
137
                    <emphasis role="bold">Number of Bits or Index of Bit</emphasis>
 
138
                </td>
 
139
            </tr>
 
140
            <tr>
 
141
                <td align="left">
 
142
                    <emphasis role="bold">Upper Half</emphasis>
 
143
                </td>
 
144
                <td align="left">Half of the input that contain the most significant bit</td>
 
145
                <td align="left">Ignored</td>
 
146
            </tr>
 
147
            <tr>
 
148
                <td align="left">
 
149
                    <emphasis role="bold">Lower Half</emphasis>
 
150
                </td>
 
151
                <td align="left">Half of the input that contain the least significant bit</td>
 
152
                <td align="left">Ignored</td>
 
153
            </tr>
 
154
            <tr>
 
155
                <td align="left">
 
156
                    <emphasis role="bold">Range from MSB</emphasis>
 
157
                </td>
 
158
                <td align="left">
 
159
                    <emphasis role="bold">Number of Bits or Index of Bit</emphasis> bits of the input that
 
160
                    contain the most significant bit (MSB)
 
161
                </td>
 
162
                <td align="left">
 
163
                    Number of bits to extract.
 
164
                </td>
 
165
            </tr>
 
166
            <tr>
 
167
                <td align="left">
 
168
                    <emphasis role="bold">Range to LSB</emphasis>
 
169
                </td>
 
170
                <td align="left">
 
171
                    <emphasis role="bold">Number of Bits or Index of Bit</emphasis> bits of the input that
 
172
                    contain the least significant bit (LSB)
 
173
                </td>
 
174
                <td align="left">
 
175
                    Number of bits to extract.
 
176
                </td>
 
177
            </tr>
 
178
            <tr>
 
179
                <td align="left">
 
180
                    <emphasis role="bold">Range of bits</emphasis>
 
181
                </td>
 
182
                <td align="left">
 
183
                    Range of bits of the input between the indexes of the bits <literal>Start</literal> and
 
184
                    <literal>End</literal> of <emphasis role="bold">Number of Bits or Index of Bit</emphasis> parameter.
 
185
                </td>
 
186
                <td align="left">
 
187
                    Vector with the format <literal>[Start, End]</literal> where <literal>start</literal>
 
188
                    the first bit index and <literal>end</literal> the last bit index.
 
189
                </td>
 
190
            </tr>
 
191
        </informaltable>
 
192
        <para>
 
193
            The output value depends also on the forth parameter
 
194
            <emphasis role="bold">Treat Bit Field as an Integer</emphasis> :
 
195
        </para>
 
196
        <itemizedlist>
 
197
            <listitem>
 
198
                <para>
 
199
                    <emphasis role="bold">0</emphasis> : the output is directly the result of extraction.
 
200
                </para>
 
201
                <para/>
 
202
            </listitem>
 
203
            <listitem>
 
204
                <para>
 
205
                    <emphasis role="bold">1</emphasis> : the output is the integer conversion of the extraction
 
206
                    result according to the signed or non-signed status of the input.
 
207
                </para>
 
208
            </listitem>
 
209
        </itemizedlist>
 
210
    </refsection>
 
211
    <refsection id="Data_Type_EXTRACTBITS">
 
212
        <title>Data types</title>
 
213
        <para>
 
214
            The block supports the following types :
 
215
        </para>
 
216
        <itemizedlist>
 
217
            <listitem>
 
218
                <para>
 
219
                    Input : scalar. All Scilab's integer type (<emphasis role="bold">Data Type</emphasis> parameter).
 
220
                </para>
 
221
                <para/>
 
222
            </listitem>
 
223
            <listitem>
 
224
                <para>
 
225
                    Output : same type than input.
 
226
                </para>
 
227
            </listitem>
 
228
        </itemizedlist>
 
229
    </refsection>
 
230
    <refsection id="Dialogbox_EXTRACTBITS">
 
231
        <title>Dialog box</title>
 
232
        <para>
 
233
            <inlinemediaobject>
 
234
                <imageobject>
 
235
                    <imagedata fileref="../../../gui/integer_pal/en_US/EXTRACTBITS_gui.png" align="center" valign="middle"/>
 
236
                </imageobject>
 
237
            </inlinemediaobject>
 
238
        </para>
 
239
        <para/>
 
240
        <itemizedlist>
 
241
            <listitem>
 
242
                <para>
 
243
                    <emphasis role="bold">Data Type (3:int32, 4:int16, 5:int8, ...)</emphasis>
 
244
                </para>
 
245
                <para>
 
246
                    It indicates the integer type on input: Between 3 and 8.
 
247
                </para>
 
248
                <para> Properties : Type 'vec' of size 1. </para>
 
249
            </listitem>
 
250
            <listitem>
 
251
                <para>
 
252
                    <emphasis role="bold">Bits to Extract</emphasis>
 
253
                </para>
 
254
                <para>
 
255
                    It indicates the mode used to extract bits from the input data : Between 1 and 5 (1:Upper Half,
 
256
                    2:Lower Half, 3:Range from MSB, 4:Range to LSB, 5:Range of bits)
 
257
                </para>
 
258
                <para> Properties : Type 'vec' of size 1. </para>
 
259
            </listitem>
 
260
            <listitem>
 
261
                <para>
 
262
                    <emphasis role="bold">Number of Bits or Index of Bit</emphasis>
 
263
                </para>
 
264
                <para>
 
265
                    When the <emphasis role="bold">Bits to Extract</emphasis> field is set to :
 
266
                </para>
 
267
                <itemizedlist>
 
268
                    <listitem>
 
269
                        <para>
 
270
                            1 or 2, this parameter is ignored.
 
271
                        </para>
 
272
                    </listitem>
 
273
                    <listitem>
 
274
                        <para>
 
275
                            3 or 4, this parameter is used to determine the number of bits to extract. This number
 
276
                            must be if the type is :
 
277
                        </para>
 
278
                        <itemizedlist>
 
279
                            <listitem>
 
280
                                <para>
 
281
                                    int32 or uint32:  positive and less than 32.
 
282
                                </para>
 
283
                            </listitem>
 
284
                            <listitem>
 
285
                                <para>
 
286
                                    int16 or uint16: positive and less than 16.
 
287
                                </para>
 
288
                            </listitem>
 
289
                            <listitem>
 
290
                                <para>
 
291
                                    int8 or uint8: positive and less than 8.
 
292
                                </para>
 
293
                            </listitem>
 
294
                        </itemizedlist>
 
295
                    </listitem>
 
296
                    <listitem>
 
297
                        <para>
 
298
                            5, this parameter is used to determine range of bits to extract and it must have the <literal>[Start, End]</literal> form vector. <literal>Start</literal> must be less than <literal>End</literal>. 
 
299
                            These values must be, if the type is:
 
300
                        </para>
 
301
                        <itemizedlist>
 
302
                            <listitem>
 
303
                                <para>
 
304
                                    int32 or uint32:  positive and less than 32.
 
305
                                </para>
 
306
                            </listitem>
 
307
                            <listitem>
 
308
                                <para>
 
309
                                    int16 or uint16: positive and less than 16.
 
310
                                </para>
 
311
                            </listitem>
 
312
                            <listitem>
 
313
                                <para>
 
314
                                    int8 or uint8: positive and less than 8.
 
315
                                </para>
 
316
                            </listitem>
 
317
                        </itemizedlist>
 
318
                    </listitem>
 
319
                </itemizedlist>
 
320
                <para>See description for more information</para>
 
321
                <para> Properties : Type 'vec' of size -1. </para>
 
322
            </listitem>
 
323
            <listitem>
 
324
                <para>
 
325
                    <emphasis role="bold">Treat Bit Field as an Integer (0:No, 1:Yes)</emphasis>
 
326
                </para>
 
327
                <para>
 
328
                    0 or 1. It indicates the scaling mode to use on the output bits selection.
 
329
                    See description for more explanation.
 
330
                </para>
 
331
                <para> Properties : Type 'vec' of size 1.</para>
 
332
            </listitem>
 
333
        </itemizedlist>
 
334
    </refsection>
 
335
    <refsection id="Defaultproperties_EXTRACTBITS">
 
336
        <title>Default properties</title>
 
337
        <itemizedlist>
 
338
            <listitem>
 
339
                <para>
 
340
                    <emphasis role="bold">always active:</emphasis> no
 
341
                </para>
 
342
            </listitem>
 
343
            <listitem>
 
344
                <para>
 
345
                    <emphasis role="bold">direct-feedthrough:</emphasis> yes
 
346
                </para>
 
347
            </listitem>
 
348
            <listitem>
 
349
                <para>
 
350
                    <emphasis role="bold">zero-crossing:</emphasis> no
 
351
                </para>
 
352
            </listitem>
 
353
            <listitem>
 
354
                <para>
 
355
                    <emphasis role="bold">mode:</emphasis> no
 
356
                </para>
 
357
            </listitem>
 
358
            <listitem>
 
359
                <para>
 
360
                    <emphasis role="bold">regular inputs:</emphasis>
 
361
                </para>
 
362
                <para>
 
363
                    <emphasis role="bold">- port 1 : size [1,1] / type 3</emphasis>
 
364
                </para>
 
365
            </listitem>
 
366
            <listitem>
 
367
                <para>
 
368
                    <emphasis role="bold">regular outputs:</emphasis>
 
369
                </para>
 
370
                <para>
 
371
                    <emphasis role="bold">- port 1 : size [1,1] / type 3</emphasis>
 
372
                </para>
 
373
            </listitem>
 
374
            <listitem>
 
375
                <para>
 
376
                    <emphasis role="bold">number/sizes of activation inputs:</emphasis> 0
 
377
                </para>
 
378
            </listitem>
 
379
            <listitem>
 
380
                <para>
 
381
                    <emphasis role="bold">number/sizes of activation outputs:</emphasis> 0
 
382
                </para>
 
383
            </listitem>
 
384
            <listitem>
 
385
                <para>
 
386
                    <emphasis role="bold">continuous-time state:</emphasis> no
 
387
                </para>
 
388
            </listitem>
 
389
            <listitem>
 
390
                <para>
 
391
                    <emphasis role="bold">discrete-time state:</emphasis> no
 
392
                </para>
 
393
            </listitem>
 
394
            <listitem>
 
395
                <para>
 
396
                    <emphasis role="bold">object discrete-time state:</emphasis> no
 
397
                </para>
 
398
            </listitem>
 
399
            <listitem>
 
400
                <para>
 
401
                    <emphasis role="bold">name of computational function:</emphasis>
 
402
                    <emphasis role="italic">extract_bit_32_UH0</emphasis>
 
403
                </para>
 
404
            </listitem>
 
405
        </itemizedlist>
 
406
    </refsection>
 
407
    <refsection id="Example_EXTRACTBITS">
 
408
        <title>Example</title>
 
409
        <para>
 
410
            In the following table, we present the results obtained for the number 215 according to several
 
411
            combinations of the parameters.
 
412
        </para>
 
413
        <para/>
 
414
        <informaltable border="1" cellpadding="3">
 
415
            <tr>
 
416
                <td>
 
417
                    <emphasis role="bold">Input</emphasis>
 
418
                </td>
 
419
                <td>
 
420
                    <emphasis role="bold">Bits to Extract</emphasis>
 
421
                </td>
 
422
                <td>
 
423
                    <emphasis role="bold">Number of Bits or Index of Bit</emphasis>
 
424
                </td>
 
425
                <td>
 
426
                    <emphasis role="bold">Treat Bit Field as an Integer</emphasis>
 
427
                </td>
 
428
                <td>
 
429
                    <emphasis role="bold">Output</emphasis>
 
430
                </td>
 
431
            </tr>
 
432
            <tr>
 
433
                <td>11010111 (215)</td>
 
434
                <td>Upper Half</td>
 
435
                <td>Ignored</td>
 
436
                <td>no</td>
 
437
                <td>01100000 (208)</td>
 
438
            </tr>
 
439
            <tr>
 
440
                <td>11010111 (215)</td>
 
441
                <td>Upper Half</td>
 
442
                <td>Ignored</td>
 
443
                <td>yes</td>
 
444
                <td>00001101 (13)</td>
 
445
            </tr>
 
446
            <tr>
 
447
                <td>11010111 (215)</td>
 
448
                <td>Lower Half</td>
 
449
                <td>Ignored</td>
 
450
                <td>no</td>
 
451
                <td>00000111 (7)</td>
 
452
            </tr>
 
453
            <tr>
 
454
                <td>11010111 (215)</td>
 
455
                <td>Lower Half</td>
 
456
                <td>Ignored</td>
 
457
                <td>yes</td>
 
458
                <td>00000111 (7)</td>
 
459
            </tr>
 
460
            <tr>
 
461
                <td>11010111 (215)</td>
 
462
                <td>Range starting with MSB</td>
 
463
                <td>6</td>
 
464
                <td>no</td>
 
465
                <td>11010100 (212)</td>
 
466
            </tr>
 
467
            <tr>
 
468
                <td>11010111 (215)</td>
 
469
                <td>Range starting with MSB</td>
 
470
                <td>6</td>
 
471
                <td>yes</td>
 
472
                <td>00110101 (53)</td>
 
473
            </tr>
 
474
            <tr>
 
475
                <td>11010111 (215)</td>
 
476
                <td>Range starting with LSB</td>
 
477
                <td>6</td>
 
478
                <td>no</td>
 
479
                <td>00010111 (23)</td>
 
480
            </tr>
 
481
            <tr>
 
482
                <td>11010111 (215)</td>
 
483
                <td>Range starting with LSB</td>
 
484
                <td>6</td>
 
485
                <td>yes</td>
 
486
                <td>00010111 (23)</td>
 
487
            </tr>
 
488
            <tr>
 
489
                <td>11010111 (215)</td>
 
490
                <td>Range of bits</td>
 
491
                <td>[ 2, 5 ]</td>
 
492
                <td>no</td>
 
493
                <td>00010100 (20)</td>
 
494
            </tr>
 
495
            <tr>
 
496
                <td>11010111 (215)</td>
 
497
                <td>Range of bits</td>
 
498
                <td>[ 2, 5 ]</td>
 
499
                <td>yes</td>
 
500
                <td>00000101 (5)</td>
 
501
            </tr>
 
502
            <tr>
 
503
                <td>11010111 (-41)</td>
 
504
                <td>Upper half</td>
 
505
                <td>Ignored</td>
 
506
                <td>no</td>
 
507
                <td>11010000 (-48)</td>
 
508
            </tr>
 
509
            <tr>
 
510
                <td>11010111 (-48)</td>
 
511
                <td>Upper half</td>
 
512
                <td>Ingnored</td>
 
513
                <td>yes</td>
 
514
                <td>11111101 (-3)</td>
 
515
            </tr>
 
516
        </informaltable>
 
517
        <para>
 
518
            In the  following diagram, two decimal digit numbers are coded on an only byte.
 
519
            The diagram decode the input to obtain two separate digits.
 
520
            <link type="scilab" linkend="scilab.xcos/xcos/examples/integer_pal/en_US/EXTRACTBITS_en_US.xcos">
 
521
                Open this example in Xcos
 
522
            </link>
 
523
        </para>
 
524
        <para/>
 
525
        <mediaobject>
 
526
            <imageobject>
 
527
                <imagedata align="center" fileref="../../../examples/integer_pal/en_US/extractbits_diagram_en_US.png"/>
 
528
            </imageobject>
 
529
        </mediaobject>
 
530
    </refsection>
 
531
    <refsection id="Interfacingfunction_EXTRACTBITS">
 
532
        <title>Interfacing function</title>
 
533
        <itemizedlist>
 
534
            <listitem>
 
535
                <para>
 
536
                    <link type="scilab" linkend="scilab.scinotes/scicos_blocks/macros/IntegerOp/EXTRACTBITS.sci">SCI/modules/scicos_blocks/macros/IntegerOp/EXTRACTBITS.sci</link>
 
537
                </para>
 
538
            </listitem>
 
539
        </itemizedlist>
 
540
    </refsection>
 
541
    <refsection id="Computationalfunction_EXTRACTBITS">
 
542
        <title>Computational function</title>
 
543
        <itemizedlist>
 
544
            <listitem>
 
545
                <para> SCI/modules/scicos_blocks/src/c/extract_bit_32_UH0.c</para>
 
546
            </listitem>
 
547
            <listitem>
 
548
                <para> SCI/modules/scicos_blocks/src/c/extract_bit_32_UH1.c</para>
 
549
            </listitem>
 
550
            <listitem>
 
551
                <para> SCI/modules/scicos_blocks/src/c/extract_bit_u32_UH1.c</para>
 
552
            </listitem>
 
553
            <listitem>
 
554
                <para> SCI/modules/scicos_blocks/src/c/extract_bit_32_LH.c</para>
 
555
            </listitem>
 
556
            <listitem>
 
557
                <para> SCI/modules/scicos_blocks/src/c/extract_bit_32_MSB0.c</para>
 
558
            </listitem>
 
559
            <listitem>
 
560
                <para> SCI/modules/scicos_blocks/src/c/extract_bit_32_MSB1.c</para>
 
561
            </listitem>
 
562
            <listitem>
 
563
                <para> SCI/modules/scicos_blocks/src/c/extract_bit_u32_MSB1.c</para>
 
564
            </listitem>
 
565
            <listitem>
 
566
                <para> SCI/modules/scicos_blocks/src/c/extract_bit_32_LSB.c</para>
 
567
            </listitem>
 
568
            <listitem>
 
569
                <para> SCI/modules/scicos_blocks/src/c/extract_bit_32_RB0.c</para>
 
570
            </listitem>
 
571
            <listitem>
 
572
                <para> SCI/modules/scicos_blocks/src/c/extract_bit_32_RB1.c</para>
 
573
            </listitem>
 
574
            <listitem>
 
575
                <para> SCI/modules/scicos_blocks/src/c/extract_bit_u32_RB1.c</para>
 
576
            </listitem>
 
577
            <listitem>
 
578
                <para> SCI/modules/scicos_blocks/src/c/extract_bit_16_UH0.c</para>
 
579
            </listitem>
 
580
            <listitem>
 
581
                <para> SCI/modules/scicos_blocks/src/c/extract_bit_16_UH1.c</para>
 
582
            </listitem>
 
583
            <listitem>
 
584
                <para> SCI/modules/scicos_blocks/src/c/extract_bit_u16_UH1.c</para>
 
585
            </listitem>
 
586
            <listitem>
 
587
                <para> SCI/modules/scicos_blocks/src/c/extract_bit_16_LH.c</para>
 
588
            </listitem>
 
589
            <listitem>
 
590
                <para> SCI/modules/scicos_blocks/src/c/extract_bit_16_MSB0.c</para>
 
591
            </listitem>
 
592
            <listitem>
 
593
                <para> SCI/modules/scicos_blocks/src/c/extract_bit_16_MSB1.c</para>
 
594
            </listitem>
 
595
            <listitem>
 
596
                <para> SCI/modules/scicos_blocks/src/c/extract_bit_u16_MSB1.c</para>
 
597
            </listitem>
 
598
            <listitem>
 
599
                <para> SCI/modules/scicos_blocks/src/c/extract_bit_16_LSB.c</para>
 
600
            </listitem>
 
601
            <listitem>
 
602
                <para> SCI/modules/scicos_blocks/src/c/extract_bit_16_RB0.c</para>
 
603
            </listitem>
 
604
            <listitem>
 
605
                <para> SCI/modules/scicos_blocks/src/c/extract_bit_16_RB1.c</para>
 
606
            </listitem>
 
607
            <listitem>
 
608
                <para> SCI/modules/scicos_blocks/src/c/extract_bit_u16_RB1.c</para>
 
609
            </listitem>
 
610
            <listitem>
 
611
                <para> SCI/modules/scicos_blocks/src/c/extract_bit_8_UH0.c</para>
 
612
            </listitem>
 
613
            <listitem>
 
614
                <para> SCI/modules/scicos_blocks/src/c/extract_bit_8_UH1.c</para>
 
615
            </listitem>
 
616
            <listitem>
 
617
                <para> SCI/modules/scicos_blocks/src/c/extract_bit_u8_UH1.c</para>
 
618
            </listitem>
 
619
            <listitem>
 
620
                <para> SCI/modules/scicos_blocks/src/c/extract_bit_8_LH.c</para>
 
621
            </listitem>
 
622
            <listitem>
 
623
                <para> SCI/modules/scicos_blocks/src/c/extract_bit_8_MSB0.c</para>
 
624
            </listitem>
 
625
            <listitem>
 
626
                <para> SCI/modules/scicos_blocks/src/c/extract_bit_8_MSB1.c</para>
 
627
            </listitem>
 
628
            <listitem>
 
629
                <para> SCI/modules/scicos_blocks/src/c/extract_bit_u8_MSB1.c</para>
 
630
            </listitem>
 
631
            <listitem>
 
632
                <para> SCI/modules/scicos_blocks/src/c/extract_bit_8_LSB.c</para>
 
633
            </listitem>
 
634
            <listitem>
 
635
                <para> SCI/modules/scicos_blocks/src/c/extract_bit_8_RB0.c</para>
 
636
            </listitem>
 
637
            <listitem>
 
638
                <para> SCI/modules/scicos_blocks/src/c/extract_bit_8_RB1.c</para>
 
639
            </listitem>
 
640
            <listitem>
 
641
                <para> SCI/modules/scicos_blocks/src/c/extract_bit_u8_RB1.c</para>
 
642
            </listitem>
 
643
        </itemizedlist>
 
644
    </refsection>
 
645
    <refsection role="see also" id="Seealso_EXTRACTBITS">
 
646
        <title>See also</title>
 
647
        <itemizedlist>
 
648
            <listitem>
 
649
                <link linkend="BITSET">BITSET</link>
 
650
            </listitem>
 
651
            <listitem>
 
652
                <link linkend="BITCLEAR">BITCLEAR</link>
 
653
            </listitem>
 
654
            <listitem>
 
655
                <link linkend="LOGICAL_OP">LOGICAL_OP</link>
 
656
            </listitem>
 
657
        </itemizedlist>
 
658
    </refsection>
659
659
</refentry>