Giter VIP home page Giter VIP logo

android-3d-model-viewer's Introduction

Android 3D Model Viewer

codeship badge

This is a demo of OpenGL ES 2.0. It is basically an android application with a 3D engine that can load Wavefront OBJ, STL & DAE files. The purpose of this application is to learn and share how to draw using OpenGL language.

News (22/12/2017)

  • Implemented collision detection algorithm: ray-aabb + ray-triangle + octree
  • Support for collada files with skeletal animations :)
  • Fixed #28: Load texture feature is now available

Android Market

About

Load 3D models and see how to do it with this open source code application.

The main purpose of this app is to show how to draw in android using the OpenGL 2.0 by sharing the source code. So please, don't expect this application to be much richer or nicer than the ones already published in the app store, but at least it's opened to anyone who wants to contribute or don't want to start a similar project from scratch.

As this is my first android app and Im still learning the OpenGL 2.0 language, it is highly probable that there are bugs; but I will try to continue improving the app and adding more features. So please send me your comments, suggestions or complains by opening an issue or email me to [email protected].

The app comes with some included 3D models that were taken for free from Internet (http://www.turbosquid.com).

Whats next

  • Stabilize app performance
  • Code refactoring
  • Carboard support?
  • Chromecast support?
  • ...

Features

  • OpenGL ES 2.0 API
  • Formats: OBJ (wavefront), STL (STereoLithography) & DAE (Collada-BETA)
  • calculation of normals
  • transformations: scaling, rotation, translation
  • colors
  • textures
  • lighting
  • wireframe & points mode
  • bounding box drawing
  • object selection
  • camera support!
    • tap to select object
    • drag to move camera
    • rotate with 2 fingers to rotate camera
    • pinch & spread to zoom in/out the camera
  • skeletal animations
  • ray collision detection

Try it

    export ANDROID_HOME=/home/$USER/Android/Sdk
    ./gradlew assembleDebug
    adb install -r app/build/outputs/apk/app-debug.apk
    adb shell am start -n org.andresoviedo.dddmodel2/org.andresoviedo.app.model3D.MainActivity
  • Open the application. You should see a menu. From there you can load some demos or load your own model
  • Once the scenario is loaded, pinch and rotate to see the 3D scene from another perspective.

Screenshot

Screenshot1 Screenshot2 Screenshot3 Screenshot4 Screenshot5 Screenshot6 Screenshot7 cowboy.gif stormtrooper.gif

Final Notes

You are free to use this program while you keep this file and the authoring comments in the code. Any comments and suggestions are welcome.

Contact

http://www.andresoviedo.org

Donations

ChangeLog

(f) fixed, (i) improved, (n) new feature

  • 2.0.4 (22/12/2017)
    • (n) Implemented face collision detection algorithm: ray-triangle + octree
  • 2.0.3 (21/12/2017)
    • (i) Improved collision detection algorithm (ray-aabb) for selecting objects
    • (i) BoundingBox code cleanup
  • 2.0.2 (17/12/2017)
    • (f) Collada XML parser is now android's XmlPullParser
    • (f) Animation engine frame times improved
    • (n) Camera now moves smoothly
  • 2.0.1 (08/12/2017)
    • (f) Multiple Collada parser fixes
    • (f) Camera now can look inside objects
  • 2.0.0 (24/11/2017)
    • (n) Support for collada files with skeletal animations :)
  • 1.4.1 (21/11/2017)
    • (f) #29: Crash loading obj with only vertex info
  • 1.4.0 (19/11/2017)
    • (f) #28: Load texture available for any model having texture coordinates
  • 1.3.1 (23/04/2017)
    • (f) #18: Removed asReadOnlyBuffer() because it is causing IndexOutOfBounds on Android 7
  • 1.3.0 (17/04/2017)
    • (n) #17: Added support for STL files
    • (n) #17: Asynchronous building of model so the build rendering is previewed
    • (f) #17: Added Toasts to buttons to show current state
  • 1.2.10 (16/04/2017)
    • (f) #16: Immersive mode is now configurable in the ModelActivity Intent: b.putString("immersiveMode", "false");
    • (f) #16: Background color configurable in the ModelActivity Intent: b.putString("backgroundColor", "0 0 0 1");
    • (f) #16: Fixed vertex normals generation (vertices were missing)
    • (f) #16: Scaling is now implemented in the ModelView Matrix with Object3DData.setScale(float[])
    • (f) #16: Wireframe generation is now using the source data
    • (n) #16: Implemented Point Drawing, like wireframe mode but only the points are drawn
    • (f) #16: Removed trailing slash from parameter "assetDir"
    • (f) #16: Access to ByteBuffers made absolute so there are thread safe (future fixes need this)
  • 1.2.9 (11/04/2017)
    • (f) #15: Toggle rotating light
    • (f) #15: Wireframe with textures and colors
  • 1.2.8 (10/04/2017)
    • (f) Fixed #14: Camera movement improved. Only 1 rotation vector is used + space bounds set
  • 1.2.8 (04/04/2017)
    • (f) Fixed #13: parsing of vertices with multiple spaces
    • (i) Improved error handling on loading task
    • (i) Vertices are defaulted to (0,0,0) if parsing fails
  • 1.2.7 (03/04/2017)
    • (i) Removed commons-lang3 dependency
  • 1.2.6 (02/04/2017)
    • (f) Fixed #12. Drawing the wireframe using GL_LINES and the index buffer (drawElements)
  • 1.2.5 (01/04/2017)
    • (f) Fixed #10. Map faces to texture only when using the only loaded texture
    • (f) Fixed #11. Generation of missing vertex normals
  • 1.2.4 (30/03/2017)
    • (f) Fixed #5. Memory performance optimization
  • 1.2.3 (27/03/2017)
    • (f) Fixed #1. Cpu performance optimization
  • 1.2.2 (25/03/2017)
    • (f) Fixed #9. IOOBE loading face normals when faces had no texture or normals
  • 1.2.1 (27/02/2017)
    • (f) Fixed loading external files issue #6
    • (i) Project moved to gradle
  • 1.2.0 (06/04/2016)
    • (n) Implemented selection of objects
  • 1.1.0 (30/03/2016)
    • (n) Implemented lighting & toggle textures & lights
    • (i) Refactoring of 3DObjectImpl
  • 1.0.0 (27/03/2016)
    • (n) First release in Google Play Android Market

android-3d-model-viewer's People

Contributors

andresoviedo avatar

Stargazers

 avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.