Table of Contents
Note: Certain development tools referenced in this document are provided by third parties, not by Amazon. Any links to these tools in this document take you to third-party sites to download and install them. This software uses the FreeImage open source image library. FreeImage is used under the FIPL license. See http://freeimage.sourceforge.net/freeimage-license.txt for details. Source code for this library is available at http://downloads.sourceforge.net/freeimage/FreeImage3154Win32.zip.
The Euclid Toolchain is a set of graphics tools that work with Autodesk Maya to create 3D digital graphic assets and animations. This section describes how to set up your system with Autodesk Maya and the EuclidBuilder plugin. Using other tools for graphics development is not recommended.
The following steps assume that you are developing 3D graphic assets and packaging bundles on a Windows computer.
Note: The Euclid Toolchain is currently only supported on Autodesk Maya running on the Windows platform. You can install it on MacOS and Linux systems, but be aware that all the Euclid tools are not supported and not guaranteed to work on these platforms.
Install Autodesk Maya
You must provide your own copy of Autodesk Maya.
- Go to the Autodesk Maya website and download Autodesk Maya. After you have downloaded the Autodesk Maya installer (Setup.exe) to your computer, install the product as follows:
- Double-click setup.exe.
- When the splash screen appears, click Install on this computer.
- Select the license type (stand-alone or network) and add the product serial number.
- Accept the default installation path (
- Click Finish.
- Go to the Python website and download Python 2.7.6. Select the appropriate installer (.msi) for your your computer. For example, for a 64-bit Windows system, select
Python 2.7.6 Windows X86-64 Installer.
- After you have downloaded the Python installer to your computer, double-click the .msi file and click Run. When installing, accept the default installation path,
C:\Python27. Configure the Python installation as desired. On the last dialog box, click Finish.
- Add the Python installation path (the default is
C:\Python27) to your path. To do this, click Start, right-click Computer, select Properties, then click Advanced System Settings. In the System Properties dialog, select the Advanced tab, then click Environment Variables. In the System Variables list, select PATH, click Edit, and in Variable Value, append
;C:\Python27to the list of path names.
Set Up the Fire Phone SDK
If you haven't done so already, set up the Fire Phone SDK, as described in Setting Up Your Development Environment.
Install the Euclid Tools
On your development computer, go to the folder in which the Fire Phone SDK Addon files were installed to the Android Development Tools (ADT) folder. For example, if you installed the ADT to
C:\ADT, go to:
This directory contains a
tools directory; copy it to a folder that you choose, for example:
Set up the EuclidBuilder Plugin for Autodesk Maya
Configure Your Maya Environment
The EuclidBuilder plugin allows you use the Euclid Toolchain tools with Autodesk Maya. To do this, modify your Maya.env file to point to the location of the EuclidBuilder plugin. In the following instructions,
<eb_root> represents the directory to which you copied the tools directory, for example,
The Maya.env file is located at
%userprofile%\documents\maya\2013-x64\maya.env. Open the maya.env file, and add the following lines:
You should save the file as plain text.
Add the following lines to the Maya.env file, which is located at
Set the Root of Your Maya Project
It is important to make the 3D assets repository the root of your Maya project. You can set the project root wherever you want. However, if you and your team are collaborating with each other through a revision control system such as Perforce or Git, you need to share the same root project path. The reason for doing this is because Maya relies on the project path to search for files such as textures. Note that Autodesk Maya stores absolute paths to referenced files. To avoid build problems due to differences in environment, use a consistent project root.
To set the project path: Open the File menu and select Set Project. Choose the root of your 3D assets enlistment as the root directory.
Maya might prompt you to create a new workspace file in the root directory. This is normal and you only need to do it once.
Load the Plugin
To load the EuclidBuilder plugin: From the Window menu, select Settings/Preferences, then select Plug-in Manager. The EuclidBuilder.py plugin is listed in the
<eb_root>/tools/maya/plug-ins folder. Select the Loaded and Auto load options. Click Close.