脚本编辑器(Script Editor)

为了便于在 Maya 中同时使用 MEL 和 Python 脚本， “脚本编辑器”(Script editor) 已修改为每种语言具有单独的选项卡。输入到 MEL 选项卡窗口中的语句将发送到 MEL 进行处理；同样，输入到 Python 选项卡窗口中的语句将由 Python 处理。

从 Python 返回的结果会带有 Python 注释字符 (#) 前缀。

在脚本编辑器中，可借助自动完成来更快地查找命令名。有关详细信息，请参见 获取 MEL 命令帮助 。

有关详细信息，请参见 脚本编辑器 。

也可在命令行输入简短的 Python 命令。通过切换可选择输入 MEL 命令或 Python 命令。

与 MEL 脚本类似，也可使用鼠标中键 ( ) 将 Python 脚本拖动到 “工具架”(Shelf) 。此时将出现一个对话框，询问脚本是 Python 脚本还是 MEL 脚本。

Maya Python 模块

所有本地 Maya 命令的 Python 绑定位于 maya.cmds 模块中。为了访问这些命令，在每个会话中，必须在 “脚本编辑器”(Script editor) 的 Python 选项卡中输入以下命令： import maya.cmds

此命令允许用户使用 Maya 命令。例如： maya.cmds.ls() maya.cmds.sphere( radius=4 )

可以将 Maya 命令导入到不同且较短的名称空间： import maya.cmds as cmd cmd.sphere()

提示 可以在 userSetup.py 文件中自动导入 maya.cmds 。可以将此命令修改为使用首选前缀，例如：

import maya.cmds as mc mc.sphere()

有关详细信息，请参见 在 Python 中和为 Python 初始化 Maya 环境 。

注意 也可以使用以下命令将 Maya 命令导入到顶层级名称空间：

from maya.cmds import *

然后，可以使用更简便的方法来引用 Maya 命令：

ls() sphere( radius=4 )

警告：导入到顶层级名称空间会覆盖 Python 内置模块和其他模块中的定义。

例如，Python 具有其自身的帮助系统，调用 Python 版本的 help 将生成特定于 Python 的输出。调用 maya.cmds.help 将提供有关 Maya 命令的帮助。将 maya.cmds 导入到顶层级名称空间会导致不能访问 Python 帮助。

在 Python 中与在 MEL 中处理标志的方式不同。MEL 是使用 shell 命令样式语法设计的。

对于 Python 中的 Maya 命令，命令参数语法已调整为适用于 Python 的方式。因此，标志（长短形式）会作为命名参数传递给命令。参数的名称是标志名称，标志的参数会传递给命名参数。

MEL 球体命令是： sphere -radius 4;

在 Python 版本中，标志 radius 作为命名参数被引用，由于只有一个参数，该值按以下形式传递： maya.cmds.sphere( radius=4 )

如果标记具有多个参数，那么这些参数需要压缩到列表或元组中。以下是带有标志（包含三个参数）的命令的示例。 # With a tuple maya.cmds.ambientLight( rgb=( 0.2, 0.3, 0.4 ) ) # With a list maya.cmds.ambientLight( rgb=[ 0.2, 0.3, 0.4 ] )

所需参数 (True/False)

命名参数必须具有与它们关联的值。但是，并非所有的 Maya 标志都需要一个值（例如， ls -sl ）。为了保存一致的语法，Autodesk Maya Python 实现需要为通常不使用任何参数的标志指定布尔参数。如果布尔值为 False，那么将忽略该标志；如果为 True，那么将使用该标志。例如： # Pass selection flag maya.cmds.ls( selection=True ) # Selection flag is ignored here maya.cmds.ls( selection=False )

多个命名参数

可能会在一个命令调用中多次使用某些标志。例如，在 MEL 中： ls -type nurbsSurface -type transform;

在 Python 中，将使用命名参数 type 并以列表或元组传递这些值。 maya.cmds.ls( type=['nurbsSurface','transform'] )

在标志被多次使用和具有多个参数的情况下，该值将是列表的列表。也可以使用元组来代替列表，因此您可以使用列表元组、元组列表或元组的元组。例如，MEL 中的 curveOnSurface 命令： curveOnSurface -d 3 -uv 0 0 -uv 0.3 0.5 -uv 0.5 0.6 -uv 0.9 1.0 surface1;

在 Python 中： maya.cmds.curveOnSurface( 'surface1', d=3, uv=[(0,0),(0.3,0.5),(0.5,0.6),(0.9,1.0)] )

如果使用多个参数标志，Python 会返回错误 (“Duplicate keyword argument”)。

Maya 命令中有三种类型的范围：时间、索引和浮点。在 Python 中必须使用元组指定所有范围。任意元组都可能有一个或两个值。具有一个值的元组指定为一个值（加括号并后跟逗号）；多个单值元组使用集表示法指定（请参见 多个命名参数 ）。

时间范围也支持单位。若要指定单位，必须使用字符串。由于每个值是单独解析的，因此可以混合使用单位。

以下是有效的时间范围：

(1,) (1,10) ('1sec','10sec') ('1min:2min')

下表以 cutKey 命令为例来指定时间范围和索引范围。

对某些命令标志的更改

对 Maya 命令所做的某些标志更改是必需的，因为 Python 中的多用途标志的参数必须以列表传递给标志。对于其中必须混合并匹配多用途标志的命令而言，这将导致出现问题。由于 Python 每个多用途标志的参数均以单独的列表提供，因此无法将这些参数混合使用。已扩展依赖于此的几个命令，以便单个多用途标志可以处理各个多用途标志的作业。

这些命令包括：

polyAppendVertex ：可用于取代 point 、 vertex 和 hole 标志的新 append 标志。

polyAppend ：可用于取代 point 、 edge 和 hole 标志的新 append 标志。

polySplit ：可以用于取代 facepoint 和 edgepoint 标志的新 insertpoint 标志。

polyCreateFacet ：经过修改后可用于指定洞的现有 point 标志。

roundConstantRadius ：可替换使用应该混合使用的 sidea 和 sid b 的新 side 标志。

CommandsPython 参考文档中记录了所有这些标志的使用。

在所有情况下，这些标志都是向后兼容的。所有旧标志仍保留在原位。

参数和对象

上面的 curveOnSurface 示例还表明了另一 Python 语法要求。除了标志，Maya 命令还使用参数和对象。参数是命令所需的固定类型的值。例如， move 命令使用三个参数表示移动的 X、Y 和 Z 值。对象是命令在其上操作的实体（例如，场景中的某个对象或 UI 元素）。基于当前的选择列表，一个命令针对的对象数量是变化的，并且有时对象是隐式的。

对象和参数将如同在 MEL 中一样传递给命令，但传递的顺序必须如下所示： command arguments object flags/named arguments

这不同于 MEL，MEL 中的排序要求对象显示在参数列表结尾处。但是，Python 要求命名参数显示在所有其他参数之后。

参数类型的摘要

下表显示了可在 Maya Python 模块中使用的标志（命名参数）类型的摘要。

具有多个参数的标志

MEL: ambientLight -rgb 0.2 0.3 0.4

Python: maya.cmds.ambientLight( rgb=( 0.2, 0.3, 0.4 ) )

使用元组指定多个参数

多用途标志

MEL: ls -type nurbsSurface -type transform

Python: maya.cmds.ls( type=['nurbsSphere','transform'] )

使用列表以包含多个标志值

具有多个参数的多用途标志

MEL: curveOnSurface -d 3 -uv 0 0 -uv 0.3 0.5 -uv 0.5 0.6 surface1

Python: maya.cmds.curveOnSurface( 'surface1', degree=3, uv=[(0,0),(0.3,0.5),(0.5,0.6)] )

使用元组列表。

（也可以使用一个元组或多个元组、列表的列表或列表的元组。）

MEL: move 2.0 1.0 1.0

Python: maya.cmds.move( 2.0, 1.0, 1.0 )

除参数必须在前外，与 MEL 相同

带有标志的命令参数

MEL: move -objectSpace 2.0 1.0 1.0

Python ： maya.cmds.move（2.0，1.0, 1.0，objectSpace=True）

带有参数和标志的命令对象

MEL: move -objectSpace 2.0 1.0 1.0 nurbsSphere1

Python ： maya.cmds.move（2.0，1.0, 1.0，"nurbsSphere1"，objectSpace=True）

对象必须在标志之前

标志/参数使用值的查询

MEL: skinCluster -q -inf;

Python maya.cmds.skinCluster (q=True, inf=True)

需要布尔值 True 的查询标志。

标志/参数不使用值的查询

MEL: skinCluster -inf joint1 -q -dr;

Python: skinCluster (q=True, inf='joint1', dr=True)

标准输入 (stdin) 实现

Python 支持从 STDIN（标准输入）进行读取。在 Python 脚本中，这是通过从 sys.stdin 进行读取或调用 raw_input 来实现的。当 Maya 在 GUI 模式（与批处理模式相对）下运行时，Maya 会拦截来自 Python 的调用并通过一个对话框来提示用户在其中键入输入。

Maya 会使用其自身的实现来覆盖 sys.stdin 。如果要使用 Python 自身的标准输入对象，可通过引用 sys.__stdin__ 来实现此目的。

在 “脚本编辑器”(Script Editor) 中输入以下内容之一来显示 Python STDIN 对话框：

使用 raw_input

raw_input()
                  
使用 sys.stdin
import sys
inp = sys.stdin.readline()
                  
自定义命令提示
import maya.cmds as cmds
inp = cmds.promptDialog(message='hello')
            
Python 的类型系统比 MEL 更复杂，因此无法将所有 Python 数据类型转化为本地 MEL 类型。Python 命令会转化自身知道如何进行处理的数据类型。对于其他数据类型，则会需要一个字符串来表示对象并进行返回。
            
下表显示了当前支持的对照关系：
               
从 Python 调用 MEL
               
 若要从 Python 调用 MEL，请使用 maya.mel.eval() 函数。由于 Python 的类型支持更灵活，此函数的转化效果会比 MEL 的 Python 命令更好。
               
 必须导入以下 maya.mel 模块才能使用此命令：
import maya.mel as mm mm.eval("polySphere;")
               
下表列出了支持的转化：
            
 位置参数指的是 UI 元素向其回调脚本传递的参数。例如，浮点滑块控件的回调 MEL 脚本可以包含 # 1。在运行此回调时，浮点滑块的值将替换为此位置参数。
            
Python 支持两种在回调中替换来自控件的值的方法。如果回调是一个要对其求值的字符串，Maya 就以 MEL 中的方式进行字符串替换。但是，会使用 Python 的格式运算符进行替换。格式操作将会获得一个传递来的用于替换的项目字典，其中值的名称为
               1、2 等等。例如： 
maya.cmds.floatSlider( cc="print '%(1)s'" )
            
（稍后，在执行此字典之前，会先将其应用于字符串。在执行脚本之前，floatSlider 命令使用当前滑块值对此字符串进行格式设置。对于格式操作，用户为其提供格式字符串，UI 元素为其提供字典。）
            
Python 回调的第二个样式使用编译的函数，其中 Maya 将值作为参数传递给该函数：
def doPrint( arg ):
	print arg
cmds.floatSlider( cc=doPrint )
            
使用回调函数时，如果回调没有使用正确数量的参数，则会收到错误消息。 
def badStuff():
	print "bad"
cmds.floatSlider( cc=badStuff )
            
在移动滑块时会看到以下错误：
# TypeError: badStuff() takes no arguments (1 given)
            
如果要创建可使用任意数量的参数的回调，请使用变量参数列表：
def genericCallback( *args ):