Overview

blender2ogre

Authors

This Blender addon was made possible by the following list of people. Anyone can contribute to the project by sending bug reports and feature requests here. Naturally the most welcome contribution is actual code via pull requests. If you are planning to implement something "big", it's a good practise to discuss it in the issue tracker first with other authors. So that there is no overlap with other developers or the overall roadmap.

Additionally the following companies have supportted/sponsored the development efforts.

Repository notes

This is a fork of the original version which is no longer actively maintained. This fork is to continue mainaining support for new Blender releases and to develop the code base further with bug fixes and new functionality.


Download

Updating to new versions

If you are upgrading from a previous version of blender2ogre, and having problems, you may want to delete your old .pickle config file from ~/.blender/2.6x/config/scripts/blender2ogre.pickle and restart blender.


Installing

Using Windows .msi installer

Note: The Windows MSI installer is not available for all releases!

The addon script io_export_ogreDotScene.py has automatically been copied to the correct place by the installer.

If the installer fails to detect a valid Blender installation for the automatic copying, it will show a dialog for the user and instructions how/where to copy it manually. The uninstall step also tries to automatically clean the script file from Blender.

Mandatory dependencies are installed to the blender2ogre install directory. The script should automatically try to find them from there and set them correctly to the addon config.

Using an .zip archive release (or raw io_export_ogreDotScene.py file)

If you are using a .zip arhive release. Extract it to disk, you will find io_export_ogreDotScene.py inside of it.

Use Blenders interface, under user-preferences, click addons, click install-addon, and select io_export_ogreDotScene.py.

Or you can simply copy io_export_ogreDotScene.py to your blender installation under blender/2.6x/scripts/addons/

3rd party tutorials

Enabling the blender2ogre addon

  • After installing the addon enable it in Blender from User Preferences > Add-Ons > Import-Export. Search for ogre and check the box on the right. Remember to save as default if you want the addon to be enabled after you exit your Blender.
  • Integrated help docs will be shown in the upper right hand toolbar, replacing blender's normal Help menu, read them for assistance.

Installing dependencies

This exporter writes Ogre mesh and skeleton files as XML [.mesh.xml, .skeleton.xml]. In order for the tool to create binary assets from them [.mesh, .skeleton], you need the OgreXMLConverter command line tool that is provided by the Ogre project.

Windows

  1. Download the latest Ogre Command-line tools
  2. Install to the default location.
  3. See Setting tool paths section to configure the tool, if binary assets [.mesh, .skeleton] are not succesfully generated when exporting.

Linux

  • Install the package ogre-1.8-tools or ogre-tools if your distro provides it. For example on Ubuntu apt-get install ogre-1.8-tools
  • Or get Ogre sources, run CMake, make && make install. This should build /usr/local/bin/OgreXMLConverter

Mac OSX

  1. Download the latest pre-built SDK or build ogre from sources. If you build from sources the needed tools will be in <Ogre Folder>/build/bin/Release
  2. Copy the OgreXMLConverter file to your /usr/bin folder. It's a hidden folder, so, to do that, open Terminal and enter the following commands cd /usr/bin and open . Finder will open on the /usr/bin folder.
  3. Drag the OgreMeshConverter file over to that folder
  4. Find Ogre.framework. If you build from sources it will be in <Ogre Folder>/build/lib/Release. The Ogre.framework shows as a "folder". Copy Ogre.framework to your /Library/Frameworks folder.

Optional dependencies

See Setting tool paths section on how to configure the optional tools if default paths fail to find them.

Image Magick

OgreMeshy

  • Windows Get the latest Ogre Meshy and install to the default location. See the "Setting tool paths" section. Prefer using the 64-bit OgreMeshy for 64-bit Windows.
  • Linux / Mac OSX Get Ogre Meshy for Windows, install wine, extract OgreMeshy to /home/yourname/OgreMeshy

NVIDIA Texture Tools 2.0 with CUDA acceleration

realXtend Tundra

Tundra is a 3D virtual world platform that uses Ogre3D for rendering. This plugin can export the Tundra scene format .txml directly along with the Ogre binary assets. Those scenes can be easily loaded and viewer by Tundra. Tundra also supports drag and drop imports for the Ogre scene file .scene.

Setting tool paths

You can change the required and optional tool paths in Blender when you see the need for it. This usually needs to be done if you failed to install the tools to the default paths, or they cannot be found from the default paths.

  • In Blender go to Properties > Scene > Ogre Configuration File
  • Edit the required tool paths
  • Click update config file to store the new config. You may need to restart Blender for the changes to take effect.