由于语言的巨大差异,在 Python 中调用 Maya 命令的方式与在 MEL 中使用 Maya 命令的方式有许多区别。
为了便于在 Maya 中同时使用 MEL 和 Python 脚本,“脚本编辑器”(Script editor)已修改为每种语言具有单独的选项卡。输入到 MEL 选项卡窗口中的语句将发送到 MEL 进行处理;同样,输入到 Python 选项卡窗口中的语句将由 Python 处理。
从 Python 返回的结果会带有 Python 注释字符 (#) 前缀。
在脚本编辑器中,可借助自动完成来更快地查找命令名。有关详细信息,请参见获取 MEL 命令帮助。
有关详细信息,请参见脚本编辑器。
也可在命令行输入简短的 Python 命令。通过切换可选择输入 MEL 命令或 Python 命令。
与 MEL 脚本类似,也可使用鼠标中键 () 将 Python 脚本拖动到“工具架”(Shelf)。此时将出现一个对话框,询问脚本是 Python 脚本还是 MEL 脚本。
所有本地 Maya 命令的 Python 绑定位于 maya.cmds 模块中。为了访问这些命令,在每个会话中,必须在“脚本编辑器”(Script editor)的 Python 选项卡中输入以下命令:
import maya.cmds
maya.cmds.ls() maya.cmds.sphere( radius=4 )
import maya.cmds as cmd cmd.sphere()
import maya.cmds as mc mc.sphere()
有关详细信息,请参见在 Python 中和为 Python 初始化 Maya 环境。
在 Python 中与在 MEL 中处理标志的方式不同。MEL 是使用 shell 命令样式语法设计的。
对于 Python 中的 Maya 命令,命令参数语法已调整为适用于 Python 的方式。因此,标志(长短形式)会作为命名参数传递给命令。参数的名称是标志名称,标志的参数会传递给命名参数。
如果标记具有多个参数,那么这些参数需要压缩到列表或元组中。以下是带有标志(包含三个参数)的命令的示例。
# 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 ] )
命名参数必须具有与它们关联的值。但是,并非所有的 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;
maya.cmds.curveOnSurface( 'surface1', d=3, uv=[(0,0),(0.3,0.5),(0.5,0.6),(0.9,1.0)] )
Maya 命令中有三种类型的范围:时间、索引和浮点。在 Python 中必须使用元组指定所有范围。任意元组都可能有一个或两个值。具有一个值的元组指定为一个值(加括号并后跟逗号);多个单值元组使用集表示法指定(请参见多个命名参数)。
时间范围也支持单位。若要指定单位,必须使用字符串。由于每个值是单独解析的,因此可以混合使用单位。
(1,) (1,10) ('1sec','10sec') ('1min:2min')
下表以 cutKey 命令为例来指定时间范围和索引范围。
对 Maya 命令所做的某些标志更改是必需的,因为 Python 中的多用途标志的参数必须以列表传递给标志。对于其中必须混合并匹配多用途标志的命令而言,这将导致出现问题。由于 Python 每个多用途标志的参数均以单独的列表提供,因此无法将这些参数混合使用。已扩展依赖于此的几个命令,以便单个多用途标志可以处理各个多用途标志的作业。
上面的 curveOnSurface 示例还表明了另一 Python 语法要求。除了标志,Maya 命令还使用参数和对象。参数是命令所需的固定类型的值。例如,move 命令使用三个参数表示移动的 X、Y 和 Z 值。对象是命令在其上操作的实体(例如,场景中的某个对象或 UI 元素)。基于当前的选择列表,一个命令针对的对象数量是变化的,并且有时对象是隐式的。
对象和参数将如同在 MEL 中一样传递给命令,但传递的顺序必须如下所示:
command arguments object flags/named arguments
这不同于 MEL,MEL 中的排序要求对象显示在参数列表结尾处。但是,Python 要求命名参数显示在所有其他参数之后。
下表显示了可在 Maya Python 模块中使用的标志(命名参数)类型的摘要。
Python 支持从 STDIN(标准输入)进行读取。在 Python 脚本中,这是通过从 sys.stdin 进行读取或调用 raw_input 来实现的。当 Maya 在 GUI 模式(与批处理模式相对)下运行时,Maya 会拦截来自 Python 的调用并通过一个对话框来提示用户在其中键入输入。
Maya 会使用其自身的实现来覆盖 sys.stdin。如果要使用 Python 自身的标准输入对象,可通过引用 sys.__stdin__ 来实现此目的。
新的 MEL 命令 (Python) 会提取字符串并将其传递到 Python 中予以执行。Python 命令会尝试将结果转化为 MEL 类型。
python( "import maya.cmds" ) python( "maya.cmds.ls" )
Python 的类型系统比 MEL 更复杂,因此无法将所有 Python 数据类型转化为本地 MEL 类型。Python 命令会转化自身知道如何进行处理的数据类型。对于其他数据类型,则会需要一个字符串来表示对象并进行返回。
Python 返回值 | MEL 转化 |
---|---|
字符串 |
字符串 |
unicode |
字符串 |
整型 |
整型 |
浮点型 |
浮点型 |
包含数字的列表,至少包括一个浮点 |
float[] |
仅包含整型或长整型的列表 |
int[] |
包含非数字的列表 |
string[] |
其他内容 |
字符串 |
空 Python 列表 |
空字符串数组 (string $array[]) |
若要从 Python 调用 MEL,请使用 maya.mel.eval() 函数。由于 Python 的类型支持更灵活,此函数的转化效果会比 MEL 的 Python 命令更好。
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 ): print( "args: " + str ( args ) ) cmds.button( command=genericCallback )