ReverseBox 0.26.2__tar.gz → 0.26.5__tar.gz

{reversebox-0.26.2 → reversebox-0.26.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ReverseBox
-Version: 0.26.2
+Version: 0.26.5
 Summary: A set of functions useful in reverse engineering.
 Home-page: https://github.com/bartlomiejduda/ReverseBox
 Author: Bartlomiej Duda
@@ -135,6 +135,7 @@ or software researchers).
   - Murmur3 ✔️ <span style="color:yellow">(wrapper only)</span>
   - (game-specific) Hercules (TODO) ❌
   - (game-specific) E-racer (TODO) ❌
+  - (game-specific) Pivotal Games DAT Hash ✔️
 
 * Image
   - Decode RGB121 ✔️

{reversebox-0.26.2 → reversebox-0.26.5}/README.md

@@ -98,6 +98,7 @@ or software researchers).
   - Murmur3 ✔️ <span style="color:yellow">(wrapper only)</span>
   - (game-specific) Hercules (TODO) ❌
   - (game-specific) E-racer (TODO) ❌
+  - (game-specific) Pivotal Games DAT Hash ✔️
 
 * Image
   - Decode RGB121 ✔️

{reversebox-0.26.2 → reversebox-0.26.5}/ReverseBox.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: ReverseBox
-Version: 0.26.2
+Version: 0.26.5
 Summary: A set of functions useful in reverse engineering.
 Home-page: https://github.com/bartlomiejduda/ReverseBox
 Author: Bartlomiej Duda
@@ -135,6 +135,7 @@ or software researchers).
   - Murmur3 ✔️ <span style="color:yellow">(wrapper only)</span>
   - (game-specific) Hercules (TODO) ❌
   - (game-specific) E-racer (TODO) ❌
+  - (game-specific) Pivotal Games DAT Hash ✔️
 
 * Image
   - Decode RGB121 ✔️

{reversebox-0.26.2 → reversebox-0.26.5}/ReverseBox.egg-info/SOURCES.txt

@@ -58,6 +58,7 @@ reversebox/hash/hash_jenkins_one_at_a_time.py
 reversebox/hash/hash_md2.py
 reversebox/hash/hash_md5.py
 reversebox/hash/hash_murmur3.py
+reversebox/hash/hash_pivotal_games_dat.py
 reversebox/hash/hash_sdbm.py
 reversebox/hash/hash_sha1.py
 reversebox/hash/hash_sha2.py

reversebox-0.26.5/reversebox/hash/hash_pivotal_games_dat.py

@@ -0,0 +1,48 @@
+"""
+Copyright © 2025  Bartłomiej Duda
+License: GPL-3.0 License
+"""
+
+import numpy as np
+
+# Pivotal Games DAT hash
+# Used for hashing filenames in DAT archives in games like:
+# - Conflict: Desert Storm
+# - Conflict: Desert Storm II
+# - Conflict: Vietnam
+# - Conflict: Global Terror
+# - Conflict: Denied Ops
+# - The Great Escape
+
+
+class PivotalGamesDATHashHandler:
+    def __init__(self):
+        pass
+
+    @staticmethod
+    def calculate_pivotal_games_dat_hash_from_string(input_string: str) -> int:
+        j = 0
+        dw_hash = np.int32(1)
+        b_counter = np.uint8(1)
+        dw_blocks = 8 * len(input_string)
+
+        if dw_blocks > 0:
+            for i in range(dw_blocks):
+                A = (dw_hash & 0x200000) != 0
+                B = (dw_hash & 2) != 0
+                C = (dw_hash & 1) != 0
+                D = dw_hash < 0
+
+                dw_hash *= 2
+
+                X = (ord(input_string[j]) & b_counter) != 0
+
+                if D ^ (A ^ B ^ C ^ X):
+                    dw_hash |= 1
+
+                b_counter *= 2
+                if b_counter == 0:
+                    j += 1
+                    b_counter = np.uint8(1)
+
+        return int(np.uint32(dw_hash))

{reversebox-0.26.2 → reversebox-0.26.5}/reversebox/image/image_decoder.py

@@ -656,7 +656,7 @@ class ImageDecoder:
             palette_offset += palette_entry_size
             palette_data_ints.append(palette_entry_int)
 
-        if img_bits_per_pixel == 4:
+        if img_bits_per_pixel == 4:  # e.g. PAL4
             for i in range(0, img_width * img_height, 2):
                 palette_index: bytes = image_handler.get_bytes(image_offset, 1)
                 palette_index_int: int = struct.unpack(image_endianess_format + "B", palette_index or b'\x00')[0]
@@ -669,17 +669,23 @@ class ImageDecoder:
                 else:
                     raise Exception(f"Endianess not supported! Endianess: {image_endianess}")
                 image_offset += 1
-        elif img_bits_per_pixel == 8:
+        elif img_bits_per_pixel == 8:  # e.g. PAL8
             for i in range(img_width * img_height):
                 palette_index: bytes = image_handler.get_bytes(image_offset, 1)
                 palette_index_int: int = struct.unpack(image_endianess_format + "B", palette_index or b'\x00')[0]
                 texture_data[i * 4:(i + 1) * 4] = decode_function(self, palette_data_ints[palette_index_int])  # noqa
                 image_offset += 1
-        elif img_bits_per_pixel == 16:
+        elif img_bits_per_pixel == 16:  # e.g. PAL16
             for i in range(img_width * img_height):
                 if image_format is ImageFormats.PAL_I8A8:
-                    palette_index: bytes = image_handler.get_bytes(image_offset, 1)
-                    alpha_value: bytes = image_handler.get_bytes(image_offset+1, 1)
+                    if image_endianess == "little":
+                        palette_index: bytes = image_handler.get_bytes(image_offset, 1)
+                        alpha_value: bytes = image_handler.get_bytes(image_offset+1, 1)
+                    elif image_endianess == "big":
+                        palette_index: bytes = image_handler.get_bytes(image_offset+1, 1)
+                        alpha_value: bytes = image_handler.get_bytes(image_offset, 1)
+                    else:
+                        raise Exception(f"Endianess not supported! Endianess: {image_endianess}")
                     palette_index_int: int = struct.unpack(image_endianess_format + "B", palette_index or b'\x00')[0]
                     alpha_value_int: int = struct.unpack(image_endianess_format + "B", alpha_value or b'\x00')[0]
                     output_bytes: bytes = decode_function(self, palette_data_ints[palette_index_int])  # noqa
@@ -698,13 +704,23 @@ class ImageDecoder:
 
                     texture_data[i * 4:(i + 1) * 4] = decoded_bytes
                 else:
-                    palette_index: bytes = image_handler.get_bytes(image_offset, 1)  # PAL16 = I8P8
+                    if image_endianess == "little":
+                        palette_index: bytes = image_handler.get_bytes(image_offset, 1)
+                    elif image_endianess == "big":
+                        palette_index: bytes = image_handler.get_bytes(image_offset+1, 1)
+                    else:
+                        raise Exception(f"Endianess not supported! Endianess: {image_endianess}")
                     palette_index_int: int = struct.unpack(image_endianess_format + "B", palette_index or b'\x00')[0]
                     texture_data[i * 4:(i + 1) * 4] = decode_function(self, palette_data_ints[palette_index_int])  # noqa
                 image_offset += 2
-        elif img_bits_per_pixel == 32:
+        elif img_bits_per_pixel == 32:  # e.g. PAL32
             for i in range(img_width * img_height):
-                palette_index: bytes = image_handler.get_bytes(image_offset, 1)  # PAL32 = I8P24
+                if image_endianess == "little":
+                    palette_index: bytes = image_handler.get_bytes(image_offset, 1)
+                elif image_endianess == "big":
+                    palette_index: bytes = image_handler.get_bytes(image_offset+3, 1)
+                else:
+                    raise Exception(f"Endianess not supported! Endianess: {image_endianess}")
                 palette_index_int: int = struct.unpack(image_endianess_format + "B", palette_index or b'\x00')[0]
                 texture_data[i * 4:(i + 1) * 4] = decode_function(self, palette_data_ints[palette_index_int])  # noqa
                 image_offset += 4

{reversebox-0.26.2 → reversebox-0.26.5}/setup.py

@@ -8,7 +8,7 @@ from typing import Final
 
 import setuptools
 
-VERSION_NUM: Final[str] = "0.26.2"
+VERSION_NUM: Final[str] = "0.26.5"
 
 
 def get_long_description() -> str: