MeshMagick is a manipulation tool for Ogre meshes (and skeletons) and is part of the OgreCommandLineTools. It allows the user to query interesting information and to transform binary meshes (and skeletons) in many ways. It can also be used as a library.

Remark: It's recommendable to add the path of the Ogre command-line tools into the path environment variable (on Windows systems). So you can use meshmagick in every directory.

Synopsis

meshmagick [global_options] toolname [tool_options] infile(s) [-- outfile(s)]

Included tools

Global options

Help to some tools

optimise

Allows you to optimise meshes and skeletons. This will merge equal vertices, remove unneeded animation tracks and do other sensible optimisation operations, that can result in smaller mesh file size and better performance.

Options:

rename

Rename different elements of meshes and skeletons.
All options can be used more than once to execute multiple renamings at once.
Instead of : any other non-space character part of neither new nor old name can be used as delimiter.

possible renamings:

transform

Scales, rotates or otherwise transforms a mesh.
All transform options are applied in their relative order.

possible transformations:

other options:

Examples

Get informations about a mesh file:
meshmagick info filename.mesh

Optimizing a mesh file:
(do this - it's just a little mount of time)
meshmagick optimise filename.mesh

Are you as annoyed as I was when I started with Ogre? Robot and Ninja don't look into the same direction. The Ninja looks toward -Z, the Robot toward +X. Not any more! With a single command you can change the direction the robot looks:
MeshMagick transform -rotate=90/0/1/0 robot.mesh
(Make sure the skeleton is in the same directory as the mesh.)

A merging example:
meshmagick meshmerge input1.mesh input2.mesh input3.mesh — output.mesh

A rename example:
This renames the bone Joint1 to Bone1 in the ninja.skeleton and writes it back to the same file.
meshmagick rename -bone=:Joint1:Bone1: ninja.skeleton

Use with a global option for info:
meshmagick -no-follow-skeleton info input.mesh

Using MeshMagick as a library

Many of MeshMagick's tools can be used as a library too. This eases integration in editors or other applications where this functionality is needed. So far InfoTool, MeshMergeTool and TransformTool can be used as a library.

In order to use MeshMagick as a library do the following:

• Get source from https://ogreaddons.svn.sourceforge.net/svnroot/ogreaddons/trunk/meshmagick
• Compile it
• Include header file MeshMagick.h and link to meshmagick.lib/meshmagick_d.lib/meshmagick.so depending on your platform.

Here is a small code sample:

#include <MeshMagick.h>
 
 using namespace meshmagick;
 
 // Call this only after Ogre has been properly initialised.
 void scaleMesh(MeshPtr mesh, Vector3 scale)
 {
     MeshMagick mm;
     TransformTool* transformTool = mm.getTransformTool();
     transformTool->transform(mesh, Matrix4::getScale(scale), false);
 }

Links

• Discussion and more information at the Forum topic.
• MeshMagick is included in the Ogre command-line tools
• Most recent source code in the ogreaddons repository