History: UOgreBrowser

            !Overview
uOgreBrowser is a project about embedding uBrowser in an Ogre application.

It can render uBrowser to Ogre ((overlay))s and ((material))s, and to be advanced enough to use for a ((-GUI)) and manipulate Ogre objects in a 3d world.

!Links
* [http://www.ogre3d.org/phpBB2/viewtopic.php?t=25936|uBrowser and Ogre] - The forum thread that started the project. You can discuss this project further there.
* [http://ubrowser.com|LLMozLib & uBrowser] - The official uBrowser webpage.
* [http://ryandeboer.byethost9.com/|uBrowser releases] - Website containing downloads of releases. These are versions snapshots of source, binaries and dependencies. Downloads of user contributions are also available.

!Development News
* The testGL project rendering into an Ogre window using raw ((-OpenGL)) calls.
* Input hooked up by using win32 dependent CreateWindow/MessagePump/WinProc calls.
* Rendering in the background ((render queue)), and a ''robot.mesh'' rendering in front of it.
* Framerate improved (160fps).
* -OpenGL calls no longer used, Ogre ((Creating dynamic textures|dynamic texture)) used instead.
* uOgreBrowserMaterial works on ((Overlays|Overlay)) and ((Displaying 2D Backgrounds|2D Backgrounds)).
* Framerate improved (800fps). It does drop when you iteract a lot (eg down to 40fps).
* Hooked up href events, button events, listbox events, textbox events which change the color of the robot and the text in a text overlay.
* Now works with DX9.
* Removed glut and -OpenGL code.
* Fixed the texture filtering problems in DX9.
* Current code released 0.1, awaiting CVS.
* CVS active, 0.11 released.
* User contribution: BrowserPlaneDemo from Farch.

!Source Code
!!Getting The Latest Source
!!!Command Line
Type the following
{MONO()}~np~svn co https://svn.ogre3d.org/svnroot/ogre/trunk ogre~/np~{MONO}

!!!TortoiseSVN
* Right click in a folder.
* Choose "SVN Checkout..."
* Fill in these settings:
{MONO()}Address: ~np~https://svn.ogre3d.org/svnroot/ogre/trunk ogre~/np~{MONO}

!!!Source Code Snapshot
* [http://github.com/twinsen/uOgreBrowser/raw/f8b7676c30d355c6a0e0d8e8d1e640c63a092a4f/uOgreBrowserSrc0.11.zip|uOgreBrowserSrc0.11.zip]

!!Compiling
* Unzip [http://github.com/twinsen/uOgreBrowser/raw/8edcdc35ff9957eaa1e4b9085e3dc6c86967260c/uOgreBrowserDependencies0.11.zip|uOgreBrowserDependencies0.11.zip] to uOgreBrowser directory.
* Compile uOgreBrowser.sln in Visual Studio 2003.
* Run debug\uOgreBrowser.exe

!Contributors
Any changes you make to the source code must be submitted back to the community under the LGPL.

!!!User
* "Users have no special permissions, but are encouraged to submit patches through the patch system where they find bugs or where they would like to enhance something." Patches are reviewed by the uOgreBrowser developers before being applied. 
* Follow the "Submitting a Patch" section in [http://ogre3d.org/index.php?option=com_content&task=blogcategory&id=74&Itemid=87|Developers - OGRE 3D], except send the patch to an uOgreBrowser developer.
* This involves "diff" files for existing files, and zip or rar files for new files.
* If you made radical changes or created a completely separate example, just zip or rar all your development work up and send it in. The important thing is to share your work.
* To quickly send the zip/rar files to others, you can use services such as:
{MONO()} http://www.sharelor.com
 http://www.quicksharing.com
 http://www.filesend.net{MONO}
* Post a description of your work on this thread - [http://www.ogre3d.org/phpBB2/viewtopic.php?t=25936|uBrowser and Ogre], so everyone watching the thread gets notified.

!!!Current uOgreBrowser user contributors
* Farch

!!!uOgreBrowser developer
For commit access you will need to:
* Get a [http://sourceforge.net/|sourceforge account].
* Contact a uOgreBrowser developer and organize access.
* You need SSH to connect to CVS.
** Follow instructions on [http://vitooki.sourceforge.net/docs/cvs-devs.php|CVS guide for developers]
** If you use TortoiseCVS see [http://sourceforge.net/docs/F04/en/|Configuring TortoiseCVS for Developer SSH Authentication].

!!!Current uOgreBrowser developers
* ryandeboer

!Images
{img src="img/wiki_up/UOgreBrowser.png" alt="frame|
uOgreBrowser initial work - experiment at geting UBrowser rendering in an Ogre window. The browser is rendered in the background render queue with the robot.mesh on top. All key/mouse input works as expected." align="left"}

{img src="img/wiki_up/UOgreBrowserBlue.png" alt="frame|
Example showing href events, button events, listbox events, textbox events which change the color of the robot and the text in a text overlay.
" align="left"}

{img src="img/wiki_up/BrowserPlane_800.png" alt="frame|
BrowserPlaneDemo user contribution to the uOgreBrowser project. Example shows browsing planes that spin.
" align="left"}

!Other Gui Projects
* [http://princeofcode.com/awesomium.php|Awesomium] - Uses Chrome as a backend, LGPL. See also: [http://www.ogre3d.org/forums/viewtopic.php?f=11&t=47887|forum thread], [http://princeofcode.com/blog/?p=74|source code].
* [http://www.ogre3d.org/forums/viewtopic.php?p=247493&sid=ce193664e1d3d7c4af509e6f4e2718c6|TwOgre - An AntTweakBar Integration] - Tweaking variables was never so easy (one liners), great when you don't need a embedded web browser. [http://www.antisphere.com/Wiki/tools:anttweakbar|AntTweakBar] is great for DirectX/OpenGL projects that don't use Ogre too.
* [http://www.ogre3d.org/phpBB2/viewtopic.php?t=32384|Navi] - Uses the LLMozLib library to render HTML based GUIs. "Awesomium shall be its new 'back-end' in an upcoming release."
* [http://www.ogre3d.org/phpBB2/viewtopic.php?t=25853|BetaGUI 2] - betajaen's overlay-based -GUI system now has a new theme system using CSS styles
* [http://www.ogre3d.org/phpBB2/viewtopic.php?t=30547&postdays=0&postorder=asc&start=0|QuickGUI] - Is another overlay-based -GUI system that concentrates on simplicity.