kc3-lang/SDL/docs/README-linux.md
-
Show log
Commit
-
Hash : c48c81bd
Author :
Date : 2021-11-06T00:00:17
docs: List the required Fedora packages in README-linux.md
Linux
By default SDL will only link against glibc, the rest of the features will be enabled dynamically at runtime depending on the available features on the target system. So, for example if you built SDL with Xinerama support and the target system does not have the Xinerama libraries installed, it will be disabled at runtime, and you won’t get a missing library error, at least with the default configuration parameters.
Build Dependencies
Ubuntu 20.04, all available features enabled:
sudo apt-get install build-essential git make cmake autoconf automake \
libtool pkg-config libasound2-dev libpulse-dev libaudio-dev libjack-dev \
libx11-dev libxext-dev libxrandr-dev libxcursor-dev libxi-dev \
libxinerama-dev libxxf86vm-dev libxss-dev libgl1-mesa-dev libdbus-1-dev \
libudev-dev libgles2-mesa-dev libegl1-mesa-dev libibus-1.0-dev \
fcitx-libs-dev libsamplerate0-dev libsndio-dev libwayland-dev \
libxkbcommon-dev libdrm-dev libgbm-devFedora 35, all available features enabled:
sudo yum install gcc git-core make cmake autoconf automake libtool \
alsa-lib-devel pulseaudio-libs-devel nas-devel pipewire-devel \
libX11-devel libXext-devel libXrandr-devel libXcursor-devel libXi-devel \
libXinerama-devel libXxf86vm-devel libXScrnSaver-devel mesa-libGL-devel \
dbus-devel systemd-devel mesa-libGLES-devel mesa-libEGL-devel ibus-devel \
fcitx-devel libsamplerate-devel wayland-devel wayland-protocols-devel \
libxkbcommon-devel libdrm-devel mesa-libgbm-devel vulkan-devel libusb-devel \
pipewire-jack-audio-connection-kit-devel libdecor-develNOTES:
- This includes all the audio targets except arts and esd, because Ubuntu (and/or Debian) pulled their packages, but in theory SDL still supports them. The sndio audio target is also unavailable on Fedora.
- libsamplerate0-dev lets SDL optionally link to libresamplerate at runtime for higher-quality audio resampling. SDL will work without it if the library is missing, so it’s safe to build in support even if the end user doesn’t have this library installed.
- DirectFB isn’t included because the configure script (currently) fails to find it at all. You can do “sudo apt-get install libdirectfb-dev” and fix the configure script to include DirectFB support. Send patches. :)
Joystick does not work
If you compiled or are using a version of SDL with udev support (and you should!) there’s a few issues that may cause SDL to fail to detect your joystick. To debug this, start by installing the evtest utility. On Ubuntu/Debian:
sudo apt-get install evtestThen run:
sudo evtestYou’ll hopefully see your joystick listed along with a name like “/dev/input/eventXX” Now run:
cat /dev/input/event/XXIf you get a permission error, you need to set a udev rule to change the mode of your device (see below)
Also, try:
sudo udevadm info --query=all --name=input/eventXXIf you see a line stating ID_INPUT_JOYSTICK=1, great, if you don’t see it, you need to set up an udev rule to force this variable.
A combined rule for the Saitek Pro Flight Rudder Pedals to fix both issues looks like:
SUBSYSTEM=="input", ATTRS{idProduct}=="0763", ATTRS{idVendor}=="06a3", MODE="0666", ENV{ID_INPUT_JOYSTICK}="1"
SUBSYSTEM=="input", ATTRS{idProduct}=="0764", ATTRS{idVendor}=="06a3", MODE="0666", ENV{ID_INPUT_JOYSTICK}="1"You can set up similar rules for your device by changing the values listed in idProduct and idVendor. To obtain these values, try:
sudo udevadm info -a --name=input/eventXX | grep idVendor
sudo udevadm info -a --name=input/eventXX | grep idProductIf multiple values come up for each of these, the one you want is the first one of each.
On other systems which ship with an older udev (such as CentOS), you may need to set up a rule such as:
SUBSYSTEM=="input", ENV{ID_CLASS}=="joystick", ENV{ID_INPUT_JOYSTICK}="1"Source
-
docs/README-linux.md
-
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95
Linux ================================================================================ By default SDL will only link against glibc, the rest of the features will be enabled dynamically at runtime depending on the available features on the target system. So, for example if you built SDL with Xinerama support and the target system does not have the Xinerama libraries installed, it will be disabled at runtime, and you won't get a missing library error, at least with the default configuration parameters. Build Dependencies -------------------------------------------------------------------------------- Ubuntu 20.04, all available features enabled: sudo apt-get install build-essential git make cmake autoconf automake \ libtool pkg-config libasound2-dev libpulse-dev libaudio-dev libjack-dev \ libx11-dev libxext-dev libxrandr-dev libxcursor-dev libxi-dev \ libxinerama-dev libxxf86vm-dev libxss-dev libgl1-mesa-dev libdbus-1-dev \ libudev-dev libgles2-mesa-dev libegl1-mesa-dev libibus-1.0-dev \ fcitx-libs-dev libsamplerate0-dev libsndio-dev libwayland-dev \ libxkbcommon-dev libdrm-dev libgbm-dev Fedora 35, all available features enabled: sudo yum install gcc git-core make cmake autoconf automake libtool \ alsa-lib-devel pulseaudio-libs-devel nas-devel pipewire-devel \ libX11-devel libXext-devel libXrandr-devel libXcursor-devel libXi-devel \ libXinerama-devel libXxf86vm-devel libXScrnSaver-devel mesa-libGL-devel \ dbus-devel systemd-devel mesa-libGLES-devel mesa-libEGL-devel ibus-devel \ fcitx-devel libsamplerate-devel wayland-devel wayland-protocols-devel \ libxkbcommon-devel libdrm-devel mesa-libgbm-devel vulkan-devel libusb-devel \ pipewire-jack-audio-connection-kit-devel libdecor-devel NOTES: - This includes all the audio targets except arts and esd, because Ubuntu (and/or Debian) pulled their packages, but in theory SDL still supports them. The sndio audio target is also unavailable on Fedora. - libsamplerate0-dev lets SDL optionally link to libresamplerate at runtime for higher-quality audio resampling. SDL will work without it if the library is missing, so it's safe to build in support even if the end user doesn't have this library installed. - DirectFB isn't included because the configure script (currently) fails to find it at all. You can do "sudo apt-get install libdirectfb-dev" and fix the configure script to include DirectFB support. Send patches. :) Joystick does not work -------------------------------------------------------------------------------- If you compiled or are using a version of SDL with udev support (and you should!) there's a few issues that may cause SDL to fail to detect your joystick. To debug this, start by installing the evtest utility. On Ubuntu/Debian: sudo apt-get install evtest Then run: sudo evtest You'll hopefully see your joystick listed along with a name like "/dev/input/eventXX" Now run: cat /dev/input/event/XX If you get a permission error, you need to set a udev rule to change the mode of your device (see below) Also, try: sudo udevadm info --query=all --name=input/eventXX If you see a line stating ID_INPUT_JOYSTICK=1, great, if you don't see it, you need to set up an udev rule to force this variable. A combined rule for the Saitek Pro Flight Rudder Pedals to fix both issues looks like: SUBSYSTEM=="input", ATTRS{idProduct}=="0763", ATTRS{idVendor}=="06a3", MODE="0666", ENV{ID_INPUT_JOYSTICK}="1" SUBSYSTEM=="input", ATTRS{idProduct}=="0764", ATTRS{idVendor}=="06a3", MODE="0666", ENV{ID_INPUT_JOYSTICK}="1" You can set up similar rules for your device by changing the values listed in idProduct and idVendor. To obtain these values, try: sudo udevadm info -a --name=input/eventXX | grep idVendor sudo udevadm info -a --name=input/eventXX | grep idProduct If multiple values come up for each of these, the one you want is the first one of each. On other systems which ship with an older udev (such as CentOS), you may need to set up a rule such as: SUBSYSTEM=="input", ENV{ID_CLASS}=="joystick", ENV{ID_INPUT_JOYSTICK}="1"