source: OGRE/trunk/ogrenew/Docs/manual/manual_33.html @ 657

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

added ogre dependencies and patched ogre sources

RevLine 
[657]1<HTML>
2<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
3<!-- Created on , 12 2006 by texi2html 1.64 -->
4<!--
5Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
6            Karl Berry  <karl@freefriends.org>
7            Olaf Bachmann <obachman@mathematik.uni-kl.de>
8            and many others.
9Maintained by: Olaf Bachmann <obachman@mathematik.uni-kl.de>
10Send bugs and suggestions to <texi2html@mathematik.uni-kl.de>
11 
12-->
13<HEAD>
14<TITLE>OGRE Manual v1.0.7: Exporters</TITLE>
15
16<META NAME="description" CONTENT="OGRE Manual v1.0.7: Exporters">
17<META NAME="keywords" CONTENT="OGRE Manual v1.0.7: Exporters">
18<META NAME="resource-type" CONTENT="document">
19<META NAME="distribution" CONTENT="global">
20<META NAME="Generator" CONTENT="texi2html 1.64">
21<LINK TYPE="text/css" rel="stylesheet" href="../style.css"> 
22</HEAD>
23
24<BODY LANG="" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
25
26<A NAME="SEC165"></A>
27<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
28<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="manual_32.html#SEC164"> &lt; </A>]</TD>
29<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="manual_32.html#SEC164"> Up </A>]</TD>
30<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="manual_34.html#SEC170"> &gt; </A>]</TD>
31<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="index.html#SEC_Top">Top</A>]</TD>
32<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="manual_toc.html#SEC_Contents">Contents</A>]</TD>
33<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
34<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="manual_abt.html#SEC_About"> ? </A>]</TD>
35</TR></TABLE>
36<HR SIZE=1>
37<H2> 4.1 Exporters </H2>
38<!--docid::SEC165::-->
39<P>
40
41Exporters are plugins to 3D modelling tools which write meshes and skeletal animation to file formats which OGRE can use for realtime rendering. The files the exporters write end in .mesh and .skeleton respectively.<BR><BR>
42</P><P>
43
44Each exporter has to be written specifically for the modeller in question, although they all use a common set of facilities provided by the classes MeshSerializer and SkeletonSerializer. They also normally require you to own the modelling tool.<BR><BR>
45</P><P>
46
47All the exporters here can be built from the source code, or you can download precompiled versions from the OGRE web site.<BR><BR>
48</P><P>
49
50<A NAME="SEC166"></A>
51<H2> A Note About Modelling / Animation For OGRE </H2>
52<!--docid::SEC166::-->
53There are a few rules when creating an animated model for OGRE:
54<UL>
55<LI>You must have no more than 4 weighted bone assignments per vertex. If you have more, OGRE will eliminate the lowest weighted assignments and renormalise the other weights. This limit is imposed by hardware blending limitations.
56<LI>All vertices must be assigned to at least one bone - assign static vertices to the root bone.
57<LI>At the very least each bone must have a keyframe at the beginning and end of the animation.
58</UL>
59If you're creating unanimated meshes, then you do not need to be concerned with the above.
60<P>
61
62<A NAME="SEC167"></A>
63<H2> Milkshape3D </H2>
64<!--docid::SEC167::-->
65<P>
66
67Milkshape3D is a popular low-polygon editor, especially popular in the modding community because of it's low price and the fact that it supports many game file formats. Installation instructions are included with the exporter itself. The Milkshape exporter supports exporting of meshes and animations. An important tip: Make sure you are not in 'animation' mode when you do this, otherwise Milkshape gets confused as to what the 'reference' position of the mesh is. Just make sure the 'Anim' button in the bottom-right is NOT depressed.<BR><BR>
68</P><P>
69
70You then get a dialog box with several options:
71<DL COMPACT>
72<DT>Export Mesh
73<DD>Obvious really - if checked this exports the geometry data (vertex positions, normals &#38; texture coordinates) to a .mesh file.
74<DT>Export Skeleton &#38; Animation
75<DD>If checked, the bones of the model and animation data is exported to a .skeleton file.
76<DT>Split Keyframe Sequence Into Multiple Animations
77<DD>You can check this to split the single timeline in Milkshape into multiple separate animations (this option has no effect if you are not exporting the skeleton). This is necessary because Milkshape doesn't have a concept of multiple separate animations, you just have to model them all in a single timeline and then use this feature to split them up. If you check this box you must supply a text file which tells OGRE how to split the animation up. This text file is very simple: each line is a single animation, and must contain comma-separated values indicating the start frame, end frame and name of the animation, e.g.:
78<TABLE><tr><td>&nbsp;</td><td class=example><pre>    1,30,Walk
79    31,45,Run
80    46,75,Die
81    ...etc
82</pre></td></tr></table><DT>Frame Rate
83<DD>The Milkshape timeline is in frames, but OGRE likes to deal with animations in terms of seconds for simplicity. This value allows the exporter to do the conversion. Note there's nothing to stop you animating the mesh at a different frame rate in OGRE at runtime by scaling the amount you change the animation by each time, but this bakes a 'default animation speed' into the animation for simplicity.
84</DL>
85<P>
86
87<A NAME="SEC168"></A>
88<H2> 3D Studio Max R4/5 </H2>
89<!--docid::SEC168::-->
90The 3D Studio exporter exports both mesh definitions and animations created with Biped and Physique. It requires no compilation because it is written in MaxScript, and exports data to XML before converting it using <A HREF="manual_34.html#SEC170">4.2 XmlConverter</A>. There are tutorials included with the exporter in it's Docs/ folder.
91<P>
92
93<A NAME="SEC169"></A>
94<H2> Other exporters </H2>
95<!--docid::SEC169::-->
96These other exporters are provided with OGRE, but are either still under development or are supported externally:
97<UL>
98<LI>Wings3D
99<LI>Blender
100<LI>Maya
101<LI>Lightwave
102</UL>
103<P>
104
105<A NAME="XmlConverter"></A>
106<HR SIZE=1>
107<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
108<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="manual_32.html#SEC164"> &lt; </A>]</TD>
109<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="manual_32.html#SEC164"> Up </A>]</TD>
110<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="manual_34.html#SEC170"> &gt; </A>]</TD>
111<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="index.html#SEC_Top">Top</A>]</TD>
112<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="manual_toc.html#SEC_Contents">Contents</A>]</TD>
113<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
114<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="manual_abt.html#SEC_About"> ? </A>]</TD>
115</TR></TABLE>
116<BR> 
117<FONT SIZE="-1">
118This document was generated
119by <I>Steve Streeting</I> on <I>, 12 2006</I>
120using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html
121"><I>texi2html</I></A>
122
123</BODY>
124</HTML>
Note: See TracBrowser for help on using the repository browser.