SDL envvars

Hinweis: Dieser Artikel ist noch unvollständig. (Mehr Informationen/weitere Artikel) {{{1}}}

---

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"` where n and d are the acceleration numerator/denumerators (so mouse movement is accelerated by `n/d`), and t is the threshold above which acceleration applies (counted as number of pixels the mouse moves at once).
SDL_VIDEO_X11_NODIRECTCOLOR	If set, don't attempt to use DirectColor visuals even if they are present. (SDL will use them otherwise for gamma correction). This is needed with older X servers when using the XVideo extension.
SDL_VIDEO_X11_VISUALID	ID of an X11 visual to use, overriding SDL's default visual selection algorithm. It can be in decimal or in hex (prefixed by 0x).
SDL_VIDEO_YUV_DIRECT	If set, display YUV overlay directly on the video surface if possible, instead of on the surface passed to ["SDL_CreateYUVOverlay"].
SDL_VIDEO_YUV_HWACCEL	If not set or set to a nonzero value, SDL will attempt to use hardware YUV acceleration for video playback.
SDL_WINDOWID	For X11 or Win32, contains the ID number of the window to be used by SDL instead of creating its own window. Either in decimal or in hex (prefixed by 0x).

Events/Input

SDL_MOUSE_RELATIVE	If set to 0, do not use mouse relative mode in X11. The default is to use it if the mouse is hidden and input is grabbed.
SDL_MOUSEDEV	The mouse device to use for the linux fbcon driver. If not set, SDL first tries to use GPM in repeater mode, then various other devices (/dev/pcaux, /dev/adbmouse, /dev/mouse etc).
SDL_MOUSEDEV_IMPS2	If set, SDL will not try to auto-detect the IMPS/2 protocol of a PS/2 mouse but use it right away. For the fbcon and ps2gs drivers.
SDL_MOUSEDRV	For the linux fbcon driver: if set to ELO, use the ELO touchscreen controller as a pointer device
SDL_NO_RAWKBD	For the libvga driver: If set, do not attempt to put the keyboard in raw mode.
SDL_NOMOUSE	If set, the linux fbcon driver will not use a mouse at all.

Audio

AUDIODEV	The audio device to use, if SDL_PATH_DSP isn't set.
SDL_AUDIODRIVER	Selects the audio driver for SDL to use. Possible values, in the order they are tried if this variable is not set: 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) (all; output to file)
SDL_DISKAUDIOFILE	The name of the output file for the "disk" audio driver. If not set, the name sdlaudio.raw is used.
SDL_DISKAUDIODELAY	For the "disk" audio driver, how long to wait (in ms) before writing a full sound buffer. The default is 150 ms.
SDL_DSP_NOSELECT	For some audio drivers (alsa, paud, dma and dsp), don't use `select()` but a timed method instead. May cure some audio problems, or cause others.
SDL_PATH_DSP	The audio device to use. If not set, SDL tries AUDIODEV and then a platform-dependent default value (/dev/audio on Solaris, /dev/dsp on Linux etc).

CD-ROM

SDL_CDROM	A colon-separated list of CD-ROM devices to use, in addition to the standard devices (typically /dev/cdrom, platform-dependent).

Debugging

SDL_DEBUG	If set, causes every call to ["SDL_SetError"] (that is, every time SDL signals an error) to also print an error message on stderr.

Joystick

SDL_JOYSTICK_DEVICE	Joystick device to use in the linux joystick driver, in addition to the usual: /dev/js*, /dev/input/event*, /dev/input/js*
SDL_LINUX_JOYSTICK	Special joystick configuration string for linux. The format is: "name numaxes numhats numballs" where name is the name string of the joystick (possibly in single quotes), and the rest are the number of axes, hats and balls respectively.

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.