Progress Continues
We've already had 21536 updates since Dolphin 5.0. Keep up with Dolphin's continuing progress through the Dolphin Blog: February, March, and April 2024 Dolphin 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. |
Template:Config/sandbox: Difference between revisions
Jump to navigation
Jump to search
mNo edit summary |
mNo edit summary |
||
(18 intermediate revisions by the same user not shown) | |||
Line 3: | Line 3: | ||
{{{dualcore|}}} | {{{dualcore|}}} | ||
{{{speedlimit|}}} | {{{speedlimit|}}} | ||
{{{panichandlers|}}} | {{{panichandlers|}}} | ||
{{{skipbios|}}} | {{{skipbios|}}} | ||
{{{cpuengine|}}} | {{{cpuengine|}}} | ||
{{{cpuclock|}}} | {{{cpuclock|}}} | ||
<!-- GRAPHICS --> | <!-- GRAPHICS > GENERAL --> | ||
{{{gfxbackend|}}} | {{{gfxbackend|}}} | ||
{{{aspectratio|}}} | {{{aspectratio|}}} | ||
{{{vsync|}}} | {{{vsync|}}} | ||
Line 17: | Line 15: | ||
{{{shadercomp|}}} | {{{shadercomp|}}} | ||
{{{compilefirst|}}} | {{{compilefirst|}}} | ||
<!-- GRAPHICS > ENHANCEMENTS --> | |||
{{{internalres|}}} | {{{internalres|}}} | ||
{{{antialiasing|}}} | {{{antialiasing|}}} | ||
Line 25: | Line 24: | ||
{{{widescreenhack|}}} | {{{widescreenhack|}}} | ||
{{{disablefog|}}} | {{{disablefog|}}} | ||
{{{force24bit|}}} | |||
{{{arbmipmap|}}} | {{{arbmipmap|}}} | ||
<!-- GRAPHICS > HACKS --> | |||
{{{skipcpuefbaccess|}}} | {{{skipcpuefbaccess|}}} | ||
{{{formatchanges|}}} | {{{formatchanges|}}} | ||
Line 37: | Line 38: | ||
{{{boundingbox|}}} | {{{boundingbox|}}} | ||
{{{vertexrounding|}}} | {{{vertexrounding|}}} | ||
<!-- GRAPHICS > ADVANCED --> | |||
{{{crop|}}} | {{{crop|}}} | ||
{{{progressivescan|}}} | {{{progressivescan|}}} | ||
{{{manualtexturesampling|}}} | {{{manualtexturesampling|}}} | ||
<!-- AUDIO --> | <!-- AUDIO --> | ||
{{{dspengine|}}} | {{{dspengine|}}} | ||
Line 57: | Line 58: | ||
{{{fprf|}}} | {{{fprf|}}} | ||
{{{syncgputhread|}}} | {{{syncgputhread|}}} | ||
{{{fastdisc | {{{fastdisc|}}}| | ||
Only configuration options for the best compatibility where they deviate from defaults are listed. | Only configuration options for the best compatibility where they deviate from defaults are listed. | ||
<!-- GENERAL -->{{#if: | <!-- GENERAL -->{{#vardefine:iniheader|}}{{#if: | ||
<!-- ini n/a --> | |||
{{{panichandlers|}}} | |||
{{{skipbios|}}}{{#if: | |||
<!-- Core --> | |||
{{{dualcore|}}} | {{{dualcore|}}} | ||
{{{speedlimit|}}} | {{{speedlimit|}}} | ||
{{{cpuengine|}}} | {{{cpuengine|}}} | ||
{{{cpuclock|}}} | {{{cpuclock|}}}|{{#vardefineecho:iniheader|[Core]}}}}| | ||
<h3> General </h3> | <h3> General </h3> | ||
{{{!}}class="wikitable" style="font-size:90%; text-align:left;" cellspacing="0" cellpadding="3" | {{{!}}class="wikitable" style="font-size:90%; text-align:left;" cellspacing="0" cellpadding="3" | ||
!Configuration!!Setting!![[GameINI]]!!Notes | !Configuration!!Setting!![[GameINI]] <span style="font-weight:normal;">{{#var:iniheader}}</span>!!Notes | ||
{{!}}- | {{!}}- | ||
{{#if:{{{dualcore|}}}|{{Config required|Enable Dual Core|CPUThread|boolean|Creates two threads, one for graphics and one for CPU, allowing better use of more than one processor core|{{{dualcore|}}}}}{{{dualcorenotes|}}}}} | {{#if:{{{dualcore|}}}|{{!}}Settings > General > {{Config required|Enable Dual Core|CPUThread|boolean|Creates two threads, one for graphics and one for CPU, allowing better use of more than one processor core|{{{dualcore|}}}}}{{{dualcorenotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{speedlimit|}}}|{{Config required|Speed Limit|EmulationSpeed|decimal|Limits the speed of emulation|{{{speedlimit|}}}|10-200% or Unlimited}}{{{speedlimitnotes|}}}}} | {{#if:{{{speedlimit|}}}|{{!}}Settings > General > {{Config required|Speed Limit|EmulationSpeed|decimal|Limits the speed of emulation|{{{speedlimit|}}}|10-200% or Unlimited}}{{{speedlimitnotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{ | {{#if:{{{panichandlers|}}}|{{!}}Settings > Interface > {{Config required|Use Panic Handlers||boolean|Shows a pop-up when an error or a panic condition is encountered|{{{panichandlers|}}}}}{{{panichandlersnotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{ | {{#if:{{{skipbios|}}}|{{!}}Settings > GameCube > {{Config required|Skip GC BIOS||boolean|Skip loading of GameCube BIOS before booting the game when the IPL dumps are present on User\GC\|{{{skipbios|}}}}}{{{skipbiosnotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{ | {{#if:{{{cpuengine|}}}|{{!}}Settings > Advanced > {{Config required|CPU Emulator Engine|CPUCore|string|Sets which CPU Emulator Engine should be used|{{{cpuengine|}}}|{{#vardefineecho:=|Interpreter=0, JIT x64=1, JIT ARM64=4, Cached Interpreter=5}}}}{{{cpuenginenotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{ | {{#if:{{{cpuclock|}}}|{{!}}Settings > Advanced > {{Config required|CPU Clock Override|Overclock|decimal|Sets the CPU clock speed|{{{cpuclock|}}}|6-400%}}{{{cpuclocknotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{!}}} | {{!}}} | ||
}}<!-- GRAPHICS -->{{#if: | }}<!-- GRAPHICS -->{{#vardefine:iniheader|}}{{#if: | ||
<!-- ini n/a --> | |||
{{{startfull|}}} | |||
{{{rendertomain|}}} | |||
{{{crop|}}}{{#if: | |||
<!-- Core --> | |||
{{{progressivescan|}}}|{{#vardefineecho:iniheader|[Core]}}}}{{#if: | |||
<!-- Video_Settings --> | |||
{{{gfxbackend|}}} | {{{gfxbackend|}}} | ||
{{{aspectratio|}}} | {{{aspectratio|}}} | ||
{{{shadercomp|}}} | {{{shadercomp|}}} | ||
{{{compilefirst|}}} | {{{compilefirst|}}}|{{#vardefineecho:iniheader|{{#if:{{#var:iniheader}}|headings|[Video_Settings]}}}}}}{{#if: | ||
<!-- Video_Enhancements --> | |||
{{{internalres|}}} | {{{internalres|}}} | ||
{{{antialiasing|}}} | {{{antialiasing|}}} | ||
Line 105: | Line 107: | ||
{{{widescreenhack|}}} | {{{widescreenhack|}}} | ||
{{{disablefog|}}} | {{{disablefog|}}} | ||
{{{arbmipmap|}}} | {{{force24bit|}}} | ||
{{{arbmipmap|}}}|{{#vardefineecho:iniheader|{{#if:{{#var:iniheader}}|headings|[Video_Enhancements]}}}}}}{{#if: | |||
<!-- Video_Hacks --> | |||
{{{skipcpuefbaccess|}}} | {{{skipcpuefbaccess|}}} | ||
{{{formatchanges|}}} | {{{formatchanges|}}} | ||
Line 117: | Line 121: | ||
{{{boundingbox|}}} | {{{boundingbox|}}} | ||
{{{vertexrounding|}}} | {{{vertexrounding|}}} | ||
{{{ | {{{manualtexturesampling|}}}|{{#vardefineecho:iniheader|{{#if:{{#var:iniheader}}|headings|[Video_Hacks]}}}}}}{{#if: | ||
{{{ | <!-- Video_Hardware --> | ||
{{{vsync|}}}|{{#vardefineecho:iniheader|{{#if:{{#var:iniheader}}|headings|[Video_Hardware]}}}}}}| | |||
<h3> Graphics </h3> | <h3> Graphics </h3> | ||
{{{!}}class="wikitable" style="font-size:90%; text-align:left;" cellspacing="0" cellpadding="3" | {{{!}}class="wikitable" style="font-size:90%; text-align:left;" cellspacing="0" cellpadding="3" | ||
!Configuration!!Setting!![[GameINI]]!!Notes | !Configuration!!Setting!!{{#ifeq:{{#var:iniheader}}|headings|<span style="font-weight:normal;">See '''[[GameINI]]''' for headings</span>|[[GameINI]] <span style="font-weight:normal;">{{#var:iniheader}}</span>}}!!Notes | ||
{{!}}- | {{!}}- | ||
{{#if:{{{gfxbackend|}}}|{{Config required|Video Back End|GFXBackend|string|Selects which graphical API interface should be used for display rendering|{{{gfxbackend|}}}|{{#vardefineecho:=|OpenGL=OGL, Direct3D11=D3D, Direct3D12=D3D12, Vulkan=Vulkan, Software=Software Renderer}}}}{{{gfxbackendnotes|}}}}} | {{#if:{{{gfxbackend|}}}|{{!}}Graphics > General > {{Config required|Video Back End|GFXBackend|string|Selects which graphical API interface should be used for display rendering|{{{gfxbackend|}}}|{{#vardefineecho:=|OpenGL=OGL, Direct3D11=D3D, Direct3D12=D3D12, Vulkan=Vulkan, Software=Software Renderer}}}}{{{gfxbackendnotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{ | {{#if:{{{aspectratio|}}}|{{!}}Graphics > General > {{Config required|Aspect Ratio|AspectRatio|string|Selects what aspect ratio the monitor should display the game in|{{{aspectratio|}}}|{{#vardefineecho:=|Auto=0, Force 16:9=1, Force 4:3=2, Stretch to Window=3}}}}{{{aspectrationotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{ | {{#if:{{{vsync|}}}|{{!}}Graphics > General > {{Config required|V-Sync|VSync|boolean|Synchronizes Dolphin's framerate with your monitor's refresh rate|{{{vsync|}}}}}{{{vsyncnotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{ | {{#if:{{{startfull|}}}|{{!}}Graphics > General > {{Config required|Use Fullscreen||boolean|Goes to fullscreen by default when a game is started|{{{startfull|}}}}}{{{startfullnotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{ | {{#if:{{{rendertomain|}}}|{{!}}Graphics > General > {{Config required|Render to Main Window||boolean|Displays games in the main window instead of a separate one|{{{rendertomain|}}}}}{{{rendertomainnotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{ | {{#if:{{{shadercomp|}}}|{{!}}Graphics > General > {{Config required|Shader Compilation|ShaderCompilationMode|string|Sets whether specialized shaders or ubershaders are used|{{{shadercomp|}}}|{{#vardefineecho:=|Synchronous=0, Synchronous (Ubershaders)=1, Asynchronous (Ubershaders)=2, Asynchronous (Skip Drawing)=3}}}}{{{shadercompnotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{ | {{#if:{{{compilefirst|}}}|{{!}}Graphics > General > {{Config required|Compile Shaders Before Starting|WaitForShadersBeforeStarting|boolean|Waits for all shaders to finish compiling before starting a game|{{{compilefirst|}}}}}{{{compilefirstnotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{ | {{#if:{{{internalres|}}}|{{!}}Graphics > Enhancements > {{Config required|Internal Resolution|InternalResolution|string|Sets the resolution the game will be rendered at behind-the-scenes (Multiple of 640x528)|{{{internalres|}}}|{{#vardefineecho:=|1x=0, 1.5x=0, 2x=1, 2.5x=1, 3x=2, 4x=3}}}}{{{internalresnotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{ | {{#if:{{{antialiasing|}}}|{{!}}Graphics > Enhancements > {{Config required|Anti-Aliasing|MSAA|string|Corrects aliasing along lines and edges (Many choices depending on Video Back End)|{{{antialiasing|}}}|{{#vardefineecho:=|None=0, Non-SSAA=0</code> or <code>SSAA = False, 2x MSAA=2</code><br><code>SSAA = False, 4x MSAA=4</code><br><code>SSAA = False, 8x MSAA=8</code><br><code>SSAA = False, 2x SSAA=2</code><br><code>SSAA = True, 4x SSAA=4</code><br><code>SSAA = True, 8x SSAA=8</code><br><code>SSAA = True}}}}{{{antialiasingnotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{ | {{#if:{{{anisotropic|}}}|{{!}}Graphics > Enhancements > {{Config required|Anisotropic Filtering|MaxAnisotropy|string|Reduces distortion when viewing textures at an angle|{{{anisotropic|}}}|{{#vardefineecho:=|1x=0, 2x=1, 4x=2, 8x=3, 16x=4}}}}{{{anisotropicnotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{ | {{#if:{{{efbscaledcopy|}}}|{{!}}Graphics > Enhancements > {{Config required|Scaled EFB Copy|EFBScaledCopy|boolean|Greatly increase the quality of textures generated using render-to-texture effects|{{{efbscaledcopy|}}}}}{{{efbscaledcopynotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{ | {{#if:{{{pixellighting|}}}|{{!}}Graphics > Enhancements > {{Config required|Per-Pixel Lighting|EnablePixelLighting|boolean|Calculate lighting of 3D graphics per-pixel rather than per-vertex|{{{pixellighting|}}}}}{{{pixellightingnotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{ | {{#if:{{{forcefilter|}}}|{{!}}Graphics > Enhancements > {{Config required|Force Texture Filtering|ForceFiltering|boolean|Forces texture filtering even if the game specifically disables it|{{{forcefilter|}}}}}{{{forcefilternotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{ | {{#if:{{{widescreenhack|}}}|{{!}}Graphics > Enhancements > {{Config required|Widescreen Hack|wideScreenHack|boolean|Force GameCube games to output graphics for widescreen resolutions|{{{widescreenhack|}}}}}{{{widescreenhacknotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{ | {{#if:{{{disablefog|}}}|{{!}}Graphics > Enhancements > {{Config required|Disable Fog|DisableFog|boolean|Disables the fog used in some games to hide far-away objects|{{{disablefog|}}}}}{{{disablefognotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{ | {{#if:{{{force24bit|}}}|{{!}}Graphics > Enhancements > {{Config required|Force 24-Bit Color|ForceTrueColor|boolean|Force the game to render the RGB color channels in 24-bit, thereby increasing quality by reducing color banding.|{{{force24bit|}}}}}{{{force24bitnotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{arbmipmap|}}}|{{Config required|Arbitrary Mipmap Detection|ArbitraryMipmapDetection|boolean|Enables detection of arbitrary mipmaps, which some games use for special distance-based effects|{{{arbmipmap|}}}}}{{{arbmipmapnotes|}}}}} | {{#if:{{{arbmipmap|}}}|{{!}}Graphics > Enhancements > {{Config required|Arbitrary Mipmap Detection|ArbitraryMipmapDetection|boolean|Enables detection of arbitrary mipmaps, which some games use for special distance-based effects|{{{arbmipmap|}}}}}{{{arbmipmapnotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{skipcpuefbaccess|}}}|{{Config required|Skip EFB Access from CPU|EFBAccessEnable|string|Prevents the CPU from accessing the External Frame Buffer|{{{skipcpuefbaccess|}}}|{{#vardefineecho:=|On=False, Off=True}}}}{{{skipcpuefbaccessnotes|}}}}} | {{#if:{{{skipcpuefbaccess|}}}|{{!}}Graphics > Hacks > {{Config required|Skip EFB Access from CPU|EFBAccessEnable|string|Prevents the CPU from accessing the External Frame Buffer|{{{skipcpuefbaccess|}}}|{{#vardefineecho:=|On=False, Off=True}}}}{{{skipcpuefbaccessnotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{formatchanges|}}}|{{Config required|Ignore Format Changes|EFBEmulateFormatChanges|string|Ignore any changes to the External Frame Buffer format|{{{formatchanges|}}}|{{#vardefineecho:=|On=False, Off=True}}}}{{{formatchangesnotes|}}}}} | {{#if:{{{formatchanges|}}}|{{!}}Graphics > Hacks > {{Config required|Ignore Format Changes|EFBEmulateFormatChanges|string|Ignore any changes to the External Frame Buffer format|{{{formatchanges|}}}|{{#vardefineecho:=|On=False, Off=True}}}}{{{formatchangesnotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{efb2texonly|}}}|{{Config required|Store EFB Copies to Texture Only||boolean|Stores EFB Copies exclusively on the GPU, bypassing system memory|{{{efb2texonly|}}}}}{{{efb2texonlynotes|}}}}} | {{#if:{{{efb2texonly|}}}|{{!}}Graphics > Hacks > {{Config required|Store EFB Copies to Texture Only|EFBToTextureEnable|boolean|Stores EFB Copies exclusively on the GPU, bypassing system memory|{{{efb2texonly|}}}}}{{{efb2texonlynotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{deferefb|}}}|{{Config required|Defer EFB Copies to RAM||boolean|Wait to store EFB Copies providing performance improvements|{{{deferefb|}}}}}{{{deferefbnotes|}}}}} | {{#if:{{{deferefb|}}}|{{!}}Graphics > Hacks > {{Config required|Defer EFB Copies to RAM|DeferEFBCopies|boolean|Wait to store EFB Copies providing performance improvements|{{{deferefb|}}}}}{{{deferefbnotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{accuratetexturecache|}}}|{{Config required|Texture Cache Accuracy|SafeTextureCacheColorSamples|string||{{{accuratetexturecache|}}}|{{#vardefineecho:=|Position 1 (Safe)=0, Position 2 (Medium)=512, Position 3 (Fast)=128}}}}{{{accuratetexturecachenotes|}}}}} | {{#if:{{{accuratetexturecache|}}}|{{!}}Graphics > Hacks > {{Config required|Texture Cache Accuracy|SafeTextureCacheColorSamples|string||{{{accuratetexturecache|}}}|{{#vardefineecho:=|Position 1 (Safe)=0, Position 2 (Medium)=512, Position 3 (Fast)=128}}}}{{{accuratetexturecachenotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{gputexdecode|}}}|{{Config required|GPU Texture Decoding|EnableGPUTextureDecoding|boolean|Enables texture decoding using the GPU instead of the CPU|{{{gputexdecode|}}}}}{{{gputexdecodenotes|}}}}} | {{#if:{{{gputexdecode|}}}|{{!}}Graphics > Hacks > {{Config required|GPU Texture Decoding|EnableGPUTextureDecoding|boolean|Enables texture decoding using the GPU instead of the CPU|{{{gputexdecode|}}}}}{{{gputexdecodenotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{xfb2texonly|}}}|{{Config required|Store XFB Copies to Texture Only||boolean|Stores XFB Copies exclusively on the GPU, bypassing system memory|{{{xfb2texonly|}}}}}{{{xfb2texonlynotes|}}}}} | {{#if:{{{xfb2texonly|}}}|{{!}}Graphics > Hacks > {{Config required|Store XFB Copies to Texture Only|XFBToTextureEnable|boolean|Stores XFB Copies exclusively on the GPU, bypassing system memory|{{{xfb2texonly|}}}}}{{{xfb2texonlynotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{xfbimmediate|}}}|{{Config required|Immediately Present XFB||boolean|Displays the XFB Copies as soon as they are created, without waiting for scanout|{{{xfbimmediate|}}}}}{{{xfbimmediatenotes|}}}}} | {{#if:{{{xfbimmediate|}}}|{{!}}Graphics > Hacks > {{Config required|Immediately Present XFB|ImmediateXFBenable|boolean|Displays the XFB Copies as soon as they are created, without waiting for scanout|{{{xfbimmediate|}}}}}{{{xfbimmediatenotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{fastdepth|}}}|{{Config required|Fast Depth Calculation|FastDepthCalc|boolean|Uses a less accurate method of depth calculation for a speedup|{{{fastdepth|}}}}}{{{fastdepthnotes|}}}}} | {{#if:{{{fastdepth|}}}|{{!}}Graphics > Hacks > {{Config required|Fast Depth Calculation|FastDepthCalc|boolean|Uses a less accurate method of depth calculation for a speedup|{{{fastdepth|}}}}}{{{fastdepthnotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{boundingbox|}}}|{{Config required|Disable Bounding Box|BBoxEnable|boolean|Disables a niche GC/Wii GPU feature for a speedup. A very small number of games will break with this.|{{{boundingbox|}}}}}{{{boundingboxnotes|}}}}} | {{#if:{{{boundingbox|}}}|{{!}}Graphics > Hacks > {{Config required|Disable Bounding Box|BBoxEnable|boolean|Disables a niche GC/Wii GPU feature for a speedup. A very small number of games will break with this.|{{{boundingbox|}}}}}{{{boundingboxnotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{vertexrounding|}}}|{{Config required|Vertex Rounding Hack|VertexRounding|boolean|Round 2D vertices to whole pixels|{{{vertexrounding|}}}}}{{{vertexroundingnotes|}}}}} | {{#if:{{{vertexrounding|}}}|{{!}}Graphics > Hacks > {{Config required|Vertex Rounding Hack|VertexRounding|boolean|Round 2D vertices to whole pixels|{{{vertexrounding|}}}}}{{{vertexroundingnotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{crop|}}}|{{Config required|Crop||boolean|Crop the picture from it's native aspect ratio to 4:3 or 16:9.|{{{crop|}}}}}{{{cropnotes|}}}}} | {{#if:{{{crop|}}}|{{!}}Graphics > Advanced > {{Config required|Crop||boolean|Crop the picture from it's native aspect ratio to 4:3 or 16:9.|{{{crop|}}}}}{{{cropnotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{progressivescan|}}}|{{Config required|Enable Progressive Scan|ProgressiveScan|boolean|Enables progressive scan if your game supports it|{{{progressivescan|}}}}}{{{progressivescannotes|}}}}} | {{#if:{{{progressivescan|}}}|{{!}}Graphics > Advanced > {{Config required|Enable Progressive Scan|ProgressiveScan|boolean|Enables progressive scan if your game supports it|{{{progressivescan|}}}}}{{{progressivescannotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{manualtexturesampling|}}}|{{Config required|Manual Texture Sampling|FastTextureSampling|string|Use a manual implementation of texture sampling instead of the graphics backend's built-in functionality|{{{manualtexturesampling|}}}|{{#vardefineecho:=|On=False, Off=True}}}}{{{manualtexturesamplingnotes | {{#if:{{{manualtexturesampling|}}}|{{!}}Graphics > Advanced > {{Config required|Manual Texture Sampling|FastTextureSampling|string|Use a manual implementation of texture sampling instead of the graphics backend's built-in functionality|{{{manualtexturesampling|}}}|{{#vardefineecho:=|On=False, Off=True}}}}{{{manualtexturesamplingnotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{!}}} | {{!}}} | ||
}}<!-- AUDIO -->{{#if: | }}<!-- AUDIO -->{{#vardefine:iniheader|}}{{#if: | ||
{{{dspengine|}}} | {{{dspengine|}}} | ||
{{{audiobackend|}}}| | {{{audiobackend|}}}| | ||
<h3> Audio </h3> | <h3> Audio </h3> | ||
{{{!}}class="wikitable" style="font-size:90%; text-align:left;" cellspacing="0" cellpadding="3" | {{{!}}class="wikitable" style="font-size:90%; text-align:left;" cellspacing="0" cellpadding="3" | ||
!Configuration!!Setting!![[GameINI]]!!Notes | !Configuration!!Setting!![[GameINI]] <span style="font-weight:normal;">[DSP]</span>!!Notes | ||
{{!}}- | {{!}}- | ||
{{#if:{{{dspengine|}}}|{{Config required|DSP Emulator Engine|EnableJIT|string|Use High-Level audio Emulation or Low-Level audio Emulation; LLE audio emulation is more accurate, but uses more CPU power|{{{dspengine|}}}|{{#vardefineecho:=|HLE=True, LLE=False}}}}{{{dspenginenotes|}}}}} | {{#if:{{{dspengine|}}}|{{!}}Settings > Audio > {{Config required|DSP Emulator Engine|EnableJIT|string|Use High-Level audio Emulation or Low-Level audio Emulation; LLE audio emulation is more accurate, but uses more CPU power|{{{dspengine|}}}|{{#vardefineecho:=|HLE=True, LLE=False}}}}{{{dspenginenotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{audiobackend|}}}|{{Config required|Audio Back End|Backend|string|Select the audio back-end API library|{{{audiobackend|}}}|{{#vardefineecho:=|No Audio Output=No audio output, Cubeb=Cubeb, OpenAL=OpenAL}}}}{{{audiobackendnotes|}}}}} | {{#if:{{{audiobackend|}}}|{{!}}Settings > Audio > {{Config required|Audio Back End|Backend|string|Select the audio back-end API library|{{{audiobackend|}}}|{{#vardefineecho:=|No Audio Output=No audio output, Cubeb=Cubeb, OpenAL=OpenAL}}}}{{{audiobackendnotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{!}}} | {{!}}} | ||
}}<!-- WII -->{{#if: | }}<!-- WII -->{{#vardefine:iniheader|}}{{#if: | ||
<!-- ini n/a --> | |||
{{{screensaver|}}} | |||
{{{usbkeyboard|}}}{{#if: | |||
<!-- Core --> | |||
{{{pal60|}}} | {{{pal60|}}} | ||
{{{ | {{{sdcard|}}}|{{#vardefineecho:iniheader|[Core]}}}}{{#if: | ||
<!-- Wii --> | |||
{{{ | {{{systemlang|}}}|{{#vardefineecho:iniheader|{{#if:{{#var:iniheader}}|headings|[Wii]}}}}}}| | ||
<h3> Wii </h3> | <h3> Wii </h3> | ||
{{{!}}class="wikitable" style="font-size:90%; text-align:left;" cellspacing="0" cellpadding="3" | {{{!}}class="wikitable" style="font-size:90%; text-align:left;" cellspacing="0" cellpadding="3" | ||
!Configuration!!Setting!![[GameINI]]!!Notes | !Configuration!!Setting!!{{#ifeq:{{#var:iniheader}}|headings|<span style="font-weight:normal;">See '''[[GameINI]]''' for headings</span>|[[GameINI]] <span style="font-weight:normal;">{{#var:iniheader}}</span>}}!!Notes | ||
{{!}}- | {{!}}- | ||
{{#if:{{{pal60|}}}|{{Config required|Use PAL60 Mode (EuRGB60)||boolean||{{{pal60|}}}}}{{{pal60notes|}}}}} | {{#if:{{{pal60|}}}|{{!}}Settings > Wii > {{Config required|Use PAL60 Mode (EuRGB60)|PAL60|boolean||{{{pal60|}}}}}{{{pal60notes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{screensaver|}}}|{{Config required|Enable Screen Saver||boolean||{{{screensaver|}}}}}{{{screensavernotes|}}}}} | {{#if:{{{screensaver|}}}|{{!}}Settings > Wii > {{Config required|Enable Screen Saver||boolean||{{{screensaver|}}}}}{{{screensavernotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{sdcard|}}}|{{Config required|Insert SD Card||boolean||{{{sdcard|}}}}}{{{sdcardnotes|}}}}} | {{#if:{{{sdcard|}}}|{{!}}Settings > Wii > {{Config required|Insert SD Card|WiiSDCard|boolean||{{{sdcard|}}}}}{{{sdcardnotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{usbkeyboard|}}}|{{Config required|Connect USB Keyboard||boolean||{{{usbkeyboard|}}}}}{{{usbkeyboardnotes|}}}}} | {{#if:{{{usbkeyboard|}}}|{{!}}Settings > Wii > {{Config required|Connect USB Keyboard||boolean||{{{usbkeyboard|}}}}}{{{usbkeyboardnotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{systemlang|}}}|{{Config required|System Language|Language|string||{{{systemlang|}}}|{{#vardefineecho:=|Japanese=0, English=1, German=2, French=3, Spanish=4, Italian=5, Dutch=6, Simplified Chinese=7, Traditional Chinese=8, Korean=9}}}}{{{systemlangnotes|}}}}} | {{#if:{{{systemlang|}}}|{{!}}Settings > Wii > {{Config required|System Language|Language|string||{{{systemlang|}}}|{{#vardefineecho:=|Japanese=0, English=1, German=2, French=3, Spanish=4, Italian=5, Dutch=6, Simplified Chinese=7, Traditional Chinese=8, Korean=9}}}}{{{systemlangnotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{!}}} | {{!}}} | ||
}}<!-- WII REMOTE -->{{#if: | }}<!-- WII REMOTE -->{{#vardefine:iniheader|}}{{#if: | ||
<!-- ini n/a --> | |||
{{{enablespeakerdata|}}} | {{{enablespeakerdata|}}} | ||
{{{wiimotemotor|}}}| | {{{wiimotemotor|}}}| | ||
<h3> Wii Remote </h3> | <h3> Wii Remote </h3> | ||
{{{!}}class="wikitable" style="font-size:90%; text-align:left;" cellspacing="0" cellpadding="3" | {{{!}}class="wikitable" style="font-size:90%; text-align:left;" cellspacing="0" cellpadding="3" | ||
!Configuration!!Setting!![[GameINI]]!!Notes | !Configuration!!Setting!![[GameINI]] <span style="font-weight:normal;">{{#var:iniheader}}</span>!!Notes | ||
{{!}}- | {{!}}- | ||
{{#if:{{{enablespeakerdata|}}}|{{Config required|Enable Speaker Data||boolean|Controls if sounds come from the Wii Remote speaker of Real Wii Remotes|{{{enablespeakerdata|}}}}}{{{enablespeakerdatanotes|}}}}} | {{#if:{{{enablespeakerdata|}}}|{{!}}Controllers > {{Config required|Enable Speaker Data||boolean|Controls if sounds come from the Wii Remote speaker of Real Wii Remotes|{{{enablespeakerdata|}}}}}{{{enablespeakerdatanotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{wiimotemotor|}}}|{{Config required|Wii Remote Motor||boolean||{{{wiimotemotor|}}}}}{{{wiimotemotornotes|}}}}} | {{#if:{{{wiimotemotor|}}}|{{!}}Controllers > {{Config required|Wii Remote Motor||boolean||{{{wiimotemotor|}}}}}{{{wiimotemotornotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{!}}} | {{!}}} | ||
}}<!-- GAME PROPERTIES -->{{#if: | }}<!-- GAME PROPERTIES -->{{#if:{{#if: | ||
<!-- Core --> | |||
{{{mmu|}}} | {{{mmu|}}} | ||
{{{fprf|}}} | {{{fprf|}}} | ||
{{{syncgputhread|}}} | {{{syncgputhread|}}} | ||
{{{fastdisc|}}} | {{{fastdisc|}}}|{{#vardefineecho:iniheader|[Core]}}}}| | ||
<h3> Game Properties </h3> | <h3> Game Properties </h3> | ||
{{{!}}class="wikitable" style="font-size:90%; text-align:left;" cellspacing="0" cellpadding="3" | {{{!}}class="wikitable" style="font-size:90%; text-align:left;" cellspacing="0" cellpadding="3" | ||
!Configuration!!Setting!![[GameINI]]!!Notes | !Configuration!!Setting!![[GameINI]] <span style="font-weight:normal;">{{#var:iniheader}}</span>!!Notes | ||
{{!}}- | {{!}}- | ||
{{#if:{{{mmu|}}}|{{Config required|Enable MMU|MMU|boolean|Enable Memory Management Unit|{{{mmu|}}}}}{{{mmunotes|}}}}} | {{#if:{{{mmu|}}}|{{!}}Properties > General > {{Config required|Enable MMU|MMU|boolean|Enable Memory Management Unit|{{{mmu|}}}}}{{{mmunotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{fprf|}}}|{{Config required|Enable FPRF|FPRF|boolean|Floating Point Result Flag support|{{{fprf|}}}}}{{{fprfnotes|}}}}} | {{#if:{{{fprf|}}}|{{!}}Properties > General > {{Config required|Enable FPRF|FPRF|boolean|Floating Point Result Flag support|{{{fprf|}}}}}{{{fprfnotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{syncgputhread|}}}|{{Config required|Synchronize GPU Thread|SyncGPU|boolean|Synchronizes CPU and GPU threads, allowing dual core to work in games where it has problems otherwise|{{{syncgputhread|}}}}}{{{syncgputhreadnotes|}}}}} | {{#if:{{{syncgputhread|}}}|{{!}}Properties > General > {{Config required|Synchronize GPU Thread|SyncGPU|boolean|Synchronizes CPU and GPU threads, allowing dual core to work in games where it has problems otherwise|{{{syncgputhread|}}}}}{{{syncgputhreadnotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#if:{{{fastdisc|}}}|{{Config required|Speed up Disc Transfer Rate|FastDiscSpeed|boolean|Enables fast disc access|{{{fastdisc|}}}}}{{{fastdiscnotes | {{#if:{{{fastdisc|}}}|{{!}}Properties > General > {{Config required|Speed up Disc Transfer Rate|FastDiscSpeed|boolean|Enables fast disc access|{{{fastdisc|}}}}}{{{fastdiscnotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{!}}} | {{!}}} | ||
Line 356: | Line 360: | ||
{{{framelimitnotes|}}} | {{{framelimitnotes|}}} | ||
{{#regex:{{{cpuengine}}}|/.*[iI][lL].*/}} | {{#regex:{{{cpuengine}}}|/.*[iI][lL].*/}} | ||
{{{ntscj|}}} | |||
{{{ubershaders|}}} | {{{ubershaders|}}} | ||
{{{ubershadersnotes|}}} | {{{ubershadersnotes|}}} |
Latest revision as of 05:03, 14 February 2022
[edit] [ ] Template documentation
This template outputs a standardized set of configuration information.
Features
New features in this sandbox version:
- Path to setting
- GameINI counterparts
- Using Template:Config required
- Handing off table tags for improved editing performance
- Produces Category:Config template misformatted settings
Issues
- Requires
{{#vardefineecho:=|setting=gameini}}
for all string-based settings for using equal signs. - String-based settings need empty equation when ini isn't available.
- Those using decimal will accept "Unlimited" as input.
Example
{{Config/sandbox |dualcore = Off |dualcorenotes = Show File Select menus properly }}
Produces
Only configuration options for the best compatibility where they deviate from defaults are listed.
General
Configuration | Setting | GameINI [Core] | Notes |
---|---|---|---|
Settings > General > Enable Dual Core | Off | CPUThread = False |
Show File Select menus properly |
Full preview
Only configuration options for the best compatibility where they deviate from defaults are listed.
General
Configuration | Setting | GameINI [Core] | Notes |
---|---|---|---|
Settings > General > Enable Dual Core | On | CPUThread = True |
Boolean |
Settings > General > Speed Limit | 100% | EmulationSpeed = 1 |
Decimal |
Settings > Interface > Use Panic Handlers | On | Boolean | |
Settings > GameCube > Skip GC BIOS | On | Boolean | |
Settings > Advanced > CPU Emulator Engine | JIT x64 | CPUCore = 1 |
String |
Settings > Advanced > CPU Clock Override | 100% | Overclock = 1 |
Decimal |
Graphics
Configuration | Setting | See GameINI for headings | Notes |
---|---|---|---|
Graphics > General > Video Back End | OpenGL | GFXBackend = OGL |
String |
Graphics > General > Aspect Ratio | Auto | AspectRatio = 0 |
String |
Graphics > General > V-Sync | On | VSync = True |
Boolean |
Graphics > General > Use Fullscreen | On | Boolean | |
Graphics > General > Render to Main Window | On | Boolean | |
Graphics > General > Shader Compilation | Synchronous | ShaderCompilationMode = 0 |
String |
Graphics > General > Compile Shaders Before Starting | On | WaitForShadersBeforeStarting = True |
Boolean |
Graphics > Enhancements > Internal Resolution | 1x | InternalResolution = 0 |
String |
Graphics > Enhancements > Anti-Aliasing | 4x SSAA | MSAA = 4 SSAA = True |
String |
Graphics > Enhancements > Anisotropic Filtering | 1x | MaxAnisotropy = 0 |
String |
Graphics > Enhancements > Scaled EFB Copy | On | EFBScaledCopy = True |
Boolean |
Graphics > Enhancements > Per-Pixel Lighting | On | EnablePixelLighting = True |
Boolean |
Graphics > Enhancements > Force Texture Filtering | On | ForceFiltering = True |
Boolean |
Graphics > Enhancements > Widescreen Hack | On | wideScreenHack = True |
Boolean |
Graphics > Enhancements > Disable Fog | On | DisableFog = True |
Boolean |
Graphics > Enhancements > Force 24-Bit Color | On | ForceTrueColor = True |
Boolean |
Graphics > Enhancements > Arbitrary Mipmap Detection | On | ArbitraryMipmapDetection = True |
Boolean |
Graphics > Hacks > Skip EFB Access from CPU | On | EFBAccessEnable = False |
String |
Graphics > Hacks > Ignore Format Changes | On | EFBEmulateFormatChanges = False |
String |
Graphics > Hacks > Store EFB Copies to Texture Only | On | EFBToTextureEnable = True |
Boolean |
Graphics > Hacks > Defer EFB Copies to RAM | On | DeferEFBCopies = True |
Boolean |
Graphics > Hacks > Texture Cache Accuracy | Position 3 (Fast) | SafeTextureCacheColorSamples = 128 |
String |
Graphics > Hacks > GPU Texture Decoding | On | EnableGPUTextureDecoding = True |
Boolean |
Graphics > Hacks > Store XFB Copies to Texture Only | On | XFBToTextureEnable = True |
Boolean |
Graphics > Hacks > Immediately Present XFB | On | ImmediateXFBenable = True |
Boolean |
Graphics > Hacks > Fast Depth Calculation | On | FastDepthCalc = True |
Boolean |
Graphics > Hacks > Disable Bounding Box | On | BBoxEnable = True |
Boolean |
Graphics > Hacks > Vertex Rounding Hack | On | VertexRounding = True |
Boolean |
Graphics > Advanced > Crop | On | Boolean | |
Graphics > Advanced > Enable Progressive Scan | On | ProgressiveScan = True |
Boolean |
Graphics > Advanced > Manual Texture Sampling | On | FastTextureSampling = False |
String |
Audio
Configuration | Setting | GameINI [DSP] | Notes |
---|---|---|---|
Settings > Audio > DSP Emulator Engine | HLE | EnableJIT = True |
String |
Settings > Audio > Audio Back End | Cubeb | Backend = Cubeb |
String |
Wii
Configuration | Setting | See GameINI for headings | Notes |
---|---|---|---|
Settings > Wii > Use PAL60 Mode (EuRGB60) | On | PAL60 = True |
Boolean |
Settings > Wii > Enable Screen Saver | On | Boolean | |
Settings > Wii > Insert SD Card | On | WiiSDCard = True |
Boolean |
Settings > Wii > Connect USB Keyboard | On | Boolean | |
Settings > Wii > System Language | English | Language = 1 |
String |
Wii Remote
Configuration | Setting | GameINI | Notes |
---|---|---|---|
Controllers > Enable Speaker Data | On | Boolean | |
Controllers > Wii Remote Motor | On | Boolean |
Game Properties
Configuration | Setting | GameINI [Core] | Notes |
---|---|---|---|
Properties > General > Enable MMU | On | MMU = True |
Boolean |
Properties > General > Enable FPRF | On | FPRF = True |
Boolean |
Properties > General > Synchronize GPU Thread | On | SyncGPU = True |
Boolean |
Properties > General > Speed up Disc Transfer Rate | On | FastDiscSpeed = True |
Boolean |
The above documentation is transcluded from Template:Config/sandbox/doc. (edit | history) Editors can experiment in this template's sandbox (edit) and testcases (edit) pages. Subpages of this template. |