switchres.ini override - ZFEbHVUE/Batocera-CRT-Script GitHub Wiki

Switchres.ini override order

Switchres reads configuration files in this order, from most specific to least specific:

  1. Per-core override /userdata/system/configs/retroarch/config/<core_name>/<core_name>.switchres.ini

  2. Global RetroArch override /userdata/system/configs/retroarch/switchres.ini

  3. System default /etc/switchres.ini

How it works

  • If a switchres.ini exists in
    /userdata/system/configs/retroarch/config/<core_name>/
    that file is used.

  • If there is no per-core file, but there is a global file in
    /userdata/system/configs/retroarch/
    the global file is used.

  • If neither override exists, the default file in
    /etc/switchres.ini
    is used.

Notes

  • A global override in /userdata/system/configs/retroarch/ applies to all cores.
  • A per-core override in /userdata/system/configs/retroarch/config/<core_name>/ always takes priority over the global override and the system default.
  • Replace <core_name> with the actual core folder name (for example VBA-M, PCSX-ReARMed, Genesis Plus GX).

Forcing a switchres.ini Core Override in RetroArch

Follow these steps to apply a switchres.ini override for a specific core in RetroArch:


1. Select the Core in Emulation Station

  • Choose the following core in Emulation Station:
    • Core: PCSX-ReARMed

2. Start a Game

  • Launch any game from Emulation Station that uses the selected core.

3. Open the Quick Menu

  • While the game is running, open the Quick Menu using:
    • [HOTKEY] + South button or Shift+F1.

4. Save Content Directory Override

  • Navigate to:
    • Override -> Save Content Directory Override
  • This will create a configuration folder for the core.

5. Exit the Emulator

  • Exit the emulator and navigate to the newly created folder for the core:
    • /userdata/system/configs/retroarch/config/PCSX-ReARMed/

6. Locate and Edit the Configuration File

  • In the folder, find the file:
    • /userdata/system/configs/retroarch/config/PCSX-ReARMed/psx.cfg
  • Open the file, delete its contents to make it blank, and then save it.

7. Copy switchres.ini from /etc/

  • Use the following terminal command to copy the switchres.ini file:
    cp /etc/switchres.ini /userdata/system/configs/retroarch/config/PCSX-ReARMed
    

8. Rename the Copied File

  • Rename the copied file to:
    • psx.switchres.ini

9. Edit the psx.switchres.ini File

  • Open the psx.switchres.ini file and apply the desired settings.

Examples of Settings

Enabling Super Resolution
  • Locate the line:
    dotclock_min 0
    
  • Change it to:
    dotclock_min 25
    
  • This will enable super resolution (e.g., 2560).

Forcing a Monitor Profile
  • Locate the line:
    monitor arcade_31
    
  • This will set the monitor profile to arcade_31, ensuring all games are displayed in 31kHz progressive resolution.

Disabling Interlaced Resolutions
  • Locate the section:
    # Allow interlaced modes (existing or generated)
    
  • Change the value of interlace to:
    interlace 0
    
  • This will turn off interlaced resolutions generated by switchres.

Result

Once completed, the switchres.ini override will apply to all games using the selected core, ensuring your custom settings are in effect.

Forcing Super Resolution for Specific Games in a Sub-Folder for RetroArch

Follow these steps to enable super resolution for specific games in RetroArch:


1. Create a New Sub-Folder

  • Create a new sub-folder under /userdata/roms/psx/ and name it super_res.

2. Place the Games

  • Place the games you want to force a super resolution for into this folder:
    • /userdata/roms/psx/super_res

3. Select the Core in Emulation Station

  • For the games in the super_res folder, select:
    • Core: PCSX-ReARMed

4. Start a Game

  • Launch any game from Emulation Station that is in the super_res folder.

5. Open the Quick Menu

  • While the game is running, open the Quick Menu using:
    • [HOTKEY] + South button or Shift+F1.

6. Save Content Directory Override

  • Navigate to:
    • Override -> Save Content Directory Override
  • This will create a configuration folder for the core.

7. Exit the Emulator

  • Exit the emulator and navigate to the newly created folder for the core:
    • /userdata/system/configs/retroarch/config/PCSX-ReARMed/

8. Edit the Configuration File

  • Inside this folder, you will find a file named:
    • /userdata/system/configs/retroarch/config/PCSX-ReARMed/super_res.cfg
  • Open the file, delete its contents to make it blank, and then save it.

9. Copy switchres.ini from /etc/

  • Use the following terminal command to copy the switchres.ini file:
    cp /etc/switchres.ini /userdata/system/configs/retroarch/config/PCSX-ReARMed
    

10. Rename the Copied File

  • Rename the copied file to:
    • super_res.switchres.ini

11. Edit the super_res.switchres.ini File

  • Open the super_res.switchres.ini file and make the following change:
    • Locate the line:
      dotclock_min 0
      
    • Change it to:
      dotclock_min 25
      

This change will enable the super resolution (e.g., 2560).


Result

Once completed, the super resolution settings will apply to all games in the super_res folder.


Individual Geometry Adjustments for Specific Games in a Sub-Folder for RetroArch

If you want to adjust the geometry settings for specific games, follow these steps:


1. Create a New Sub-Folder

  • Create a new sub-folder under /userdata/roms/psx/ and name it capcom.

2. Place the Games

  • Place the games you want to adjust the geometry for into the capcom folder:
    • /userdata/roms/psx/capcom

3. Select the Core in Emulation Station

  • For the games in the capcom folder, select:
    • Core: PCSX-ReARMed

4. Start a Game

  • Launch any game from Emulation Station that is in the capcom folder.

5. Open the Quick Menu

  • While the game is running, open the Quick Menu using:
    • [HOTKEY] + South button or Shift+F1.

6. Save Content Directory Override

  • Navigate to:
    • Override -> Save Content Directory Override
  • This will create a configuration folder for the core.

7. Exit the Emulator

  • Exit the emulator and navigate to the newly created folder for the core:
    • /userdata/system/configs/retroarch/config/PCSX-ReARMed/

8. Edit the Configuration File

  • Inside this folder, you will find a file named:
    • /userdata/system/configs/retroarch/config/PCSX-ReARMed/capcom.cfg
  • Open the file, delete its contents to make it blank, and then save it.

9. Copy switchres.ini from /etc/

  • Use the following terminal command to copy the switchres.ini file:
    cp /etc/switchres.ini /userdata/system/configs/retroarch/config/PCSX-ReARMed
    

10. Rename the Copied File

  • Rename the copied file to:
    • capcom.switchres.ini

11. Edit the capcom.switchres.ini File

  • Open the file and make changes to the following lines:
    h_size                    1.0
    h_shift                   0
    v_shift                   0
    

Explanation of Parameters

  • H-size [0.5 - 1.5]: Controls the horizontal size of the image (h_size option).
  • H-shift [positive or negative, in pixels]: Controls the horizontal position of the image (h_shift option).
  • V-shift [positive or negative, in lines]: Controls the vertical position of the image (v_shift option).

Note: Adjustments for V-size are not possible via software.


Example Geometry Adjustments for a 15kHz Consumer CRT

Here are some typical ranges for geometry adjustments on a 15kHz CRT:

  • H-Size Positive: (1.0) 1.1 -> 1.12
  • H-Size Negative: (1.0) 0.99 -> 0.94
  • H-Shift Right: (0) 1 -> 25
  • H-Shift Left: (0) -1 -> -25
  • V-Shift Up: (0) -1 -> -9
  • V-Shift Down: (0) 1 -> 9

Note: Values outside these ranges may not work properly.


Result

Once completed, the geometry adjustments will apply to all games in the capcom folder.

⚠️ **GitHub.com Fallback** ⚠️