Table of contents
With the Mogre MyGUI wrapper it's possible to use the MyGUI system by Mogre.
More information you find at the MyGUI website mygui.info.
Ogre related information you find in the MyGUI forum (section of the Ogre forum).
Related to the Mogre wrapper there is a special forum topic: Managed MyGUI
For Mogre related questions you can open a thread in the Mogre forum. Additionally you could invite user mstoyke to answer. (Please don't discuss by message - do it in public so that it helps other people, too.)
Videos
Download
The source code you can get in the download area of the MyGUI website.
The Mogre/.NET wrapper is part of the MyGUI project and can be found in the MyGUI repository.
Additionally look to the binary download section. It contains the Mogre wrapper, dependencies, demos and the layout editor.
I also packed a workable MyGUI wrapper for MOGRE 1.7.1, here is the download link: MediaFire download or you can extract the full MOGRE libraries (including Physx, MyGUI) from my Billardgames: Github Repository
Usage
I am using MyGui in my mogre app successfully. It wasn't hard, anything you need is here and here(all for Mogre 1.6.5.)
The second one is optional, but there is one file you need: export.vs . This codefile contains some functions to init and destroy MyGui. I never tried to use the MOGREframework in that package, I used the one in the Wiki. Some classes aren't wrapped, but all basic things seams to work fine.
(Quoted from this forum post in January 2010)
First of all, we need to create a class called "Export" which will import some necessary functions from "MyGUI.OgrePlatform.Export.dll"
public class Export { #region Export [DllImport("MyGUI.OgrePlatform.Export.dll", CallingConvention = CallingConvention.Cdecl)] private static extern void Export_CreateGUI(); [DllImport("MyGUI.OgrePlatform.Export.dll", CallingConvention = CallingConvention.Cdecl)] private static extern void Export_DestroyGUI(); [DllImport("MyGUI.OgrePlatform.Export.dll", CallingConvention = CallingConvention.Cdecl)] private static extern void Export_SetRenderWindow([MarshalAs(UnmanagedType.LPStr)] string _name); [DllImport("MyGUI.OgrePlatform.Export.dll", CallingConvention = CallingConvention.Cdecl)] private static extern void Export_SetSceneManager([MarshalAs(UnmanagedType.LPStr)] string _name); [DllImport("MyGUI.OgrePlatform.Export.dll", CallingConvention = CallingConvention.Cdecl)] private static extern void Export_SetActiveViewport(int _index); #endregion public static void CreateGUI() { Export_CreateGUI(); } public static void DestroyGUI() { Export_DestroyGUI(); } public static void SetRenderWindow(RenderWindow _renderWindow) { Export_SetRenderWindow(_renderWindow.Name); } public static void SetSceneManager(SceneManager _sceneManager) { Export_SetSceneManager(_sceneManager.Name); } public static void SetActiveViewport(int _index) { Export_SetActiveViewport(_index); } }
and then, in your ui creation code part, we need to create the GUI firstlty:
Export.CreateGUI(); Export.SetRenderWindow(YourRenderWindowObject); Export.SetSceneManager(YourSceneManager); Export.SetActiveViewport(Viewport ID, set 0 to be a first viewport);
After creating the GUI, you can create any widgets as you want
When you want to destroy the GUI, make sure you use the following code:
Export.DestroyGUI();
Wrapper details
The MyGUI repository has the directory Wrappers. This contains several subdirectories. For some we know the meaning:
- MyGUI.Export (C++): . . . . Exports all needed functions of the native MyGui
- MyGUI.Sharp: . . . . A C# Wrapper of MyGui (needs file MyGui.export)
- The depencies are MyGUIEngine.dll and MyGui.export.dll (and .NET)
- For Mogre is only an indirect depency: You need Mogre for creating MyGui.export.dll
- MyGUI.OgrePlatform.Export(C++): . . . . Exports all needed functions of the native MyGui
- MyGUI.Managed: . . . . A CLI/C++ Wrapper (needs MyGUI.OgrePlatform.Export)
Note:
MyGui.managed and MyGui.sharp seems to be equal. Maybe the C# one is a port of the managed one and not a build from scratch.
The original post from Altren:
Hello from MyGUI project! We have implemented generator wrappers for the library. Generator parsed data from doxygen, and with the help of templates, performs the generation of wrappers. At the moment there are templates for C# and Managed C++. It is also possible to setup generator for other languages if the need arises.
1. C# - MyGUI.Export.dll (exported functions) + MyGUI.Sharp.dll (wrapper using P/Invoke)
2. Managed C++ - MyGUI.Managed.dll (wrapper using CLR)
...
Compilation
1. Download MyGUI and compile it with same Ogre version and with same visual studio as Mogre was built with (also MYGUI_BUILD_WRAPPER option in CMake should be enabled). See also http://www.ogre3d.org/tikiwiki/MyGUI+Compiling
2. Compile MyGUI.OgrePlatform.Export(_d).dll
3. Generate Managed wrapper (to do this run WrapperGenerator that comes with MyGUI -> (in app select one by one)Generate Solution, Doxygen, Managed).
4. Compile MyGUI.Managed.dll in newly generated solution.
5. In Mogre add MyGUI.Managed.dll as referecnce
6. Use MyGUI initialisation from MyGUI.OgrePlatform.Export(_d).dll
Whole post: http://www.ogre3d.org/addonforums/viewtopic.php?f=17&t=9529
Note: It seems that with .Net 4 the wrapper does not work anymore. The OgrePlattform.Export.dll ist not found (although its in the same directory). An workaround would be to merge it with the main wrapper project and so totally avoid all P/Invoke calls.
See also
MyGUI related:
- mygui.info - official Website
- API reference - documentation of MyGUI interface
- MyGUI forum section - (in Ogre add-ons forum)
- Managed MyGUI - Forum topic for the Mogre wrapper
- Repository - SVN with source code
- Mogre wrapper (part of the same repository)
- Managed MyGUI for Mogre (pre-compiled binary)
- Demos (pre-compiled)
- Dependencies
- Layout editor
- MyGUI - much Ogre related stuff
- MyGUI 3.0 for MogreSDK 1.6.5
- binary (9 MB)
- source code (27 KB)
Common:
- GUI - an overview of GUI systems
- Comparison of GUIs
- Miyagi - an alternative GUI system for Mogre
- Hikari Wrapper for MOGRE - embed Adobe Flash into Mogre (e.g. GUI menus)
- Easy Debug Text for MOGRE - for plain text display
- Prototype steps of GUI development
- MQuickGUI - an outdated C# port of QuickGUI