sotn-decomp/include/common.h

139 lines
4.3 KiB
C
Raw Normal View History

2022-01-01 17:45:41 +00:00
#ifndef COMMON_H
#define COMMON_H
2023-05-04 22:32:35 +00:00
#if defined(_internal_version_us)
#define VERSION_US
#define VERSION "us"
2023-05-04 22:32:35 +00:00
#elif defined(_internal_version_hd)
#define VERSION_HD
#define VERSION "hd"
Add TT_000 overlay from PSP (#1113) TT_000 is the first overlay from PlayStation 1 that we are now able to compile from the source and produce a 1:1 binary. This lead me to start exploring the same overlay from the game Castlevania: Dracula X Chronicles, which contains a PSP re-build of Symphony of the Night. This PR adds all the infrastructure to add the same flow for a PSP matching decomp. Use `export VERSION=pspeu` and then the usual `sotn` command to splat the overlay, build it and check if it matches. Running `make extract_disk` should not be necessary as the same ISO used from `VERSION=hd` is also used for `pspeu`, so you will probably have it extracted already. Some important notes about the PSP build: * The whole PSP build seems to be compiled with `-O0`, which makes it much easier to decompile * Having ŧhe PSX, PSP and Saturn builds will allow to easily cross-reference the code and reduce fake matches * `disks/pspeu/PSP_GAME/USRDIR/res/ps/hdbin/tt_000.bin` is the HD PSX build * `disks/pspeu/PSP_GAME/USRDIR/res/ps/PSPBIN/tt_000.bin` has the same code from the HD build, but for PSP * `disks/pspeu/PSP_GAME/USRDIR/res/ps/PACK_E/TP00.BIN` is the same as above, but it packs both overlay and graphics. This is the file the PSP game seems to actually use * The PSP build uses the Metrowerk CodeWarrior's C compiler, which is very different from the GCC one used on PSX. * Thanks to @mkst lead, we found a way to still use the GNU assembler and linker * MWCC uses [wibo](https://github.com/decompals/WiBo/), a think compatibility layer to run Windows CLI tools on Linux. It is much more lightweight than Wine. * MWCC does not support the `INCLUDE_ASM` dialect, so the custom pre-processor `tools/mwcpp` had to be created * The exact MWCC compiler version is unknown, but I suspect it is `build 147` * I am not yet sure of any implications for using GNU AS and GNU LD instead of the MW correspondent tools * Not all the functions can be correctly disassembled, spimdisasm will just produce a bunch of `.word 0x________` due to the in-progress effort of adding the Allegrex-specific opcodes support --- TO-DO list before marking the PR as ready: - [X] Add PSP build to the CI - [x] Add progress reporting to the PSP build - [x] Integrate source file from `src/servant/tt_000_psp` to `src/servant/tt_000` to promote the psp build as first-citizen --- TO-DO in a follow-up PR: * Figure out what `header` is: can we extract it as assembly code? or maybe as custom re-compilable asset via splat? Is it a MW stuff or a Castlevania-specific file? * Get rid of the last line in `Makefile.psp.mk`
2024-04-21 01:18:10 +00:00
#elif defined(_internal_version_pspeu)
#define VERSION_PSP
#define VERSION "psp"
#elif defined(_internal_version_beta)
#define VERSION_BETA
#define VERSION "beta"
2023-05-04 22:32:35 +00:00
#else
#warning "Version not specified. Falling back to the US version."
#define VERSION_US
#define VERSION "us"
2023-05-04 22:32:35 +00:00
#endif
#include "include_asm.h"
#include "settings.h"
#include "types.h"
2023-03-24 12:42:41 +00:00
#define LEN(x) ((s32)(sizeof(x) / sizeof(*(x))))
#define OFF(type, field) ((size_t)(&((type*)0)->field))
2023-03-28 12:14:13 +00:00
#define STRCPY(dst, src) __builtin_memcpy(dst, src, sizeof(src))
#define SQ(x) ((x) * (x))
#define MIN(a, b) ((a) > (b) ? (b) : (a))
#define MAX(a, b) ((a) > (b) ? (b) : (a))
#ifdef _MSC_VER
#define __builtin_memcpy memcpy
#endif
#if defined(VERSION_PC)
#ifndef _MSC_VER
#define STATIC_ASSERT _Static_assert
#define PACKED __attribute__((packed))
#else
#define STATIC_ASSERT(x, ...)
#define PACKED
#endif
#elif defined(VERSION_PSP)
#define STATIC_ASSERT(x)
#define PACKED
#else
#define STATIC_ASSERT(x, ...)
#define PACKED
#endif
2023-03-04 01:26:05 +00:00
#define LOH(x) (*(s16*)&(x))
#define HIH(x) (((s16*)&(x))[1])
2023-07-06 11:20:53 +00:00
#define LOHU(x) (*(u16*)&(x))
2023-05-27 10:13:49 +00:00
#define LOW(x) (*(s32*)&(x))
2023-07-06 11:20:53 +00:00
#define LOWU(x) (*(u32*)&(x))
2023-05-27 10:13:49 +00:00
2023-03-13 01:43:07 +00:00
#if defined(HACKS) && !defined(PERMUTER)
2023-03-12 00:13:28 +00:00
#define ALIGNED4 __attribute__((aligned(4)))
2023-03-12 00:11:04 +00:00
#else
#define ALIGNED4
#endif
2023-03-04 01:26:05 +00:00
#ifndef __clang__
int sprintf(char* dst, const char* fmt, ...);
#endif
// Converts a given value to a fixed-point value, where
// 16 bits represents the integer part and 16 bits for fractional part
#define FIX(x) ((s32)((x) * 65536.0))
// Get the integer part of such a fixed-point value
#define FIX_TO_I(x) ((s32)((x) >> 16))
// Get the fractional part of such a fixed-point value
#define FIX_FRAC(x) (*(s16*)&(x))
// The second argument to CreateEntFactoryFromEntity has weird bit packing,
// this takes the 2 relevant inputs and packs them up.
// id is which blueprint gets loaded from g_FactoryBlueprints.
#define FACTORY(id, param) ((id) + (param << 16))
// Tests multiple bits of x being set, based on the bitmask defined in y.
#define TEST_BITS(x, y) ((x & y) == y)
// PSX SDK libraries do not use float. Instead they use a fix-point number
// where 4096 is equal to 1.0.
#define FLT(x) ((s32)((x) * 4096.0))
// Access to the Scratchpad memory. Different on different systems.
#if defined(VERSION_PC)
#define SP_LEN 0x400
#define SP(x) (&sp[x])
#elif defined(VERSION_PSP)
#define SP(x) (0x00010000 + (x))
#else
#define SP(x) (0x1F800000 + (x))
#endif
#define CLAMP_MIN(v, min) ((v) < (min) ? (min) : (v))
#define CLAMP_MAX(v, max) ((v) > (max) ? (max) : (v))
// Creates padding between variables with a unique name and file
// visibility. On versions where this padding is unnecessary, these
// macros expand to nothing. "Critical" versions of these macros
// ensure that the padding is provided, regardless of version, useful
// for when locations are accessed using a variety of sizes so
// field offset needs to be maintained. The unknown critical versions
// expand identically to the critical versions but indicate that it
// is not known whether or not the padding is necessary outside of
// reproducing an original binary.
#define __INDIRECT_CRITICAL_PAD_TYPE_FIELD(type, size, line, counter) \
type __pad__##size##__##line##__##counter[size]
#define __CRITICAL_PAD_TYPE_FIELD(type, size, line, counter) \
__INDIRECT_CRITICAL_PAD_TYPE_FIELD(type, size, line, counter)
#define CRITICAL_PAD_TYPE_FIELD(type, size) \
__CRITICAL_PAD_TYPE_FIELD(type, size, __LINE__, __COUNTER__)
#define CRITICAL_PAD_FIELD(size) CRITICAL_PAD_TYPE_FIELD(uint8_t, size)
#define UNKNOWN_CRITICAL_PAD_TYPE(type, size) \
CRITICAL_PAD_TYPE_FIELD(type, size)
#define UNKNOWN_CRITICAL_PAD_FIELD(size) CRITICAL_PAD_FIELD(size)
#ifndef VERSION_PC
#define PAD_FIELD(size) const CRITICAL_PAD_FIELD(size)
#define STATIC_PAD_BSS(size) static CRITICAL_PAD_FIELD(size)
#define STATIC_PAD_DATA(size) STATIC_PAD_BSS(size) = {0}
RIC: add more documentation (#1573) Follow-up to #1569 . Loads of changes, where the most prominent one is synchronising the `self->ext.*.subweaponId` field across entities to make it work on `RicSetSubweaponParams`. I added some static assertions with the new macro `SYNC_FIELD`, which is easier to read. The new `enum RicSubweapons` decouples the subweapons of Richter from those found in DRA. This is important because `assets/ric/subweapondefs.json` is different from the definition stored in DRA. I discovered new entities and renamed them accordingly. I am following the format `RicEntity` for each entity. Then `RicEntitySubwpn` or `RicEntityCrash` for the appropriate category. The BSS section has been assigned to the right places and `ric.h` has been cleaned as most of the declarations are no longer necessary. More data and functions have been marked as `static`. `src/st/st0/2DAC8.c` had a reference to `.ext.agunea`, which was probably put there by mistake. The fake symbol `D_801758D0` has been removed and I think I found a way to fix the stopwatch subweapon without the `#ifdef`. ```c #ifdef VERSION_PC #ifdef _MSC_VER { s32 temp_x = (rcos(primLine->angle) << 8); s32 temp_y = (-(rsin(primLine->angle) << 8)); primLine->velocityX = *(f32*)&temp_x; primLine->velocityY = *(f32*)&temp_y; } #else primLine->velocityX = (f32)(rcos(primLine->angle) << 8); primLine->velocityY = (f32) - (rsin(primLine->angle) << 8); #endif #else primLine->velocityX = (rcos(primLine->angle) << 8); primLine->velocityY = -(rsin(primLine->angle) << 8); #endif ``` this one has been resolved by just using `velocityX.val`.
2024-08-27 17:18:26 +00:00
#define STATIC_PAD_RODATA(size) const STATIC_PAD_BSS(size) = {0}
#else
#define PAD_FIELD(size)
#define STATIC_PAD_BSS(size)
#define STATIC_PAD_DATA(size)
#define STATIC_PAD_RODATA(size)
#endif
2022-01-01 17:45:41 +00:00
#endif