AL-omx 1.0.4

A fast and user-friendly library built on top of Autodesk Maya's OpenMaya library.

AL_omx

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.

QuickStart

Install AL_omx using mayapy -m pip install AL_omx, or by adding the root directory to sys.path. For more information on the installation, check out here.

The requirements of AL_omx:

Python	Maya
3.7+	2022+

Syntax

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

Documentation

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:

• Cookbook Style Snippets
• Public API Reference
• Running Tests
• Changes Log

Contribution & Feedback

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.