やりたい処理のコマンドを見つける５つの方法を徹底解説！

こんにちは！python勉強中の、ビーバー@ゲーム業界歴約２０年　です。
ＣＧ・ゲーム制作系の３Dデザイナーさんに向けて、maya python のコンテンツを発信しています。

目的のコマンドを知るにはmaya helpか、あるいは書籍か。そもそもコマンド名さえ分からない場合はどうしたらいいんだと感じませんか（笑）

今回は、そんな私自身が探り探りやってきた方法や書籍で学んだ方法、youTubeや人から教えてもらった方法をまとめて紹介します！

調べ方を知るだけで、スクリプトを書くスピードが断然速くなりますよ！

＞＞　Pythonの勉強方法を知りたい方はこちらをどうぞ

※当サイトで紹介する商品は、アフィリエイトプログラムを利用しています。

前準備

…と、その前に。コマンドを調べる前に欲しい処理を分解して考えてみましょう。

コントロールリグを作る例をあげます。
たとえば、こんなシーンで、、

まずどのようなリグにするのか要件を考えると思います。

ここで大事なのは、どんなコマンドを使ったか、どんな操作を行ったかを具体化することです。

やりたい処理を見つける方法

mayaのpythonコマンドを探すアプローチは、５つあります。

それぞれ具体的な例を挙げながら、調べ方を紹介していきます。

①maya help から検索

公式のリファレンスで、網羅性高く、個々のコマンドのフラグ情報まで詳しく解説されています。
また、コマンド解説のページ下部には、コマンド使用のサンプルスクリプトもあり、
そこから具体的な使い方を知ることもできます

アニメーションキーのあるフレーム数を取得したい場合

この場合は、どのようにコマンドを調べるでしょうか？

ヘルプの概要を読んでほしい処理に近づきそうかどうか判断、、

イケそうな感じです。続いてフラグを確認します。

これかもしれません。５ｆ目に打ったキーを選択して試してみます。

今回はまっすぐにヘルプから答えを見つけることができました。
当たり前と言えばそうですが、最初に頼るのはやはり公式のヘルプではないでしょうか。

②melのヒストリから探す

しかし、、そんなmayaヘルプでも、目的のコマンドにたどり着けないこともあると思います。
そんな時、GUIからのコマンドを知っているなら、
それを実行して、ヒストリからコマンド名を探す手もあります

「トランスフォームのフリーズ」の例

フリーズのpythonコマンドを使いたい場合はどうすればいいのでしょう？

さっそくやってみましょう。適当なboxを作成し、フリーズをかけます。
実行した内容がmelで返ってきました。

「makeIdentity」がそれっぽいです。これをヘルプで検索してみます。

内容がわかりにくいですが、たぶんビンゴです。
pythonスクリプトの書式で打ち込んでみます。

欲しい結果が得られました！

③ググる

ヘルプでも、ヒストリからも手掛かりがつかめない場合もありますよね。。
そんな時はどうしたらいいのでしょうか？

ポリゴンの頂点のワールド位置を取得したいとき

ちょっと手の込んだ（？）コマンドを探したいときは、
Google先生にお世話になることが多いでしょう。

「Maya Python 頂点 取得」 などのキーワードで検索します。

一番目のページから「pointPosition」というコマンドがあることを知ります。
そのページを読みこんでみたり、ヘルプで詳細確認してみましょう。

それっぽいですね！
適当に作った、ボックスの頂点を選択して実行してみます。

ズバリ欲しかった結果が得られました！

④pythonコマンドとして存在しない場合、melを呼び出して使う

なんぼ探してもpythonコマンドがみつからん、、
そんな時はpythonからmelを呼び出して使いましょう！具体的なケースで見ていきます。

たとえば、「小さなウェイトの値を削減（Prune Small Weights）」したいとき

スキンバインドされたメッシュから、設定した値より小さいウェイトを削除するコマンドです。
このコマンドの例でみていきましょう。

最初に、pythonコマンドあるかどうかを確認します。
「②melのヒストリから探す」手順と同様、
GUIから実行したコマンドのヒストリを見てみましょう。

GUIメインメニューから
スキン＞小さいウェイトを削減　を実行

ヒストリに　doPruneSkinClusterWeightsArgList 1 { “0.01” };
と表示されました。どうやら、「doPruneSkinClusterWeightsArgList」というのが
今、探しているコマンド（？）のようです。

Prune や SkinCluster などめぼしいキーワードで、mayaヘルプを検索します。

maya python の helpコマンド

maya pythonには、helpコマンドというものがあります。
helpコマンドでは、スクリプトエディタにコマンドのクイック ヘルプを表示したり、
ブラウザでオンラインマニュアルを呼び出すことができます。

例）クイックヘルプの表示

cmds.help('polySphere')

例）オンラインマニュアルの表示

cmds.help( 'polySphere', language='python', doc=True )

画像ではhelpコマンドで、polySphere()のクイックヘルプを表示しています。
今回、注目すべきは最下段

Command Type: Command
コマンドタイプがコマンドである内容の記述があります。

これは「polySpher　は　mayaコマンドである」
とヘルプが返してきている、ということです。

さっそくhelpで問い合わせてみます。

長すぎてヒストリが見切れます（笑）が、何やら出てきました。

# 結果: "doPruneSkinClusterWeightsArgList" は
ファイル C:/ProgramFiles/Autodesk/Maya2020/scripts/others/doPruneSkinClusterWeightsArgList.mel 
に定義された MEL プロシージャです。 #

「MEL プロシージャです」と帰ってきました。
プロシージャ　＝　関数です。この処理はコマンドではなく関数だったのですね。

mayaの「コマンド」であるなら、pythonコマンドもありそうですが、
mel関数となると、この例の場合対応するpython関数、、はないようです。

こんな時はどうすればいいのでしょうか？
そう、今こそ、pythonからmelを呼び出すのです！

pythonからmelを呼びだすには、先にimport でmelを読み込んでおく必要があります。

これは、melを「mm」として読みこむという宣言です。
melコマンドは、「mm」の後に　「mm.○○○（melコマンド名）」の形で書くことで
pythonから呼び出すことができます。

例えば、ポリゴン球を作成するmelをpythonから呼び出す場合はこのように書きます。

import maya.mel as mm
mm.eval("polySphere;")

pythonコマンド「eval」はmelスクリプトを実行します。
ヘルプにはこう書いてあります

要するに、
mm.eval(“○○”)
○○のところにmelスクリプトをコピーしたら、
「その挙動をpythonとして実行しまっせ」ということです。

「小さなウェイトの値を削減」のヒストリを思い出します。

doPruneSkinClusterWeightsArgList 1 { "0.01" };

そのままevalのカッコ内に貼り付けて実行してみましょう。

// エラー: doPruneSkinClusterWeightsArgList 1 { '0.01' }; //
// エラー: Line 1.38: Syntax error //
エラー: RuntimeError: file line 1: MEL スクリプトの実行時にエラーが発生しました
Line 1.38: Syntax error #

書き直します。

これでどうだ！

pythonコマンドの探し方の記事のはずなのに、melを呼び出して使おうなんて、
なんか卑怯な気もしましたが、コマンドがないんだから仕方ありません（笑）

⑤py友に聞く

コマンドを見つける奥の手です。

というかもう人に聞いちゃう(笑)
もし、一緒にmaya pythonを学習する仲間がいるなら、聞いてみるのも良いと思います。
テクニカルアート職の方だったり、その手のプロが身近にいるなら、最高の先生です。

たとえば、ロケータから骨のtrans,rotを動かすリグを作りたいとき

前準備で、作ろうとしているものの要件と手順が具体的になっているなら、
それを伝えてみると、py友も答えやすいと思います。

思いがけない方法を教えてもらえるかもしれません。
詳細はぜひヘルプを見たり、ググってみたりして、使い方を自分の血肉にしましょう。

そして、py友へ絶大な感謝を述べましょう。
いつの日か、自分もpy友へお返しができるくらい上達したいものです。

まとめ

今回はやりたい処理のpythonコマンドを見つける方法をご紹介しました！

どんなコマンドもドキュメントだけではわかりづらく、
結局は調べて、試して、地道な学習の繰り返しで覚えていくのかな、と思いますが、
それでもこの記事が皆さんのお役にたてればうれしいです！