README.md

   1 PPSSPP - a fast and portable PSP emulator
   2 =========================================
   3
   4 Created by Henrik Rydgård
   5
   6 Additional code by many contributors, see the Credits screen
   7
   8 Originally released under the GPL 2.0 (and later) in November 2012
   9
  10 Official website:
  11 http://www.ppsspp.org/
  12
  13 No BIOS file required to play, PPSSPP is in many ways a "HLE" emulator.
  14
  15 To contribute, see [the development page](http://www.ppsspp.org/development.html).
  16
  17 For the latest source code, see [our github page](https://github.com/hrydgard/ppsspp).
  18
  19 For build instructions and other development tutorials, see the [wiki](https://github.com/hrydgard/ppsspp/wiki).
  20
  21 What's new in 1.0.1
  22 -------------------
  23 * Bugfixes like the save state scroll issue, cosmetic issues like overscroll
  24 * Some cheat code bugfixes
  25 * Adler32 and Mersenne Twister modules added (fixes some obscure games)
  26 * Fix for Jak & Daxter slowdown
  27 * Graphics hack for Phantasy Star Portable 2 for Direct3D9
  28 * Fix compatibility with some PowerVR devices broken since v0.9.5-959-g4998044
  29
  30 What's new in 1.0
  31 -----------------
  32 * Many, many bug fixes in JIT and elsewhere, improving compatibility
  33 * Proper fix for Zenfone and related devices
  34 * Direct3D 9 supported as a rendering backend on Windows, helps on old GPUs and can be faster than OpenGL in many cases
  35 * You can now create specific configs per game
  36 * FPU rounding modes much better supported, fixes the Peace Walker boss that was undefeatable. NOTE: This breaks saves in Gods Eater - you must turn off the better rounding, load your save game, turn it on and save.
  37 * The JIT now uses SSE on x86, improving speed considerably. This does not affect ARM devices, that's for the next version or two.
  38 * Improved audio output code on both Windows and Android, reducing audio latency on Windows and on some Android systems
  39 * FFMPEG upgraded, fixed some music hangs ("GHA phase shifts")
  40 * Some Ad Hoc improvements, coldbird.net is now default adhoc server. Ad Hoc still unfinished and hard to use.
  41 * Graphics fixes: Bezier/spline drawing fixes, vertex position fixes, DanganRonpa on Adreno fixed, flat shading fixed, vertex cache improved, some PowerVR blockiness issues fixed, screen scaling filter added, Google Cardboard support
  42 * Simulate UMD speed better, fixing hangs in several games
  43 * More Atrac3 fixes, fixing hangs
  44 * Somewhat better disk full handling
  45 * Fixes to dynamic unloading of code, fixing problems in GEB and TRM 2/3
  46 * Updated to SDL2 where applicable (Linux, Mac)
  47 * Some new features, like analog/dpad-swap hotkey, graphics hack for Phantasy Star, show last bit of debug log in dev tools, etc
  48
  49 What's new in 0.9.9.1
  50 -------------------
  51 A few issues have been discovered in the release that need fixing, the Star Ocean fix had a bug and there are some unexpected slowdowns.
  52
  53 Improved sceMpegRingbufferAvailableSize -  UFC© Undisputed™ 2010 now playable
  54
  55 Improved ISO File System - Bleach Soul Carnival 2 now in-game (but freeze when in menu)
  56
  57 What's new in 0.9.9
  58 -------------------
  59 * CLUT (paletted) texturing from framebuffers supported, fixing many graphical issues
  60   like the shadows in Final Fantasy: Type-0
  61 * More types of framebuffer copies are now handled correctly, fixing a variety of graphical
  62   issues, like the sun in Burnout and many more
  63 * Better savedata compatibility with the real PSP
  64 * Support for more codecs used by "Custom BGM" and sometimes regular music in games: MP3, AAC
  65 * PMP video format support
  66 * Implemented some strange blending modes like ABSDIFF as shaders, fixing the outlines in DBZ Tag Team and more.
  67 * Emulation of the vrot CPU instruction improved - it caused cracks in FF3 graphics before
  68 * Many bugfixes around the UI, touch D-pad now works better when scaled large
  69 * Workaround implemented to support Star Ocean's stencil trickery as efficiently as possible on all platforms
  70 * Major corrections to module loading and memory management, fixing further games
  71 * Bulgarian and Thai language translations were contributed
  72 * Many, many more game fixes and bug fixes
  73
  74 What's new in 0.9.8
  75 -------------------
  76 * OpenGL ES 3 detection bug on Xperia devices fixed, graphics work again.
  77 * More accurate audio mixing and emulation
  78 * Software rendering and display list performance improvements
  79 * Workaround for timing issue hanging Crash Tag Team Racing
  80 * Galician language
  81 * Built-in ARM disassembler improvements (dev feature)
  82 * Fix for immersive mode volume key issue on Android Kitkat
  83 * And more minor tweaks and fixes as always.
  84
  85 What's new in 0.9.7.1
  86 ---------------------
  87 * Some critical bugfixes (rotation, haptic feedback on Android, etc)
  88
  89 What's new in 0.9.7
  90 -------------------
  91 * Several scheduling and audio fixes, fixing black screens in Yu Gi Oh games among other things.
  92 * Screen rotation and immersive mode support on Android
  93 * Large improvements to the software renderer (still not really playable, but looks right more
  94   often than not)
  95 * New VPL allocator and bugfixes, fixing Pangya Golf performance problems.
  96 * Some mpeg/video playback fixes, fixing Parappa The Rapper and others. Some issues remain.
  97 * Fix save state bugs causing incompatibility between 32 and 64-bit platforms.
  98 * Symbol map/debugger improvements
  99 * Depth buffer copy, fixing Jeanne D'arc. May cause minor slowdowns though, this will be worked
 100   around in the future.
 101 * MsgDialog fixes. Saving fixed in numerous games.
 102 * Initial multitouch support on Windows 8 for on-screen controls.
 103
 104 What's new in 0.9.6
 105 -------------------
 106 * Large general speed improvements and assorted bug fixes
 107 * "Software Skinning" option which speeds up many games with animated 3D characters
 108   (but may slow down a few, like Monster Hunter games - experiment with turning it off)
 109 * Various fixes around stencil/alpha, reducing glow problems in Wipeout and Gods Eater Burst.
 110 * Timing improvements making more games run at the correct FPS, also fixing some audio issues
 111 * More debugger features
 112 * Option for four-way touch dpad, avoiding diagonal dpad issues
 113 * Better looking and individually resizable touch controls
 114 * Add ability to switch UMD in multi-disc games (works for most)
 115 * Emulate PSP-2000 rather than the 1000 model by default. Not much different in practice.
 116 * Automatic install of games from ZIP files, like demos and many homebrew.
 117 * VERY basic ad-hoc online play support, to be improved in future versions. See below.
 118 * Software renderer improvements
 119
 120 What's new in 0.9.5
 121 -------------------
 122 * Many, many emulation fixes:
 123   - bezier/spline curve support, fixing LocoRoco and others
 124   - stencil clear emulation, fixing Final Fantasy IV text
 125 * Performance improvements in some games
 126 * Post-processing shaders like FXAA, scanlines, vignette
 127 * More solid save states (we will try to keep them working from now on. Save states only upgrade forward,
 128   not backward to older versions though).
 129 * Change render resolution independently of window size
 130 * Massive debugger improvements
 131 * Win32 menu bar is now translatable
 132 * Multiple UI bugs were fixed, and the UI instantly changes when a new language is selected
 133 * Win32: Ability to store PPSSPP's config files and memory stick files in places other than the same directory
 134 * Android-x86 support
 135 * Unofficial port for modified Xbox 360 consoles
 136 * Atrac3+ plugin no longer required. Symbian now supports Atrac3+ audio.
 137 * Symbian audio and ffmpeg is now threaded for more consistent media processing.
 138 * Haptic feedback support for mobile devices.
 139 * Accurate system information for mobile devices.
 140 * Qt audio has been fixed.
 141 * Analog controller support for Blackberry.
 142
 143
 144 ADHOC SUPPORT (by Igor Calabria)
 145 ================================
 146 This is based on coldbird's code: http://code.google.com/p/aemu/
 147 All credit goes to him!
 148
 149 Status
 150 ------
 151 Code is a bit of a mess and it's not fully functional yet, I still need to implement
 152 some functions and add a upnp lib(really important for people with routers).
 153
 154 I did test it with some games(emulator <-> real psp with the server running locally)
 155 and it's looking good:
 156
 157 * Worms Open Warfare: Ran just fine, I was able to play a whole match without problems
 158 * Monster Hunter Freedom Unite: Runs fine too. Gathering Hall and embarking on quests works
 159 * Dissidia Duodecim 012: Doesn't work. It requires some functions that I haven't implemented
 160 yet. Also, it uses a port < 1000 and thats reserved for admin apps on linux, running the emu
 161 as sudo "solves" it, but it's far from ideal.
 162 * Pacman World Rally: Works too.
 163
 164 Update (Kyhel) :
 165 ---------------
 166 * Now compiles on both Mac OSX and Windows. For more details on how to play and build
 167 go to see there http://forums.ppsspp.org/showthread.php?tid=3595&pid=59241#pid59241
 168 * Got it tested windows <-> mac osx <-> psp, it works
 169 * Monster Hunter 3rd HD works too, as well as God Eater Burst.