aspose-barcode-for-python-via-java 25.6.0__tar.gz → 25.8.0__tar.gz

{aspose-barcode-for-python-via-java-25.6.0 → aspose-barcode-for-python-via-java-25.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: aspose-barcode-for-python-via-java
-Version: 25.6.0
+Version: 25.8.0
 Summary: Barcode generation and recognition component. It allows developers to quickly and easily add barcode creation and scanning functionality to their Python applications.
 Home-page: UNKNOWN
 Author: Aspose

{aspose-barcode-for-python-via-java-25.6.0 → aspose-barcode-for-python-via-java-25.8.0}/aspose_barcode_for_python_via_java.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: aspose-barcode-for-python-via-java
-Version: 25.6.0
+Version: 25.8.0
 Summary: Barcode generation and recognition component. It allows developers to quickly and easily add barcode creation and scanning functionality to their Python applications.
 Home-page: UNKNOWN
 Author: Aspose

{aspose-barcode-for-python-via-java-25.6.0 → aspose-barcode-for-python-via-java-25.8.0}/aspose_barcode_for_python_via_java.egg-info/SOURCES.txt

@@ -11,6 +11,6 @@ asposebarcode/ComplexBarcode.py
 asposebarcode/Generation.py
 asposebarcode/Recognition.py
 asposebarcode/__init__.py
-asposebarcode/jlib/aspose-barcode-python-25.6.jar
+asposebarcode/jlib/aspose-barcode-python-25.8.jar
 license/End+User+License+Agreement.html
 license/ThirdPartyLicenses.Aspose.BarCode.Java.pdf

{aspose-barcode-for-python-via-java-25.6.0 → aspose-barcode-for-python-via-java-25.8.0}/asposebarcode/Generation.py

@@ -87,16 +87,47 @@ class BarcodeGenerator(Assist.BaseJavaClass):
 
     def setCodeText(self, codeText: Union[str, bytes], encoding: Optional[str], BoM: Optional[bool]) -> None:
         """
-        Encodes codetext with a byte order mark (BOM) using the specified encoding.
-        @param codeText: The CodeText string or bytes.
-                      If a bytes object is provided, it will be encoded to Base64.
-        @param encoding: The encoding to apply when processing the string value.
-
-        @param BoM: flag indicates insertion of the Encoding byte order mark (BOM). In case, the Encoding requires byte order mark (BOM) insertion: like UTF8,
-         UTF16, UTF32, e.t.c. and flag is set to true, the BOM is added, in case of setting flag to false, the BOM insertion is ignored.
-
-        If 'value' is a bytes object, it is encoded using Base64.
-        If 'value' is a string, it's passed to 'setCodeText' of the Java class along with the specified encoding.
+        <p>
+         <p>
+         Encodes the Unicode {@code <b>codeText</b>} into a byte sequence using the specified {@code <b>encoding</b>}.
+         UTF-8 is the most commonly used encoding.
+         If the encoding supports it and {@code <b>insertBOM</b>} is set to {@code true}, the function includes a
+         {@code <a href="https://en.wikipedia.org/wiki/Byte_order_mark#Byte-order_marks_by_encoding">byte order mark (BOM)</a>}.
+         </p>
+         <p>
+         This function is intended for use with 2D barcodes only (e.g., Aztec, QR, DataMatrix, PDF417, MaxiCode, DotCode, HanXin, RectMicroQR, etc.).
+         It enables manual encoding of Unicode text using national or special encodings; however, this method is considered obsolete in modern applications.
+         For modern use cases, {@code <a href="https://en.wikipedia.org/wiki/Extended_Channel_Interpretation">ECI</a>} encoding is recommended for Unicode data.
+         </p>
+         <p>
+         Using this function with 1D barcodes, GS1-compliant barcodes (including 2D), or HIBC barcodes (including 2D) is not supported by the corresponding barcode standards and may lead to unpredictable results.
+         </p>
+         </p><p><hr><blockquote><pre>
+         <p>This example shows how to use {@code SetCodeText} with or without a BOM for 2D barcodes.</p>
+         <pre>
+            # Encode codetext using UTF-8 with BOM
+            gen = BarcodeGenerator(EncodeTypes.QR, None)
+            gen.setCodeText("車種名", "UTF-8", True)
+            gen.save("barcode.png", BarCodeImageFormat.PNG)
+            reader = new BarCodeReader("barcode.png", None, DecodeType.QR)
+            for result in reader.readBarCodes():
+                print("BarCode CodeText: " + result.getCodeText())
+
+
+            # Encode codetext using UTF-8 without BOM
+            gen = new BarcodeGenerator(EncodeTypes.QR, None)
+            gen.setCodeText("車種名", "UTF-8", false)
+            gen.save("barcode.png", BarCodeImageFormat.PNG)
+            reader = new BarCodeReader("barcode.png", None, DecodeType.QR)
+            for result in reader.readBarCodes():
+                print("BarCode CodeText: " + result.getCodeText())
+            </pre>
+         </pre></blockquote></hr></p>
+        @param codeText CodeText string
+        @param encoding Applied encoding
+        @param insertBOM
+         Indicates whether to insert a byte order mark (BOM) when the specified encoding supports it (e.g., UTF-8, UTF-16, UTF-32).
+         If set to {@code true}, the BOM is added; if {@code false}, the BOM is omitted even if the encoding normally uses one.
         """
         if isinstance(codeText, bytes):
             base64_bytes = base64.b64encode(codeText)
@@ -3900,6 +3931,20 @@ class PdfParameters(Assist.BaseJavaClass):
         formatted = None if value is None else value.formatCMYK()
         self.getJavaClass().setCMYKCaptionBelowColor(formatted)
 
+    def isTextAsPath(self) -> bool:
+        """
+        Are paths used instead of text (use if Unicode characters are not displayed)
+        Default value: false.
+        """
+        return self.getJavaClass().isTextAsPath()
+
+    def setTextAsPath(self, value : bool) -> None:
+        """
+          Are paths used instead of text (use if Unicode characters are not displayed)
+          Default value: false.
+        """
+        self.getJavaClass().setTextAsPathSync(value)
+
 class CMYKColor:
     """
     Class for CMYK color. None means CMYK is not used, default RGB color is in use.

{aspose-barcode-for-python-via-java-25.6.0 → aspose-barcode-for-python-via-java-25.8.0}/asposebarcode/Recognition.py

@@ -990,12 +990,26 @@ class BarCodeResult(Assist.BaseJavaClass):
         """
         return BarCodeConfidence(str(self.getJavaClass().getConfidence()))
 
-    def getCodeText(self) -> str:
-        """!
-        Gets the code text.
-        Value: The code text of the barcode.
+    def getCodeText(self, encoding: Optional[str]) -> str:
+        """!
+        <p>
+         Gets the code text with encoding.
+         </p><p><hr><blockquote><pre>
+         <p>This example shows how to use {@code GetCodeText}:</p>
+         <pre>
+         gen = BarcodeGenerator(EncodeTypes.DATA_MATRIX, None);
+         gen.setCodeText("車種名", "932");
+         gen.save("barcode.png", BarCodeImageFormat.PNG);
+
+         reader = BarCodeReader("barcode.png", None, DecodeType.DATA_MATRIX);
+         for result in reader.readBarCodes():
+             console.log("BarCode CodeText: " + result.getCodeText("932"))
+         </pre>
+         </pre></blockquote></hr></p>
+        @return A string containing recognized code text.
+        @param encoding The encoding for codetext.
         """
-        value = self.getJavaClass().getCodeText()
+        value = self.getJavaClass().getCodeText(encoding)
         return str(value) if value is not None else None
 
     def getCodeBytes(self) -> List[str]:

{aspose-barcode-for-python-via-java-25.6.0 → aspose-barcode-for-python-via-java-25.8.0}/asposebarcode/__init__.py

@@ -3,6 +3,6 @@ import os
 from asposebarcode import Generation, Recognition, Assist
 
 __asposebarcode_dir__ = os.path.dirname(__file__)
-__barcode_jar_path__ = __asposebarcode_dir__ + "/jlib/aspose-barcode-python-25.6.jar"
+__barcode_jar_path__ = __asposebarcode_dir__ + "/jlib/aspose-barcode-python-25.8.jar"
 jpype.startJVM(jpype.getDefaultJVMPath(), "-Djava.class.path=%s" % __barcode_jar_path__)
 __all__ = ['Assist','Recognition','Generation','ComplexBarcode']

{aspose-barcode-for-python-via-java-25.6.0 → aspose-barcode-for-python-via-java-25.8.0}/setup.py

@@ -1,7 +1,7 @@
 from setuptools import setup
 
 NAME = "aspose-barcode-for-python-via-java"
-VERSION = "25.6.0"
+VERSION = "25.8.0"
 REQUIRES = ["JPype1==1.4.1"]
 
 setup(