summaryrefslogtreecommitdiffstats
path: root/iphone/doc/ZBarSymbol.rst
blob: 058a7b1c7c38cd214086d69a64a5a424b7fab439 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
ZBarSymbol Class Reference
==========================

.. class:: ZBarSymbol

   :Inherits from: :class:`NSObject`

   A symbol wraps all of the information the library has about a decoded
   barcode.  Use the available properties to retrieve the barcode data, the
   symbology (type of barcode), location and more.

   This class is a simple wrapper around a :type:`zbar_symbol_t` C object
   (q.v.)


Properties
----------

   .. member:: zbar_symbol_type_t type

      The type of symbology that was decoded. (read-only)

   .. member:: NSString *typeName

      The canonical name used by the library to represent the symbology.
      (read-only)

   .. member:: NSUInteger configMask

      Bitmask of symbology config settings used during decode.

   .. member:: NSUInteger modifierMask

      Bitmask of symbology characteristics detected during decode.  See
      :type:`zbar_modifier_t` for the currently defined modifier bits.

   .. member:: NSString *data

      The raw decoded barcode data. (read-only)

   .. member:: int quality

      A relative metric indicating rough confidence in the decoded value.
      Larger values are better than smaller values. (read-only)

   .. member:: zbar_orientation_t orientation

      The general, axis-aligned orientation of the symbol, or
      ZBAR_ORIENT_UNKNOWN if unknown. (read-only)

   .. member:: ZBarSymbolSet *components

      The components of a composite symbol. (read-only)

   .. member:: const zbar_symbol_t *zbarSymbol

      Retrieve the underlying C object instance. (read-only)

   .. member:: CGRect bounds

      Calculate a rough bounding box for the symbol. (read-only)

      .. note::

         Coordinates are relative to the image *data*, which may not match a
         displayed UIImage.  Make sure to account for the UIImage orientation
         when using these values.


Class Methods
-------------

   .. _`nameForType:`:
   .. describe:: + (NSString*) nameForType:(zbar_symbol_type_t)type

      Retrieve the canonical name for a symbology used by the library, given
      its enumerated value.

      :type: The :type:`zbar_symbol_type_t` enumerated symbology value.
      :Returns: A short string name for the symbology.


Instance Methods
----------------

   .. _`initWithSymbol:`:
   .. describe:: - (id) initWithSymbol:(const zbar_symbol_t*)symbol

      Initialize a symbol wrapper, given the C object to wrap.

      :symbol: The C object to wrap.
      :Returns: The initialized symbol, or nil if an error occurred.


Constants
---------

.. type:: zbar_symbol_type_t

   Symbology identifiers.

   ZBAR_NONE
      No symbol was decoded.

   ZBAR_PARTIAL
      Intermediate status.

   ZBAR_EAN8
      EAN-8

   ZBAR_UPCE
      UPC-E

   ZBAR_ISBN10
      ISBN-10, converted from EAN-13

   ZBAR_UPCA
      UPC-A

   ZBAR_EAN13
      EAN-13

   ZBAR_ISBN13
      ISBN-13, converted from EAN-13

   ZBAR_I25
      Interleaved 2 of 5

   ZBAR_DATABAR
      GS1 DataBar (RSS)

   ZBAR_DATABAR_EXP
      GS1 DataBar Expanded

   ZBAR_CODABAR
      Codabar

   ZBAR_CODE39
      Code 39 (3 of 9)

   ZBAR_QRCODE
      QR Code

   ZBAR_CODE128
      Code 128

.. type:: zbar_orientation_t

   The coarse orientation of a symbol.

   .. note::

      Orientation is relative to the image *data*, which may not match a
      displayed UIImage.  Make sure to account for the UIImage orientation
      when using these values.

   ZBAR_ORIENT_UNKNOWN
      Unable to determine orientation.

   ZBAR_ORIENT_UP
      Upright, read left to right

   ZBAR_ORIENT_RIGHT
      Sideways, read top to bottom

   ZBAR_ORIENT_DOWN
      Upside-down, read right to left

   ZBAR_ORIENT_LEFT
      Sideways, read bottom to top

.. type:: zbar_modifier_t

   Decoder symbology modifier flags.

   .. note::

      These are bit indices, use eg, (1 << ZBAR_MOD_GS1) to test the
      modifierMask property.

   ZBAR_MOD_GS1
      Barcode tagged as GS1 (EAN.UCC) reserved (eg, FNC1 before first data
      character).  Data may be parsed as a sequence of GS1 AIs.

   ZBAR_MOD_AIM
      Barcode tagged as AIM reserved.