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

概要

artPuttyCtx [-accopacity boolean] [-activeListChangedProc string] [-afterStrokeCmd string] [-alphaclamp string] [-alphaclamplower float] [-alphaclampupper float] [-attrSelected string] [-autosmooth boolean] [-beforeStrokeCmd string] [-brushStrength float] [-brushalignment boolean] [-brushfeedback boolean] [-clamp string] [-clamplower float] [-clampupper float] [-clear] [-collapsecvtol float] [-colorRamp string] [-colorfeedback boolean] [-colorrangelower float] [-colorrangeupper float] [-dataTypeIndex int] [-disablelighting boolean] [-dispdecr] [-dispincr] [-dragSlider string] [-duringStrokeCmd string] [-exists] [-expandfilename boolean] [-exportfilemode string] [-exportfilesave string] [-exportfilesizex int] [-exportfilesizey int] [-exportfiletype string] [-filterNodes] [-history boolean] [-image1 string] [-image2 string] [-image3 string] [-importfileload string] [-importfilemode string] [-importreassign boolean] [-interactiveUpdate boolean] [-invertrefvector boolean] [-lowerradius float] [-mappressure string] [-maxdisp float] [-maxvalue float] [-minvalue float] [-mouldtypemouse string] [-name string] [-objattrArray string] [-opacity float] [-outline boolean] [-outwhilepaint boolean] [-paintNodeArray string] [-paintattrselected string] [-paintmode string] [-polecv boolean] [-profileShapeFile string] [-projective boolean] [-radius float] [-rampMaxColor float float float] [-rampMinColor float float float] [-reflection boolean] [-reflectionaxis string] [-refsurface boolean] [-refvector string] [-refvectoru float] [-refvectorv float] [-selectedattroper string] [-showactive boolean] [-smoothiters int] [-stampProfile string] [-stitchcorner boolean] [-stitchedgeflood] [-stitchtype string] [-surfaceConformedBrushVertices boolean] [-tablet] [-tangentOutline boolean] [-toolOffProc string] [-toolOnProc string] [-updateerasesrf] [-updaterefsrf] [-useColorRamp boolean] [-useMaxMinColor boolean] [-usepressure boolean] [-value float] [-whichTool string]

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

これは、アトリビュート ペイント操作のベース コンテキストである artAttrContext にフラグを設定するためのコンテキスト コマンドです。すべてのコマンドは、最後の引数としてコンテキスト名を必要とします。これは作成、編集、または照会されるコンテキストの名前を表します。このコマンドは、ブラシ ベースのインタフェース(Maya Artisan)で NURBS サーフェスを修正するために使用します。修正するには、ブラシの下にある制御点(cv)を指定した方向に移動します。

戻り値

なし

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

フラグ

accopacity, activeListChangedProc, afterStrokeCmd, alphaclamp, alphaclamplower, alphaclampupper, attrSelected, autosmooth, beforeStrokeCmd, brushStrength, brushalignment, brushfeedback, clamp, clamplower, clampupper, clear, collapsecvtol, colorRamp, colorfeedback, colorrangelower, colorrangeupper, dataTypeIndex, disablelighting, dispdecr, dispincr, dragSlider, duringStrokeCmd, exists, expandfilename, exportfilemode, exportfilesave, exportfilesizex, exportfilesizey, exportfiletype, filterNodes, history, image1, image2, image3, importfileload, importfilemode, importreassign, interactiveUpdate, invertrefvector, lowerradius, mappressure, maxdisp, maxvalue, minvalue, mouldtypemouse, name, objattrArray, opacity, outline, outwhilepaint, paintNodeArray, paintattrselected, paintmode, polecv, profileShapeFile, projective, radius, rampMaxColor, rampMinColor, reflection, reflectionaxis, refsurface, refvector, refvectoru, refvectorv, selectedattroper, showactive, smoothiters, stampProfile, stitchcorner, stitchedgeflood, stitchtype, surfaceConformedBrushVertices, tablet, tangentOutline, toolOffProc, toolOnProc, updateerasesrf, updaterefsrf, useColorRamp, useMaxMinColor, usepressure, value, whichTool
ロング ネーム(ショート ネーム) 引数タイプ プロパティ
-exists(-ex) create
指定したオブジェクトが存在するかどうかによって、true または false を返します。他のフラグは無視されます。
-image1(-i1) string createqueryedit
-image2(-i2) string createqueryedit
-image3(-i3) string createqueryedit
コンテキストは、コンテキストに関連付けられている ツールを表すアイコンを 3 つまでサポートします。
-history(-ch) boolean create
ツール コマンドの場合、対象となるツールの コンストラクション ヒストリをオンにします。
-name(-n) string create
これがツール コマンドの場合、ツールに適切に名前を付けます。
-dragSlider(-dsl) string createedit
(既定のホットキーの 'b' と 'm' のように)ブラシをサイズ変更したりオフセットしたりするため、現在のブラシのドラッグ状態を設定します。文字列引数は次のいずれかです。「radius」、「lowradius」、「opacity」、「value」、「depth」、「displacement」、「uvvector」、または「none」。C: 既定は「none」です。
-opacity(-op) float createqueryedit
ブラシの不透明度を設定します。C: 既定は 1.0 です。Q: 照会すると float を返します。
-accopacity(-aco) boolean createqueryedit
不透明度の塗り重ねをオンまたはオフに設定します。C: 既定は false です(既定が true のスカルプト ツールを除く)。Q: 照会すると boolean を返します。
-radius(-r) float createqueryedit
ブラシのサイズを設定します。C: 既定は 1.0 cm です。Q: 照会すると float を返します。
-lowerradius(-lr) float createqueryedit
ブラシの下限サイズを設定します(タブレットにのみ適用されます)。
-stampProfile(-stP) string createqueryedit
現在のスタンプのブラシ プロファイルを設定します。現在、次のプロファイルがサポートされています。「gaussian」、「soft」、「solid」または「square」。C: 既定は「gaussian」です。Q: 照会すると string を返します。
-profileShapeFile(-psf) string queryedit
スタンプ シェイプのプロファイルにイメージ ファイルの名前を渡します。
-brushalignment(-bra) boolean createqueryedit
パス ブラシの位置合わせを指定します。true の場合はストローク パスに位置合わせ、false の場合はアップ ベクトルに位置合わせます。C: 既定は true です。Q: 照会すると boolean を返します。
-clear(-clr) createedit
CV/頂点のすべてを現在値に塗り潰します。
-usepressure(-up) boolean createqueryedit
タブレット圧力をオンまたはオフに設定します。C: 既定は false です。Q: 照会すると boolean を返します。
-mappressure(-mp) string createqueryedit
タブレットを使用するときのタブレット圧力のマッピングを設定します。次の 4 つの選択肢があります: 「none」- 圧力に影響がない、「opacity」- 圧力が不透明度にマップされる、「radius」- 圧力がブラシ半径を修正するようマップされる、「both」- 圧力が不透明度と半径の両方を修正する。C: 既定は「none」です。Q: 照会すると string を返します。
-outline(-o) boolean createqueryedit
ブラシを描画するかどうかを指定します。C: 既定は true です。Q: 照会すると boolean を返します。
-outwhilepaint(-owp) boolean createqueryedit
ペイント時にブラシの輪郭を描画するかどうかを指定します。C: 既定は false です。Q: 照会すると boolean を返します。
-brushfeedback(-brf) boolean createqueryedit
ブラシの追加のフィードバックを描画するかどうかを指定します。C: 既定は true です。Q: 照会すると boolean を返します。
-showactive(-sa) boolean createqueryedit
サーフェス アイソパラムの表示をオンまたはオフに設定します。C: 既定は true です。Q: 照会すると boolean を返します。
-paintmode(-pm) string createqueryedit
ペイント モードを指定します。次の 2 つの選択肢があります: 「screen」または「tangent」。C: 既定は「screen」です。Q: 照会すると string を返します。
-projective(-prm) boolean createqueryedit
投影ペイント モードを指定します。C: 既定は false です。Q: 照会すると boolean を返します。
-reflection(-rn) boolean createqueryedit
反射モードを指定します。C: 既定は false です。Q: 照会すると boolean を返します。
-reflectionaxis(-ra) string createqueryedit
反射軸を指定します。次の 3 つの選択肢があります: 「x」、「y」、「z」。C: 既定は「x」です。Q: 照会すると string を返します。
-importfileload(-ifl) string edit
指定したファイルのアトリビュート マップをロードします。
-importreassign(-irm) boolean createqueryedit
読み込む時に複数のアトリビュート マップを再割り当てするかどうかを指定します。再割り当てできるマップは、以前にアーティザン(Artisan)から書き出されたマップだけです。C: 既定は false です。Q: 照会すると boolean を返します。
-importfilemode(-ifm) string createqueryedit
読み込むチャネルを指定します。有効なエントリは以下のとおりです: 「alpha」、「luminance」、「red」、「green」、「blue」、「rgb」 C: 既定は「alpha」です。Q: 照会すると string を返します。
-expandfilename(-eef) boolean createedit
true の場合、書き出しファイルの名前を拡張し、サーフェス名と連結します。false の場合、名前をそのまま受け取ります。C: 既定は true です。
-exportfilesave(-esf) string edit
アトリビュート マップを書き出し、指定したファイルに保存します。
-exportfilemode(-efm) string createqueryedit
書き出しチャネルを指定します。有効なエントリは以下のとおりです: 「alpha」、「luminance」、「rgb」、「rgba」。C: 既定は「luminance/rgb」です。Q: 照会すると string を返します。
-exportfilesizex(-fsx) int createqueryedit
書き出すアトリビュート マップの幅を指定します。C:既定幅は 256 です。Q: 照会すると integer を返します。
-exportfilesizey(-fsy) int createqueryedit
書き出すアトリビュート マップの幅を指定します。C:既定幅は 256 です。Q: 照会すると integer を返します。
-exportfiletype(-eft) string createqueryedit
イメージ ファイル フォーマットを指定します。次のいずれかを指定できます: 「iff」、「tiff」、「jpeg」、「alias」、「rgb」、「fit」、「postScriptEPS」、「softimage」、「wavefrontRLA」、「wavefrontEXP」。C: 既定は「tiff」です。Q: 照会すると string を返します。
-tablet(-tab) query
タブレット デバイスが存在する場合は true を、存在しない場合は false を返します。
-surfaceConformedBrushVertices(-scv) boolean createqueryedit
影響を受ける頂点として、有効なブラシ領域の表示を有効化/無効化します。
-tangentOutline(-to) boolean createqueryedit
サーフェスへのブラシ円接線の表示を有効化/無効化します。
-selectedattroper(-sao) string createqueryedit
ウェイト編集操作を設定します。次の 4 つのウェイト編集操作があります: 「absolute」の場合、ウェイト値は現在のウェイトで置き換えられます。「additive」の場合、現在のウェイトにウェイト値が足されます。「scale」の場合、ウェイト値に現在のウェイトが掛けられます。「smooth」の場合、ウェイト値は現在のウェイトで割られます。C: 既定は「absolute」です。Q: 照会すると string を返します。
-filterNodes(-fon) edit
ノード フィルタを設定します。
-value(-val) float createqueryedit
各アトリビュートの値を指定します。C: 既定は 0.0 です。Q: 照会すると float を返します。
-minvalue(-miv) float createqueryedit
各アトリビュートの最小値を指定します。C: 既定は 0.0 です。Q: 照会すると float を返します。
-maxvalue(-mxv) float createqueryedit
各アトリビュートの最大値を指定します。C: 既定は 1.0 です。Q: 照会すると float を返します。
-useColorRamp(-ucr) boolean createqueryedit
ユーザ定義のカラー ランプを使用して値をカラーにマッピングするかどうかを指定します。これがオフの場合、既定のグレースケール フィードバックを使用します。
-colorRamp(-cr) string createqueryedit
ユーザ定義のカラー ランプを使用した、値のカラーへのマッピングを許可します。
-useMaxMinColor(-umc) boolean createqueryedit
範囲外のカラーを使用するべきかどうかを指定します。詳細については、rampMinColor、rampMaxColor フラグを参照してください。
-rampMinColor(-rmc) float float float createqueryedit
値が最小値以下の場合に、特別のカラーを使用するように定義します。
-rampMaxColor(-rxc) float float float createqueryedit
値が最大値以上の場合に、特別のカラーを使用するように定義します。
-clamp(-cl) string createqueryedit
ウェイト値に上限、下限を設定するかどうかを指定します。次の 4 つの選択肢があります。「none」- クランプをまったく実行しません。「lower」- 下限にのみ合わせてクランプします。「upper」- 上限にのみ合わせてクランプします。「both」- 上限、下限両方に合わせてクランプします。C: 既定は「none」です。Q: 照会すると string を返します。
-clamplower(-cll) float createqueryedit
値の下限を指定します。C: 既定は 0.0 です。Q: 照会すると float を返します。
-clampupper(-clu) float createqueryedit
値の上限を指定します。C: 既定は 1.0 です。Q: 照会すると float を返します。
-alphaclamp(-alc) string createqueryedit
ウェイト値を上限、下限にアルファ クランプするかどうかを指定します。次の 4 つの選択肢があります。「none」- クランプをまったく実行しません。「lower」- 下限にのみ合わせてクランプします。「upper」- 上限にのみ合わせてクランプします。「both」- 上限、下限両方に合わせてクランプします。C: 既定は「none」です。Q: 照会すると string を返します。
-alphaclamplower(-acl) float createqueryedit
アルファ値の下限を指定します。C: 既定は 0.0 です。Q: 照会すると float を返します。
-alphaclampupper(-acu) float createqueryedit
アルファ値の上限を指定します。C: 既定は 1.0 です。Q: 照会すると float を返します。
-dataTypeIndex(-dti) int queryedit
選択したペイント可能なアトリビュートが vectorArray のときに、ペイントするフィールドを指定します。
-colorfeedback(-cf) boolean createqueryedit
カラー フィードバックの表示をオンまたはオフに設定します。C: 既定は false です。Q: 照会すると boolean を返します。
-disablelighting(-dl) boolean createqueryedit
カラー フィードバックがオンの場合、このフラグによって、影響を受けるサーフェスのライティングを無効にするかどうかが決まります。C: 既定は false です。Q: 照会すると boolean を返します。
-colorrangelower(-crl) float createqueryedit
カラー フィードバック モードがオンのときに黒にマップする値を指定します。C: 既定は 0.0 です。Q: 照会すると float を返します。
-colorrangeupper(-cru) float createqueryedit
カラー フィードバック モードがオンのときに最大カラーにマップする値を指定します。C: 既定は 1.0 です。Q: 照会すると float を返します。
-interactiveUpdate(-iu) boolean createqueryedit
ペイントされた値をアトリビュートに転送する頻度を指定します。TRUE: 「継続的」に(1 つのストロークにつき何度も)転送します。FALSE: ストロークの最後(マウス ボタンが放されたとき)にのみ転送します。C: 既定は true です。Q: 照会すると boolean を返します。
-paintNodeArray(-pna) string query
ペイント可能なノードの配列です。Q: 照会すると string を返します。
-objattrArray(-oaa) string query
ペイント可能なすべてのアトリビュートの配列です。配列の各要素は、次の情報を含む文字列です。NodeType.NodeName.AttributeName.MenuType *MenuType: メニュー項目(UI)のタイプ(レベル)です。Q: 照会すると string を返します。
-attrSelected(-asl) string query
現在選択されているアトリビュートの名前を返します。Q: 照会すると string を返します。
-paintattrselected(-pas) string edit
選択したペイント可能なアトリビュートの配列です。配列の各要素は、次の情報を含む文字列です。NodeType.NodeName.AttributeName。
-beforeStrokeCmd(-bsc) string createqueryedit
渡された文字列はストロークの開始直前に MEL コマンドとして実行されます。C: 既定は、コマンドなしです。Q: 照会すると現在のコマンドを返します。
-duringStrokeCmd(-dsk) string createqueryedit
マウスでドラッグする度に、渡された文字列はストローク時に MEL コマンドとして実行されます。C: 既定は、コマンドなしです。Q: 照会すると現在のコマンドを返します。
-afterStrokeCmd(-asc) string createqueryedit
渡された文字列はストロークの終了直前に MEL コマンドとして実行されます。C: 既定は、コマンドなしです。Q: 照会すると現在のコマンドを返します。
-whichTool(-wst) string createqueryedit
この文字列は、アーティザン コンテキストで使用されるツールの名前を定義します。たとえば、「artClothPaint」のように指定します。照会モードでは、指定したコンテキストのツール名が返されます。注: MEL の動作方法の理由から、引数を取るフラグを指定するときには、必ず、-query フラグを最後に指定してください。
-activeListChangedProc(-alp) string createqueryedit
アクティブ リストが変更されたときに必ず起動される MEL コマンドを含む文字列を取ります。シーンでオブジェクトを選択または選択解除したときに、たとえば、UI を更新する必要があるなど、いくつかの状況が考えられます。照会モードでは、現在登録されている MEL コマンドの名前が返されます。何も定義されていない場合は空の文字列になります。
-toolOnProc(-top) string createqueryedit
このツールがオンになったときに必ず起動される MEL プロシージャの名前を表す文字列を取ります。たとえば、クロス ペイント ツールがオンになったとき、クロスは「clothPaintToolOn」を起動します。ツールがアクティブになったときに特別な機能が必要となる場合はこのコールバックを定義します。toolOnProc を実装した場合は toolOffProc も実装したくなるでしょう(-toolOffProc フラグを参照)。照会モードでは、現在登録されている MEL コマンドの名前が返されます。何も定義されていない場合は空の文字列になります。
-toolOffProc(-tfp) string createqueryedit
このツールがオフになったときに必ず起動される MEL プロシージャの名前を表す文字列を取ります。たとえば、クロス ペイント ツールがオンになったとき、クロスは「clothPaintToolOff」を起動します。ツールが非アクティブになったときに特別な機能が必要となる場合はこのコールバックを定義します。toolOffProc を実装した場合は toolOnProc も実装したくなるでしょう(-toolOnProc フラグを参照)。照会モードでは、現在登録されている MEL コマンドの名前が返されます。何も定義されていない場合は空の文字列になります。
-mouldtypemouse(-mtm) string createqueryedit
パテ操作/モードを指定します(「push」:複数の CV を指定した方向に押す(refvector フラグを参照)、「pull」: 複数の CV を指定した方向に引く、「smooth」: スカルプトをスムーズする、「erase」: ペイントを消去する)。C: 既定は「push」です。Q: 照会すると string を返します。
-refvector(-rv) string createqueryedit
押し込み/引き出し操作の方向を指定します(「normal」- 法線に沿ってスカルプト、「firstnormal」- ストロークの 1 番目の法線に沿ってスカルプト、「view」- ビューの方向に沿ってスカルプト、「xaxis」、「yaxis」、「zaxis」- 指定した軸方向にスカルプト、「uisoparm」、「visoparm」- U または V アイソパラメトリック ラインに沿ってスカルプト、「uvvector」- UV スペースの任意のベクトルに沿ってスカルプト)。C: 既定は「normal」です。Q: 照会すると string を返します。
-invertrefvector(-irv) boolean createqueryedit
反射がオンのときに基準ベクトル オプションを反転するように設定します。true の場合、反映されたストローク用のリファレンス ベクトルは、元のベクトルに関してネゲートされます。C: 既定は false です。Q: 照会すると boolean を返します。
-refvectoru(-rvu) float createqueryedit
-refVector が「uvvector」に設定されてたときに使用される UV ベクトルの U 成分を指定します。
-refvectorv(-rvv) float createqueryedit
-refVector が「uvvector」に設定されたときに使用される UV ベクトルの V 成分を指定します。
-maxdisp(-md) float createqueryedit
最大ディスプレイスメントを定義します(maxDisp は [0.0..5.0])。C: 既定は 1.0 です。Q: 照会すると float を返します。
-collapsecvtol(-clc) float createqueryedit
コラプス CV 検出のしきい値の許容値を指定します。C: 既定は 0.005 cm です。Q: 照会すると float を返します。
-autosmooth(-asm) boolean createqueryedit
自動スムーズオプションを設定します。ブラシがスムーズモードの場合、強さを調整するとサーフェスをスムーズする速度が調整されます。C: 既定は false です。Q: 照会すると boolean を返します。
-smoothiters(-si) int createqueryedit
スムージング操作の精度(繰り返しの回数)を設定します。C: 既定は 3 です。Q: 照会すると int を返します。
-brushStrength(-bs) float createqueryedit
ブラシの強度を設定します。ブラシの強度はピンチ ブラシでサポートされています。ピンチ モードの場合、強度を調整すると、サーフェスがブラシの中央で収束する速度が調整されます。C: 既定は 1.0 です。Q: 照会すると float を返します。
-stitchtype(-stt) string createqueryedit
ステッチング モードのオン/オフを設定します(「off」: ステッチングをオフ、「position」: 接線連続性 C0 に関係なくポジション ステッチングを行う、「tan」: C1 の連続性を保持する)。C: 既定は「position」です。Q: 照会すると string を返します。
-stitchedgeflood(-sef) edit
ポストプロセスのステッチング エッジ処理をトリガします。
-stitchcorner(-stc) boolean createqueryedit
ステッチング コーナー モードのオン/オフを設定します。C: 既定はオフです。Q: 照会すると boolean を返します。
-polecv(-pcv) boolean createqueryedit
極の CV をすべて同じ位置に引き寄せます。
-refsurface(-rs) boolean createqueryedit
リファレンス サーフェスの更新のオン/オフを設定します。true にすると、ストローク毎にリファレンス サーフェスは自動的に更新されます。false にすると、更新ボタンを押してリファレンス サーフェスを明示的に更新する必要があります(updaterefsrf を参照)。C: 既定は true です。Q: 照会すると boolean を返します。
-updaterefsrf(-urs) createedit
リファレンス サーフェスを更新します。
-updateerasesrf(-ues) createedit
消去サーフェスを更新します。
-dispincr(-din) createedit
最大ディスプレイスメントを 10% 増加させます。
-dispdecr(-dde) createedit
最大ディスプレイスメントを 10% 減少させます。

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

MEL 例

// Set the brush radius to 20.0
artPuttyCtx -e -radius 20.00 artPuttyContext;
// Set the brush radius to 20.0
artPuttyCtx -e -radius 20.00 artPuttyContext;