ジャンプ先: 概要. 戻り値. キーワード. 関連. フラグ. Python 例.
hudButton([string], [allowOverlap=boolean], [block=int], [blockAlignment=string], [blockSize=string], [buttonShape=string], [buttonWidth=int], [label=string], [labelFontSize=string], [padding=int], [pressCommand=script], [releaseCommand=script], [section=int], [visible=boolean])
注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。
hudButton は、取り消し不可能、照会可能、および編集可能です。
このコマンドは、3D ビューポート上にある 2D の非アクティブ オーバーレイ プレーンに配置されるヘッドアップ ディスプレイ(HUD)のボタン コントロールを作成します。このコマンドを使用して、ユーザ スクリプトで実際的な操作を指定できます。HUD ボタンは一般的な HUD オブジェクトから派生するため、同様のワークフローを継承します。
このコマンドの機能は headsUpDisplay コマンドによく似ていますが、layoutVisibility、nextFreeBlock、lastOccupiedBlock、exists、remove などの headsUpDisplay レイアウト コントロールは利用できません。レイアウト コントロールを利用する場合は、headsUpDisplay コマンドを使用してください。このコマンドは、HUD ボタン コントロールの作成と管理に特化しています。同様に、このコマンドで実行される操作はボタン コントロールになる HUD のみを対象としています。
作成時に必要なフラグは、section フラグと block フラグのみです。
headsUpDisplay コマンドと同様に、HUD ボタンを作成すると、ID 番号が割り当てられます。必要に応じて、この ID 番号を使用して headsUpDisplay コマンド(-rid/removeID [int IDNumber])で HUD を除去することができます。あるいは、HUD オブジェクトをそれらの位置(セクションとブロック)やそれぞれの固有名を使用して除去することもできます。
int | ヘッドアップ ディスプレイ(HUD)の ID 番号 |
string|int|int[2] | 対応する除去コマンドのヘッドアップ ディスプレイの名前、ID またはセクション、ブロック値。 |
照会モードでは、戻り値のタイプは照会されたフラグに基づきます。
hud, headsupdisplay, button, hudbutton
button, headsUpDisplay
allowOverlap, block, blockAlignment, blockSize, buttonShape, buttonWidth, label, labelFontSize, padding, pressCommand, releaseCommand, section, visible
フラグはコマンドの作成モードで表示できます
|
フラグはコマンドの編集モードで表示できます
|
フラグはコマンドの照会モードで表示できます
|
フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。
|
import maya.cmds as cmds
# Define a "Hello!" counter procedure. This procedure will output
# "Hello! [number]"
# each time it is run. The number is incremented at the end of each call.
#
gHelloCount = 0
def HUDButtonHello(*args):
global gHelloCount
print 'Hello!( %i )' % gHelloCount
gHelloCount += 1
# Now create our button. Only execute on mouse release.
#
cmds.hudButton('HUDHelloButton', s=7, b=5, vis=1, l='Button', bw=80, bsh='roundRectangle', rc=HUDButtonHello )