core/src/com/google/zxing/qrcode/decoder/Mode.java

   1 /*
   2  * Copyright 2007 ZXing authors
   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.qrcode.decoder;
  18
  19 /**
  20  * <p>See ISO 18004:2006, 6.4.1, Tables 2 and 3. This enum encapsulates the various modes in which
  21  * data can be encoded to bits in the QR code standard.</p>
  22  *
  23  * @author Sean Owen
  24  */
  25 public final class Mode {
  26
  27   // No, we can't use an enum here. J2ME doesn't support it.
  28
  29   public static final Mode TERMINATOR = new Mode(new int[]{0, 0, 0}, 0x00, "TERMINATOR"); // Not really a mode...
  30   public static final Mode NUMERIC = new Mode(new int[]{10, 12, 14}, 0x01, "NUMERIC");
  31   public static final Mode ALPHANUMERIC = new Mode(new int[]{9, 11, 13}, 0x02, "ALPHANUMERIC");
  32   public static final Mode BYTE = new Mode(new int[]{8, 16, 16}, 0x04, "BYTE");
  33   public static final Mode ECI = new Mode(null, 0x07, "ECI"); // character counts don't apply
  34   public static final Mode KANJI = new Mode(new int[]{8, 10, 12}, 0x08, "KANJI");
  35   public static final Mode FNC1_FIRST_POSITION = new Mode(null, 0x05, "FNC1_FIRST_POSITION");
  36   public static final Mode FNC1_SECOND_POSITION = new Mode(null, 0x09, "FNC1_SECOND_POSITION");
  37
  38   private final int[] characterCountBitsForVersions;
  39   private final int bits;
  40   private final String name;
  41
  42   private Mode(int[] characterCountBitsForVersions, int bits, String name) {
  43     this.characterCountBitsForVersions = characterCountBitsForVersions;
  44     this.bits = bits;
  45     this.name = name;
  46   }
  47
  48   /**
  49    * @param bits four bits encoding a QR Code data mode
  50    * @return {@link Mode} encoded by these bits
  51    * @throws IllegalArgumentException if bits do not correspond to a known mode
  52    */
  53   public static Mode forBits(int bits) {
  54     switch (bits) {
  55       case 0x0:
  56         return TERMINATOR;
  57       case 0x1:
  58         return NUMERIC;
  59       case 0x2:
  60         return ALPHANUMERIC;
  61       case 0x4:
  62         return BYTE;
  63       case 0x5:
  64         return FNC1_FIRST_POSITION;
  65       case 0x7:
  66         return ECI;
  67       case 0x8:
  68         return KANJI;
  69       case 0x9:
  70         return FNC1_SECOND_POSITION;
  71       default:
  72         throw new IllegalArgumentException();
  73     }
  74   }
  75
  76   /**
  77    * @param version version in question
  78    * @return number of bits used, in this QR Code symbol {@link Version}, to encode the
  79    *         count of characters that will follow encoded in this {@link Mode}
  80    */
  81   public int getCharacterCountBits(Version version) {
  82     if (characterCountBitsForVersions == null) {
  83       throw new IllegalArgumentException("Character count doesn't apply to this mode");
  84     }
  85     int number = version.getVersionNumber();
  86     int offset;
  87     if (number <= 9) {
  88       offset = 0;
  89     } else if (number <= 26) {
  90       offset = 1;
  91     } else {
  92       offset = 2;
  93     }
  94     return characterCountBitsForVersions[offset];
  95   }
  96
  97   public int getBits() {
  98     return bits;
  99   }
 100
 101   public String getName() {
 102     return name;
 103   }
 104
 105   public String toString() {
 106     return name;
 107   }
 108
 109 }