SDL envvars: Unterschied zwischen den Versionen

Aus DGL Wiki
Wechseln zu: Navigation, Suche
K
(Vollständig übersetzt.)
 
(2 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
{{Unvollständig}}
 
 
= SDL_envvars =
 
= SDL_envvars =
  
Zeile 28: Zeile 27:
 
{| {{Prettytable_B1}}
 
{| {{Prettytable_B1}}
 
!SDL_FBACCEL
 
!SDL_FBACCEL
|If set to 0, disable hardware acceleration in the linux fbcon driver.
+
|Wenn auf 0 gesetzt, wird die Hardwarebeschleunigung beim Linux fbcon Treiber deaktiviert.
 
|-
 
|-
 
!SDL_FBDEV
 
!SDL_FBDEV
|Frame buffer device to use in the linux fbcon driver, instead of /dev/fb0
+
|Welches Frame-Buffer-Device vom Linux fbcon Treiber benutzt werden soll. Standard ist /dev/fb0
 
|-
 
|-
 
!SDL_FULLSCREEN_UPDATE
 
!SDL_FULLSCREEN_UPDATE
|In the ps2gs driver, sets the SDL_ASYNCBLIT flag on the display surface.
+
|Bei Benutzung des ps2gs Treibers wird das SDL_ASNCBLIT Flag in der Displaysurface gesetzt.
 
|-
 
|-
 
!SDL_VIDEODRIVER
 
!SDL_VIDEODRIVER
|Selects the video driver for SDL to use. Possible values, in the order they are tried if this variable is not set:
+
|Bestimmt welcher Videotreiber von SDL benutzt werden soll. Möglich Werte sind:
 
   {| {{Prettytable_B1}}
 
   {| {{Prettytable_B1}}
 
   !x11
 
   !x11
Zeile 119: Zeile 118:
 
|-
 
|-
 
!SDL_VIDEO_CENTERED
 
!SDL_VIDEO_CENTERED
|If set, tries to center the SDL window when running in X11 windowed mode, or using the CyberGrafix driver.
+
|Wenn gesetzt versucht SDL das Fenster unter X11 in das Zentrum des Bildschirms zu setzen.
 
|-
 
|-
 
!SDL_VIDEO_GL_DRIVER
 
!SDL_VIDEO_GL_DRIVER
|The openGL driver (shared library) to use for X11. Default is libGL.so.1
+
|Der OpenGL-Treiber der von X11 benutzt. Standard ist libGL.so.1.
 
|-
 
|-
 
!SDL_VIDEO_X11_DGAMOUSE
 
!SDL_VIDEO_X11_DGAMOUSE
|With XFree86, enables use of DGA mouse if set.
+
|Unter XFree86 wird die DGA-Maus benutzt, wenn es aktiviert wird.
 
|-
 
|-
 
!SDL_VIDEO_X11_MOUSEACCEL
 
!SDL_VIDEO_X11_MOUSEACCEL
|For X11, sets the mouse acceleration. The value should be a string on the form:
+
|Setzt unter X11 die Mausbeschleunigung. Der Wert soll ein String in folgender Form sein:
  
 
`"n/d/t"`
 
`"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).
+
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
|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.
+
|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 of an X11 visual to use, overriding SDL's default visual selection algorithm. It can be in decimal or in hex (prefixed by 0x).
+
|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
|If set, display YUV overlay directly on the video surface if possible, instead of on the surface passed to ["SDL_CreateYUVOverlay"].
+
|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
|If not set or set to a nonzero value, SDL will attempt to use hardware YUV acceleration for video playback.
+
|Falls nicht gesetzt oder mit einem nichtnegativen Wert belegt, versucht SDL YUV Hardwarebeschleunigung für das Video abspielen zu benutzen.
 
|-
 
|-
 
!SDL_WINDOWID
 
!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).
+
|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.
 
|}
 
|}
  
Zeile 153: Zeile 152:
 
{| {{Prettytable_B1}}
 
{| {{Prettytable_B1}}
 
!SDL_MOUSE_RELATIVE
 
!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.
+
|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
|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).
+
|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
|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.
+
|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
|For the linux fbcon driver: if set to ELO, use the ELO touchscreen controller as a pointer device
+
|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
|For the libvga driver: If set, do not attempt to put the keyboard in raw mode.
+
|Für den libvga Treiber: Falls es gesetzt wurde wird nicht versucht den Tastaturinput im Raw Modus einzulesen.
 
|-
 
|-
 
!SDL_NOMOUSE
 
!SDL_NOMOUSE
|If set, the linux fbcon driver will not use a mouse at all.
+
|Falls gesetzt wird der Linux fbcon Treiber überhaupt keine Maus benutzen.
 
|}
 
|}
  
Zeile 174: Zeile 173:
 
{| {{Prettytable_B1}}
 
{| {{Prettytable_B1}}
 
!AUDIODEV
 
!AUDIODEV
|The audio device to use, if SDL_PATH_DSP isn't set.
+
|Das Audiogerät welches benutzt werden soll falls SDL_PATH_DSP nicht gesetzt ist.
 
|-
 
|-
 
!SDL_AUDIODRIVER
 
!SDL_AUDIODRIVER
|Selects the audio driver for SDL to use. Possible values, in the order they are tried if this variable is not set:
+
|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 224: Zeile 223:
 
   |(Amiga)
 
   |(Amiga)
 
   |-
 
   |-
   !disk|(all; output to file)
+
   !disk
 +
  |(all; output to file)
 
   |}
 
   |}
 
|-
 
|-
 
!SDL_DISKAUDIOFILE
 
!SDL_DISKAUDIOFILE
|The name of the output file for the "disk" audio driver. If not set, the name sdlaudio.raw is used.
+
|Der Name der Ausgabedatei für den "disk" Audiotreiber. Falls nicht gesetzt wird ''sdlaudio.raw'' benutzt.
 
|-
 
|-
 
!SDL_DISKAUDIODELAY
 
!SDL_DISKAUDIODELAY
|For the "disk" audio driver, how long to wait (in ms) before writing a full sound buffer. The default is 150 ms.
+
|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
|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.
+
|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
|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).
+
|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}}
 
{| {{Prettytable_B1}}
 
!SDL_CDROM
 
!SDL_CDROM
|A colon-separated list of CD-ROM devices to use, in addition to the standard devices (typically /dev/cdrom, platform-dependent).
+
|Eine mit Doppelpunkten abgetrennte Liste von CD-ROM Geräten welche zusätzlich zu den Standardgeräten benutzt werden sollen.
 
|}
 
|}
 
=== Debugging ===
 
=== Debugging ===
 
{| {{Prettytable_B1}}
 
{| {{Prettytable_B1}}
 
!SDL_DEBUG
 
!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.
+
|Falls gesetzt verursacht jeder Aufruf von [[SDL_SetError]] eine Ausgabe auf stderr.
 
|}
 
|}
 
=== Joystick ===
 
=== Joystick ===
 
{| {{Prettytable_B1}}
 
{| {{Prettytable_B1}}
 
!SDL_JOYSTICK_DEVICE
 
!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*  
+
|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
|Special joystick configuration string for linux. The format is:
+
|Spezieller Joystickkonfigurationsstring für Linux. Das Format ist:
  
 
"name numaxes numhats numballs"
 
"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.
+
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

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.