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. |
Template:Config/sandbox: Difference between revisions
Jump to navigation
Jump to search
m (Rearranged Force 24-bit option params to match Dolphin configuration UI) |
mNo edit summary |
||
Line 95: | Line 95: | ||
{{{rendertomain|}}} | {{{rendertomain|}}} | ||
{{{shadercomp|}}} | {{{shadercomp|}}} | ||
{{{compilefirst | {{{compilefirst|}}}| | ||
<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" | ||
Line 139: | Line 115: | ||
{{!}}- | {{!}}- | ||
{{#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:{{{compilefirst|}}}|{{!}}Graphics > General > {{Config required|Compile Shaders Before Starting|WaitForShadersBeforeStarting|boolean|Waits for all shaders to finish compiling before starting a game|{{{compilefirst|}}}}}{{{compilefirstnotes|}}}}} | ||
{{!}}- | |||
{{!}}} | |||
}}<!-- GRAPHICS ENHANCEMENTS -->{{#if: | |||
{{{internalres|}}} | |||
{{{antialiasing|}}} | |||
{{{anisotropic|}}} | |||
{{{efbscaledcopy|}}} | |||
{{{pixellighting|}}} | |||
{{{forcefilter|}}} | |||
{{{widescreenhack|}}} | |||
{{{disablefog|}}} | |||
{{{force24bit|}}} | |||
{{{arbmipmap|}}}| | |||
<h3> Graphics Enhancements</h3> | |||
{{{!}}class="wikitable" style="font-size:90%; text-align:left;" cellspacing="0" cellpadding="3" | |||
!Configuration!!Setting!![[GameINI]] <span style="font-weight:normal;">[Video_Enhancements]</span>!!Notes | |||
{{!}}- | {{!}}- | ||
{{#if:{{{internalres|}}}|{{!}}Graphics > Enhancements > {{Config required|Internal Resolution|InternalResolution|string|Sets the resolution the game will be rendered at behind-the-scenes|{{{internalres|}}}|{{#vardefineecho:=|Window Size, Multiple of 640x528, 1x=0, 1.5x=0, 2x=1, 2.5x=1, 3x=2, 4x=3}}}}{{{internalresnotes|}}}}} | {{#if:{{{internalres|}}}|{{!}}Graphics > Enhancements > {{Config required|Internal Resolution|InternalResolution|string|Sets the resolution the game will be rendered at behind-the-scenes|{{{internalres|}}}|{{#vardefineecho:=|Window Size, Multiple of 640x528, 1x=0, 1.5x=0, 2x=1, 2.5x=1, 3x=2, 4x=3}}}}{{{internalresnotes|}}}}} | ||
{{!}}- | {{!}}- | ||
{{#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, 2x MSAA=2, 4x MSAA=4, 8x MSAA=8, 2x SSAA=2, 4x SSAA=4, 8x SSAA=8}}}}{{{antialiasingnotes|}}}}} | {{#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, 2x MSAA=2, 4x MSAA=4, 8x MSAA=8, 2x SSAA=2 | ||
SSAA = True, 4x SSAA=4 | |||
SSAA = True, 8x SSAA=8 | |||
SSAA = True}}}}{{{antialiasingnotes|}}}}} | |||
{{!}}- | {{!}}- | ||
{{#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:{{{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|}}}}} | ||
Line 159: | Line 157: | ||
{{!}}- | {{!}}- | ||
{{#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:{{{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|}}}}} | ||
{{!}}- | |||
{{!}}} | |||
}}<!-- GRAPHICS HACKS -->{{#if: | |||
{{{skipcpuefbaccess|}}} | |||
{{{formatchanges|}}} | |||
{{{efb2texonly|}}} | |||
{{{deferefb|}}} | |||
{{{accuratetexturecache|}}} | |||
{{{gputexdecode|}}} | |||
{{{xfb2texonly|}}} | |||
{{{xfbimmediate|}}} | |||
{{{fastdepth|}}} | |||
{{{boundingbox|}}} | |||
{{{vertexrounding|}}}| | |||
<h3> Graphics Hacks </h3> | |||
{{{!}}class="wikitable" style="font-size:90%; text-align:left;" cellspacing="0" cellpadding="3" | |||
!Configuration!!Setting!![[GameINI]] <span style="font-weight:normal;">[Video_Hacks]</span>!!Notes | |||
{{!}}- | {{!}}- | ||
{{#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:{{{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|}}}}} | ||
Line 181: | Line 196: | ||
{{!}}- | {{!}}- | ||
{{#if:{{{vertexrounding|}}}|{{!}}Graphics > Hacks > {{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|}}}}} | ||
{{!}}- | |||
{{!}}} | |||
}}<!-- GRAPHICS ADVANCED -->{{#if: | |||
{{{crop|}}} | |||
{{{progressivescan|}}} | |||
{{{manualtexturesampling|}}}| | |||
<h3> Graphics </h3> | |||
{{{!}}class="wikitable" style="font-size:90%; text-align:left;" cellspacing="0" cellpadding="3" | |||
!Configuration!!Setting!![[GameINI]] <span style="font-weight:normal;">[Core]</span>!!Notes | |||
{{!}}- | {{!}}- | ||
{{#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:{{{crop|}}}|{{!}}Graphics > Advanced > {{Config required|Crop||boolean|Crop the picture from it's native aspect ratio to 4:3 or 16:9.|{{{crop|}}}}}{{{cropnotes|}}}}} |
Revision as of 02:09, 9 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 > General > 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 | GameINI [Video_Settings] | 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
Configuration | Setting | GameINI [Video_Enhancements] | Notes |
---|---|---|---|
Graphics > Enhancements > Internal Resolution | 1x | InternalResolution = 0 |
String |
Graphics > Enhancements > Anti-Aliasing | 4x SSAA | MSAA = None=0, 2x MSAA=2, 4x MSAA=4, 8x MSAA=8, 2x SSAA=2
| |
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
Configuration | Setting | GameINI [Video_Hacks] | Notes |
---|---|---|---|
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 | Boolean | |
Graphics > Hacks > Defer EFB Copies to RAM | On | 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 | Boolean | |
Graphics > Hacks > Immediately Present XFB | On | 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
Configuration | Setting | GameINI [Core] | Notes |
---|---|---|---|
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 | GameINI [Wii] | Notes |
---|---|---|---|
Settings > Wii > Use PAL60 Mode (EuRGB60) | On | Boolean | |
Settings > Wii > Enable Screen Saver | On | Boolean | |
Settings > Wii > Insert SD Card | On | Boolean | |
Settings > Wii > Connect USB Keyboard | On | Boolean | |
Settings > Wii > System Language | English | Language = 1 |
String |
Wii Remote
Configuration | Setting | GameINI [Controls] | 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. |