Umbau DX-Ball
von seiner ausführbaren Datei.

55

beibehaltene C-Funktionen

45,380

vergleiche mit Originalcode

33

funktionen mit übereinstimmenden kompilierten Bytes

Projekt-Checkpoint: 7. Oktober 2026. Fortschrittsbuch · Testabdeckung

Das Projekt bisher

Der wiederhergestellte Code umfasst Brett- und Ressourcenhandhabung, Ziegelsteintreffer, Animationen, Partikel und Bonusproduktion. Aktuelle Builds bieten Inspektionsprogramme und eine Analysebibliothek. Die Arbeit am spielbaren Spiel wird mit Ball- und Paddelphysik, Power-Up-Handling und Windows-Integration fortgesetzt.

Ermittlung der Berechnung der linken / rechten Schallposition

Wenn ein Stein getroffen wird, wird seine horizontale Position an den Soundcode übergeben. Die Untersuchung musste wiederhergestellt werden, wie diese Bildschirmkoordinate zu einem Links / Rechts-Schwenkwert wird.

Eine Beispielaufforderung für Ihren Codierungsagenten, wobei die lokale ausführbare Datei verfügbar ist. Die folgende Untersuchung zeigt die REA-Abfragen und Beweise hinter der Antwort.

Der Agent hat REA verwendet, um die Funktion zu überprüfen, seinem Aufrufer mit Ziegelsteinen zu folgen und die Konstanten aus der ausführbaren Datei zu lesen. Diese Ergebnisse lieferten die Eingabe und Arithmetik, die zum Schreiben der folgenden C-Funktion erforderlich waren.

Das erste Funktionsergebnis für 0x406400 enthaltene Pseudocode-Deklaration FUN_00406400(void) und ruft __ftol(). Die Anweisungsansicht zeigte eine Stapeleingabe und Gleitkommaoperationen. Diese Diskrepanz gab dem Agenten einen konkreten Grund, weiter zu ermitteln.

longlong FUN_00406400(void)
{
  longlong lVar1;

  lVar1 = __ftol();
  return lVar1;
}

Drei Fragen beantwortet durch REA

1. Stellen Sie die fehlende Eingabe wieder her

   Vertreter → REA · analyze_function

   {"procedure": "0x406400"}

   REA → Agent * Anweisungsauszug

   0x406409: MOV EAX, dword ptr [EBP + 0x8]
   0x40640c: MOV dword ptr [EBP + -0xc], EAX
   0x40640f: FILD dword ptr [EBP + -0xc]

   Das Funktionsergebnis enthält Anweisungen neben Pseudocode und Aufrufern. Hier, [EBP+8] macht die Integer-Eingabe verfügbar, die in der Dekompilierungsansicht fehlt.

2. Die aufrufende Funktion erklärt die Eingabe

   Vertreter → REA · analyze_function

   {"procedure": "0x411f40"}

   REA → Agent · Auszug der aufrufenden Funktion

   0x411f5b: ADD EAX, 0x14
   0x411f5e: PUSH EAX
   0x411f5f: CALL 0x00406400

   REA nennt diese aufrufende Funktion bereits im ersten Ergebnis. Vor dem Aufruf multipliziert sie tile_x mit 30 und addiert 20. Das ergibt die Bildschirmkoordinate des Ziegels, 20 + 30 × tile_x.

3. Lesen Sie die Werte hinter den Speicheradressen

   Vertreter → REA * zwei read_bytes Antr

   {"address": "0x420068", "length": 16}
   {"address": "0x4210a0", "length": 8}

   REA Byte-Ergebnisse * dekodiert als Doppel

   000000000000f93f → 1.5625
   0000000000407f40 → 500.0
   000000000000f03f → 1.0

   Die zurückgegebenen Bytes legen die beiden arithmetischen Konstanten und die anfängliche Schwenkskala fest. Der Agent hat jetzt die Werte, die für den C-Ausdruck benötigt werden.

Von den Erkenntnissen von REA zu C

Befolgen Sie die folgenden fünf Schritte. Jede Auswahl hebt die ursprünglichen Anweisungen und die von ihnen informierten C-Zeilen hervor.

0x406409: MOV EAX, dword ptr [EBP + 0x8]
0x40640c: MOV dword ptr [EBP + -0xc], EAX
0x40640f: FILD dword ptr [EBP + -0xc]
0x406415: FMUL double ptr [0x00420068]
0x40641e: FSUB double ptr [0x00420070]
0x406427: FMUL double ptr [0x004210a0]
0x406430: CALL 0x0041678c
0x40643e: RET

DxBallInt dxball_screen_pan(DxBallInt x)
{
    double pan;
    pan = (double)x;
    pan = pan * 1.5625;
    pan = pan - 500.0;
    pan = pan * dxball_pan_scale;
    return (DxBallInt)pan;
}

Der Assemblyauszug wählt die Eingabe-, Arithmetik- und Rückgabeanweisungen aus. Die vollständige Liste unten enthält auch die dazwischenliegenden Speicher sowie die Einrichtung und Bereinigung von Funktionen.

0x406400: PUSH EBP
0x406401: MOV EBP, ESP
0x406403: SUB ESP, 0xc
0x406406: PUSH EBX
0x406407: PUSH ESI
0x406408: PUSH EDI
0x406409: MOV EAX, dword ptr [EBP + 0x8]
0x40640c: MOV dword ptr [EBP + -0xc], EAX
0x40640f: FILD dword ptr [EBP + -0xc]
0x406412: FST double ptr [EBP + -0x8]
0x406415: FMUL double ptr [0x00420068]
0x40641b: FST double ptr [EBP + -0x8]
0x40641e: FSUB double ptr [0x00420070]
0x406424: FST double ptr [EBP + -0x8]
0x406427: FMUL double ptr [0x004210a0]
0x40642d: FST double ptr [EBP + -0x8]
0x406430: CALL 0x0041678c
0x406435: JMP 0x0040643a
0x40643a: POP EDI
0x40643b: POP ESI
0x40643c: POP EBX
0x40643d: LEAVE
0x40643e: RET

0x411f50: MOV EAX, dword ptr [EBP + 0x8]
0x411f53: ADD EAX, EAX
0x411f55: LEA EAX, [EAX + EAX*0x2]
0x411f58: LEA EAX, [EAX + EAX*0x4]
0x411f5b: ADD EAX, 0x14
0x411f5e: PUSH EAX
0x411f5f: CALL 0x00406400
0x411f64: ADD ESP, 0x4

Gepflegte Quelle · Ermittlungsnotizen und Beweisreferenzen

Überprüfen der wiederhergestellten Funktion

Die wiederhergestellte Funktion besteht zwei Prüfungen: Ihre Rückgabewerte stimmen mit dem Original überein und ihre kompilierten Bytes stimmen mit der ausführbaren Datei überein.

Bei einer Skala von 1 gibt die wiederhergestellte Berechnung -500 am linken Rand, 0 in der Mitte und 500 am rechten Rand zurück. Der nächste Teil der Audioarbeit besteht darin, diesen Wert in das Sound-Backend des Spiels zu integrieren.

Lesen Sie die Compiler-Wiedergabedetails

Setzen Sie die Untersuchung fort

Der gleiche Ansatz wird für Partikelaktualisierungen, Explosionswarteschlangen und Bonusgenerierung verwendet: Überprüfen Sie die relevanten Funktionen, stellen Sie ihren Zustand und ihre Abhängigkeiten wieder her und vergleichen Sie dann die Implementierung mit dem Original.

Um die Sound-Pan-Funktion selbst zu überprüfen, befolgen Sie die Einrichtungsanweisungen des DX-Ball-Projekts und geben Sie das passende Originalziel an. Dann lauf:

scripts/rea function original/DXBALL.EXE 0x00406400 \
  --snapshot .analysis/rea/dxball.snapshot.json --json

• DX-Ball ArchivAktuelle Quelle, Fortschritt und lokale Einrichtung.
• REA Analyse-ArbeitsablaufBefolgen Sie die Berechnung und verwenden Sie dann den gleichen Ansatz mit Ihrer eigenen Binärdatei.
• Partikel- und BonusproduktionEine größere Untersuchung zu Status, Warteschlangen und Pixelschreibvorgängen.