Files
rea/website/public/showcase/dx-ball/index.html
T
12ee785e5e feat(website): follow the system dark mode and fix small-screen text (#1894)
* fix(website): keep text inside small screens and tidy small type and spacing

From a layout audit of the built pages:

- Long terminal prompts and code-header buttons wrap instead of being cut
  off at 320px (WCAG 1.4.10).
- Headings and table cells break long words, so the 1.4.12 text-spacing
  test no longer widens pages past 320px.
- Header and footer links get a 24px minimum height (2.5.8).
- Labels that rendered under 12px now render at 12px or more, and inline
  code never drops under 0.75rem.
- The home page's hero and definition rows share one column gap and align
  on the first baseline, and stacked boxes share one corner size.
- Highlight chips get room around the text, and the active run in a step
  listing is one band instead of a box per line.

Colors are unchanged.

🤖 Generated with Claude Code (Sonnet 5.5) 🦊

* feat(website): follow the system dark mode

The site was light only, so a reader with a dark system still got a white
page. Add one prefers-color-scheme: dark block to the stylesheet that swaps
the six color variables to Catppuccin Mocha (MIT) and overrides the fixed
colors that would break on a dark page: selection, buttons, tinted
highlights, flow nodes and arrows, and a visible border on the agent
terminal.

Add a dark theme-color tag beside the light one in the page template and
the 17 pages, and a Dark column to the style guide's color table.

Light colors are unchanged. The SVG figures follow in the next commit; the
blog page's inline strokes, the dinosaur game and the social card are left
as they are.

🤖 Generated with Claude Code (Sonnet 5.5) 🦊

* feat(website): give the five SVG figures a dark scheme

Pages load the figures with <img>, so page CSS cannot reach inside them.
Each figure now carries its own @media (prefers-color-scheme: dark) block
of attribute-selector overrides that map every light color to a Catppuccin
Mocha color, with one shared map across all five. No markup, labels,
shapes or positions change, and nothing uses !important.

Four figures also paint a mantle canvas so "Open figure" works on its own;
analyst-thinking.svg stays transparent, since it sits on the page rather
than in a figure box.

🤖 Generated with Claude Code (Sonnet 5.5) 🦊

* chore(website): refresh translation source references

The theme-color tags move the page lines that the catalogs cite, so
python3 scripts/website.py translations extract rewrites the source
references in messages.pot and the 18 PO files. No message text changes.
The same run moves the "Main navigation" entry to its new position in each
catalog.

🤖 Generated with Claude Code (Sonnet 5.5) 🦊

* fix(website): keep inline step highlights inline

The full-width band for the active step now applies only to code-step
blocks. The inline parameter highlights in the dx-ball and th04
signatures stay inline again.

🤖 Generated with Claude Code (Opus 5.5) 🦊

* test(website): check every page offers light and dark theme colors

Each authored reading page, and its built copy in every language,
must carry one theme-color tag for light and one for dark. The
stylesheet must keep its dark color scheme block. On the commit before
dark mode, this test fails on every page.

🤖 Generated with Claude Code (Opus 5.5) 🦊

* fix(website): draw the dinosaur game in the page colors

In dark mode the game box turned dark, but the game still drew with
its light colors, so the dinosaur, cacti and text fell to about 2:1
contrast. The canvas now reads five colors from CSS variables on
.dino-stage. Light values are the old ones, so light mode draws the
same pixels. Dark values are Catppuccin Mocha: 8.3:1 for the
dinosaur, 7.9:1 for cacti and text, 7.6:1 for the crash color.

The moved lines in dino-demo.js shift the translation catalog
references, so the catalogs are refreshed too (reference comments
only).

🤖 Generated with Claude Code (Opus 5.5) 🦊

* fix(website): recolor the Touhou flywheel arrows in dark mode

The inline flywheel SVG on the Touhou article hard-codes its stroke
colors, so on the dark page its connectors fell to about 2:1. Two
dark-only rules map those strokes to the page accent and muted colors
(7.8:1 and 7.4:1). Light mode is unchanged.

🤖 Generated with Claude Code (Opus 5.5) 🦊

* fix(website): redraw the dinosaur game when the system theme changes

The canvas reads its colors only when it draws, so an idle, paused or
crashed game kept the old palette after a theme switch. Each demo now
redraws on a prefers-color-scheme change.

The added lines shift the translation catalog references, so the
catalogs are refreshed too (reference comments only).

🤖 Generated with Claude Code (Opus 5.5) 🦊

---------

Co-authored-by: Claude Sonnet 5.5 <sonnet@cassie-pc>
Co-authored-by: Claude Opus 5.5 <opus@cassie-pc>
2026-10-12 03:17:49 +08:00

787 lines
36 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1" />
<title>DX-Ball Reverse Engineering: Sound Panning — REA</title>
<meta
name="description"
content="Follow a DX-Ball reconstruction from binary analysis through REA to maintained C, original-x86 tests and matching compiled function bytes."
/>
<!-- website:sharing:start -->
<!-- prettier-ignore -->
<link rel="canonical" href="https://rea.tools/showcase/dx-ball/" />
<!-- website:languages:start -->
<!-- prettier-ignore -->
<link rel="alternate" hreflang="en" href="https://rea.tools/showcase/dx-ball/" />
<!-- prettier-ignore -->
<link rel="alternate" hreflang="zh-CN" href="https://rea.tools/zh-CN/showcase/dx-ball/" />
<!-- prettier-ignore -->
<link rel="alternate" hreflang="zh-TW" href="https://rea.tools/zh-TW/showcase/dx-ball/" />
<!-- prettier-ignore -->
<link rel="alternate" hreflang="ja" href="https://rea.tools/ja/showcase/dx-ball/" />
<!-- prettier-ignore -->
<link rel="alternate" hreflang="ko" href="https://rea.tools/ko/showcase/dx-ball/" />
<!-- prettier-ignore -->
<link rel="alternate" hreflang="tr" href="https://rea.tools/tr/showcase/dx-ball/" />
<!-- prettier-ignore -->
<link rel="alternate" hreflang="ru" href="https://rea.tools/ru/showcase/dx-ball/" />
<!-- prettier-ignore -->
<link rel="alternate" hreflang="vi" href="https://rea.tools/vi/showcase/dx-ball/" />
<!-- prettier-ignore -->
<link rel="alternate" hreflang="th" href="https://rea.tools/th/showcase/dx-ball/" />
<!-- prettier-ignore -->
<link rel="alternate" hreflang="de" href="https://rea.tools/de/showcase/dx-ball/" />
<!-- prettier-ignore -->
<link rel="alternate" hreflang="es" href="https://rea.tools/es/showcase/dx-ball/" />
<!-- prettier-ignore -->
<link rel="alternate" hreflang="fr" href="https://rea.tools/fr/showcase/dx-ball/" />
<!-- prettier-ignore -->
<link rel="alternate" hreflang="uk" href="https://rea.tools/uk/showcase/dx-ball/" />
<!-- prettier-ignore -->
<link rel="alternate" hreflang="pl" href="https://rea.tools/pl/showcase/dx-ball/" />
<!-- prettier-ignore -->
<link rel="alternate" hreflang="pt-BR" href="https://rea.tools/pt-BR/showcase/dx-ball/" />
<!-- prettier-ignore -->
<link rel="alternate" hreflang="ar" href="https://rea.tools/ar/showcase/dx-ball/" />
<!-- prettier-ignore -->
<link rel="alternate" hreflang="fa" href="https://rea.tools/fa/showcase/dx-ball/" />
<!-- prettier-ignore -->
<link rel="alternate" hreflang="id" href="https://rea.tools/id/showcase/dx-ball/" />
<!-- prettier-ignore -->
<link rel="alternate" hreflang="it" href="https://rea.tools/it/showcase/dx-ball/" />
<!-- prettier-ignore -->
<link rel="alternate" hreflang="x-default" href="https://rea.tools/showcase/dx-ball/" />
<!-- website:languages:end -->
<!-- prettier-ignore -->
<meta property="og:type" content="website" />
<!-- prettier-ignore -->
<meta property="og:site_name" content="REA" />
<!-- prettier-ignore -->
<meta property="og:title" content="DX-Ball Reverse Engineering: Sound Panning — REA" />
<!-- prettier-ignore -->
<meta property="og:description" content="Follow a DX-Ball reconstruction from binary analysis through REA to maintained C, original-x86 tests and matching compiled function bytes." />
<!-- prettier-ignore -->
<meta property="og:url" content="https://rea.tools/showcase/dx-ball/" />
<!-- prettier-ignore -->
<meta property="og:image" content="https://rea.tools/assets/social-card.png" />
<!-- prettier-ignore -->
<meta property="og:image:type" content="image/png" />
<!-- prettier-ignore -->
<meta property="og:image:width" content="1200" />
<!-- prettier-ignore -->
<meta property="og:image:height" content="630" />
<!-- prettier-ignore -->
<meta
property="og:image:alt"
content="REA — Find out how software works. Reverse engineering with your coding agent."
/>
<!-- prettier-ignore -->
<meta name="twitter:card" content="summary_large_image" />
<!-- prettier-ignore -->
<meta name="twitter:title" content="DX-Ball Reverse Engineering: Sound Panning — REA" />
<!-- prettier-ignore -->
<meta name="twitter:description" content="Follow a DX-Ball reconstruction from binary analysis through REA to maintained C, original-x86 tests and matching compiled function bytes." />
<!-- prettier-ignore -->
<meta name="twitter:image" content="https://rea.tools/assets/social-card.png" />
<!-- prettier-ignore -->
<meta
name="twitter:image:alt"
content="REA — Find out how software works. Reverse engineering with your coding agent."
/>
<!-- website:sharing:end -->
<meta
name="theme-color"
content="#ffffff"
media="(prefers-color-scheme: light)"
/>
<meta
name="theme-color"
content="#1e1e2e"
media="(prefers-color-scheme: dark)"
/>
<link rel="icon" href="../../assets/favicon.svg" type="image/svg+xml" />
<link rel="stylesheet" href="../../assets/styles.css" />
<script src="../../assets/main.js" defer></script>
</head>
<body id="top">
<a class="skip-link" href="#main">Skip to content</a>
<!-- website:header:start -->
<!-- prettier-ignore -->
<header class="site-header">
<div class="container header-inner">
<a class="brand" href="../../" aria-label="REA home"
><span class="brand-name">REA</span
><span class="brand-caption" data-i18n-skip>Reverse Engineer Anything</span></a
>
<nav class="navigation" aria-label="Main navigation">
<a href="../../showcase/" aria-current="page">Showcases</a>
<a href="../../blog/">Blog</a>
<a href="../../get-started/" class="nav-start">Get started</a>
<a href="../../guides/">Guides</a>
<a href="../../faq/">FAQ</a>
</nav>
<div class="header-social">
<details class="language-picker" data-i18n-skip><summary><span aria-hidden="true">文 / A</span> <span>English</span></summary><nav aria-label="English"><a href="../../showcase/dx-ball/" lang="en" dir="ltr" data-language="en" aria-current="true">English</a><a href="../../zh-CN/showcase/dx-ball/" lang="zh-CN" dir="ltr" data-language="zh-CN">简体中文</a><a href="../../zh-TW/showcase/dx-ball/" lang="zh-TW" dir="ltr" data-language="zh-TW">繁體中文</a><a href="../../ja/showcase/dx-ball/" lang="ja" dir="ltr" data-language="ja">日本語</a><a href="../../ko/showcase/dx-ball/" lang="ko" dir="ltr" data-language="ko">한국어</a><a href="../../tr/showcase/dx-ball/" lang="tr" dir="ltr" data-language="tr">Türkçe</a><a href="../../ru/showcase/dx-ball/" lang="ru" dir="ltr" data-language="ru">Русский</a><a href="../../vi/showcase/dx-ball/" lang="vi" dir="ltr" data-language="vi">Tiếng Việt</a><a href="../../th/showcase/dx-ball/" lang="th" dir="ltr" data-language="th">ไทย</a><a href="../../de/showcase/dx-ball/" lang="de" dir="ltr" data-language="de">Deutsch</a><a href="../../es/showcase/dx-ball/" lang="es" dir="ltr" data-language="es">Español</a><a href="../../fr/showcase/dx-ball/" lang="fr" dir="ltr" data-language="fr">Français</a><a href="../../uk/showcase/dx-ball/" lang="uk" dir="ltr" data-language="uk">Українська</a><a href="../../pl/showcase/dx-ball/" lang="pl" dir="ltr" data-language="pl">Polski</a><a href="../../pt-BR/showcase/dx-ball/" lang="pt-BR" dir="ltr" data-language="pt-BR">Português (Brasil)</a><a href="../../ar/showcase/dx-ball/" lang="ar" dir="rtl" data-language="ar">العربية</a><a href="../../fa/showcase/dx-ball/" lang="fa" dir="rtl" data-language="fa">فارسی</a><a href="../../id/showcase/dx-ball/" lang="id" dir="ltr" data-language="id">Bahasa Indonesia</a><a href="../../it/showcase/dx-ball/" lang="it" dir="ltr" data-language="it">Italiano</a></nav></details>
<a
class="nav-github"
href="https://github.com/morluto/rea"
aria-label="REA on GitHub"
title="REA on GitHub"
>
<svg
width="22"
height="22"
viewBox="0 0 16 16"
aria-hidden="true"
focusable="false"
>
<path
fill="currentColor"
d="M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82a7.65 7.65 0 0 1 2-.27c.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.01 8.01 0 0 0 16 8c0-4.42-3.58-8-8-8Z"
/>
</svg>
<span class="nav-github-count" hidden aria-hidden="true"></span>
</a>
<a
class="nav-discord"
href="https://discord.gg/GkcryMnJDM"
aria-label="Join REA on Discord"
title="Join REA on Discord"
>
<svg
width="22"
height="22"
viewBox="0 0 24 24"
aria-hidden="true"
focusable="false"
>
<path
fill="currentColor"
d="M20.317 4.3698a19.7913 19.7913 0 0 0-4.8851-1.5152.0741.0741 0 0 0-.0785.0371c-.211.3753-.4447.8648-.6083 1.2495-1.8447-.2762-3.68-.2762-5.4868 0-.1636-.3933-.4058-.8742-.6177-1.2495a.077.077 0 0 0-.0785-.037 19.7363 19.7363 0 0 0-4.8852 1.515.0699.0699 0 0 0-.0321.0277C.5334 9.0458-.319 13.5799.0992 18.0578a.0824.0824 0 0 0 .0312.0561c2.0528 1.5076 4.0413 2.4228 5.9929 3.0294a.0777.0777 0 0 0 .0842-.0276c.4616-.6304.8731-1.2952 1.226-1.9942a.076.076 0 0 0-.0416-.1057c-.6528-.2476-1.2743-.5495-1.8722-.8923a.077.077 0 0 1-.0076-.1277c.1258-.0943.2517-.1923.3718-.2914a.0743.0743 0 0 1 .0776-.0105c3.9278 1.7933 8.18 1.7933 12.0614 0a.0739.0739 0 0 1 .0785.0095c.1202.099.246.1981.3728.2924a.077.077 0 0 1-.0066.1276 12.2986 12.2986 0 0 1-1.873.8914.0766.0766 0 0 0-.0407.1067c.3604.698.7719 1.3628 1.225 1.9932a.076.076 0 0 0 .0842.0286c1.961-.6067 3.9495-1.5219 6.0023-3.0294a.077.077 0 0 0 .0313-.0552c.5004-5.177-.8382-9.6739-3.5485-13.6604a.061.061 0 0 0-.0312-.0286ZM8.02 15.3312c-1.1825 0-2.1569-1.0857-2.1569-2.419 0-1.3332.9555-2.4189 2.157-2.4189 1.2108 0 2.1757 1.0952 2.1568 2.419 0 1.3332-.9555 2.4189-2.1569 2.4189Zm7.9748 0c-1.1825 0-2.1569-1.0857-2.1569-2.419 0-1.3332.9554-2.4189 2.1569-2.4189 1.2108 0 2.1757 1.0952 2.1568 2.419 0 1.3332-.946 2.4189-2.1568 2.4189Z"
/>
</svg>
</a>
<a
class="nav-x"
href="https://x.com/reatools"
aria-label="Follow REA on X"
title="Follow REA on X"
>
<svg
width="18"
height="18"
viewBox="0 0 24 24"
aria-hidden="true"
focusable="false"
>
<path
fill="currentColor"
d="M18.901 1.153h3.68l-8.04 9.19L24 22.846h-7.406l-5.8-7.584-6.638 7.584H.474l8.6-9.83L0 1.154h7.594l5.243 6.932ZM17.61 20.644h2.039L6.486 3.24H4.298Z"
/>
</svg>
</a>
</div>
</div>
</header>
<!-- website:header:end -->
<main id="main" class="container">
<div class="page-heading">
<p class="breadcrumb">
<a href="../../">Home</a> / <a href="../">Showcases</a> / DX-Ball
</p>
<p class="eyebrow">Case study · DX-Ball 1.07</p>
<h1>Rebuilding DX-Ball<br />from its executable.</h1>
<p class="lede">
The goal is a maintainable C version of the 1996 Windows game. REA
helps the agent inspect the original, one function at a time.
</p>
<p class="page-meta">Windows i386 · C · REA</p>
</div>
<figure class="explanatory-figure case-figure">
<div
class="figure-viewport"
tabindex="0"
role="region"
aria-label="DX-Ball sound-pan investigation; scroll horizontally on smaller screens"
>
<img
src="../../assets/figures/dx-ball-sound-pan-investigation.svg"
width="1774"
height="887"
alt="DXBALL.EXE function 0x00406400 is inspected with REA. A brick-hit caller supplies 20 plus 30 times tile_x. Instructions load x, multiply by 1.5625, subtract 500.0, apply pan_scale and return an integer. The maintained C is checked independently against the original x86 in 3,205 cases and by VC4.0 compiler replay matching 63 bytes."
decoding="async"
/>
</div>
<figcaption>
One function, from executable to checked C. REA supplies the
instructions, callers and data reads; the reconstruction project
implements and tests the result.
<a href="../../assets/figures/dx-ball-sound-pan-investigation.svg"
>Open figure</a
>
</figcaption>
</figure>
<div class="article-layout">
<nav class="contents" aria-label="On this page">
<p>In this case study</p>
<ul>
<li><a href="#progress">The project</a></li>
<li><a href="#sound-pan">Sound pan</a></li>
<li><a href="#checking">Checking the result</a></li>
<li><a href="#continue">Continue the work</a></li>
</ul>
</nav>
<article class="article" aria-label="DX-Ball reconstruction case study">
<section class="article-section" id="progress">
<dl class="stats">
<div>
<dt>55</dt>
<dd>maintained C functions</dd>
</div>
<div>
<dt>45,380</dt>
<dd>comparisons with original code</dd>
</div>
<div>
<dt>33</dt>
<dd>functions with matching compiled bytes</dd>
</div>
</dl>
<p class="caption">
Project checkpoint: 7 October 2026.
<a
href="https://github.com/N0zoM1z0/dx-ball/blob/a55dca27ec0a07018c1b2c95ae2be027f7d8c3c4/docs/PROGRESS.md"
>Progress ledger</a
>
·
<a
href="https://github.com/N0zoM1z0/dx-ball/blob/a55dca27ec0a07018c1b2c95ae2be027f7d8c3c4/docs/ORACLES.md"
>Test coverage</a
>
</p>
<h2>The project so far</h2>
<p>
The recovered code covers board and resource handling, brick hits,
animations, particles and bonus production. Current builds provide
inspection utilities and an analysis library. Work on the playable
game continues with ball and paddle physics, power-up handling and
Windows integration.
</p>
</section>
<section class="article-section" id="sound-pan">
<h2>Finding the sound-pan calculation</h2>
<p>
When a brick is hit, its horizontal position is passed to the
sound code. The investigation needed to recover how that screen
coordinate becomes a left/right panning value.
</p>
<div class="agent-terminal">
<div class="terminal-header">
<span class="terminal-title"
><span class="terminal-dots" aria-hidden="true"
><i></i><i></i><i></i></span
>Your coding agent</span
><button
class="copy-button"
type="button"
data-copy="dxball-prompt"
aria-label="Copy example prompt"
>
Copy
</button>
</div>
<p class="terminal-prompt">
<span class="prompt-symbol" aria-hidden="true">›</span
><span id="dxball-prompt"
>Use REA to find how DX-Ball calculates sound panning. Explain
the calculation and show the code.</span
><span class="terminal-cursor" aria-hidden="true"></span>
</p>
</div>
<p class="caption">
An example prompt for your coding agent, with the local executable
available. The investigation below shows the REA queries and
evidence behind the answer.
</p>
<p>
The agent used REA to inspect the function, follow its brick-hit
caller and read the constants from the executable. Those results
supplied the input and arithmetic needed to write the C function
below.
</p>
<p>
The first function result for <code>0x406400</code> included
pseudocode declaring <code>FUN_00406400(void)</code> and calling
<code>__ftol()</code>. Its instruction view showed a stack input
and floating-point operations. That discrepancy gave the agent a
concrete reason to keep investigating.
</p>
<details class="evidence-details">
<summary>The first decompiler view</summary>
<div class="code-block">
<div class="code-header">
<span>REA result · pseudocode excerpt</span>
</div>
<pre><code>longlong FUN_00406400(void)
{
longlong lVar1;
lVar1 = __ftol();
return lVar1;
}</code></pre>
</div>
<p>
The output shows a conversion call. Reading the instructions
below reveals the input and the calculation feeding that call.
</p>
</details>
<h3 class="small-heading">Three questions answered through REA</h3>
<ol class="rea-queries">
<li>
<h4>Recover the missing input</h4>
<div class="rea-query-pair">
<div class="code-block">
<div class="code-header">
<span>Agent → REA · <code>analyze_function</code></span>
</div>
<pre><code>{"procedure": "0x406400"}</code></pre>
</div>
<div class="code-block">
<div class="code-header">
<span>REA → agent · instruction excerpt</span>
</div>
<pre><code>0x406409: MOV EAX, dword ptr [EBP + 0x8]
0x40640c: MOV dword ptr [EBP + -0xc], EAX
0x40640f: FILD dword ptr [EBP + -0xc]</code></pre>
</div>
</div>
<p>
The function result includes instructions alongside pseudocode
and callers. Here, <code>[EBP+8]</code> exposes the integer
input missing from the decompiler view.
</p>
</li>
<li>
<h4>Follow the caller to understand the input</h4>
<div class="rea-query-pair">
<div class="code-block">
<div class="code-header">
<span>Agent → REA · <code>analyze_function</code></span>
</div>
<pre><code>{"procedure": "0x411f40"}</code></pre>
</div>
<div class="code-block">
<div class="code-header">
<span>REA → agent · caller excerpt</span>
</div>
<pre><code>0x411f5b: ADD EAX, 0x14
0x411f5e: PUSH EAX
0x411f5f: CALL 0x00406400</code></pre>
</div>
</div>
<p>
REA identified this caller in the first result. Its preceding
instructions scale <code>tile_x</code> by 30; adding 20 gives
the brick's screen coordinate, <code>20 + 30 × tile_x</code>.
</p>
</li>
<li>
<h4>Read the values behind the memory addresses</h4>
<div class="rea-query-pair">
<div class="code-block">
<div class="code-header">
<span
>Agent → REA · two
<code>read_bytes</code> requests</span
>
</div>
<pre><code>{"address": "0x420068", "length": 16}
{"address": "0x4210a0", "length": 8}</code></pre>
</div>
<div class="code-block">
<div class="code-header">
<span>REA byte results · decoded as doubles</span>
</div>
<pre><code>000000000000f93f → 1.5625
0000000000407f40 → 500.0
000000000000f03f → 1.0</code></pre>
</div>
</div>
<p>
The returned bytes establish the two arithmetic constants and
initial pan scale. The agent now has the values needed for the
C expression.
</p>
</li>
</ol>
<h3 class="small-heading">From REA's findings to C</h3>
<p>
Follow the five steps below. Each selection highlights the
original instructions and the C lines they informed.
</p>
<div class="step-comparison" data-step-comparison>
<div
class="step-selector"
role="group"
aria-label="Follow the sound-pan calculation"
>
<button
type="button"
data-select-step="1"
aria-pressed="true"
aria-controls="pan-assembly pan-source pan-step-detail"
>
<span>01</span> Input
</button>
<button
type="button"
data-select-step="2"
aria-pressed="false"
aria-controls="pan-assembly pan-source pan-step-detail"
>
<span>02</span> Multiply
</button>
<button
type="button"
data-select-step="3"
aria-pressed="false"
aria-controls="pan-assembly pan-source pan-step-detail"
>
<span>03</span> Subtract
</button>
<button
type="button"
data-select-step="4"
aria-pressed="false"
aria-controls="pan-assembly pan-source pan-step-detail"
>
<span>04</span> Scale
</button>
<button
type="button"
data-select-step="5"
aria-pressed="false"
aria-controls="pan-assembly pan-source pan-step-detail"
>
<span>05</span> Return
</button>
</div>
<div class="code-comparison">
<div class="code-block">
<div class="code-header">
<span>Original x86 · excerpt</span
><button
class="copy-button"
type="button"
data-copy="pan-assembly"
aria-label="Copy original assembly excerpt"
>
Copy
</button>
</div>
<pre><code id="pan-assembly"><span class="code-step is-active" data-step="1">0x406409: MOV EAX, dword ptr [EBP + 0x8]
0x40640c: MOV dword ptr [EBP + -0xc], EAX
0x40640f: FILD dword ptr [EBP + -0xc]</span>
<span class="code-step" data-step="2">0x406415: FMUL double ptr [0x00420068]</span>
<span class="code-step" data-step="3">0x40641e: FSUB double ptr [0x00420070]</span>
<span class="code-step" data-step="4">0x406427: FMUL double ptr [0x004210a0]</span>
<span class="code-step" data-step="5">0x406430: CALL 0x0041678c
0x40643e: RET</span></code></pre>
</div>
<div class="code-block">
<div class="code-header">
<span>Reconstructed C</span
><button
class="copy-button"
type="button"
data-copy="pan-source"
aria-label="Copy sound-pan function"
>
Copy
</button>
</div>
<pre><code id="pan-source">DxBallInt dxball_screen_pan(<span class="is-active" data-step="1">DxBallInt x</span>)
{
double pan;
<span class="code-step is-active" data-step="1"> pan = (double)x;</span>
<span class="code-step" data-step="2"> pan = pan * 1.5625;</span>
<span class="code-step" data-step="3"> pan = pan - 500.0;</span>
<span class="code-step" data-step="4"> pan = pan * dxball_pan_scale;</span>
<span class="code-step" data-step="5"> return (DxBallInt)pan;</span>
}</code></pre>
</div>
</div>
<div
class="step-detail"
id="pan-step-detail"
aria-live="polite"
aria-atomic="true"
>
<p data-step-note="1">
<strong>01 · Read the input.</strong>
The instruction view in REA's function result reads
<code>[EBP+8]</code> and uses <code>FILD</code> to load the
integer. Following its caller through REA establishes the
screen-coordinate meaning of the C parameter <code>x</code>.
</p>
<p data-step-note="2" hidden>
<strong>02 · Multiply by 1.5625.</strong>
<code>FMUL</code> reads the double at <code>0x420068</code>.
The bytes returned by REA's <code>read_bytes</code> decode to
<code>1.5625</code>; the C uses the same constant.
</p>
<p data-step-note="3" hidden>
<strong>03 · Subtract 500.0.</strong> <code>FSUB</code> reads
the double at <code>0x420070</code>. REA's byte result decodes
to <code>500.0</code>, shifting the calculation's center to
screen coordinate <code>320</code>.
</p>
<p data-step-note="4" hidden>
<strong>04 · Apply the stored scale.</strong> The second
<code>FMUL</code> reads <code>0x4210a0</code>. That global is
named <code>dxball_pan_scale</code> in the maintained source.
REA's second byte read establishes its initial value of
<code>1.0</code>.
</p>
<p data-step-note="5" hidden>
<strong>05 · Return an integer.</strong> The call at
<code>0x406430</code> reaches <code>__ftol</code>, identified
in REA's callee results. The C casts the result to
<code>DxBallInt</code>; original-x86 comparisons check the
returned value.
</p>
</div>
</div>
<p class="caption">
The assembly excerpt selects the input, arithmetic and return
instructions. The full listing below also includes the intervening
stores and function setup and cleanup.
</p>
<details class="evidence-details">
<summary>Full assembly and supporting evidence</summary>
<div class="code-block">
<div class="code-header">
<span>REA result · 0x406400–0x40643e</span
><button
class="copy-button"
type="button"
data-copy="pan-assembly-full"
aria-label="Copy complete sound-pan assembly"
>
Copy
</button>
</div>
<pre><code id="pan-assembly-full">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</code></pre>
</div>
<h3>What the caller supplies</h3>
<p>
The brick-hit function at <code>0x411f40</code> scales its tile
coordinate by 30, adds 20, then pushes it before the call:
</p>
<div class="code-block">
<pre><code>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</code></pre>
</div>
<h3>What the data reads establish</h3>
<div class="evidence-table-wrap">
<table class="evidence-table">
<caption>
REA byte reads, decoded as little-endian doubles
</caption>
<thead>
<tr>
<th scope="col">Address</th>
<th scope="col">Value</th>
<th scope="col">Used for</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>0x420068</code></td>
<td><code>1.5625</code></td>
<td>First multiplication</td>
</tr>
<tr>
<td><code>0x420070</code></td>
<td><code>500.0</code></td>
<td>Subtraction</td>
</tr>
<tr>
<td><code>0x4210a0</code></td>
<td><code>1.0</code> initially</td>
<td>Stored pan scale</td>
</tr>
</tbody>
</table>
</div>
<p class="caption">
Recorded with REA 4.1.0 for the hash-pinned DX-Ball 1.07 target.
The linked investigation notes retain the Evidence IDs.
</p>
</details>
<p class="caption">
<a
href="https://github.com/N0zoM1z0/dx-ball/blob/a55dca27ec0a07018c1b2c95ae2be027f7d8c3c4/src/gameplay.c#L41"
>Maintained source</a
>
·
<a
href="https://github.com/N0zoM1z0/dx-ball/blob/a55dca27ec0a07018c1b2c95ae2be027f7d8c3c4/docs/GAMEPLAY_OWNER.md"
>Investigation notes and evidence references</a
>
</p>
</section>
<section class="article-section" id="checking">
<h2>Checking the recovered function</h2>
<p>
The recovered function passes two checks: its return values match
the original, and its compiled bytes match the executable.
</p>
<div class="verification">
<div>
<h3>3,205 behavior cases</h3>
<p>
The tests execute the original x86 function and compare its
return value with the maintained C. They cover every integer
position from 0 to 640 at five pan scales: 0, 0.5, 1, 20 and
−1.
</p>
</div>
<div>
<h3>63 matching bytes</h3>
<p>
The C function is compiled with the pinned VC4.0 toolchain.
Compiler replay matches the complete function after applying
the reviewed relocations and checking the referenced
constants.
</p>
</div>
</div>
<p class="small-heading">
At a scale of 1, the recovered calculation returns −500 at the
left edge, 0 at the center and 500 at the right edge. The next
part of the audio work is integrating that value with the game's
sound backend.
</p>
<p>
<a
href="https://github.com/N0zoM1z0/dx-ball/blob/a55dca27ec0a07018c1b2c95ae2be027f7d8c3c4/docs/BUILD_MATCHING.md"
>Read the compiler replay details</a
>
</p>
</section>
<section class="article-section" id="continue">
<h2>Continue the investigation</h2>
<p>
The same approach is being used for particle updates, explosion
queues and bonus generation: inspect the relevant functions,
recover their state and dependencies, then compare the
implementation with the original.
</p>
<p>
To inspect the sound-pan function yourself, follow the DX-Ball
project's setup instructions and supply its matching original
target. Then run:
</p>
<div class="code-block">
<div class="code-header">
<span>In the DX-Ball checkout</span
><button
class="copy-button"
type="button"
data-copy="pan-command"
aria-label="Copy DX-Ball analysis command"
>
Copy
</button>
</div>
<pre><code id="pan-command">scripts/rea function original/DXBALL.EXE 0x00406400 \
--snapshot .analysis/rea/dxball.snapshot.json --json</code></pre>
</div>
<ul class="reading-list">
<li>
<a href="https://github.com/N0zoM1z0/dx-ball"
>DX-Ball repository</a
><span>Current source, progress and local setup.</span>
</li>
<li>
<a href="../../guides/native/">REA analysis workflow</a
><span
>Follow the calculation, then use the same approach with your
own binary.</span
>
</li>
<li>
<a
href="https://github.com/N0zoM1z0/dx-ball/blob/a55dca27ec0a07018c1b2c95ae2be027f7d8c3c4/docs/ENTITIES_OWNER.md"
>Particles and bonus production</a
><span
>A larger investigation into state, queues and pixel
writes.</span
>
</li>
</ul>
<div class="actions">
<a class="button" href="../../get-started/"
>Start with your own target</a
>
</div>
</section>
</article>
</div>
</main>
<!-- website:footer:start -->
<!-- prettier-ignore -->
<footer class="site-footer">
<div class="container footer-inner">
<p>REA · Reverse Engineer Anything</p>
<div class="footer-links">
<a href="https://github.com/morluto/rea">Source</a
><a href="https://github.com/morluto/rea/blob/main/LICENSE">MIT license</a
><a href="https://discord.gg/GkcryMnJDM">Join the community</a
><a href="https://x.com/reatools">Follow us on X</a>
</div>
</div>
</footer>
<p class="sr-only" id="copy-status" role="status" aria-live="polite"></p>
<a class="back-to-top" href="#top" aria-label="Back to top">
<span aria-hidden="true">↑</span> Top
</a>
<!-- website:footer:end -->
</body>
</html>