Template:Config/doc: Difference between revisions

Template page
(→‎Parameters: Moved hook static function to debug tab)
(→‎Parameters: Added missing options)
Line 26: Line 26:
<pre>
<pre>
<!-- CPU configuration -->
<!-- CPU configuration -->
|ppu decoder                     = Interpreter (precise), Interpreter (fast), LLVM Recompiler
|ppu decoder                         = Interpreter (precise), Interpreter (fast), LLVM Recompiler
|ppu decoder notes               =
|ppu decoder notes                   =
|spu decoder                     = Interpreter (precise), Interpreter (fast), ASMJIT Recompiler, LLVM Recompiler
|spu decoder                         = Interpreter (precise), Interpreter (fast), ASMJIT Recompiler, LLVM Recompiler
|spu decoder notes               =
|spu decoder notes                   =
|preferred spu threads           = Auto, Single digit between 1 to 6 (e.g. 3), Range between 1 to 6 (e.g. 1 - 3)  
|preferred spu threads               = Auto, Single digit between 1 to 6 (e.g. 3), Range between 1 to 6 (e.g. 1 - 3)  
|preferred spu threads notes     =
|preferred spu threads notes         =
|firmware settings               = Automatically load required libraries, Manually load selected libraries,  
|firmware settings                   = Automatically load required libraries, Manually load selected libraries,  
                                    Load automatic and manual selection, Load liblv2.sprx only
                                      Load automatic and manual selection, Load liblv2.sprx only
|firmware settings notes         = Where Manually load selected libraries or Load automatic and manual selection options  
|firmware settings notes             = Where Manually load selected libraries or Load automatic and manual selection options  
                                    is selected, mention the list of libraries to be selected in this parameter
                                      is selected, mention the list of libraries to be selected in this parameter
|enable thread scheduler         = On, Off
|enable thread scheduler             = On, Off
|enable thread scheduler notes   =
|enable thread scheduler notes       =
|lower spu thread priority       = On, Off
|lower spu thread priority           = On, Off
|lower spu thread priority notes =
|lower spu thread priority notes     =
|enable spu loop detection       = On, Off
|enable spu loop detection           = On, Off
|enable spu loop detection notes =
|enable spu loop detection notes     =
|spu cache                          = On, Off
|spu cache notes                    =
|accurate xfloat                    = On, Off
|accurate xfloat notes              =
|spu block size                      = Safe, Mega, Giga
|spu block size notes                =
</pre>
</pre>
'''GPU configuration'''
'''GPU configuration'''
<pre>
<pre>
<!-- GPU configuration -->
<!-- GPU configuration -->
|renderer                         = OpenGL, Vulkan
|renderer                           = OpenGL, Vulkan
|renderer notes                   =
|renderer notes                     =
|graphics device                 = This option is used only with Vulkan renderer to select the graphics card to be used by   
|graphics device                     = This option is used only with Vulkan renderer to select the graphics card to be used by   
                                    RPCS3 when multiple eligible cards exist. Do not used this parameter on game pages.
                                      RPCS3 when multiple eligible cards exist. Do not used this parameter on game pages.
|graphics device notes           =
|graphics device notes               =
|aspect ratio                     = Auto, 4:3, 16:9
|aspect ratio                       = Auto, 4:3, 16:9
|aspect ratio notes               =  
|aspect ratio notes                 =  
|framelimit                       = Off, 59.94, 50, 60, 30, Auto
|framelimit                         = Off, 59.94, 50, 60, 30, Auto
|framelimit notes                 =
|framelimit notes                   =
|anisotropic filter               = Automatic, Disabled, 2x, 4x, 8x, 16x
|anisotropic filter                 = Automatic, Disabled, 2x, 4x, 8x, 16x
|anisotropic filter notes         =
|anisotropic filter notes           =
|anti-aliasing                   = NA
|anti-aliasing                       = NA
|anti-aliasing notes             =
|anti-aliasing notes                 =
|default resolution               = 1920x1080, 1280x720, 720x480, 720x576, 1600x1080, 1440x1080, 1280x1080, 960x1080
|default resolution                 = 1920x1080, 1280x720, 720x480, 720x576, 1600x1080, 1440x1080, 1280x1080, 960x1080
|default resolution notes         =
|default resolution notes           =
|resolution scale                 = Range between 50% to 800%
|resolution scale                   = Range between 50% to 800%
|resolution scale notes           =
|resolution scale notes             =
|resolution scale threshold       = Range between 1 to 1024 in the format 16 x 16
|resolution scale threshold         = Range between 1 to 1024 in the format 16 x 16
|resolution scale threshold notes =
|resolution scale threshold notes   =
|write color buffer               = On, Off
|write color buffer                 = On, Off
|write color buffer notes         =
|write color buffer notes           =
|use gpu texture scaling         = On, Off
|use gpu texture scaling             = On, Off
|use gpu texture scaling notes   =
|use gpu texture scaling notes       =
|strict rendering mode           = On, Off
|strict rendering mode               = On, Off
|strict rendering mode notes     =
|strict rendering mode notes         =
|vsync                           = On, Off
|vsync                               = On, Off
|vsync notes                     =
|vsync notes                         =
|stretch to display area         = On, Off
|stretch to display area             = On, Off
|stretch to display area notes   =
|stretch to display area notes       =
|disable vertex cache             = On, Off
|disable vertex cache               = On, Off
|disable vertex cache notes      =
|disable vertex cache notes         =
|disable async shader compiler       = On, Off
|disable async shader compiler notes =
</pre>
</pre>
'''Debug configuration'''
'''Debug configuration'''
<pre>
<pre>
<!-- Debug configuration -->
<!-- Debug configuration -->
|force cpu blit emulation         = On, Off
|force cpu blit emulation           = On, Off
|force cpu blit emulation notes   =
|force cpu blit emulation notes     =
|hook static function             = On, Off
|hook static function               = On, Off
|hook static function notes       =
|hook static function notes         =
</pre>
</pre>



Revision as of 15:16, 20 October 2018

This template is used on all game pages under the ==Configuration== sub-header. The purpose of the template is to capture deviations in configurations from the default settings to be used for the emulator for each game. Hence, while using this template in the game pages, only options which deviate from the default settings are to be recorded.

Refer here for the full list of default settings used in the emulator.

Mandatory vs. recommendatory settings

Before using this is template, it is imperative to understand the distinction between mandatory settings and recommendatory settings.

  • Mandatory settings - Settings without which the game would not work (for example, write colour buffer for Demon's Souls and PPU Interpreter (precise) for The Elder Scrolls IV: Oblivion) or will significantly degrade performance.
  • Recommendatory settings - User specific settings which will improve the overall gaming experience based on the hardware available. For example, a higher option can be used for Anisotropic Filter and Resolution Scale if the user's hardware is capable of handling the additional load whereas settings such as Lower SPU Thread Priority should be used for better performance with weaker CPUs.

Given the nature of the options available, it is not feasible to capture all permutations of settings for each game using this template. Hence, only mandatory settings shall be listed in the game pages using this template. To know which recommendatory setting would be most appropriate, kindly read the guidance available for each setting in the default settings page. RPCS3 is alpha stage emulator and hence user will have to experiment with the recommendatory settings to optimise their gameplay experience.

An exception to the above rule would be Preferred SPU Threads where a value or range can be provided to identify the optimal option for each user.

Syntax

Below is the syntax of the template. This template must be present for all game pages irrespective of whether any non-default configurations are necessary. Where the game only requires default settings, the template should simply be used without any parameters.

{{config
|parameters =
}}

Parameters

The following are the only valid parameters accepted by this template. Unless mentioned otherwise, choose only one of the options mentioned for each setting. For any setting which deviates from the default configuration, an additional note may be given if required using the notes extension to highlight any necessary information.

CPU configuration

<!-- CPU configuration -->
|ppu decoder                         = Interpreter (precise), Interpreter (fast), LLVM Recompiler
|ppu decoder notes                   =
|spu decoder                         = Interpreter (precise), Interpreter (fast), ASMJIT Recompiler, LLVM Recompiler
|spu decoder notes                   =
|preferred spu threads               = Auto, Single digit between 1 to 6 (e.g. 3), Range between 1 to 6 (e.g. 1 - 3) 
|preferred spu threads notes         =
|firmware settings                   = Automatically load required libraries, Manually load selected libraries, 
                                       Load automatic and manual selection, Load liblv2.sprx only
|firmware settings notes             = Where Manually load selected libraries or Load automatic and manual selection options 
                                       is selected, mention the list of libraries to be selected in this parameter
|enable thread scheduler             = On, Off
|enable thread scheduler notes       =
|lower spu thread priority           = On, Off
|lower spu thread priority notes     =
|enable spu loop detection           = On, Off
|enable spu loop detection notes     =
|spu cache                           = On, Off
|spu cache notes                     =
|accurate xfloat                     = On, Off
|accurate xfloat notes               =
|spu block size                      = Safe, Mega, Giga
|spu block size notes                =

GPU configuration

<!-- GPU configuration -->
|renderer                            = OpenGL, Vulkan
|renderer notes                      =
|graphics device                     = This option is used only with Vulkan renderer to select the graphics card to be used by  
                                       RPCS3 when multiple eligible cards exist. Do not used this parameter on game pages.
|graphics device notes               =
|aspect ratio                        = Auto, 4:3, 16:9
|aspect ratio notes                  = 
|framelimit                          = Off, 59.94, 50, 60, 30, Auto
|framelimit notes                    =
|anisotropic filter                  = Automatic, Disabled, 2x, 4x, 8x, 16x
|anisotropic filter notes            =
|anti-aliasing                       = NA
|anti-aliasing notes                 =
|default resolution                  = 1920x1080, 1280x720, 720x480, 720x576, 1600x1080, 1440x1080, 1280x1080, 960x1080
|default resolution notes            =
|resolution scale                    = Range between 50% to 800%
|resolution scale notes              =
|resolution scale threshold          = Range between 1 to 1024 in the format 16 x 16
|resolution scale threshold notes    =
|write color buffer                  = On, Off
|write color buffer notes            =
|use gpu texture scaling             = On, Off
|use gpu texture scaling notes       =
|strict rendering mode               = On, Off
|strict rendering mode notes         =
|vsync                               = On, Off
|vsync notes                         =
|stretch to display area             = On, Off
|stretch to display area notes       =
|disable vertex cache                = On, Off
|disable vertex cache notes          =
|disable async shader compiler       = On, Off
|disable async shader compiler notes =

Debug configuration

<!-- Debug configuration -->
|force cpu blit emulation            = On, Off
|force cpu blit emulation notes      =
|hook static function                = On, Off
|hook static function notes          =

Examples

Demon's Souls - Standard

{{config
<!-- CPU configuration -->
|preferred spu threads            = 3 - 4
<!-- GPU configuration -->
|write color buffer               = On
}}

Options that deviate from RPCS3's default settings and provide the best experience with this title are listed below.

CPU configuration

Setting Option Notes
Preferred SPU threads 3 - 4


Find a game that does this - When the game only uses default settings

{{config
}}

No options that deviate from RPCS3's default settings are recommended for this title.