Added some degree of support for Character Set ECIs

[zxing.git] / core / src / com / google / zxing / Result.java

diff --git a/core/src/com/google/zxing/Result.java b/core/src/com/google/zxing/Result.java
index 42f1947..80fb7f4 100644 (file)
--- a/core/src/com/google/zxing/Result.java
+++ b/core/src/com/google/zxing/Result.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2007 Google Inc.
+ * 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.
@@ -16,6 +16,8 @@
 
 package com.google.zxing;
 
+import java.util.Hashtable;
+
 /**
  * <p>Encapsulates the result of decoding a barcode within an image.</p>
  *
@@ -24,20 +26,39 @@ package com.google.zxing;
 public final class Result {
 
   private final String text;
+  private final byte[] rawBytes;
   private final ResultPoint[] resultPoints;
+  private final BarcodeFormat format;
+  private Hashtable resultMetadata;
 
-  public Result(String text, ResultPoint[] resultPoints) {
+  public Result(String text,
+                byte[] rawBytes,
+                ResultPoint[] resultPoints,
+                BarcodeFormat format) {
+    if (text == null && rawBytes == null) {
+      throw new IllegalArgumentException("Text and bytes are null");
+    }
     this.text = text;
+    this.rawBytes = rawBytes;
     this.resultPoints = resultPoints;
+    this.format = format;
+    this.resultMetadata = null;
   }
 
   /**
-   * @return raw text encoded by the barcode, if any
+   * @return raw text encoded by the barcode, if applicable, otherwise <code>null</code>
    */
   public String getText() {
     return text;
   }
 
+  /**
+   * @return raw bytes encoded by the barcode, if applicable, otherwise <code>null</code>
+   */
+  public byte[] getRawBytes() {
+    return rawBytes;
+  }
+
   /**
    * @return points related to the barcode in the image. These are typically points
    *         identifying finder patterns or the corners of the barcode. The exact meaning is
@@ -47,4 +68,34 @@ public final class Result {
     return resultPoints;
   }
 
+  /**
+   * @return {@link BarcodeFormat} representing the format of the barcode that was recognized and decoded
+   */
+  public BarcodeFormat getBarcodeFormat() {
+    return format;
+  }
+
+  /**
+   * @return {@link Hashtable} mapping {@link ResultMetadataType} keys to values. May be <code>null</code>.
+   *  This contains optional metadata about what was detected about the barcode, like orientation.
+   */
+  public Hashtable getResultMetadata() {
+    return resultMetadata;
+  }
+
+  public void putMetadata(ResultMetadataType type, Object value) {
+    if (resultMetadata == null) {
+      resultMetadata = new Hashtable(3);
+    }
+    resultMetadata.put(type, value);
+  }
+
+  public String toString() {
+    if (text == null) {
+      return "[" + rawBytes.length + " bytes]";
+    } else {
+      return text;
+    }
+  }
+
 }