GameINI: Difference between revisions

From Dolphin Emulator Wiki
Jump to navigation Jump to search
(There is no title on the wiki listed as requiring Skip Idle, so let's just purge it here if it's been removed, especially here since it's still a sandbox.)
No edit summary
Line 1: Line 1:
== ISO Properties Windows ==
These are settings you can also find in the ISO properties.
* Enable Dual Core - controls [[#CPUThread]]
* Enable MMU - controls [[#MMU]]
* Skip DCBZ clearing - controls [[#DCBZ]]
* Enable FPRF - controls [[#]]
* Synchronize GPU thread - controls [[#SyncGPU]]
* Speed up Disc Transfer Rate - controls [[#FastDiscSpeed]]
* DSP HLE emulation (fast) - controls [[#DSPHLE]]
* Stereoscopy Depth Percentage - controls StereoDepthPercentage in [[#Stereoscopic 3D Settings]]
* Convergence - controls StereoConvergence in [[#Stereoscopic 3D Settings]]
* Monoscopic Shadows - controls StereoEFBMonoDepth in [[#Stereoscopic 3D Settings]]
* [[#BlockMerging]]
* [[#TLBHack]]
* [[#VBeam]]
== [Core] ==
== [Core] ==
The following entires go under [Core] section of the GameINI.
The following entires go under [Core] section of the GameINI.


=== CPUThread ===
=== CPUThread ===
Controls Dual Core and Single Core modes. Can be set in the ISO properties window.
*<code>CPUThread = True</code> to enable Dual Core mode
 
*<code>CPUThread = False</code> to disable Dual Core mode.
*'''CPUThread = True''' -> Enables Dual Core mode
*'''CPUThread = False''' -> Disables Dual Core mode.


=== GFXBackend ===
=== GFXBackend ===
Sets the video backend the game will use.
*<code>GFXBackend = D3D</code> to set the video backend to D3D (previously called D3D11 prior to {{revision|4.0-155}})
 
*<code>GFXBackend = OGL</code> to set the video backend to OpenGL
*'''GFXBackend = D3D''' –> Sets the video backend to D3D (previously called D3D11 prior to {{revision|4.0-155}})
*'''GFXBackend = OGL''' –> Sets the video backend to OpenGL


D3D9 was removed in {{revision|4.0-155}}. On builds prior to {{revision|4.0-155}}, the following three options are available.
D3D9 was removed in {{revision|4.0-155}}. On builds prior to {{revision|4.0-155}}, the following three options are available.
 
*<code>GFXBackend = DX11</code> to set the video backend to D3D11 (now called D3D in the emulator as of {{revision|4.0-155}})
*'''GFXBackend = DX11''' -> Sets the video backend to D3D11 (now called D3D in the emulator as of {{revision|4.0-155}})
*<code>GFXBackend = OGL</code> to set the video backend to OpenGL
*'''GFXBackend = OGL''' -> Sets the video backend to OpenGL
*<code>GFXBackend = DX9</code> to set the video backend to D3D9. For {{revision|4.0-155}} and later setting the graphics backend to DX9 will do nothing.
*'''GFXBackend = DX9''' -> Sets the video backend to D3D9. For {{revision|4.0-155}} and later setting the graphics backend to DX9 will do nothing.


=== CPUCore ===
=== CPUCore ===
Sets the CPU Emulator Engine that Dolphin will use to emulate the game. Uses numbers starting with 0 to represent the tick-mark order used in the Dolphin GUI for the option.
*<code>CPUCore = 0</code> to set the CPU engine to Interpreter
*<code>CPUCore = 1</code> to set the CPU engine to JIT
*<code>CPUCore = 2</code> to set the CPU engine to JITIL


*'''CPUCore = 0''' -> Sets the CPU engine to Interpreter
Uses numbers starting with 0 to represent the tick-mark order used in the Dolphin GUI for the option.
*'''CPUCore = 1''' -> Sets the CPU engine to JIT
*'''CPUCore = 2''' -> Sets the CPU engine to JITIL


=== DSPHLE ===
=== DSPHLE ===
Chooses the audio engine. Can also be set in the ISO properties window.
*<code>DSPHLE = True</code> to force DSP HLE for the game.
*<code>DSPHLE = False</code> to force disable DSP HLE, forcing DSP LLE.


*'''DSPHLE = True''' -> Forces DSP HLE for the game.
If DSP LLE is set in the lines above, it will use either DSP LLE recompiler or DSP LLE interpreter based on your general Dolphin settings. More information at [[Audio Emulation]].
*'''DSPHLE = False''' -> Disables DSP HLE, forcing DSP LLE.
 
If DSP LLE is set in the lines above, it will use either DSP LLE recompiler or DSP LLE interpreter based on your general Dolphin settings. To force either DSP LLE recompiler or DSP LLE interpreter, see [[DSP EnableJIT]].


=== DSPThread ===
=== DSPThread ===
Controls "DSP LLE on Dedicated Thread".
*<code>DSPThread = True</code> to enable DSP LLE on Dedicated Thread
 
*<code>DSPThread = False</code> to disable DSP LLE on Dedicated Thread
*'''DSPThread = True''' - Enables DSP LLE on Dedicated Thread
*'''DSPThread = False''' - Disables DSP LLE on Dedicated Thread


=== FrameLimit ===
=== FrameLimit ===
Uses hex values to set the framelimit. Based on VPS unless [[UseFPS]] is set to true. Added in {{revision|4.0-265}}; it will do nothing in revisions prior to that.
Uses hex values to set the framelimit. Based on VPS unless [[#UseFPS]] is set to true. Added in {{revision|4.0-265}}; it will do nothing in revisions prior to that.
 
*<code>FrameLimit = 0x00000000</code> -> "Off"
*'''FrameLimit = 0x00000000''' -> "Off"
*<code>FrameLimit = 0x00000001</code> -> "Auto"
*'''FrameLimit = 0x00000001''' -> "Auto"
*<code>FrameLimit = 0x00000002</code> -> "Audio"
*'''FrameLimit = 0x00000002''' -> "Audio"
*<code>FrameLimit = 0x00000003</code> -> "10"
*'''FrameLimit = 0x00000003''' -> "10"
Continues up to
Continues up to
*'''FrameLimit = 0x00000019''' -> "120"
*<code>FrameLimit = 0x00000019</code> -> "120"


=== UseFPS ===
=== UseFPS ===
Determines whether the framelimiter is based on VPS or FPS. Added in {{revision|4.0-265}}; it will do nothing in revisions prior to that.
Implemented in {{revision|4.0-265}} and later.
 
*<code>UseFPS = True</code> -> Sets the FrameLimiter to be based on FPS instead of the VPS.  
*'''UseFPS = True''' -> Sets the FrameLimiter to be based on FPS instead of the VPS.  
*<code>UseFPS = False</code> -> Sets the FrameLimiter to be based on VPS instead of the FPS. This is the normal behavior for the emulator.
*'''UseFPS = False''' -> Sets the FrameLimiter to be based on VPS instead of the FPS. This is the normal behavior for the emulator.


=== VBeam ===
=== VBeam ===
Controls the "VBeam Speed Hack" setting. Can also be set in the ISO properties window.
*<code>VBeam = True</code> to enable the VBeam Speed Hack
 
*<code>VBeam = False</code> to disable the VBeam Speed Hack
*'''VBeam = True''' -> Enables the VBeam Speed Hack
*'''VBeam = False''' -> Disables the VBeam Speed Hack


=== SyncGPU ===
=== SyncGPU ===
Controls the "SyncGPU setting". 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 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.
 
*<code>SyncGPU = True</code>
*'''SyncGPU = True'''
*<code>SyncGPU = False</code>
*'''SyncGPU = False'''


=== FastDiscSpeed ===
=== FastDiscSpeed ===
Accelerates the emulated disc speed, removing any loading emulation. Can also be set in the ISO properties window.
Accelerates the emulated disc speed, removing any loading emulation.
 
*<code>FastDiscSpeed = True</code>
*'''FastDiscSpeed = True'''
*<code>FastDiscSpeed = False</code>
*'''FastDiscSpeed = False'''


=== BlockMerging ===
=== BlockMerging ===
Can also be set in the ISO properties window.
*<code>BlockMerging = True</code>
 
*<code>BlockMerging = False</code>
*'''BlockMerging = True'''
*'''BlockMerging = False'''


=== MMU ===
=== MMU ===
Controls the MMU setting. Can also be set in the ISO properties window.
*<code>MMU = True</code> -> Enables "MMU"
 
*<code>MMU = False</code> -> Disables "MMU"
*'''MMU = True''' -> Enables "MMU"
*'''MMU = False''' -> Disables "MMU"


=== TLBHack ===
=== TLBHack ===
Controls the "MMU Speed Hack" setting, a hacked version of the MMU that isn't as demanding. Can also be set in the ISO properties window.
Controls the "MMU Speed Hack" setting, a hacked version of the MMU that isn't as demanding.
 
*<code>TLBHack = True</code> -> Enables the MMU Speed Hack
*'''TLBHack = True''' -> Enables the MMU Speed Hack
*<code>TLBHack = False</code> -> Disables the MMU Speed Hack
*'''TLBHack = False''' -> Disables the MMU Speed Hack


=== DCBZ ===
=== DCBZ ===
Controls the "Skip DCBZ Clearing" setting. Can also be set in the ISO properties window.
*<code>DCBZ = True</code> to enable "Skip DCBZ Clearing"
 
*<code>DCBZ = False</code> to disable "Skip DCBZ Clearing"
*'''DCBZ = True''' -> Enables "Skip DCBZ Clearing"
*'''DCBZ = False''' -> Disables "Skip DCBZ Clearing"


== [Video_Settings] ==
== [Video_Settings] ==
=== EFBScale ===
=== EFBScale ===
Sets the internal resolution. Values starting from 0 represent the drop down order in the list that dolphin uses. Currently:
Sets the internal resolution. Values starting from 0 represent the drop down order in the list that dolphin uses.
 
*<code>EFBScale = 0</code> to set the Internal Resolution to "Auto (Multiple of 640x528)"
*'''EFBScale = 0''' -> Sets the Internal Resolution to "Auto (Multiple of 640x528)"
*<code>EFBScale = 1</code> to set the Internal Resolution to "Auto (Window Size)"
*'''EFBScale = 1''' -> Sets the Internal Resolution to "Auto (Window Size)"
*<code>EFBScale = 2</code> to set the Internal Resolution to 1x Native
*'''EFBScale = 2''' -> Sets the Internal Resolution to 1x Native
*<code>EFBScale = 3</code> to set the Internal Resolution to 1.5x Native
*'''EFBScale = 3''' -> Sets the Internal Resolution to 1.5x Native
*<code>EFBScale = 4</code> to set the Internal Resolution to 2x Native
*'''EFBScale = 4''' -> Sets the Internal Resolution to 2x Native
*<code>EFBScale = 5</code> to set the Internal Resolution to 2.5x Native
*'''EFBScale = 5''' -> Sets the Internal Resolution to 2.5x Native
*<code>EFBScale = 6</code> to set the Internal Resolution to 3x Native
*'''EFBScale = 6''' -> Sets the Internal Resolution to 3x Native
*<code>EFBScale = 7</code> to set the Internal Resolution to 4x Native
*'''EFBScale = 7''' -> Sets the Internal Resolution to 4x Native
*<code>EFBScale = -1</code> "-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.
*'''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.


=== SafeTextureCacheColorSamples ===
=== SafeTextureCacheColorSamples ===
Controls the "Texture Cache Accuracy" setting, shown as a slider in the GUI.
Controls the "Texture Cache Accuracy" setting, shown as a slider in the GUI.
*<code>SafeTextureCacheColorSamples = 0</code> -> Texture Cache Accuracy "Safe", the left most option on the slider
*<code>SafeTextureCacheColorSamples = 512</code> -> Texture Cache Accuracy "Middle", the middle option on the slider
*<code>SafeTextureCacheColorSamples = 128</code> -> Texture Cache Accuracy "Fast", the right most option on the slider


*'''SafeTextureCacheColorSamples = 0''' -> Texture Cache Accuracy "Safe", the left most option on the slider
=== AspectRatio ===
*'''SafeTextureCacheColorSamples = 512''' -> Texture Cache Accuracy "Middle", the middle option on the slider
Values represent the drop down list in the Dolphin GUI, starting with 0.
*'''SafeTextureCacheColorSamples = 128''' -> Texture Cache Accuracy "Fast", the right most option on the slider
*<code>AspectRatio = 0</code> -> Auto Aspect Ratio, assigned based on what the emulated console indicates
 
*<code>AspectRatio = 1</code> -> Force 16:9
 
*<code>AspectRatio = 2</code> -> Force 4:3
=== AspectRatio ===
*<code>AspectRatio = 3</code> -> Sets the aspect ratio to "Stretch to window"
Sets the AspectRatio for the title. Values represent the drop down list in the Dolphin GUI, starting with 0.
 
*'''AspectRatio = 0''' -> Auto Aspect Ratio, assigned based on what the emulated console indicates
*'''AspectRatio = 1''' -> Force 16:9
*'''AspectRatio = 2''' -> Force 4:3
*'''AspectRatio = 3''' -> Sets the aspect ratio to "Stretch to window"


=== wideScreenHack ===
=== wideScreenHack ===
Separates the aspect ratio rendered by the game from the one displayed in the game window. Use [[Aspect Ratio]] controls in addition to this setting.
Separates the aspect ratio rendered by the game from the one displayed in the game window. Use [[#AspectRatio|AspectRatio]] options in addition to this setting.
 
*<code>wideScreenHack = True</code>
*'''wideScreenHack = True'''
*<code>wideScreenHack = False</code>
*'''wideScreenHack = False'''


=== MSAA ===
=== MSAA ===
Values starting from 0 represent the drop down order in the list that dolphin uses. Each backend has it's own list of antialiasing options so it is suggested to enforce a certain video backend along with this option.  
Values starting from 0 represent the drop down order in the list that dolphin uses. Each backend has it's own list of antialiasing options so it is suggested to enforce a certain video backend along with this option.
[Video_Settings]
*<code>MSAA = 0</code> will set it to the top of the list value which is 'Off' for all backends, for values starting from 1 the result will vary depending on the backend used, check the drop list in the gui and start counting from 0 to find which antialiasing option will be used for values higher than zero.
MSAA = 0 (Will set it to the top of the list value which is Off for all backends, for values starting from 1 the result will vary depending on the backend used, check the drop list in the gui and start counting from 0 to find which antialiasing option will be used for values higher than zero).


=== External Frame Buffer ===
*<code>UseXFB = True</code> or <code>False</code> 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:
*<code>UseRealXFB = True</code> or <code>False</code> to enable "Real Xfb" or "Virtual Xfb" respectively.


External Frame Buffer:
=== Fast Depth Calculation ===
[Video_Settings]
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:
[Video_Settings]
[Video_Settings]
FastDepthCalc = True (or False to enable and disable "Fast depth calculation" respectively).
*<code>FastDepthCalc = True</code> or <code>False</code> to enable and disable "Fast depth calculation" respectively.


Per-Pixel Lighting:
=== Per-Pixel Lighting ===
[Video_Settings]
*<code>EnablePixelLighting = True</code> or <code>False</code> to enable and disable "Per-Pixel Lighting" respectively.
EnablePixelLighting = True (or False to enable and disable "Per-Pixel Lighting" respectively).


OpenMP Texture Decoder:
=== OpenMP Texture Decoder ===
[Video_Settings]
*<code>OMPDecoder = True</code> or <code>False</code> to enable and disable "OpenMP Texture Decoder" respectively.
OMPDecoder = True (or False to enable and disable "OpenMP Texture Decoder" respectively).


OpenCL Texture Decoder:
=== OpenCL Texture Decoder ===
[Video_Settings]
*<code>EnableOpenCL = True</code> or <code>False</code> to enable and disable "OpenCL Texture Decoder" respectively.
EnableOpenCL = True (or False to enable and disable "OpenCL Texture Decoder" respectively).


Disable Fog:
=== Disable Fog ===
[Video_Settings]
*<code>DisableFog = True</code> or <code>False</code> to enable and disable "Disable Fog" respectively.
DisableFog = True (or False to enable and disable "Disable Fog" respectively).


Disable Destination Alpha:
=== Disable Destination Alpha ===
[Video_Settings]
*<code>DstAlphaPass = True</code> or <code>False</code> to enable and disable "Disable Destination Alpha" respectively.
DstAlphaPass = True (or False to enable and disable "Disable Destination Alpha" respectively).


== [Video_Enhancements] ==
== [Video_Enhancements] ==
Anisotropic Filtering:
=== Anisotropic Filtering ===
Values starting from 0 represent the drop down order in the list that dolphin uses.
Values starting from 0 represent the drop down order in the list that dolphin uses.
[Video_Enhancements]
*<code>MaxAnisotropy = 0</code> 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).
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:
=== Force Texture Filtering ===
[Video_Enhancements]
*<code>ForceFiltering = True</code> or <code>False</code> to enable and disable "Force Texture Filtering" respectively.
ForceFiltering = True (or False to enable and disable "Force Texture Filtering" respectively).


Post - Processing Effects:
=== Post-processing Effects ===
This option will only work with the opengl backend. Use the names listed in the drop down menu of the option, below we use sepia as an example.
This option will only work with the opengl backend. Use the names listed in the drop down menu of the option, below we use sepia as an example.
[Video_Enhancements]
*<code>PostProcessingShader = sepia</code>, also you can put the name of your preferred shader here.
PostProcessingShader = sepia (you can put the name of your preferred shader here).


== [Video_Hacks] ==
== [Video_Hacks] ==
Cache Display Lists:
=== Cache Display Lists ===
[Video_Hacks]
*<code>DlistCachingEnable = True</code> or <code>False</code> to enable and disable "Cache Display Lists" respectively.
DlistCachingEnable = True (or False to enable and disable "Cache Display Lists" respectively).


Efb Copies:
=== EFB Copies ===
[Video_Hacks]
*<code>EFBToTextureEnable = True</code> or <code>False</code> to enable "Efb to Texture" and "Efb to Ram" respectively.
EFBToTextureEnable = True (or False to enable "Efb to Texture" and "Efb to Ram" respectively).
*<code>EFBCopyEnable = True</code> or <code>False</code> to enable and disable "EFB copies" respectively.
EFBCopyEnable = True (or False to enable and disable "EFB copies" respectively).
*<code>EFBCopyCacheEnable = True</code> or <code>False</code> to enable and disable "Efb to RAM Cache" respectively.
EFBCopyCacheEnable = True (or False to enable and disable "Efb to RAM Cache" respectively).


Scaled EFB Copy:
=== Scaled EFB Copy ===
[Video_Hacks]
*<code>EFBScaledCopy = True</code> or <code>False</code> to enable and disable "Scaled EFB Copy" respectively.
EFBScaledCopy = True (or False to enable and disable "Scaled EFB Copy" respectively).


Skip EFB Access From Cpu:
=== Skip EFB Access From Cpu ===
[Video_Hacks]
*<code>EFBAccessEnable = True</code> or <code>False</code> to disable and enable "Skip EFB Access From Cpu" respectively. Beware that it has the opposite behavior of the gui option!
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:
=== Ignore Format Changes ===
[Video_Hacks]
*<code>EFBEmulateFormatChanges = True</code> or <code>False</code> to disable and enable "Ignore Format Changes" respectively. Beware that it has the opposite behavior of the gui option!
EFBEmulateFormatChanges = True (or False to disable and enable "Ignore Format Changes" respectively). Beware that it has the opposite behavior of the gui option!


== [Video] ==
== [Video] ==
UseBBox = True (or False to enable and disable "Bounding Box Calculation" respectively).
*<code>UseBBox = True</code> or <code>False</code> to enable and disable "Bounding Box Calculation" respectively.
ZTPSpeedupHack = True (or False to enable and disable "ZTP Hack" respectively).
*<code>ZTPSpeedupHack = True</code> or <code>False</code> to enable and disable "ZTP Hack" respectively.
ProjectionHack = 1 (or 0 to enable and disable "Custom Projection Hack" respectively).
*<code>ProjectionHack = 1</code> or <code>0</code> to enable and disable "Custom Projection Hack" respectively.


== [Video_Hardware] ==
== [Video_Hardware] ==
VSync:
=== VSync ===
[Video_Hardware]
*<code>VSync = True</code> or <code>False</code> to enable and disable "VSync" respectively.
VSync = True (or False to enable and disable "VSync" respectively).
 
== [Video_Stereoscopy] ==
=== Stereoscopic 3D Settings ===
*<code>StereoDepthPercentage = 100</code> Percentage of depth value set in the video configuration applied in-game.
*<code>StereoConvergenceMinimum = 0</code> Base convergence value that's added to the value set in the video configuration.
*<code>StereoEFBMonoDepth = False</code> or <code>True</code> to enable "Monoscopic Shadows" respectively.


== [DSP] ==
== [DSP] ==
=== Backend ===
=== Backend ===
 
Implemented in {{revision|4.0-101}} and later.
The audio backend that will be used.
*<code>Backend = OpenAL</code>
 
*<code>Backend = DSound</code>
''Note: A dolphin version above 4.0 - 101 is needed to set this, since there was no audio backend choice possible via gameini before that rev.''
*<code>Backend = XAudio2</code>
 
* '''Backend = OpenAL'''
* '''Backend = DSound'''
* '''Backend = XAudio2'''


=== EnableJIT ===
=== EnableJIT ===
 
*<code>EnableJIT = True</code> => for LLE recompiler
* '''EnableJIT = True''' => for LLE recompiler
*<code>EnableJIT = False</code> => for LLE interpreter
* '''EnableJIT = False''' => for LLE interpreter


=== Volume ===
=== Volume ===
 
Implemented in {{revision|4.0-265}} and later.
''Note: A dolphin version above 4.0 - 101 is needed to set this option.''
*<code>Volume = 100</code>, values starting from 0 up to 100 max are valid.
 
* '''Volume = 100''' (values starting from 0 up to 100 max are valid).


== [Controls] ==
== [Controls] ==
=== PadProfile[1-4] ===
The GameCube controller profile to be used for player 1 to 4.
<pre>
PadProfile1 = Name of Profile
PadProfile2 = Name of Profile
PadProfile3 = Name of Profile
PadProfile4 = Name of Profile
</pre>


=== WiimoteProfile''N'' ===
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.


The Wiimote profile that should be used for player ''N''.
=== WiimoteProfile[1-4] ===
 
The Wii Remote profile to be used for player 1 to 4.
* '''WiimoteProfile''N'' = Name Of Profile''' => The Wiimote profile to be used for player ''N''. You should change ''N'' to be the number corresponding to the player, and change ''Name Of Profile'' to the correct profile name.
<pre>
 
WiimoteProfile1 = Name of Profile
=== PadProfile''N'' ===
WiimoteProfile2 = Name of Profile
 
WiimoteProfile3 = Name of Profile
The gamecube controller profile that should be used for player ''N''.
WiimoteProfile4 = Name of Profile
 
</pre>
* '''PadProfile''N'' = Name Of Profile''' => The Gamecube controller profile to be used for player ''N''. You should change ''N'' to be the number corresponding to the player, and change ''Name Of Profile'' to the correct profile name.
 
=== Example: Choosing Control Profiles per game ===


First you should have a control profile saved for the gamecube controller or Wiimote. For example lets say you have created a Wiimote profile named "Sideways" for Wii games that use the sideways wiimote handling(donkey kong, kirby games, etc.). In order to load that profile per game you should put:
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.


<pre>
[Controls]
WiimoteProfile1 = Sideways
WiimoteProfile2 = Sideways
WiimoteProfile3 = Sideways
WiimoteProfile4 = Sideways
</pre>
[[Category:Tutorials]]
[[Category:Tutorials]]

Revision as of 00:44, 9 July 2017

ISO Properties Windows

These are settings you can also find in the ISO properties.

[Core]

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

CPUThread

  • CPUThread = True to enable Dual Core mode
  • CPUThread = False to disable Dual Core mode.

GFXBackend

  • GFXBackend = D3D to set the video backend to D3D (previously called D3D11 prior to 4.0-155)
  • GFXBackend = OGL to set the video backend to OpenGL

D3D9 was removed in 4.0-155. On builds prior to 4.0-155, the following three options are available.

  • GFXBackend = DX11 to set the video backend to D3D11 (now called D3D in the emulator as of 4.0-155)
  • GFXBackend = OGL to set the video backend to OpenGL
  • GFXBackend = DX9 to set the video backend to D3D9. For 4.0-155 and later setting the graphics backend to DX9 will do nothing.

CPUCore

  • 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

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

DSPHLE

  • DSPHLE = True to force DSP HLE for the game.
  • DSPHLE = False to force disable DSP HLE, forcing DSP LLE.

If DSP LLE is set in the lines above, it will use either DSP LLE recompiler or DSP LLE interpreter based on your general Dolphin settings. More information at Audio Emulation.

DSPThread

  • DSPThread = True to enable DSP LLE on Dedicated Thread
  • DSPThread = False to disable DSP LLE on Dedicated Thread

FrameLimit

Uses hex values to set the framelimit. Based on VPS unless #UseFPS is set to true. Added in 4.0-265; it will do nothing in revisions prior to that.

  • FrameLimit = 0x00000000 -> "Off"
  • FrameLimit = 0x00000001 -> "Auto"
  • FrameLimit = 0x00000002 -> "Audio"
  • FrameLimit = 0x00000003 -> "10"

Continues up to

  • FrameLimit = 0x00000019 -> "120"

UseFPS

Implemented in 4.0-265 and later.

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

VBeam

  • VBeam = True to enable the VBeam Speed Hack
  • VBeam = False to disable the VBeam Speed Hack

SyncGPU

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
  • SyncGPU = False

FastDiscSpeed

Accelerates the emulated disc speed, removing any loading emulation.

  • FastDiscSpeed = True
  • FastDiscSpeed = False

BlockMerging

  • BlockMerging = True
  • BlockMerging = False

MMU

  • MMU = True -> Enables "MMU"
  • MMU = False -> Disables "MMU"

TLBHack

Controls the "MMU Speed Hack" setting, a hacked version of the MMU that isn't as demanding.

  • TLBHack = True -> Enables the MMU Speed Hack
  • TLBHack = False -> Disables the MMU Speed Hack

DCBZ

  • DCBZ = True to enable "Skip DCBZ Clearing"
  • DCBZ = False to disable "Skip DCBZ Clearing"

[Video_Settings]

EFBScale

Sets the 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.

SafeTextureCacheColorSamples

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

AspectRatio

Values represent the drop down list in the Dolphin GUI, starting with 0.

  • AspectRatio = 0 -> Auto Aspect Ratio, assigned based on what the emulated console indicates
  • AspectRatio = 1 -> Force 16:9
  • AspectRatio = 2 -> Force 4:3
  • AspectRatio = 3 -> Sets the aspect ratio to "Stretch to window"

wideScreenHack

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

  • wideScreenHack = True
  • wideScreenHack = False

MSAA

Values starting from 0 represent the drop down order in the list that dolphin uses. Each backend has it's own list of antialiasing options so it is suggested to enforce a certain video backend along with this option.

  • MSAA = 0 will set it to the top of the list value which is 'Off' for all backends, for values starting from 1 the result will vary depending on the backend used, check the drop list in the gui and start counting from 0 to find which antialiasing option will be used for values higher than zero.

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

[Video_Settings]

  • 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]

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 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]

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]

  • 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]

VSync

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

[Video_Stereoscopy]

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]

Backend

Implemented in 4.0-101 and later.

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

EnableJIT

  • EnableJIT = True => for LLE recompiler
  • EnableJIT = False => for LLE interpreter

Volume

Implemented in 4.0-265 and later.

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

[Controls]

PadProfile[1-4]

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.

WiimoteProfile[1-4]

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.

Retrieved from "https://wiki.dolphin-emu.org/index.php?title=GameINI&oldid=146137"