hudSliderButton

ジャンプ先: 概要. 戻り値. キーワード. 関連. フラグ. MEL 例.

概要

hudSliderButton [-allowOverlap boolean] [-block int] [-blockAlignment string] [-blockSize string] [-buttonLabel string] [-buttonLabelFontSize string] [-buttonPressCommand script] [-buttonReleaseCommand script] [-buttonShape string] [-buttonWidth int] [-decimalPrecision int] [-internalPadding int] [-maxValue float] [-minValue float] [-padding int] [-section int] [-sliderDragCommand script] [-sliderIncrement float] [-sliderLabel string] [-sliderLabelFontSize string] [-sliderLabelWidth int] [-sliderLength int] [-sliderPressCommand script] [-sliderReleaseCommand script] [-type string] [-value float] [-valueAlignment string] [-valueFontSize string] [-valueWidth int] [-visible boolean] [string]

hudSliderButton は、取り消し不可能、照会可能、および編集可能です。

このコマンドの機能は headsUpDisplay コマンドによく似ていますが、layoutVisibility、nextFreeBlock、lastOccupiedBlock、exists、remove などの headsUpDisplay レイアウト コントロールは利用できません。レイアウト コントロールを利用する場合は、headsUpDisplay コマンドを使用してください。このコマンドは、HUD スライダ ボタン コントロールの作成と管理に特化しています。同様に、このコマンドで実行される操作はスライダ ボタン コントロールになる HUD のみを対象としています。

作成時に必要なフラグは、section フラグと block フラグのみです。

headsUpDisplay コマンドと同様に、HUD スライダ ボタンを作成すると、ID 番号が割り当てられます。必要に応じて、この ID 番号を使用して headsUpDisplay コマンド(-rid/removeID [int IDNumber])で HUD スライダを除去することができます。あるいは、HUD オブジェクトをそれらの位置(セクションとブロック)やそれぞれの固有名を使用して除去することもできます。

戻り値

照会モードでは、戻り値のタイプは照会されたフラグに基づきます。

キーワード

関連

フラグ

ロング ネーム(ショート ネーム)	引数タイプ	プロパティ
-allowOverlap(-ao)	boolean
重なっているセクションの幅や制限に関わらず、ヘッドアップ ディスプレイを表示します(詳細については、-s/section フラグの説明を参照してください)。
-block(-b)	int
セクション内で、HUD が属する個々のブロックを表します。各セクションは一列のブロックから構成されます。各セクションに含まれるブロックの総数は異なります。 各セクションに表示されるブロック数は、各セクションにあるブロックのサイズとウィンドウの現在のサイズによって決まります。ブロック数は 0 から始まり、必要に応じて増加します。 HUD スライダのフォーマットは、標準的な HUD とは異なります。フォーマット フラグ(justify、padding、buttonWidth など)で定義するパラメータを使用するレイアウトは、次のとおりです。 __________________________________________________________________________ | | | | | | | | | | | | P | J | LW | Slider | IP | Value | IP | Button | J | P | |_____|_____|______|___________|______|_______|______|________|_____|_____| P = 幅のサブブロック、パディング J = ブロック全体の行端揃え LW = 幅のサブブロック、labelWidth Slider = スライダの長さ SliderValue = 幅のサブブロック、valueWidth Button = 幅のサブブロック、buttonWidth IP = 内部パディング ブロックの位置決め 上部セクションのブロックは主要ビューポートの上端から始まり、下部セクションは下端から始まります。ブロックは、ビューポートの中間から動的に非表示になります。したがって、比較的多いブロック数はビューポートへと引き寄せられません。 最後に、単一ブロックを占有できる HUD の数は一つです。占有されているブロックに HUD をさらに配置しようとするとエラーになります。HUD を配置する際の注意点です。
-blockAlignment(-ba)	string
ブロックの、その列内での位置合わせを指定します。使用可能な位置合わせは「center」、「left」、「right」で、既定は「left」です。
-blockSize(-bs)	string
各ブロックの高さを設定します。選択できる高さは、small、medium、large です。ピクセル単位では、それぞれ 20、35、50 ピクセルに相当します。
-buttonLabel(-bl)	string
HUD ボタンのテキスト ラベル。
-buttonLabelFontSize(-bfs)	string
ボタン ラベルのフォント サイズを設定します。使用可能なサイズは small と large です。
-buttonPressCommand(-bpc)	script
ボタンでマウスをクリックしたときに実行するプロシージャまたはスクリプトを指定します。
-buttonReleaseCommand(-brc)	script
ボタンでマウスを放したときに実行するプロシージャまたはスクリプトを指定します。
-buttonShape(-bsh)	string
ボタンのシェイプを指定します。使用可能なボタンのシェイプは、「rectangle」と「roundRectangle」です。「rectangle」は四角形のボタン、「roundRectangle」は角が丸い四角形ボタンです。
-buttonWidth(-bw)	int
ボタンの幅を指定します。
-decimalPrecision(-dp)	int
コマンドが返す浮動小数点値の小数精度を設定します。精度値の有効範囲は、1～8 です。
-internalPadding(-ip)	int
HUD の内部要素間のパディング数を指定します。hudSlider の場合、これはスライダ バーとスライダ値の間のパディングを表します。既定のパディングは 10 です。
-maxValue(-max)	float
スライダの最大値を指定します。注: このフラグは float を引数として使用しますが、HUD タイプが「int」(整数)の場合、この値は自動的に整数に変換されます。
-minValue(-min)	float
スライダの最小値を指定します。注: このフラグは float を引数として使用しますが、HUD タイプが「int」(整数)の場合、この値は自動的に整数に変換されます。
-padding(-p)	int
ブロックの左右マージンの幅を指定します。既定値は 15 ピクセルです。
-section(-s)	int
HUD を表示させるセクションを定義します。画面は 10 セクションに分割されています。メイン ビューポートを分割する 10 の要素行列は、5 列 x 2 行で構成されます。セクションのレイアウトを以下に示します。 ________________________ | | | | | | | | | | | | | 0 | 1 | 2 | 3 | 4 | | | | | | | |____|____|____|____|____| | | | | | | | | | | | | | 5 | 6 | 7 | 8 | 9 | | | | | | | |____|____|____|____|____| 各セクションは、上記のとおり 0 から 9 までの番号で表されます。たとえば、上列の左から 2 行目の場合、セクションは次のように定義されます。-sec 1 ヘッドアップ ディスプレイが重なり合って文字が煩雑になることを回避するため、それぞれの行には表示の優先順位が定義されていて、各セクションの表示にも優先順位が設定されています。この優先順位に従って、画面スペースが狭まって行のセクション幅が重なり合うと、HUD は優先順位が一番低いセクションを自動的に除去します。これらのセクションは非表示になり、除去されたことを伝える警告メッセージが表示されます。この処理は、最優先のセクションのみが残るまで継続されます。 それぞれの行の優先順位は、次のように定義されます。上列の場合の例: セクション 0 が最優先され、セクション 4 が 2 番目と、外側のセクションの優先順位が最も高くなります。次にセクション 2 、続くセクション 1 と 3 の優先順位は等しく、共に優先順位が最も低くなります。この優先順位の構造は、下列にも適用されます。外側の 2 セクションが最優先され、中央のセクションが続き、残りの 2 セクションの優先順位が最も低くなります。 つまりビューポートの幅が狭まって上列のセクションが重なり始めた場合、まずセクション 1 と 3 がビューから除去され、続いてセクション 2 が、最後にセクション 4 が除去されます。ブロック レイアウトについても、同様の説明が以下に記されています。
-sliderDragCommand(-sdc)	script
スライダでマウス ボタンをドラッグしたときに実行するプロシージャまたはスクリプトを指定します。
-sliderIncrement(-si)	float
スライダの増分数を指定します。この値を設定しない、または 0 以下に設定した場合にスライダは minValue から maxValue まで、リニアに均一で連続的になります。注: このフラグは float を引数として使用しますが、HUD タイプが「int」(整数)の場合、この値は自動的に整数に変換されます。
-sliderLabel(-sl)	string
HUD スライダのテキスト ラベル。
-sliderLabelFontSize(-sfs)	string
スライダ ラベルのフォント サイズを設定します。使用可能なサイズは small と large です。
-sliderLabelWidth(-slw)	int
ラベルを保持する仮想「テキストボックス」のピクセル幅を指定します。この「テキストボックス」の内容は左揃えにされます。ラベルの実際の幅が「テキストボックス」の幅を超える場合、「テキストボックス」の寸法に合わせてラベルが切り捨てられます(ブロックのレイアウトを確認する場合は、-block フラグの説明を参照してください)。
-sliderLength(-sln)	int
スライダの長さを、ピクセル単位で指定します。
-sliderPressCommand(-spc)	script
スライダでマウスをクリックしたときに実行するプロシージャまたはスクリプトを指定します。
-sliderReleaseCommand(-src)	script
スライダでマウス ボタンを放したときに実行するプロシージャまたはスクリプトを指定します。
-type(-t)	string
HUD の数値のタイプを指定します。使用可能なタイプは、「float」と「int」です。
-value(-v)	float
HUD が有効な HUD スライダである場合、スライダ値を設定または返します。注: このフラグは float を引数として使用しますが、HUD タイプが「int」(整数)の場合、この値は自動的に整数に変換されます。
-valueAlignment(-va)	string
データ ブロックとデータ テキストの、HUD ブロック内での位置合わせを指定します。使用可能な位置合わせは「left」と「right」で、既定は「left」です。
-valueFontSize(-vfs)	string
スライダ値のフォント サイズを設定します。使用可能なサイズは small と large です。
-valueWidth(-vw)	int
スライダ値を保持する仮想「テキストボックス」のピクセル幅を指定します(ブロックのレイアウトを確認する場合は、-block フラグの説明を参照してください)。
-visible(-vis)	boolean
ヘッドアップ ディスプレイのレイアウトの表示(オンかオフ)を切り替えます。

フラグはコマンドの作成モードで表示できます	フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます	コマンド内でフラグを複数回使用できます。

MEL 例

// Define a procedure to execute on press/drag/release. This procedure
// will explicitly set any selected transforms to a given position along
// the X axis based on the value of a given HUD slider.
//
global proc translateXSliderButton( string $HUD )
{
	// Ensure undo enabled since we will just trigger this on the button
	// release event.
	//
	undoInfo -swf true;

	string $selList[] = `ls -sl`;
	int $numItems = size($selList);
	for( $i = 0; $i < $numItems; $i++ )
	{
		string $object = $selList[$i];
		if( `objectType -isType "transform" $object` )
		{
			string $translateX = $object + ".tx";
			float $value = `hudSliderButton -q -v $HUD`;
			setAttr $translateX $value;
		}
	}
}

// Create our slider button
//
hudSliderButton -s 5
				-b 5
				-vis 1
				-sl "Slider:"
				-value 0
				-type "int"
				-min -10
				-max 10
				-slw 50
				-vw 50
				-sln 100
				-si 1
				-bl "Button"
				-bw 60
				-bsh "rectangle"
				-brc "translateXSliderButton( \"HUDTranslateXSliderButton\" )"
				HUDTranslateXSliderButton;