root/trunk/llmozlib2/README-test_apps.txt

Revision 11, 2.9 kB (checked in by callum.linden, 2 years ago)

Update of this branch with files from internal Linden version.
Addition of README for Windows developers
Internal Linden version is now deprecated and this branch becomes the canonical version.

Line 
1 LLMozLib2 Test applications
2 ===========================
3
4 There are a some simple test applications, built against LLMozLib2 that serve as test mules, examples of how it can be used and what it is/isn't capable of.
5
6 They are (or will be eventually) available for all 3 of our supported platforms.
7
8 testGL
9 ======
10     * Very simple OpenGL application that displays a single Web page (URL is hard coded into the app) on a single orthographic quad.
11
12     * Can be found in tests/testgl directory or viewed at https://svn.secondlife.com/svn/llmozlib/trunk/llmozlib2/tests/testgl/
13
14     * Uses GLUT (http://www.opengl.org/resources/libraries/glut/) for window/input/OpenGL support
15
16     * Mouse/keyboard interaction work as expected
17
18     * Resizes as the application window resizes
19
20     * ESC key exits
21
22
23 uBrowser
24 ========
25     * OpenGL application that display multiple Web pages
26
27     * Can be found in tests/ubrowser directory or viewed at https://svn.secondlife.com/svn/llmozlib/trunk/llmozlib2/tests/ubrowser/
28
29     * Uses GLUT (http://www.opengl.org/resources/libraries/glut/) for window/input/OpenGL support and GLUI (http://glui.sourceforge.net/) for user interface support.
30
31     * You can enter a new URL manually by typing into the URL edit field and pressing ENTER (this version of GLUI doesn't support cut/paste unfortunately)
32
33     * Mouse/keyboard interaction work as expected
34
35     * Due to a limitation of GLUI (or a limitation of my understanding) you can't return focus automatically to the UI when you click in the URL edit widget. This means you have to click on the "Focus" button first to enter a new URL.
36
37     * The '<<<' (back), 'HOME' and '>>>' (forward) buttons work as you might expect
38
39     * There is a long list of bookmarks built in that illustrate the sorts of sites and technologies that are supported (AJAX, SHTML, XUL, SVG etc.)
40
41     * You can select the type of geometry that is used to display the page.
42           * Cube - writes a different page to each side of the cube
43           * Flat - is a single quadrilateral - just like having a regular browser (sort of)
44           * Ball - My favorite - Google Maps on it looks especially good!
45           * Flag - More to demonstrate that it can be done that anything useful.
46
47     * You can rotate the geometry to a pre-defined position using the controls at the side.
48
49     * You can change the position, orientation and scale of the geometry by clicking on the 'Rotate', 'Translate' and 'Scale' controls. Hold the mouse down over them and drag.
50
51     * You can change the resolution of the embedded browser window by pressing the 'small', 'medium' and 'large' buttons. Since, in this application, the browser window is always stretched to fill the geometry, the smaller the browser window, the larger it renders - (if that makes any sense)
52
53     * You'll see status and progress messages at the bottom - just like a real browser!
54
Note: See TracBrowser for help on using the browser.