7 CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
10 TITLE="SDL Library Documentation"
11 HREF="index.html"><LINK
14 HREF="general.html"><LINK
17 HREF="sdlgeterror.html"><LINK
20 HREF="video.html"></HEAD
31 SUMMARY="Header navigation table"
40 >SDL Library Documentation</TH
48 HREF="sdlgeterror.html"
83 >SDL_envvars -- SDL environment variables</DIV
92 >Not a function, set using setenv()</P
94 >Several environment variables are available to modify the
95 behaviour of SDL. Using these variables isn't recommened and the names
96 and presence of these variables aren't guaranteed from one release to
97 the next. However, they can be very useful for debugging
119 >If set to 0, disable hardware acceleration in the linux fbcon driver.</P
128 >Frame buffer device to use in the linux fbcon driver, instead of /dev/fb0</P
133 >SDL_FULLSCREEN_UPDATE</TT
137 >In the ps2gs driver, sets the <TT
150 >Selectes the video driver for SDL to use. Possible values, in the
151 order they are tried if this variable is not set:</P
153 CLASS="INFORMALTABLE"
190 >(the XFree86 DGA2)</P
457 >SDL_VIDEO_CENTERED</TT
461 >If set, tries to center the SDL window when running in X11 windowed
462 mode, or using the CyberGrafix driver.</P
467 >SDL_VIDEO_GL_DRIVER</TT
471 >The openGL driver (shared library) to use for X11. Default is libGL.so.1</P
476 >SDL_VIDEO_X11_DGAMOUSE</TT
480 >With XFree86, enables use of DGA mouse if set.</P
485 >SDL_VIDEO_X11_MOUSEACCEL</TT
489 >For X11, sets the mouse acceleration. The value should be a string
520 acceleration numerator/denumerators (so mouse movement is accelerated by
537 > is the threshold above which acceleration applies
538 (counted as number of pixels the mouse moves at once).</P
543 >SDL_VIDEO_X11_NODIRECTCOLOR</TT
547 >If set, don't attempt to use DirectColor visuals even if they are
548 present. (SDL will use them otherwise for gamma correction).
549 This is needed with older X servers when using the XVideo extension.</P
554 >SDL_VIDEO_X11_VISUALID</TT
558 >ID of an X11 visual to use, overriding SDL's default visual selection
559 algorithm. It can be in decimal or in hex (prefixed by 0x).</P
564 >SDL_VIDEO_YUV_DIRECT</TT
568 >If set, display YUV overlay directly on the video surface if possible,
569 instead of on the surface passed to
571 HREF="sdlcreateyuvoverlay.html"
574 >SDL_CreateYUVOverlay</TT
581 >SDL_VIDEO_YUV_HWACCEL</TT
585 >If not set or set to a nonzero value, SDL will attempt to use
586 hardware YUV acceleration for video playback.</P
595 >For X11 or Win32, contains the ID number of the window to be used by
596 SDL instead of creating its own window. Either in decimal or
597 in hex (prefixed by 0x).</P
617 >SDL_MOUSE_RELATIVE</TT
621 >If set to 0, do not use mouse relative mode in X11. The default is
622 to use it if the mouse is hidden and input is grabbed.</P
631 >The mouse device to use for the linux fbcon driver. If not set,
632 SDL first tries to use GPM in repeater mode, then various other
633 devices (/dev/pcaux, /dev/adbmouse, /dev/mouse etc).</P
638 >SDL_MOUSEDEV_IMPS2</TT
642 >If set, SDL will not try to auto-detect the IMPS/2 protocol of
643 a PS/2 mouse but use it right away. For the fbcon and ps2gs drivers.</P
652 >For the linux fbcon driver: if set to ELO, use the ELO touchscreen
653 controller as a pointer device</P
662 >For the libvga driver: If set, do not attempt to put the keyboard in raw mode.</P
671 >If set, the linux fbcon driver will not use a mouse at all.</P
676 >SDL_NO_LOCK_KEYS</TT
680 >Disable CAPS-LOCK and NUM-LOCK suppression of down+up key events,
681 suitable for games where the player needs these keys to do more than just toggle.
682 A value of 1 will effect both CAPS-LOCK and NUM-LOCK.
683 A value of 2 will effect only CAPS-LOCK.
684 A value of 3 will effect only NUM-LOCK.
685 All other values have no effect.
710 >The audio device to use, if <TT
722 >Selects the audio driver for SDL to use. Possible values, in the
723 order they are tried if this variable is not set:</P
725 CLASS="INFORMALTABLE"
762 >(OSS /dev/dsp: Linux, Solaris, BSD etc)</P
792 >(PulseAudio daemon)</P
807 >(Unix style /dev/audio: SunOS, Solaris etc)</P
837 >(ARTS audio daemon)</P
852 >(esound audio daemon)</P
867 >(NAS audio daemon)</P
882 >(OSS /dev/dsp, using DMA)</P
942 >(MacOS SoundManager)</P
987 >(all; output to file)</P
999 >SDL_DISKAUDIOFILE</TT
1003 >The name of the output file for the "disk" audio driver. If not
1012 >SDL_DISKAUDIODELAY</TT
1016 >For the "disk" audio driver, how long to wait (in ms) before writing
1017 a full sound buffer. The default is 150 ms.</P
1022 >SDL_DSP_NOSELECT</TT
1026 >For some audio drivers (alsa, paud, dma and dsp), don't use select()
1027 but a timed method instead. May cure some audio problems, or cause
1037 >The audio device to use. If not set, SDL tries AUDIODEV and then
1038 a platform-dependent default value (/dev/audio on Solaris,
1039 /dev/dsp on Linux etc).</P
1054 CLASS="VARIABLELIST"
1063 >A colon-separated list of CD-ROM devices to use, in addition to
1064 the standard devices (typically /dev/cdrom, platform-dependent).</P
1079 CLASS="VARIABLELIST"
1088 >If set, causes every call to <TT
1092 is, every time SDL signals an error) to also print an error message on
1108 CLASS="VARIABLELIST"
1113 >SDL_JOYSTICK_DEVICE</TT
1117 >Joystick device to use in the linux joystick driver, in addition
1118 to the usual: /dev/js*, /dev/input/event*, /dev/input/js*</P
1123 >SDL_LINUX_JOYSTICK</TT
1127 >Special joystick configuration string for linux. The format is</P
1156 > is the name string of the joystick
1157 (possibly in single quotes), and the rest are the number of axes, hats
1158 and balls respectively.</P
1168 SUMMARY="Footer navigation table"
1179 HREF="sdlgeterror.html"