「BGM」の編集履歴（バックアップ）一覧はこちら

「BGM」(2013/07/24 (水) 16:21:19) の最新版変更点

追加された行は緑色になります。

削除された行は赤色になります。

*標準ライブラリ - BGM
**説明
>BGMには、曲を再生したいときに使用すると便利なメソッドが含まれています。&br()曲ではなく、効果音(SE)を再生する場合には、&u(){[[Snd]]}を使用することが好ましいとされています。&br()なお、このライブラリだけ全部大文字なので注意。Backgroundは1語なので、法則からするとBgMかBgmのどちらかだと思うんだが。

----
#contents(fromhere=true)
----

*所有メソッド
**Play(path:[]char,playpos:float,looppos:float) : float
***&aname(Play説明)説明
>pathに与えた曲を再生します。&br()&color(red){playposとloopposは未実装の模様。}
***&aname(Play引数)引数
-path:[]char
--再生したい曲のファイルパスを指定します。
--&color(blue){dbgresディレクトリからの相対パス指定も可能}
-playpos:float
--(推定)再生を開始したい位置を指定します。
--&color(red){Ver0.031現在未実装なので0.0を指定すると良い。}
--なお、指定する値はおそらく(sec)単位で指定。(曲の長さ以上の秒数を指定すると例外が発生したため)
-looppos:float
--(推定)曲が最後まで再生された後、ループを再開したい位置を指定します。
--&color(red){Ver0.031現在未実装なので0.0を指定すると良い。}
--なお、指定する値はおそらく(sec)単位で指定。(曲の長さ以上の秒数を指定すると例外が発生したため)
***&aname(Play戻り値)戻り値
-float
--初回再生時は0を返す。
--以降は再生に成功したら再生中の曲の再生位置(≠今から流そうとする曲の位置)、再生に失敗したら0を返す模様。
***&aname(Playサンプルコード)サンプルコード(Ver0.031)
#highlight(linenumber){{func Main()
	var res : float
	do res :: BGM@Play("bgm.ogg", 0.0, 0.0) {再生開始}
	do Dbg@Log(res.ToStr()) {0 と表示される}
	do Kuin@Stop() {Kuinを終了させないようにガードガード}
end func}}

----

**PlayFade(path:[]char,playpos:float,looppos:float,fadetime:int) : float
***&aname(PlayFade説明)説明
>再生中の曲をfadetimeフレームかけてフェードアウトした後、pathに与えた曲を再生します。&br()&color(red){playposとloopposは未実装の模様。}&br()フェードアウト開始時に強制的に音量が最大になる模様。&br()また、フェードを掛ける前の曲と新たに再生する曲は、&color(red){別のファイルでなくてはならない。}
***&aname(PlayFade引数)引数
-path:[]char
--再生したい曲のファイルパスを指定します。
--&color(blue){dbgresディレクトリからの相対パス指定も可能}
-playpos:float
--(推定)再生を開始したい位置を指定します。
--&color(red){Ver0.031現在未実装なので0.0を指定すると良い。}
--なお、指定する値はおそらく(sec)単位で指定。(曲の長さ以上の秒数を指定すると例外が発生したため)
-looppos:float
--(推定)曲が最後まで再生された後、ループを再開したい位置を指定します。
--&color(red){Ver0.031現在未実装なので0.0を指定すると良い。}
--なお、指定する値はおそらく(sec)単位で指定。(曲の長さ以上の秒数を指定すると例外が発生したため)
-fadetime:int
--フェードにかける&color(blue){フレーム数}を指定する。
--Ver0.031では、(処理落ちしない限り)30fpsなので、例えば約5秒間なら150と指定する。
***&aname(PlayFade戻り値)戻り値
-float
--初回再生時は0を返す。
--以降は再生に成功したら再生中の曲の再生位置(≠今から流そうとする曲の位置)、再生に失敗したら0を返す模様。
***&aname(PlayFadeサンプルコード)サンプルコード(Ver0.031)
#highlight(linenumber){{func Main()
	const FPS : int :: 30 {Ver0.031ではFPSが30}
	do Dbg@Log("これよりbgm.oggを再生する")
	do BGM@Play("bgm.ogg", 0.0, 0.0)
	while(true)
		do Kuin@Act()
		if(Kuin@Cnt() = FPS*10)
			do Dbg@Log("10秒経過。これよりbgm.oggを5秒かけてフェードアウトする")
			do BGM@PlayFade("bgm2.ogg", 0.0, 0.0,FPS*5) {5秒かけてフェード}
		elif(Kuin@Cnt() = FPS*15)
			do Dbg@Log("フェードアウト完了。これよりbgm2.oggの再生を開始する")
		elif(Kuin@Cnt()%5 = 0)
			do Dbg@Log(Kuin@Cnt().ToStr() ~ "frameカウント中...")
		end if
	end while
end func}}

----

**PlayCross(path:[]char,playpos:float,looppos:float,fadetime:int) : float
***説明
>再生中の曲をfadetimeフレームかけてフェードアウトしつつ、pathに与えた曲をフェードインします。&br()&color(red){playposとloopposは未実装の模様。}&br()フェードアウト開始時に強制的に音量が最大になる模様。&br()また、フェードを掛ける前の曲と新たに再生する曲は、&color(red){別のファイルでなくてはならない。}
***引数
-path:[]char
--再生したい曲のファイルパスを指定します。
--&color(blue){dbgresディレクトリからの相対パス指定も可能}
-playpos:float
--(推定)再生を開始したい位置を指定します。
--&color(red){Ver0.031現在未実装なので0.0を指定すると良い。}
--なお、指定する値はおそらく(sec)単位で指定。(曲の長さ以上の秒数を指定すると例外が発生したため)
-looppos:float
--(推定)曲が最後まで再生された後、ループを再開したい位置を指定します。
--&color(red){Ver0.031現在未実装なので0.0を指定すると良い。}
--なお、指定する値はおそらく(sec)単位で指定。(曲の長さ以上の秒数を指定すると例外が発生したため)
-fadetime:int
--フェードにかける&color(blue){フレーム数}を指定する。
--Ver0.031では、(処理落ちしない限り)30fpsなので、例えば約5秒間なら150と指定する。
***戻り値
-float
--初回再生時は0を返す。
--以降は再生に成功したら再生中の曲の再生位置(≠今から流そうとする曲の位置)、再生に失敗したら0を返す模様。
***サンプルコード(Ver0.031)
#highlight(linenumber){{func Main()
	const FPS : int :: 30 {Ver0.031ではFPSが30}
	do Dbg@Log("これよりbgm.oggを再生する")
	do BGM@Play("bgm.ogg", 0.0, 0.0)
	while(true)
		do Kuin@Act()
		if(Kuin@Cnt() = FPS*10) {10秒経過したらフェード開始}
			do Dbg@Log("10秒経過。これよりbgm.oggを5秒かけてフェードアウトする")
			do Dbg@Log("また同時に、bgm2.oggの再生を開始し、5秒かけてフェードインする")
			do BGM@PlayCross("bgm2.ogg", 0.0, 0.0,FPS*5) {5秒かけてフェード}
		elif(Kuin@Cnt() = FPS*15)
			do Dbg@Log("bgm.oggのフェードアウト完了と、bgm2.oggのフェードイン完了を確認")
		elif(Kuin@Cnt()%5 = 0)
			do Dbg@Log(Kuin@Cnt().ToStr() ~ "frameカウント中...")
		end if
	end while
end func}}

----

**Stop() : float
***説明
>再生中の曲を停止します。
***引数
-なし
--ないよっ
***戻り値
-float
--初回再生時は0を返す。
--以降は再生に成功したら再生中の曲の再生位置(≠今から流そうとする曲の位置)、再生に失敗したら0を返す模様。
***サンプルコード(Ver0.031)
#highlight(linenumber){{func Main()
	const FPS : int :: 30 {Ver0.031ではFPSが30}
	do Dbg@Log("これよりbgm.oggを再生する")
	do BGM@Play("bgm.ogg", 0.0, 0.0)
	while(true)
		do Kuin@Act()
		if(Kuin@Cnt() = FPS*10) {10秒経過したらフェード開始}
			do Dbg@Log("10秒経過。これよりbgm.oggを停止する。")
			do BGM@Stop()
		elif(Kuin@Cnt()%5 = 0)
			do Dbg@Log(Kuin@Cnt().ToStr() ~ "frameカウント中...")
		end if
	end while
end func}}

----

**StopFade(fadetime:int) : float
***説明
>再生中の曲をfadetimeで指定したフレーム数かけてフェードアウトしながら停止します。
***引数
-fadetime:int
--フェードにかける&color(blue){フレーム数}を指定する。
--Ver0.031では、(処理落ちしない限り)30fpsなので、例えば約5秒間なら150と指定する。
***戻り値
-float
--初回再生時は0を返す。
--以降は再生に成功したら再生中の曲の再生位置(≠今から流そうとする曲の位置)、再生に失敗したら0を返す模様。
***サンプルコード(Ver0.031)
#highlight(linenumber){{func Main()
	const FPS : int :: 30 {Ver0.031ではFPSが30}
	do Dbg@Log("これよりbgm.oggを再生する")
	do BGM@Play("bgm.ogg", 0.0, 0.0)
	while(true)
		do Kuin@Act()
		if(Kuin@Cnt() = FPS*10) {10秒経過したらフェード開始}
			do Dbg@Log("10秒経過。これより5秒かけてbgm.oggをフェードアウトする。")
			do BGM@StopFade(FPS*5)
		elif(Kuin@Cnt() = FPS*15)
			do Dbg@Log("bgm.oggの停止を確認。")
		elif(Kuin@Cnt()%5 = 0)
			do Dbg@Log(Kuin@Cnt().ToStr() ~ "frameカウント中...")
		end if
	end while
end func}}

----

**テンプレメソッド(ひきすー:ひきすうかたー) : もどりちー
***説明
>テンプレメソッドの説明をここにー
***引数
-ひきすー:ひきすうかたー
--ひきすーのせつめー
***戻り値
-もどりちかたー
--もどりちせつめいー
***サンプルコード(Ver0.031)
#highlight(linenumber){{func Main()
	{素敵なソースコードをここにー}
end func}}

*標準ライブラリ - BGM
**説明
>BGMには、曲を再生したいときに使用すると便利なメソッドが含まれています。&br()曲ではなく、効果音(SE)を再生する場合には、&u(){[[Snd]]}を使用することが好ましいとされています。&br()なお、このライブラリだけ全部大文字なので注意。Backgroundは1語なので、法則からするとBgMかBgmのどちらかだと思うんだが。

----
#contents(fromhere=true)
----

*所有メソッド
**Play(path:[]char,playpos:float,looppos:float) : float
***&aname(Play説明)説明
>pathに与えた曲を再生します。&br()&color(red){playposとloopposは未実装の模様。}
***&aname(Play引数)引数
-path:[]char
--再生したい曲のファイルパスを指定します。
--&color(blue){dbgresディレクトリからの相対パス指定も可能}
-playpos:float
--(推定)再生を開始したい位置を指定します。
--&color(red){Ver0.031現在未実装なので0.0を指定すると良い。}
--なお、指定する値はおそらく(sec)単位で指定。(曲の長さ以上の秒数を指定すると例外が発生したため)
-looppos:float
--(推定)曲が最後まで再生された後、ループを再開したい位置を指定します。
--&color(red){Ver0.031現在未実装なので0.0を指定すると良い。}
--なお、指定する値はおそらく(sec)単位で指定。(曲の長さ以上の秒数を指定すると例外が発生したため)
***&aname(Play戻り値)戻り値
-float
--初回再生時は0を返す。
--以降は再生に成功したら再生中の曲の再生位置(≠今から流そうとする曲の位置)、再生に失敗したら0を返す模様。
***&aname(Playサンプルコード)サンプルコード(Ver0.031)
#highlight(linenumber){{func Main()
	var res : float
	do res :: BGM@Play("bgm.ogg", 0.0, 0.0) {再生開始}
	do Dbg@Log(res.ToStr()) {0 と表示される}
	do Kuin@Stop() {Kuinを終了させないようにガードガード}
end func}}

----

**PlayFade(path:[]char,playpos:float,looppos:float,fadetime:int) : float
***&aname(PlayFade説明)説明
>再生中の曲をfadetimeフレームかけてフェードアウトした後、pathに与えた曲を再生します。&br()&color(red){playposとloopposは未実装の模様。}&br()フェードアウト開始時に強制的に音量が最大になる模様。&br()また、フェードを掛ける前の曲と新たに再生する曲は、&color(red){別のファイルでなくてはならない。}
***&aname(PlayFade引数)引数
-path:[]char
--再生したい曲のファイルパスを指定します。
--&color(blue){dbgresディレクトリからの相対パス指定も可能}
-playpos:float
--(推定)再生を開始したい位置を指定します。
--&color(red){Ver0.031現在未実装なので0.0を指定すると良い。}
--なお、指定する値はおそらく(sec)単位で指定。(曲の長さ以上の秒数を指定すると例外が発生したため)
-looppos:float
--(推定)曲が最後まで再生された後、ループを再開したい位置を指定します。
--&color(red){Ver0.031現在未実装なので0.0を指定すると良い。}
--なお、指定する値はおそらく(sec)単位で指定。(曲の長さ以上の秒数を指定すると例外が発生したため)
-fadetime:int
--フェードにかける&color(blue){フレーム数}を指定する。
--Ver0.031では、(処理落ちしない限り)30fpsなので、例えば約5秒間なら150と指定する。
***&aname(PlayFade戻り値)戻り値
-float
--初回再生時は0を返す。
--以降は再生に成功したら再生中の曲の再生位置(≠今から流そうとする曲の位置)、再生に失敗したら0を返す模様。
***&aname(PlayFadeサンプルコード)サンプルコード(Ver0.031)
#highlight(linenumber){{func Main()
	const FPS : int :: 30 {Ver0.031ではFPSが30}
	do Dbg@Log("これよりbgm.oggを再生する")
	do BGM@Play("bgm.ogg", 0.0, 0.0)
	while(true)
		do Kuin@Act()
		if(Kuin@Cnt() = FPS*10)
			do Dbg@Log("10秒経過。これよりbgm.oggを5秒かけてフェードアウトする")
			do BGM@PlayFade("bgm2.ogg", 0.0, 0.0,FPS*5) {5秒かけてフェード}
		elif(Kuin@Cnt() = FPS*15)
			do Dbg@Log("フェードアウト完了。これよりbgm2.oggの再生を開始する")
		elif(Kuin@Cnt()%5 = 0)
			do Dbg@Log(Kuin@Cnt().ToStr() ~ "frameカウント中...")
		end if
	end while
end func}}

----

**PlayCross(path:[]char,playpos:float,looppos:float,fadetime:int) : float
***&aname(PlayCross説明)説明
>再生中の曲をfadetimeフレームかけてフェードアウトしつつ、pathに与えた曲をフェードインします。&br()&color(red){playposとloopposは未実装の模様。}&br()フェードアウト開始時に強制的に音量が最大になる模様。&br()また、フェードを掛ける前の曲と新たに再生する曲は、&color(red){別のファイルでなくてはならない。}
***&aname(PlayCross引数)引数
-path:[]char
--再生したい曲のファイルパスを指定します。
--&color(blue){dbgresディレクトリからの相対パス指定も可能}
-playpos:float
--(推定)再生を開始したい位置を指定します。
--&color(red){Ver0.031現在未実装なので0.0を指定すると良い。}
--なお、指定する値はおそらく(sec)単位で指定。(曲の長さ以上の秒数を指定すると例外が発生したため)
-looppos:float
--(推定)曲が最後まで再生された後、ループを再開したい位置を指定します。
--&color(red){Ver0.031現在未実装なので0.0を指定すると良い。}
--なお、指定する値はおそらく(sec)単位で指定。(曲の長さ以上の秒数を指定すると例外が発生したため)
-fadetime:int
--フェードにかける&color(blue){フレーム数}を指定する。
--Ver0.031では、(処理落ちしない限り)30fpsなので、例えば約5秒間なら150と指定する。
***&aname(PlayCross戻り値)戻り値
-float
--初回再生時は0を返す。
--以降は再生に成功したら再生中の曲の再生位置(≠今から流そうとする曲の位置)、再生に失敗したら0を返す模様。
***&aname(PlayCrossサンプルコード)サンプルコード(Ver0.031)
#highlight(linenumber){{func Main()
	const FPS : int :: 30 {Ver0.031ではFPSが30}
	do Dbg@Log("これよりbgm.oggを再生する")
	do BGM@Play("bgm.ogg", 0.0, 0.0)
	while(true)
		do Kuin@Act()
		if(Kuin@Cnt() = FPS*10) {10秒経過したらフェード開始}
			do Dbg@Log("10秒経過。これよりbgm.oggを5秒かけてフェードアウトする")
			do Dbg@Log("また同時に、bgm2.oggの再生を開始し、5秒かけてフェードインする")
			do BGM@PlayCross("bgm2.ogg", 0.0, 0.0,FPS*5) {5秒かけてフェード}
		elif(Kuin@Cnt() = FPS*15)
			do Dbg@Log("bgm.oggのフェードアウト完了と、bgm2.oggのフェードイン完了を確認")
		elif(Kuin@Cnt()%5 = 0)
			do Dbg@Log(Kuin@Cnt().ToStr() ~ "frameカウント中...")
		end if
	end while
end func}}

----

**Stop() : float
***&aname(Stop説明)説明
>再生中の曲を停止します。
***&aname(Stop引数)引数
-なし
--ないよっ
***&aname(Stop戻り値)戻り値
-float
--初回再生時は0を返す。
--以降は再生に成功したら再生中の曲の再生位置(≠今から流そうとする曲の位置)、再生に失敗したら0を返す模様。
***&aname(Stopサンプルコード)サンプルコード(Ver0.031)
#highlight(linenumber){{func Main()
	const FPS : int :: 30 {Ver0.031ではFPSが30}
	do Dbg@Log("これよりbgm.oggを再生する")
	do BGM@Play("bgm.ogg", 0.0, 0.0)
	while(true)
		do Kuin@Act()
		if(Kuin@Cnt() = FPS*10) {10秒経過したらフェード開始}
			do Dbg@Log("10秒経過。これよりbgm.oggを停止する。")
			do BGM@Stop()
		elif(Kuin@Cnt()%5 = 0)
			do Dbg@Log(Kuin@Cnt().ToStr() ~ "frameカウント中...")
		end if
	end while
end func}}

----

**StopFade(fadetime:int) : float
***&aname(StopFade説明)説明
>再生中の曲をfadetimeで指定したフレーム数かけてフェードアウトしながら停止します。
***&aname(StopFade引数)引数
-fadetime:int
--フェードにかける&color(blue){フレーム数}を指定する。
--Ver0.031では、(処理落ちしない限り)30fpsなので、例えば約5秒間なら150と指定する。
***&aname(StopFade戻り値)戻り値
-float
--初回再生時は0を返す。
--以降は再生に成功したら再生中の曲の再生位置(≠今から流そうとする曲の位置)、再生に失敗したら0を返す模様。
***&aname(StopFadeサンプルコード)サンプルコード(Ver0.031)
#highlight(linenumber){{func Main()
	const FPS : int :: 30 {Ver0.031ではFPSが30}
	do Dbg@Log("これよりbgm.oggを再生する")
	do BGM@Play("bgm.ogg", 0.0, 0.0)
	while(true)
		do Kuin@Act()
		if(Kuin@Cnt() = FPS*10) {10秒経過したらフェード開始}
			do Dbg@Log("10秒経過。これより5秒かけてbgm.oggをフェードアウトする。")
			do BGM@StopFade(FPS*5)
		elif(Kuin@Cnt() = FPS*15)
			do Dbg@Log("bgm.oggの停止を確認。")
		elif(Kuin@Cnt()%5 = 0)
			do Dbg@Log(Kuin@Cnt().ToStr() ~ "frameカウント中...")
		end if
	end while
end func}}

----

**テンプレメソッド(ひきすー:ひきすうかたー) : もどりちー
***&aname(テンプレ説明)説明
>テンプレメソッドの説明をここにー
***&aname(テンプレ引数)引数
-ひきすー:ひきすうかたー
--ひきすーのせつめー
***&aname(テンプレ戻り値)戻り値
-もどりちかたー
--もどりちせつめいー
***&aname(テンプレサンプルコード)サンプルコード(Ver0.031)
#highlight(linenumber){{func Main()
	{素敵なソースコードをここにー}
end func}}