This wiki is out of date, use the continuation of this wiki instead

From FenixWiki

Revision as of 01:18, 26 April 2007 (edit) Sandman (Talk | contribs) m (→Example) ← Previous diff		Revision as of 11:22, 31 July 2007 (edit) (undo) Sandman (Talk | contribs) m (Afaik it doesn't play .wav) Next diff →
Line 2:		Line 2:
	[[Category:sound]]		[[Category:sound]]
-	'''INT''' load_song ( <'''STRING''' path> )	+	==Definition==
		+	'''INT''' load_song ( <'''STRING''' filename> )
	Loads a song for later use with [[play_song]]().		Loads a song for later use with [[play_song]]().
Line 10:		Line 11:
	* MIDI (.mid). Takes very low space, but it's limited to samples of the soundcard.		* MIDI (.mid). Takes very low space, but it's limited to samples of the soundcard.
	* Modules (.xm, .it, .s3m, .mod). Like MIDI, but Modules also contain the samples themselves.		* Modules (.xm, .it, .s3m, .mod). Like MIDI, but Modules also contain the samples themselves.
-	* WAV (.wav). Uncompressed audio data, taking very much space.
	== Parameters ==		== Parameters ==
	{|		{|
-	| '''STRING''' path || - The [[path]] to the music file to be loaded.	+	| '''STRING''' filename || - The music file to be loaded, including a possible path
	|}		|}

---

Revision as of 11:22, 31 July 2007

Contents 1 Definition 2 Parameters 3 Returns 4 Example

Definition

INT load_song ( <STRING filename> )

Loads a song for later use with play_song().

There are multiple filetypes you can load using this function. Included are:

• OGG Vorbis (.ogg). Good quality for songs and doesn't take too much space (it's similar to *.mp3).
• MIDI (.mid). Takes very low space, but it's limited to samples of the soundcard.
• Modules (.xm, .it, .s3m, .mod). Like MIDI, but Modules also contain the samples themselves.

Parameters

STRING filename

- The music file to be loaded, including a possible path

Returns

INT : SongID

-1	- Could not load music file (errormessage in console).
>=0	- The SongID.

Example

Program example;
Private
    int song;
Begin
    song = load_song("my_song.ogg");
    play_song(song,0);
    Loop
        frame;
    End
End

Used in example: play_song()