runcommand.sh File Reference

runcommand launching script More...

Variables
Exported String	SDL_GAMECONTROLLERCONFIG = "$(cat "$SDL2_MAPPINGS")"

Detailed Description

runcommand launching script

Copyright

GPLv3

Usage

runcommand.sh VIDEO_MODE COMMAND SAVE_NAME

or

runcommand.sh VIDEO_MODE _SYS_/_PORT_ SYSTEM ROM

Video mode switching is supported on X11, KMS and Raspberry Pi (legacy graphics) systems

Automatic video mode selection (all):

• VIDEO_MODE = 0: use the current video mode

Automatic video mode (Raspberry Pi legacy graphics):

• VIDEO_MODE = 1: set video mode to 640x480 (4:3) or 720x480 (16:9) @60hz
• VIDEO_MODE = 4: set video mode to 1024x768 (4:3) or 1280x720 (16:9) @60hz

Manual video mode selection (Raspberry Pi legacy graphics):

• VIDEO_MODE = "CEA-#": set video mode to CEA mode #
• VIDEO_MODE = "DMT-#": set video mode to DMT mode #
• VIDEO_MODE = "PAL/NTSC-RATIO": set mode to SD output with RATIO of 4:3 / 16:10 or 16:9

Manual video mode selection (KMS):

• VIDEO_MODE = "CRTCID-MODEID": set video mode to CRTC connector id and mode id

Manual video mode selection (X11):

• VIDEO_MODE = "OUTPUT:MODEID": set video mode to connected output name and mode index

Note

Video mode switching only happens if the monitor reports the modes as available (via tvservice) and the requested mode differs from the currently active mode

Additionally it is possible to pass in the current screen resolution (selectable in the runcommand menu) to the emulator to be launched. The respective variables are %XRES% and %YRES% which will be replaced with the specific values as the placeholders %ROM% and %BASENAME% (see below). For example it is possible to set –displaysize=%XRESx%YRES% in emulators.cfg` if an emulator has a command line switch to set the resolution.

If _SYS_ or _PORT_ is provided as the second parameter for the runcommand.sh script, the commandline will be extracted from /opt/retropie/configs/SYSTEM/emulators.cfg with %ROM%, %BASENAME% being replaced with the ROM parameter. This is the default mode used when launching in RetroPie so the user can switch emulator used as well as other options from the runcommand GUI.

If SAVE_NAME is included, that is used for loading and saving of video output modes as well as rendering backend settings for the current COMMAND. If omitted, the binary name is used as a key for the loading and saving. The savename is also displayed in the video output menu (detailed below), so for our purposes we send the emulator module id, which is somewhat descriptive yet short.

On launch this script waits for two seconds for a key or joystick press. If pressed the GUI is shown, where a user can set video modes, default emulators and other options (depending what is being launched).