ジャンプ先: 概要. 戻り値. 関連. フラグ. Python 例.

概要

selectPref([affectsActive=boolean], [allowHiliteSelection=boolean], [autoSelectContainer=boolean], [autoUseDepth=boolean], [clickBoxSize=uint], [clickDrag=boolean], [containerCentricSelection=boolean], [disableComponentPopups=boolean], [expandPopupList=boolean], [ignoreSelectionPriority=boolean], [manipClickBoxSize=uint], [paintSelect=boolean], [paintSelectWithDepth=boolean], [popupMenuSelection=boolean], [preSelectBackfacing=boolean], [preSelectClosest=boolean], [preSelectDeadSpace=uint], [preSelectHilite=boolean], [preSelectHiliteSize=float], [preSelectTweakDeadSpace=uint], [selectionChildHighlightMode=int], [singleBoxSelection=boolean], [trackSelectionOrder=boolean], [useDepth=boolean], [xformNoSelect=boolean])

注: オブジェクトの名前と引数を表す文字列は、カンマで区切る必要があります。これはシノプシスに示されていません。

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

このコマンドは、UI 動作を選択するために使用する状態変数を制御します。

戻り値

boolean照会モードのみ

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

関連

select, selectKey, selectMode, selectPriority, selectType, selectedNodes

フラグ

affectsActive, allowHiliteSelection, autoSelectContainer, autoUseDepth, clickBoxSize, clickDrag, containerCentricSelection, disableComponentPopups, expandPopupList, ignoreSelectionPriority, manipClickBoxSize, paintSelect, paintSelectWithDepth, popupMenuSelection, preSelectBackfacing, preSelectClosest, preSelectDeadSpace, preSelectHilite, preSelectHiliteSize, preSelectTweakDeadSpace, selectionChildHighlightMode, singleBoxSelection, trackSelectionOrder, useDepth, xformNoSelect
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
affectsActive(aa) boolean createquery
影響アクティブな切り替えを設定します。影響アクティブな切り替えがオンに設定されていると、オブジェクト モードとコンポーネント モードとの変更時にアクティブ リストが影響を受けるようになります。
allowHiliteSelection(ahs) boolean createquery
コンポーネント モード時に、編集のためにオブジェクトを選択できるようにします。編集のためにオブジェクトが選択した場合、オブジェクトはハイライト カラーで表示され、オブジェクトの選択可能なコンポーネントが自動的に表示されます。
autoSelectContainer(asc) boolean query
コンテナ中心の選択がオンの状態で有効にすると、ルート トランスフォームをビューポートで選択するたびに、コンテナ ノードも自動的に選択されます。
autoUseDepth(aud) boolean query
有効にすると、useDepth および paintSelectWithDepth がシェーディング表示モードでは自動的に有効になり、ワイヤフレーム表示モードでは無効になります。
clickBoxSize(cbs) uint createquery
クリック選択時の、カーソルを囲む正方形の選択領域のサイズを定義します。正方形のサイズは、指定した値の 2 乗になります。つまり、この値はカーソル位置から四方の領域の量を定義します。サイズは正の値でなければなりません。
clickDrag(cld) boolean createquery
クリック/ドラッグによる選択操作をオン/オフに設定します。
containerCentricSelection(ccs) boolean query
有効の場合、ビューポートのコンテナにある任意の DAG ノードを選択すると、コンテナのルート トランスフォームがあればこれが選択されます。ルート トランスフォームがない場合、コンテナ内で最上位の DAG ノードが選択されます。コンテナに入っていないノードを選択しても何も起こりません。
disableComponentPopups(dcp) boolean createquery
コンポーネントを選択したときにユーザがポップアップ メニューを無効にすることができる別個のプリファレンス。このプリファレンスは、popupMenuSelection プリファレンスが有効の場合のみ意味を持ちます。
expandPopupList(epl) boolean createquery
ポップアップ セレクション モード時にこれが設定されている場合、複数のオブジェクトまたはコンポーネントを含むすべての選択項目が展開され、各オブジェクトまたはコンポーネントが単一の新しい選択項目になります。
ignoreSelectionPriority(isp) boolean createquery
これが設定されている場合、選択を実行する際の選択の優先順位は無視されます。
manipClickBoxSize(mcb) uint createquery
マニピュレータ選択時の、カーソルを囲む正方形の選択領域のサイズを定義します。正方形のサイズは、指定した値の 2 乗になります。つまり、この値はカーソル位置から四方の領域の量を定義します。サイズは正の値でなければなりません。
paintSelect(ps) boolean query
有効にすると、選択ツールはセレクション ボックス選択の代わりにドラッグ選択を使用します。
paintSelectWithDepth(psd) boolean query
有効にすると、ペイント選択で現在のカメラ ビュー内のサーフェスの後ろにあるコンポーネントは選択されません。
popupMenuSelection(pms) boolean createquery
これが設定されている場合、ポップアップ メニューが表示され、選択するオブジェクトを決定するために使用されます。メニューには、選択した候補オブジェクトの現在のユーザ フィールド(マーキー)がリストされます。
preSelectBackfacing(psb) boolean query
有効にすると、事前選択で法線がカメラの方を向いていないバックフェース側のコンポーネントがハイライト表示されます。
preSelectClosest(psc) boolean query
有効にしてカーソルがサーフェス上にある場合、事前選択ハイライトでは距離に関係なくカーソルに最も近いコンポーネントを事前選択しようとします。
preSelectDeadSpace(pds) uint query
この値は、カーソルがサーフェスの外側にある場合の事前選択ハイライトに使用する、カーソル周囲の領域のサイズを定義します。
preSelectHilite(psh) boolean query
有効にすると、カーソルの下にある最も近いコンポーネントがハイライト表示され、これをクリックするとそのコンポーネントが選択されることを示します。
preSelectHiliteSize(phs) float query
この値は、事前選択ハイライトに使用するカーソル周囲の領域のサイズを定義します。この領域内のカーソルに最も近いコンポーネントがハイライト表示されます。
preSelectTweakDeadSpace(pdt) uint query
この値は、微調整モードでカーソルがサーフェスの外側にある場合の事前選択ハイライトに使用する、カーソル周囲の領域のサイズを定義します。
selectionChildHighlightMode(sch) int createquery
選択されたオブジェクトの子のハイライトを制御します。有効なモードは、0: 常に子をハイライト(Always highlight children)、1: 子をハイライトしない(Never highlight children)、2: オブジェクトごとに "選択項目の子をハイライト" 設定を使用(Use per-object "Selection Child Highlight" setting)です。既定モードは、(0): 常に子をハイライト(Always highlight children)です。(2)の場合、各 DAG オブジェクトには、"選択項目の子をハイライト(Selection Child Highlight)"ブーリアン フラグが個別にあります。既定では、このフラグは TRUE になります。モード(2)を有効にすると、コントロールは、選択したオブジェクトの "選択項目の子をハイライト(Selection Child Highlight)" フラグに従います。
singleBoxSelection(sbs) boolean createquery
単一のフィールド選択をオン/オフに設定します。このフラグが true に設定されている場合、ユーザ フィールド(マーキー)で複数のオブジェクトが選択したときに単一のオブジェクトだけが選択されます。このフラグが false に設定されている場合は、フィールド内のすべてのオブジェクトが選択されます。
trackSelectionOrder(tso) boolean query
有効にすると、選択したオブジェクトとコンポーネントの順番を返します。'ls' コマンドは、スクリプトを記述する選択順のアクティブなリストを返せるようになります。
useDepth(ud) boolean query
有効にすると、セレクション ボックス選択で現在のカメラ ビュー内のサーフェスの後ろにあるコンポーネントは選択されません。
xformNoSelect(xns) boolean createquery
xform ツールでの選択を無効にします。

フラグはコマンドの作成モードで表示できます フラグはコマンドの編集モードで表示できます
フラグはコマンドの照会モードで表示できます フラグに複数の引数を指定し、タプルまたはリストとして渡すことができます。

Python 例

import maya.cmds as cmds

cmds.selectPref(popupMenuSelection=True,disableComponentPopups=True)