GameINI: Difference between revisions

From Dolphin Emulator Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 36: Line 36:


=== Floating-point Result Flag ===
=== Floating-point Result Flag ===
Implemented in {{revision|4.0-2777}} and later.
*<code>FPRF = True</code> or <code>False</code> to enable and disable "Floating-point Result Flag" calculation respectively.
*<code>FPRF = True</code> or <code>False</code> to enable and disable "Floating-point Result Flag" calculation respectively.


Line 71: Line 70:


=== UseFPS ===
=== UseFPS ===
Implemented in {{revision|4.0-265}} and later.
*<code>UseFPS = True</code> to set the FrameLimiter to be based on FPS instead of the VPS.  
*<code>UseFPS = True</code> to set the FrameLimiter to be based on FPS instead of the VPS.  
*<code>UseFPS = False</code> to set the FrameLimiter to be based on VPS instead of the FPS. This is the normal behavior for the emulator.
*<code>UseFPS = False</code> to set the FrameLimiter to be based on VPS instead of the FPS. This is the normal behavior for the emulator.


=== CPU Overclock ===
=== CPU Overclock ===
Implemented in {{revision|5.0-2302}} and later.
*<code>OverclockEnable = True</code> or <code>False</code> to enable and disable "CPU Overclocking" respectively.
*<code>OverclockEnable = True</code> or <code>False</code> to enable and disable "CPU Overclocking" respectively.
*<code>Overclock = 1.0</code> translates to "100%" CPU clock, greater in value is considered overclocking and smaller in value is considered underclocking.
*<code>Overclock = 1.0</code> translates to "100%" CPU clock, greater in value is considered overclocking and smaller in value is considered underclocking.
Line 222: Line 221:


=== Backend ===
=== Backend ===
Implemented in {{revision|4.0-101}} and later.
*<code>Backend = OpenAL</code>
*<code>Backend = OpenAL</code>
*<code>Backend = DSound</code>
*<code>Backend = DSound</code>
Line 231: Line 229:


=== Volume ===
=== Volume ===
Implemented in {{revision|4.0-265}} and later.
*<code>Volume = 100</code>, values starting from 0 up to 100 max are valid.
*<code>Volume = 100</code>, values starting from 0 up to 100 max are valid.



Revision as of 00:46, 10 July 2017

You can configure settings per game through their GameINI. GameINI is a plain text file with game's GameID as its file name and INI as its file extension. It can be retrieved from game's properties, right-click the game from game list then choose Properties from the context menu, then click on the Edit Config button and edit the empty text file that pops up. When editing, carefully arranged line, headings, and capitalization are important.

Properties Window

These are settings you can update GameINI directly from the game properties window.

[Core]

The following entries go under [Core] section of the GameINI.

Dual Core

  • CPUThread = True or False to enable and disable "Dual Core" mode respectively.

Graphics Backend

  • GFXBackend = DX9 to set the video backend to Direct3D 9. Removed (will do nothing) in 4.0-155 and later.
  • GFXBackend = D3D to set the video backend to Direct3D 11. Use DX11 in Dolphin build earlier than 4.0-155.
  • GFXBackend = D3D12 to set the video backend to Direct3D 12. Removed (will do nothing) in 5.0-3774 and later.
  • GFXBackend = OGL to set the video backend to OpenGL.
  • GFXBackend = Vulkan to set the video backend to Vulkan.

CPU Engine

  • CPUCore = 0 to set the CPU engine to "Interpreter".
  • CPUCore = 1 to set the CPU engine to "JIT".
  • CPUCore = 2 to set the CPU engine to "JITIL". Removed (will do nothing) in 5.0-3792 and later.
  • CPUCore = 5 to set the CPU engine to "Cached Interpreter".

Uses numbers starting with 0 to represent the tick-mark order used in the Dolphin GUI for the option.

Floating-point Result Flag

  • FPRF = True or False to enable and disable "Floating-point Result Flag" calculation respectively.

DSP HLE

  • DSPHLE = True or False to enable and disable "DSP HLE" respectively.

If DSP HLE is disabled, DSL LLE will be used, it will use either DSP LLE recompiler or DSP LLE interpreter based on your general Dolphin settings, or see #DSP Emulator Engine. More information at Audio Emulation.

DSP LLE on Dedicated Thread

  • DSPThread = True or False to enable and disable the "DSP LLE on Dedicated Thread" respectively.

Emulation Speed (formerly Framelimit)

  • EmulationSpeed = 0.000000000 will set it to "unlimited".
  • EmulationSpeed = 0.100000001 will set it to "10%".
  • EmulationSpeed = 0.200000003 will set it to "20%".
  • EmulationSpeed = 0.300000012 will set it to "30%".
  • EmulationSpeed = 0.400000006 will set it to "40%".
  • EmulationSpeed = 0.500000000 will set it to "50%".
  • EmulationSpeed = 0.600000024 will set it to "60%".
  • EmulationSpeed = 0.699999988 will set it to "70%".
  • EmulationSpeed = 0.800000012 will set it to "80%".
  • EmulationSpeed = 0.900000036 will set it to "90%".
  • EmulationSpeed = 1.00000000 will set it to "100%", as in normal emulation speed.
  • EmulationSpeed = 1.10000002 will set it to "110%".
  • EmulationSpeed = 1.20000005 will set it to "120%".
  • EmulationSpeed = 1.30000007 will set it to "130%".
  • EmulationSpeed = 1.39999998 will set it to "140%".
  • EmulationSpeed = 1.50000000 will set it to "150%".
  • EmulationSpeed = 1.60000002 will set it to "160%".
  • EmulationSpeed = 1.70000005 will set it to "170%".
  • EmulationSpeed = 1.80000007 will set it to "180%".
  • EmulationSpeed = 1.89999998 will set it to "190%".
  • EmulationSpeed = 2.00000000 will set it to "200%".

UseFPS

  • UseFPS = True to set the FrameLimiter to be based on FPS instead of the VPS.
  • UseFPS = False to set the FrameLimiter to be based on VPS instead of the FPS. This is the normal behavior for the emulator.

CPU Overclock

Implemented in 5.0-2302 and later.

  • OverclockEnable = True or False to enable and disable "CPU Overclocking" respectively.
  • Overclock = 1.0 translates to "100%" CPU clock, greater in value is considered overclocking and smaller in value is considered underclocking.

Synchronize GPU Thread

SyncGPU is a speed hack for dual core mode to allow games to get around dual core glitches without having to use single core. Usually not much faster than single core mode.

  • SyncGPU = True or False to enable and disable the "Synchronize GPU thread" respectively.

Speed Up Disc Transfer Rate

Accelerates the emulated disc speed, removing any loading emulation.

  • FastDiscSpeed = True or False to enable and disable the "Speed up Disc Transfer Rate" respectively.

Memory Management Unit (MMU)

  • MMU = True or False to enable and disable the "Memory Management Unit" respectively.

DCBZ

  • DCBZ = True or False to enable and disable "Skip DCBZ Clearing" respectively.

GameCube Language

Implemented in 5.0-2023 and later.

  • GameCubeLanguage = 0 for English or Japanese, depending on the region of the console/game.

Choose a number for the language you want from the list below:

0 = English/Japanese
1 = German
2 = French
3 = Spanish
4 = Italian
5 = Dutch

[Video_Settings]

The following entries go under [Video_Settings] section of the GameINI.

Internal Resolution

Values starting from 0 represent the drop down order in the list that dolphin uses.

  • EFBScale = 0 to set the Internal Resolution to "Auto (Multiple of 640x528)"
  • EFBScale = 1 to set the Internal Resolution to "Auto (Window Size)"
  • EFBScale = 2 to set the Internal Resolution to 1x Native
  • EFBScale = 3 to set the Internal Resolution to 1.5x Native
  • EFBScale = 4 to set the Internal Resolution to 2x Native
  • EFBScale = 5 to set the Internal Resolution to 2.5x Native
  • EFBScale = 6 to set the Internal Resolution to 3x Native
  • EFBScale = 7 to set the Internal Resolution to 4x Native
  • EFBScale = -1 "-1" is a special case that does not exist in the GUI. It is used to set an Internal Resolution that is the nearest whole number multiplier of the value set in Dolphin's general settings, rounded down. For example, if 2.5x Native is set in the GUI (general settings), than 2x Native will be used.

Texture Cache Accuracy

Controls the "Texture Cache Accuracy" setting, shown as a slider in the GUI.

  • SafeTextureCacheColorSamples = 0 -> Texture Cache Accuracy "Safe", the left most option on the slider.
  • SafeTextureCacheColorSamples = 512 -> Texture Cache Accuracy "Middle", the middle option on the slider.
  • SafeTextureCacheColorSamples = 128 -> Texture Cache Accuracy "Fast", the right most option on the slider.

Aspect Ratio

Values starting from 0 represent the drop down order in the list that dolphin uses.

  • AspectRatio = 0 is auto, assigned based on what the emulated console indicates.
  • AspectRatio = 1 to force the aspect ratio to 16:9.
  • AspectRatio = 2 to force the aspect ratio to 4:3.
  • AspectRatio = 3 to set the aspect ratio to "Stretch to window".

Widescreen Hack

Separates the aspect ratio rendered by the game from the one displayed in the game window. Use #Aspect Ratio options in addition to this setting.

  • wideScreenHack = True or False to enable and disable the "Widescreen Hack" respectively.

Anti-Aliasing

  • MSAA = 0 will set it to the top of the list value which is "None". "2x", "4x", "8x" samples would need 2, 4, 8 to be used respectively. Prior to 4.0-8385, values starting from 0 represent the drop down order in the list that dolphin uses.
  • SSAA = True or False will toggle between "SSAA" and "MSAA" respectively. The amount of samples used for SSAA will depend on the MSAA value above.

External Frame Buffer

  • UseXFB = True or False to enable and disable "External Frame Buffer" respectively. Virtual or Real will be set according to what you have set it last at the general settings. To control it use together the line below:
  • UseRealXFB = True or False to enable "Real XFB" or "Virtual XFB" respectively.

Fast Depth Calculation

  • FastDepthCalc = True or False to enable and disable "Fast depth calculation" respectively.

Per-Pixel Lighting

  • EnablePixelLighting = True or False to enable and disable "Per-Pixel Lighting" respectively.

OpenMP Texture Decoder

  • OMPDecoder = True or False to enable and disable "OpenMP Texture Decoder" respectively.

OpenCL Texture Decoder

  • EnableOpenCL = True or False to enable and disable "OpenCL Texture Decoder" respectively.

Disable Fog

  • DisableFog = True or False to enable and disable "Disable Fog" respectively.

Disable Destination Alpha

  • DstAlphaPass = True or False to enable and disable "Disable Destination Alpha" respectively.

[Video_Enhancements]

The following entries go under [Video_Enhancements] section of the GameINI.

Anisotropic Filtering

Values starting from 0 represent the drop down order in the list that dolphin uses.

  • MaxAnisotropy = 0 will set it to the top of the list value of 1x equivalent of disabling it. 2x, 4x, 8x, 16x would need 1, 2, 3, 4 to be used respectively.

Force Texture Filtering

  • ForceFiltering = True or False to enable and disable "Force Texture Filtering" respectively.

Post-processing Effects

This option will only work with the OpenGL and Vulkan backend. Use the names listed in the drop down menu of the option, below we use sepia as an example.

  • PostProcessingShader = sepia, also you can put the name of your preferred shader here.

[Video_Hacks]

The following entries go under [Video_Hacks] section of the GameINI.

Cache Display Lists

  • DlistCachingEnable = True or False to enable and disable "Cache Display Lists" respectively.

EFB Copies

  • EFBToTextureEnable = True or False to enable "EFB to Texture" and "EFB to Ram" respectively.
  • EFBCopyEnable = True or False to enable and disable "EFB copies" respectively.
  • EFBCopyCacheEnable = True or False to enable and disable "EFB to RAM Cache" respectively.

Scaled EFB Copy

  • EFBScaledCopy = True or False to enable and disable "Scaled EFB Copy" respectively.

Skip EFB Access From CPU

  • EFBAccessEnable = True or False to disable and enable "Skip EFB Access From CPU" respectively. Beware that it has the opposite behavior of the GUI option!

Ignore Format Changes

  • EFBEmulateFormatChanges = True or False to disable and enable "Ignore Format Changes" respectively. Beware that it has the opposite behavior of the GUI option!

[Video]

The following entries go under [Video] section of the GameINI.

  • UseBBox = True or False to enable and disable "Bounding Box Calculation" respectively.
  • ZTPSpeedupHack = True or False to enable and disable "ZTP Hack" respectively.
  • ProjectionHack = 1 or 0 to enable and disable "Custom Projection Hack" respectively.

[Video_Hardware]

The following entries go under [Video_Hardware] section of the GameINI.

VSync

  • VSync = True or False to enable and disable "VSync" respectively.

[Video_Stereoscopy]

The following entries go under [Video_Stereoscopy] section of the GameINI.

Stereoscopic 3D Settings

  • StereoDepthPercentage = 100 Percentage of depth value set in the video configuration applied in-game.
  • StereoConvergenceMinimum = 0 Base convergence value that's added to the value set in the video configuration.
  • StereoEFBMonoDepth = False or True to enable "Monoscopic Shadows" respectively.

[DSP]

The following entries go under [DSP] section of the GameINI.

Backend

  • Backend = OpenAL
  • Backend = DSound
  • Backend = XAudio2

DSP Emulator Engine

  • EnableJIT = True or False for "LLE recompiler" and "LLE interpreter" respectively. This is when #DSP HLE is disabled.

Volume

  • Volume = 100, values starting from 0 up to 100 max are valid.

[Controls]

The following entries go under [Controls] section of the GameINI.

GameCube Controller Port

PadType0 = 0
PadType1 = 0
PadType2 = 0
PadType3 = 0

GameCube Controller Profile

The GameCube controller profile to be used for player 1 to 4.

PadProfile1 = Name of Profile
PadProfile2 = Name of Profile
PadProfile3 = Name of Profile
PadProfile4 = Name of Profile

Change Name of Profile to the name of an existing control profile. It requires that you have created and saved a new control profile beforehand for the emulated GameCube controller.

Wii Remote

Values starting from 0 represent the drop down order in the list that dolphin uses.

WiimoteSource0 = 0
WiimoteSource1 = 0
WiimoteSource2 = 0
WiimoteSource3 = 0

Balance Board

WiimoteSourceBB = 0 or 2 to disable and enable the "Real Balance Board" respectively.

Wii Remote Profile

The Wii Remote profile to be used for player 1 to 4.

WiimoteProfile1 = Name of Profile
WiimoteProfile2 = Name of Profile
WiimoteProfile3 = Name of Profile
WiimoteProfile4 = Name of Profile

Change Name of Profile to the name of an existing control profile. It requires that you have created and saved a new control profile beforehand for the emulated Wii Remote.

[Wii]

Wii System Language

Implemented in 5.0-2023 and later.

  • Language = 1 for English

Choose a number for the language you want from the list below:

0 = Japanese
1 = English
2 = German
3 = French
4 = Spanish
5 = Italian
6 = Dutch
7 = Simplified Chinese
8 = Traditional Chinese
9 = Korean