doclib\hspmucom.txt » Plain Format
------------------------------------------------------------------------------
HSPMUCOM REFERENCE MANUAL HSP : Hot Soup Processor
ＨＳＰ拡張拡張DLLリファレンス copyright 2007-2020 (c) onion software
------------------------------------------------------------------------------
・はじめに
このDLLは、Hot Soup Processor ver3以降とともに使用することで、
MUCOM88エミュレーションを使用した波形の再生、及び音楽データの再生を
行なうことができるプラグインです。
Hot Soup Processor公式HP
https://hsp.tv/
・HSPMUCOMの機能概要
NECのパソコンPC-8801シリーズで動作していた、FM音源のドライバー、
MUCOM88(MUSIC LALF)というツールをWindows上で動作させることができる
MUCOM88 Windowsの機能をDLLにまとめたものが、HSPMUCOMです。
HSPMUCOMを使用することにより、単純な音楽の再生から、MMLの解釈まで
スクリプト言語から幅広く制御することができます。
HSPMUCOMで扱うことのできるフォーマットは、以下の通りです。
・MUC形式 PC-8801上で動作するMUCOM88(MUSIC LALF)の書式で
記述されたMML(行番号を除く)SJIS形式のテキストファイル
として保存したもの。
FM音源(YM2608)6声、ADPCM1声とリズム音源6声、PSG3声の
コントロールが可能です。
MMLの詳細はMUCOM88のマニュアルを参照下さい。
・MUB形式 MUC形式をバイナリに変換したファイル形式。
演奏データ及びFM音色、ADPCMデータを内包します。
Windowsのサウンド再生処理は、DirectX8以降のDirectSoundを
使用しています。Windows XP以降の環境では、追加のコンポーネントを
用意することなく動作させることができます。
FM音源、PSGサウンドのエミュレーションは32bit/55KHzで合成し、
出力されています。古いマシンでは、負荷が大きい場合があります。
・インストール
HSPから使用するためには、拡張プラグインのファイル、HSPMUCOM.DLLを、
HSPインストールフォルダ(HSED3.EXEおよび、HSP3.EXEのあるフォルダ)
にコピーしてお使いください。
また、HSPMUCOM.ASをスクリプトと同じディレクトリか、
またはcommonフォルダ内にコピーされている必要があります。
HSPから実行ファイルを作成した場合は、HSPMUCOM.DLLを同じフォルダに
同梱してください。
HSPMUCOMを使用する場合は、スクリプトの先頭に必ず
「#include "hspmucom.as"」という行を追加してください。
以上で、HSPの機能が拡張され、このリファレンスで説明をしている命令を
使用することができるようになります。
・著作権とライセンス
HSPMUCOMは、Open MUCOM88プロジェクトの一部として公開されています。
Open MUCOM88プロジェクトについては、以下を参照してください。
Open MUCOM88
https://onitama.tv/mucom88/
HSPMUCOMの著作権はおにたま(onion software)にあります。
onion softwareは本プログラムによって生じた、いかなる損害についても
保証いたしません。自己の責任の範囲で使用してください。
また、付属のHSPスクリプトも自由に改変、公開していただいて構いません。
HSPMUCOM.DLL及びソースコードは、無償(非営利)である限りは自由に紹介、
複製、再配布することができます。その際には必ずドキュメントと
ライセンス表記も含めるようにしてください。
・Portable Z80 emulation作者 Yasuo Kuwahara氏
http://www.geocities.jp/kwhr0/
・fmgen作者 cisc氏
http://www.retropc.net/cisc/
・MUCOM88作者 古代祐三氏
https://twitter.com/yuzokoshiro
・HSPMUCOM作者 おにたま(ONION software)
https://www.onionsoft.net/
ユーザーがHSPMUCOMを使って作成したオリジナルのソフトウェア
(実行ファイル)の権利は、それを作成したユーザーに属します。
ただし、HSPMUCOMランタイムには、fmgen及び、Portable Z80 emulationの
ライブラリを使用しており、配布規定に従う必要があります。
fmgenソースコードの配布規定は、以下の通りです。
・fmgenソースコードは作者(cisc@retropc.net) が著作権を所有しています。
・本ソースコードはあるがままに提供されるものであり，
暗黙及び明示的な保証を一切含みません．
・本ソースコードを利用したこと，利用しなかったこと，
利用できなかったことに関して生じたあるいは生じると予測される
損害について，作者は一切責任を負いません．
・本ソースコードは，以下の制限を満たす限り自由に改変・組み込み・
配布・利用することができます．
1. 本ソフトの由来(作者, 著作権)を明記すること.
2. 配布する際にはフリーソフトとすること．
3. 改変したソースコードを配布する際は改変内容を明示すること.
4. ソースコードを配布する際にはこのテキストを一切改変せずに
そのまま添付すること．
・公開の際に作者への連絡を頂ければ幸いです．
・商用ソフト(シェアウェア含む) に本ソースコードの一部，または
全部を組み込む際には，事前に作者の合意を得る必要があります．
各ライブラリについての詳細は、それぞれのソースコード及びドキュメントを
参照ください。
有償・商用での配布については、別途作者までお問い合わせください。
・命令一覧
mucominit MUCOM88初期化
mucombye MUCOM88を解放
mucomreset MUCOM88をリセット
mucomplay 音楽の再生
mucomstop 再生の停止
mucomfade フェードアウト再生
mucomload 音楽データ読み込み
mucomloadpcm PCMデータ読み込み
mucomloadvoice FM音色データ読み込み
mucomcomp MMLのコンパイル
mucomres MUCOM88実行結果を取得
mucomstat MUCOM88のステータス取得
mucomtag タグデータの取得
mucomloadtag タグデータの読み込み
命令の詳細は、ヘルプを参照してください。
-------------------------------------------------------------------------------
HSP users manual / end of file
-------------------------------------------------------------------------------