ObjViewer_Android

ObjViewer_Android copied to clipboard

ObjViewer is a sample Android application illustrating various aspects of using OpenGL-ES 3D graphics:

• GeomBuilder: basic management of 3D object geometry and rendering
• ObjReader: simple reading of common .obj-format model files and associated .mtl material-definition files
• Rotation: generation of 3D rotation transformations using unit quaternions
• ObjectView: basic on-screen display of a 3D model with simple lighting, allowing interactive rotation to any orientation, and also demonstrating animated rotations

Copy the .obj file that you want to view (and associated .mtl file, if any) onto a directory named “Models” on the SD card of the Android device. It should then appear in the list that is shown when you select “Open...” from the options menu in ObjViewer.

You can interactively adjust the orientation of the object by dragging across the view; drag across the middle part to rotate about the X (horizontal) and Y (vertical) axes, and drag around the periphery to rotate about the Z axis (perpendicular to the view) as well.

To see any colours that might be defined for the surfaces of your model, turn on lighting.

If parts of the surface of the object seem to disappear, try switching the order of vertices in a forward-looking face under “Orient Faces...”.

“Reset View” animates rotating the object back to its initial orientation. “Random View” animates rotating the object to a random orientation.

If you want to find downloadable models to view, here are a couple of lists of likely websites: http://en.wikibooks.org/wiki/Blender_3D:_Noob_to_Pro/Sources_of_free_3D_models http://wiki.blender.org/index.php/Doc:Tutorials/Resources/Models.

If you want to create your own models, Blender http://www.blender.org/ is an amazing package, well worth at least getting a basic understanding of how to create simple models and scenes with it. But don’t try to learn it on your own; you’ll find plenty of tutorials to get you started--just follow the links from the Blender site.

Contents: src/ -- Java sources for the Android app res/ -- resources for the Android app AndroidManifest.xml, build.xml, *.properties -- for driving Google's Android build tools (note that you will have to provide a couple more of these--see INSTALL for details) README -- this file INSTALL -- build/installation instructions LICENSE -- licence (Apache 2.0, same as Google’s sample code)

Like the icon? It's by Tehkseven--more here http://www.tehkseven.net/news/12-stunning-icon-packs-for-android-phones.

Lawrence D'Oliveiro [email protected]