Red Viper

A Virtual Boy emulator for the Nintendo 3DS continuing mrdanielps's work on r3Ddragon, which is itself based on Reality Boy / Red Dragon. It uses a dynamic recompiler with busywait detection and a hardware-accelerated renderer to achieve high performance on the 3DS's limited hardware.

Features

• All officially licensed games are playable at full speed, even on the original 3DS
• 3D support
• Game saves are supported
• Map either the A/B buttons or the right D-Pad to the face buttons, with the other being on the touch screen
• New 3DS C-Stick is also supported
• Configurable face button mapping
• Configurable color filter

Future additions:

• Support for PCM samples
• Savestates
• Homebrew support
• Circle Pad Pro support
• Button controls for menu
• More versatile color filter
• A forwarder to allow loading a specific game from the home menu

Usage

The latest release can be found here, provided as a 3DSX (can be loaded with Homebrew Launcher) and as a CIA (can be installed to the home menu with FBI). ROMs can be placed in any desired location on your SD card. The emulator will remember the location of the last ROM you loaded.

A display with some simple performance info can be enabled in the settings. Through this, you can see the time taken for All proecessing, DRC processing (CPU emulation), Citro3D processing (CPU graphics), and PICA200 processing (GPU graphics), and the Memory usage of the DRC cache (increases over time then resets).

Building

Before building, fetch the dependencies:

> git submodule update

Once you have ctrulib installed, you can choose between four different make targets:

• make release is the default, and adds -O3 to CFLAGS.
• make testing adds -O3 to CFLAGS. It will output basic debug info to a connected debugger.
• make debug adds -g -O0 to CFLAGS. It builds without optimizations so it can be debugged more easily.
• make slowdebug adds -g -O0 to CFLAGS. It will output a lot of debug information, which will slow emulation down but might be helpful to debug game-specific issues.

License

Some of the code is distributed under the MIT License (check source files for that) but, since this is a port of Reality Boy, here is (part of) the original readme:

This Reality Boy emulator is copyright (C) David Tucker 1997-2008, all rights
reserved.   You may use this code as long as you make no money from the use of
this code and you acknowledge the original author (Me).  I reserve the right to
dictate who can use this code and how (Just so you don't do something stupid
with it).
Most Importantly, this code is swap ware.  If you use It send along your new
program (with code) or some other interesting tidbits you wrote, that I might be
interested in.
This code is in beta, there are bugs!  I am not responsible for any damage
done to your computer, reputation, ego, dog, or family life due to the use of
this code.  All source is provided as is, I make no guaranties, and am not
responsible for anything you do with the code (legal or otherwise).
Virtual Boy is a trademark of Nintendo, and V810 is a trademark of NEC.  I am
in no way affiliated with either party and all information contained hear was
found freely through public domain sources.

Acknowledgments:
----------------

Frostgiant, Parasyte, and DogP (and the rest of people that have contributed
to the VB sceen in the last five years) - Their work on Red_Dragon has been a
real inspiration. Its amazing how far they have gone with so little to start
with.

Bob VanderClay - most of the original code is based off
of his VB disassembler.

Ben Haynor - Provided me with a much better understanding of
the VB internals.

Joseph LoCicero, Dave Shadoff - I stole the jump table ideas from their tg16
disassembler, thanks guys.

Neill Corlett - took many ideas (and some code)
from his Starscream CPU core

Kevin Banks - for donating a very nice pair of Frenzle 3D
viewers, and being an all around great guy.

Megan Tucker - For putting up with my tinkering all night, and resisting the
urge to toss all my video games out the window.

v810 is a trademark of NEC co.
Virtual Boy is a trade mark of Nintendo
Reality Boy is in no way affiliated with either of these parties

Credits

• Everyone mentioned in the license. Without Reality Boy and Red Dragon it wouldn't have been possible.
• smealum and contributors - ctrulib.
• Vappy, Team Fail, HtheB, hippy dave and kane159 on GBAtemp - early testing.
• benhoyt - inih.
• Myria - libkhax
• thunderstruck - CIA banner sound (taken from Fishbone).
• nop90 - Reality Boy backports and fixes.
• danielps - Initial 3DS port and V810 dynarec.
• Floogle - 3DS hardware renderer; many optimizations, bugfixes, and other improvements.