mirror of https://github.com/RPCS3/rpcs3.git
61 lines
3.4 KiB
Markdown
61 lines
3.4 KiB
Markdown
RPCS3
|
|
=====
|
|
|
|
[](https://travis-ci.org/RPCS3/rpcs3)
|
|
[](https://ci.appveyor.com/project/rpcs3/rpcs3/branch/master)
|
|
[](https://scan.coverity.com/projects/3960)
|
|
[](https://coveralls.io/r/RPCS3/rpcs3)
|
|
|
|
An open-source PlayStation 3 emulator/debugger written in C++.
|
|
|
|
You can find some basic information in the [FAQ](https://github.com/RPCS3/rpcs3/wiki/FAQ). For discussion about this emulator and PS3 emulation please visit the [official forums](http://www.emunewz.net/forum/forumdisplay.php?fid=162).
|
|
|
|
|
|
### Development
|
|
|
|
If you want to contribute please take a look at the [Coding Style](https://github.com/RPCS3/rpcs3/wiki/Coding-Style), [Roadmap](https://github.com/RPCS3/rpcs3/wiki/Roadmap) and [Developer Information](https://github.com/RPCS3/rpcs3/wiki/Developer-Information) pages. You should as well contact any of the developers in the forum in order to know about the current situation of the emulator.
|
|
|
|
|
|
### Dependencies
|
|
|
|
__Windows__
|
|
* [Visual Studio 2015](https://www.visualstudio.com/en-us/downloads/download-visual-studio-vs.aspx)
|
|
* [Visual C++ Redistributable Packages for Visual Studio 2015](http://www.microsoft.com/en-us/download/details.aspx?id=48145)
|
|
* [Cmake 3.1.0+](http://www.cmake.org/download/) (required; add to PATH)
|
|
* [Python 3.3+](https://www.python.org/downloads/) (required; add to PATH)
|
|
|
|
__Linux__
|
|
* GCC 5.1+ or Clang 3.5.0+ ([not GCC 6.1](https://github.com/RPCS3/rpcs3/issues/1691))
|
|
* Debian & Ubuntu: `sudo apt-get install cmake build-essential libopenal-dev libwxgtk3.0-dev libglew-dev zlib1g-dev libedit-dev libvulkan-dev`
|
|
* Arch: `sudo pacman -S glew openal wxgtk cmake llvm`
|
|
|
|
__Mac OSX__
|
|
* Xcode 6+ (tested with Xcode 6.4)
|
|
* Install with Homebrew: `brew install glew wxwidgets`
|
|
* Remove '-framework QuickTime' from '_ldflags' in /usr/local/bin/wx-config
|
|
|
|
|
|
### Building
|
|
|
|
To initialize the repository don't forget to execute `git submodule update --init` to pull the submodules.
|
|
* __Windows__:
|
|
1) Open the *.SLN* file.
|
|
2) Build the projects in *__BUILD_BEFORE* folder: right-click on every project > *Build*.
|
|
3) Press *BUILD* > *Build Solution* or *Rebuild Solution*.
|
|
* __Linux & Mac OSX__:
|
|
If you want to build with LLVM, then LLVM 3.8 is required.
|
|
`cd rpcs3 && cmake CMakeLists.txt && make && cd ../` then run with `cd bin && ./rpcs3`.
|
|
If you are on OSX and want to build with llvm don't forget to add `-DLLVM_DIR=...` (or wherever llvm brew was installed) to cmake invocation.
|
|
When using GDB, configure it to ignore SIGSEGV signal (`handle SIGSEGV nostop noprint`).
|
|
|
|
##### CMake Build Options (Linux & Mac OSX)
|
|
|
|
- ```-DUSE_SYSTEM_LIBPNG=ON/OFF``` (default = *OFF*) </br>
|
|
Build against the shared libpng instead of using the builtin one. libpng 1.6+ highly recommended. Try this option if you get version conflict errors or only see black game icons.
|
|
|
|
- ```-DUSE_SYSTEM_FFMPEG=ON/OFF``` (default = *OFF*) </br>
|
|
Build against the shared ffmpeg libraries instead of using the builtin patched version. Try this if the builtin version breaks the OpenGL renderer for you.
|
|
|
|
### Support
|
|
* [Donate by PayPal](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=nekotekina%40gmail%2ecom&lc=US&item_name=RPCS3¤cy_code=USD&bn=PP%2dDonationsBF%3abtn_donate_LG%2egif%3aNonHosted)
|