Buat Gambar BarCode Khusus
Barcode adalah representasi visual dari data dalam bentuk garis atau pola sejajar. Barcode banyak digunakan di berbagai industri seperti ritel, logistik, kesehatan, perbankan, dan banyak lainnya.
Microsoft Word memungkinkan pengguna menyematkan kode batang langsung ke dalam dokumen menggunakan bidang. Pengguna dapat menyisipkan jenis kode batang tertentu, seperti kode QR atau kode batang linier, menggunakan BARCODE lapangan.
Pada artikel ini, kita akan melihat bagaimana bidang BARCODE diimplementasikan di Aspose.Words dan bagaimana Aspose.Words memungkinkan pengguna untuk bekerja dengan dokumen Word yang telah ditambahkan barcode.
Jenis Kode Batang yang Didukung oleh Aspose.Words
Aspose.Words mendukung berbagai jenis barcode. Jenis kode batang diteruskan sebagai nilai string di properti BarcodeType.
Saat menyimpan ke format Word yang mendukung kode batang, Anda dapat menggunakan semua jenis kode batang yang didukung diambil oleh Microsoft Word. Jika jenis kode batang yang diteruskan salah, Word akan menampilkan kesalahan.
Saat menyimpan ke format lain, seperti PDF, Aspose.Words mendelegasikan rendering kode batang ke kode pengguna, sehingga pengguna dibatasi pada jenis kode batang dari implementasi atau pustaka yang digunakan.
Menyisipkan Kode Batang ke dalam Dokumen atau Memuat Dokumen dengan Kode Batang yang Ditambahkan
Aspose.Words memberikan kemampuan untuk:
- Menyisipkan kode batang secara terprogram ke dalam dokumen menggunakan DisplayBarcode dan MergeBarcode kode bidang
- Atau muat dokumen Word dengan kode batang yang sudah dimasukkan ke dalamnya untuk pekerjaan lebih lanjut
Aspose.Words memiliki antarmuka untuk membuat kode batang khusus yang membuatnya mudah digunakan Aspose.Words dan Aspose.BarCode bersama-sama untuk merender gambar kode batang dalam dokumen keluaran. Misalnya, Anda dapat membuat dokumen DOC, OOXML, atau RTF dan menambahkan bidang DISPLAYBARCODE ke dalamnya menggunakan Aspose.Words. Atau Anda dapat memuat dokumen DOC, OOXML, atau RTF dengan bidang DISPLAYBARCODE yang sudah ada di dalamnya dan menyediakan implementasi generator kode batang khusus Anda.
Bidang DISPLAYBARCODE tipikal memiliki sintaks berikut:
{ DISPLAYBARCODE "SomeData" QR \h 720 }
Di bawah ini adalah contoh pembuat kode menggunakan Aspose.Words dan Aspose.BarCode APIs. Contoh ini menunjukkan cara menyisipkan gambar kode batang pada posisi bidang DISPLAYBARCODE dalam dokumen Word:
// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java.git. | |
Document doc = new Document(getMyDir() + "Field sample - BARCODE.docx"); | |
doc.getFieldOptions().setBarcodeGenerator(new CustomBarcodeGenerator()); | |
doc.save(getArtifactsDir() + "WorkingWithBarcodeGenerator.GenerateACustomBarCodeImage.pdf"); |
// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java.git. | |
public class CustomBarcodeGenerator extends DocsExamplesBase implements IBarcodeGenerator | |
{ | |
/// <summary> | |
/// Converts barcode image height from Word units to Aspose.BarCode units. | |
/// </summary> | |
/// <param name="heightInTwipsString"></param> | |
/// <returns></returns> | |
private static float convertSymbolHeight(String heightInTwipsString) throws Exception { | |
// Input value is in 1/1440 inches (twips). | |
int heightInTwips = tryParseInt(heightInTwipsString); | |
if (heightInTwips == Integer.MIN_VALUE) | |
throw new Exception("Error! Incorrect height - " + heightInTwipsString + "."); | |
// Convert to mm. | |
return (float) (heightInTwips * 25.4 / 1440.0); | |
} | |
/// <summary> | |
/// Converts barcode image color from Word to Aspose.BarCode. | |
/// </summary> | |
/// <param name="inputColor"></param> | |
/// <returns></returns> | |
private static Color convertColor(String inputColor) throws Exception { | |
// Input should be from "0x000000" to "0xFFFFFF". | |
int color = tryParseHex(inputColor.replace("0x", "")); | |
if (color == Integer.MIN_VALUE) | |
throw new Exception("Error! Incorrect color - " + inputColor + "."); | |
return new Color((color >> 16), ((color & 0xFF00) >> 8), (color & 0xFF)); | |
// Backward conversion - | |
// return string.Format("0x{0,6:X6}", mControl.ForeColor.ToArgb() & 0xFFFFFF); | |
} | |
/// <summary> | |
/// Converts bar code scaling factor from percent to float. | |
/// </summary> | |
/// <param name="scalingFactor"></param> | |
/// <returns></returns> | |
private static float convertScalingFactor(String scalingFactor) throws Exception { | |
boolean isParsed = false; | |
int percent = tryParseInt(scalingFactor); | |
if (percent != Integer.MIN_VALUE && percent >= 10 && percent <= 10000) | |
isParsed = true; | |
if (!isParsed) | |
throw new Exception("Error! Incorrect scaling factor - " + scalingFactor + "."); | |
return percent / 100.0f; | |
} | |
/// <summary> | |
/// Implementation of the GetBarCodeImage() method for IBarCodeGenerator interface. | |
/// </summary> | |
/// <param name="parameters"></param> | |
/// <returns></returns> | |
public BufferedImage getBarcodeImage(BarcodeParameters parameters) throws Exception { | |
if (parameters.getBarcodeType() == null || parameters.getBarcodeValue() == null) | |
return null; | |
BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.QR); | |
String type = parameters.getBarcodeType().toUpperCase(); | |
switch (type) | |
{ | |
case "QR": | |
generator = new BarcodeGenerator(EncodeTypes.QR); | |
break; | |
case "CODE128": | |
generator = new BarcodeGenerator(EncodeTypes.CODE_128); | |
break; | |
case "CODE39": | |
generator = new BarcodeGenerator(EncodeTypes.CODE_39_STANDARD); | |
break; | |
case "EAN8": | |
generator = new BarcodeGenerator(EncodeTypes.EAN_8); | |
break; | |
case "EAN13": | |
generator = new BarcodeGenerator(EncodeTypes.EAN_13); | |
break; | |
case "UPCA": | |
generator = new BarcodeGenerator(EncodeTypes.UPCA); | |
break; | |
case "UPCE": | |
generator = new BarcodeGenerator(EncodeTypes.UPCE); | |
break; | |
case "ITF14": | |
generator = new BarcodeGenerator(EncodeTypes.ITF_14); | |
break; | |
case "CASE": | |
generator = new BarcodeGenerator(EncodeTypes.NONE); | |
break; | |
} | |
if (generator.getBarcodeType().equals(EncodeTypes.NONE)) | |
return null; | |
generator.setCodeText(parameters.getBarcodeValue()); | |
if (generator.getBarcodeType().equals(EncodeTypes.QR)) | |
generator.getParameters().getBarcode().getCodeTextParameters().setTwoDDisplayText(parameters.getBarcodeValue()); | |
if (parameters.getForegroundColor() != null) | |
generator.getParameters().getBarcode().setBarColor(convertColor(parameters.getForegroundColor())); | |
if (parameters.getBackgroundColor() != null) | |
generator.getParameters().setBackColor(convertColor(parameters.getBackgroundColor())); | |
if (parameters.getSymbolHeight() != null) | |
{ | |
generator.getParameters().getImageHeight().setPixels(convertSymbolHeight(parameters.getSymbolHeight())); | |
generator.getParameters().setAutoSizeMode(AutoSizeMode.NONE); | |
} | |
generator.getParameters().getBarcode().getCodeTextParameters().setLocation(CodeLocation.NONE); | |
if (parameters.getDisplayText()) | |
generator.getParameters().getBarcode().getCodeTextParameters().setLocation(CodeLocation.BELOW); | |
generator.getParameters().getCaptionAbove().setText(""); | |
// Empiric scaling factor for converting Word barcode to Aspose.BarCode. | |
final float SCALE = 2.4f; | |
float xdim = 1.0f; | |
if (generator.getBarcodeType().equals(EncodeTypes.QR)) | |
{ | |
generator.getParameters().setAutoSizeMode(AutoSizeMode.NEAREST); | |
generator.getParameters().getImageWidth().setInches(generator.getParameters().getImageWidth().getInches() * SCALE); | |
generator.getParameters().getImageHeight().setInches(generator.getParameters().getImageWidth().getInches()); | |
xdim = generator.getParameters().getImageHeight().getInches() / 25; | |
generator.getParameters().getBarcode().getXDimension().setInches(xdim); | |
generator.getParameters().getBarcode().getBarHeight().setInches(xdim); | |
} | |
if (parameters.getScalingFactor() != null) | |
{ | |
float scalingFactor = convertScalingFactor(parameters.getScalingFactor()); | |
generator.getParameters().getImageHeight().setInches(generator.getParameters().getImageHeight().getInches() * scalingFactor); | |
if (generator.getBarcodeType().equals(EncodeTypes.QR)) | |
{ | |
generator.getParameters().getImageWidth().setInches(generator.getParameters().getImageHeight().getInches()); | |
generator.getParameters().getBarcode().getXDimension().setInches(xdim * scalingFactor); | |
generator.getParameters().getBarcode().getBarHeight().setInches(xdim * scalingFactor); | |
} | |
generator.getParameters().setAutoSizeMode(AutoSizeMode.NONE); | |
} | |
return generator.generateBarCodeImage(); | |
} | |
/// <summary> | |
/// Implementation of the GetOldBarcodeImage() method for IBarCodeGenerator interface. | |
/// </summary> | |
/// <param name="parameters"></param> | |
/// <returns></returns> | |
public BufferedImage getOldBarcodeImage(BarcodeParameters parameters) | |
{ | |
if (parameters.getPostalAddress() == null) | |
return null; | |
BarcodeGenerator generator = new BarcodeGenerator(EncodeTypes.POSTNET); | |
{ | |
generator.setCodeText(parameters.getPostalAddress()); | |
} | |
return generator.generateBarCodeImage(); | |
} | |
/// <summary> | |
/// Parses an integer using the invariant culture. Returns Int.MinValue if cannot parse. | |
/// | |
/// Allows leading sign. | |
/// Allows leading and trailing spaces. | |
/// </summary> | |
public static int tryParseInt(String s) { | |
try { | |
double value = Double.parseDouble(s); | |
return castDoubleToInt(value); | |
} catch (NumberFormatException e) { | |
return Integer.MIN_VALUE; | |
} | |
} | |
/// <summary> | |
/// Casts a double to int32 in a way that uint32 are "correctly" casted too (they become negative numbers). | |
/// </summary> | |
public static int castDoubleToInt(double value) | |
{ | |
long temp = (long) value; | |
return (int) temp; | |
} | |
/// <summary> | |
/// Try parses a hex String into an integer value. | |
/// on error return int.MinValue | |
/// </summary> | |
public static int tryParseHex(String s) | |
{ | |
try { | |
return Integer.parseInt(s); | |
} catch (NumberFormatException e) { | |
return Integer.MIN_VALUE; | |
} | |
} | |
} |
Anda juga dapat menyimpan dokumen dengan kode batang yang dimuat atau yang baru disisipkan dalam format halaman tetap seperti PDF, XPS, dll. Contoh kode berikut menunjukkan cara menyimpan dokumen Word ke format PDF:
// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java.git. | |
Document doc = new Document(getMyDir() + "Document.docx"); | |
doc.save(getArtifactsDir() + "BaseConversions.DocxToPdf.pdf"); |
Tentukan Opsi Kode Batang
Saat bekerja dengan kode batang, Anda dapat mengatur beberapa properti tambahan. Aspose.Words memberi Anda kelas BarcodeParameters - kelas untuk parameter kode batang yang diteruskan ke BarcodeGenerator.
Aspose.Words mendukung resolusi 96 ppi tersemat untuk gambar yang dihasilkan dengan IBarcodeGenerator, yang membatasi ukuran minimum gambar kode batang. Untuk mengatasinya, pengembang dapat menyisipkan gambar kode batang dengan resolusi target secara manual ke dalam dokumen Word dan menyimpannya dalam format yang diperlukan. Untuk detail lebih lanjut dan contoh bekerja dengan kode batang, lihat artikel Baca Kode Batang dari Word Dokumen.