ReverseBox 0.36.0__tar.gz → 0.38.0__tar.gz

{reversebox-0.36.0 → reversebox-0.38.0}/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.1
 Name: ReverseBox
-Version: 0.36.0
+Version: 0.38.0
 Summary: A set of functions useful in reverse engineering.
 Home-page: https://github.com/bartlomiejduda/ReverseBox
 Author: Bartlomiej Duda
 Author-email: ikskoks@gmail.com
-Keywords: ReverseBox,reverse engineering,RE,CRC,Hash,Encryption,Compression,Checksum,Python,image,decode,decoding,RGB,swizzle,swizzling,morton,twiddle,twiddling,texture,UYVY,YUY2,NV21,NV12,RGBA,RGBA8888,RGB565,RGBA8,BGR,grayscale,graphics,color,pixel,convert,converting,YUV,RAW,PSP,PS1,PS2,PS3,PS4,XBOX,X360,gamecube,dreamcast,BC,BC1,BC2,BC3,BC4,BC5,BC6,BC7,DXT1,DXT2,DXT3,PackBits,RLE,Macintosh,Jenkins,murmur,murmur3,one-at-a-time,additive
+Keywords: ReverseBox,reverse engineering,RE,CRC,Hash,Encryption,Compression,Checksum,Python,image,decode,decoding,RGB,swizzle,swizzling,morton,twiddle,twiddling,texture,UYVY,YUY2,NV21,NV12,RGBA,RGBA8888,RGB565,RGBA8,BGR,grayscale,graphics,color,pixel,convert,converting,YUV,RAW,PSP,PS1,PS2,PS3,PS4,XBOX,X360,gamecube,dreamcast,BC,BC1,BC2,BC3,BC4,BC5,BC6,BC7,DXT1,DXT2,DXT3,PackBits,RLE,Macintosh,Jenkins,murmur,murmur3,one-at-a-time,additive,ASTC,ETC1,ETC2
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.6
 Classifier: Programming Language :: Python :: 3.7
@@ -193,6 +193,9 @@ or software researchers).
   - Decode/Encode BC5 ✔️
   - Decode/Encode BC6 ✔️
   - Decode/Encode BC7 ✔️
+  - Decode/Encode ASTC_4x4
+  - Decode/Encode ASTC_5x4
+  - Decode/Encode ASTC_5x5
   - Decode GST121 ✔️
   - Decode GST221 ✔️
   - Decode GST421 ✔️

{reversebox-0.36.0 → reversebox-0.38.0}/README.md

@@ -156,6 +156,9 @@ or software researchers).
   - Decode/Encode BC5 ✔️
   - Decode/Encode BC6 ✔️
   - Decode/Encode BC7 ✔️
+  - Decode/Encode ASTC_4x4
+  - Decode/Encode ASTC_5x4
+  - Decode/Encode ASTC_5x5
   - Decode GST121 ✔️
   - Decode GST221 ✔️
   - Decode GST421 ✔️

{reversebox-0.36.0 → reversebox-0.38.0}/ReverseBox.egg-info/PKG-INFO

@@ -1,11 +1,11 @@
 Metadata-Version: 2.1
 Name: ReverseBox
-Version: 0.36.0
+Version: 0.38.0
 Summary: A set of functions useful in reverse engineering.
 Home-page: https://github.com/bartlomiejduda/ReverseBox
 Author: Bartlomiej Duda
 Author-email: ikskoks@gmail.com
-Keywords: ReverseBox,reverse engineering,RE,CRC,Hash,Encryption,Compression,Checksum,Python,image,decode,decoding,RGB,swizzle,swizzling,morton,twiddle,twiddling,texture,UYVY,YUY2,NV21,NV12,RGBA,RGBA8888,RGB565,RGBA8,BGR,grayscale,graphics,color,pixel,convert,converting,YUV,RAW,PSP,PS1,PS2,PS3,PS4,XBOX,X360,gamecube,dreamcast,BC,BC1,BC2,BC3,BC4,BC5,BC6,BC7,DXT1,DXT2,DXT3,PackBits,RLE,Macintosh,Jenkins,murmur,murmur3,one-at-a-time,additive
+Keywords: ReverseBox,reverse engineering,RE,CRC,Hash,Encryption,Compression,Checksum,Python,image,decode,decoding,RGB,swizzle,swizzling,morton,twiddle,twiddling,texture,UYVY,YUY2,NV21,NV12,RGBA,RGBA8888,RGB565,RGBA8,BGR,grayscale,graphics,color,pixel,convert,converting,YUV,RAW,PSP,PS1,PS2,PS3,PS4,XBOX,X360,gamecube,dreamcast,BC,BC1,BC2,BC3,BC4,BC5,BC6,BC7,DXT1,DXT2,DXT3,PackBits,RLE,Macintosh,Jenkins,murmur,murmur3,one-at-a-time,additive,ASTC,ETC1,ETC2
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.6
 Classifier: Programming Language :: Python :: 3.7
@@ -193,6 +193,9 @@ or software researchers).
   - Decode/Encode BC5 ✔️
   - Decode/Encode BC6 ✔️
   - Decode/Encode BC7 ✔️
+  - Decode/Encode ASTC_4x4
+  - Decode/Encode ASTC_5x4
+  - Decode/Encode ASTC_5x5
   - Decode GST121 ✔️
   - Decode GST221 ✔️
   - Decode GST421 ✔️

{reversebox-0.36.0 → reversebox-0.38.0}/ReverseBox.egg-info/SOURCES.txt

@@ -82,6 +82,7 @@ reversebox/image/decoders/bumpmap_decoder.py
 reversebox/image/decoders/compressed_decoder_encoder.py
 reversebox/image/decoders/gst_decoder.py
 reversebox/image/decoders/n64_decoder.py
+reversebox/image/decoders/pvrtexlib_decoder_encoder.py
 reversebox/image/decoders/yuv_decoder.py
 reversebox/image/encoders/__init__.py
 reversebox/image/encoders/gst_encoder.py
@@ -114,5 +115,9 @@ reversebox/io_files/file_handler.py
 reversebox/io_files/mod_handler.py
 reversebox/io_files/translation_text_handler.py
 reversebox/libs/DirectXTex.dll
+reversebox/libs/PVRTexLib.dll
+reversebox/libs/TexWrapper.dll
 reversebox/libs/__init__.py
+reversebox/libs/crnlib.dll
+reversebox/libs/ispc_texcomp.dll
 reversebox/libs/refpack.dll

{reversebox-0.36.0 → reversebox-0.38.0}/reversebox/image/common.py

@@ -223,6 +223,10 @@ def get_block_data_size(img_format: ImageFormats) -> int:
         return 1
 
 
+def get_bc_image_data_size(image_height: int, image_width: int, image_format: ImageFormats) -> int:
+    return ((image_height + 3) // 4) * ((image_width + 3) // 4) * get_block_data_size(image_format)
+
+
 def calculate_aligned_value(value: int, multiple: int) -> int:
     return ((value + multiple - 1) // multiple) * multiple
 

{reversebox-0.36.0 → reversebox-0.38.0}/reversebox/image/decoders/compressed_decoder_encoder.py

@@ -17,6 +17,7 @@ from ctypes import (
 
 from reversebox.common.common import get_dll_path
 from reversebox.common.logger import get_logger
+from reversebox.image.common import get_bc_image_data_size
 from reversebox.image.image_formats import ImageFormats
 
 logger = get_logger(__name__)
@@ -41,7 +42,7 @@ class DXGIImage(Structure):
 
 class CompressedImageDecoderEncoder:
     """
-    Decoder for any compressed images like BC1/DXT1, BC2/DXT2 etc.
+    Decoder/Encoder for any compressed images like BC1/DXT1, BC2/DXT2 etc.
     """
 
     def __init__(self):
@@ -94,7 +95,7 @@ class CompressedImageDecoderEncoder:
 
     def _convert_directxtex_image(self, image_data: bytes, img_width: int, img_height: int, image_format: ImageFormats, encode_flag: bool) -> bytes:
         """
-        Function used for decoding compressed BC formats
+        Function used for decoding/encoding compressed BC formats
         """
         dll_path: str = get_dll_path("DirectXTex.dll")
         if encode_flag:
@@ -147,9 +148,12 @@ class CompressedImageDecoderEncoder:
         if h_result != 0:
             raise Exception(f"DLL decompression failed! H_result: {h_result}")
 
-        decoded_data_size: int = img_height * img_width * 4
-        decoded_data = bytearray((c_uint8 * decoded_data_size).from_address(ctypes.addressof(output_dxgi_image.pixels.contents)))
-        return decoded_data
+        if encode_flag:
+            converted_data_size: int = get_bc_image_data_size(img_height, img_width, image_format)
+        else:
+            converted_data_size: int = img_height * img_width * 4
+        converted_data = bytearray((c_uint8 * converted_data_size).from_address(ctypes.addressof(output_dxgi_image.pixels.contents)))
+        return converted_data
 
     def decode_compressed_image_main(self, image_data: bytes, img_width: int, img_height: int, image_format: ImageFormats) -> bytes:
         return self._convert_directxtex_image(image_data, img_width, img_height, image_format, False)

reversebox-0.38.0/reversebox/image/decoders/pvrtexlib_decoder_encoder.py

@@ -0,0 +1,96 @@
+"""
+Copyright © 2025  Bartłomiej Duda
+License: GPL-3.0 License
+"""
+
+import ctypes
+from ctypes import POINTER, c_int, c_uint8, cast, create_string_buffer
+
+from reversebox.common.common import get_dll_path
+from reversebox.common.logger import get_logger
+from reversebox.image.image_formats import ImageFormats
+
+logger = get_logger(__name__)
+
+# fmt: off
+# mypy: ignore-errors
+
+
+pvrtexlib_format_mapping: dict[ImageFormats, int] = {
+        ImageFormats.RGB565: 7,
+        ImageFormats.ASTC_4x4: 48,
+        ImageFormats.ASTC_5x4: 70,
+        ImageFormats.ASTC_5x5: 49,
+    }
+
+
+class PvrTexlibImageDecoderEncoder:
+    """
+    Decoder/Encoder for any compressed images like ASTC, ETC1 etc.
+    """
+
+    def __init__(self):
+        pass
+
+    def _get_pvrtexlib_format_number(self, image_format: ImageFormats) -> int:
+        """
+        Mapping ReverseBox formats to PvrTexLib formats
+        """
+
+        try:
+            return pvrtexlib_format_mapping[image_format]
+        except KeyError:
+            raise Exception(f"Not supported image format! Image_format: {image_format}")
+
+    def _convert_pvrtexlib_image(self, image_data: bytes, img_width: int, img_height: int, image_format: ImageFormats, encode_flag: bool) -> bytes:
+        """
+        Function used for decoding/encoding compressed PvrTexlib formats
+        """
+        dll_path: str = get_dll_path("TexWrapper.dll")
+
+        input_format_number: int = self._get_pvrtexlib_format_number(image_format)
+        output_buffer_size: int = img_height * img_width * 4
+
+        c_format_number = c_int(input_format_number)
+        c_image_width = c_int(img_width)
+        c_image_height = c_int(img_height)
+        c_comp_level = c_int(1)
+
+        input_buffer = create_string_buffer(bytes(image_data))
+        c_input_buffer = cast(input_buffer, POINTER(c_uint8))  # buffer with input image data
+        c_output_buffer = (c_uint8 * output_buffer_size)()  # empty buffer for output image data
+
+        try:
+            dll_file = ctypes.CDLL(dll_path)
+
+            if encode_flag:
+                output_size: int = dll_file.EncodeByPVRTexLib(
+                    c_input_buffer,
+                    c_output_buffer,
+                    c_format_number,
+                    c_comp_level,
+                    c_image_width,
+                    c_image_height
+                )
+            else:
+                output_size: int = dll_file.DecodeByPVRTexLib(
+                    c_input_buffer,
+                    c_output_buffer,
+                    c_format_number,
+                    c_image_width,
+                    c_image_height
+                )
+        except Exception as error:
+            raise Exception(f"Error! Error: {error}")
+
+        if output_size == 0:
+            raise Exception("Output texture is empty!")
+
+        converted_data = bytearray((c_uint8 * output_size).from_address(ctypes.addressof(c_output_buffer)))
+        return converted_data
+
+    def decode_compressed_image_main(self, image_data: bytes, img_width: int, img_height: int, image_format: ImageFormats) -> bytes:
+        return self._convert_pvrtexlib_image(image_data, img_width, img_height, image_format, False)
+
+    def encode_compressed_image_main(self, image_data: bytes, img_width: int, img_height: int, image_format: ImageFormats) -> bytes:
+        return self._convert_pvrtexlib_image(image_data, img_width, img_height, image_format, True)

{reversebox-0.36.0 → reversebox-0.38.0}/reversebox/image/image_decoder.py

@@ -13,6 +13,9 @@ from reversebox.image.decoders.compressed_decoder_encoder import (
 )
 from reversebox.image.decoders.gst_decoder import GSTImageDecoder
 from reversebox.image.decoders.n64_decoder import N64Decoder
+from reversebox.image.decoders.pvrtexlib_decoder_encoder import (
+    PvrTexlibImageDecoderEncoder,
+)
 from reversebox.image.decoders.yuv_decoder import YUVDecoder
 from reversebox.image.image_formats import ImageFormats
 from reversebox.image.pillow_wrapper import PillowWrapper
@@ -796,6 +799,9 @@ class ImageDecoder:
     def decode_compressed_image(self, image_data: bytes, img_width: int, img_height: int, image_format: ImageFormats) -> bytes:
         return CompressedImageDecoderEncoder().decode_compressed_image_main(image_data, img_width, img_height, image_format)
 
+    def decode_pvrtexlib_image(self, image_data: bytes, img_width: int, img_height: int, image_format: ImageFormats) -> bytes:
+        return PvrTexlibImageDecoderEncoder().decode_compressed_image_main(image_data, img_width, img_height, image_format)
+
     def decode_gst_image(self, image_data: bytes, palette_data: bytes, img_width: int, img_height: int, image_format: ImageFormats, convert_format: ImageFormats, convert_pal_format: ImageFormats, is_swizzled: bool = True) -> bytes:
         gst_decoder = GSTImageDecoder()
         decoded_gst_data: bytes = gst_decoder.decode_gst_image_main(image_data, img_width, img_height, image_format, is_swizzled)

{reversebox-0.36.0 → reversebox-0.38.0}/reversebox/image/image_encoder.py

@@ -15,6 +15,9 @@ from reversebox.image.common import (
 from reversebox.image.decoders.compressed_decoder_encoder import (
     CompressedImageDecoderEncoder,
 )
+from reversebox.image.decoders.pvrtexlib_decoder_encoder import (
+    PvrTexlibImageDecoderEncoder,
+)
 from reversebox.image.image_formats import ImageFormats
 from reversebox.image.pillow_wrapper import PillowWrapper
 from reversebox.io_files.bytes_handler import BytesHandler
@@ -437,3 +440,6 @@ class ImageEncoder:
 
     def encode_compressed_image(self, image_data: bytes, img_width: int, img_height: int, image_format: ImageFormats) -> bytes:
         return CompressedImageDecoderEncoder().encode_compressed_image_main(image_data, img_width, img_height, image_format)
+
+    def encode_pvrtexlib_image(self, image_data: bytes, img_width: int, img_height: int, image_format: ImageFormats) -> bytes:
+        return PvrTexlibImageDecoderEncoder().encode_compressed_image_main(image_data, img_width, img_height, image_format)

{reversebox-0.36.0 → reversebox-0.38.0}/reversebox/image/image_formats.py

@@ -111,6 +111,9 @@ class ImageFormats(Enum):
     BC6H_UF16 = "bc6h_uf16"
     BC6H_SF16 = "bc6h_sf16"
     BC7_UNORM = "bc7_unorm"
+    ASTC_4x4 = "ASTC_4x4"
+    ASTC_5x4 = "ASTC_5x4"
+    ASTC_5x5 = "ASTC_5x5"
 
     # PS2 GS Texture Formats
     GST121 = "gst121"

{reversebox-0.36.0 → reversebox-0.38.0}/setup.py

@@ -8,7 +8,7 @@ from typing import Final
 
 import setuptools
 
-VERSION_NUM: Final[str] = "0.36.0"
+VERSION_NUM: Final[str] = "0.38.0"
 
 
 def get_long_description() -> str:
@@ -54,7 +54,7 @@ setuptools.setup(
     "RGB, swizzle, swizzling, morton, twiddle, twiddling, texture, UYVY, YUY2, NV21, NV12, RGBA, RGBA8888, RGB565, RGBA8, BGR, "
     "grayscale, graphics, color, pixel, convert, converting, YUV, RAW, PSP, PS1, PS2, PS3, PS4, XBOX, X360, gamecube, dreamcast, "
     "BC, BC1, BC2, BC3, BC4, BC5, BC6, BC7, DXT1, DXT2, DXT3, PackBits, RLE, Macintosh, Jenkins, murmur, murmur3, one-at-a-time, "
-    "additive",
+    "additive, ASTC, ETC1, ETC2",
     python_requires=">=3.6",
     install_requires=[
         "lzokay",