base on A Virtual Boy emulator for the 3DS Red Viper ========= A Virtual Boy emulator for the Nintendo 3DS continuing mrdanielps's work on [r3Ddragon](https://github.com/mrdanielps/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 and savestates are supported * 3DS display runs at 50Hz, like the Virtual Boy * Fully customizable button mapping, including New 3DS inputs * Virtual right D-Pad or A/B buttons on the touch screen * Configurable color filter Future additions: * Circle Pad Pro support * More versatile color filter * A forwarder to allow loading a specific game from the home menu ## Usage [A modded 3DS](https://3ds.hacks.guide/) is needed. Once that's sorted, you can install it using [Universal Updater](https://universal-team.net/projects/universal-updater.html). <details> <summary>You can also scan this QR code with FBI.</summary>  </details> Alternatively, the latest release can be manually downloaded [here](https://github.com/skyfloogle/red-viper/releases), 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. ## FAQ > It doesn't work! / What's this DSP firmware error? Try updating your Luma3DS installation (I tested with v13.0.2). Once it's updated, you may need to [dump your DSP firmware](https://3ds.hacks.guide/finalizing-setup#section-iii---rtc-and-dsp-setup). > The depth slider is weird. The Virtual Boy wasn't designed with a depth slider, so games can't have their depth scaled in the way 3DS games can. The alternative is to shift the entire image backwards or forwards, similar to how the Virtual Boy's IPD slider works. The default setting (3DS mode) starts at a "neutral" level and pushes the image further back as you move the slider up, keeping the metaphor fairly similar to how most 3DS games work. Alternatively, "Virtual Boy IPD" mode can be enabled, which unlocks the full range, from closest to furthest. To use the "default" level, use 3DS mode and keep the depth slider on, but near the bottom. > What do the numbers in the performance info mean? This displays the time taken for **A**ll processing in one frame, **D**RC processing (CPU emulation), **C**itro3D processing (CPU graphics), and **P**ICA200 processing (GPU graphics). It also displays the **M**emory usage of the DRC cache (increases over time then resets). As this is a developer option at heart, frametimes are displayed in milliseconds rather than FPS, as the former is much easier to reason about in this context. The target is usually 20ms, though some games only draw every other frame, so rendering has more leeway there. ## Building After setting up [devkitPro](http://3dbrew.org/wiki/Setting_up_Development_Environment), install the additional dependencies: ```bash > pacman -S 3ds-zlib ``` After cloning the repository, fetch the last dependencies: ```bash > git submodule update ``` Once that's all sorted, 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. * djedditt - Enhanced 3D depth slider support. * Morintari - splash screen artwork * nevumx - Custom control scheme * All GitHub contributors ", Assign "at most 3 tags" to the expected json: {"id":"8121","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"