发行说明Mari 3.0版1

 

发布日期

2015年12月2日

警告：  第一组发行说明中无意中省略了有关从PythonQt迁移到PySide的信息。 Mari 3.0v1，请参阅PythonQt到 PySide更改了解更多信息。

系统要求

注意：  Mari通过更新，更高级的硬件配置来提高其性能水平。然而， Mari经过测试，能够在许多较旧的前代系统上运行。因此，我们列出了建议的最低要求以及进行了哪些测试。您的特定需求可能与其他用户的需求有所不同。

官方支持的操作系统

• Mac OS X 10.9.5（Mavericks）或更高版本

• Windows 7 64位或更高

• Linux 64位操作系统（CentOS / RHEL 5.4）

最低硬件要求

• 四核处理器

• 10 + GB磁盘空间可用于缓存和临时文件

• 至少4GB RAM

• 以1680 x 1050像素分辨率显示

• 带有最新驱动程序的NVIDIA或AMD *图形卡

• 1GB图形内存

• OpenGL 3.2 *或更高版本

*位移预览当前仅在支持OpenGL 4.0或更高版本的卡和驱动程序上可用。

推荐系统要求

• 2.5 + Ghz四核处理器

• 250 + GB的磁盘空间可用于缓存和临时文件。SSD是优选的。

• 16GB RAM和额外的虚拟内存*

• 以1920 x 1080像素分辨率显示

• 带有最新驱动程序的NVIDIA或AMD *图形卡

• 2 + GB图形内存

• OpenGL 4.4或更高版本的支持

*使用虚拟内存可以提高稳定性，并有助于防止大型项目中的数据丢失。

“推荐”并不能保证它满足您的特定需求。

经测试的工作站硬件

下面列出的配置是The Foundry经过测试的配置Mari。由于市场上不断变化的性质和种类繁多的计算机硬件，The Foundry无法正式认证硬件。以下内容可以作为建议，并不保证它可以满足您的特定需求。

请下载并安装适用于NVIDIA或AMD网站的最新图形驱动程序，并确保对AMD卡使用的驱动程序为8.982.1或更高版本。

如果遇到任何问题，请联系support@thefoundry.co.uk。

经测试的工作站硬件
苹果	• MacPro4,1 • MacPro5,1 • iMac13,2 • MacBookPro10,1
生命值	• 惠普Z600 • 惠普Z620 • 惠普Z800

经过测试的GPU硬件
AMD Prosumer显卡	• AMD Radeon HD-D500 • AMD Radeon R7-260倍
AMD企业图形卡	• AMD FirePro W7000
NVIDIA Prosumer显卡	• NVIDIA Geforce GTX 680 • NVIDIA Geforce GTX Titan • NVIDIA Geforce GT 650M
NVIDIA企业图形卡	• NVIDIA Quadro 4000 • NVIDIA Quadro K5000 • NVIDIA Quadro M6000

新的功能

节点图

• Mari可通过以下方式访问的幕后节点图Node Graph调色板，使您可以更精确地控制分层系统。与图层系统交互时，会自动创建和操作节点，但是您可以在Node Properties调色板以达到所需的结果。

• Mari的Node Graph有两种模式， Basic和Advanced，在调色板中显示不同级别的细节。基本模式（默认模式）仅允许您使用Layers调色板。Advanced模式会在Node Graph调色板，包括所有图层，通道和着色器。

注意：  您可以启用Advanced中的节点图Preferences对话框下Node Graph > General > Advanced View。

小发明和出版

• 组节点可以另存为.gizmo文件，使您可以从“节点图”中保存图层并在协作工作流程中共享它们。一个的属性视图.gizmo允许您选择要在导出的Gizmo中公开的成员节点的哪些参数。

Gizmos可以装回Mari通过：

• 注册.gizmo在Python API中，

• 注册.gizmo在节点目录文件中，或

• 复制.gizmo进入~/Mari/Gizmos目录，由...自动搜索Mari在启动时。

使用Modo烘焙

• Mari现在可以将往返纹理烘焙到Modo，使您可以修改参数并查看预览更新。您可以通过创建新的烘焙食谱轻松添加.lxo文件。

Modo渲染器集成

• Mari现在包括一个Modo Render走路的脚本Mari的Node Graph并将阴影信息发送到Modo。然后，Modo使用其离线渲染器渲染场景。

的Modo Render该脚本还包含有关如何集成的示例Mari和离线渲染器。

• Mari使用以下环境变量来加载“烘焙”和“渲染”配方： MARI_MODO_BAKE_PRESETS和MARI_MODO_RENDER_PRESETS。

每通道色彩管理

• 现在，可以通过第三方OpenColorIO库按图像和每个通道使用Colorspace属性。您还可以指定一个项目默认值，类似于Nuke的OpenColorIO config设置。

开放细分支持

• Mari现在支持几何细分，具有以下优点：

• 可观察到的光滑表面，类似于最终离线渲染器的细分，

• UV布局可以细分，从而可以查看更准确的UV布局，并且

• 无需预先细分几何。

• 的Subdivision对话框包含通过单击以下选项来计算前景中的细分的选项OK或点击背景In Background。

• OK -进度条显示为Mari计算细分。完成后，指定的细分级别将立即应用于对象。如果在前台运行时细分失败，则会显示一个错误对话框。

• In Background -细分计算已提交到后台处理，并且没有进度条显示。细分Level必须在Objects当“跑步者”图标从状态栏中消失时显示调色板。

Arnold，V-Ray，虚幻和Redshift着色器

• Mari现在包括Arnold，V-Ray，Unreal和Redshift着色器，使您可以在更逼真的行业标准着色器下绘制纹理，从而改善其纹理的可视化效果。

会话脚本

• 会话脚本允许您创建以下内容的轻量级存档Mari项目，将数据合并到其他项目中。会话脚本可用于在彼此上下文中查看资产或共享数据，例如图像，通道和着色器。数据也可以用作模板系统，以使用默认通道，着色器等设置项目。

通过PartIO进行纹理传输

• Mari现在，您可以在高多边形和低多边形模型之间生成高度和法线贴图，包括跨贴片边界的无缝模糊和通过纹理转移的重叠UV。

实体定位器

• Mari的Move工具现在显示轴和运动方向，并允许您旋转和缩放几何。

FBX几何支持

• Mari现在支持从中导入几何.fbx文件，包括使用树小部件从文件中选择特定的子几何体。

选择组

• 现在，您可以使用Python API操纵选择组，从而可以自动化管道中与选择组相关的功能。

• ID 42287-一种新的智能选择类型，称为Selection Group已添加，使您可以循环浏览所选面孔所属的各个选择组。

Python升级

• Mari现在与其他领先的行业产品一起提供了Python 2.7.3。

安全模式

• Mari现在包括--safe和--safer类似于Nuke的启动模式，具有不同的日志记录级别，可以帮助在运行时诊断问题Mari。

杂

• ID 47144- Selection Mask层/节点类型已添加到Procedural > Geometry图层菜单。该层/节点将当前选择输出为1。

功能增强

• 您现在可以用Face启用选择，就像处理对象或补丁一样。只需选择要填充的面，然后选择Patches > Fill从菜单栏或右键单击菜单。

• 现在，您可以为Group图层的工作方式与Photoshop中的“通过”混合模式相似。在里面Layers调色板，与Group选定图层，单击“通过”图标。

• ID 43764-现在将对象元数据写入已加载的新版本.abc要么.fbx几何图形，以便稍后可以使用会话脚本读取元数据并重新创建场景。

• ID 46073-添加了将Python API的压缩选项传递给OpenEXR文件编写器的支持。

• ID 50082- Data > Cache类别已重命名为Data > Project在里面Mari首选项。

Bug修复

• ID 32251-按PgUp和PgDown键在上一个频道和下一个频道之间移动，而不是移动到频道列表可见区域的顶部和底部。

• ID 34502-无法启动Mari禁用用户自定义。

现在添加了两种模式： --safe和--safer。这会禁用用户自定义等功能。

• ID 34542-切换Tool Properties调色板（F7）未分配，并且它不再出现在Manage Keyboard Shortcuts对话。

• ID 37717-在某些情况下， Mari尝试保存时崩溃。

• ID 37927-无法从name中的字段Objects调色板。

• ID 40963- Mari使用GUI加载投影仪时崩溃。

• ID 41487- Mari无法识别OCIO颜色配置文件（例如config.ocio）中包含的OpenColorIO“外观”。

• ID 42426-V-Ray着色器没有本机支持。

• ID 42861-着色器源代码文件中有一个错字，表示“ Bitangent”显示为“ biTangent”。

• ID 43732-尝试撤消缓存并不总是撤消该操作。

• ID 44964-复制组图层或图层蒙版不会深度复制成员图层的图像集。

• ID 47732 -核弹<>Mari网桥映射方案未正确序列化，导致网桥脚本失败。

• ID 47749-层堆栈的默认布局意味着程序属性部分在视图中大部分被遮盖。

• ID 48268- Mari阅读MARI_PLUGINS_PATH环境变量，其顺序与预期的UNIX顺序相反，优先于最接近字符串末尾的那些条目。

• ID 48861-色彩空间工具栏已锁定，但未响应打开/关闭管理按钮。

• ID 49335-将多个过程层转换为可绘画有时会失败或引起Mari崩溃，因为处理它们的顺序可能导致它们发生冲突。

• ID 49600- Mari有时会将项目中的每个面片偏移-1。

• ID 49671-核弹<>Mari Bridge在某些情况下无法发送组件。

• ID 49690-当对象的UV贴图侵入负空间时，重复复制通道，导致Mari坠毁。

• ID 51062-仅限Mac OS X：菜单项显示为灰色，如果该菜单项不可用Mari会议是第一个创建Mari.ini文件。

开发者须知

这些是与开发人员相关的更改。

新的功能

PythonQt到 PySide更改

在3.0v1中， Mari从PythonQt迁移到PySide以进行Python绑定。尽管功能保持不变，但仍存在一些差异，例如功能签名，这可能会影响现有脚本。本节列出了对Mari的Python引擎，以及有关中的新功能的一些说明Mari 3.0v1以及从PythonQt迁移到PySide所产生的更改。

主要变化

• 更新了随附的Python版本Mari从2.6.5到2.7.3。

• 将Python API绑定生成从PythonQt更改为PySide。

• 为新的节点图功能添加了Python API绑定。

• 为新的OpenSubdiv功能添加了Python API绑定。

• 为新的Colorspace支持添加了Python API绑定。

• 为新的定位器功能添加了Python API绑定。

• 添加了Python API绑定以与新的Image and Geometry CAPI插件进行交互。

• 为OpenColorIO支持添加了许多功能。

PySide绑定生成更改导致的隐式Python API更改

连接信号时，请勿使用临时对象，因为它们会由于引用计数而使PySide崩溃。始终存储临时对象，以便保留对它的引用，并且不会收集垃圾。以下示例崩溃：

def createComboBox(): return PySide.QtGui.QComboBox() def doSomething(): print 'Hello World!' createComboBox().currentIndexChanged.connect(doSomething)

作为一种解决方法，请执行以下操作：

combo_box = createComboBox() combo_box.currentIndexChanged.connect(doSomething)

注意：  这在PySide文档中有所说明，请参阅： https://wiki.qt.io/PySide_Shiboken_Object_Ownership#Common_pitfalls。

PySide对类型严格，因此某些函数不接受枚举的等效整数值。例如，以下不再起作用：

channel = mari.current.channel() channel.setDepth(16, 1)

而是执行以下操作：

channel.setDepth(mari.Image.DEPTH_HALF, mari.Channel.CONVERT_ALL)

自2.6v5以来的次要API更改列表

• 裸露MkdirCommand到Python API。

• 添加MriRegExpChannelNameExtractor和Python API。

• 添加了额外的信号ImageManager适用于Python API。

• 添加transform() Image Python API的方法。

• 向Python API添加了项目信号回调。

• 为选择组添加了Python绑定。这意味着要再创建五个API对象， SelectionGroupManager， SelectionGroup ， ObjectSelectionGroup ， FaceSelectionGroup和PatchSelectionGroup。另外，在Python示例文件夹中添加了一个示例脚本，该脚本适用于Mari Python示例菜单。

• Texture Transfer-添加了用于位移，高度和高斯模糊操作的Python API。

• Texture Transfer-为通过Python的新操作链添加了支持GUI。

• 通过Python添加了选择选择组。

• 节点图API。

• 添加了PythonAPI以支持CAPI图像插件。

• 添加了将额外的参数从Python传递到CAPI纹理和几何的代码。

• OpenColorIO-添加OpenColorIO到Python API。

• OpenColorIO-扩展ImageManager在Python API中使用，因此可以在打开图像时指定色彩空间属性。

• OpenColorIO-Python API中的扩展图像，因此可以访问和修改色彩空间属性。

• OpenColorIO-扩展的Python API，包括检查配置文件中是否存在色彩空间或角色的方法。

• OpenColorIO-当colorspace阶段参数超出范围时，使Python API引发异常。

• OpenColorIO-已注册ColorspaceType用Python API枚举。

• 自定义显示Pythom API-添加了Python函数来创建PySide小部件，该小部件托管用于显示驱动程序API的自定义小部件。

• 修复了Python API通道信息修饰符，因此它可以正确设置指定的文件空间。

• 弃用的旧COLOR和SCALAR Python API中的系统。

• 添加的色彩空间默认值更改了对Python API的信号。

• 向Python API添加了colorspace配置更改的信号。

• OpenColorIO-添加了将自动文件名解析为Python API中的config类的方法。

• 添加了用于细分的Python API。

• 在Python API中添加了方法，以确定配置文件名是否为随附的标准文件名Mari。

• 增加了在Python API中指定更改颜色空间配置信号名称的功能。

• 添加了Python API信号，用于更改通道的标量色彩空间配置。

• 重命名Python API类EventWrapper至WrappedEvent以便它可以与PySide一起构建和使用。

• 将Python API绑定从PythonQt切换到PySide。

• 删除了冗余的PythonQt信号连接方式mari.utils.connect()。

• 添加了Python LocatorEntity类。

• 扩展的GeoEntity获取并设置转换。

• 扩展的GeoManager列出定位器。

• 在Python API中的画布上添加了暂停着色器编译。

• 添加了对将压缩选项从Python API传递到OpenEXR文件编写器的支持。

• 重新启用DIFFERENCE Python API中图层的混合模式。

• 添加hasAdjustmentStack， isAdjustmentStackEnabled ， setAdjustmentStackEnabled到Python API。

• Python API-分离ImageSet.importImages()和ImageSet.importImagesFromDict()以支持从图像对象和文件路径的字典中导入图像。

纹理访问API

• 添加了新的C API，使您可以实时处理纹理数据Mari改善Mari与外部渲染器。C API允许外部渲染请求特定的纹理数据，并在从场景渲染场景时将其应用于几何Mari。

• 使用C API访问纹理数据可为外部应用程序提供实时的未压缩原始数据，由Mari的DataManager，允许进行有效的内存分页。

显示驱动程序API

• 添加了新的C API，使您可以编写自己的C API Mari插件来接收和显示外部流式图像数据，例如外部渲染器结果。

Display Driver API启用Mari可以更紧密地集成到LookDev管道中，因为它构成了LookDev集成的一部分，其中Mari将纹理和底纹信息发送到外部渲染器，并且Mari接收渲染的结果。

自定义图上下文API

• 添加了新的C API，使您可以将上下文信息添加到以下节点中Mari的节点图。

Custom Graph Context API支持Mari可以更紧密地集成到LookDev管道中。

Custom Graph Context API的示例用法包括：

• 外部实时视口，

• 自定义导出和导入，

• 添加自定义属性，

• 外部和网络渲染或烘焙，以及

• 将着色信息移植到其他软件。

几何访问API

• 的Mari C API已扩展为包括两个以上的几何访问API， MriGeometryAccessPlugin和MriUserGeometryOperationPlugin。这些使您可以创建插件来访问内部的几何Mari项目并在这些几何上执行操作。

的Example OBJ Exporter，也提供了内置示例几何访问插件。它演示了访问几何图形并对其执行操作以及将几何图形导出到几何图形中的能力。 .obj格式。

杂

• ID 51590-您可以从Node Properties通过在Python控制台中输入以下命令来创建调色板：

b = mari.actions.get("/Mari/NodeGraph/Delete All Properties") b.trigger()

功能增强

• ID 44024-一种Python API方法， removeKeyFrame已添加，以从图像集中删除关键帧。

• ID 46034-示例代码已添加到Python开发人员指南从Alembic文件创建投影仪。

• ID 46073-添加了将Python API的压缩选项传递给OpenEXR文件编写器的支持。

• ID 46539-已将注释添加到GeoEntity.patchList()和GeoEntityVersion.patchList()表示GeoEntity返回所有版本的补丁组合列表，而GeoEntityVersion仅返回该版本的补丁列表。

• ID 49554-Python API： Mari的AdjustableLayer现在的课程包括isAdjustmentStackEnabled()和setAdjustmentStackEnabled()方法。

• ID 50171-Python API： ImageSet.importImages()和ImageSet.importImagesFromDict()为了支持从“图像”对象和文件路径的字典中导入图像，已对函数进行了分离。

Bug修复

• ID 47138-仅Linux： Mari捆绑包不包含libQtDesigner.so文件，这意味着QtUiTools不可用。

• ID 48239-缺少QtUiTools模块Mari的PySide的编译。