python 3d游戏脚本_3ds Max python脚本编写及部分API介绍

1.无名

最近，老师让我用3ds Max渲染一批模型制作数据集。大概看了一下，每个模型从不同角度共需要渲染一百多张，而这样的模型总共有三百多个。如果直接手工上手开干的话，我想我可能会变成一个无情的渲染机器，但是，作为一个计算机学科的学生，这不正是发挥专业特长的时候吗？首先分析一下这个任务，无非就是以下几个步骤：

导入模型；

制作关键帧动画；

渲染图片并保存；

重复以上动作N次；

而我们知道，重复的工作是计算机最擅长的，因此我在官网3ds Max 2018 Help 花了一些时间查阅3ds Max脚本，然后将一个集合自动加载、动画、渲染、保存、清除等流程写成一个脚本文件，最后运行脚本，开始摸鱼。

2. 3ds Max脚本简介

3ds Max原生的脚本语言是MAXScript，而通过其官方提供的MAXPlus库来提供对python2.7语言的支持。安装的时候自带python2.7的运行环境，可以在菜单栏 -> Scripting -> MAXScript Listener 中选中python，然后就可以测试python代码(如图1所示)。

图1. MAXScript Listener

而写好的脚本文件则可以在菜单栏 -> Scripting -> runScript中选中运行。因为python API没有MAXScript资料和文档丰富，所以一般在实际脚本编写中可以将MaxScript和python结合使用。

3. MaxPlus API简介

python主要通过MaxPlus包来实现3ds Max的相关操作。下面介绍一些MaxPlus的常用类和函数。

MaxPlus.Core类

import MaxPlus

MaxPlus.Core.EvalMAXScript(command) #在python中运行Maxscript脚本，command维MAXScript命令。

MaxPlus.FileManager类

– MaxPlus.FileManager.Merge() #将Max模型合并到当前模型

– MaxPlus.FileManager.Import() #导入模型，如fbx，obj等。

MaxPlus.SelectionManager类

– MaxPlus.SelectionManager.GetNodes() #获取场景中选中的所有INode对象。

MaxPlus.INode类

– MaxPlus.INode.IsGroupMember() #判断是否是组成员，类似的有 IsGroupHead()

– MaxPlus.INode.Delete(self) #删除一个INode物体

– MaxPlus.INode.DeleteNodes(INodeTab) #删除一系列INode节点

– MaxPlus.INode.SetLocalRotation(rotate_axis) #设置按照局部坐标系旋转

– MaxPlus.INode.GroupNodes(INodeTab, MaxPlus.WStr(name)) #将所选INode组合

– MaxPlus.INode.GetINodeByName(name) #根据模型名获取模型INode对象

MaxPlus.Quat 四元数类

– MaxPlus.Quat(x,y,z, w) # 获取给定数值的旋转四元数

– quat = MaxPlus.Quat()

– quat.SetEuler(dx,dy,dz) #按欧拉角的方式分别设置绕X，Y，Z的旋转角度(弧度)，进而获得对应的四元数。

MaxPlus.Animation 动画类

注意！动画中每一帧被分为160段

import MaxPlus

anim = MaxPlus.Animation

newRange = MaxPlus.Interval(0, newFrames) #获取时间区间类，其中newFrames = 实际帧数 * 160

anim.SetRange(newRange) #设定动画帧数范围

anim.SetAnimateButtonState(True) #开启自动关键帧按钮

for idx in range(0,Nums):

anim.SetTime(( idx*Frames) * ticks, doRedraw) #设置关键点

node.SetLocalRotation(quat) #从上一个关键点到这个关键点，所做的变换

anim.SetTime( ((idx+1)*Frames-1) * ticks, doRedraw) #设置关键点

node.SetLocalRotation(no_rotate) #从上一个关键点到这个关键点，所做的变换,

anim.SetAnimateButtonState(False) #关闭自动关键帧按钮

MaxPlus.RenderSettings 类

这是一个静态类，主要用来设置渲染参数

– MaxPlus.RenderSettings.SetOutputFile(outputpath) #设置输出路径

– MaxPlus.RenderSettings.SetSaveFile(True) #选择保存渲染图片

– MaxPlus.RenderSettings.SetWidth(width) #设置渲染图片宽度

– MaxPlus.RenderSettings.SetTimeType(2) #设置渲染帧数方式，2为设置帧数范围，此外，0为渲染单帧

– MaxPlus.RenderSettings.SetFileNumberBase(0) #渲染多帧图片保存的开始下标

– MaxPlus.RenderSettings.SetStart(0) #设置帧数范围的起点

– MaxPlus.RenderSettings.SetEnd() #设置帧数范围的终止点

– MaxPlus.RenderSettings.OpenDialog() #打开渲染设置框，这个测试的时候有助于更新并应用参数

– MaxPlus.RenderSettings.CreateDefault(index) #获取渲染器，其中下标index为你渲染设置界面渲染器的顺序。这里我用的是V-Ray GPU Next, update 2，排在第6，因此index=6.

– MaxPlus.RenderSettings.SetCurrent(vray_renderer) #将上面得到的渲染器，设为当前渲染器，即可以采用这个渲染器进行渲染。

MaxPlus.ViewportManager 类

该类用于管理当前窗口

– MaxPlus.ViewportManager.Viewports #生成器类似，可列出所有窗口

– MaxPlus.ViewportManager.SetActiveViewport(idx) #idx为某个窗口在上面生成器中的下标，该函数可将该窗口设为活跃窗口(渲染器将会渲染活跃窗口的内容)。

– MaxPlus.Viewport.SetViewCamera(cam) #将某个相机INode设为窗口的视图，渲染器将可以渲染相机视图。

其他函数

– MaxPlus.RenderExecute.QuickRender() #开始渲染

3. 总结

我这里介绍的API只是一些我用到的，在官网可以看到MaxPlus的类和函数非常多，全部了解不太现实，一般可以用到什么再去学，这里可以结合官网和安装包提供的python脚本示例代码进行学习( 在3ds Max[安装路径\Autodesk\3ds Max 2018\scripts\Python] 目录下可以找到相关脚本文件)。