Editing DeSmuME

{{Infobox emulator
|logo = Desmume.png
|logowidth = 100
|version = {{Version|DeSmuME}}
|active = Yes
|platform = Multi-platform
|target = [[Nintendo DS emulators|Nintendo DS]]
|developer = YopYop156<br/>[http://wiki.desmume.org/index.php?title=DeSmuME:About#DeSmuME_current_team DeSmuME Team]
|website = [https://desmume.org/ DeSmuME.org]
|source = [https://github.com/TASEmulators/desmume GitHub]
|license = GNU GPLv2
}}

'''DeSmuME''' is an open-source [[Nintendo DS emulators|Nintendo DS emulator]]. It is the most accurate Nintendo DS emulator and is actively developed by the DeSmuME Team. It can be run from the command line directly or as a graphical program.

The regular version now allows for increasing internal resolution.

It is also available as a libretro core for [[RetroArch]].

==Download==
{| cellpadding="4"
|-
|align=center|{{Icon|Win-big}}
|'''[https://desmume.org/download/ Stable & Nightly releases]'''
|-
|colspan="3"|<hr/>
|-
|align=center|{{Icon|Win-big}}
|[https://nightly.link/TASEmulators/desmume/workflows/build_win/master/desmume-win-x64 Latest Dev build]<br><small>Requires [https://www.microsoft.com/en-us/download/details.aspx?id=52685  Microsoft Visual C++ Runtime]</small>
|-
|align=center|{{Icon|3DS}}
|[https://github.com/shutterbug2000/DeSmuME/releases/tag/v0.1-confandselect 3DS Port]<br><small>(Inactive)</small>
|-
|align=center|{{Icon|Wii}}
|[http://code.google.com/p/desmumewii/downloads/list Wii Port]<br><small>(Inactive)</small>
|}

==Issues==
DeSmuME uses [[Wikipedia:DirectInput|DirectInput]] if an [[Xbox 360 emulators|Xbox 360]] controller is being used. No support for [[Wikipedia:DirectInput#XInput|XInput]] exists. This will be noticeable if an Xbox 360 controller's LT and RT inputs are mapped to emulate the DS's L and R buttons respectively.

Several features aren't supported by DeSmuME and aren't parts of its future as per the emulator's current design philosophy. They include:
*DS Download Play
*DS Local Play (local multiplayer)
*DSi emulation (DSi-enhanced retail, DSi-exclusive retail, DSiWare)
*DS/Wii Connectivity

A DeSmuME fork with online multiplayer, which includes functional code that made it to official version 0.9.7 before being removed, is available and has been improved to allow for limited dumping of online data prior to the server shutdown in 2014, as well as a version allowing for using online play for a select few games and downloading DLC data from alternative servers with the backed-up data.

At some point in 2010, development on these features was permanently discontinued and the developers distanced themselves from the above-mentioned fork. The official team stance on this is as follows, and is as clear as it can get:

::''As you may have come to find, Release versions and WIP builds distributed by DeSmuME developers do not have the Wi-Fi menu enabled, while builds provided by dodgy scener sites or the one your best friend in the whole wide world has handed to you on a USB key does.''
::''Officially, DeSmuME DOES NOT support the use of builds with Wi-Fi support.''
::''As such, though it may come as a shock to you, requests for help or information about it are thus NOT likely to obtain a response to your satisfaction.''
::''The developers have no current interest for furthering the development of the EXPERIMENTAL_WIFI, and the current state of the DeSmuME source code might have even completely broken it.''

It was also deemed that the Dynamic JIT recompiler was a poor fit for the DeSmuME project and as such a fork called "DeSmuME 0.9.9 JIT" including it was made, and some used to recommend it over the mainline project. Much later, like with the internal resolution feature, a compromise was reached and a slightly different implementation was since included in the main project after 0.9.11. 

Wi-Fi/Online support has also been re-included in versions 0.9.12 and later.

==Troubleshooting==
If the game is slow:
*Enable the '''dynamic recompiler''' in '''Emulation Settings'''.
*If it's still slow, you must be running on a toaster. It can't be helped. But try tinkering with things for the fastest settings you can find.
*Use frameskip as the absolute last resort.
*If your graphics card was designed by Nvidia and the OpenGL Display Method (useful for its filter) is stuttering despite reporting good framerate, open the Nvidia Control Panel and turn off Threaded Optimization for this program. What's happening is sequential OpenGL code is being put on different processors running at different speeds, forcing them to wait for each other repeatedly.
If the sound is distorted.
*'''Synchronous''' mode is far less buggy. '''Method Z''' seems to work the best in most cases.
If the 3D is messed up.
*Set it to OpenGL 3.2. Old OpenGL had problems with 3D itself, while SoftRasterizer had alignment issues with 2D. But 3.2 seems to fix most of both.
*SoftRasterizer's texture alignment issues are supposedly fixed on a per game basis with the newer TXT hack. It now seems to be more compatible and showing more effects than GL3.2. Etrian Odyssey and Dragon Quest V seem to work best with it over GL3.2.

==Graphical enhancement==
After the increased internal resolutions were implemented in the X432 fork, as well as in [[DraStic]] and even the barebones official Nintendo Virtual Console DS emulator on Wii U, the mainline DeSmuME project developers decided to reconsider and include their own implementation for higher internal resolution.

Official dev builds now have the option to render at a higher resolution as well, and filter textures to boot. Overall, it's more hardware intensive than X432R's implementation.

The latest development version of [[RetroArch]] DeSmuME core also has an option to increase internal resolution which can be set using '''desmume_internal_resolution''' in Core Options. This option was added in [https://github.com/libretro/desmume/commit/5e430dfbc22f9d54c77f291304a38352ee1e5a63 August 8, 2015 commit]. This is massively CPU-intensive because only SoftRasterizer exists in RetroArch core.

*The OpenGL 3.2 renderer option in 3D Settings supports '''Multisampling Anti-Aliasing (MSAA)'''. Turning it on helps the edges of ultra low-res DS polygons and lines smooth out appear to wobble less during movement, and retain their shape better when viewed from distance. Unlike post-processing effects that modify the still frame after completion and essentially try to guess at the shapes they are smoothing, this effect knows the actual shapes of the polygons themselves.
**Versions before r5032 had this option for a long time, but it was only put in the GUI at r5032. To turn it on in older versions you needed to change a value from false to true in the source code and recompile it.
*Another thing you can do is filter it. Make sure '''OpenGL''' and '''Filter''' are checked under '''Display Method'''.
*Finally, there are a variety of post-processing shaders that can be selected under '''Magnification Filter'''. Whether that is simple Nearest 2x or some pixel art scaling filter like HQx or xBRZ is up to you. No post-processing smoothing is perfect, but if you want to use one the xBRZ options are generally the most high-end among smoothing filters present.
*macOS version of DeSmuME also has support for multi-pass post-processing shaders and filters which Windows version currently doesn't have.
*Leaving it native and aligning it to a CRT (Set to a 384 high resolution) is also an option, if you feel like going through the effort.
*Recent Desmume revisions now add support for texture filtering, greatly reducing pixelation albeit at the cost of blurrier visuals. Some may find this rather jarring or too N64-esque, so it's a matter of individual preference as there's an option to turn it on or off. 

===DeSmuME X432R===
Mainline DeSmuME didn't offer any options for higher than native internal resolutions at first. DeSmuME X432R is a fork with the option to increase internal resolution. Be warned that this option is very system-intensive. There have been reports of people who can run [[Dolphin]] and [[PCSX2]] at a perfect pace but can't run this at full speed using increased internal resolution, however newer versions are much faster.

While generally more accurate, the SoftRasterizer is massively CPU-intensive in this mode, whereas the OpenGL renderer shares the load with your GPU. This can be considered a '''speedup''' option, but it also boasts an MSAA option unavailable to SoftRasterizer.

This fork also has some options for configuring sub-screens. This fork is no longer active, and its last version is dated 19-04-2015.

*[https://web.archive.org/web/20190718184333/http://shikaver01.webcrow.jp/ http://shikaver01.webcrow.jp/] <small>(Wayback Machine)</small>
*Binary of SVN r5043: http://www75.zippyshare.com/v/67167782/file.html

==Review==
DeSmuME is currently one of the best available [[Nintendo DS emulators|Nintendo DS emulator]] on PCs, however [[MelonDS]] has been catching up in recent years. It is far better than [[No$|No$GBA]] when it comes to accuracy, though not flawless, and there are some aspects of DeSmuME that are more mature than the MelonDS. However, it's more hardware intensive than most other DS emulators (either No$GBA or emulated DraStic) and many features are not supported.

==Gallery==
<gallery>
Internal resolution comparion - Assassin's Creed II Discovery.png|Top: native internal resolution (256x192). Bottom: 4x internal resolution (1024x768)
Kit Mystery Challenge nearest neighbour.png|''Kit Mystery Challenge'' running at 2x internal resolution and nearest-neighbour (i.e. DS-style) texture filtering.
Kit Mystery Challenge filtered.png|The same scene in ''Kit Mystery Challenge'', albeit with GL Tex Smoothing enabled. Notice the blurrier floor texture.
</gallery>

==Guides and info==
*[https://wiki.desmume.org/index.php?title=Main_Page DeSmuME Wiki]
*[https://wiibrew.org/wiki/DeSmuME_Wii/Compatibility_List DeSmuMe Wii Compatibility List]
<!-- ==References==
<references/> -->

[[Category:Emulators]]
[[Category:Console emulators]]
[[Category:Handheld console emulators]]
[[Category:Wii emulation software]]
[[Category:Nintendo DS emulators]]
[[Category:Windows emulation software]]
[[Category:Linux emulation software]]
[[Category:macOS emulation software]]