runtime

The Runtime guide explains this folder.

FoldersCopy Anchor Link

• runtime

math_table.cCopy Anchor Link

games/tbs/src/runtime/math_table.c

GlobalsCopy Anchor Link

gMath_TwoPiStepsCopy Anchor Link

const u16 gMath_TwoPiSteps[8]

floor(i * 2π)

Line 43

gMath_QuadrantSinCopy Anchor Link

const s32 gMath_QuadrantSin[4]

The sine at 0, 90, 180 and 270 degrees, in Q16.

Line 48

gMath_TanTableCopy Anchor Link

const u16 gMath_TanTable[258]

Tangents scaled by 256: index i is tan(i * 45 / 128 degrees), so index 128 is tan(45 degrees). ArcTan2 starts its binary search at index 127.

Used by ArcTan2.

Line 55

Also, globals without a comment: gMath_SinQuarter.

numtext.cCopy Anchor Link

games/tbs/src/runtime/numtext.c

Globals, without a comment: gText_HexDigits, gText_PowersOfTen.

runtime.cCopy Anchor Link

games/tbs/src/runtime/runtime.c

The runtime object: what every other part of the game stands on. Power-up and the interrupt handlers, the frame wait and VBlank, input, the register write queue, fades, the sprite lists and VRAM cache, the task scheduler, maths, debug text, the heap, the 3D transform, saving and the link cable.

runtime_internal.h holds what every part shares (its includes); the code is in the files under runtime/, included here in the order it has in the ROM. Camelot's own files are not recoverable: the ROM shows one object, and these parts are ours, cut where one family ends and the next begins. README.md in this folder gives the words and prefixes the parts use. Where to start:

  Power-up        system.c: System_Initialize
  Frames          frame.c: WaitFrames, System_VBlankHandler,
                  Runtime_SetIrqHandler; scheduler.c:
                  Scheduler_AddOrUpdateCallback
  Screen          fade.c: Fade_Start; render.c: Render_BuildOamList;
                  vram_cache.c: VramCache_Load
  Memory          heap.c: Runtime_AllocateHeapBlock, MemAlloc
  3D              transform.c: SceneTransform_ApplyRotationTranslation,
                  Render_ProjectPoint
  Saving          save.c: SaveState_WriteRecord,
                  SaveState_ReadRecordPayload
  Link cable      serial.c: SerialRuntime_Initialize,
                  SerialRuntime_ExchangePayloads

runtime_internal.hCopy Anchor Link

games/tbs/src/runtime/runtime_internal.h

DeclarationsCopy Anchor Link

_call_via_r3Copy Anchor Link

s32 _call_via_r3(s32, s32, s32, s32)

The compiler library's call through r3, which render.c and save.c use to run code copied to RAM with four arguments.

Line 64