a8b9daecf8d59585f8c78be2c8ca84baf3716a12
[zxing.git] / core / src / com / google / zxing / qrcode / encoder / Encoder.java
1 /*
2  * Copyright 2008 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.encoder;
18
19 import com.google.zxing.EncodeHintType;
20 import com.google.zxing.WriterException;
21 import com.google.zxing.common.BitArray;
22 import com.google.zxing.common.CharacterSetECI;
23 import com.google.zxing.common.ECI;
24 import com.google.zxing.common.reedsolomon.GF256;
25 import com.google.zxing.common.reedsolomon.ReedSolomonEncoder;
26 import com.google.zxing.qrcode.decoder.ErrorCorrectionLevel;
27 import com.google.zxing.qrcode.decoder.Mode;
28 import com.google.zxing.qrcode.decoder.Version;
29
30 import java.io.UnsupportedEncodingException;
31 import java.util.Hashtable;
32 import java.util.Vector;
33
34 /**
35  * @author satorux@google.com (Satoru Takabayashi) - creator
36  * @author dswitkin@google.com (Daniel Switkin) - ported from C++
37  */
38 public final class Encoder {
39
40   // The original table is defined in the table 5 of JISX0510:2004 (p.19).
41   private static final int[] ALPHANUMERIC_TABLE = {
42       -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1,  // 0x00-0x0f
43       -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1, -1,  // 0x10-0x1f
44       36, -1, -1, -1, 37, 38, -1, -1, -1, -1, 39, 40, -1, 41, 42, 43,  // 0x20-0x2f
45       0,   1,  2,  3,  4,  5,  6,  7,  8,  9, 44, -1, -1, -1, -1, -1,  // 0x30-0x3f
46       -1, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24,  // 0x40-0x4f
47       25, 26, 27, 28, 29, 30, 31, 32, 33, 34, 35, -1, -1, -1, -1, -1,  // 0x50-0x5f
48   };
49
50   static final String DEFAULT_BYTE_MODE_ENCODING = "ISO-8859-1";
51
52   private Encoder() {
53   }
54
55   // The mask penalty calculation is complicated.  See Table 21 of JISX0510:2004 (p.45) for details.
56   // Basically it applies four rules and summate all penalties.
57   private static int calculateMaskPenalty(ByteMatrix matrix) {
58     int penalty = 0;
59     penalty += MaskUtil.applyMaskPenaltyRule1(matrix);
60     penalty += MaskUtil.applyMaskPenaltyRule2(matrix);
61     penalty += MaskUtil.applyMaskPenaltyRule3(matrix);
62     penalty += MaskUtil.applyMaskPenaltyRule4(matrix);
63     return penalty;
64   }
65
66   /**
67    *  Encode "bytes" with the error correction level "ecLevel". The encoding mode will be chosen
68    * internally by chooseMode(). On success, store the result in "qrCode".
69    *
70    * We recommend you to use QRCode.EC_LEVEL_L (the lowest level) for
71    * "getECLevel" since our primary use is to show QR code on desktop screens. We don't need very
72    * strong error correction for this purpose.
73    *
74    * Note that there is no way to encode bytes in MODE_KANJI. We might want to add EncodeWithMode()
75    * with which clients can specify the encoding mode. For now, we don't need the functionality.
76    */
77   public static void encode(String content, ErrorCorrectionLevel ecLevel, QRCode qrCode)
78       throws WriterException {
79     encode(content, ecLevel, null, qrCode);
80   }
81
82   public static void encode(String content, ErrorCorrectionLevel ecLevel, Hashtable hints,
83       QRCode qrCode) throws WriterException {
84
85     String encoding = hints == null ? null : (String) hints.get(EncodeHintType.CHARACTER_SET);
86     if (encoding == null) {
87       encoding = DEFAULT_BYTE_MODE_ENCODING;
88     }
89
90     // Step 1: Choose the mode (encoding).
91     Mode mode = chooseMode(content, encoding);
92
93     // Step 2: Append "bytes" into "dataBits" in appropriate encoding.
94     BitArray dataBits = new BitArray();
95     appendBytes(content, mode, dataBits, encoding);
96     // Step 3: Initialize QR code that can contain "dataBits".
97     int numInputBytes = dataBits.getSizeInBytes();
98     initQRCode(numInputBytes, ecLevel, mode, qrCode);
99
100     // Step 4: Build another bit vector that contains header and data.
101     BitArray headerAndDataBits = new BitArray();
102
103     // Step 4.5: Append ECI message if applicable
104     if (mode == Mode.BYTE && !DEFAULT_BYTE_MODE_ENCODING.equals(encoding)) {
105       CharacterSetECI eci = CharacterSetECI.getCharacterSetECIByName(encoding);
106       if (eci != null) {
107         appendECI(eci, headerAndDataBits);
108       }
109     }
110
111     appendModeInfo(mode, headerAndDataBits);
112
113     int numLetters = mode.equals(Mode.BYTE) ? dataBits.getSizeInBytes() : content.length();
114     appendLengthInfo(numLetters, qrCode.getVersion(), mode, headerAndDataBits);
115     headerAndDataBits.appendBitArray(dataBits);
116
117     // Step 5: Terminate the bits properly.
118     terminateBits(qrCode.getNumDataBytes(), headerAndDataBits);
119
120     // Step 6: Interleave data bits with error correction code.
121     BitArray finalBits = new BitArray();
122     interleaveWithECBytes(headerAndDataBits, qrCode.getNumTotalBytes(), qrCode.getNumDataBytes(),
123         qrCode.getNumRSBlocks(), finalBits);
124
125     // Step 7: Choose the mask pattern and set to "qrCode".
126     ByteMatrix matrix = new ByteMatrix(qrCode.getMatrixWidth(), qrCode.getMatrixWidth());
127     qrCode.setMaskPattern(chooseMaskPattern(finalBits, qrCode.getECLevel(), qrCode.getVersion(),
128         matrix));
129
130     // Step 8.  Build the matrix and set it to "qrCode".
131     MatrixUtil.buildMatrix(finalBits, qrCode.getECLevel(), qrCode.getVersion(),
132         qrCode.getMaskPattern(), matrix);
133     qrCode.setMatrix(matrix);
134     // Step 9.  Make sure we have a valid QR Code.
135     if (!qrCode.isValid()) {
136       throw new WriterException("Invalid QR code: " + qrCode.toString());
137     }
138   }
139
140   /**
141    * @return the code point of the table used in alphanumeric mode or
142    *  -1 if there is no corresponding code in the table.
143    */
144   static int getAlphanumericCode(int code) {
145     if (code < ALPHANUMERIC_TABLE.length) {
146       return ALPHANUMERIC_TABLE[code];
147     }
148     return -1;
149   }
150
151   public static Mode chooseMode(String content) {
152     return chooseMode(content, null);
153   }
154
155   /**
156    * Choose the best mode by examining the content. Note that 'encoding' is used as a hint;
157    * if it is Shift_JIS, and the input is only double-byte Kanji, then we return {@link Mode#KANJI}.
158    */
159   public static Mode chooseMode(String content, String encoding) {
160     if ("Shift_JIS".equals(encoding)) {
161       // Choose Kanji mode if all input are double-byte characters
162       return isOnlyDoubleByteKanji(content) ? Mode.KANJI : Mode.BYTE;
163     }
164     boolean hasNumeric = false;
165     boolean hasAlphanumeric = false;
166     for (int i = 0; i < content.length(); ++i) {
167       char c = content.charAt(i);
168       if (c >= '0' && c <= '9') {
169         hasNumeric = true;
170       } else if (getAlphanumericCode(c) != -1) {
171         hasAlphanumeric = true;
172       } else {
173         return Mode.BYTE;
174       }
175     }
176     if (hasAlphanumeric) {
177       return Mode.ALPHANUMERIC;
178     } else if (hasNumeric) {
179       return Mode.NUMERIC;
180     }
181     return Mode.BYTE;
182   }
183
184   private static boolean isOnlyDoubleByteKanji(String content) {
185     byte[] bytes;
186     try {
187       bytes = content.getBytes("Shift_JIS");
188     } catch (UnsupportedEncodingException uee) {
189       return false;
190     }
191     int length = bytes.length;
192     if (length % 2 != 0) {
193       return false;
194     }
195     for (int i = 0; i < length; i += 2) {
196       int byte1 = bytes[i] & 0xFF;
197       if ((byte1 < 0x81 || byte1 > 0x9F) && (byte1 < 0xE0 || byte1 > 0xEB)) {
198         return false;
199       }
200     }
201     return true;
202   }
203
204   private static int chooseMaskPattern(BitArray bits, ErrorCorrectionLevel ecLevel, int version,
205       ByteMatrix matrix) throws WriterException {
206
207     int minPenalty = Integer.MAX_VALUE;  // Lower penalty is better.
208     int bestMaskPattern = -1;
209     // We try all mask patterns to choose the best one.
210     for (int maskPattern = 0; maskPattern < QRCode.NUM_MASK_PATTERNS; maskPattern++) {
211       MatrixUtil.buildMatrix(bits, ecLevel, version, maskPattern, matrix);
212       int penalty = calculateMaskPenalty(matrix);
213       if (penalty < minPenalty) {
214         minPenalty = penalty;
215         bestMaskPattern = maskPattern;
216       }
217     }
218     return bestMaskPattern;
219   }
220
221   /**
222    * Initialize "qrCode" according to "numInputBytes", "ecLevel", and "mode". On success,
223    * modify "qrCode".
224    */
225   private static void initQRCode(int numInputBytes, ErrorCorrectionLevel ecLevel, Mode mode,
226       QRCode qrCode) throws WriterException {
227     qrCode.setECLevel(ecLevel);
228     qrCode.setMode(mode);
229
230     // In the following comments, we use numbers of Version 7-H.
231     for (int versionNum = 1; versionNum <= 40; versionNum++) {
232       Version version = Version.getVersionForNumber(versionNum);
233       // numBytes = 196
234       int numBytes = version.getTotalCodewords();
235       // getNumECBytes = 130
236       Version.ECBlocks ecBlocks = version.getECBlocksForLevel(ecLevel);
237       int numEcBytes = ecBlocks.getTotalECCodewords();
238       // getNumRSBlocks = 5
239       int numRSBlocks = ecBlocks.getNumBlocks();
240       // getNumDataBytes = 196 - 130 = 66
241       int numDataBytes = numBytes - numEcBytes;
242       // We want to choose the smallest version which can contain data of "numInputBytes" + some
243       // extra bits for the header (mode info and length info). The header can be three bytes
244       // (precisely 4 + 16 bits) at most. Hence we do +3 here.
245       if (numDataBytes >= numInputBytes + 3) {
246         // Yay, we found the proper rs block info!
247         qrCode.setVersion(versionNum);
248         qrCode.setNumTotalBytes(numBytes);
249         qrCode.setNumDataBytes(numDataBytes);
250         qrCode.setNumRSBlocks(numRSBlocks);
251         // getNumECBytes = 196 - 66 = 130
252         qrCode.setNumECBytes(numEcBytes);
253         // matrix width = 21 + 6 * 4 = 45
254         qrCode.setMatrixWidth(version.getDimensionForVersion());
255         return;
256       }
257     }
258     throw new WriterException("Cannot find proper rs block info (input data too big?)");
259   }
260
261   /**
262    * Terminate bits as described in 8.4.8 and 8.4.9 of JISX0510:2004 (p.24).
263    */
264   static void terminateBits(int numDataBytes, BitArray bits) throws WriterException {
265     int capacity = numDataBytes << 3;
266     if (bits.getSize() > capacity) {
267       throw new WriterException("data bits cannot fit in the QR Code" + bits.getSize() + " > " +
268           capacity);
269     }
270     for (int i = 0; i < 4 && bits.getSize() < capacity; ++i) {
271       bits.appendBit(false);
272     }
273     // Append termination bits. See 8.4.8 of JISX0510:2004 (p.24) for details.
274     // If the last byte isn't 8-bit aligned, we'll add padding bits.
275     int numBitsInLastByte = bits.getSize() & 0x07;    
276     if (numBitsInLastByte > 0) {
277       for (int i = numBitsInLastByte; i < 8; i++) {
278         bits.appendBit(false);
279       }
280     }
281     // If we have more space, we'll fill the space with padding patterns defined in 8.4.9 (p.24).
282     int numPaddingBytes = numDataBytes - bits.getSizeInBytes();
283     for (int i = 0; i < numPaddingBytes; ++i) {
284       bits.appendBits(((i & 0x01) == 0) ? 0xEC : 0x11, 8);
285     }
286     if (bits.getSize() != capacity) {
287       throw new WriterException("Bits size does not equal capacity");
288     }
289   }
290
291   /**
292    * Get number of data bytes and number of error correction bytes for block id "blockID". Store
293    * the result in "numDataBytesInBlock", and "numECBytesInBlock". See table 12 in 8.5.1 of
294    * JISX0510:2004 (p.30)
295    */
296   static void getNumDataBytesAndNumECBytesForBlockID(int numTotalBytes, int numDataBytes,
297       int numRSBlocks, int blockID, int[] numDataBytesInBlock,
298       int[] numECBytesInBlock) throws WriterException {
299     if (blockID >= numRSBlocks) {
300       throw new WriterException("Block ID too large");
301     }
302     // numRsBlocksInGroup2 = 196 % 5 = 1
303     int numRsBlocksInGroup2 = numTotalBytes % numRSBlocks;
304     // numRsBlocksInGroup1 = 5 - 1 = 4
305     int numRsBlocksInGroup1 = numRSBlocks - numRsBlocksInGroup2;
306     // numTotalBytesInGroup1 = 196 / 5 = 39
307     int numTotalBytesInGroup1 = numTotalBytes / numRSBlocks;
308     // numTotalBytesInGroup2 = 39 + 1 = 40
309     int numTotalBytesInGroup2 = numTotalBytesInGroup1 + 1;
310     // numDataBytesInGroup1 = 66 / 5 = 13
311     int numDataBytesInGroup1 = numDataBytes / numRSBlocks;
312     // numDataBytesInGroup2 = 13 + 1 = 14
313     int numDataBytesInGroup2 = numDataBytesInGroup1 + 1;
314     // numEcBytesInGroup1 = 39 - 13 = 26
315     int numEcBytesInGroup1 = numTotalBytesInGroup1 - numDataBytesInGroup1;
316     // numEcBytesInGroup2 = 40 - 14 = 26
317     int numEcBytesInGroup2 = numTotalBytesInGroup2 - numDataBytesInGroup2;
318     // Sanity checks.
319     // 26 = 26
320     if (numEcBytesInGroup1 != numEcBytesInGroup2) {
321       throw new WriterException("EC bytes mismatch");
322     }
323     // 5 = 4 + 1.
324     if (numRSBlocks != numRsBlocksInGroup1 + numRsBlocksInGroup2) {
325       throw new WriterException("RS blocks mismatch");
326     }
327     // 196 = (13 + 26) * 4 + (14 + 26) * 1
328     if (numTotalBytes !=
329         ((numDataBytesInGroup1 + numEcBytesInGroup1) *
330             numRsBlocksInGroup1) +
331             ((numDataBytesInGroup2 + numEcBytesInGroup2) *
332                 numRsBlocksInGroup2)) {
333       throw new WriterException("Total bytes mismatch");
334     }
335
336     if (blockID < numRsBlocksInGroup1) {
337       numDataBytesInBlock[0] = numDataBytesInGroup1;
338       numECBytesInBlock[0] = numEcBytesInGroup1;
339     } else {
340       numDataBytesInBlock[0] = numDataBytesInGroup2;
341       numECBytesInBlock[0] = numEcBytesInGroup2;
342     }
343   }
344
345   /**
346    * Interleave "bits" with corresponding error correction bytes. On success, store the result in
347    * "result". The interleave rule is complicated. See 8.6 of JISX0510:2004 (p.37) for details.
348    */
349   static void interleaveWithECBytes(BitArray bits, int numTotalBytes,
350       int numDataBytes, int numRSBlocks, BitArray result) throws WriterException {
351
352     // "bits" must have "getNumDataBytes" bytes of data.
353     if (bits.getSizeInBytes() != numDataBytes) {
354       throw new WriterException("Number of bits and data bytes does not match");
355     }
356
357     // Step 1.  Divide data bytes into blocks and generate error correction bytes for them. We'll
358     // store the divided data bytes blocks and error correction bytes blocks into "blocks".
359     int dataBytesOffset = 0;
360     int maxNumDataBytes = 0;
361     int maxNumEcBytes = 0;
362
363     // Since, we know the number of reedsolmon blocks, we can initialize the vector with the number.
364     Vector blocks = new Vector(numRSBlocks);
365
366     for (int i = 0; i < numRSBlocks; ++i) {
367       int[] numDataBytesInBlock = new int[1];
368       int[] numEcBytesInBlock = new int[1];
369       getNumDataBytesAndNumECBytesForBlockID(
370           numTotalBytes, numDataBytes, numRSBlocks, i,
371           numDataBytesInBlock, numEcBytesInBlock);
372
373       int size = numDataBytesInBlock[0];
374       byte[] dataBytes = new byte[size];
375       bits.toBytes(8*dataBytesOffset, dataBytes, 0, size);
376       byte[] ecBytes = generateECBytes(dataBytes, numEcBytesInBlock[0]);
377       blocks.addElement(new BlockPair(dataBytes, ecBytes));
378
379       maxNumDataBytes = Math.max(maxNumDataBytes, size);
380       maxNumEcBytes = Math.max(maxNumEcBytes, ecBytes.length);
381       dataBytesOffset += numDataBytesInBlock[0];
382     }
383     if (numDataBytes != dataBytesOffset) {
384       throw new WriterException("Data bytes does not match offset");
385     }
386
387     // First, place data blocks.
388     for (int i = 0; i < maxNumDataBytes; ++i) {
389       for (int j = 0; j < blocks.size(); ++j) {
390         byte[] dataBytes = ((BlockPair) blocks.elementAt(j)).getDataBytes();
391         if (i < dataBytes.length) {
392           result.appendBits(dataBytes[i], 8);
393         }
394       }
395     }
396     // Then, place error correction blocks.
397     for (int i = 0; i < maxNumEcBytes; ++i) {
398       for (int j = 0; j < blocks.size(); ++j) {
399         byte[] ecBytes = ((BlockPair) blocks.elementAt(j)).getErrorCorrectionBytes();
400         if (i < ecBytes.length) {
401           result.appendBits(ecBytes[i], 8);
402         }
403       }
404     }
405     if (numTotalBytes != result.getSizeInBytes()) {  // Should be same.
406       throw new WriterException("Interleaving error: " + numTotalBytes + " and " +
407           result.getSizeInBytes() + " differ.");
408     }
409   }
410
411   static byte[] generateECBytes(byte[] dataBytes, int numEcBytesInBlock) {
412     int numDataBytes = dataBytes.length;
413     int[] toEncode = new int[numDataBytes + numEcBytesInBlock];
414     for (int i = 0; i < numDataBytes; i++) {
415       toEncode[i] = dataBytes[i] & 0xFF;
416     }
417     new ReedSolomonEncoder(GF256.QR_CODE_FIELD).encode(toEncode, numEcBytesInBlock);
418
419     byte[] ecBytes = new byte[numEcBytesInBlock];
420     for (int i = 0; i < numEcBytesInBlock; i++) {
421       ecBytes[i] = (byte) toEncode[numDataBytes + i];
422     }
423     return ecBytes;
424   }
425
426   /**
427    * Append mode info. On success, store the result in "bits".
428    */
429   static void appendModeInfo(Mode mode, BitArray bits) {
430     bits.appendBits(mode.getBits(), 4);
431   }
432
433
434   /**
435    * Append length info. On success, store the result in "bits".
436    */
437   static void appendLengthInfo(int numLetters, int version, Mode mode, BitArray bits)
438       throws WriterException {
439     int numBits = mode.getCharacterCountBits(Version.getVersionForNumber(version));
440     if (numLetters > ((1 << numBits) - 1)) {
441       throw new WriterException(numLetters + "is bigger than" + ((1 << numBits) - 1));
442     }
443     bits.appendBits(numLetters, numBits);
444   }
445
446   /**
447    * Append "bytes" in "mode" mode (encoding) into "bits". On success, store the result in "bits".
448    */
449   static void appendBytes(String content, Mode mode, BitArray bits, String encoding)
450       throws WriterException {
451     if (mode.equals(Mode.NUMERIC)) {
452       appendNumericBytes(content, bits);
453     } else if (mode.equals(Mode.ALPHANUMERIC)) {
454       appendAlphanumericBytes(content, bits);
455     } else if (mode.equals(Mode.BYTE)) {
456       append8BitBytes(content, bits, encoding);
457     } else if (mode.equals(Mode.KANJI)) {
458       appendKanjiBytes(content, bits);
459     } else {
460       throw new WriterException("Invalid mode: " + mode);
461     }
462   }
463
464   static void appendNumericBytes(String content, BitArray bits) {
465     int length = content.length();
466     int i = 0;
467     while (i < length) {
468       int num1 = content.charAt(i) - '0';
469       if (i + 2 < length) {
470         // Encode three numeric letters in ten bits.
471         int num2 = content.charAt(i + 1) - '0';
472         int num3 = content.charAt(i + 2) - '0';
473         bits.appendBits(num1 * 100 + num2 * 10 + num3, 10);
474         i += 3;
475       } else if (i + 1 < length) {
476         // Encode two numeric letters in seven bits.
477         int num2 = content.charAt(i + 1) - '0';
478         bits.appendBits(num1 * 10 + num2, 7);
479         i += 2;
480       } else {
481         // Encode one numeric letter in four bits.
482         bits.appendBits(num1, 4);
483         i++;
484       }
485     }
486   }
487
488   static void appendAlphanumericBytes(String content, BitArray bits) throws WriterException {
489     int length = content.length();
490     int i = 0;
491     while (i < length) {
492       int code1 = getAlphanumericCode(content.charAt(i));
493       if (code1 == -1) {
494         throw new WriterException();
495       }
496       if (i + 1 < length) {
497         int code2 = getAlphanumericCode(content.charAt(i + 1));
498         if (code2 == -1) {
499           throw new WriterException();
500         }
501         // Encode two alphanumeric letters in 11 bits.
502         bits.appendBits(code1 * 45 + code2, 11);
503         i += 2;
504       } else {
505         // Encode one alphanumeric letter in six bits.
506         bits.appendBits(code1, 6);
507         i++;
508       }
509     }
510   }
511
512   static void append8BitBytes(String content, BitArray bits, String encoding)
513       throws WriterException {
514     byte[] bytes;
515     try {
516       bytes = content.getBytes(encoding);
517     } catch (UnsupportedEncodingException uee) {
518       throw new WriterException(uee.toString());
519     }
520     for (int i = 0; i < bytes.length; ++i) {
521       bits.appendBits(bytes[i], 8);
522     }
523   }
524
525   static void appendKanjiBytes(String content, BitArray bits) throws WriterException {
526     byte[] bytes;
527     try {
528       bytes = content.getBytes("Shift_JIS");
529     } catch (UnsupportedEncodingException uee) {
530       throw new WriterException(uee.toString());
531     }
532     int length = bytes.length;
533     for (int i = 0; i < length; i += 2) {
534       int byte1 = bytes[i] & 0xFF;
535       int byte2 = bytes[i + 1] & 0xFF;
536       int code = (byte1 << 8) | byte2;
537       int subtracted = -1;
538       if (code >= 0x8140 && code <= 0x9ffc) {
539         subtracted = code - 0x8140;
540       } else if (code >= 0xe040 && code <= 0xebbf) {
541         subtracted = code - 0xc140;
542       }
543       if (subtracted == -1) {
544         throw new WriterException("Invalid byte sequence");
545       }
546       int encoded = ((subtracted >> 8) * 0xc0) + (subtracted & 0xff);
547       bits.appendBits(encoded, 13);
548     }
549   }
550
551   private static void appendECI(ECI eci, BitArray bits) {
552     bits.appendBits(Mode.ECI.getBits(), 4);
553     // This is correct for values up to 127, which is all we need now.
554     bits.appendBits(eci.getValue(), 8);
555   }
556
557 }