SDL envvars: Unterschied zwischen den Versionen
Aus DGL Wiki
I0n0s (Diskussion | Beiträge) (Teile müssen noch übersetzt werden) |
I0n0s (Diskussion | Beiträge) (Vollständig übersetzt.) |
||
(4 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) | |||
Zeile 1: | Zeile 1: | ||
− | |||
= SDL_envvars = | = SDL_envvars = | ||
Zeile 13: | Zeile 12: | ||
== Parameter == | == Parameter == | ||
− | {| | + | {| {{Prettytable_B1}} |
! ''variable'' | ! ''variable'' | ||
| "SDL-Variable=Wert" | | "SDL-Variable=Wert" | ||
Zeile 26: | Zeile 25: | ||
=== Video === | === Video === | ||
− | {| | + | {| {{Prettytable_B1}} |
!SDL_FBACCEL | !SDL_FBACCEL | ||
− | | | + | |Wenn auf 0 gesetzt, wird die Hardwarebeschleunigung beim Linux fbcon Treiber deaktiviert. |
|- | |- | ||
!SDL_FBDEV | !SDL_FBDEV | ||
− | |Frame | + | |Welches Frame-Buffer-Device vom Linux fbcon Treiber benutzt werden soll. Standard ist /dev/fb0 |
|- | |- | ||
!SDL_FULLSCREEN_UPDATE | !SDL_FULLSCREEN_UPDATE | ||
− | | | + | |Bei Benutzung des ps2gs Treibers wird das SDL_ASNCBLIT Flag in der Displaysurface gesetzt. |
|- | |- | ||
!SDL_VIDEODRIVER | !SDL_VIDEODRIVER | ||
− | | | + | |Bestimmt welcher Videotreiber von SDL benutzt werden soll. Möglich Werte sind: |
− | {| | + | {| {{Prettytable_B1}} |
!x11 | !x11 | ||
|[http://x.org/ X Window System] | |[http://x.org/ X Window System] | ||
Zeile 119: | Zeile 118: | ||
|- | |- | ||
!SDL_VIDEO_CENTERED | !SDL_VIDEO_CENTERED | ||
− | | | + | |Wenn gesetzt versucht SDL das Fenster unter X11 in das Zentrum des Bildschirms zu setzen. |
|- | |- | ||
!SDL_VIDEO_GL_DRIVER | !SDL_VIDEO_GL_DRIVER | ||
− | | | + | |Der OpenGL-Treiber der von X11 benutzt. Standard ist libGL.so.1. |
|- | |- | ||
!SDL_VIDEO_X11_DGAMOUSE | !SDL_VIDEO_X11_DGAMOUSE | ||
− | | | + | |Unter XFree86 wird die DGA-Maus benutzt, wenn es aktiviert wird. |
|- | |- | ||
!SDL_VIDEO_X11_MOUSEACCEL | !SDL_VIDEO_X11_MOUSEACCEL | ||
− | | | + | |Setzt unter X11 die Mausbeschleunigung. Der Wert soll ein String in folgender Form sein: |
`"n/d/t"` | `"n/d/t"` | ||
− | + | wobei ''n'' und ''d'' die Beschleunigung der Maus und ''t'' der Grenzwert der Beschleunigung (die maximale Anzahl an Pixeln der Maus in einer Bewegung). | |
|- | |- | ||
!SDL_VIDEO_X11_NODIRECTCOLOR | !SDL_VIDEO_X11_NODIRECTCOLOR | ||
− | | | + | |Falls gesetzt darf DirectColor nicht mehr benutzt werden, auch wenn dies noch immer vorhanden ist (SDL benutzt es sonst zur Gammakorrektur). Dies ist für ältere X-Server benötigt bei denen die XVideo Erweiterung benutzt wird. |
|- | |- | ||
!SDL_VIDEO_X11_VISUALID | !SDL_VIDEO_X11_VISUALID | ||
− | |ID | + | |ID des X11 Visual welches benutzt werden soll. Dabei wird der SDL Algorithmus zur Auswahl des Visual übergangen. Die Zahl darf dezimal oder hexadezimal (mit Präfix 0x) sein. |
|- | |- | ||
!SDL_VIDEO_YUV_DIRECT | !SDL_VIDEO_YUV_DIRECT | ||
− | | | + | |Wenn gesetzt wird versucht den YUV Overlay direkt in der Videosurface darzustellen anstatt in einer Surface welche an [[SDL_CreateYUVOverlay]] weitergereicht wird. |
|- | |- | ||
!SDL_VIDEO_YUV_HWACCEL | !SDL_VIDEO_YUV_HWACCEL | ||
− | | | + | |Falls nicht gesetzt oder mit einem nichtnegativen Wert belegt, versucht SDL YUV Hardwarebeschleunigung für das Video abspielen zu benutzen. |
|- | |- | ||
!SDL_WINDOWID | !SDL_WINDOWID | ||
− | | | + | |Für X11 oder Win32 enthält dies die ID des Fensters welches von SDL benutzt werden soll damit dieses kein eigenes erstellt. Darf entweder dezimal oder hexadezimal (mit Präfix 0x) angegeben werden. |
|} | |} | ||
=== Events/Input === | === Events/Input === | ||
− | {| | + | {| {{Prettytable_B1}} |
!SDL_MOUSE_RELATIVE | !SDL_MOUSE_RELATIVE | ||
− | | | + | |Falls auf 0 gesetzt wird nicht der relative Mausmodus in X11 benutzt. Standardmäßig wird er benutzt falls die Maus versteckt wurde und die Eingabe an sich gerissen wurde. |
|- | |- | ||
!SDL_MOUSEDEV | !SDL_MOUSEDEV | ||
− | | | + | |Das Mausdevice welche für den Linux fbcon Treiber benutzt werden soll. Falls es nicht gesetzt ist versucht SDL erst GPM im Wiederholungsmodus, danach verschiedene andere Geräte (/dev/pcaux, /dev/adbmouse, /dev/mouse etc). |
|- | |- | ||
!SDL_MOUSEDEV_IMPS2 | !SDL_MOUSEDEV_IMPS2 | ||
− | | | + | |Falls gesetzt wird SDL nicht versuchen das IMPS/2 Protokoll einer PS/2 Maus zu erkennen sondern es direkt zu benutzen. Für fbcon und ps2gs Treiber. |
|- | |- | ||
!SDL_MOUSEDRV | !SDL_MOUSEDRV | ||
− | | | + | |Für den Linux fbcon Treiber: Falls es zu ELO gesetzt wurde wird der ELO Touchscreen als Zeigegerät benutzt. |
|- | |- | ||
!SDL_NO_RAWKBD | !SDL_NO_RAWKBD | ||
− | | | + | |Für den libvga Treiber: Falls es gesetzt wurde wird nicht versucht den Tastaturinput im Raw Modus einzulesen. |
|- | |- | ||
− | !SDL_NOMOUSE | + | !SDL_NOMOUSE |
+ | |Falls gesetzt wird der Linux fbcon Treiber überhaupt keine Maus benutzen. | ||
|} | |} | ||
+ | |||
=== Audio === | === Audio === | ||
− | {| | + | {| {{Prettytable_B1}} |
!AUDIODEV | !AUDIODEV | ||
− | | | + | |Das Audiogerät welches benutzt werden soll falls SDL_PATH_DSP nicht gesetzt ist. |
|- | |- | ||
!SDL_AUDIODRIVER | !SDL_AUDIODRIVER | ||
− | | | + | |Wählt den Audiotreiber den SDL benutzen soll. Die Tabelle enthält die möglichen Werte in der Reihenfolge wie sie überprüft werden falls die Variable nicht gesetzt wurde. |
{| border="1" rules="all" | {| border="1" rules="all" | ||
!openbsd | !openbsd | ||
Zeile 222: | Zeile 223: | ||
|(Amiga) | |(Amiga) | ||
|- | |- | ||
− | !disk|(all; output to file) | + | !disk |
+ | |(all; output to file) | ||
|} | |} | ||
|- | |- | ||
!SDL_DISKAUDIOFILE | !SDL_DISKAUDIOFILE | ||
− | | | + | |Der Name der Ausgabedatei für den "disk" Audiotreiber. Falls nicht gesetzt wird ''sdlaudio.raw'' benutzt. |
|- | |- | ||
!SDL_DISKAUDIODELAY | !SDL_DISKAUDIODELAY | ||
− | | | + | |Sagt den "disk" Audiotreiber wie lange er warten soll bevor er einen vollen Soundbuffer schreibt (in ms). Der Standardwert ist 150 ms. |
|- | |- | ||
!SDL_DSP_NOSELECT | !SDL_DSP_NOSELECT | ||
− | | | + | |Für diverse Audiotreiber (alsa, paud, dma und dsp): Es wird nicht 'select()' sondern eine alternative Methode benutzt. Dies könnte ein paar Audioprobleme beseitigen, dafür aber andere verursachen. |
|- | |- | ||
!SDL_PATH_DSP | !SDL_PATH_DSP | ||
− | | | + | |Das Audiogerät welches benutzt werden soll. Falls es nicht gesetzt wurde versucht SDL AUDIODEV und danach den Plattform abhängigen Standardwert (/dev/audio bei Solaris, /dev/dsp auf Linux etc). |
|} | |} | ||
=== CD-ROM === | === CD-ROM === | ||
− | {| | + | {| {{Prettytable_B1}} |
!SDL_CDROM | !SDL_CDROM | ||
− | | | + | |Eine mit Doppelpunkten abgetrennte Liste von CD-ROM Geräten welche zusätzlich zu den Standardgeräten benutzt werden sollen. |
|} | |} | ||
=== Debugging === | === Debugging === | ||
− | {| | + | {| {{Prettytable_B1}} |
!SDL_DEBUG | !SDL_DEBUG | ||
− | | | + | |Falls gesetzt verursacht jeder Aufruf von [[SDL_SetError]] eine Ausgabe auf stderr. |
|} | |} | ||
=== Joystick === | === Joystick === | ||
− | {| | + | {| {{Prettytable_B1}} |
!SDL_JOYSTICK_DEVICE | !SDL_JOYSTICK_DEVICE | ||
− | |Joystick | + | |Joystickdevice welches von dem Linux Joystick zusätzlich zu den üblichen (/dev/js*, /dev/input/event*, /dev/input/js*) benutzt werden soll. |
|- | |- | ||
!SDL_LINUX_JOYSTICK | !SDL_LINUX_JOYSTICK | ||
− | | | + | |Spezieller Joystickkonfigurationsstring für Linux. Das Format ist: |
"name numaxes numhats numballs" | "name numaxes numhats numballs" | ||
− | + | wobei ''name'' der Name des Joysticks ist und der Rest die Anzahl der Achsen, der Cooliehats sowie der Balls. | |
|} | |} | ||
Aktuelle Version vom 15. September 2007, 10:33 Uhr
Inhaltsverzeichnis
SDL_envvars
Name
SDL_envvars - SDL-Umgebungsvariablen
Delphi-Spezifikation
function SDL_putenv(const variable: PChar): Integer; function SDL_getenv(const name: PChar): PChar;
Parameter
variable | "SDL-Variable=Wert" |
---|---|
name | "SDL-Variable" |
Beschreibung
Erlaubt das Modizifieren von diversen SDL-Variablen um das Verhalten von SDL zu verändern.
Video
SDL_FBACCEL | Wenn auf 0 gesetzt, wird die Hardwarebeschleunigung beim Linux fbcon Treiber deaktiviert. | ||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
SDL_FBDEV | Welches Frame-Buffer-Device vom Linux fbcon Treiber benutzt werden soll. Standard ist /dev/fb0 | ||||||||||||||||||||||||||||||||||||||||||||||||||||
SDL_FULLSCREEN_UPDATE | Bei Benutzung des ps2gs Treibers wird das SDL_ASNCBLIT Flag in der Displaysurface gesetzt. | ||||||||||||||||||||||||||||||||||||||||||||||||||||
SDL_VIDEODRIVER | Bestimmt welcher Videotreiber von SDL benutzt werden soll. Möglich Werte sind:
| ||||||||||||||||||||||||||||||||||||||||||||||||||||
SDL_VIDEO_CENTERED | Wenn gesetzt versucht SDL das Fenster unter X11 in das Zentrum des Bildschirms zu setzen. | ||||||||||||||||||||||||||||||||||||||||||||||||||||
SDL_VIDEO_GL_DRIVER | Der OpenGL-Treiber der von X11 benutzt. Standard ist libGL.so.1. | ||||||||||||||||||||||||||||||||||||||||||||||||||||
SDL_VIDEO_X11_DGAMOUSE | Unter XFree86 wird die DGA-Maus benutzt, wenn es aktiviert wird. | ||||||||||||||||||||||||||||||||||||||||||||||||||||
SDL_VIDEO_X11_MOUSEACCEL | Setzt unter X11 die Mausbeschleunigung. Der Wert soll ein String in folgender Form sein:
`"n/d/t"` wobei n und d die Beschleunigung der Maus und t der Grenzwert der Beschleunigung (die maximale Anzahl an Pixeln der Maus in einer Bewegung). | ||||||||||||||||||||||||||||||||||||||||||||||||||||
SDL_VIDEO_X11_NODIRECTCOLOR | Falls gesetzt darf DirectColor nicht mehr benutzt werden, auch wenn dies noch immer vorhanden ist (SDL benutzt es sonst zur Gammakorrektur). Dies ist für ältere X-Server benötigt bei denen die XVideo Erweiterung benutzt wird. | ||||||||||||||||||||||||||||||||||||||||||||||||||||
SDL_VIDEO_X11_VISUALID | ID des X11 Visual welches benutzt werden soll. Dabei wird der SDL Algorithmus zur Auswahl des Visual übergangen. Die Zahl darf dezimal oder hexadezimal (mit Präfix 0x) sein. | ||||||||||||||||||||||||||||||||||||||||||||||||||||
SDL_VIDEO_YUV_DIRECT | Wenn gesetzt wird versucht den YUV Overlay direkt in der Videosurface darzustellen anstatt in einer Surface welche an SDL_CreateYUVOverlay weitergereicht wird. | ||||||||||||||||||||||||||||||||||||||||||||||||||||
SDL_VIDEO_YUV_HWACCEL | Falls nicht gesetzt oder mit einem nichtnegativen Wert belegt, versucht SDL YUV Hardwarebeschleunigung für das Video abspielen zu benutzen. | ||||||||||||||||||||||||||||||||||||||||||||||||||||
SDL_WINDOWID | Für X11 oder Win32 enthält dies die ID des Fensters welches von SDL benutzt werden soll damit dieses kein eigenes erstellt. Darf entweder dezimal oder hexadezimal (mit Präfix 0x) angegeben werden. |
Events/Input
SDL_MOUSE_RELATIVE | Falls auf 0 gesetzt wird nicht der relative Mausmodus in X11 benutzt. Standardmäßig wird er benutzt falls die Maus versteckt wurde und die Eingabe an sich gerissen wurde. |
---|---|
SDL_MOUSEDEV | Das Mausdevice welche für den Linux fbcon Treiber benutzt werden soll. Falls es nicht gesetzt ist versucht SDL erst GPM im Wiederholungsmodus, danach verschiedene andere Geräte (/dev/pcaux, /dev/adbmouse, /dev/mouse etc). |
SDL_MOUSEDEV_IMPS2 | Falls gesetzt wird SDL nicht versuchen das IMPS/2 Protokoll einer PS/2 Maus zu erkennen sondern es direkt zu benutzen. Für fbcon und ps2gs Treiber. |
SDL_MOUSEDRV | Für den Linux fbcon Treiber: Falls es zu ELO gesetzt wurde wird der ELO Touchscreen als Zeigegerät benutzt. |
SDL_NO_RAWKBD | Für den libvga Treiber: Falls es gesetzt wurde wird nicht versucht den Tastaturinput im Raw Modus einzulesen. |
SDL_NOMOUSE | Falls gesetzt wird der Linux fbcon Treiber überhaupt keine Maus benutzen. |
Audio
AUDIODEV | Das Audiogerät welches benutzt werden soll falls SDL_PATH_DSP nicht gesetzt ist. | ||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
SDL_AUDIODRIVER | Wählt den Audiotreiber den SDL benutzen soll. Die Tabelle enthält die möglichen Werte in der Reihenfolge wie sie überprüft werden falls die Variable nicht gesetzt wurde.
| ||||||||||||||||||||||||||||||||
SDL_DISKAUDIOFILE | Der Name der Ausgabedatei für den "disk" Audiotreiber. Falls nicht gesetzt wird sdlaudio.raw benutzt. | ||||||||||||||||||||||||||||||||
SDL_DISKAUDIODELAY | Sagt den "disk" Audiotreiber wie lange er warten soll bevor er einen vollen Soundbuffer schreibt (in ms). Der Standardwert ist 150 ms. | ||||||||||||||||||||||||||||||||
SDL_DSP_NOSELECT | Für diverse Audiotreiber (alsa, paud, dma und dsp): Es wird nicht 'select()' sondern eine alternative Methode benutzt. Dies könnte ein paar Audioprobleme beseitigen, dafür aber andere verursachen. | ||||||||||||||||||||||||||||||||
SDL_PATH_DSP | Das Audiogerät welches benutzt werden soll. Falls es nicht gesetzt wurde versucht SDL AUDIODEV und danach den Plattform abhängigen Standardwert (/dev/audio bei Solaris, /dev/dsp auf Linux etc). |
CD-ROM
SDL_CDROM | Eine mit Doppelpunkten abgetrennte Liste von CD-ROM Geräten welche zusätzlich zu den Standardgeräten benutzt werden sollen. |
---|
Debugging
SDL_DEBUG | Falls gesetzt verursacht jeder Aufruf von SDL_SetError eine Ausgabe auf stderr. |
---|
Joystick
SDL_JOYSTICK_DEVICE | Joystickdevice welches von dem Linux Joystick zusätzlich zu den üblichen (/dev/js*, /dev/input/event*, /dev/input/js*) benutzt werden soll. |
---|---|
SDL_LINUX_JOYSTICK | Spezieller Joystickkonfigurationsstring für Linux. Das Format ist:
"name numaxes numhats numballs" wobei name der Name des Joysticks ist und der Rest die Anzahl der Achsen, der Cooliehats sowie der Balls. |
Hinweise
Die Namen und Existenz der Variablen können sich bei jedem Release ändern. Das Ganze ist für Debugging-Zwecke implementiert.
SDL_VIDEODRIVER=dummy vor dem Aufruf SDL_SetVideoMode führt dazu, dass kein Fenster erzeugt wird, aber das Event-Handling denoch von SDL übernommen wird.