Details | Last modification | View Log | RSS feed
Rev | Author | Line No. | Line |
---|---|---|---|
646 | serge | 1 | /* |
2 | uFMOD AC97SND codec header file |
||
3 | Target OS: KolibriOS |
||
4 | Compiler: Visual C |
||
5 | |||
6 | NOTE: ufmod.obj should be rebuilt setting UF_MODE=AC97SND |
||
7 | in order to make it usable in AC97SND player. |
||
8 | |||
9 | The Infinity Sound driver handle should be available as |
||
10 | a public symbol named hSound. It is so when using Serge's |
||
11 | sound.lib. |
||
12 | */ |
||
13 | |||
14 | #ifdef __cplusplus |
||
15 | extern "C" { |
||
16 | #endif |
||
17 | |||
18 | /* HANDLE uFMOD_LoadSong(char *lpXM); |
||
19 | --- |
||
20 | Description: |
||
21 | --- |
||
22 | Loads the given XM song and starts playing it as soon as you |
||
23 | call uFMOD_WaveOut for the first time. It will stop any |
||
24 | currently playing song before loading the new one. Heap should |
||
25 | be initialized before calling this function! |
||
26 | --- |
||
27 | Parameters: |
||
28 | --- |
||
29 | lpXM |
||
30 | Specifies the filename of the song to load. |
||
31 | --- |
||
32 | Return Values: |
||
33 | --- |
||
34 | On success, returns a non zero value. Returns 0 on failure. |
||
35 | */ |
||
36 | int __cdecl uFMOD_LoadSong(char*); |
||
37 | |||
38 | /* int uFMOD_WaveOut(SNDBUF hBuff) |
||
39 | --- |
||
40 | Description: |
||
41 | --- |
||
42 | Updates the internal playback buffer. |
||
43 | --- |
||
44 | Parameters: |
||
45 | --- |
||
46 | hBuff |
||
47 | The Infinity Sound buffer to update. |
||
48 | --- |
||
49 | Remarks: |
||
50 | --- |
||
51 | Playback doesn't actually begin when calling uFMOD_LoadSong, |
||
52 | but when calling uFMOD_WaveOut after a successful uFMOD_LoadSong |
||
53 | call. Afterwards, you should call uFMOD_WaveOut repeatedly at |
||
54 | least once every 250 ms to prevent "buffer underruns". |
||
55 | uFMOD_WaveOut is a non-blocking function. |
||
56 | --- |
||
57 | Return Values: |
||
58 | --- |
||
59 | Returns non zero on error. |
||
60 | */ |
||
61 | int __cdecl uFMOD_WaveOut(unsigned int); |
||
62 | |||
63 | /* void uFMOD_StopSong(void) |
||
64 | --- |
||
65 | Description: |
||
66 | --- |
||
67 | Stops the currently playing song, freeing the associated |
||
68 | resources. |
||
69 | --- |
||
70 | Remarks: |
||
71 | --- |
||
72 | Does nothing if no song is playing at the time the call is made. |
||
73 | */ |
||
74 | void __cdecl uFMOD_StopSong(); |
||
75 | |||
76 | /* unsigned char* _uFMOD_GetTitle(void) |
||
77 | --- |
||
78 | Description: |
||
79 | --- |
||
80 | Returns the current song's title. |
||
81 | --- |
||
82 | Remarks: |
||
83 | --- |
||
84 | Not every song has a title, so be prepared to get an empty string. |
||
85 | */ |
||
86 | unsigned char* __cdecl uFMOD_GetTitle(); |
||
87 | |||
88 | #ifdef __cplusplus |
||
89 | } |
||
90 | #endif |