source: OGRE/trunk/ogrenew/Tools/MayaExport/index.htm @ 657

Revision 657, 13.5 KB checked in by mattausch, 19 years ago (diff)

added ogre dependencies and patched ogre sources
RevLine 
[657]1<html>
2
3<head>
4<meta http-equiv="Content-Type" content="text/html; charset=windows-1252">
5<meta http-equiv="Content-Language" content="en-us">
6<meta name="GENERATOR" content="Microsoft FrontPage 5.0">
7<meta name="ProgId" content="FrontPage.Editor.Document">
8<title>Fifty1 Software: Maya-to-OGRE</title>
9<meta name="Microsoft Border" content="none">
10</head>
11
12<body topmargin="0" leftmargin="0" stylesrc="../index.htm" bgcolor="#003300" text="#FFFF00" link="#FFFFFF" vlink="#FFFF00" alink="#FECB62">
13<!--webbot bot="Include" U-Include="../include/nav_ogre_top.htm" TAG="BODY" startspan -->
14              <div align="left">
15                <table border="0" cellpadding="5" cellspacing="0" style="border-collapse: collapse" bordercolor="#111111" width="100%" bgcolor="#006600">
16                  <tr>
17                    <td width="50%" valign="top"><font face="Arial" color="#FECB62">
18                    <a name="Top"></a>Fifty1
19                    Software<br>
20                    <b>
21                    Maya-to-OGRE</b></font></td>
22                    <td width="50%" valign="top">
23                    <p align="right"><a href="http://ogre.sourceforge.net">
24      <img border="0" src="../images/ogrelinkbuttonsmall.gif" width="88" height="31"></a></td>
25                  </tr>
26                </table>
27              </div>
28
29<!--webbot bot="Include" i-checksum="54751" endspan --><div align="left">
30  <table border="1" cellpadding="5" cellspacing="0" style="border-collapse: collapse" width="830" bordercolor="#003300">
31    <tr>
32      <td bgcolor="#006600" align="center" valign="top" width="155">
33      <p align="left">
34      <b><font face="Arial">Links</font></b></p>
35      <p align="left">
36      <b><font face="Arial" size="2"><a href="http://www.fifty1.com">Fifty1 Home</a><br>
37      <a href="http://ogre.fifty1.com/">Fifty1 OGRE Stuff</a><br>
38      <a href="http://ogre.sourceforge.net">OGRE Home</a></font></b></p>
39      </td>
40      <td width="652" align="left" valign="top">
41              <i>
42              <font face="Times New Roman" size="2">(Developed with <b>macross</b> from
43              <b><a href="http://www.bytelords.de">bytelords.de</a></b>)</font></i><p>
44              <b><font face="Arial"><a name="Contents">Contents</a></font></b></p>
45              <blockquote>
46                <p><b><font face="Arial" size="2">
47                <a href="#Downloads">Downloads</a><br>
48                <a href="#Installation">Installation</a><br>
49                <a href="#Usage">Usage</a><br>
50                <a href="#Known Bugs">Known Bugs and Limitations</a><br>
51                <a href="#Features">Features</a></font></b></p>
52              </blockquote>
53              <hr noshade color="#FFFF00">
54              <p align="left" class="TopZ"><b><font face="Arial" size="2">
55              <a name="Downloads">Downloads</a></font></b></p>
56              <ul>
57                <li>
58              Source code is part of <a href="http://ogre.sourceforge.net">OGRE</a>
59              (0.12.1 and above)
60                </li>
61                <li>
62              Pre-compiled exporters:<ul>
63                <li>Ogre 0.12 and older:<ul>
64                <li><a href="4.5/ogre_0.12/maya2ogre.exe">Windows Maya 4.5</a>
65                <font size="1">(2003-10-31)</font></li>
66                <li><a href="5.0/0.12/maya2ogre.exe">Windows Maya 5.0</a>
67                <font size="1">(2003-10-31)</font></li>
68              </ul>
69                </li>
70                <li>Ogre 0.13 and newer<ul>
71                <li><a href="4.5/ogre_0.13/maya2ogre.exe">Windows Maya 4.5</a>
72                <font size="1">(2004-01-07)</font></li>
73                <li><a href="5.0/0.13/maya2ogre.exe">Windows Maya 5.0</a>
74                <font size="1">(2004-01-04)</font></li>
75              </ul>
76                </li>
77              </ul>
78                </li>
79                <li>
80              <a href="mel.zip">Maya MEL scripts</a> (Windows .zip archive)
81              <font size="1">(2003-10-15)</font></li>
82                <li>
83              <a href="OgreXMLConverter.zip">Pre-compiled OgreXMLConverter</a>
84              and support DLLs
85              (Windows .zip archive) <font size="1">(2003-10-23)</font></li>
86              </ul>
87              <blockquote>
88                <p><a href="#Contents">Back to Top</a></p>
89              </blockquote>
90              <hr noshade color="#FFFF00">
91              <p align="left" class="TopZ"><b><font face="Arial" size="2">
92              <a name="Installation">Installation</a></font></b></p>
93              Installation instructions assume you are using the pre-compiled
94              files above.
95              <ol>
96                <li>Copy the following MEL scripts to your Maya scripts
97                directory (typically &quot;My Documents/Maya/4.5/scripts&quot;
98                or &quot;My Documents/Maya/5.0/scripts&quot; in
99                Windows):<ul>
100                  <li>maya2ogre_setup.mel</li>
101                  <li>maya2ogre_window.mel</li>
102                  <li>maya2ogre_export.mel</li>
103                </ul>
104                </li>
105                <li>Update  userSetup.mel file in Maya scripts directory with
106                contents of userSetup.mel for Maya exporter<ul>
107                  <li>If userSetup.mel does not exist in your scripts directory,
108                  copy it there</li>
109                  <li>If userSetup.mel exists in your script directory, append
110                  the contents of the new userSetup.mel to the end (using
111                  Notepad)</li>
112                </ul>
113                </li>
114                <li>Copy the appropriate (Maya 4.5 or Maya 5.0) pre-compiled command-line exporter to a location in
115                your path<ul>
116                  <li>Alternatively, copy to Maya scripts directory to use from
117                  Maya UI only (will not be available from command-line)</li>
118                </ul>
119                </li>
120                <li>Copy the pre-compiled OgreXMLConverter and support DLLs to a
121                location in your path<ul>
122                  <li>Required support DLLs are OgreMain.dll, devil.dll and
123                  ilu.dll</li>
124                  <li>Alternatively, copy to Maya scripts directory to use from
125                  Maya UI only (will not be available from command-line)</li>
126                </ul>
127                <p><a href="#Contents">Back to Top</a></li>
128              </ol>
129              <hr noshade color="#FFFF00">
130              <p align="left" class="TopZ"><b><font face="Arial" size="2">
131              <a name="Usage">Usage</a></font></b></p>
132              <ul>
133                <li>Maya usage:<ul>
134                  <li>Launch exporter UI from new 'Ogre' menu (Ogre | Export)</li>
135                  <li>Define export details<ul>
136                    <li>Should be self-explanatory</li>
137                    <li>Export details are saved with the Maya file after each
138                    export</li>
139                  </ul>
140                  </li>
141                </ul>
142                </li>
143                <li>Command-line usage:<div align="left">
144                  <table border="1" cellpadding="5" cellspacing="0" style="border-collapse: collapse" width="100%" bgcolor="#FFFFFF" bordercolor="#FFFFFF">
145                    <tr>
146                      <td width="100%">
147                      <pre><font color="#000000">Version : Oct 15 2003 11:47:30
148Maya API: 450</font></pre>
149                      <pre><font color="#000000">Usage: maya2ogre -in FILE [-mesh [FILE]] [-vba] [-skel [FILE]]
150                 [-anim NAME START END STEP]
151                 [-mat [FILE]] [-mprefix PREFIX]
152                 [-n] [-c] [-t] [-v]</font></pre>
153                      <pre><font color="#000000"> -in      FILE   input mb File
154 -mesh    FILE   export mesh (FILE is optional)
155 -vba            export vertex bone assignments
156 -skel    FILE   export skeleton (FILE is optional)
157 -anim    NAME   export Animation beginning at START and ending
158          START  at END with fixed STEP
159          END
160          STEP
161 -mat     FILE   export material (FILE is optional)
162 -mprefix PREFIX material prefix
163 -n              export normals
164 -c              export diffuse colours
165 -t              export texture coords
166 -v              more output</font></pre>
167                      <pre><font color="#000000">Examples:
168 maya2ogre -in foo.mb -mesh -skel -mat
169     =&gt; exports skeleton, mesh and material using default file names,
170        in this case foo.mesh.xml, foo.skeleton.xml and foo.material</font></pre>
171                      <pre><font color="#000000"> maya2ogre -in foo.mb -mesh custom_name.mesh.xml -skel custom_name.skel.xml
172     =&gt; exports skeleton and mesh using user defined file names</font></pre>
173                      <pre><font color="#000000"> maya2ogre -in foo.mb -skel -anim Walk 1 30 2 -anim Die 50 60 2
174     =&gt; exports skeleton with animation tracks Walk and Die</font></pre>
175                      </td>
176                    </tr>
177                  </table>
178                </div>
179                </li>
180              </ul>
181              <blockquote>
182                <p><a href="#Contents">Back to Top</a></p>
183              </blockquote>
184              <hr noshade color="#FFFF00">
185              <p align="left" class="TopZ"><b><font face="Arial" size="2">
186              <a name="Known Bugs">Known Bugs and Limitations</a></font></b></p>
187              <ol>
188                <li>Skeleton supports only one skin cluster per mesh<ul>
189                  <li>All vertices in mesh must be connected to skin cluster</li>
190                </ul>
191                </li>
192                <li>MEL scripts call command-line tool instead of a native Maya
193                plug-in</li>
194                <li>MEL scripts do not work on Linux or Irix<ul>
195                  <li>Small additions required -- anyone willing to help?</li>
196                </ul>
197                </li>
198                <li>Exporter assigns the default material (lambert1) if the
199                initialShadingGroup is connected to a Maya Mesh directly or
200                indirectly.<ul>
201                  <li>Workaround is to remove all extra connections to the
202                                  initialShadingGroup using Hypershade</li>
203                                  <li>When creating Maya models as you are skinning the mesh to the joints you have the
204                                  option of smooth binding or rigid binding. We have found that with rigid binding you don't
205                                  get any bone assignments, but when the using smooth binding the exporter works perfectly fine.
206                </ul>
207                </li>
208              </ol>
209                <p><a href="#Contents">Back to Top</a><hr noshade color="#FFFF00">
210              <p align="left" class="TopZ">
211              <b><font face="Arial" size="2"><a name="Features">Features</a></font></b></p>
212              <blockquote>
213              <p align="left" class="TopZ">
214              <b><font face="Arial" size="2">Mesh Export</font></b></p>
215                <ul>
216                  <li>Exports everything related to a mesh<ul>
217                  <li>Vertices</li>
218                  <li>Normals</li>
219                  <li>Vertex colours</li>
220                  <li>Texture coordinates (all sets)</li>
221                  <li>Bone assignments and weights</li>
222                  <li>Include/exclude any of the above</li>
223                </ul>
224                  </li>
225                  <li>Vertex optimization removes duplicate vertices before
226                  exporting<ul>
227                  <li>Based on position, normal, colour,
228                  uvs</li>
229                </ul>
230                  </li>
231                  <li>Defaults to XML<ul>
232                  <li>Convert to binary with OgreXMLConverter</li>
233                  <li>Maya UI can automatically launch binary conversion </li>
234                </ul>
235                  </li>
236                </ul>
237                <p><font face="Arial" size="2"><b>Material Export</b></font></p>
238                <ul>
239                  <li>Colours (ambient, diffuse, specular, emissive)</li>
240                  <li>Shininess for specular colours (requires calibration)</li>
241                  <li>Texture names</li>
242                </ul>
243                <p><b><font size="2" face="Arial">Skeleton/Animation Export</font></b></p>
244                <ul>
245                  <li>Vertex bone assignments and weights</li>
246                  <li>Multiple named animations<ul>
247                  <li>Animation name</li>
248                  <li>Start frame</li>
249                  <li>End frame</li>
250                  <li>Number of frames to skip</li>
251                </ul>
252                  </li>
253                  <li>Up to 8 named animations preserved in Maya UI </li>
254                  <li>Default to XML<ul>
255                  <li>Convert to binary with OgreXMLConverter</li>
256                  <li>Maya UI can automatically launch binary conversion</li>
257                </ul>
258                  </li>
259                </ul>
260              <p><a href="#Contents">Back to Top</a></p>
261              </blockquote>
262            </td>
263    </tr>
264    </table>
265</div>
266
267<!--webbot bot="Include" U-Include="../include/nav_ogre_bottom.htm" TAG="BODY" startspan -->
268              <div align="left">
269                <table border="0" cellpadding="5" cellspacing="0" style="border-collapse: collapse" bordercolor="#111111" width="100%" bgcolor="#006600">
270                  <tr>
271                    <td width="100%">
272                    <p align="right">
273                    <font size="1" face="Arial" color="#FECB62">Contents
274                    copyright </font><font size="1" color="#FECB62">©2003 Fifty1
275                    Software Inc. Granite is a registered trademark of Fifty1
276                    Software Inc.</font></td>
277                  </tr>
278                </table>
279              </div>
280
281<!--webbot bot="Include" i-checksum="3278" endspan --></body></html>
Note: See TracBrowser for help on using the repository browser.