private static void EmbedTimingPatterns(ByteMatrix matrix)
{
// -8 is for skipping position detection patterns (size 7), and two horizontal/vertical
// separation patterns (size 1). Thus, 8 = 7 + 1.
for (int i = 8; i < matrix.GetWidth() - 8; ++i)
{
int bit = (i + 1) % 2;
// Horizontal line.
if (!IsValidValue(matrix.Get(i, 6)))
{
throw new WriterException();
}
if (IsEmpty(matrix.Get(i, 6)))
{
matrix.Set(i, 6, bit);
}
// Vertical line.
if (!IsValidValue(matrix.Get(6, i)))
{
throw new WriterException();
}
if (IsEmpty(matrix.Get(6, i)))
{
matrix.Set(6, i, bit);
}
}
}
// Embed version information if need be. On success, modify the matrix and return true.
// See 8.10 of JISX0510:2004 (p.47) for how to embed version information.
public static void MaybeEmbedVersionInfo(int version, ByteMatrix matrix)
{
if (version < 7) // Version info is necessary if version >= 7.
{
return; // Don't need version info.
}
BitVector versionInfoBits = new BitVector();
MakeVersionInfoBits(version, versionInfoBits);
int bitIndex = 6 * 3 - 1; // It will decrease from 17 to 0.
for (int i = 0; i < 6; ++i)
{
for (int j = 0; j < 3; ++j)
{
// Place bits in LSB (least significant bit) to MSB order.
int bit = versionInfoBits.At(bitIndex);
bitIndex--;
// Left bottom corner.
matrix.Set(i, matrix.GetHeight() - 11 + j, bit);
// Right bottom corner.
matrix.Set(matrix.GetHeight() - 11 + j, i, bit);
}
}
}
// Embed type information. On success, modify the matrix.
public static void EmbedTypeInfo(ErrorCorrectionLevel ecLevel, int maskPattern, ByteMatrix matrix)
{
BitVector typeInfoBits = new BitVector();
MakeTypeInfoBits(ecLevel, maskPattern, typeInfoBits);
for (int i = 0; i < typeInfoBits.Size(); ++i)
{
// Place bits in LSB to MSB order. LSB (least significant bit) is the last value in
// "typeInfoBits".
int bit = typeInfoBits.At(typeInfoBits.Size() - 1 - i);
// Type info bits at the left top corner. See 8.9 of JISX0510:2004 (p.46).
int x1 = TYPE_INFO_COORDINATES[i][0];
int y1 = TYPE_INFO_COORDINATES[i][1];
matrix.Set(x1, y1, bit);
if (i < 8)
{
// Right top corner.
int x2 = matrix.GetWidth() - i - 1;
int y2 = 8;
matrix.Set(x2, y2, bit);
}
else
{
// Left bottom corner.
int x2 = 8;
int y2 = matrix.GetHeight() - 7 + (i - 8);
matrix.Set(x2, y2, bit);
}
}
}
// Embed "dataBits" using "getMaskPattern". On success, modify the matrix and return true.
// For debugging purposes, it skips masking process if "getMaskPattern" is -1.
// See 8.7 of JISX0510:2004 (p.38) for how to embed data bits.
public static void EmbedDataBits(BitVector dataBits, int maskPattern, ByteMatrix matrix)
{
int bitIndex = 0;
int direction = -1;
// Start from the right bottom cell.
int x = matrix.GetWidth() - 1;
int y = matrix.GetHeight() - 1;
while (x > 0)
{
// Skip the vertical timing pattern.
if (x == 6)
{
x -= 1;
}
while (y >= 0 && y < matrix.GetHeight())
{
for (int i = 0; i < 2; ++i)
{
int xx = x - i;
// Skip the cell if it's not empty.
if (!IsEmpty(matrix.Get(xx, y)))
{
continue;
}
int bit;
if (bitIndex < dataBits.Size())
{
bit = dataBits.At(bitIndex);
++bitIndex;
}
else
{
// Padding bit. If there is no bit left, we'll fill the left cells with 0, as described
// in 8.4.9 of JISX0510:2004 (p. 24).
bit = 0;
}
// Skip masking if mask_pattern is -1.
if (maskPattern != -1)
{
if (MaskUtil.GetDataMaskBit(maskPattern, xx, y))
{
bit ^= 0x1;
}
}
matrix.Set(xx, y, bit);
}
y += direction;
}
direction = -direction; // Reverse the direction.
y += direction;
x -= 2; // Move to the left.
}
// All bits should be consumed.
if (bitIndex != dataBits.Size())
{
throw new WriterException("Not all bits consumed: " + bitIndex + '/' + dataBits.Size());
}
}
// Embed the lonely dark dot at left bottom corner. JISX0510:2004 (p.46)
private static void EmbedDarkDotAtLeftBottomCorner(ByteMatrix matrix)
{
if (matrix.Get(8, matrix.GetHeight() - 8) == 0)
{
throw new WriterException();
}
matrix.Set(8, matrix.GetHeight() - 8, 1);
}
private static void EmbedHorizontalSeparationPattern(int xStart, int yStart,
ByteMatrix matrix)
{
// We know the width and height.
if (HORIZONTAL_SEPARATION_PATTERN[0].Length != 8 || HORIZONTAL_SEPARATION_PATTERN.GetLength(0) != 1)
{
throw new WriterException("Bad horizontal separation pattern");
}
for (int x = 0; x < 8; ++x)
{
if (!IsEmpty(matrix.Get(xStart + x, yStart)))
{
throw new WriterException();
}
matrix.Set(xStart + x, yStart, HORIZONTAL_SEPARATION_PATTERN[0][x]);
}
}
private static void EmbedVerticalSeparationPattern(int xStart, int yStart,
ByteMatrix matrix)
{
// We know the width and height.
if (VERTICAL_SEPARATION_PATTERN[0].Length != 1 || VERTICAL_SEPARATION_PATTERN.GetLength(0) != 7)
{
throw new WriterException("Bad vertical separation pattern");
}
for (int y = 0; y < 7; ++y)
{
if (!IsEmpty(matrix.Get(xStart, yStart + y)))
{
throw new WriterException();
}
matrix.Set(xStart, yStart + y, VERTICAL_SEPARATION_PATTERN[y][0]);
}
}
private static void EmbedPositionDetectionPattern(int xStart, int yStart,
ByteMatrix matrix)
{
// We know the width and height.
if (POSITION_DETECTION_PATTERN[0].Length != 7 || POSITION_DETECTION_PATTERN.GetLength(0) != 7)
{
throw new WriterException("Bad position detection pattern");
}
for (int y = 0; y < 7; ++y)
{
for (int x = 0; x < 7; ++x)
{
if (!IsEmpty(matrix.Get(xStart + x, yStart + y)))
{
throw new WriterException();
}
matrix.Set(xStart + x, yStart + y, POSITION_DETECTION_PATTERN[y][x]);
}
}
}
// Note that we cannot unify the function with EmbedPositionDetectionPattern() despite they are
// almost identical, since we cannot write a function that takes 2D arrays in different sizes in
// C/C++. We should live with the fact.
private static void EmbedPositionAdjustmentPattern(int xStart, int yStart,
ByteMatrix matrix)
{
// We know the width and height.
if (POSITION_ADJUSTMENT_PATTERN[0].Length != 5 || POSITION_ADJUSTMENT_PATTERN.GetLength(0) != 5)
{
throw new WriterException("Bad position adjustment");
}
for (int y = 0; y < 5; ++y)
{
for (int x = 0; x < 5; ++x)
{
if (!IsEmpty(matrix.Get(xStart + x, yStart + y)))
{
throw new WriterException();
}
matrix.Set(xStart + x, yStart + y, POSITION_ADJUSTMENT_PATTERN[y][x]);
}
}
}
// Embed "dataBits" using "getMaskPattern". On success, modify the matrix and return true.
// For debugging purposes, it skips masking process if "getMaskPattern" is -1.
// See 8.7 of JISX0510:2004 (p.38) for how to embed data bits.
public static void EmbedDataBits(BitVector dataBits, int maskPattern, ByteMatrix matrix)
{
int bitIndex = 0;
int direction = -1;
// Start from the right bottom cell.
int x = matrix.GetWidth() - 1;
int y = matrix.GetHeight() - 1;
while (x > 0) {
// Skip the vertical timing pattern.
if (x == 6) {
x -= 1;
}
while (y >= 0 && y < matrix.GetHeight()) {
for (int i = 0; i < 2; ++i) {
int xx = x - i;
// Skip the cell if it's not empty.
if (!IsEmpty(matrix.Get(xx, y))) {
continue;
}
int bit;
if (bitIndex < dataBits.Size()) {
bit = dataBits.At(bitIndex);
++bitIndex;
}
else {
// Padding bit. If there is no bit left, we'll fill the left cells with 0, as described
// in 8.4.9 of JISX0510:2004 (p. 24).
bit = 0;
}
// Skip masking if mask_pattern is -1.
if (maskPattern != -1) {
if (MaskUtil.GetDataMaskBit(maskPattern, xx, y)) {
bit ^= 0x1;
}
}
matrix.Set(xx, y, bit);
}
y += direction;
}
direction = -direction; // Reverse the direction.
y += direction;
x -= 2; // Move to the left.
}
// All bits should be consumed.
if (bitIndex != dataBits.Size()) {
throw new WriterException("Not all bits consumed: " + bitIndex + '/' + dataBits.Size());
}
}
// Embed version information if need be. On success, modify the matrix and return true.
// See 8.10 of JISX0510:2004 (p.47) for how to embed version information.
public static void MaybeEmbedVersionInfo(int version, ByteMatrix matrix)
{
if (version < 7) { // Version info is necessary if version >= 7.
return; // Don't need version info.
}
BitVector versionInfoBits = new BitVector();
MakeVersionInfoBits(version, versionInfoBits);
int bitIndex = 6 * 3 - 1; // It will decrease from 17 to 0.
for (int i = 0; i < 6; ++i) {
for (int j = 0; j < 3; ++j) {
// Place bits in LSB (least significant bit) to MSB order.
int bit = versionInfoBits.At(bitIndex);
bitIndex--;
// Left bottom corner.
matrix.Set(i, matrix.GetHeight() - 11 + j, bit);
// Right bottom corner.
matrix.Set(matrix.GetHeight() - 11 + j, i, bit);
}
}
}
private static void EmbedHorizontalSeparationPattern(int xStart, int yStart,
ByteMatrix matrix)
{
// We know the width and height.
if (HORIZONTAL_SEPARATION_PATTERN[0].Length != 8 || HORIZONTAL_SEPARATION_PATTERN.GetLength(0) != 1) {
throw new WriterException("Bad horizontal separation pattern");
}
for (int x = 0; x < 8; ++x) {
if (!IsEmpty(matrix.Get(xStart + x, yStart))) {
throw new WriterException();
}
matrix.Set(xStart + x, yStart, HORIZONTAL_SEPARATION_PATTERN[0][x]);
}
}
// Embed the lonely dark dot at left bottom corner. JISX0510:2004 (p.46)
private static void EmbedDarkDotAtLeftBottomCorner(ByteMatrix matrix)
{
if (matrix.Get(8, matrix.GetHeight() - 8) == 0) {
throw new WriterException();
}
matrix.Set(8, matrix.GetHeight() - 8, 1);
}
// Note that we cannot unify the function with EmbedPositionDetectionPattern() despite they are
// almost identical, since we cannot write a function that takes 2D arrays in different sizes in
// C/C++. We should live with the fact.
private static void EmbedPositionAdjustmentPattern(int xStart, int yStart,
ByteMatrix matrix)
{
// We know the width and height.
if (POSITION_ADJUSTMENT_PATTERN[0].Length != 5 || POSITION_ADJUSTMENT_PATTERN.GetLength(0) != 5) {
throw new WriterException("Bad position adjustment");
}
for (int y = 0; y < 5; ++y) {
for (int x = 0; x < 5; ++x) {
if (!IsEmpty(matrix.Get(xStart + x, yStart + y))) {
throw new WriterException();
}
matrix.Set(xStart + x, yStart + y, POSITION_ADJUSTMENT_PATTERN[y][x]);
}
}
}
private static void EmbedPositionDetectionPattern(int xStart, int yStart,
ByteMatrix matrix)
{
// We know the width and height.
if (POSITION_DETECTION_PATTERN[0].Length != 7 || POSITION_DETECTION_PATTERN.GetLength(0) != 7) {
throw new WriterException("Bad position detection pattern");
}
for (int y = 0; y < 7; ++y) {
for (int x = 0; x < 7; ++x) {
if (!IsEmpty(matrix.Get(xStart + x, yStart + y))) {
throw new WriterException();
}
matrix.Set(xStart + x, yStart + y, POSITION_DETECTION_PATTERN[y][x]);
}
}
}
private static void EmbedTimingPatterns(ByteMatrix matrix)
{
// -8 is for skipping position detection patterns (size 7), and two horizontal/vertical
// separation patterns (size 1). Thus, 8 = 7 + 1.
for (int i = 8; i < matrix.GetWidth() - 8; ++i) {
int bit = (i + 1) % 2;
// Horizontal line.
if (!IsValidValue(matrix.Get(i, 6))) {
throw new WriterException();
}
if (IsEmpty(matrix.Get(i, 6))) {
matrix.Set(i, 6, bit);
}
// Vertical line.
if (!IsValidValue(matrix.Get(6, i))) {
throw new WriterException();
}
if (IsEmpty(matrix.Get(6, i))) {
matrix.Set(6, i, bit);
}
}
}
// Embed type information. On success, modify the matrix.
public static void EmbedTypeInfo(ErrorCorrectionLevel ecLevel, int maskPattern, ByteMatrix matrix)
{
BitVector typeInfoBits = new BitVector();
MakeTypeInfoBits(ecLevel, maskPattern, typeInfoBits);
for (int i = 0; i < typeInfoBits.Size(); ++i) {
// Place bits in LSB to MSB order. LSB (least significant bit) is the last value in
// "typeInfoBits".
int bit = typeInfoBits.At(typeInfoBits.Size() - 1 - i);
// Type info bits at the left top corner. See 8.9 of JISX0510:2004 (p.46).
int x1 = TYPE_INFO_COORDINATES[i][0];
int y1 = TYPE_INFO_COORDINATES[i][1];
matrix.Set(x1, y1, bit);
if (i < 8) {
// Right top corner.
int x2 = matrix.GetWidth() - i - 1;
int y2 = 8;
matrix.Set(x2, y2, bit);
}
else {
// Left bottom corner.
int x2 = 8;
int y2 = matrix.GetHeight() - 7 + (i - 8);
matrix.Set(x2, y2, bit);
}
}
}
private static void EmbedVerticalSeparationPattern(int xStart, int yStart,
ByteMatrix matrix)
{
// We know the width and height.
if (VERTICAL_SEPARATION_PATTERN[0].Length != 1 || VERTICAL_SEPARATION_PATTERN.GetLength(0) != 7) {
throw new WriterException("Bad vertical separation pattern");
}
for (int y = 0; y < 7; ++y) {
if (!IsEmpty(matrix.Get(xStart, yStart + y))) {
throw new WriterException();
}
matrix.Set(xStart, yStart + y, VERTICAL_SEPARATION_PATTERN[y][0]);
}
}
