/*	
 *	clipmus.h
 *
 *	P/ECE標準音楽ライブラリ 補助ルーチン
 *
 *	CLiP - Common Library for P/ECE
 *	Copyright (C) 2001-2004 Naoyuki Sawa
 *
 *	* Mon May 24 06:00:00 JST 2004 Naoyuki Sawa
 *	- 作成開始。
 */
#ifndef __CLIP_MUS_H__
#define __CLIP_MUS_H__

/* P/ECE標準音楽ライブラリの音量増幅ON/OFFを切り替えます。
 * [in]
 *	enable		0を指定すると、音量増幅を行いません。
 *			1を指定すると、音量増幅を行います。
 * [note]
 *	* enable=1を指定すると、pceWaveDataOut()をフックします。
 *	  既にフックされている場合は、何もしません。
 *	* enable=0を指定すると、pceWaveDataOut()のフックを解除します。
 *	  まだフックされていない場合は、何もしません。
 *	* music_loudness(1)を呼び出したら、アプリケーション終了前に必ずmusic_loudness(0)も呼び出して、フックを解除してください。
 *	  フックを解除しないままアプリケーションを終了すると、P/ECEがハングアップします。
 *	* CLiPライブラリの終了ルーチンは、自動的にmusic_loudness(0)を★呼び出しません!!★
 *	  アプリケーションから明示的にmusic_loudness(0)を呼び出してください。
 *	* CLiPライブラリの終了ルーチンで自動的にmusic_loudness(0)を呼んでいない理由は、プログラムサイズを抑えるためです。
 *	  music_loudness()関数は、P/ECE標準音楽ルーチンの変数"music_wch"を参照しています。
 *	  CLiPライブラリの終了ルーチンでmusic_loudness()を呼んでしまうと、P/ECE標準音楽ライブラリの使用有無に関わらず、
 *	  常にP/ECE標準音楽ライブラリがリンクされ、プログラムサイズが増えてしまいます。
 *	  この問題を避けるために、CLiPライブラリの終了ルーチンからmusic_loudness()を呼び出すことは避けました。
 *	  P/ECE標準音楽ライブラリを利用するアプリケーションだけが明示的にmusic_loudness()を呼び出すことにより、
 *	  P/ECE標準音楽ライブラリを領するアプリケーションだけにP/ECE標準音楽ライブラリがリンクされます。
 */
void music_loudness(int enable);

#endif /*__CLIP_MUS_H__*/
