プチコン4 まとめWiki

Toukou/MML_CARRIER の変更点

パンくずリスト


#title(投稿プログラム : MML Carrier)
#contents
// ↑↑↑↑ この2行は削除しないでください。 ↑↑↑↑
// ←「//」で始まる行はコメントです。ページ本文には反映されません。

// --------------------------------------------------------------------------------------------
// ・以下に作品の情報を書きます。

2019年5月26日投稿
/ 2019年6月23日更新
/ 投稿者 : イスターリャ
/ &tag(投稿プログラム,ツール,MML);

// ・投稿年月日は、いま投稿しようとしている今日の日付を半角数字で記入してください。
//   投稿プログラムページの「投稿された順」で上位に表示されます。
// ・作品の公開キーをアップデートしたら、更新日を記入して、頭の「//」2文字を取り除くと
//   「アップデート順」で上位に表示されます。(ページの更新だけで更新日の記入をするのは禁止です)
// ・投稿者名は、投稿プログラム一覧に表示するために使用します。匿名(名無しさん)でも可能です
// ・&tag() 内にコンマ区切りで、作品に関するタグ(任意の単語)を並べると、
//   同じタグがついた作品を検索できます。
// --------------------------------------------------------------------------------------------


// --------------------------------------------------------------------------------------------
// ここから先に概要など、作品の説明を書きます。
// ・* や ** や *** ではじまると見出しになります。* が多いほど階層が深くなります。
// ・[#英数字] はページ内リンクに使用されるキーワードとなりますが、消してもかまいません。
//   消したりなかったりの場合は、ランダムな文字列が自動で付与されます。
//   逆に、ページ内に同じキーワードが複数ある場合、目次からのリンクが正常に動きません。
// --------------------------------------------------------------------------------------------

* 概要 [#Summary]
MML Carrierは''作曲者でも利用者でも簡単に使えるMMLプレイヤー''です。&br;
他のMMLプレイヤーとは違い、本ツールはMMLを素材として扱うことにコンセプトを置いています。

作曲者側は、作成したMMLを「MCD (MML Carrier Data)」という形式でまとめます。これは制作者名、曲のタイトル、説明、そしてMMLを列挙しただけのシンプルな形式です。(具体的には後述します)&br;
作曲者はMMLを他のクリエイターに提供するだけでなく、説明文に書くことで以下のようなものをアピールできます:&br;
- 曲のイメージ
- 作曲した際に工夫した点
- 曲がループに対応しているか否か
- 利用するにあたって制作者名を作品内に書いてほしい、等のお願い

一方、利用者側はそのMCDファイルをMML Carrierのプロジェクト内にダウンロードするだけで、本ツール上からMMLを再生し、作者からの説明を読むことができます。&br;
MCDファイルはプロジェクト内にいくつあっても大丈夫です。(あまりに多いと読み込みが遅くなるかもしれませんが)&br;
色々なMMLを聞いて気に入ったものがあれば、''ワンボタンでそのMMLをコピーして自作品に持って行くことができます''。

#tweet(https://twitter.com/is_ptcm/status/1132626936209989633)


* 使い方 [#HowToUse]
一通りMMLプレイヤーとして必要な機能を揃えています。&br;
プレイリスト機能や連続再生などはMML「素材」を扱う上で必要ないと判断したため、現在はありません。&br;
ツール上の操作は画面右上に常時表示されているので、この項ではMCD形式について触れることにします。

MCD形式は前項で触れたとおり、制作者名、曲のタイトル、説明、MMLをDATA文で列挙する形式です。ファイル名は末尾が「.MCD」である必要があります。&br;
まず先頭に制作者名を書き、その後にタイトル、説明、MMLの列挙を行います。各曲の最後のデータは0としてください。&br;
説明文は表示エリアに合わせて自動で改行されます。文中に"/n"を入れることにより、任意位置での改行も可能です。&br;
MMLは複数行にわたっても構いません。(ただし利用者がコピーするときは1つの文字列に結合されます)&br;
曲データを書き終わったら、最後に-1を加えて終了です。

共通の説明文がMCDファイル内に存在する場合、設定した説明文がファイルに含まれる全てのMMLの説明文の後ろに付加されます。&br;
MML素材の利用条件など、曲によって変わらない文章を説明として表示したい際にご利用ください。

WAVSETについては、ラベル@WAVの後にWAVSETの7つの引数7つを列挙してください。最後にDATA 0を置けば終了です。なおWAVSETAには対応していません。

GPKによる背景表示は本ツール付属のツールTOOL_GRP2GPKをご利用ください。320x180の解像度の画像を背景としてMCDファイルに同梱できます。

#basic{{
@MCD
DATA "制作者名"
'曲データ
DATA "タイトルA", "説明A", "MML A", 0
DATA "タイトルB"
DATA "説明B"
DATA "MML B (1)"
DATA "MML B (2)"
DATA "MML B (3)", 0
'終了
DATA -1
@COM
DATA"共通の説明文"
}}

この説明はプロジェクトに同梱されているSAMPLE.MCDにも書かれています。SAMPLE.MCDを改変するのが最も簡単かもしれません。&br;
なお、SAMPLE.MCDを作成するにあたり、[[XelticaのMMLコレクション>Toukou/XelticaMMLCollection]]と[[ジプッチャさんのMML>http://petitverse.hosiken.jp/community/petitcom/diary/?read=3051&ukey=0]]を利用、再配布しました。素晴らしいMMLをありがとうございました。


/////////////////////////////////


* 更新履歴 [#changelog]

|CENTER:Ver.|CENTER:変更点|h
|01|初版公開|
|02|ボリューム機能の追加、0〜7の8段階の音量調整が可能に|
|03|制作者名がずれるバグを修正&br;タイトルバーにバージョンを表示するように変更&br;Aboutの文章を追加&br;MCD形式に共通の説明文を付加する機能を追加|
|04|ファイルごとに背景画像を設定できる機能を追加&br;WAVSET用データに対応|
|05|キーボード操作に対応&br;3号版のMCDファイルの改行を反映できていなかった問題を修正|
|06|Naさんの[[プチコンmkII at 3号/BIG/4>http://wiki.hosiken.jp/petc3gou/?Toukou%2F%A5%D7%A5%C1%A5%B3%A5%F3mkII_at3%B9%E6]]で使用されているMMLTO4$関数を使わせていただき、3号互換のMCDファイルのMMLを自動的に変換するように変更|
|07|Naさんの[[ExtendedMML>http://wiki.hosiken.jp/petc3gou/?Toukou%2FExtendedMML]]と、高原のなさんの[[NMPACKS>http://wiki.hosiken.jp/petc3gou/?Toukou%2F%A5%D7%A5%C1%A5%B3%A5%F3%A5%B7%A5%EA%A1%BC%A5%BA%B6%A6%C4%CC%B2%BB%B3%DA%A5%D1%A5%C3%A5%AF%A5%D5%A5%A9%A1%BC%A5%DE%A5%C3%A5%C8%20NMPACKS]]に対応|


* 公開キー [#Key]
プチコン4用の公開キーです。トップメニューの「作品を見る」から公開キーを入力すると、作品をダウンロードできます。&br;
なおバージョンアップは同じ公開キーのまま差し替えによって行います。プロジェクト名は変わらないので、ダウンロード時に上書きを選択すると簡単にアップデートできます。
#ptcmid(4JE3JEQD,MML_CARRIER (Ver.07))


* 他作者様による作品 [#usercontents]

#region(なぜかTweetが長くなってしまうので折りたたんでいます)
本ツールをご利用頂きありがとうございます。互換性を崩さない範囲の独自拡張、および便利ツールを紹介します。
** @ WAV2 Patch for MML Carrier Ver.07 (by 輝(ひかる)) [#aea7784a]
プチコンmkIIのBGMPRG命令と同じ形式でユーザー定義波形を記述できる@WAV2の機能を追加したMML Carrierです。&br;
ファイル単体公開なので、MML Carrier本体と同じプロジェクトにダウンロードしてお使いください。
#ptcmid(48444K344)
#tweet(https://twitter.com/mtar3_01/status/1155357044678877184)
** MCDPLAY (by 輝(ひかる)) [#t9c51781]
MCDファイルのMMLを再生できる命令です。MCDファイルのままBGMを再生したいという方、プレイヤーを作りたい方はこちらを利用すると楽にできると思います。
#ptcmid(44AE53HD)
#tweet(https://twitter.com/mtar3_01/status/1146511024918540290)

#endregion


// --------------------------------------------------------------------------------------------
// もしコメントを募集したくないなら、ここから下は削除してください
// --------------------------------------------------------------------------------------------

* CHECKER FLAG (ひとことコメント) [#Comments]
この作品に対するコメントがあれば一言どうぞ。(作品に直接関係ない質問や雑談は[[掲示板>Board]]へ)&br;
作成したMCDファイルの公開キーを晒すのはこちらでも構いませんが、私や他の利用者がここをマメにチェックしているとは限らないので、Petitverseでの公開をおすすめします。
- ''takumi'' : Data文の使い方(僕はこれに対応したBgmプレーヤー作りたいので)教えて下さい。 (&new{2019/06/12 (水) 17:39:02};)
- ''イスターリャ(投稿者)'' : @takumiさん ありがとうございます。基本的な使い方は[[説明>#HowToUse]]およびプロジェクトに含まれるSMPLE.MCDを見れば分かるようになっています。 (&new{2019/06/13 (木) 20:38:51};)
- ''イスターリャ(投稿者)'' : プチコンでのDATA分そのものの扱い方は、RESTORE命令でどのDATA分を読みたいのかを指定し、READ命令で上から順に読み込むという流れです。MCD形式とREAD命令の仕様上、特定の曲を狙って読み出すには、そこまでのデータを捨てる処理が必要になります。 (&new{2019/06/13 (木) 20:43:28};)

#comment

表示モード : [ スマホ・3DS対応表示 | クラシック表示 ]
PukiWiki 1.4.7 Copyright © 2001-2006 PukiWiki Developers Team. License is GPL. Based on "PukiWiki" 1.3 by yu-ji
ページの処理時間 : 0.005 秒 | ログイン
Copyright(C) 2011-2019 プチコンまとめWiki