Refactorings to allow raw bytes to be passed back with reader result, where applicable
[zxing.git] / core / src / com / google / zxing / Result.java
1 /*
2  * Copyright 2007 Google Inc.
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16
17 package com.google.zxing;
18
19 /**
20  * <p>Encapsulates the result of decoding a barcode within an image.</p>
21  *
22  * @author srowen@google.com (Sean Owen)
23  */
24 public final class Result {
25
26   private final String text;
27   private final byte[] rawBytes;
28   private final ResultPoint[] resultPoints;
29   private final BarcodeFormat format;
30
31   public Result(String text, byte[] rawBytes, ResultPoint[] resultPoints, BarcodeFormat format) {
32     this.text = text;
33     this.rawBytes = rawBytes;
34     this.resultPoints = resultPoints;
35     this.format = format;
36   }
37
38   /**
39    * @return raw text encoded by the barcode, if applicable, otherwise <code>null</code>
40    */
41   public String getText() {
42     return text;
43   }
44
45   /**
46    * @return raw bytes encoded by the barcode, if applicable, otherwise <code>null</code>
47    */
48   public byte[] getRawBytes() {
49     return rawBytes;
50   }
51
52   /**
53    * @return points related to the barcode in the image. These are typically points
54    *         identifying finder patterns or the corners of the barcode. The exact meaning is
55    *         specific to the type of barcode that was decoded.
56    */
57   public ResultPoint[] getResultPoints() {
58     return resultPoints;
59   }
60
61   /**
62    * @return {@link BarcodeFormat} representing the format of the barcode that was recognized and decoded
63    */
64   public BarcodeFormat getBarcodeFormat() {
65     return format;
66   }
67
68 }