Maya 2019 release has been released now. Here is a guide based on What's New in API in Maya 2019 with some extra info.
For more details, please check our documents here.
Windows and MacOSX remain unchanged. Linux is updated to CentOS/RHEL 7.x(x>=2) and using gcc 6.3.1 from DTS 6.1
|Windows||Windows 7 x64||Visual Studio 2015 Update 3
Windows SDK Version 10.0.10586.0
|Mac||El Capitan 10.11.6||XCode 7.3.1|
|Linux||CentOS/RHEL 7.x(x>=2)||gcc 6.3.1(DTS 6.1)|
Important: Maya sets the SSL_CERT_FILE environment variable to point to the cert.pem file within its embedded Python Framework if SSL_CERT_FILE is unset.
If you need SSL_CERT_FILE to remain unset because you are using other means of controlling Python's certificate usage, set MAYA_DO_NOT_SET_SSL_CERT_FILE before launching Maya:
Devkit samples of Maya 2019 use CMake to generate makefiles/solutions.
Added a new geometryOverrideExample1/geometryOverrideExample1.cpp example plug-in, which demonstrates how to render geometry with a stock shader.
Added a new geometryOverrideExample2/geometryOverrideExample2.cpp example plug-in, which demonstrates how render geometry with a Maya shader network.
Added a new geometryOverrideHighPerformance/geometryOverrideHighPerformance example, which demonstrates how to use MPxGeometryOverride to render geometry with the best performance as possible.
Added a new footPrintNode_GeometryOverride/footPrintNode_GeometryOverride.cpp example plug-in to make it fully compatible with Evaluation Caching.
Added a new footPrintNode_GeometryOverride_AnimatedMaterial/footPrintNode_GeometryOverride_AnimatedMaterial.cpp example, which demonstrates how to draw a simple mesh like foot Print in an efficient way.
Added a new nameFilter/NameFilter.cpp example, which demonstrates how to create custom configuration rule filters with new API
Added a new testMTopologyEvaluator/testMTopologyEvaluator.cpp example, which demonstrates the features of topology evaluators.
Added a new topologyTrackingNode/topologyTrackingNode.cpp example, which demonstrates the use of the new version of the attributeAffects() relationship which can take a parameter specifying whether or not the relationship affects topology.
A number of devkit examples have been updated to remove deprecated methods.
An updated captureViewRenderCmd/captureViewRenderCmd.cpp devkit example now shows how to disable the output transform in Viewport 2.0 using the MRenderer::render() API.
Add a guide for cmake in readme.md
libOpenMayalib.a is removed in Linux.
Added a new tessellatedQuad example plug-in to the Maya devkit. The example demonstrates how to implement custom selection shader for kPatch render items in a MPxGeometryOverride. It also shows how to share geometry/index streams among several render items to avoid expensive recalculation.
Cg(moved to headers)
Universal Front End
- Universal Front End is to create a DCC-agnostic component that will allow a DCC to browse and edit data in multiple data models.
The initial data model targets to be supported are the Maya DG, Bifrost, and USD.
When a 3D model view activates Isolate Select for components, Viewport 2.0 creates and maintains necessary render items to represent the drawing of the isolate selected components specifically for that view. These render items are copies of their original items and so they have the same properties including name, type, primitive type, and draw mode. However, their shading components are filtered from the view selected set of that view.
New methods have been added to allow custom render items created in a MPxGeometryOverride implementation to have their copies created for the drawing of isolate selected components. They also provide access of the view-selected shading components so that the MPxGeometryOverride implementation can fill in geometries properly.
These new methods include:
The apiMeshShape example plug-in has been updated to use these new methods, and the Python API also includes these changes.
The mask argument has changed from a non-const reference to const reference for the following methods:
Updates to the both C++/Python MPxGeometryOverride class include the following new methods:
- MPxGeometryOverride::requiresGeometryUpdate(), which determines if other MPxGeometryOverride methods get called for the associated DAG object during the draw preparation phase.
- MPxGeometryOverride::requiresUpdateRenderItems(), which gets called when an instance of a DAG object changes to determine whether MPxGeometryOverride::updateRenderItems() needs to be called.
- MPxGeometryOverride::supportsEvaluationManagerParallelUpdate(), which gets called to determine if the scene is supported by the Evaluation Manager Parallel Update.
- MPxGeometryOverride::supportsVP2CustomCaching(), which gets called during evaluation to determine if VP2 Custom Caching is supported.
A new MPxDrawOverride::pointSnappingActive() method allows a draw override to query whether snapping to points is active.
A new MPxDrawOverride::userSelect() interface. It allows for adding a list of DAG paths/components and world space hit points.
A new MShaderManager::getArraySize method. It returns array size of the given parameter.
You can now control consolidation per-object to MPxGeometryOverride. The following new methods have been added to let you control whether render items participate in consolidation:
This change also deprecates the following methods:
The footPrintNode_SubSceneOverride example plug-in has been updated to use these new methods.
The MColorManagementNodes C++ API class has been added that allows you to manipulate color managed nodes; for example: you can color manage one or all input nodes, and query whether an object is color manageable or color managed. A colorManageAllNodes flag has also been added to the colorManagementPrefs MEL/Python command.
The new class allows topology override of evaluation graph. This makes possible to have total control over granularity, leverage already existing scheduling constraints and scheduling graph. Supports partial evaluation for minimal evaluation of cluster content. Finally, allows better resource utilization since execution of cluster content doesn’t have to wait for entire upstream to start and downstream can start as soon as dependencies are ready (sort of transparent clusters, but much more configurable and with no constraints on granularity).
New methods added to the MFnDependencyNode class let you set and manage which nodes have permission to be scheduled for evaluation by the evaluation graph. Nodes that do not have permission for evaluation can be created and destroyed without invalidating the evaluation graph.The Python API also includes these new methods.
- MFnDependencyNode::setAllowedToAnimate(), sets whether or not a node has permission to be added to the evaluation graph for scheduling during playback or manipulation. Nodes without permission, cannot be added to the evaluation graph.
- MFnDependencyNode::allowedToAnimate() indicates whether or not the node has permission for evaluation based on MFnDependencyNode::setAllowedToAnimate().
Added the following new methods to the MGraphEditorInfo class:
- MGraphEditorInfo::isStackedViewportMode(), which returns whether or not the Graph Editor is in Stacked View mode.
- MGraphEditorInfo::isNormalizedViewportMode(), which returns whether or not the Graph Editor is in Normalized View mode.
- New versions of the MProfiler::addCategory() and MProfiler::getAllCategories() methods now use a categoryInfo parameter in addition to the previous accepted parameters. Previous versions of these methods have been deprecated.
- A new MProfiler::getCategoryInfo() method returns the profiling category description.
- Add two methods for controlling topology dirtying
A new MPxCacheConfigRuleFilter class lets you define custom configuration rule filters for background evaluation caching. The new class includes the following methods:
- MPxCacheConfigRuleFilter::preRulesExecution(), which is called when the cache configuration rule application starts.
- MPxCacheConfigRuleFilter::postRulesExecution(), which is called when the cache configuration rule application stops.
- MPxCacheConfigRuleFilter::isMatch(), which gets called for each evaluation node when filter rules are applied for the cache configuration.
A new MCacheConfigRuleRegistry class includes a static method for registering and deregistering MPxCacheConfigRuleFilter custom classes.
A new nameFilter/NameFilter.cpp example demonstrates how to create custom configuration rule filters.
Updates to the MUIDrawManager include the following:
New cylinder and capsule primitive extension methods:
New parametric primitive methods now let you define the number of subdivisions for primitives:
The Python API also includes these methods. Updates to the uiDrawManager example plug-in in the Maya devkit include the new methods.
A new MCameraMessage class lets you register callbacks for interactive camera manipulation messages. To remove a callback use MMessage::removeCallback(). Note that all callbacks registered by a plug-in must be removed by that plug-in when it is unloaded. Failure to do so will result in a fatal error. The Python API has also been updated with these new methods.
A new cameraMessageCmd/cameraMessageCmd.cpp plug-in example demonstrates how to use each of the new camera manipulation callbacks.
A new version of the MFnMesh::create() method now stores vertices in doubles and allows edge connections.
The OpenMaya.MFnMesh.create () method in the Python API has also been updated with this improvement.
Added new kPinToGeometryUV, kPinToGeometryProx and kUfeProxyTransform enums.
Note, kPinToGeometryUV and kPinToGeometryProx are fater kClosestPointOnMesh. If you are using numbers directly instead of enum, it may cause problem.
Added the MPolyMessage::addColorSetChangedCallback() method to register a callback when ColorSetChanged is modified.
Added the following new enums to specify the type of color set change message:
- kColorSetAdded when a new color set gets added.
- kColorSetDeleted when a color set gets deleted.
- kCurrentColorSetChanged when the current color set gets changed.
The Python API has also been updated to include these changes.
Updates to the MGlobal class include the addition of the MGlobal::executeTaskOnIdle() method. Use this method to execute a customized task to execute on the next idle event. This is a thread safe way to schedule a task for the main thread to execute. This method is not available in Python.
Add a new method MGlobal::customVersion.
Added the MMessage::stopRegisteringCallableScript() method. Use this method to stop the MMessage object from being passed.
- Added a new kAfterCreateReference enum to the MSceneMessage class for Python. The enum provides support for MSceneMessage.addReferenceCallback().
- Added a new MColorPickerUtilities class, which lets you create a color picker that can grab colors from third-party plugins.
- Added a new callback MPxIkSolverNode::isAttributeCreatedBySolver. It returns whether a certain attribute on the ikHandle was created by the solver (and affecting the result of the solve).
- Added a new class MArrayIteratorTemplate. It enables iterators for Maya array classes.
- Added a new method MFnAnimCurve::insertKey
- The MnCloth::setAddCrossLinks() method now uses a boolean instead of a float value.
- doubleBuffered is renamed to softwareStaged in MVertexBuffer and MIndexBuffer. When using MVertexBuffer/MIndexBuffer in conjunction with Evaluation Manager Parallel Update in MPxGeometryOverride the buffer used must be software staged.
- In Maya 2019, we changed the deprecation mechanism for several methods. These methods have already been marked as being obsolete in the documentation for several years but now they will generate warnings at the compilation time. The documentation usually explains which alternate method to use. In the meantime the warning/error can be disabled by using the _OPENMAYA_DEPRECATION_PUSH_AND_DISABLE_WARNING and _OPENMAYA_POP_WARNING macros.