SDL envvars

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: x11 X Window System dga XFree86 DGA 2 nanox Nano-X Window System (Linux) qtopia Qtopia (embedded Linux) fbcon Linux framebuffer console (Linux) directfb DirectFB (Linux) ps2gs Playstation 2 Graphics Synthesizer (Playstation 2) ggi General Graphics Interface vgl FreeBSD Video Graphics Library (BSD) svgalib SVGAlib (Linux) aalib ASCII Art Library directx Microsoft DirectX (Win32) windib Win95/98/NT/2000 GDI (Win32) bwindow BDirectWindow (BeOS) toolbox MacOS ROM Toolbox (MacOS Classic) DSp DrawSprocket (MacOS Classic) Quartz Quartz (MacOS X) CGX WikiPedia:CyberGraphX (AmigaOS) photon QNX Photon (QNX) epoc EPOC (EPOC) xbios Atari XBIOS (Atari) gem Atari GEM (Atari) picogui PicoGUI dcvideo Dreamcast Video (Dreamcast) riscos RISC OS (RISCOS) dummy dummy driver (no output)
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. openbsd (OpenBSD) dsp (OSS /dev/dsp: Linux, Solaris, BSD etc) alsa (Linux) audio (Unix style /dev/audio: SunOS, Solaris etc) AL (Irix) artsc (ARTS audio daemon) esd (esound audio daemon) nas (NAS audio daemon) dma (OSS /dev/dsp, using DMA) dsound (Win32 DirectX) waveout (Win32 WaveOut) baudio (BeOS) sndmgr (MacOS SoundManager) paud (AIX) AHI (Amiga) disk (all; output to file)
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.