YT ステッピング スライダの取扱説明書 ( YT Stepping Slider Instruction Manual )

YT ステッピング スライダの全てを詳細に解説したページです。

YT ステッピング スライダはZbrushのスライダをキーボードのホットキーで制御するプラグインです。

YT Stepping Slider is a plugin that controls Zbrush sliders with keyboard hotkeys.

主に左手デバイスのホイール操作による素早いスライダ操作を目的として開発しました😊

YT ステッピング スライダはブラシカーソルをスライダの上に重ねた状態でキーボードのホットキーを押すとスライダの値を変更できるZbrushのプラグインです。変化量はユーザーが指定可能です。

特徴をすぐに知りたい人はこちら。簡潔な紹介記事です。

すぐに使いたい人は以下の記事をご覧下さい。クイックスタート記事です。

更新履歴

2023/05/19 Ver.1.3.1 公開。Zbrush 2023.1.1と2022.0.8に対応。Zbrush 2023.1.0のサポートを終了。制限モードで利用している場合のアップデート方法を追加。

2023/05/10 Ver.1.3.0 公開。Zbrush 2023.1.0 最終対応版。

• 3Dプリントハブ、デシメーションマスターやスケールマスターの連動型スライダ以外のスライダの制御方法を変更。
• カスタムメニュー（カスタムUI）のポップアップウィンドウ内のスライダ制御時にそのウィンドウが消えるバグを修正。
  • カスタムメニューにホットキーを割り当てた場合にカスタムメニューをポップアップ表示させられますが、ポップアップウィンドウ内にZbrushプラグインのスライダがある場合、そのスライダを制御しようとするとそのウィンドウが消えるバグを修正しました。
  • ただし以下のようにポップアップウィンドウでは使用できないスライダが判明しました。

この修正に伴い、当ページの記載も一部修正。

• 当ページの制限事項の章に「3Dプリントハブ、デシメーションマスターやスケールマスターにある連動型スライダは、ホットキーで呼び出すカスタムメニューのポップアップウィンドウ上で操作できない」点を追加。

プラグインのアップデート方法

最新版のダウンロード

Ver.1.3.1以降はZbrush 2023.1.1または2022.0.8で動作します。他のZbrushバージョンでは動作しません。ご注意下さい。

Ver.1.3.0では2023.1.0と2022.0.8で動作します。

インストール方法

こちらをご覧下さい。

当プラグインの基本的な概念は「操作したいスライダを許可リストに登録することで、そのスライダを操作可能にする」というものです。ですので何も登録しない場合、どのスライダも操作できません。

これは意図的に「操作したくないアイテムには誤操作であっても操作しない」という安全面を重視した結果です。

当プラグインに興味のあるユーザー様は恐らく以下の2通りに分かれると思います。

• Zbrushのほとんどのスライダを最初からをホットキーで操作したい人（通常モード）
• 少しの特定のスライダだけを操作したい人（制限モード）

上記の2通りのユーザー様を想定しています。多くのユーザー様は恐らく①であり、一部のユーザー様は②を希望すると思っています。当プラグインではどちらにも対応可能ですが、まずは①の場合から説明いたします。

無料体験版の制限事項

体験版には以下の制限があります。

• Zbrush起動時から5分間のみ利用できます
• サブツールの総数が15個以下で利用できます
• Aボタンの利用回数が200回までに制限されています
• 体験版ではマイナスAキーが利用できません
• Zbrushを再起動することで再びお試し可能

体験版の＋Aボタンのホットキーでスライダが正常に動作すれば製品版のマイナスAボタンのホットキーでも正常動作します。そのため体験版の＋Aボタンのホットキーのみで十分に動作確認ができます。

体験版で当プラグインの動作を確認できると思います。

なお製品版には上記の制限はございません。

【通常モード】使い始めの初期化作業

インストールに成功したら、初めて当プラグインを使う初回の1回目のみ、初期化作業が必要です。といっても以下の「初期化ボタン」をクリックするだけです。

オプション＞初期化＞初期化ボタンを押すと、Zbrush内のほとんどのスライダが登録されます。

もし20秒経っても完了メッセージが表示されないときにはZbrushキャンバスを一度クリックし、さらに20秒ほど待ってみて下さい。

ただし2割ほどの特殊なスライダはこの初期化作業で登録されません。もし使っていて「明らかにスライダなのに初期化後でも動作しない」場合には、お手数ですが以下の「操作したいスライダの登録」の章をご覧下さい。

通常モードで使い始める場合にはこれで使い始めることができます。

Zbrush 2023.1.1の場合、下2桁の数字を表現するためにAllowedBtns2023.11.zvrとなっていますが正常です。ユーザー設定ファイルの名前ではバージョン番号の2つ目のピリオドが省略されています。

ユーザー設定ファイルはZbrushのバージョンごとに作成されます。別バージョンには使えません。マイナーアップデート時であっても初期化して使うか、アイテムを登録し直す必要があります。

通常モードの初期化が終わりましたら、いよいよメインとなるキーにホットキーを割り当てていきます。

±Aボタンにホットキーを割り当てる

この記事では一例として、②のマイナスAボタンにアルファベットの「Oキー」を、①のプラスAボタンに「Pキー」を割り当てています。ですがこのキーに限らず、お好みのキーを割り当てて作業をして下さい😊

ホットキーを割り当てた場合、それを今後も使いたい場合は必ずZbrush側で保存して下さい。そうしないとZbrush再起動でホットキー割り当てが無効になります。

スライダをホットキーで制御する

いよいよ本題の操作です。

1. ブラシカーソルをスライダアイテムの上に重ねる
2. ±Aキーに割り当てたホットキーを押す（例えば＋AにPキー、－Aに Oキー）
3. Step A値で指定したステップ量ごとにスライダが変化する

ブラシカーソルをスライダに重ねてホットキーを押すだけ。簡単にスライダの数値を変更できます。ホットキー2つあればOKです。

ステップ量はユーザーがキーボードで指定することもできます。また以下のクイックボタンをクリックすることで規定値に素早く変更可能です。

キャンバス上でブラシの直径も制御可能🏆

ブラシカーソルがキャンバス上にある状態で（±Aボタンに割り当てた）ホットキーを押すと、ブラシの直径が変化します。ブラシカーソルがキャンバス上にある状態でOキーやPキーを押してみて下さい。

ホットキーを押したとき、

• ブラシカーソルがキャンバス上にあるとブラシの直径が大きくなる
• ブラシカーソルがスライダ上にあるとスライダ値が大きくなる

本来ならばブラシの直径の変更とスライダ値の変更のためには合計で4つのホットキーが必要ですが、当プラグインの便利機能によって2つのホットキーだけで済みます。数少ないホットキーを消費せずに済みます😊また使い勝手もとてもよいです。

【制限モード】初期化とファイルの確認

ここまでの説明と手順を実施して挙動を理解した後に、もし制限モードで使用したい場合の設定手順を解説します。

• Zbrushを終了させる
• YtSteppingSliderDataフォルダを別の場所にコピペしてバックアップしておく
  （念のため。動作確認後にバックアップを削除して構いません。）
• YtSteppingSliderDataフォルダ内の②AllowedBtns202X.YY.zvrというファイルを削除
  （202X.YYとはZbrushのバージョンのことです）
• Zbrushを起動させる
• 下図の①の1ボタンをクリックする
  （下図の②AllowedBtns202X.YY.zvrが新規作成される）

操作したいスライダの登録

当プラグインでは初期状態ではどのスライダも操作することができません。通常モードの場合は自動でスキャンしたスライダが登録されますが、制限モードでは手動で登録する必要があります。

多くの場合、あとからユーザー様ご自身の操作によって「操作したいスライダの登録や解除」が必要になります。

登録用のホットキーを一時的に割り当てる

この記事では仮に、スライダアイテムの①登録解除用に「6キー」を、②登録用に「7キー」を割り当てた例で説明しています。ですがこのキーに限らず、お好みのキーを割り当てて作業をして下さい😊

登録用のホットキーは常時使用しなくてもOKです。ですので登録作業を行なうときに「一時的に」ホットキーを割り当ててもらえればそれで問題ありません。必要なスライダアイテムの登録が終わりましたら、もう登録用のホットキーを使う必要がありません。Zbrush終了時にホットキーを保存しなければZbrush再起動時に元に戻っています。

もちろん登録と解除用のホットキーを常に割り当てたままでも問題ありません。

スライダの登録＆解除の手順

スライダの登録はとても簡単です。

1. ブラシカーソルをお好みのスライダの上に重ねる
2. 先ほど登録した「登録ボタン」のホットキーを押す（例えば7キー）
3. 「登録しました」というダイアログが2秒ほど表示されて消える

これで登録完了です。もし何度も同じアイテムを登録しようとしても「既に登録されています」というダイアログが表示され、自動で消えます。

同様の操作でスライダアイテムの上にブラシカーソルを重ねて「登録解除ボタン」のホットキーを押せば登録が解除されます（例えば6キー）。そして登録されていないアイテムの登録解除の場合でも同様に「既に登録解除されています」というダイアログが表示されて、自動で消えます。

このように、簡単に登録できて簡単に登録解除できる仕組み作りにとても苦労しました😭

登録状況はリアルタイムでユーザー設定ファイルに上書き保存されます。

自動登録されなかったスライダを登録してみよう

通常モードの場合でも、約2割のスライダが自動で登録されません😭

例えばアルファ＞バスレリーフ＞レリーフコントラストを操作してみて下さい。

通常モードでは初期化で登録されていないスライダです。これはこのスライダの範囲が0から1までであり、Zbrush起動時の値が0であるため、自動登録されなかった例です。

登録して操作できることを確認し、不要ならば登録を解除しておきましょう。

（Tips💡）ボタンの操作にも使える

押しボタンやトグルボタンについても、登録できる場合には当プラグインで押し操作が可能です。

• 押しボタンの場合、＋Aキーのホットキーで押し操作となる
• トグルボタンの場合、Step A値が1の場合、＋Aキーで押した状態、マイナスAキーで押していない状態となる
  （Step A値が1以外の場合には動作が不安定です。推奨しません。）

ですがこの機能は当プラグインの主な目的ではありません。そのため全てのボタンで押し操作できることを保証していません。あくまでも裏技的な使い方です。

一時的なホットキーの削除方法

もししばらくの間、登録用ホットキーを何度も使いたい場合には以下の操作は不要です。Zbrush側でホットキーを保存し、次の章に進んで下さい。

制限事項

当プラグインにはいくつか制限事項がございます。現在の仕様上の制限です。

セーフティー機能について

Zbrushではとてつもなくポリゴン数が多い状態でZRemesherなどを利用した場合、処理に数秒以上かかります。あるいはポリゴン数が多い状態でツール＞変形＞回転などさせた場合です。その場合、Zbrush側での処理待ち状態となりますが、その状態でもしユーザー様が誤ってブラシカーソルを他のスライダやボタンに重ねてしまい、意図しないアイテムの状態が変化するかも知れません。場合によってはZbrushが落ちるかも知れません。

そういったトラブルを事前に回避するために、当プラグインでは事前にユーザー様が登録したアイテムのみを制御できるようなセーフティー機能を実装しています。言い換えると「登録していないスライダやボタン類は当プラグインでは制御していません。」

スムーズ＆マスクブラシは操作対象外

スムーズブラシはShiftキーを、マスクブラシはCtrlキーを押し続けたときとそれらを離したときとでスライダ値が異なるスライダがあります。例えばZ強度（Z Intensity）や焦点移動（Focal Shift）などです。ですのでスムーズブラシとマスクブラシは修飾キーの押し状態によってスライダの状態が異なります。

現在の当プラグインの実装では、基本キーを押し続けた場合に連続入力させることを優先したため、修飾キーが押されている場合のホットキーの動作はサポートしていません。そのため必然的にスムーズブラシとマスクブラシのスライダ操作を当プラグインで行なうことはできません。

スムーズブラシとマスクブラシのスライダ操作はユーザー様が手動で行なって下さい😱

操作できない状況がある

スペースキー押し時のポップアップウィンドウアイテムでは動作しません

スペースキーを押したときに表示されるポップアップウィンドウ内のアイテムについては、当プラグインのみならず全てのプラグインを使うことができません。これはZbrushの仕様です。申し訳ございません😭

Zbrush内で新規ウィンドウが開いた場合は操作できません

例えばツール＞サーフェス＞ノイズ（ノイズメーカー）機能などZbrush内で新規にウィンドウが開く場合には、当プラグインが動作しません。当プラグインに限らず全てのマクロやプラグインが新規ウィンドウ内で動作しません。これはZbrushの仕様です。

IDが0～100のアイテムは登録できません

ウィンドウIDが0～100のスライダやボタン類はZscriptのバグにより正常に処理できません😭具体的には以下の赤枠内①②に含まれる全てのボタンとスライダです。

そこで当プラグインではそれらのスライダーやボタンの登録および制御に制限を設けております。これは仕様です。例外として以下の6つのスライダアイテムについてのみ、例外処理を施した上で当プラグインで制御可能となるように実装しています。

1. Tool:SubTool:Visible Count
2. Tool:SubTool:Res
3. Tool:SubTool:Polish
4. Tool:SubTool:Dist
5. Tool:SubTool:Mean
6. Tool:SubTool:PA Blur

地味に手間のかかる作業でした。

カスタムメニューのポップアップウィンドウ上での制限

Zbrushの標準機能として、カスタムメニューを作成してそれにホットキーを割り当てると、ホットキーでカスタムメニューをポップアップ表示させることができます。ただしこのポップアップウィンドウでは次の3つのZbrushプラグインのスライダを制御することはできません。

1. 3Dプリントハブ
2. デシメーションマスター
3. スケールマスター

「3Dプリントハブ、デシメーションマスターやスケールマスターの連動型スライダ」は、ホットキーで呼び出すカスタムメニューのポップアップウィンドウ上で操作できません。操作しようとするとポップアップウィンドウが閉じます。これは残念ながら当プラグインの仕様です。

なお、上記のような連動型スライダ以外のスライダはポップアップウィンドウ内で制御可能です。

添付の「EnterEsc.exe」について

EnterEsc.exeのコード内容はDataフォルダに添付の「EnterEsc.ahk」というテキストファイルに書いてあります。この実行ファイルはAuto Hot Keyというオープンソースのソフトウェアで作られています。

実行ファイルの動作内容に不安がある人はご自身でahkソースファイルをexeファイルにコンパイルして下さい。

Mac利用時の制限事項

前述した連動型スライダ操作時にはAボタンのホットキー2回押しで1回分の操作になる。

Mac版の場合、「連動型スライダ」操作時には「Aボタンを2回押すとようやく1回分の動作」になります。これの回避にはキーボード操作をZscript以外の、OSレベルで行なう必要があります。Windows利用時にはDataフォルダ内にあるEnterEsc.exeファイルによって「1回操作で1回実行」を実現させています。それに対してMac版ではそもそもexeファイルが実行できません。

Mac利用時にはexeファイルを利用できないので、Aボタンのホットキーを2回押して1回分の動作となります。ですがホットキーを押し続けている時には問題になりません。ほぼ利用できる状態と言っていいでしょう（快適ではないが、使えるレベル）。ホットキーを連打するときに少し苦労するくらいで、他の挙動はWindowsと同じなので、Macでもほぼ利用できると言っていいと思います。

「連動型スライダ」ではないスライダについてはMac利用時でも1回押しで1回動作します。

±Aボタンには基本キー割り当てを強く推奨

±Aボタンに割り当てたホットキーがa～zや0～9、シフトキーを押さずに入力できる記号などの基本キーのみの場合は、基本キーを押し続けることで連続操作が可能です。

しかしながら、Ctrl, Shift, Altなどの修飾キーを組み合わせた場合、Zbrush側の仕様によって修飾キー＋基本キーを押し続けても正しく動作しません。具体的には以下の通り。

これは当プラグインの仕様ではなく、Zbrushの全てのホットキーについて共通する現象です😭

ただし左手デバイスでボタンを押し続けている場合に、例えば「Shift + Pキー」というワンセットのコンビネーションキーを何度も送信できるようになっているデバイスの場合には、修飾キーを組み合わせた場合でも正常に動作します。ゲーミングキーボードのマクロ機能などでも同様だと思われます。
その際には修飾キーを組み合わせたホットキーを当プラグインの±Aキーに割り当て可能です。

ですがその場合であっても当プラグインの今の実装ではスムーズブラシとマスクブラシのスライダを操作できません。

Zbrush 2022 特有の制限事項

Zbrush 2022.0.8には2023とは異なる特有のバグがあります。そのためZbrush 2022で当プラグインをご利用の場合、Zbrush 2022特有の制限があります。

登録できないアイテム一覧

例えばZbrush 2022では以下のアイテムを当プラグインに登録することができません。理由はウインドウIDが他のボタンと重複していることによってウィンドウIDとボタンが1対1になっていないためであり、かつスライダアイテムとして当プラグインで操作することはないアイテムだと判断したためです。

重複IDでも登録できるアイテム一覧

同様にIDと複数のボタンパスの重複問題の対策として、以下の一部のスライダアイテムとIDとを強制的に1対1となるように当プラグイン内で紐付けすることで、以下の主要なスライダアイテムも当プラグインによって操作可能としています。

不具合はお問い合わせ下さい

Zbrush由来のバグについてはおよそ対処できたと思っていますが、完璧ではないかも知れません。もし不具合を発見した場合にはお手数ですがこちらからお問い合わせ下さい。

FAQ（よくある質問）

スライダーが変化しない？

スライダなどのアイテムを当プラグインに登録して下さい。あるいは初期化ボタンを押して初期化して下さい。

初期化もしていない初期状態ではどのスライダーも未登録であるため動作しません。これは「ユーザーが意図しないスライダを誤操作することを防止するため」の安全対策です。

初期化ボタンによりZbrushの約8割のスライダが自動登録されます。多くのユーザー様にとってはこれで問題なく使い出せると思います。自動登録されない未登録スライダについてはお手数ですが各自で必要に応じて登録してお使い下さい。

昨日まで使えていたのに今日突然使えなくなった

ごく稀に、他者製プラグインをインストールしたりアンインストールしたりすることで当プラグインの動作に不具合が発生する場合があります。その場合には初期化を実行するか、操作したいアイテムを登録解除＆再登録してみて下さい。正常に登録されていても操作できない場合はバグの可能性があります。一度お問い合わせ下さい。

登録済みスライダーやトグルボタンが変化しない？

ステップ量を確認して下さい。

スライダに対してステップ量が小さすぎたり大きすぎたりしているとスライダが適切に変化しません。スライダーに対してステップ量が小さすぎる場合、スライダーがわずかに移動したように見えますが数値が変化していない場合があります（これはZbrush側の仕様です）。適切なステップ量を指定してお試し下さい。
ボタンの状態がON/OFFに切り替わるトグルボタンの場合にはステップ量を1にしてお試し下さい。

それでも動作しない場合には初期化を実行するか、操作したいアイテムを登録解除＆再登録してみて下さい。正常に登録されていても操作できない場合はバグの可能性があります。一度お問い合わせ下さい。

ドローサイズを0.1ずつ変化させているのになぜか突然「12.50001」や「12.29999」のようなわずかな誤差が含まれる

これはZbrushの仕様、おそらくはZscriptの仕様です。プラグインの挙動としては元の数値に±0.1などの演算を繰り返しているだけですが、小数点以下の演算をするとときどきこのような現象が生じます。当プラグインのバグではございません。

Zbrushをアップデートしたらプラグインが使えなくなった

初期化を実行するか、操作したいアイテムを登録解除＆再登録してみて下さい。

当プラグインのユーザー設定ファイルはZbrushのバージョンごとに作成されます。

マイナーアップデートも含めて、別バージョンのユーザー設定ファイルを使うことができません。ユーザー設定ファイルを新規作成して下さい。

ときどきボタンパスの文字列ではなくて数字が登録される？

正常です。当プラグインではZbrush側の重複IDのバグ回避や重複ボタンパスのバグの回避のために、意図的に一部のボタンパスについては文字列ではなくウィンドウIDを扱う場合があります。

【バグレポート】ブラシカーソルの下にない別のアイテムが変化する

それはおそらく当プラグインのバグです😭発見された場合にはお手数ですがこちらまでご連絡下さい。なおその場合には以下の点を最初に報告して頂ければ対処が早まります。

• 体験版か、製品版か？当プラグインのバージョン番号は？（当プラグインのVer.ボタンで確認できます。）
• Zbrushのバージョンは？
• 登録しようとしたアイテムのボタンパスは？
  （カーソルを重ねてCtrlキーを押し続けるとウィンドウの最下段にボタンパスの文字列が表示されます。例えば Tool:SubTool:PA Blur、など。）
• 間違って動いてしまうアイテムのボタンパス文字列を教えて下さい。
• 登録した直後から動作が異常か？それとも登録時は正常でZbrush再起動後の動作がおかしいのか？

インターフェースの日本語以外の対応は？

英語に対応しています。またGoogle翻訳ではありますが、当プラグインでは特別に試験的に韓国語インターフェースにも対応しています。ただし当方は韓国語がサッパリ分かりませんので、あくまでもGoogle翻訳で日英と韓国語の相互翻訳にて「ほぼ合っているだろう」という文字列を韓国語ファイルとして添付してあります。オマケ機能です。翻訳ボランティアを募集中です。詳細はこちらからお問い合わせ下さい。

登録可能なアイテムの上限は？

2,000個です。通常モードで初期化した場合、約1,000個ほどのスライダが登録されます。もし個人開発のマクロや他者製のプラグインを導入している場合、そこから数百個ほどが登録される可能性があります。私の場合は約1,200個ほど登録されました。ほとんどのユーザー様におかれましては、登録可能なアイテムが最大2,000個もあれば十分だと考えております。

ときどきスライダの赤色がちらつく

その現象は、「3Dプリントハブ、デシメーションマスターやスケールマスターなどの特定のZbrushプラグインのスライダ」を操作した場合に発生します。仕様です。正常にスライダを制御するための工夫の結果です。制御動作に支障はございません。

3Dプリントハブプラグインのインポートオプション▶、エクスポートオプション▶内のスライダを操作すると表示領域が閉じる

3Dプリントハブプラグインの仕様です。そのため当プラグインではそのオプション内のスライダを制御できません。

ほかのZbrushプラグインのスライダのうち、マウスやブラシ操作時には他のスライダが連動して変化するが、このプラグインで操作するとその連動操作が発動しない

恐らく当プラグインでは対応していないブラグインの連動型スライダだと思います。前述のFAQにある【バグレポート】と同様にボタンパスなどの情報をお知らせ下さい。アプデで対応できる場合があります。（必ずしも対応をお約束するものではございません。ご了承下さい。）

今のところ、3Dプリントハブ、デシメーションマスター、スケールマスターに対応しております。