Mercurial > sdl-ios-xcode
view docs/html/sdlsyswmevent.html @ 2866:e532417a6977
Fixed SDL 1.2 compatibility problem.
The API specifies that SDL_OpenAudio() will fill out the 'desired' audio spec
with the correct samples and size set by the driver. This value is important
since it may be used by applications that size audio buffers, etc.
However, we want to allow advanced applications to call SDL_OpenAudioDevice()
which gets passed a const 'desired' parameter, and have the correct data filled
into the 'obtained' parameter, possibly allowing or not allowing format changes.
So... 'obtained' becomes the audio format the user callback is expected to use,
and we add flags to allow the application to specify which format changes are
allowed.
Note: We really need to add a way to query the 'obtained' audio spec.
author | Sam Lantinga <slouken@libsdl.org> |
---|---|
date | Sat, 13 Dec 2008 06:36:47 +0000 |
parents | 355632dca928 |
children |
line wrap: on
line source
<HTML ><HEAD ><TITLE >SDL_SysWMEvent</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ "><LINK REL="HOME" TITLE="SDL Library Documentation" HREF="index.html"><LINK REL="UP" TITLE="SDL Event Structures." HREF="eventstructures.html"><LINK REL="PREVIOUS" TITLE="SDL_ExposeEvent" HREF="sdlexposeevent.html"><LINK REL="NEXT" TITLE="SDL_UserEvent" HREF="sdluserevent.html"></HEAD ><BODY CLASS="REFENTRY" BGCOLOR="#FFF8DC" TEXT="#000000" LINK="#0000ee" VLINK="#551a8b" ALINK="#ff0000" ><DIV CLASS="NAVHEADER" ><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="3" ALIGN="center" >SDL Library Documentation</TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="bottom" ><A HREF="sdlexposeevent.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="80%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="10%" ALIGN="right" VALIGN="bottom" ><A HREF="sdluserevent.html" ACCESSKEY="N" >Next</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><H1 ><A NAME="SDLSYSWMEVENT" ></A >SDL_SysWMEvent</H1 ><DIV CLASS="REFNAMEDIV" ><A NAME="AEN4538" ></A ><H2 >Name</H2 >SDL_SysWMEvent -- Platform-dependent window manager event.</DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN4541" ></A ><H2 >Description</H2 ><P >The system window manager event contains a pointer to system-specific information about unknown window manager events. If you enable this event using <A HREF="sdleventstate.html" ><TT CLASS="FUNCTION" >SDL_EventState()</TT ></A >, it will be generated whenever unhandled events are received from the window manager. This can be used, for example, to implement cut-and-paste in your application. <PRE CLASS="PROGRAMLISTING" >typedef struct { Uint8 type; /* Always SDL_SYSWMEVENT */ SDL_SysWMmsg *msg; } SDL_SysWMEvent;</PRE > If you want to obtain system-specific information about the window manager, you can fill the version member of a <SPAN CLASS="STRUCTNAME" >SDL_SysWMinfo</SPAN > structure (details can be found in <TT CLASS="FILENAME" >SDL_syswm.h</TT >, which must be included) using the <TT CLASS="FUNCTION" >SDL_VERSION()</TT > macro found in <TT CLASS="FILENAME" >SDL_version.h</TT >, and pass it to the function: <DIV CLASS="FUNCSYNOPSIS" ><A NAME="AEN4551" ></A ><P ></P ><P ><CODE ><CODE CLASS="FUNCDEF" >int <B CLASS="FSFUNC" >SDL_GetWMInfo</B ></CODE >(SDL_SysWMinfo *info);</CODE ></P ><P ></P ></DIV ></P ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN4556" ></A ><H2 >See Also</H2 ><P ><A HREF="sdleventstate.html" ><TT CLASS="FUNCTION" >SDL_EventState</TT ></A ></P ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="sdlexposeevent.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="index.html" ACCESSKEY="H" >Home</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="sdluserevent.html" ACCESSKEY="N" >Next</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >SDL_ExposeEvent</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="eventstructures.html" ACCESSKEY="U" >Up</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >SDL_UserEvent</TD ></TR ></TABLE ></DIV ></BODY ></HTML >