カスタムツールバー

ツールバーを作成および編集する

新しいツールバーを作成するには

メインメニューから[表示](View) [新規カスタムツールバー](New Custom Toolbar)を選択します。

空の新規ツールバーが表示されます。

特定の位置に新規ツールバーを作成するには

プラグインマネージャを開きます([ファイル](File) [プラグインマネージャ](Plug-in Manager)を選択します)。
[ツリー]タブで、[ツールバー](Toolbars)フォルダを右クリックし、[新規作成](New) [ツールバー](Toolbar)を選択します。

たとえば、アドオンフォルダ内にツールバーを作成するには、そのアドオンフォルダの下の[ツールバー](Toolbars)フォルダを右クリックします。

ワークグループ内にツールバーを作成するには、そのワークグループの下の[ツールバー](Toolbars)フォルダを右クリックします。
[ツールバー名](Toolbar Name)ボックスで、ツールバーの名前を入力します。
空のツールバーを作成する場合は、[この場所からコマンド付きで作成](Populate with Commands from this location)チェックボックスをオフにします。

デフォルトでは、すべてのコマンドを含んだ新規ツールバーが、ツールバーと同じ場所に配置されます。たとえば、アドオンフォルダ内に新規ツールバーを作成すると、アドオンで定義されたすべてのコマンドがツールバーに含まれます。
[出力フォルダ](Output Directory)は、[ツリー]タブでクリックしたパス(ワークグループまたはアドオンフォルダ)内の Application¥Toolbars フォルダにあります。
[OK]をクリックすると、新規ツールバーが作成され、表示されます。

カスタムツールバーに名前を付けるには

ツールバーの何もない領域を右クリックして[名前の変更](Rename)を選択し、新しい名前を入力して[OK]をクリックします。

[表示](View) [ツールバー](Toolbars)メニューとツールバーのタイトルバーに、ツールバーの名前が表示されます。スペースも使用できます。

カスタムツールバーを保存するには

ツールバーの何もない領域を右クリックし、[保存](Save)または[名前を付けて保存](Save As)を選択します。

変更を保存せずに閉じようとすると、自動的にツールバーの保存を求めるダイアログボックスが表示されます。

ツールバーにコマンドを追加する

コマンドボタンは、[ツールバーのカスタマイズ]ウィンドウまたはプラグインマネージャからツールバーにドラッグアンドドロップして追加できます。

[ツールバーのカスタマイズ]ウィンドウを使用して、コマンドをツールバーに追加するには

ツールバーが表示されていることを確認します。たとえば、ツールバーを[表示](View) [ツールバー](Toolbars)メニューから選択します。
[表示](View) [ツールバーのカスタマイズ](Customize Toolbar)を選択するか、カスタムツールバーの空白領域を右クリックして[ツールバーのカスタマイズ](Customize Toolbar)を選択します。
[ツールバーのカスタマイズ]ダイアログボックスで、[コマンドカテゴリー](Command Categories)リストから項目を選択します。たとえば、カスタムコマンドを検索する場合、[Custom Script Commands]を選択すると、一覧に表示されるコマンドがそのタイプのものだけに限られます。
[利用可能コマンド](Available Commands)リストから項目を選択し、ツールバーの任意の場所にドラッグします。

プラグインマネージャを使ってツールバーにコマンドを追加するには

プラグインマネージャを開きます([ファイル](File) [プラグインマネージャ](Plug-in Manager)を選択します)。
ツールバーが表示されていることを確認します。たとえば、プラグインマネージャの[ツリー]タブで、[ツールバー](Toolbars)フォルダを展開し、ツールバー(.xsitb ファイル)をダブルクリックします。
プラグインマネージャの[ツリー]タブで、[プラグイン](Plug-ins)フォルダを展開し、プラグインを展開して、カスタムコマンドをツールバーにドラッグします。

ツールバー上のコマンドボタンをカスタマイズするには

コマンドボタンを右クリックし、[ボタンのカスタマイズ](Customize Button)を選択します。
必要に応じてオプションを設定します。
- [Height]および[Width]のピクセル数を設定します。
- [Button Label]をオンにして[ツールバー名](Label)を入力します。
- [Bitmap](.bmp ファイル)のパスを指定します。「ボタンビットマップを追加する」を参照してください。
[OK]をクリックします。

ツールバーにプリセットを追加する

プリセットボタンをブラウザからツールバーにドラッグして追加できます。プリセットボタンをクリックすると、選択したオブジェクトにプリセットを適用できます。また、選択されていないオブジェクトにプリセットボタンをドラッグアンドドロップして、プリセットを適用できます。

プリセットが使用できる場合は、組み込まれたサムネイルが使用されます。プリセットを保存するときに、レンダ領域のサムネイルも保存したり(「プリセットの保存」(「シーンエレメント」)を参照)、setthumb スタンドアロンを使用してサムネイルをプリセットにアタッチしたりできます(「プリセット用サムネイルの作成と抽出」(「スタンドアロン」)を参照)。プリセットにサムネイルが存在しない場合は、汎用サムネイルが使用されます。

ツールバーにプリセットボタンを追加するには

ブラウザで、ツールバーに追加するプリセットを検索し、ツールバーにドラッグします。

プリセットボタンの表示を変更するには

ツールバーの何もない領域を右クリックし、[テキストのみ](Text Only)または[サムネイルのみ](Thumbnail Only)を選択します。

プリセットのサムネイルのサイズを変更するには

ツールバーの何もない領域を右クリックし、[サムネイルサイズ](Thumbnail Size)メニューから項目を選択します。

ツールバーにプリセットリストボタンを追加するには

プリセットリストには、特定のフォルダでメニューとして検出されるすべてのプリセットが表示されます。サブフォルダは含まれません。

ツールバーの何もない領域を右クリックし、[カスタマイズ](Customize)を選択します。
[コマンドカテゴリー](Command Categories)から[ツールバー](Toolbar)を設定します。
[利用可能コマンド](Available Commands)から[Preset List Button]をツールバーにドラッグします。
プリセットが格納されているフォルダを指定します。

Toolbar Widgetsによるツールバーの最適化

Toolbar Widgets は、カスタムツールバー上に使用できるボタンおよびセパレータの集まりです。セパレータ(グループラベル、水平方向の空白/行セパレータ、および改行)をツールバー上のボタンの整列にどう使用できるかを、下図に示します。

A	水平方向の空白セパレータ
B	改行
C	水平方向の行セパレータ

Toolbar Widgets ボタンを使用すると、メニューのポップアップ、プリセット一覧のポップアップ、およびスクリプティングコードの実行も可能になります。

[Menu Button]を使用すると、コマンドのメニューがポップアップします。[Menu Separator]ウィジェットを使用すると、ポップアップメニュー上のコマンドをグループ化できます。
[Preset List Button]を使用すると、特定の場所にあるプリセットリスト(たとえば、ワークグループ内のライトシェーダプリセットリスト)がポップアップします。
[Script Button]を使用すると、スクリプトコマンドを作成しなくても、直接にスクリプティングコードをツールバーに埋め込むことができます。

ツールバーを整理するには

ツールバーの何もない領域を右クリックし、[カスタマイズ](Customize)を選択します。
[コマンド](Command)カテゴリを[ツールバーウィジット(Toolbar Widgets)に設定します。
項目をツールバー上の目的の場所までドラッグします。

ボタンを再配置する

Toolbar Widgets(メニューボタン、改行、水平セパレータなど)は、ツールバー上でドラッグして移動することができます。ツールバーを右クリックし、[ツールバーのカスタマイズ]を選択して、[Toolbar Widgets]を別の場所にドラッグします。

スクリプトボタンを追加する

[ツールバー]フォルダの .xsitb ファイルに保存されているスクリプティングコードは、スクリプトボタンで実行できます。スクリプトボタンを使用すると、コマンドを作成してコードを外部ファイルに保存することなしに、カスタムコードをツールバーから実行できます。スクリプトボタンを使用すると、たとえば引数値でコマンドを呼び出すこともできます。

次のいずれかの操作を実行します。
- ツールバーウィンドウで、何もない領域を右クリックし、[ツールバーのカスタマイズ](Customize Toolbar)を選択します。[グループ](Group)一覧で、[Toolbar Widgets]をクリックし、[Script Button]を[利用可能コマンド](Available Commands)一覧からツールバーにドラッグします。
  
  または
- Script Editor(または外部テキストエディタ)で、任意のスクリプティングコードを選択します。コードをツールバーにドラッグします。[スクリプトボタン](Script Button)ダイアログボックスで、[OK]をクリックします(デフォルトでは[スクリプトボタン](Script Button)が選択されるはずです)。コードは、Script Editor のヒストリペインまたは編集ペインのどちらかからドラッグすることができます。
[Customize Button]ダイアログボックスで、次の操作を実行します。
- [Script Commands]は、ボタンをクリックしたときに実行されるスクリプティングコードです。[Run]をクリックして、コードをテストします。
- [Scripting Language]は、スクリプトボタンによって使用されるスクリプト言語です。
- [Bitmap]は、ボタン上に表示されるビットマップ(.bmp)ファイルの名前です。「ボタンビットマップを追加する」を参照してください。

ボタンビットマップを追加する

ビットマップは、ツールバーのスクリプトボタンおよびコマンドボタン上に表示できます。

ボタンのサイズは、ビットマップのサイズによって決定されます。ビットマップ内の白色ピクセル(255,255,255)はすべて、イメージの背景カラーで置換されます。

ボタンビットマップが表示されるのは、ツールバーがサムネイルのみ表示するように設定されている場合だけです。.xsitb ファイル内で、これは以下のように変換されます。

<properties ... display_as_text_only="False"></properties>

ボタン上にビットマップを表示するには

[ツールバー](toolbar)フォルダに bitmaps というサブフォルダを作成し、そこにビットマップファイル(.bmp)を保存します。

[ヒント](Tip):[ツリー]タブからファイルシステムにすばやくアクセスするには、[ツールバー]フォルダを右クリックして[ブラウズ](Browse)を選択します。
Softimage で、ツールバーを開き、スクリプトまたはコマンドボタンを右クリックして、[ボタンのカスタマイズ](Customize Button)を選択します。
[Bitmap]ボックスで、パスまたは拡張子を[含めずに](without)ビットマップファイルの名前を入力します。たとえば、ビットマップファイルが myimage.bmp である場合は、「myimage」と入力します。

メニューボタンを追加する

ツールバーウィンドウで、何もない領域を右クリックし、[ツールバーのカスタマイズ](Customize Toolbar)を選択します。
[グループ](Group)一覧で、[Toolbar Widgets]をクリックします。
[利用可能コマンド](Available Commands)一覧から[Menu Button]をツールバーにドラッグします。
[ポップアップメニューボタンに名前を付ける](Name Popup Menu Button)ボックスで、ボタンのラベルを入力します。

ボタンラベルを変更するには、.xsitb ファイルを編集する必要があります。
コマンド、ビューショートカット、およびメニューセパレータをメニューボタンに追加します。
- コマンドを追加するには、[ツールバーのカスタマイズ](Group)ダイアログボックスの[グループ](Customize Toolbar)一覧の[Custom Script Commands]をクリックします。その後、[利用可能コマンド]一覧で、必要なコマンドを検索して、メニューボタンにドラッグします。
- メニュー項目間にメニューセパレータを追加するには、[グループ](Group)一覧の[Toolbar Widgets]をクリックし、[Menu Separator]をメニューボタンにドラッグします。
変更内容を保存します。ツールバーウィンドウで、何もない領域を右クリックし、[保存](Save)を選択します。

注:

メニューボタン上の項目を並べ替えるには、ボタンを右クリックし、[ボタンのカスタマイズ](Customize Button)を選択します。[ポップアップメニューボタンのカスタマイズ]ダイアログボックスで、メニュー項目をクリックし、[上げる]または[下げる]をクリックします。
その他のコマンドをメニューボタンに追加するには、[ツールバーのカスタマイズ](Customize Toolbar)ダイアログボックスをもう一度開き、コマンドをツールバー上のメニューボタンにドラッグします。
独自のメニューにではなく、デフォルトの Softimage メニューに項目を追加する場合は、標準メニューとコンテキストメニュー『SDK ガイド』を参照してください。

項目を削除する

ツールバー上のボタンを右クリックし、[ボタン削除](Remove Button)を選択します。

そのボタンがカスタムコマンド用であった場合、そのコマンドや関連付けられたスクリプトは登録されたままになります。カスタムコマンドの登録を解除するには、「カスタムコマンドの削除」を参照してください。

.xsitb ファイルの編集

ツールバーは、.xsitb 拡張子で XML ファイルに保存されます。XML ファイルの編集が快適な場合、Text Editor を使用してツールバーをカスタマイズできます。たとえば、次のような作業が必要な場合があります。

メニューボタン上のラベルの変更(この操作は、[ボタンのカスタマイズ]では実行できません)。
複数のボタンの幅および高さの変更。この操作は、[ボタンのカスタマイズ]ダイアログボックスで実行できますが、人によっては XML ファイルを編集するほうが簡単な場合もあります。
ツールバー上のボタンおよびグループヘッダを再配置します。

ツールバーの XML ソースを編集するには

[ツリー]タブの、[ツールバー]フォルダを右クリックして、[編集](Edit)を選択します。

Script Editor 内で .xsitb ファイルが開きます。
ファイルを編集して保存します。

カスタム ツールバー