maya-glTF
glTF exporter plugin for Autodesk Maya
This plugin is compatible with most modern versions of Maya. Tested with Maya 2015+. Most of the glTF spec has been implemented, but this is still a work in progress. For best material results use StingrayPBS shader. Report any issues here!
Installation
- Download the ZIP file using the green button at the top of this page.
- Extract the ZIP and copy the files to their appropriate folders:
glTFExport.pyandglTFTranslatorOpts.melfrom thescriptsfolder need to be copied to the scripts folder here:
| OS | Path |
|---|---|
| (Windows) | C:/Users/<username>/Documents/maya/<version>/scripts |
| (Mac OS X) | Library/Preferences/Autodesk/maya/<version>/scripts |
| (Linux) | $MAYA_APP_DIR/maya/<version>/scripts |
glTFTranslator.pyfrom theplug-insfolder needs to be copied to the plug-ins folder here (create a plug-ins folder if you don't have one):
| OS | Path |
|---|---|
| (Windows) | C:/Users/<username>/Documents/maya/<version>/plug-ins |
| (Mac OS X) | Library/Preferences/Autodesk/maya/<version>/plug-ins |
| (Linux) | $MAYA_APP_DIR/maya/<version>/plug-ins |
Usage
Exporting through the File menu
- Launch Maya.
- Open the Plug-in Manager
- Check on "Loaded" for "glTFTranslator.py" plug-in.
- Export your scene: File->Export All...
- File->Export Selection... not currently supported.
- Choose "glTF Export" for the "Files of Type" option.
- Optionally, set any file type specific options as well.
Exporting as a part of a script
import glTFExport
glTFExport.export(r"C:\Temp\test.glb", resource_format='bin', anim='keyed', vflip=True)Export parameters
| Parameter | Description |
|---|---|
| file_path | Path to export the file to. File extension should be .glb or .gltf |
| resource_format | How to export binary data. Only applies to .gltf format. Valid value: 'bin', 'source', 'embedded'. bin - A single .bin file next to the .gltf file. source - Images are copied next to the .gltf file. embedded - Everything is embedded within the .gltf. |
| anim | How to deal with animation. Valid values: 'none', 'keyed'. none - Don't export animation. keyed - Respect current keys |
| vFlip | GL renderers want UVs flippedin V compared to Maya. Set to False if you don't need to fix the flipping. |
Current Features
- Export whole scene from Maya
- Exports transform nodes and meshes with hierarchy
- Exports single material shader per mesh currently.
- Picks the first shader.
- Lambert, Blinn, Phong use a PBR conversion approximation
- Base color comes from color attribute as texture or value.
- Metallic and roughness are derived from the other attribute values and do not support textures.
- Recommend StingrayPBS shader for best material conversion.
- Node animation supported for translation, rotation, scale.
- glTF and glb supported
- Options for embedded binary data, single external bin, or preserved external images.