O código Han Xin é uma simbologia matricial bidimensional, composta por uma matriz de módulos nominalmente quadrados dispostos em um padrão quadrado geral.
A matriz do código de barras Han Xin possui quatro padrões de busca (A1-A4) posicionados nas bordas do código de barras. Além disso, a matriz do código de barras possui padrões de alinhamento (B), localizados em seu interior, que permitem o reconhecimento de códigos de barras com diversas distorções, as quais podem surgir devido a imperfeições no processo de fotografia ou irregularidades na superfície onde o código de barras é impresso ou etiquetado. O código de barras
Han Xin Code possui uma característica especial: ele pode armazenar dados de texto codificados em GB18030 (símbolos de 2 e 4 bytes) da maneira mais compacta possível.
Características gerais do código Han Xin:
-
Sete modos de codificação:
- Modo texto (até 4350 caracteres de texto)
- Modo byte (até 3261 bytes)
- Modo numérico (até 7827 caracteres numéricos)
- Caracteres chineses comuns no modo Região Um (até 2174 caracteres GB18030)
- Caracteres chineses comuns no modo Região Dois (até 2174 caracteres GB18030)
- Modo Região GB18030 de 2 bytes (até 1739 caracteres GB18030)
- Modo Região GB18030 de 4 bytes (até até 1044 caracteres GB18030)
- Detecção e correção de erros Reed-Solomon (4 níveis)
- O protocolo de Interpretação de Canal Estendida (ECI) permite que o fluxo de dados de saída tenha interpretações diferentes daquelas do conjunto de caracteres padrão
VintaSoft Barcode .NET SDK suporta leitura, gravação e teste de qualidade de impressão de códigos de barras Han Xin Code (Código Sensível Chinês).
Aqui está o código C# que mostra como gerar o código de barras Han Xin Code como imagem raster:
/// <summary>
/// Generates Han Xin Code barcode as raster image.
/// </summary>
public void GenerateHanXinCodeBarcodeAsRasterImage()
{
// create the barcode writer
Vintasoft.Barcode.BarcodeWriter barcodeWriter = new Vintasoft.Barcode.BarcodeWriter();
// set barcode writer settings
barcodeWriter.Settings.Barcode = Vintasoft.Barcode.BarcodeType.HanXinCode;
barcodeWriter.Settings.Value = "012345abcde";
// get a barcode image
using (System.Drawing.Image image = barcodeWriter.GetBarcodeAsBitmap())
{
// save the barcode image to a file
image.Save("HanXinCodeBarcode.png");
}
}
Aqui está o código C# que mostra como gerar o código de barras Han Xin Code em formato vetorial:
/// <summary>
/// Generates Han Xin Code barcode as graphics path.
/// </summary>
public System.Drawing.Drawing2D.GraphicsPath GenerateHanXinCodeBarcodeAsGraphicsPath()
{
// create the barcode writer
Vintasoft.Barcode.BarcodeWriter barcodeWriter = new Vintasoft.Barcode.BarcodeWriter();
// set barcode writer settings
barcodeWriter.Settings.Barcode = Vintasoft.Barcode.BarcodeType.HanXinCode;
barcodeWriter.Settings.Value = "012345abcde";
// return barcode as graphics path
return barcodeWriter.GetBarcodeAsGraphicsPath();
}
Aqui está o código C# que mostra como gerar o código de barras Han Xin Code como imagem SVG:
/// <summary>
/// Generates Han Xin Code barcode as SVG image.
/// </summary>
public string GenerateHanXinCodeBarcodeAsSvgImage()
{
// create the barcode writer
Vintasoft.Barcode.BarcodeWriter barcodeWriter = new Vintasoft.Barcode.BarcodeWriter();
// set barcode writer settings
barcodeWriter.Settings.Barcode = Vintasoft.Barcode.BarcodeType.HanXinCode;
barcodeWriter.Settings.Value = "012345abcde";
// return barcode as SVG image
return barcodeWriter.GetBarcodeAsSvgFile();
}
Aqui está o código C# que mostra como reconhecer o código de barras Han Xin Code em uma imagem:
/// <summary>
/// Recognizes Han Xin Code barcode in image.
/// </summary>
public void RecognizeHanXinCodeBarcode()
{
// create barcode reader
using (Vintasoft.Barcode.BarcodeReader reader = new Vintasoft.Barcode.BarcodeReader())
{
// specify that reader must search for Han Xin Code barcodes
reader.Settings.ScanBarcodeTypes = Vintasoft.Barcode.BarcodeType.HanXinCode;
// specify that reader must search for horizontal and vertical barcodes only
reader.Settings.ScanDirection = Vintasoft.Barcode.ScanDirection.Horizontal | Vintasoft.Barcode.ScanDirection.Vertical;
// read barcodes from image file
Vintasoft.Barcode.IBarcodeInfo[] barcodeInfos = reader.ReadBarcodes("HanXinCodeBarcode.png");
// if barcodes are not detected
if (barcodeInfos.Length == 0)
{
Console.WriteLine("Barcodes are not found.");
}
// if barcodes are detected
else
{
// get information about recognized barcodes
Console.WriteLine(string.Format("{0} barcode(s) found:", barcodeInfos.Length));
Console.WriteLine();
for (int i = 0; i < barcodeInfos.Length; i++)
{
Vintasoft.Barcode.IBarcodeInfo barcodeInfo = barcodeInfos[i];
Console.WriteLine(string.Format("[{0}:{1}]", i + 1, barcodeInfo.BarcodeType));
Console.WriteLine(string.Format("Value: {0}", barcodeInfo.Value));
Console.WriteLine(string.Format("Region: {0}", barcodeInfo.Region));
Console.WriteLine();
}
}
}
}
Aqui está o código C# que mostra como reconhecer e testar a qualidade de impressão do código de barras Han Xin Code em uma imagem:
/// <summary>
/// Recognizes and prints quality of Han Xin Code barcode in image.
/// </summary>
public void ReadBarcodesAndTestBarcodePrintQuality()
{
// load image with barcode from file
using (System.Drawing.Image barcodeImage = System.Drawing.Image.FromFile("HanXinCodeBarcode.png"))
{
// create the barcode reader
using (Vintasoft.Barcode.BarcodeReader reader = new Vintasoft.Barcode.BarcodeReader())
{
// specify that reader must search for Han Xin Code barcodes
reader.Settings.ScanBarcodeTypes = Vintasoft.Barcode.BarcodeType.HanXinCode;
// specify that reader must collect information for quality test
reader.Settings.CollectTestInformation = true;
// read barcodes
Vintasoft.Barcode.IBarcodeInfo[] barcodeInfos = reader.ReadBarcodes(barcodeImage);
// for each found barcode
for (int i = 0; i < barcodeInfos.Length; i++)
{
Vintasoft.Barcode.IBarcodeInfo barcodeInfo = barcodeInfos[i];
// print information about recognized barcode
Console.WriteLine(string.Format("[{0}:{1}]", i + 1, barcodeInfo.BarcodeType));
Console.WriteLine(string.Format("Value: {0}", barcodeInfo.Value));
Console.WriteLine(string.Format("Region: {0}", barcodeInfo.Region));
// test barcode print quality in accordance with ISO 15415
Vintasoft.Barcode.QualityTests.ISO15415QualityTest test = new Vintasoft.Barcode.QualityTests.ISO15415QualityTest();
test.CalculateGrades((Vintasoft.Barcode.BarcodeInfo.BarcodeInfo2D)barcodeInfo, barcodeImage);
// print results of barcode print quality test
Console.WriteLine("ISO15415 print quality test:");
Console.WriteLine(string.Format("- Decode : {0}", GradeToString(test.DecodeGrade)));
Console.WriteLine(string.Format("- Unused error correction : {0} ({1}%)", GradeToString(test.UnusedErrorCorrectionGrade), test.UnusedErrorCorrection));
Console.WriteLine(string.Format("- Symbol contrast : {0} ({1}%)", GradeToString(test.SymbolContrastGrade), test.SymbolContrast));
Console.WriteLine(string.Format("- Axial nonuniformity : {0} ({1})", GradeToString(test.AxialNonuniformityGrade), test.AxialNonuniformity));
Console.WriteLine(string.Format("- Grid nonuniformity : {0} ({1} cell)", GradeToString(test.GridNonuniformityGrade), test.GridNonuniformity));
Console.WriteLine(string.Format("- Modulation : {0}", GradeToString(test.ModulationGrade)));
Console.WriteLine(string.Format("- Reflectance margin : {0}", GradeToString(test.ReflectanceMarginGrade)));
Console.WriteLine(string.Format("- Fixed pattern damage : {0}", GradeToString(test.FixedPatternDamageGrade)));
Console.WriteLine(string.Format("- Distortion angle (informative) : {0}°", test.DistortionAngle));
Console.WriteLine();
}
}
}
}
/// <summary>
/// Converts ISO15415 quality grade into string value.
/// </summary>
static string GradeToString(Vintasoft.Barcode.QualityTests.ISO15415QualityGrade grade)
{
int gradeAsInt = (int)grade;
return string.Format("{0}({1})", gradeAsInt, grade);
}
Aqui está uma captura de tela da
VintaSoft Barcode Demo que mostra o resultado do teste de qualidade de impressão ISO/IEC 15415 para o código de barras Han Xin Code:
