mirror of
https://github.com/RPCS3/rpcs3.git
synced 2024-12-27 15:26:19 +00:00
869e10027d
Provides two options when building RPCS3
USE_SYSTEM_FFMPEG BOOL (default: OFF)
USE_SYSTEM_LIBPNG BOOL (default: OFF)
These options lets the user select between the system provided and builtin libraries of ffmpeg and libpng to overcome possible system issues.
Also adds support for older libpng releases if the user doesn't have libpng 1.5 or higher.
61 lines
3.3 KiB
Markdown
61 lines
3.3 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+
|
|
* 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=_s-xclick&hosted_button_id=MPJ3S9XQXCE3G)
|