📄 sdlenvvars.html
字号:
<HTML><HEAD><TITLE>SDL_envvars</TITLE><METANAME="GENERATOR"CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+"><LINKREL="HOME"TITLE="SDL Library Documentation"HREF="index.html"><LINKREL="UP"TITLE="General"HREF="general.html"><LINKREL="PREVIOUS"TITLE="SDL_GetError"HREF="sdlgeterror.html"><LINKREL="NEXT"TITLE="Video"HREF="video.html"></HEAD><BODYCLASS="REFENTRY"BGCOLOR="#FFF8DC"TEXT="#000000"LINK="#0000ee"VLINK="#551a8b"ALINK="#ff0000"><DIVCLASS="NAVHEADER"><TABLESUMMARY="Header navigation table"WIDTH="100%"BORDER="0"CELLPADDING="0"CELLSPACING="0"><TR><THCOLSPAN="3"ALIGN="center">SDL Library Documentation</TH></TR><TR><TDWIDTH="10%"ALIGN="left"VALIGN="bottom"><AHREF="sdlgeterror.html"ACCESSKEY="P">Prev</A></TD><TDWIDTH="80%"ALIGN="center"VALIGN="bottom"></TD><TDWIDTH="10%"ALIGN="right"VALIGN="bottom"><AHREF="video.html"ACCESSKEY="N">Next</A></TD></TR></TABLE><HRALIGN="LEFT"WIDTH="100%"></DIV><H1><ANAME="SDLENVVARS"></A>SDL_envvars</H1><DIVCLASS="REFNAMEDIV"><ANAME="AEN675"></A><H2>Name</H2>SDL_envvars -- SDL environment variables</DIV><DIVCLASS="REFSECT1"><ANAME="AEN678"></A><H2>Description</H2><P>Not a function, set using setenv()</P><P>Several environment variables are available to modify thebehaviour of SDL. Using these variables isn't recommened and the namesand presence of these variables aren't guaranteed from one release tothe next. However, they can be very useful for debuggingpurposes.</P></DIV><DIVCLASS="REFSECT1"><ANAME="AEN682"></A><H2>Video</H2><P></P><DIVCLASS="VARIABLELIST"><DL><DT><TTCLASS="LITERAL">SDL_FBACCEL</TT></DT><DD><P>If set to 0, disable hardware acceleration in the linux fbcon driver.</P></DD><DT><TTCLASS="LITERAL">SDL_FBDEV</TT></DT><DD><P>Frame buffer device to use in the linux fbcon driver, instead of /dev/fb0</P></DD><DT><TTCLASS="LITERAL">SDL_FULLSCREEN_UPDATE</TT></DT><DD><P>In the ps2gs driver, sets the <TTCLASS="LITERAL">SDL_ASYNCBLIT</TT> flag on thedisplay surface.</P></DD><DT><TTCLASS="LITERAL">SDL_VIDEODRIVER</TT></DT><DD><P>Selectes the video driver for SDL to use. Possible values, in theorder they are tried if this variable is not set:</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN706"></A><P></P><TABLEBORDER="0"CLASS="CALSTABLE"><TBODY><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="LITERAL">x11</TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P></P></TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="LITERAL">dga</TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P>(the XFree86 DGA2)</P></TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="LITERAL">nanox</TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P>(Linux)</P></TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="LITERAL">fbcon</TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P>(Linux)</P></TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="LITERAL">directfb</TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P>(Linux)</P></TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="LITERAL">ps2gs</TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P>(Playstation 2)</P></TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="LITERAL">ggi</TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P></P></TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="LITERAL">vgl</TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P>(BSD)</P></TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="LITERAL">svgalib</TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P>(Linux)</P></TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="LITERAL">aalib</TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P></P></TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="LITERAL">directx</TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P>(Win32)</P></TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="LITERAL">windib</TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P>(Win32)</P></TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="LITERAL">bwindow</TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P>(BeOS)</P></TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="LITERAL">toolbox</TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P>(MacOS Classic)</P></TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="LITERAL">DSp</TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P>(MacOS Classic)</P></TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="LITERAL">Quartz</TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P>(Mac OS X)</P></TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="LITERAL">CGX</TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P>(Amiga)</P></TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="LITERAL">photon</TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P>(QNX)</P></TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="LITERAL">epoc</TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P>(Epoc)</P></TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="LITERAL">dummy</TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P></P></TD></TR></TBODY></TABLE><P></P></DIV></DD><DT><TTCLASS="LITERAL">SDL_VIDEO_CENTERED</TT></DT><DD><P>If set, tries to center the SDL window when running in X11 windowedmode, or using the CyberGrafix driver.</P></DD><DT><TTCLASS="LITERAL">SDL_VIDEO_GL_DRIVER</TT></DT><DD><P>The openGL driver (shared library) to use for X11. Default is libGL.so.1</P></DD><DT><TTCLASS="LITERAL">SDL_VIDEO_X11_DGAMOUSE</TT></DT><DD><P>With XFree86, enables use of DGA mouse if set.</P></DD><DT><TTCLASS="LITERAL">SDL_VIDEO_X11_MOUSEACCEL</TT></DT><DD><P>For X11, sets the mouse acceleration. The value should be a stringon the form:</P><P>"<TTCLASS="PARAMETER"><I>n</I></TT>/<TTCLASS="PARAMETER"><I>d</I></TT>/<TTCLASS="PARAMETER"><I>t</I></TT>"</P><P>where <TTCLASS="PARAMETER"><I>n</I></TT> and <TTCLASS="PARAMETER"><I>d</I></TT> are theacceleration numerator/denumerators (so mouse movement is accelerated by<TTCLASS="PARAMETER"><I>n</I></TT>/<TTCLASS="PARAMETER"><I>d</I></TT>), and<TTCLASS="PARAMETER"><I>t</I></TT> is the threshold above which acceleration applies(counted as number of pixels the mouse moves at once).</P></DD><DT><TTCLASS="LITERAL">SDL_VIDEO_X11_NODIRECTCOLOR</TT></DT><DD><P>If set, don't attempt to use DirectColor visuals even if they arepresent. (SDL will use them otherwise for gamma correction).This is needed with older X servers when using the XVideo extension.</P></DD><DT><TTCLASS="LITERAL">SDL_VIDEO_X11_VISUALID</TT></DT><DD><P>ID of an X11 visual to use, overriding SDL's default visual selectionalgorithm. It can be in decimal or in hex (prefixed by 0x).</P></DD><DT><TTCLASS="LITERAL">SDL_VIDEO_YUV_DIRECT</TT></DT><DD><P>If set, display YUV overlay directly on the video surface if possible,instead of on the surface passed to<AHREF="sdlcreateyuvoverlay.html"><TTCLASS="FUNCTION">SDL_CreateYUVOverlay</TT></A>.</P></DD><DT><TTCLASS="LITERAL">SDL_VIDEO_YUV_HWACCEL</TT></DT><DD><P>If not set or set to a nonzero value, SDL will attempt to usehardware YUV acceleration for video playback.</P></DD><DT><TTCLASS="LITERAL">SDL_WINDOWID</TT></DT><DD><P>For X11 or Win32, contains the ID number of the window to be used bySDL instead of creating its own window. Either in decimal orin hex (prefixed by 0x).</P></DD></DL></DIV></DIV><DIVCLASS="REFSECT1"><ANAME="AEN866"></A><H2>Events/Input</H2><P></P><DIVCLASS="VARIABLELIST"><DL><DT><TTCLASS="LITERAL">SDL_MOUSE_RELATIVE</TT></DT><DD><P>If set to 0, do not use mouse relative mode in X11. The default isto use it if the mouse is hidden and input is grabbed.</P></DD><DT><TTCLASS="LITERAL">SDL_MOUSEDEV</TT></DT><DD><P>The mouse device to use for the linux fbcon driver. If not set,SDL first tries to use GPM in repeater mode, then various otherdevices (/dev/pcaux, /dev/adbmouse, /dev/mouse etc).</P></DD><DT><TTCLASS="LITERAL">SDL_MOUSEDEV_IMPS2</TT></DT><DD><P>If set, SDL will not try to auto-detect the IMPS/2 protocol ofa PS/2 mouse but use it right away. For the fbcon and ps2gs drivers.</P></DD><DT><TTCLASS="LITERAL">SDL_MOUSEDRV</TT></DT><DD><P>For the linux fbcon driver: if set to ELO, use the ELO touchscreencontroller as a pointer device</P></DD><DT><TTCLASS="LITERAL">SDL_NO_RAWKBD</TT></DT><DD><P>For the libvga driver: If set, do not attempt to put the keyboard in raw mode.</P></DD><DT><TTCLASS="LITERAL">SDL_NOMOUSE</TT></DT><DD><P>If set, the linux fbcon driver will not use a mouse at all.</P></DD></DL></DIV></DIV><DIVCLASS="REFSECT1"><ANAME="AEN899"></A><H2>Audio</H2><P></P><DIVCLASS="VARIABLELIST"><DL><DT><TTCLASS="LITERAL">AUDIODEV</TT></DT><DD><P>The audio device to use, if <TTCLASS="LITERAL">SDL_PATH_DSP</TT> isn't set.</P></DD><DT><TTCLASS="LITERAL">SDL_AUDIODRIVER</TT></DT><DD><P>Selects the audio driver for SDL to use. Possible values, in theorder they are tried if this variable is not set:</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN913"></A><P></P><TABLEBORDER="0"CLASS="CALSTABLE"><TBODY><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="LITERAL">openbsd</TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P>(OpenBSD)</P></TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="LITERAL">dsp</TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P>(OSS /dev/dsp: Linux, Solaris, BSD etc)</P></TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="LITERAL">alsa</TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P>(Linux)</P></TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="LITERAL">audio</TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P>(Unix style /dev/audio: SunOS, Solaris etc)</P></TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="LITERAL">AL</TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P>(Irix)</P></TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="LITERAL">artsc</TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P>(ARTS audio daemon)</P></TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="LITERAL">esd</TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P>(esound audio daemon)</P></TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="LITERAL">nas</TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P>(NAS audio daemon)</P></TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="LITERAL">dma</TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P>(OSS /dev/dsp, using DMA)</P></TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="LITERAL">dsound</TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P>(Win32 DirectX)</P></TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="LITERAL">waveout</TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P>(Win32 WaveOut)</P></TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="LITERAL">baudio</TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P>(BeOS)</P></TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="LITERAL">sndmgr</TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P>(MacOS SoundManager)</P></TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="LITERAL">paud</TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P>(AIX)</P></TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="LITERAL">AHI</TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P>(Amiga)</P></TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="LITERAL">disk</TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P>(all; output to file)</P></TD></TR></TBODY></TABLE><P></P></DIV></DD><DT><TTCLASS="LITERAL">SDL_DISKAUDIOFILE</TT></DT><DD><P>The name of the output file for the "disk" audio driver. If notset, the name <TTCLASS="LITERAL">sdlaudio.raw</TT> is used.</P></DD><DT><TTCLASS="LITERAL">SDL_DISKAUDIODELAY</TT></DT><DD><P>For the "disk" audio driver, how long to wait (in ms) before writinga full sound buffer. The default is 150 ms.</P></DD><DT><TTCLASS="LITERAL">SDL_DSP_NOSELECT</TT></DT><DD><P>For some audio drivers (alsa, paud, dma and dsp), don't use select()but a timed method instead. May cure some audio problems, or causeothers.</P></DD><DT><TTCLASS="LITERAL">SDL_PATH_DSP</TT></DT><DD><P>The audio device to use. If not set, SDL tries AUDIODEV and thena platform-dependent default value (/dev/audio on Solaris,/dev/dsp on Linux etc).</P></DD></DL></DIV></DIV><DIVCLASS="REFSECT1"><ANAME="AEN1017"></A><H2>CD-ROM</H2><P></P><DIVCLASS="VARIABLELIST"><DL><DT><TTCLASS="LITERAL">SDL_CDROM</TT></DT><DD><P>A colon-separated list of CD-ROM devices to use, in addition tothe standard devices (typically /dev/cdrom, platform-dependent).</P></DD></DL></DIV></DIV><DIVCLASS="REFSECT1"><ANAME="AEN1025"></A><H2>Debugging</H2><P></P><DIVCLASS="VARIABLELIST"><DL><DT><TTCLASS="LITERAL">SDL_DEBUG</TT></DT><DD><P>If set, causes every call to <TTCLASS="FUNCTION">SDL_SetError</TT> (thatis, every time SDL signals an error) to also print an error message onstderr.</P></DD></DL></DIV></DIV><DIVCLASS="REFSECT1"><ANAME="AEN1034"></A><H2>Joystick</H2><P></P><DIVCLASS="VARIABLELIST"><DL><DT><TTCLASS="LITERAL">SDL_JOYSTICK_DEVICE</TT></DT><DD><P>Joystick device to use in the linux joystick driver, in additionto the usual: /dev/js*, /dev/input/event*, /dev/input/js*</P></DD><DT><TTCLASS="LITERAL">SDL_LINUX_JOYSTICK</TT></DT><DD><P>Special joystick configuration string for linux. The format is</P><P>"<TTCLASS="PARAMETER"><I>name</I></TT> <TTCLASS="PARAMETER"><I>numaxes</I></TT> <TTCLASS="PARAMETER"><I>numhats</I></TT> <TTCLASS="PARAMETER"><I>numballs</I></TT>"</P><P>where <TTCLASS="PARAMETER"><I>name</I></TT> is the name string of the joystick(possibly in single quotes), and the rest are the number of axes, hatsand balls respectively.</P></DD></DL></DIV></DIV><DIVCLASS="NAVFOOTER"><HRALIGN="LEFT"WIDTH="100%"><TABLESUMMARY="Footer navigation table"WIDTH="100%"BORDER="0"CELLPADDING="0"CELLSPACING="0"><TR><TDWIDTH="33%"ALIGN="left"VALIGN="top"><AHREF="sdlgeterror.html"ACCESSKEY="P">Prev</A></TD><TDWIDTH="34%"ALIGN="center"VALIGN="top"><AHREF="index.html"ACCESSKEY="H">Home</A></TD><TDWIDTH="33%"ALIGN="right"VALIGN="top"><AHREF="video.html"ACCESSKEY="N">Next</A></TD></TR><TR><TDWIDTH="33%"ALIGN="left"VALIGN="top">SDL_GetError</TD><TDWIDTH="34%"ALIGN="center"VALIGN="top"><AHREF="general.html"ACCESSKEY="U">Up</A></TD><TDWIDTH="33%"ALIGN="right"VALIGN="top">Video</TD></TR></TABLE></DIV></BODY></HTML>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -