Blender日本語エディタ ver0.98 取説（暫定版）

サンプル『jpe.blend』について

• サンプルには、日本語入力スクリプト本体（.py）と、このスクリプトを使って日本語入力をするために必要な設定を施した『Editor』という名前のオブジェクトが含まれています。 さらにゲームエンジンでの使用例を示したサンプルスクリプトも同梱しています。
• 日本語の入力と編集は『Editor』オブジェクトを使って行います。 『Editor』オブジェクトのメッシュに対してFaceの複製、追加や分割といった操作をするとスクリプトが正しく機能しなくなる可能性があります。
• ObjectModeで複製することは問題ありません。
• jpe.blend以外のファイルで『Editor』を使いたい場合はjpe.blendからAppendしてください。

最初の設定

1. アドオンとして導入する場合はjpe.blendを開き『japanese_edit.py』をお使いのBlenderのアドオンフォルダに保存してください（例：\blender-2.59-windows32\2.59\scripts\addons）
2. File -> User Preferences -> Add Ons -> Japanese Editor のチェックをオンにします。
3. アドオンとして導入しないで使う場合はテキストエディタから『japanese_edit.py』をRunしてください。
4. 文字の入力と編集は全てFace選択で行いますので、SelectModeがFace以外の場合はFaceSelectModeに切り替えてください。→
5. 文字の入力と編集は全てEditModeで行います。『Japanese Edit』UIは、EditModeの時のみToolShelfに表示されます。

• 辞書機能を活用する場合は頻繁にRunすることになります・・・

文字の入力（ひらがな）

英数字の入力

▼操作手順

1. 上記『文字の入力』のうちダイアログボックスを開くまでの手順を実行
2. Commandボックス内に>>と入力し、次いで英数字を入力する
3. OKボタンをクリック

• 英数字入力モードからひらがな入力モードに復帰したい場合は再度>>を入力します。
• カタカナ入力モードはありません。

かな/カナ変換

▼操作手順

1. カタカナに変換する場合はひらがなを、ひらがなに変換する場合はカタカナをFace選択
2. 3D View ->ToolShelf -> Japanese Edit -> Input tools にある『Kana』ボタンをクリック（Shotcut = K）

• 元に戻す場合はもう一度『Kana』ボタンをクリックします。
• 漢字の索引として使われているひらがなはカナや漢字に変換できません。

漢字変換

▼操作手順

1. 漢字変換するひらがなもしくはカタカナをFace選択
2. 3D View ->ToolShelf -> Japanese Edit -> Input tools にある『Kanji / Next』ボタンをクリック（Shotcut = Space）
3. 目的の漢字に変換されなかった場合はもう一度『Kanji / Next』ボタンをクリック
4. ひとつ前の変換候補に移動するには3D View ->ToolShelf -> Japanese Edit -> Input tools にある『Prev』ボタンをクリック（Shotcut = Alt + Space）
5. 目的の漢字がヒットするまで3を繰り返す

コピー ＆ ペースト

▼操作手順

1. コピーしたい範囲をFace選択する
2. 3D View ->ToolShelf -> Japanese Edit -> Edit Tools にある『Copy』ボタンをクリック（Shotcut = Shift + Ctrl + C）
3. ペーストしたい位置にあるFaceを選択しActiveにする（ActiveFace状態であれば選択状態でなくても可）
4. 3D View ->ToolShelf -> Japanese Edit -> Edit Tools にある『Paste』ボタンをクリック（Shotcut = Shift + Ctrl + V）

• 元に戻す場合はもう一度『Kana』ボタンをクリックします
• 漢字の索引として使われているひらがなはカナや漢字に変換できません。

カット

▼操作手順

1. カットしたい範囲をFace選択する
2. 3D View ->ToolShelf -> Japanese Edit -> Edit Tools にある『Cut』ボタンをクリック（Shotcut = Shift + Ctrl + X）

• 切り取った文字を貼り付けるには上記『コピー ＆ ペースト』の３〜４を実行します。
• カット機能で切り取った場合は切り取った位置に空白が残ります。

空白の挿入

▼操作手順

1. 空白を挿入する位置にあるFaceを選択しActiveにする（ActiveFace状態であれば選択状態でなくても可）
2. 3D View ->ToolShelf -> Japanese Edit -> Edit Tools にある『Insert』ボタンをクリック（Shotcut = Shift + Space）

• 空白を挿入した位置に文字があった場合は右隣のFaceに移動します。またそれ以降にある文字も全て右詰めされ、編集領域から溢れた文字は削除されます。

文字の削除

▼UIを使って1文字を削除

1. 削除する文字をFace選択しActiveにする（ActiveFace状態であれば選択状態でなくても可）
2. 3D View ->ToolShelf -> Japanese Edit -> Edit Tools にある『Delete』ボタンをクリック（Shotcut = Ctrl + D）

• Delete機能はActiveFace上の1文字のみを削除します。
• 削除した文字以降にある文字は左詰めされます。

▼コマンドを使って、これから入力する文字以降にある全ての文字を削除

1. 『文字の入力』のうちダイアログボックスを開くまでの手順を実行
2. Commandボックス内にCommandを入力し、最後に**と入力
3. OKボタンをクリック

• 編集領域にある全ての文字が削除対象になります（行の終端までではありません）。

▼Backspaceキーを使って前の文字を削除

1. 削除する文字の右隣にあるFaceを選択しActiveにする（ActiveFace状態であれば選択状態でなくても可）
2. Backspaceキーを押す

ラインフィード（改行）

▼操作手順

1. 改行したい位置にある空白Faceを選択
2. 3D View ->ToolShelf -> Japanese Edit -> Edit Tools にある『LF』ボタンをクリック（Shotcut = Space）

• この機能はゲームエンジンにおいて任意の位置で改行処理を実行するためのものです。編集時にはLF記号が表示されるだけで改行としては機能しません。
• ゲームプレイ時はLFよりも右側にある文字は表示されません。
• LFを使わずに改行するには行の終端まで空白で埋める必要があります。しかしそうした場合後述の『エンコード』で生成されるコードに無駄が生じます。LFはこの無駄を省くための機能です。

色の変更

▼操作手順

1. 色を変更する文字をFace選択
2. 3D View ->ToolShelf -> Japanese Edit -> Edit Tools にある『Color』ボタンをクリック
3. ダイアログボックスのColorR、ColorG、ColorBにそれぞれに０〜１の範囲で値を入力する
4. OKボタンをクリック

• 例）0.0, 0.0, 0.0 = 黒　1.0, 1.0, 1.0 = 白　1.0, 0.0, 0.0 = 赤　0.5, 0.5, 0.5 = グレー
• 文字と色はリンクしていないため、文字の配置が変わると色がズレます（汗
• 色を変更する操作はテキスト完成後に行うことを推奨します。
• 文字色をコピーする場合はBlenderアドオン『CopyAttributes』を使ってください。
• 文字を削除してもFaceの色情報（VertexColor）は削除されません。文字を削除して空白となった部分には色情報が残っています。 空白部分の色情報をまとめて削除するには、色を変更しても問題ないFaceを選択して操作手順2を実行しそのままOKボタンを押してください。 なお、文字をエンコードする際にも無効な色情報が削除されますので、作成中のテキストに問題がなければ放置したままでも構いません。
• 文字ごとに色情報を付加するとエンコードで生成されるコードが非常に長くなるため、その回避策として隣り合う色が同じ場合をひとつの範囲としその範囲につきひとつの色情報コードを生成しています。 そのため文字色を変更したあとは文字の配置を動かさないようにする必要があります。（完成間近になって思いつきで付けた機能であるためなんとも雑な仕様となっていますが平にご容赦m(_ _;)m

Seach ＆ Put

▼Seachの操作手順

1. 3D View ->ToolShelf -> Japanese Edit -> Seach Tools にある『Seach』ボタンをクリック
2. ダイアログボックスの『Seach』に検索したい漢字の読みをローマ字で入力
3. OKボタンをクリック

▼Putの操作手順

1. 編集領域内の空白Faceを選択
2. 入力したい漢字を検索候補領域からShift+右クリックでFace選択
3. 3D View ->ToolShelf -> Japanese Edit -> Seach Tools にある『Put』ボタンをクリック

• Putの手順1と手順2は逆でも問題ありません。

エンコード

▼操作手順

1. エンコードする文字列を範囲選択
2. 3D View ->ToolShelf -> Japanese Edit -> Game Engine Tools にある『Encode』ボタンをクリック
3. ダイアログボックスの『Key』にこのテキストを呼び出すときのキーネームを入力(例：mes_5）
4. OKボタンをクリック

• サンプル『jp_render』を使って文字を表示する場合は、新たに作成した文章のキーネームをmes_5としてエンコードしたうえで、『jp_render』のdict={}内にペーストしてください。
• 文字に演出を加えたい場合は各自でスクリプトを改造してください。

キーマップ

▼ショートカットの無効化

1. 3D View ->ToolShelf -> Japanese Edit -> Keymap Tools にある『Remove』ボタンをクリック

▼ショートカットの有効化

1. 3D View ->ToolShelf -> Japanese Edit -> Keymap Tools にある『Regist』ボタンをクリック

辞書への語句登録

▼操作手順

1. 辞書に登録したい語句をFace選択
2. 3D View ->ToolShelf -> Japanese Edit -> Game Engine Tools にある『Encode』ボタンをクリック
3. ダイアログボックスの『Key』にこの語句を呼び出すためのキーを入力（例：登録語句が『凱旋』の場合、キーは『gaisenn』）
4. OKボタンをクリック
5. テキストエディタでjapanese_edit.pyを開き32行目にある『dict＝{}』の{}内の適切な位置にカーソルを合わせてCtrl+Vでペースト
6. 登録した語句を適用する場合はRunScriptをクリック

• 読み方が重複する語句を辞書に登録する場合は、キーの末尾に_1、_2…という書式で通し番号を付加します。こうすることで漢字変換の際にスペースキーを押すごとに読みが重複した語句が通し番号の順で表示されます。