Awesome
Pyblish integration for Autodesk Maya 2008-2019.
<br> <br> <br>What is included?
A set of common plug-ins and functions shared across other integrations - such as getting the current working file. It also visually integrates Pyblish into the File-menu for easy access.
- Common plug-ins
- Common functionality
- File-menu shortcut
Installation
pyblish-maya depends on pyblish-base and is available via PyPI.
$ pip install pyblish-maya
You may also want to consider a graphical user interface, such as pyblish-qml or pyblish-lite.
<br> <br> <br>Usage
To get started using pyblish-maya, run setup()
at startup of your application.
# 1. Register your favourite GUI
import pyblish.api
pyblish.api.register_gui("pyblish_lite")
# 2. Set-up Pyblish for Maya
import pyblish_maya
pyblish_maya.setup()
<br>
<br>
<br>
Documentation
<br> <br> <br>Under the hood
The setup()
command will:
- Register
maya
andmayapy
as as a "host" to Pyblish, allowing plug-ins to be filtered accordingly. - Append a new menu item, "Publish" to your File-menu
- Register a minimal set of plug-ins that are common across all integrations.
No menu-item
Should you not want a menu-item, pass menu=False
.
import pyblish_maya
pyblish_maya.setup(menu=False)
<br>
<br>
<br>
Manually show GUI
The menu-button is set to run show()
, which you may also manually call yourself, such as from a shelf-button.
import pyblish_maya
pyblish_maya.show()
<br>
<br>
<br>
Teardown pyblish-maya
To get rid of the menu, and completely remove any trace of pyblish-maya from your Maya session, run teardown()
.
import pyblish_maya
pyblish_maya.teardown()
This will do the opposite of setup()
and clean things up for you.
No GUI
In the event that no GUI is registered upon running setup()
, the button will provide the user with this information on how they can get up and running on their own.