Extensions:2.4/Py/Scripts/Export/M3G
< Extensions:2.4 | Py | Scripts | Export
m3g_export
About
| UI location | Group: Export | ||
|---|---|---|---|
| Version | 0.8 | Author(s) | Gerhard Völkl |
| Blender | 2.37 - 2.46 | License | GPL |
| Note(s) | Included in Blender 2.46. | ||
| File name | export_m3g.py |
|---|
| Links | http://www.nelson-games.de/bl2m3g/ |
|---|
Support
- Python & Plugins forum at Blender Artists.
Usage
Instructions
To use script:
1.) load this file in the text window.
(press SHIFT+F11, Open New via Datablock button)
2.) make sure your mouse is over the text edit window and
run this script. (press ALT+P)
Or:
copy to the scripts directory and it will appear in the
export list. (Needs 2.32 or higher)
To-Do list
- Export only selected mesh
- Optimize Bones < - > Vertex Group mapping
- Compressed File
- MTex - Support
- By Rotating use SQUAD instead of Beziere. It's smoother
History
History 0.2
* maximal Precision in VertexArray (with algorithms from Kalle Raita)
* IPO Animation with mesh: Rotation, Translation and Size
History 0.3
* to find a 3d object in your java programm you can assign a userID
your blender object has name 'cube#01' your 3d object will have ID 01
the number after '#' is taken
* more than one material per mesh can be used
* uv texture support (implemented by Aki Koskinen and Juha Laitinen)
The image which is bound to the faces will be exportet within m3g-file
Limitations by M3G-API:
The width and height of the image must be non-negative powers of two,
but they need not to be equal. Maximum value is 256.
*.java export: Only PNG images can be used.
History 0.4
* check limitation of texture images (credit to MASTER_ZION for Brasil)
* Better light: The light modeles of Blender and M3G are naturally
different. So the export script trys to translate as much as possible
M3G Light type Blender Light type
--------------------------------------------------------------
AMIENT Light Not available as light type in Blender
DIRECTIONAL Light SUN
OMNIdirectional light LAMP
SPOT light SPOT
not translated HEMI
not translated AREA
Attributs of M3G Lights:
Attenuation (OMNI,SPOT):
Intensity of light changes with distance
The attenuation factor is 1 / (c + l d + q d2)
where d is the distance between the light and the vertex being lighted
and c, l, q are the constant, linear, and quadratic coefficients.
In Blender exists much complex posibilies. To simplify exporter uses
only button Dist: distance at which the light intensity is half
the Energy
Color (ALL)
Color of light
Intensity (ALL)
The RGB color of this Light is multiplied component-wise with the
intensity. In Blender : energy
SpotAngle (SPOT)
the spot cone angle for this Light
In Blender: spotSize
SpotExponent (SPOT)
The spot exponent controls the distribution of the intensity of
this Light within the spot cone, such that larger values yield
a more concentrated cone. In Blender: SpotBl
* Some GUI for options
First prototype of GUI was created using RipSting's Blender-Python
GUI designer. Download at Http://oregonstate.edu/~dennisa/Blender/BPG/
* Ambiente light
Information is taken by world ambiente attribute
* Parenting Part 1
In Blender the Empty object is used to group objects. All objects
which have the same empty as parent are the member of the same group.
empty <-- Parent of -- element 1
<-- Parent of -- element 2
is translated in M3G
group-Node -- Member --> element 1
-- Member --> element 2
In Blender every object can be the parent of every other object
In M3G that is not possible. Only a group object can be parent.
(Or the world object which is derived from group).
That will come later as Parenting Part 2
* Backface Culling
you can use backface culling, if option "use backface culloing" is on.
Culling will be set in PolygonMode object of every mesh. The correct
winding is controlled.
History 0.5
* Bone Animation - Armature (Part 1)
Armature is the skeleton for skinned meshes. It stores the bones in
rest position (more information http://www.blender.org/cms/How_Armatures_work.634.0.html)
You can work in Blender with bones and meshes in different ways. In
this first attempt only the use of vertex groups is assisted.
Blender-Objekts translated into M3G-Objects
MESH SkinnedMesh
| |
v v
ARMATURE Group
| |
v v
BONE_1 Group
Group_second
| |
V v
BONE_2 Group
Group_secound
Every bone is translated into two groups at the moment, because
the second bone is needed to do the animation in an easy way.
The animations in Blender for meshes are stored in action objects.
Blender Objects translated into M3G-Objects
ARMATURE
| activ
v
ACTION ANIMATIONCONTROLLER
| 1..n ^
v ANIMATIONTRACK --> Group_second
IPOs |
v
KEYSEQUENZE
One action is translated into one animationcontroller. One IPO is
translated in one KEYSEQUENZE and one ANIMATIONTRACK.
At the moment only the active action of the armature object is translated.
* Print Info, if type of light is used that is not supported
History 0.5
* New Option exportAllAction (default value: false)
If that option is true, all actions will be exported - not only the active
action.
At the moment you can only assign one action to one armature.
To know which action is used with which armature the action
needs a special name :
<Action Name>A<M3G ID of Armature>E<End Frame><ID of Action>
Example: Name of action : walkA10E25002
Name of armature : man10
End Frame: 250
History 0.6
Include the same image only one time into the m3g-file
* Until now all vertices of the faces was been written.
Now the vertices will be used again if possible:
normal and texture coordinates of to vertices have to be the same
* Smooth/solid shading can now be defined for every single material:
in Editing panel (F9)>Link and Materials
* This script uses now correctly the TexFace and Shadless Buttons in
Shading panel (F5)>Material buttons>Material box.
TexFace switches on/off the Export of texture coordinates.
Shadeless does the some with the normal coordinates
* The GUI was redesigned in a PupBlock
* Options:
** Texturing Enabled: Switches on/off export of textures and texture
coordinates. Attention: the TextFace button switches only
for one mesh
** Texturing External: the textures will be included it mg3-file or
exported in seperate file
** Lighting Enabled: turns on/off export of lights and normal completly
Attention: Shadeless only for one mesh
** Persp. Correction: turns on/off perspective correction in PolygonMode.
** Smooth Shading: turns on/off smooth shading in PolygonMode.
* Textures in external references are used again (with ImageFactory)
* Blender function: Double Sided button in Editing Context
(F9)>Mesh panel)
turn on/off PolygonMode.CULL_BACK anzuschalten.
* Script ingnores meshes that have no faces
History 0.7
* Exporter can work with texture coordinates greater 1 and smaller 0
* Adler32 did not work always correct. New implementation made.
* Modul shutil is not needed any longer. Exporter has its own copy_file.
(realized and inspired by ideasman_42 and Martin Neumann)
History 0.8
* Blender works with SpotAngles 1..180 but M3G works only with 0..90
M3G use the 'half angle' (cut off angle) (Thanks to Martin Storsjö)
* Error fixed: Texture coordinates was not calculated correct.
(Thanks to Milan Piskla, Vlad, Max Gilead, Regis Cosnier ...)
* New options in GUI:
M3G Version 2.0 : Will export M3G files Vers. 2.0 in future
Game Physics: Adds Game Physics infos for NOPE API
