📄 sdlaudiospec.html

📁 VC5.6.7的一个扩展库。跟DirectX的功能差不多。
💻 HTML
字号:
<HTML><HEAD><TITLE>SDL_AudioSpec</TITLE><METANAME="GENERATOR"CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+"><LINKREL="HOME"TITLE="SDL Library Documentation"HREF="index.html"><LINKREL="UP"TITLE="Audio"HREF="audio.html"><LINKREL="PREVIOUS"TITLE="Audio"HREF="audio.html"><LINKREL="NEXT"TITLE="SDL_OpenAudio"HREF="sdlopenaudio.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="audio.html"ACCESSKEY="P">Prev</A></TD><TDWIDTH="80%"ALIGN="center"VALIGN="bottom"></TD><TDWIDTH="10%"ALIGN="right"VALIGN="bottom"><AHREF="sdlopenaudio.html"ACCESSKEY="N">Next</A></TD></TR></TABLE><HRALIGN="LEFT"WIDTH="100%"></DIV><H1><ANAME="SDLAUDIOSPEC"></A>SDL_AudioSpec</H1><DIVCLASS="REFNAMEDIV"><ANAME="AEN6507"></A><H2>Name</H2>SDL_AudioSpec&nbsp;--&nbsp;Audio Specification Structure</DIV><DIVCLASS="REFSECT1"><ANAME="AEN6510"></A><H2>Structure Definition</H2><PRECLASS="PROGRAMLISTING">typedef struct{  int freq;  Uint16 format;  Uint8 channels;  Uint8 silence;  Uint16 samples;  Uint32 size;  void (*callback)(void *userdata, Uint8 *stream, int len);  void *userdata;} SDL_AudioSpec;</PRE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN6513"></A><H2>Structure Data</H2><DIVCLASS="INFORMALTABLE"><ANAME="AEN6515"></A><P></P><TABLEBORDER="0"CLASS="CALSTABLE"><TBODY><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="STRUCTFIELD"><I>freq</I></TT></TD><TDALIGN="LEFT"VALIGN="TOP">Audio frequency in samples per second</TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="STRUCTFIELD"><I>format</I></TT></TD><TDALIGN="LEFT"VALIGN="TOP">Audio data format</TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="STRUCTFIELD"><I>channels</I></TT></TD><TDALIGN="LEFT"VALIGN="TOP">Number of channels: 1 mono, 2 stereo</TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="STRUCTFIELD"><I>silence</I></TT></TD><TDALIGN="LEFT"VALIGN="TOP">Audio buffer silence value (calculated)</TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="STRUCTFIELD"><I>samples</I></TT></TD><TDALIGN="LEFT"VALIGN="TOP">Audio buffer size in samples</TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="STRUCTFIELD"><I>size</I></TT></TD><TDALIGN="LEFT"VALIGN="TOP">Audio buffer size in bytes (calculated)</TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="STRUCTFIELD"><I>callback(..)</I></TT></TD><TDALIGN="LEFT"VALIGN="TOP">Callback function for filling the audio buffer</TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="STRUCTFIELD"><I>userdata</I></TT></TD><TDALIGN="LEFT"VALIGN="TOP">Pointer the user data which is passed to the callback function</TD></TR></TBODY></TABLE><P></P></DIV></DIV><DIVCLASS="REFSECT1"><ANAME="AEN6550"></A><H2>Description</H2><P>The <SPANCLASS="STRUCTNAME">SDL_AudioSpec</SPAN> structure is used to describe the format of some audio data. This structure is used by <AHREF="sdlopenaudio.html"><TTCLASS="FUNCTION">SDL_OpenAudio</TT></A> and <AHREF="sdlloadwav.html"><TTCLASS="FUNCTION">SDL_LoadWAV</TT></A>. While all fields are used by <TTCLASS="FUNCTION">SDL_OpenAudio</TT> only <TTCLASS="STRUCTFIELD"><I>freq</I></TT>, <TTCLASS="STRUCTFIELD"><I>format</I></TT>, <TTCLASS="STRUCTFIELD"><I>samples</I></TT> and <TTCLASS="STRUCTFIELD"><I>channels</I></TT> are used by <TTCLASS="FUNCTION">SDL_LoadWAV</TT>. We will detail these common members here.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN6564"></A><P></P><TABLEBORDER="0"CLASS="CALSTABLE"><TBODY><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="STRUCTFIELD"><I>freq</I></TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P>The number of samples sent to the sound device every second. Common values are 11025, 22050 and 44100. The higher the better.</P></TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="STRUCTFIELD"><I>format</I></TT></TD><TDALIGN="LEFT"VALIGN="TOP"><P>Specifies the size and type of each sample element<P></P><DIVCLASS="VARIABLELIST"><DL><DT><TTCLASS="LITERAL">AUDIO_U8</TT></DT><DD><P>Unsigned 8-bit samples</P></DD><DT><TTCLASS="LITERAL">AUDIO_S8</TT></DT><DD><P>Signed 8-bit samples</P></DD><DT><TTCLASS="LITERAL">AUDIO_U16</TT> or <TTCLASS="LITERAL">AUDIO_U16LSB</TT></DT><DD><P>Unsigned 16-bit little-endian samples</P></DD><DT><TTCLASS="LITERAL">AUDIO_S16</TT> or <TTCLASS="LITERAL">AUDIO_S16LSB</TT></DT><DD><P>Signed 16-bit little-endian samples</P></DD><DT><TTCLASS="LITERAL">AUDIO_U16MSB</TT></DT><DD><P>Unsigned 16-bit big-endian samples</P></DD><DT><TTCLASS="LITERAL">AUDIO_S16MSB</TT></DT><DD><P>Signed 16-bit big-endian samples</P></DD><DT><TTCLASS="LITERAL">AUDIO_U16SYS</TT></DT><DD><P>Either <TTCLASS="LITERAL">AUDIO_U16LSB</TT> or <TTCLASS="LITERAL">AUDIO_U16MSB</TT> depending on you systems endianness</P></DD><DT><TTCLASS="LITERAL">AUDIO_S16SYS</TT></DT><DD><P>Either <TTCLASS="LITERAL">AUDIO_S16LSB</TT> or <TTCLASS="LITERAL">AUDIO_S16MSB</TT> depending on you systems endianness</P></DD></DL></DIV></P></TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="STRUCTFIELD"><I>channels</I></TT></TD><TDALIGN="LEFT"VALIGN="TOP">The number of seperate sound channels. 1 is mono (single channel), 2 is stereo (dual channel).</TD></TR><TR><TDALIGN="LEFT"VALIGN="TOP"><TTCLASS="STRUCTFIELD"><I>samples</I></TT></TD><TDALIGN="LEFT"VALIGN="TOP">When used with <AHREF="sdlopenaudio.html"><TTCLASS="FUNCTION">SDL_OpenAudio</TT></A> this refers to the size of the audio buffer in samples. A sample a chunk of audio data of the size specified in <TTCLASS="PARAMETER"><I>format</I></TT> mulitplied by the number of channels. When the <SPANCLASS="STRUCTNAME">SDL_AudioSpec</SPAN> is used with <AHREF="sdlloadwav.html"><TTCLASS="FUNCTION">SDL_LoadWAV</TT></A> <TTCLASS="STRUCTFIELD"><I>samples</I></TT> is set to 4096.</TD></TR></TBODY></TABLE><P></P></DIV></DIV><DIVCLASS="REFSECT1"><ANAME="AEN6639"></A><H2>See Also</H2><P><AHREF="sdlopenaudio.html"><TTCLASS="FUNCTION">SDL_OpenAudio</TT></A>,<AHREF="sdlloadwav.html"><TTCLASS="FUNCTION">SDL_LoadWAV</TT></A></P></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="audio.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="sdlopenaudio.html"ACCESSKEY="N">Next</A></TD></TR><TR><TDWIDTH="33%"ALIGN="left"VALIGN="top">Audio</TD><TDWIDTH="34%"ALIGN="center"VALIGN="top"><AHREF="audio.html"ACCESSKEY="U">Up</A></TD><TDWIDTH="33%"ALIGN="right"VALIGN="top">SDL_OpenAudio</TD></TR></TABLE></DIV></BODY></HTML>
⌨️ 快捷键说明

复制代码 Ctrl + C
搜索代码 Ctrl + F
全屏模式 F11
切换主题 Ctrl + Shift + D
显示快捷键 ?
增大字号 Ctrl + =
减小字号 Ctrl + -