AL_omx
is an open-source library that provides a thin wrapper around Maya OM2 which makes it easy to manipulate nodes, attributes and connections while retaining the API's performance:
- User-friendly entry point into Maya’s native om2 (maya.api.OpenMaya) API .
- Simple explicit code. Cookbook.
- Closer to Maya’s om2 API’s performance over other libraries. Performance Comparison.
- Built-in Undoability.
Install AL_omx
using mayapy -m pip install AL_omx
, or by adding the root directory to sys.path
. The url for PyPi
package is here.
For more information on the installation, check out here.
The requirements of AL_omx
:
Python | Maya |
---|---|
3.7+ | 2022+ |
AL_omx
uses object-oriented syntax:
from AL import omx
transform, locator = omx.createDagNode(
"locator", nodeName="myLocShape", returnAllCreated=True
)
omx.createDGNode("time", nodeName="myTime")
persp = omx.XNode("persp")
perspShape = omx.XNode("perspShape")
persp.visibility.setLocked(True)
transform.t.set([2.0, 2.0, 2.0])
print(f"locator worldMatrix: {transform.wm[0].get()}")
locator.overrideEnabled.set(True)
locator.overrideColor.set(14)
persp.r.connectTo(transform.r)
transform.sx.connectFrom(omx.XNode("time1").outTime)
transform.r.disconnectFromSource()
# ctrl+Z/shift+Z to undo & redo
The full document source is available in the docs
folder, you can generate the document yourself using sphinx
, check out here for how to do it.
The full online documentation can be found at https://animallogic.github.io/AL_omx/
Here are some convenient entries:
For how to contribute to AL_omx
, check out here.
If you have any issues or feature suggestions, please feel free to submit a ticket in GitHub Issues.