Pureikyubu 1.7 rebuilds its GameCube graphics core and adds real tests

The GameCube emulator's biggest update yet replaces its fixed-function graphics backend with GLSL shaders and adds hundreds of automated tests, letting a Linux kernel boot along the way.

AI-drafted from 2 sources. This story was written with AI from the outside reporting listed under Sources, and checked by automated tools before it went up. The originals have the full detail.

Pureikyubu, the Russian-led GameCube emulator also known as PlayCube, has shipped version 1.7, which its own release notes call the largest update since the project started. The headline change is a full rebuild of the graphics backend around Flipper, the GameCube's graphics chip, plus the first proper automated test suites for its two most complicated subsystems.

According to the release notes, the previous version, 1.6, dates back to August 2023, so this has been a long time coming. The Reddit thread on r/emulation flags it as the same news, with users pointing to the scale of the changelog rather than any single flashy feature.

Why the Flipper rewrite matters

Flipper has two programmable stages that decide how a GameCube frame actually looks: the Transform Unit (XF), which handles vertex and lighting maths, and the Texture Environment Unit (TEV), which blends textures together. Pureikyubu used to emulate both by driving OpenGL's old fixed-function pipeline directly. In 1.7 that is gone. The XF and TEV are now emulated with GLSL 3.30 vertex and fragment shaders running on an OpenGL 3.3 core profile, and the Command Processor, the part of Flipper that issues drawing commands, now feeds the XF rather than reaching into the rasteriser blocks itself. The release notes describe the fragment shader alone handling up to sixteen TEV combine stages and the full operand, bias, clamp and shift path that the real chip uses.

This is the same kind of move Dolphin made years ago, trading a simpler but less accurate fixed-function approximation for something closer to what the silicon does. The payoff, per the notes, is a long list of fixed rendering bugs, though the underlying rewrite is also what makes the new automated testing possible in the first place.

Testing what used to be guesswork

The graphics pipeline, from Command Processor through XF, the Setup Unit, Rasteriser, Texture Unit, TEV and Pixel Engine, now has 340 unit tests that run against a real OpenGL context and publish an HTML report with 262 rendered reference images. The notes say the suite caught a batch of long-standing rendering faults during development. The DSP, the GameCube's sound coprocessor, gets similar treatment: 177 tests, 1,822 golden ALU vectors and 435 circular-buffer vectors checked against real hardware behaviour, alongside a full disassembly of the DSP boot ROM. For a project with a small contributor list, that is a serious amount of scaffolding, and it should make future accuracy fixes easier to verify rather than relying on eyeballing a screenshot.

The update also clears a cluster of CPU and memory bugs, including how paired-single instructions and the GQR register are decoded, how the memory management unit walks its page-table hash, and how the decrementer timer behaves. The combined effect, the notes say, is that a 2004-era Linux kernel now boots far enough to reach the framebuffer console with the Broadband Adapter network driver loaded. On the games side, Metroid Prime's intro plays and reaches its title screen, Zelda: The Wind Waker gets past boot, Ikaruga's opening movie now has correct colours, and PONG, of all things, runs again.

What is still open

None of this amounts to broad playability. The release notes list specific milestones, a title screen here, a boot sequence there, rather than claiming finished game support, and there is no benchmark data on speed. The SDL front end also grows up in this release, gaining sound, a file browser and a full game selector with banners and sorting, which suggests the project wants a proper cross-platform build rather than a Windows-only curiosity. Whether the new test suites keep pace with future changes, and whether more commercial titles clear the title screen bar, is not something the notes answer. That is presumably the point of the next release.

Sources

Image: GitHub