mirror of
https://github.com/zeldaret/af.git
synced 2026-09-28 14:50:04 -04:00
Anghelo Carvajal
94b300b0d0
* start * match the file * actor_dlftbls_num * script to extract the actor table * bootstrap actor table * ActorId enum * migrate actor table * reorganize overlays in subfolders * Fix Player * migrate bss * cleanup and format * ActorProfile * Move player_actor to actors folder * RomOffset * ACTOR_ID_MAX
124 lines
3.7 KiB
Python
Executable File
124 lines
3.7 KiB
Python
Executable File
#!/usr/bin/env python3
|
|
|
|
# SPDX-FileCopyrightText: © 2023 ZeldaRET
|
|
# SPDX-License-Identifier: MIT
|
|
|
|
from __future__ import annotations
|
|
|
|
import argparse
|
|
import dataclasses
|
|
from pathlib import Path
|
|
import struct
|
|
|
|
|
|
ENTRY_SIZE = 0x20
|
|
|
|
@dataclasses.dataclass
|
|
class ActorOverlay:
|
|
vromStart: int # uintptr_t
|
|
vromEnd: int # uintptr_t
|
|
vramStart: int # void*
|
|
vramEnd: int # void*
|
|
loadedRamAddr: int # void*
|
|
profile: int # ActorProfile*
|
|
name: int # char*
|
|
allocType: int # u16
|
|
numLoaded: int # s8
|
|
|
|
def rawstr(self) -> str:
|
|
result = f"0x{self.vromStart:08X}, "
|
|
result += f"0x{self.vromEnd:08X}, "
|
|
result += f"0x{self.vramStart:08X}, "
|
|
result += f"0x{self.vramEnd:08X}, "
|
|
result += f"0x{self.loadedRamAddr:08X}, "
|
|
result += f"0x{self.profile:08X}, "
|
|
result += f"0x{self.name:08X}, "
|
|
result += f"{self.allocType}, "
|
|
result += f"{self.numLoaded}"
|
|
|
|
return result
|
|
|
|
def allocTypeStr(self) -> str:
|
|
if self.allocType == 0:
|
|
return "ALLOCTYPE_NORMAL"
|
|
if self.allocType == 1:
|
|
return "ALLOCTYPE_ABSOLUTE"
|
|
if self.allocType == 2:
|
|
return "ALLOCTYPE_PERMANENT"
|
|
return "ALLOCTYPE_ERROR"
|
|
|
|
def _macroEntry_Unset(self, index: int) -> str:
|
|
return f"DEFINE_ACTOR_UNSET(ACTOR_UNSET_{index})"
|
|
|
|
def _macroEntry_Internal(self, index: int) -> str:
|
|
return f"DEFINE_ACTOR_INTERNAL(_{self.vromStart:08X}, ACTOR_{index}, {self.allocTypeStr()})"
|
|
|
|
def _macroEntry_Normal(self, index: int) -> str:
|
|
return f"DEFINE_ACTOR(_{self.vromStart:08X}, ACTOR_{index}, {self.allocTypeStr()})"
|
|
|
|
def isUnset(self) -> bool:
|
|
return self.profile == 0
|
|
def isInternal(self) -> bool:
|
|
return not self.isUnset() and self.vromStart == 0
|
|
def isNormal(self) -> bool:
|
|
if self.isUnset() or self.isInternal():
|
|
return False
|
|
return True
|
|
|
|
def macroEntry(self, index: int) -> str:
|
|
if self.isUnset():
|
|
return self._macroEntry_Unset(index)
|
|
elif self.isInternal():
|
|
return self._macroEntry_Internal(index)
|
|
return self._macroEntry_Normal(index)
|
|
|
|
def renames(self) -> str:
|
|
result = f""
|
|
|
|
if self.profile != 0:
|
|
result += f"D_{self.profile:08X}_jp,_{self.vromStart:08X}_Profile\n"
|
|
if self.vromStart != 0:
|
|
result += f"ovl_{self.vromStart:08X},ovl__{self.vromStart:08X}\n"
|
|
|
|
return result
|
|
|
|
|
|
def extractEntry(rom: bytes, offset: int, index: int) -> ActorOverlay:
|
|
entry = struct.unpack_from(">IIIIIIIHb", rom, offset + ENTRY_SIZE * index)
|
|
|
|
return ActorOverlay(*entry)
|
|
|
|
|
|
def ExtractActorTableMain():
|
|
parser = argparse.ArgumentParser(description="Actor table tool")
|
|
parser.add_argument("rom_path", help="Path to uncompressed rom")
|
|
parser.add_argument("offset", help="Raw offset to the actor table. Either dec or hex")
|
|
parser.add_argument("length", help="Amount of entries on the actor table. Either dec or hex")
|
|
|
|
parser.add_argument("--renames", help="Print a list of strings to rename instead of the actor table", action="store_true")
|
|
|
|
args = parser.parse_args()
|
|
|
|
rom_path = Path(args.rom_path)
|
|
offset = int(args.offset, 0)
|
|
length = int(args.length, 0)
|
|
renames = args.renames
|
|
|
|
with rom_path.open("rb") as f:
|
|
rom = f.read()
|
|
|
|
for i in range(length):
|
|
entry = extractEntry(rom, offset, i)
|
|
|
|
if renames:
|
|
print(entry.renames(), end="")
|
|
|
|
else:
|
|
macroEntry = entry.macroEntry(i)
|
|
print(f"/* 0x{i:02X} */ {macroEntry}")
|
|
|
|
|
|
if __name__ == '__main__':
|
|
ExtractActorTableMain()
|
|
|