blob: d434215d4cbdd46660fef4eb8e268d6f21ae2bdf (
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
|
ZBarReaderView Class Reference
==============================
.. class:: ZBarReaderView
:Inherits from: :class:`UIView`
This is a barcode reader encapsulted in a UIView. It manages an
:class:`AVCaptureSession` with a camera device and a
:class:`ZBarCaptureReader`, presents the video preview and optionally
tracks detected barcode symbols. A delegate will usually be assigned for
notification of new decode results.
Properties
----------
.. member:: id<ZBarReaderViewDelegate> readerDelegate
The delegate that will be notified of new decode results.
.. member:: ZBarImageScanner *scanner
Access to the image scanner is provided for configuration. (read-only)
.. member:: BOOL tracksSymbols
Whether to display the tracking annotation (default ``YES``).
.. member:: UIColor *trackingColor
The color of the tracking annotation (default green).
.. member:: BOOL allowsPinchZoom
Enable pinch gesture recognition for manually zooming the preview/decode
(default ``YES``).
.. member:: NSInteger torchMode
An :type:`AVCaptureTorchMode` value that will be applied if/when
appropriate. (default Auto)
.. member:: BOOL showsFPS
Overlay the decode frame rate on the preview to help with performance
optimization. This is for *debug only* and should not be set for
production. (default ``NO``)
.. member:: CGFloat zoom
Zoom scale factor applied to the video preview *and* scanCrop. This
value is also updated by the pinch-zoom gesture. Valid values are in
the range [1,maxZoom]. (default 1.25)
.. member:: CGFloat maxZoom
Maximum settable zoom level. The zoom property will be clipped to this
value.
.. member:: CGRect scanCrop
The region of the video image that will be scanned, in normalized image
coordinates. Note that the video image is in landscape mode (default
{{0, 0}, {1, 1}})
.. member:: CGAffineTransform previewTransform
Additional transform that will be applied to the video preview. Note
that this transform is *not* applied to scanCrop.
.. member:: AVCaptureDevice *device
The capture device may be manipulated or replaced.
.. member:: AVCaptureSession *session
Direct access to the capture session. Warranty void if opened.
(read-only)
.. member:: ZBarCaptureReader *captureReader
Direct access to the capture reader. Warranty void if opened.
(read-only)
.. member:: BOOL enableCache
:Deprecated:
Whether to use the inter-frame consistency cache. This should always be
set to ``YES``.
Instance Methods
----------------
.. describe:: - (id) initWithImageScanner:(ZBarImageScanner*)imageScanner
:imageScanner: A pre-configured :class:`ZBarImageScanner` to use for scanning
:Returns: The initialized :class:`ZBarReaderView`
.. describe:: - (void) start
Begin/resume scanning after a call to ``stop``.
.. describe:: - (void) stop
Stop scanning and pause the video feed.
.. describe:: - (void) flushCache
Flush the inter-frame consistency cache. Any barcodes in the frame will
be re-recognized in subsequent frames.
.. _`setZoom:animated:`:
.. describe:: - (void) setZoom:(CGFloat)zoom animated:(BOOL)animated
Set the zoom property with optional animation.
.. _`willRotateTointerfaceOrientation:duration:`:
.. describe:: - (void) willRotateToInterfaceOrientation:(UIInterfaceOrientation)interfaceOrientation duration:(NSTimeInterval)duration
Compensate for device / camera / interface orientation. Must be called
by containing view controller that supports any non-portrait orientation
to restore the camera preview to the correct orientation. Call from
view controller method of the same name for correct animation.
|