daa7520d1d
* Deploy QT DLLs using windeployqt tool Replace the old mechanism that manually copy the DLLs using either CMake or VS built-in functions. The new approach uses the windeployqt tool provided by the QT project that automatically detect the needed DLLs and perform the necessary copying. This approach should be more robust if there's an upstream change on QT project regarding DLLs usage. * QT DLLs: do not ship RPCS3 with ANGLE and software-OpenGL According to https://doc.qt.io/qt-5/windows-requirements.html ANGLE is useful for applications that use OpenGL ES by removing the need to install OpenGL drivers, redirecting OpenGL calls to DirectX instead. RPCS does not uses OpenGL ES so it's better to just remove it from the binary distribution. opengl32sw.dll is a fallback mechanism when ANGLE libraries are not available that uses a software backend for OpenGL. It's unlikely that RPCS3 will work using software-OpenGL, so there's little point into shipping them. * QT DLLs: do not ship with SVG and translation files Like the other removed QT libraries: they are not needed right now. We can deploy them if they become useful someday. |
||
---|---|---|
3rdparty | ||
asmjit@1370fe6a26 | ||
asmjitsrc | ||
bin | ||
llvm@4423e35117 | ||
llvm_build | ||
ps3emu_api | ||
rpcs3 | ||
rpcs3-tests | ||
rsx-debugger@3b11b9652d | ||
Utilities | ||
Vulkan | ||
.clang-format | ||
.editorconfig | ||
.gitignore | ||
.gitmodules | ||
.mention-bot | ||
.travis.yml | ||
appveyor.yml | ||
CMakeLists.txt | ||
CONTRIBUTING.md | ||
git-clang-format | ||
LICENSE | ||
pre-commit.readme | ||
qt-installer-noninteractive.qs | ||
README.md | ||
rpcs3_debug.props | ||
rpcs3_default.props | ||
rpcs3_llvm.props | ||
rpcs3_memleak.props | ||
rpcs3_release.props | ||
rpcs3.sln | ||
usertype.dat | ||
zlib.props |
RPCS3
The world's first open-source PlayStation 3 emulator/debugger written in C++ for Windows and Linux.
You can find some basic information in our website. For discussion about this emulator and PS3 emulation please visit our forums and our Discord server.
Support Lead Developers Nekotekina and kd-11 on Patreon
Development
If you want to contribute please take a look at the Coding Style, Roadmap and Developer Information pages. You should as well contact any of the developers in the forums or in Discord in order to know more about the current situation of the emulator.
Dependencies
Windows
- Visual Studio 2015
- Visual C++ Redistributable Packages for Visual Studio 2015
- Cmake 3.1.0+ (required; add to PATH)
- Python 3.3+ (required; add to PATH)
- Qt 5.7+ (required; add QTDIR
<QtInstallFolder>\5.7\msvc2015_64\
environment variable if you do not want to use the Visual Studio Qt Plugin) - Visual Studio Qt Plugin (optional; see above)
Linux
- Qt 5.7+
- GCC 5.1+ or Clang 3.5.0+ (not GCC 6.1)
- Debian & Ubuntu:
sudo apt-get install cmake build-essential libasound2-dev libopenal-dev libglew-dev zlib1g-dev libedit-dev libvulkan-dev libudev-dev git qt5-default
- Arch:
sudo pacman -S glew openal cmake llvm qt5-base
- Fedora:
sudo dnf install cmake qt5-devel vulkan-devel glew glew-devel
If you have a NVIDIA GPU, you may need to install the libglvnd package.
MacOS
MacOS is not supported at this moment because it doesn't meet system requirements (OpenGL 4.3)
- Xcode 6+ (tested with Xcode 6.4)
- Install with Homebrew:
brew install glew llvm qt cmake
Building on Windows:
To initialize the repository don't forget to execute git submodule update --init
to pull the submodules.
Configuring Qt
If you're using Visual Studio 2017 without Qt plugin support (or simply dont want to use it):
- Add
QTDIR
environment variable and set it to<QtInstallFolder>\5.7\msvc2015_64\
If you wish to use the Visual Studio plugin for Qt:
- Go to the Qt5 menu and edit Qt5 options. Add the path to your Qt installation with compiler e.g.
C:\Qt\5.7\msvc2015_64
. - While selecting the rpcs3qt project, go to Qt5->Project Setting and select the version you added.
Building the projects
- Build the projects in __BUILD_BEFORE folder: right-click on every project > Build.
- Press BUILD > Build Solution or Rebuild Solution.
Building on Linux & Mac OS:
git clone https://github.com/RPCS3/rpcs3.git
cd rpcs3/
git submodule update --init
cmake CMakeLists.txt && make GitVersion && make
- Run RPCS3 with
./bin/rpcs3
If you are on MacOS and want to build with brew llvm and qt don't forget to add the following environment variables
LLVM_DIR=/usr/local/opt/llvm/
(or wherever llvm was installed).Qt5_DIR=/usr/local/opt/qt/lib/cmake/Qt5
(or wherever qt was installed).
When using GDB, configure it to ignore SIGSEGV signal (handle SIGSEGV nostop noprint
).
CMake Build Options (Linux & Mac OS)
-
-DUSE_SYSTEM_LIBPNG=ON/OFF
(default = OFF)
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)
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. -
-DUSE_SHARED_LLVM_LIBS=ON/OFF
(default = OFF)
This builds against the shared LLVM libs, rather than the static ones. This may interfere with Mesa and render RPCS3 non-functional. Only recommended on gentoo. -
-DWITHOUT_LLVM=ON/OFF
(default = OFF)
This forces RPCS3 to build without LLVM, not recommended. -
-DWITH_GDB=ON/OFF
(default = OFF)
This Builds RPCS3 with support for debugging PS3 games using gdb. -
-DUSE_VULKAN=ON/OFF
(default = ON)
This builds RPCS3 with Vulkan support.
License
Most files are licensed under the terms of GNU GPLv2 License, see LICENSE file for details. Some files may be licensed differently, check appropriate file headers for details.