Name      blender2ogre 
Version   0.5.8
License   GNU LGPL
Authors   Brett, S.Rombauts, F00bar, Waruck, Mind Calamity, 
          Mr.Magne, Jonne Nauha, vax456
Sponsors  Adminotech Ltd.

    - Blender 2.63
    - Linux, Windows, OSX

Note for upgrading
    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

    Using Windows .msi installer
        The addon script 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 archive or plain file
        Use Blenders interface, under user-preferences, click addons, 
        click "install-addon", and select
        Or you can simply copy to your 
        blender installation under blender/2.6x/scripts/addons/

        Installing Dependencies
            In order to create binary Ogre meshes, you need OgreXMLConverter.
            Try to use the latest Ogre tools, at the moment that would be 1.7
                1. Download the latest Ogre Command-line tools from
                2. Install to the default location.
                3. See "Setting Tool Paths" section if .mesh files
                   are not exported to configure the tools.

                Get the Ogre source code, compile and "make install" that
                should give you /usr/local/bin/OgreXMLConverter
                or use "apt-get install ogre-tools" if your distro has it.

            Mac OSX by Night Elf
                1. Download the latest pre-built SDK from
                   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
                     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 soruces 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.
        1. Install Image Magick from
           to the default location.

        2. OgreMeshy
                Get the latest Ogre Meshy from 
       and install to 
                the default location. See the "Setting Tool Paths" section.
                If your using 64bit Windows, you will need to download the 
                64bit OgreMeshy.
            Linux / Mac OSX
                Get Ogre Meshy for Windows, install wine, extract 
                OgreMeshy to /home/yourname/OgreMeshy

        3. NVIDIA Texture Tools 2.0 with CUDA acceleration
           Note: Nvidia DDS, if you can not install "NVIDIA 
           Texture Tools 2.0" above, you can still use Legacy 
           Utils below:

        4. realXtend Tundra
            Windows and Mac OSX
                Download and install the latest Tundra from
                1. Download
                2. Extract to your home directory ~/Tundra2
                Or build from sources

Enabling blender2ogre
    - 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 plugin 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.

Setting Tool Paths
    If for some reason you can not install the dependencies below to the 
    recommended paths, you can change the paths in Blender by going to 
    Properties -> Scene -> Ogre Configuration File and then click 
    "update config file" to store the new config. You may need to restart
    Blender for the changes to take effect.