Progress Continues
We've already had 21453 updates since Dolphin 5.0. Keep up with Dolphin's continuing progress through the Dolphin Blog: August, September, and October 2023 Progress Report. |
The Dolphin Emulator Wiki needs your help! Dolphin can play thousands of games, and changes are happening all the time. Help us keep up! Join in and help us make this the best resource for Dolphin. |
GameINI
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]
The following entires go under [Core] section of the GameINI.
CPUThread
CPUThread = True
orFalse
to enable and disable "Dual Core" mode respectively.
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 OpenGLGFXBackend = 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 InterpreterCPUCore = 1
to set the CPU engine to JITCPUCore = 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
orFalse
to force enable and disable "DSP HLE" for the game 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. More information at Audio Emulation.
DSPThread
DSPThread = True
orFalse
to enable and disable the "DSP LLE on Dedicated Thread" respectively.
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
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.
VBeam
VBeam = True
orFalse
to enable and disable the "VBeam Speed Hack" respectively.
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
orFalse
to enable and disable the "Synchronize GPU" respectively.
FastDiscSpeed
Accelerates the emulated disc speed, removing any loading emulation.
FastDiscSpeed = True
orFalse
to enable and disable the "Speed up Disc Transfer Rate" respectively.
BlockMerging
BlockMerging = True
orFalse
to enable and disable the "???" respectively.
MMU
MMU = True
False
to enable and disable the "Memory Management Unit" respectively.
TLBHack
Controls the "MMU Speed Hack" setting, a hacked version of the MMU that isn't as demanding.
TLBHack = True
orFalse
to enable or disable the "MMU Speed Hack" respectively.
DCBZ
DCBZ = True
orFalse
to enable or 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 NativeEFBScale = 3
to set the Internal Resolution to 1.5x NativeEFBScale = 4
to set the Internal Resolution to 2x NativeEFBScale = 5
to set the Internal Resolution to 2.5x NativeEFBScale = 6
to set the Internal Resolution to 3x NativeEFBScale = 7
to set the Internal Resolution to 4x NativeEFBScale = -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 sliderSafeTextureCacheColorSamples = 512
-> Texture Cache Accuracy "Middle", the middle option on the sliderSafeTextureCacheColorSamples = 128
-> Texture Cache Accuracy "Fast", the right most option on the slider
Aspect Ratio
Values represent the drop down list in the Dolphin GUI, starting with 0.
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
orFalse
to enable and disable the Widescreen Hack respectively.
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 anti-aliasing option will be used for values higher than zero.
External Frame Buffer
UseXFB = True
orFalse
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
orFalse
to enable "Real XFB" or "Virtual XFB" respectively.
Fast Depth Calculation
FastDepthCalc = True
orFalse
to enable and disable "Fast depth calculation" respectively.
Per-Pixel Lighting
EnablePixelLighting = True
orFalse
to enable and disable "Per-Pixel Lighting" respectively.
OpenMP Texture Decoder
OMPDecoder = True
orFalse
to enable and disable "OpenMP Texture Decoder" respectively.
OpenCL Texture Decoder
EnableOpenCL = True
orFalse
to enable and disable "OpenCL Texture Decoder" respectively.
Disable Fog
DisableFog = True
orFalse
to enable and disable "Disable Fog" respectively.
Disable Destination Alpha
DstAlphaPass = True
orFalse
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 need1
,2
,3
,4
to be used respectively.
Force Texture Filtering
ForceFiltering = True
orFalse
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
orFalse
to enable and disable "Cache Display Lists" respectively.
EFB Copies
EFBToTextureEnable = True
orFalse
to enable "EFB to Texture" and "EFB to Ram" respectively.EFBCopyEnable = True
orFalse
to enable and disable "EFB copies" respectively.EFBCopyCacheEnable = True
orFalse
to enable and disable "EFB to RAM Cache" respectively.
Scaled EFB Copy
EFBScaledCopy = True
orFalse
to enable and disable "Scaled EFB Copy" respectively.
Skip EFB Access From Cpu
EFBAccessEnable = True
orFalse
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
orFalse
to disable and enable "Ignore Format Changes" respectively. Beware that it has the opposite behavior of the gui option!
[Video]
UseBBox = True
orFalse
to enable and disable "Bounding Box Calculation" respectively.ZTPSpeedupHack = True
orFalse
to enable and disable "ZTP Hack" respectively.ProjectionHack = 1
or0
to enable and disable "Custom Projection Hack" respectively.
[Video_Hardware]
VSync
VSync = True
orFalse
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
orTrue
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 recompilerEnableJIT = 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#
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#
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.