mirror of
https://git.mirrors.martin98.com/https://github.com/google/draco
synced 2025-08-05 12:20:39 +08:00
93 lines
2.7 KiB
Markdown
93 lines
2.7 KiB
Markdown
# Description
|
|
Plugin to add support for Draco files (.drc) in Autodesk Maya.
|
|
|
|
# Features
|
|
The following `features` are offered:
|
|
* Support .drc format: TRIANGULAR MESH (no POINT CLOUD)
|
|
* Import .drc file into Maya by "Import menu" and "Drag & Drop"
|
|
* Export from Maya into .drc file by "Export Selection menu"
|
|
|
|
With the following `constraints`:
|
|
* Import feature is limited to attributes: Vertices, Normals and Uvs
|
|
* Export feature is limited to attributes: Vertices, Normals and Uvs
|
|
* Meshes has to be made of Triangular Polygons
|
|
|
|
| Read [Release doc](./RELEASE.md) for details about what is implemented and what will be done next.
|
|
|
|
# Supported OS / Maya Version
|
|
Currently the plugin has been built for the following `OS`:
|
|
* Windows x64
|
|
|
|
and tested against Maya versions:
|
|
* Maya 2017
|
|
* Maya 2018
|
|
|
|
| Note: if you want you can build the plugin for your `OS / architecture`. Refer to `Build from Sources` section
|
|
|
|
# Installation
|
|
## On Windows
|
|
1. Copy the folder `draco_maya` under Maya pluging folder.
|
|
| E.g.: C:\Users\<USER>\Documents\maya\<VERSION>\plug-ins
|
|
2. Open Maya go to menu: `Windows -> Settings\Preferences -> Plug-in Manager`
|
|
3. Use `Browse` button, point to `draco_maya` folder and select `draco_maya_plugin.py` as plugin file
|
|
|
|
# Usage
|
|
Use the regular Maya Import/Export functionalities.
|
|
|
|
# Build From Source
|
|
You can build the plugins on your own for OSX/Win/Linux. Source code for the wrapper is here: [src/draco/maya/](../src/draco/maya). Following is detailed building instruction.
|
|
|
|
### Mac OS X
|
|
On Mac OS X, run the following command to generate Xcode projects:
|
|
|
|
~~~~~ bash
|
|
$ cmake path/to/draco -G Xcode -DBUILD_MAYA_PLUGIN=ON
|
|
~~~~~
|
|
|
|
Then open the project use Xcode and build.
|
|
You should be able to find the library under:
|
|
|
|
~~~~ bash
|
|
path/to/build/Debug(or Release)/draco_maya_wrapper.bundle
|
|
~~~~
|
|
|
|
The makefile generator will also work:
|
|
|
|
~~~~~ bash
|
|
$ cmake path/to/draco -DBUILD_MAYA_PLUGIN=ON && make
|
|
~~~~~
|
|
|
|
`draco_maya_wrapper.bundle` can be found in the directory where you generated
|
|
the build files and ran make.
|
|
|
|
### Windows
|
|
On Windows, run the following command to generate Visual Studio projects:
|
|
|
|
32-bit version:
|
|
~~~~~ bash
|
|
cmake path/to/draco -G "Visual Studio 15 2017" -DBUILD_MAYA_PLUGIN=ON -DBUILD_SHARED_LIBS=ON
|
|
~~~~~
|
|
|
|
64-bit version:
|
|
~~~~~ bash
|
|
cmake path/to/draco -G "Visual Studio 15 2017 Win64" -DBUILD_MAYA_PLUGIN=ON -DBUILD_SHARED_LIBS=ON
|
|
~~~~~
|
|
|
|
Then open the project use VS and build.
|
|
You should be able to find the library under:
|
|
|
|
~~~~ bash
|
|
path/to/build/Debug(or Release)/draco_maya_wrapper.dll
|
|
~~~~
|
|
|
|
### Linux
|
|
On Linux, run the following command to generate a Makefile build and build the
|
|
plugin.
|
|
|
|
~~~~~ bash
|
|
$ cmake path/to/draco -DBUILD_MAYA_PLUGIN=1 && make
|
|
~~~~~
|
|
|
|
Note: While the linux build completes successfully, the plugin has not been
|
|
tested.
|