投稿プログラム : 【公開終了】音楽パックフォーマット NMPACKS

パンくずリスト

概要
仕様アップデート履歴
使い方
サンプルの公開キー
- サンプルアップデート履歴
CHECKER FLAG (ひとことコメント)

2019年5月26日投稿 / 2019年7月8日更新 / 投稿者 : 高原のな / タグ : 投稿プログラム実用ツール音楽

概要

いくつかの曲と、その曲の関連データを一つのファイルにまとめることができます。

本ライブラリのメンテナンスは終了しました。後継フォーマットのNNMフォーマットへの乗り換えをお勧めします。

以下の部分は、NNMへの乗り換えのための参考資料としてご利用ください。

仕様アップデート履歴

バージョン	公開日	アップデート内容
0.1(初版)	2019年5月26日	1ファイルに曲関連データをまとめ上げることを目的として設計した。
0.1.1	2019年5月26日	誤字訂正を行った。
0.2	2019年5月26日	wav<楽器番号>要素を追加した。composer要素の誤字を訂正した。
0.2.1	2019年6月8日	album要素の誤字を訂正した。
0.2.2	2019年6月8日	かつて誤字のあった要素の救済措置を設定した。
0.3.0	2019年7月8日	データ埋め込み構文、copyright要素、date要素を追加した。

使い方

使い倒したい人向けに、仕様書(外部サイト)が用意してありますが、最初は読まなくていいです。

音楽パックを作るには

音楽パックは次の4つの要素から構成されます。これらを必要なものだけ書き記して、拡張子.NMPのファイルとして保存します。

@NMTRACKSから始まる、その音楽パックに収録されている曲IDのリスト
@NMPACKから始まる、その音楽パック全体に関するデータ
@D_＜曲ID＞から始まる、その曲IDの曲に関するデータ
@M_＜曲ID＞から始まる、その曲IDの曲のMML

次のプログラムは一番シンプルなファイルの例です。

サンプルファイルはプチコン4専用MMLが収録されたサンプルになっているので参考にしてみてください。

なお、音楽パックファイルに動作可能なプログラムを入れると誤作動の原因になるのでご注意ください。

＠ＮＭＴＲＡＣＫＳ
ＤＡＴＡ”ＭＹＢＧＭ１”
ＤＡＴＡ”ＭＹＢＧＭ２”
ＤＡＴＡ””

＠ＮＭＰＡＣＫ
ＤＡＴＡ”ａｌｂｕｍ：はじめての　きょくパック”
ＤＡＴＡ””

＠Ｄ＿ＭＹＢＧＭ１
ＤＡＴＡ”ｔｉｔｌｅ：はじめての　きょく”
ＤＡＴＡ”ｃｏｍｐｏｓｅｒ：○○○○”
ＤＡＴＡ””

＠Ｍ＿ＭＹＢＧＭ１
ＤＡＴＡ”（中略：ＭＭＬデータ）”
ＤＡＴＡ””，０

＠Ｄ＿ＭＹＢＧＭ２
ＤＡＴＡ”ｔｉｔｌｅ：かっこいい　きょく”
ＤＡＴＡ”ｃｏｍｐｏｓｅｒ：○○○○”
ＤＡＴＡ””

＠Ｍ＿ＭＹＢＧＭ２
ＤＡＴＡ”（中略：ＭＭＬデータ）”
ＤＡＴＡ””，０

NMPACKS対応ソフトを作るには

基本ライブラリとして「NM One」をご用意しました。ちょっとだけ楽ができます！！

NM Oneを使うときはEXECを利用してロードするか、NM Oneの中身を全てコピーしてプログラムファイルの前や後ろに貼り付けてください。

使い方の実例は収録したサンプル「SAMPLE.PRG」をご覧ください。次に追加される主な関数を紹介します。

主な関数一覧

NMO_INIT$(slot,mode)
- 戻り値は、曲ID配列。使用開始の準備をする。slotのスロットにNMPACKSフォーマットのファイルがロードされてないとSmileBASICのエラーになる。
- slot: NMPファイルがロードされているプログラムスロット番号
- mode: 識別文字と分割先の動作モード。NMO_GETMODECH$関数とNMO_GETMODESU$関数の中身を見ながら設定すること。
NMO_GETMODECH$(mode)
- 戻り値は、曲IDの前につける識別文字(仕様書参照)。
- mode: モード。モードによって返す識別文字が変化するよう適宜関数の中身を変更すること。
NMO_GETMODESU$(mode)
- 戻り値は、曲データをモードによって分ける際の、分割先ラベルの@と_を含む先頭部分(仕様書参照)
- mode: モード。モードによって返す分割先ラベルが変化するよう適宜関数の中身を変更すること。
NMO_GET$(id$,attr$)
- 戻り値は、id$で指定された曲の、attr$で指定された要素の値文字列。id$に空文字列を指定した場合は@NMPACK内からデータをロードする。要素が見つからなかった場合は空文字列を返す。
- id$: 曲ID(単体)
NMO_GET_PACK$(attr$)
- 戻り値は、@NMPACK内の、attr$で指定された要素の値文字列。要素が見つからなかった場合は空文字列を返す。
- attr$: 要素名。ここへの指定も大文字小文字を問わない。
NMO_GET_FAST$(id$,attr$)
- 戻り値は、id$で指定された曲の、attr$で指定された要素の値文字列。挙動はNMO_GET$と同等であるが、埋め込み構文の文字列を置換しない。
- id$: 曲ID(単体)
- attr$: 要素名。ここへの指定も大文字小文字を問わない。
NMO_GET_PACK_FAST$(attr$)
- 戻り値は、@NMPACK内の、attr$で指定された要素の値文字列。挙動はNMO_GET_PACK$と同等であるが、埋め込み構文の文字列を置換しない。
- attr$: 要素名。ここへの指定も大文字小文字を問わない。
NMO_SETWAV id$,no
- id$で指定された曲の、noで指定された波形番号の波形を設定する。
- id$: 曲ID(単体)
- no: 波形番号
NMO_SETALLWAV id$
- id$で指定された曲の波形を全て設定する。
- id$: 曲ID(単体)
NMO_BGMSET id$,no
- id$で指定された曲をBGM no番に設定する。曲メタデータの波形は設定されない。
- id$: 曲ID(単体)
- no: BGM番号

曲再生の流れの概要をまとめると以下のようになります。

適当な空きスロットに.NMPファイルをロードする
NMO_INIT$関数にロードしたスロットと"識別文字と分割先の動作モード"(関数一覧参照)を渡してIDの配列を取得する
再生したい曲のIDと曲を定義する定義番号をNMO_BGMSETに渡す(必要に応じてNMO_SETALLWAVも実行しておく)
BGMPLAYで再生

最小のプログラム例を下に示しておきます。

ＥＸＥＣ”ＰＲＧ２：ＮＭＯＮＥ－ＬＩＢ．ＰＲＧ”
ＥＸＥＣ”ＰＲＧ１：曲ファイル”

ＤＩＭ　ＩＤ＄［０］
ＩＤ＄＝ＮＭＯ＿ＩＮＩＴ＄（１，０）

ＮＭＯ＿ＢＧＭＳＥＴ　ＩＤ＄［０］，１２８
ＢＧＭＰＬＡＹ　１２８

また、NMO_GET$(曲ID,”TITLE”)で曲名、NMO_GET$(曲ID,”COMPOSER”)で作曲者などを取得可能です。

もうちょっと作り込むには(中上級者向け)

独自拡張でどんどん作り込むのもアリですが、ここでは標準で用意した一部機能を紹介します。

設定可能な主な要素

各種要素は、適切な位置にDATA文を並べて"要素名:データ"の形式で書くことで設定できます。要素名の大文字小文字は問いません(当ページ内でも混在しています)。

次の表に示す、音楽パックファイル全体の要素は@NMPACKのDATA文に書きます。

要素名	内容
album	アルバム名(音楽パックファイルの題)

次の表に示す、曲の要素は@D_＜曲ID＞のDATA文に書きます。

要素名	内容
title	曲のタイトル(このデータがない場合エラーとなる実装もある)
composer	作曲者(このデータがない場合エラーとなる実装もある)
wav<楽器番号>	WAVSET用のデータ。wav224のようにして指定する。アタック,ディケイ,サスティン,リリース,定義文字列[,基準音程]と、リファレンス通りに設定する。基準音程は省略してもよい。実装者はこのデータに対応するべき。
arranger	編曲者(開発者の意図としては積極的に設定&対応してほしい。)
lyricist	作詞者
description	曲の詳細およびコメント等
copyright	コピーライト・権利表示
date	制作日時(yyyy-mm-dd形式が望ましいが、区切り文字は/や漢字による助数詞も許容される)
lyric	歌詞(ただし、この仕様書ではフォーマットを指定しないため、非推奨)

標準で用意してある他の要素を確認するには仕様書(外部サイト)をご覧ください。

特定バージョンのプチコンやSmileBASICで、別のMMLを読み込ませる

曲IDの前に、次のような「識別文字」を追加すると、データを読み込みラベルの「@M_」部分が変化します。

対応バージョン	識別文字	読み込みラベル
プチコン3号	#	@M3_
プチコンBIG	$	@MB_
PiStarter	%	@MP_
プチコン4	&	@M4_

また、必要に応じて、自分で識別文字を追加して、読み込みラベルを変更することも可能です。NM Oneではそれが簡単にできるようになっています。

埋め込み構文を使う

[=曲ID:要素名]という式単体もしくはembed構文を組み合わせて、他の要素に設定したデータを埋め込めるようになりました。

要素のデータがこの埋め込み式だけの場合はsame構文といい、曲ID:要素名の要素をそのままコピーします。

要素のデータ全体を{}で囲んだ場合はembed構文といい、埋め込み式がどこにあっても埋め込み式を評価しようと試みます。

なお、どちらの構文にも当てはまらない場合は埋め込み式が評価されません。

このほか、ライブラリに関して要望等ありましたらCHECKER FLAGにお寄せください。

サンプルの公開キー

トップメニューの「作品公開とダウンロード」から公開キーを入力すると、ダウンロードすることができます。

サンプルとして、「NM One」を使用したシンプルなプレイヤーと、投稿者が第3回SB2Weeksに投稿した「おてがみコウモリさん」の曲を数曲収録しました。

プチコン3号/BIG版バージョン2019-07-08

公開終了

サンプルアップデート履歴

バージョン	対象環境	公開状況	アップデート内容
(初版)	3号/BIG	終了	1ファイルに曲関連データをまとめ上げることを目的として設計した。
(初期版)	3号/BIG	終了	バックアップがないため、詳細は不明
2019-07-02	4	終了	プチコン4対応版初版。ただし対応し忘れた部分がある。仕様バージョン0.2.2に対応。
2019-07-08	3号/BIG	終了	仕様バージョン0.3.0に対応。NMONE-LIB.PRGは埋め込み構文にも対応した。
2019-07-21	4	終了	仕様バージョン0.3.0に対応。NMONE-LIB.PRGは埋め込み構文にも対応した。
2019-11-30	3号/BIG	-	プチコン3号/プチコンBIG版はNNMフォーマットに保守管理を移行しました。
2019-12-21	4	-	プチコン4版もNNMフォーマットに保守管理を移行しました。

CHECKER FLAG (ひとことコメント)

この作品(= NMPACKSの仕様と、公開キーでアップしているサンプル)に対するコメントがあれば一言どうぞ。(作品に直接関係ない質問や雑談は掲示板へ)

Na : バグ報告 NMOME-LIB.PRG 168行目のBGMSETDでスロット1を読み込むようになっているので他のスロットでロードできません (2019/06/08 (土) 20:43:14)
Na : "1:"+NMO_ …を STR$(_NMO_SLOT)+":"+NMO_ …とすると動きます (2019/06/08 (土) 20:45:24)
投稿者 : 修正したものをアップしました。仕様書とこのページの修正反映も間も無く行います (2019/06/08 (土) 20:50:01)
投稿者 : http://petitverse.hosiken.jp/community/petitcom/topic/?read=1321 にて、新バージョンの仕様検討を行っております。要望等があればプチバースのページかこのコメント欄へお願いします。 (2019/10/22 (火) 22:43:58)

メニュー【3号】

旧プチコンまとめWiki
(初代/mkII)

ヘルプ

リンク

Miiverseの避難先まとめ

プチコン3号リンク集

オンライン情報

現在同時に 1 人がこのサイトを見ています
このページはこれまでに 1311 回、本日は 1 回、昨日は 0 回閲覧されました

ページの先頭に戻る

プチコン3号＆BIGまとめWiki