MayaBatch.py 解读

MayaBatch插件解读

MayaBatch类插件变量介绍

注：表格中变量非明确说明，均为字符串类型

变量名称 |变量含义 |说明 ---- |---- | |================|
ProcessName |进程名称 | Process | | Version |Maya版本信息 ( 整数 )| Build |64bit/32bit | Renderer |渲染器名称 | StartFrame |渲染起始帧 | EndFrame |渲染结束帧 | ByFrame |渲染跳帧 | RenumberFrameStart| | SceneFile |场景文件路径 | ProjectPath |渲染工程路径 |用来搜索纹理、参考等路径用 StartupScriptPath|启动脚本路径 |Maya文件加载完成后自动运行该脚本 RenderDirectory |渲染路径 | CurentRenderDirectory|当前渲染路径| LocalRendering |本地渲染 ( True/False ) |本地渲染是指先将图像渲染到本地，完成后再从本地移动到服务器上 ImagePrefix |图像前缀 | Camera |指定渲染摄像机 | Width |渲染图像宽度 | Height |渲染图像高度 | AspectRatio |设备高宽比 |指播放设备，并非像素比 AntiAliasing |抗锯齿 | MotionBlur |运动模糊 | Threads |多线程 | Verbosity |日志等级 | RenderLayer |渲染层 | UsingRenderLayers|使用渲染层 ( True/False )| Left |范围渲染左 | Right |范围渲染右 | Top |范围渲染上 | Bottom |范围渲染下 | ScriptJob |脚本任务 ( True/False ) ScriptFilename |脚本文件路径 | RegionRendering |范围渲染 ( True/False ) | SingleRegionJob | SingleRegionIndex|

注：Krakatoa 参数不予以介绍。

类中 _init_ 函数介绍

函数名称	说明
self.InitializeProcess	初始化一些常用的插件配置
self.StartJob	当第一个Slave第一次获取一个任务时，就调用该函数
self.RenderTasks	每次Slave抽取一个Task时，都会调用该函数
self.EndJob	当最后一个Slave完成最后一个Task后，就会调用该函数

类中 Cleanup 函数介绍

清除 init 中添加的回调，并清理渲染进程

类中 InitializeProcess 函数介绍

变量名称	说明
SingleFramesOnly	( True/False )
PluginType	配置插件类型 PluginType.Single / PluginType.Advanced

类中 StartJob 函数介绍

文件名/路径处理

self.SceneFile 变量记录了最终的渲染文件路径。

1. 通过 self.GetPluginInfoEntry 函数获取 dlinit / param 文件里定义的 Version 值，即软件版本号。
2. 通过 StringUtils.ParseLeadingNumber 函数解析获取的版本号。文档说明：该函数会解析字符串参数开头的数字，并返回 float 类型。
3. 获取版本号中第一位小数。
4. 判断第一位小数是否为 .5 ( 在 Deadline 有关 Autodesk的软件都有个 .5 版本，比如 Maya2014.5，但是没有用过。 )
5. 通过 self.GetPluginInfoEntryWithDefault 函数获取插件信息中有关第一个参数 Build 的键值，如果没有，则返回第二个参键值作为默认值。
6. 通过 self.GetDataFilename 函数获取提交的任务的第一个辅助 ( auxiliary ) 文件，返回这个文件的文件名，如果没有文件名，则返回空字符串，不是 None 。
7. 通过 self.GetPluginInfoEntryWithDefault 函数来获取插件信息中有关 SceneFile 的键值，如果插件信息中没有 SceneFile 值，则返回 self.GetDataFilename 的值。
8. 通过 RepositoryUtils.CheckPathMapping 函数来对给定的 sceneFilename 进行路径重新映射，映射路径使用的是Repository 配置里面的设置，返回映射后的路径。
9. 通过 SystemUtils.IsRunningOnWindows 函数检车是否是 Windows 环境，再通过 startwidth 函数来检测是否为网络路径，如果是，则检测开头是否有两根反斜杠，没有则自动补上。
10. 对 ma 文件进行路径重新映射。Deadline 只能针对 ma 文件进行文件内路径映射，因为 ma 文件是文本文件，可以直接读写。
11. Path.