📄 sdlloadwav.html
字号:
<HTML><HEAD><TITLE>SDL_LoadWAV</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="SDL_GetAudioStatus"HREF="sdlgetaudiostatus.html"><LINKREL="NEXT"TITLE="SDL_FreeWAV"HREF="sdlfreewav.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="sdlgetaudiostatus.html"ACCESSKEY="P">Prev</A></TD><TDWIDTH="80%"ALIGN="center"VALIGN="bottom"></TD><TDWIDTH="10%"ALIGN="right"VALIGN="bottom"><AHREF="sdlfreewav.html"ACCESSKEY="N">Next</A></TD></TR></TABLE><HRALIGN="LEFT"WIDTH="100%"></DIV><H1><ANAME="SDLLOADWAV"></A>SDL_LoadWAV</H1><DIVCLASS="REFNAMEDIV"><ANAME="AEN6816"></A><H2>Name</H2>SDL_LoadWAV -- Load a WAVE file</DIV><DIVCLASS="REFSYNOPSISDIV"><ANAME="AEN6819"></A><H2>Synopsis</H2><DIVCLASS="FUNCSYNOPSIS"><ANAME="AEN6820"></A><P></P><PRECLASS="FUNCSYNOPSISINFO">#include "SDL.h"</PRE><P><CODE><CODECLASS="FUNCDEF">SDL_AudioSpec *<BCLASS="FSFUNC">SDL_LoadWAV</B></CODE>(const char *file, SDL_AudioSpec *spec, Uint8 **audio_buf, Uint32 *audio_len);</CODE></P><P></P></DIV></DIV><DIVCLASS="REFSECT1"><ANAME="AEN6826"></A><H2>Description</H2><P><TTCLASS="FUNCTION">SDL_LoadWAV</TT>This function loads a WAVE <TTCLASS="PARAMETER"><I>file</I></TT> into memory.</P><P>If this function succeeds, it returns the given <AHREF="sdlaudiospec.html"><TTCLASS="FUNCTION">SDL_AudioSpec</TT></A>, filled with the audio data format of the wave data, and sets <TTCLASS="PARAMETER"><I>audio_buf</I></TT> to a <TTCLASS="FUNCTION">malloc</TT>'d buffer containing the audio data, and sets <TTCLASS="PARAMETER"><I>audio_len</I></TT> to the length of that audio buffer, in bytes. You need to free the audio buffer with <AHREF="sdlfreewav.html"><TTCLASS="FUNCTION">SDL_FreeWAV</TT></A> when you aredone with it.</P><P>This function returns <TTCLASS="LITERAL">NULL</TT> and sets the SDL error message if the wave file cannot be opened, uses an unknown data format, or is corrupt. Currently raw, MS-ADPCM and IMA-ADPCM WAVE files are supported.</P></DIV><DIVCLASS="REFSECT1"><ANAME="AEN6841"></A><H2>Example</H2><PRECLASS="PROGRAMLISTING">SDL_AudioSpec wav_spec;Uint32 wav_length;Uint8 *wav_buffer;/* Load the WAV */if( SDL_LoadWAV("test.wav", &wav_spec, &wav_buffer, &wav_length) == NULL ){ fprintf(stderr, "Could not open test.wav: %s\n", SDL_GetError()); exit(-1);}.../* Do stuff with the WAV */../* Free It */SDL_FreeWAV(wav_buffer);</PRE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN6844"></A><H2>See Also</H2><P><AHREF="sdlaudiospec.html"><SPANCLASS="STRUCTNAME">SDL_AudioSpec</SPAN></A>,<AHREF="sdlopenaudio.html"><TTCLASS="FUNCTION">SDL_OpenAudio</TT></A>,<AHREF="sdlfreewav.html"><TTCLASS="FUNCTION">SDL_FreeWAV</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="sdlgetaudiostatus.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="sdlfreewav.html"ACCESSKEY="N">Next</A></TD></TR><TR><TDWIDTH="33%"ALIGN="left"VALIGN="top">SDL_GetAudioStatus</TD><TDWIDTH="34%"ALIGN="center"VALIGN="top"><AHREF="audio.html"ACCESSKEY="U">Up</A></TD><TDWIDTH="33%"ALIGN="right"VALIGN="top">SDL_FreeWAV</TD></TR></TABLE></DIV></BODY></HTML>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -