pandemonium_engine_minimal/platform/frt/doc/Environment.md

69 lines
1.9 KiB
Markdown
Raw Normal View History

2023-12-14 21:54:22 +01:00
Environment
===========
Environment variables can be passed to FRT like this:
export FRT_KMSDRM_DEVICE=/dev/dri/renderD128
frt_096_216_pi2.bin -path ~/mygame
Or like this:
FRT_KMSDRM_DEVICE=/dev/dri/renderD128 frt_096_216_pi2.bin -path ~/mygame
In most cases, you shouldn't need to set environment variables to use FRT.
## `FRT_X11_UNDECORATED`
Ask the window manager not to decorate the window, and force its position
to be at 0,0.
Work around the lack of fullscreen support in the X11 module. Intended to be
used together with --resolution (or -r for Godot 2).
## `FRT_KEYBOARD_ID` and `FRT_MOUSE_ID`
If FRT fails to select the correct device for your keyboard and/or your mouse,
you can force it to by specifying either the full path of the device, or its
name as seen by the input bus. For example, to find out which name to use, you
can use the following command:
grep Name= /proc/bus/input/devices
`FRT_KEYBOARD_ID` can also be used to let FRT open a "virtual keyboard". For
example (GPIOnext):
FRT_KEYBOARD_ID="GPIOnext Keyboard"
or (Adafruit-Retrogame):
FRT_KEYBOARD_ID=retrogame
These variables are not relevant under X11.
## `FRT_KMSDRM_DEVICE`
Selection of the dri card to use is done by an heuristic tuned for the
Pis. For other devices, you might have to select it manually. For
example:
FRT_KMSDRM_DEVICE=/dev/dri/renderD128
## `FRT_MODULES`
This should be used as a last resort and only if you know what you are doing.
Forcing a module that cannot run is likely to result in FRT just crashing.
To override which modules are loaded by FRT, use the following pattern:
FRT_MODULES=<video>,<keyboard>,<mouse>
For example, this forces FRT to use the legacy fbdev module (Mali binary
driver for FBDEV):
FRT_MODULES=video_fbdev,keyboard_linux_input,mouse_linux_input
And this prevents FRT from grabbing/using the keyboard and the mouse:
FRT_MODULES=video_kmsdrm,,