Add missing return documentation

[skip ci]
This commit is contained in:
Dom Light 2015-11-18 00:20:22 +00:00
parent a07333aeaf
commit 92a30e0a32
1 changed files with 5 additions and 3 deletions

View File

@ -195,6 +195,7 @@ void audio_pause_sounds();
* @param volume The volume at which the sound effect should be played. * @param volume The volume at which the sound effect should be played.
* @param pan The pan at which the sound effect should be played. If set to anything other than AUDIO_PLAY_AT_CENTRE, plays the * @param pan The pan at which the sound effect should be played. If set to anything other than AUDIO_PLAY_AT_CENTRE, plays the
* sound at a position relative to the centre of the viewport. * sound at a position relative to the centre of the viewport.
* @return 0 if the sound was not out of range; otherwise, soundId.
*/ */
int audio_play_sound(int soundId, int volume, int pan); int audio_play_sound(int soundId, int volume, int pan);
/** /**
@ -203,6 +204,7 @@ int audio_play_sound(int soundId, int volume, int pan);
* @param x The x coordinate of the location. * @param x The x coordinate of the location.
* @param y The y coordinate of the location. * @param y The y coordinate of the location.
* @param z The z coordinate of the location. * @param z The z coordinate of the location.
* @return 0 if the sound was not out of range; otherwise, soundId.
*/ */
int audio_play_sound_at_location(int soundId, sint16 x, sint16 y, sint16 z); int audio_play_sound_at_location(int soundId, sint16 x, sint16 y, sint16 z);
/** /**
@ -210,9 +212,9 @@ int audio_play_sound_at_location(int soundId, sint16 x, sint16 y, sint16 z);
* @deprecated Use audio_play_sound_at_location or audio_play_sound instead. * @deprecated Use audio_play_sound_at_location or audio_play_sound instead.
* Plays the specified sound effect at a location specified by the pan parameter. * Plays the specified sound effect at a location specified by the pan parameter.
* @param soundId (eax) The sound effect to play. * @param soundId (eax) The sound effect to play.
* @param pan (ebx) If set to AUDIO_PLAY_AT_LOCATION, play the sound at the specified location; if set to AUDIO_PLAY_AT_CENTRE, play * @param pan (ebx) If set to AUDIO_PLAY_AT_LOCATION, play the sound at the specified location; if set to AUDIO_PLAY_AT_CENTRE,
* the sound at the centre of the viewport; if set to anything else, use the value of pan as a relative position to the centre * play the sound at the centre of the viewport; if set to anything else, use the value of pan as a relative position to the
* of the viewport. * centre of the viewport.
* @param x (cx) The x coordinate of the location. * @param x (cx) The x coordinate of the location.
* @param y (dx) The y coordinate of the location. * @param y (dx) The y coordinate of the location.
* @param z (bp) The z coordinate of the location. * @param z (bp) The z coordinate of the location.