README.md

Ogre3D mesh viewer/converter

A Ogre3D mesh viewer based on v2.1 which can import obj/gltf models.

Download Windows x64

Features

• Load Ogre v2, v1, xml meshes with HLMS materials.
• Import Wavefront Obj and save as Ogre Meshes
• Import glTF 2.0 models and save as Ogre Meshes
  • It's not perfect yet, some glTF models appear black or have flat materials
• Show scene hierarchy
• Basic HLMS editing
  • Texture: diffuse, background diffuse, normal, roughness, metalness
  • Transparent value and mode
  • Solid or wireframe
  • Two-sided on/off
• Scene node editing:
  • Position, rotation and scale
  • Show/hide bounding boxes
  • Switch visibility
• Batch conversion tool from obj => .mesh

How to compile

1. Have Qt 5 SDK installed (recommend Qt 5.6+), download it here.
2. Have a working Ogre3D 2.1 sdk.
3. Set the path to Ogre sdk folder. You can either set an user-level OGREHOME environment variable, or set it directly in ogre-v2-mesh-viewer.pro line 9.
4. Open ogre-v2-mesh-viewer.pro in QtCreator and presse RUN.

TODO

• HLMS material editing (WIP)
• Batch convertor from mesh to obj
• glTF export
• Support DotScene
• Improve performance by converting obj data to ogre mesh directly
• Automatically generate normals if there are no normal vectors in obj
• glTF import

Known issues

• Normals are broken when converting a v2-mesh to a obj
• Normal textures are not showing correctly on the material panel
• Normal weight doesn't update right after updating the Pbs blocks
• Metallic texture is not showing with DirectX11 rendersystem

Acknowledgements

• Ogre3D: https://www.ogre3d.org/
• Qt: https://www.qt.io/
• Magus Toolkit: https://github.com/spookyboo/Magus
• tinyobjloader: https://github.com/syoyo/tinyobjloader
• Ogre glTF: https://github.com/Ybalrid/Ogre_glTF
• tinygltf: https://github.com/syoyo/tinygltf
• PBR Pistol: http://artisaverb.info/PBT.html