automatically build plugins
[pcsx_rearmed.git] / readme.txt
index c793c7c..b1459c8 100644 (file)
@@ -12,9 +12,11 @@ which itself contains code from PCSX, PCSX-df and PCSX-Revolution. This
 version is ARM architecture oriented and features MIPS->ARM recompiler by
 Ari64, NEON GTE code and more performance improvements. It was created for
 Pandora handheld, but should be usable on other devices after some code
 version is ARM architecture oriented and features MIPS->ARM recompiler by
 Ari64, NEON GTE code and more performance improvements. It was created for
 Pandora handheld, but should be usable on other devices after some code
-adjustments (N900 version is also available).
+adjustments (N900, GPH Wiz/Caanoo versions are also available).
 
 
-PCSX ReARMed features GPU plugin from PCSX4ALL project.
+PCSX ReARMed features ARM NEON GPU by Exophase, that in many cases produces
+pixel perfect graphics at very high performance. There is also Una-i's GPU
+plugin from PCSX4ALL project, and traditional P.E.Op.S. one.
 
 
 Usage
 
 
 Usage
@@ -32,6 +34,7 @@ Supported CD image formats:
 - .bz/.bz.table
 - .ZNX/.ZNX.table (partial)
 - EBOOT.PBP (PSP, partial)
 - .bz/.bz.table
 - .ZNX/.ZNX.table (partial)
 - EBOOT.PBP (PSP, partial)
+- .cbn
 
 CDDA (CD audio) only supported when .cue/.toc/.ccd/.mds files are present.
 There is support for redump.org .sbi files, which can be used instead of
 
 CDDA (CD audio) only supported when .cue/.toc/.ccd/.mds files are present.
 There is support for redump.org .sbi files, which can be used instead of
@@ -44,8 +47,8 @@ to work. To use real BIOS, copy uncompressed BIOS files to
 [sd card]/pandora/appdata/pcsx_rearmed/bios/
 then select the BIOS you want to use in Options->BIOS/Plugins menu.
 
 [sd card]/pandora/appdata/pcsx_rearmed/bios/
 then select the BIOS you want to use in Options->BIOS/Plugins menu.
 
-Analog controllers are supported using nubs, but this is disabled by
-default and needs to be enabled in 'Controls' menu.
+On pandora, analog controllers are supported using nubs, but this is
+disabled by default and needs to be enabled in 'Controls' menu.
 There is also touchscreen based GunCon support, which also requires
 appropriate controller selected in controls configuration.
 
 There is also touchscreen based GunCon support, which also requires
 appropriate controller selected in controls configuration.
 
@@ -56,18 +59,68 @@ Plugins
 GPU (graphics) and SPU (sound) plugins can be selected in
 [BIOS/Plugins] menu:
 
 GPU (graphics) and SPU (sound) plugins can be selected in
 [BIOS/Plugins] menu:
 
-builtin_gpu    - the P.E.Op.S. GPU plugin, most accurate but slow.
-gpuPCSX4ALL.so - plugin from PCSX4ALL project. Faster but has some glitches.
+builtin_gpu    - this is either Exophase's ARM NEON GPU (accurate and fast,
+                 available if platform supports NEON), else it's P.E.Op.S.
+                 soft GPU (accurate but slow).
+gpuPCSX4ALL.so - plugin from PCSX4ALL project. Faster than P.E.Op.S.
+                 but has some glitches.
 gpuGLES.so     - experimental port of P.E.Op.S. MesaGL plugin to OpenGL ES.
                  Occasionally faster but has lots of glitches and seems to
                  be rather unstable (may crash the system).
 gpuGLES.so     - experimental port of P.E.Op.S. MesaGL plugin to OpenGL ES.
                  Occasionally faster but has lots of glitches and seems to
                  be rather unstable (may crash the system).
-builtin_spu    - P.E.Op.S. SPU plugin.
+gpuPEOPS.so    - P.E.Op.S. soft GPU (in case builtin one is NEON)
+builtin_spu    - P.E.Op.S. SPU plugin, optimized for ARM.
 spunull.so     - NULL plugin, i.e. no sound emulation.
 
 
 Changelog
 ---------
 
 spunull.so     - NULL plugin, i.e. no sound emulation.
 
 
 Changelog
 ---------
 
+r14 (2012-03-04)
+* GLES GPU: implemented frameskip
+* GLES GPU: merged some changes from schtruck/FPSE
+* Caanoo: potential workaround for save corruption
+  (always exit emulator cleanly before turning off the console
+   to reduce chance of corruption)
+* Caanoo: fixed a bug in GTE code (graphic glitches in some games)
+* Caanoo: reworked vibration support, should support more games
+* various refactoring/minor tweaks
+
+r13 (2012-01-09)
+* yet more fixes for regressions from earlier versions
+* various fixes for NEON GPU (in collaboration with Exophase)
++ NEON GPU supports interlace mode now, but it's not always
+  enabled due to frameskip glithes (can be changed in the menu)
+* cdda should resume on savestate load now
+* fixed date display in menus to honour locale
++ pandora: added support for minimizing the emulator (while ingame only)
+
+r12 (2011-12-24)
++ new ARM NEON GPU rasterizer from Exophase (NEON hardware required)
++ new GPU emulation code
++ new analog controller configurator
+* changed frameskip handling (again..), higher values supported
+* fixed several more regressions from earlier versions
+* changed cdrom code with hope for better compatibility
+* sprite optimization for PCSX4ALL plugin
++ Caanoo: added vibration support
+
+r11 (2011-10-31)
++ added Wiz support
+* Caanoo: fixed tv-out
++ Caanoo/Wiz: added scaling (16bpp only)
++ Caanoo/Wiz: added touchscreen-as-buttons input (4 sections)
++ added .cbin support
++ added multidisk eboot support (use "next multidisk CD" in exras menu)
+* some GTE related optimizations
+* various other optimizations
++ added some speed hack options for slower devices
+  (get more speed at stability and correctness loss)
+* fixed several compatibility issues
+* fixed a few crash situations
+* various minor adjustments
+* maemo: merged some code from Bonapart
+* maemo: fixed BIOS issue (hopefully)
+
 r10 (2011-10-10)
 + added Caanoo port
 + completely rewrote memory handlers
 r10 (2011-10-10)
 + added Caanoo port
 + completely rewrote memory handlers
@@ -224,6 +277,10 @@ Emulator core:
        Dario, NeToU, siveritas (Various bugfixes)
        Wei Mingzhi (Maintainer, input plugin, iso/cheat support, misc stuff)
 
        Dario, NeToU, siveritas (Various bugfixes)
        Wei Mingzhi (Maintainer, input plugin, iso/cheat support, misc stuff)
 
+NEON GPU plugin:
+       (C) 2011-2012 Exophase
+       (C) 2011-2012 notaz
+
 PCSX4ALL GPU plugin:
        (C) 2010 PCSX4ALL Team
        (C) 2010 Unai
 PCSX4ALL GPU plugin:
        (C) 2010 PCSX4ALL Team
        (C) 2010 Unai
@@ -237,25 +294,31 @@ GLES plugin (psx4m project):
        Proger
        Pickle
 
        Proger
        Pickle
 
-builtin GPU/SPU plugin:
+P.E.Op.S. GPU plugin:
        (C) Pete Bernert and the P.E.Op.S. team
 
        (C) Pete Bernert and the P.E.Op.S. team
 
-builtin SPU plugin:
+P.E.Op.S. SPU plugin:
        (C) Pete Bernert and the P.E.Op.S. team
        (C) SPU2-X, gigaherz, Pcsx2 Development Team
        shalma
        (C) Pete Bernert and the P.E.Op.S. team
        (C) SPU2-X, gigaherz, Pcsx2 Development Team
        shalma
+       notaz
 
 MIPS->ARM recompiler:
        (C) 2009-2011 Ari64
 
 integration, optimization and frontend:
 
 MIPS->ARM recompiler:
        (C) 2009-2011 Ari64
 
 integration, optimization and frontend:
-       (C) 2010-2011 notaz
+       (C) 2010-2012 notaz
 
 
-some implementation ideas (and maybe code?) likely originated from
+Special thanks to Mednafen author, shalma/gretar and Rokas for
+various help while developing this emulator.
+
+Some implementation ideas (and maybe code?) likely originated from
 MAME/smf/pSXauthor and were integrated by various people to PCSX.
 
 Source code is released under GNU GPL license, version 2 or later.
 MAME/smf/pSXauthor and were integrated by various people to PCSX.
 
 Source code is released under GNU GPL license, version 2 or later.
-See COPYING included in the archive (.pnd can be extracted using unsquashfs).
+See COPYING included in the archive (pandora version's .pnd can be
+extracted using unsquashfs).
+
 The source code is available in a GIT repository at:
 
 git://notaz.gp2x.de/~notaz/pcsx_rearmed.git
 The source code is available in a GIT repository at:
 
 git://notaz.gp2x.de/~notaz/pcsx_rearmed.git