/* * Copyright 2007 ZXing authors * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ using System.Collections.Generic; using ZXing.Aztec; using ZXing.Datamatrix; using ZXing.IMB; using ZXing.Maxicode; using ZXing.OneD; using ZXing.PDF417; using ZXing.QrCode; namespace ZXing { /// /// MultiFormatReader is a convenience class and the main entry point into the library for most uses. /// By default it attempts to decode all barcode formats that the library supports. Optionally, you /// can provide a hints object to request different behavior, for example only decoding QR codes. /// /// Sean Owen /// dswitkin@google.com (Daniel Switkin) /// www.Redivivus.in (suraj.supekar@redivivus.in) - Ported from ZXING Java Source public sealed class MultiFormatReader : Reader { private IDictionary hints; private IList readers; /// This version of decode honors the intent of Reader.decode(BinaryBitmap) in that it /// passes null as a hint to the decoders. However, that makes it inefficient to call repeatedly. /// Use setHints() followed by decodeWithState() for continuous scan applications. /// /// /// The pixel data to decode /// /// The contents of the image /// /// ReaderException Any errors which occurred public Result decode(BinaryBitmap image) { Hints = null; return decodeInternal(image); } /// Decode an image using the hints provided. Does not honor existing state. /// /// /// The pixel data to decode /// /// The hints to use, clearing the previous state. /// /// The contents of the image /// /// ReaderException Any errors which occurred public Result decode(BinaryBitmap image, IDictionary hints) { Hints = hints; return decodeInternal(image); } /// Decode an image using the state set up by calling setHints() previously. Continuous scan /// clients will get a large speed increase by using this instead of decode(). /// /// /// The pixel data to decode /// /// The contents of the image /// /// ReaderException Any errors which occurred public Result decodeWithState(BinaryBitmap image) { // Make sure to set up the default state so we don't crash if (readers == null) { Hints = null; } return decodeInternal(image); } /// This method adds state to the MultiFormatReader. By setting the hints once, subsequent calls /// to decodeWithState(image) can reuse the same set of readers without reallocating memory. This /// is important for performance in continuous scan clients. /// /// /// The set of hints to use for subsequent calls to decode(image) /// public IDictionary Hints { set { hints = value; var tryHarder = value != null && value.ContainsKey(DecodeHintType.TRY_HARDER); var formats = value == null || !value.ContainsKey(DecodeHintType.POSSIBLE_FORMATS) ? null : (IList)value[DecodeHintType.POSSIBLE_FORMATS]; if (formats != null) { bool addOneDReader = formats.Contains(BarcodeFormat.All_1D) || formats.Contains(BarcodeFormat.UPC_A) || formats.Contains(BarcodeFormat.UPC_E) || formats.Contains(BarcodeFormat.EAN_13) || formats.Contains(BarcodeFormat.EAN_8) || formats.Contains(BarcodeFormat.CODABAR) || formats.Contains(BarcodeFormat.CODE_39) || formats.Contains(BarcodeFormat.CODE_93) || formats.Contains(BarcodeFormat.CODE_128) || formats.Contains(BarcodeFormat.ITF) || formats.Contains(BarcodeFormat.RSS_14) || formats.Contains(BarcodeFormat.RSS_EXPANDED); readers = new List(); // Put 1D readers upfront in "normal" mode if (addOneDReader && !tryHarder) { readers.Add(new MultiFormatOneDReader(value)); } if (formats.Contains(BarcodeFormat.QR_CODE)) { readers.Add(new QRCodeReader()); } if (formats.Contains(BarcodeFormat.DATA_MATRIX)) { readers.Add(new DataMatrixReader()); } if (formats.Contains(BarcodeFormat.AZTEC)) { readers.Add(new AztecReader()); } if (formats.Contains(BarcodeFormat.PDF_417)) { readers.Add(new PDF417Reader()); } if (formats.Contains(BarcodeFormat.MAXICODE)) { readers.Add(new MaxiCodeReader()); } if (formats.Contains(BarcodeFormat.IMB)) { readers.Add(new IMBReader()); } // At end in "try harder" mode if (addOneDReader && tryHarder) { readers.Add(new MultiFormatOneDReader(value)); } } if (readers == null || readers.Count == 0) { readers = readers ?? new List(); if (!tryHarder) { readers.Add(new MultiFormatOneDReader(value)); } readers.Add(new QRCodeReader()); readers.Add(new DataMatrixReader()); readers.Add(new AztecReader()); readers.Add(new PDF417Reader()); readers.Add(new MaxiCodeReader()); if (tryHarder) { readers.Add(new MultiFormatOneDReader(value)); } } } } public void reset() { if (readers != null) { foreach (var reader in readers) { reader.reset(); } } } private Result decodeInternal(BinaryBitmap image) { if (readers != null) { var rpCallback = hints != null && hints.ContainsKey(DecodeHintType.NEED_RESULT_POINT_CALLBACK) ? (ResultPointCallback) hints[DecodeHintType.NEED_RESULT_POINT_CALLBACK] : null; for (var index = 0; index < readers.Count; index++) { var reader = readers[index]; reader.reset(); var result = reader.decode(image, hints); if (result != null) { // found a barcode, pushing the successful reader up front // I assume that the same type of barcode is read multiple times // so the reordering of the readers list should speed up the next reading // a little bit readers.RemoveAt(index); readers.Insert(0, reader); return result; } if (rpCallback != null) rpCallback(null); } } return null; } } }