Skip to content

Commit

Permalink
update
Browse files Browse the repository at this point in the history
  • Loading branch information
@LeeAkinobu
LeeAkinobu committed Nov 2, 2023
1 parent e02e7fe commit 9b7adb6
Show file tree
Hide file tree
Showing 3 changed files with 47 additions and 27 deletions.
18 changes: 18 additions & 0 deletions content.ja/docs/43_3dmodel.md
View file
Expand Up @@ -108,4 +108,22 @@ max_multi_sampling=4
cartoon_edge_width=0.35
{{< /mdf>}}

## モデルロード時・削除時メッセージ

モデルがロードされたとき、あるいは削除されたときに特定のメッセージをシステムへ発行するよう仕込むことができます。これを使うことで、例えば「モデルをロードしたときにメニューやボタンを追加する」「モデルをロードしたとき同時に背景も替える」といった処理をモデル側の指示として行うことができます。

モデル名 `xxx.pmd` に対して、`xxx.pmd.loadmessage` というテキストファイルを作り、その中に、1行1つずつメッセージを記述しておきます。そうすることで、このモデル `xxx.pmd` がロードされる際に、ロード直後に `xxx.pmd.loadmessage` の中に記述されているメッセージが順に実行されます。

同様に、`xxx.pmd.deletemessage` を記述することで、モデルが削除されたときに発行するメッセージを指定できます。

例が Example の「ジェネ」のモデルにあります。この `Gene.pmd.loadmessage` では、ジェネのモデルをロードした際に、アクセサリの ON/OFF を行うメニューを追加するように書かれています。

```text
MENU|ADD|Gene
MENU|SETITEM|Gene|0|頬なし|MODEL_BINDFACE|0|頬全消し|1
MENU|SETITEM|Gene|1|頬あり|MODEL_BINDFACE|0|頬全消し|0
MENU|SETITEM|Gene|2|メッシュなし|MODEL_BINDFACE|0|メッシュなし|1
MENU|SETITEM|Gene|3|メッシュあり|MODEL_BINDFACE|0|メッシュなし|0
MENU|SETITEM|Gene|4|髪留なし|MODEL_BINDFACE|0|髪留なし|1
MENU|SETITEM|Gene|5|髪留あり|MODEL_BINDFACE|0|髪留なし|0
```
46 changes: 24 additions & 22 deletions content.ja/docs/64_menu.md
View file
Expand Up @@ -4,41 +4,43 @@ slug: menu
---
# メニューの定義

## メニュー追加
MMDAgent-EX はメニューボタンあるいは `/` キーでメニューを出すことができます。

**MENU|ADD**
メッセージで新たなメニューを追加できます。コンテンツのスクリプトに仕込んでおくことで、コンテンツ固有のメニューを追加することができます。以下、メッセージによってメニューを追加・削除する方法を説明します。

メニューに新たにページを追加する。デフォルトと合わせて最大20ページまで可能。追加完了時に **MENU_EVENT|ADD** を発行する。
## メニューに新たなページを追加する

```text
**MENU|ADD** でメニューに新たにページを追加します。エイリアス名を新たに指定します。エイリアス名はユニークである必要があります。完了時に **MENU_EVENT|ADD** が発行されます。

{{<message>}}
MENU|ADD|(alias)
MENU|ADD|(alias)|backgroundImagePath
MENU_EVENT|ADD|(alias)
```
{{</message>}}

**MENU|SETITEM**
## ページに項目を追加する

メニューの指定ページの指定位置に項目を登録する。`id` は0から始まる項目番号。1ページあたり項目は30個まで登録可能。登録完了後に **MENU_EVENT|SETITEM** を発行する。
メニューのページに「押したら特定のメッセージを発行する」項目を追加できます。追加するには
**MENU|SETITEM** を使います。`(alias)` はページ指定で、`(id)` はそのページ中で今回登録する項目の位置（一番上が 0）を指定します。`(label)` は表示テキストで、それ以降の `(type)|(arg1)|(arg2)|...` の部分で、そのメニュー項目が選択されたときに発行するメッセージを記述します。完了時に **MENU_EVENT|SETITEM** が発行されます。

```text
{{<message>}}
MENU|SETITEM|(alias)|(id)|(label)|(type)|(arg1)|(arg2)|...
MENU_EVENT|SETITEM|(alias)|(id)
```
{{</message>}}

**MENU|DELETEITEM**
## ページの項目を削除する

メニューの指定ページの指定位置の項目内容を削除する。削除完了時に **MENU_EVENT|DELETEITEM** を発行する。
追加した項目を削除するときは **MENU|DELETEITEM** を使います。完了時に **MENU_EVENT|DELETEITEM** を発行します。

```text
MENU|DELETE|(alias)
MENU_EVENT|DELETE|(alias)
```
{{<message>}}
MENU|DELETEITEM|(alias)|(id)
MENU_EVENT|DELETEITEM|(alias)|(id)
{{</message>}}

**MENU|DELETE**
## ページ全体を削除する

メニューの指定ページをまるごど削除する。削除完了時に **MENU_EVENT|DELETE** を発行する。
**MENU|DELETE** でメニューの指定ページをまるごと削除します。完了時に **MENU_EVENT|DELETE** を発行します。

```text
MENU|DELETEITEM|(alias)|(id)
MENU_EVENT|DELETEITEM|(alias)|(id)
```
{{<message>}}
MENU|DELETE|(alias)
MENU_EVENT|DELETE|(alias)
{{</message>}}
10 changes: 5 additions & 5 deletions content.ja/docs/86_messages.md
View file
Expand Up @@ -1107,15 +1107,15 @@ MENU_EVENT|SETITEM|(alias)|(id)
メニューの指定ページの指定位置の項目内容を削除する。削除完了時に **MENU_EVENT|DELETEITEM** を発行する。

```text
MENU|DELETE|(alias)
MENU_EVENT|DELETE|(alias)
MENU|DELETEITEM|(alias)|(id)
MENU_EVENT|DELETEITEM|(alias)|(id)
```

**MENU|DELETE**

メニューの指定ページをまるごど削除する。削除完了時に **MENU_EVENT|DELETE** を発行する。
メニューの指定ページをまるごと削除する。削除完了時に **MENU_EVENT|DELETE** を発行する。

```text
MENU|DELETEITEM|(alias)|(id)
MENU_EVENT|DELETEITEM|(alias)|(id)
MENU|DELETE|(alias)
MENU_EVENT|DELETE|(alias)
```

0 comments on commit 9b7adb6

Please sign in to comment.