Skip to content

Proof of Concept Android app demonstrating how to embed interactive 3D models (STL & glTF) into a Jetpack Compose UI using a WebView and Three.js. Includes real-time scene configuration, model loading, and orientation control via device sensors.

Notifications You must be signed in to change notification settings

Alexx247/Model3dViewer

Repository files navigation

🌟 Model3dViewer: Interactive 3D Model Viewer for Android

Model3dViewer Releases

Welcome to the Model3dViewer repository! This project serves as a proof of concept for an Android application that demonstrates how to embed interactive 3D models into a Jetpack Compose UI. Using a WebView and Three.js, this app allows for real-time scene configuration, model loading, and orientation control through device sensors.

🚀 Table of Contents

  1. Features
  2. Technologies Used
  3. Installation
  4. Usage
  5. Contributing
  6. License
  7. Contact

🔍 Features

  • Interactive 3D Models: Load and interact with STL and glTF models.
  • Jetpack Compose UI: Modern UI toolkit for Android.
  • WebView Integration: Seamlessly display 3D models in your app.
  • Real-Time Configuration: Change scene settings on the fly.
  • Orientation Control: Use device sensors for intuitive navigation.

🛠️ Technologies Used

This project utilizes a range of technologies to create a robust and efficient application:

  • Kotlin: The primary programming language for Android development.
  • Jetpack Compose: A modern toolkit for building native UI.
  • Three.js: A powerful JavaScript library for 3D graphics.
  • WebView: For rendering web content within the app.
  • STL & glTF: Formats for 3D model files.

📥 Installation

To get started with Model3dViewer, you can download the latest release from the Releases section. Simply download the APK file and install it on your Android device.

📖 Usage

Once installed, open the app. You will see a simple interface that allows you to load different 3D models. Here’s how to use the app:

  1. Load a Model: Tap the "Load Model" button to select an STL or glTF file.
  2. Interact: Use touch gestures to rotate, zoom, and pan the model.
  3. Adjust Settings: Modify scene settings in real-time.
  4. Use Sensors: Tilt your device to change the orientation of the model.

🤝 Contributing

We welcome contributions! If you have suggestions or improvements, please fork the repository and submit a pull request. Here are some ways you can contribute:

  • Bug Reports: Report any issues you encounter.
  • Feature Requests: Suggest new features or enhancements.
  • Documentation: Help improve the documentation.

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

📬 Contact

For questions or feedback, please reach out:


🎉 Getting Started

To get started, visit the Releases section for the latest version. Download the APK file, install it, and dive into the world of 3D modeling on Android.

📸 Screenshots

Screenshot 1
Loading a 3D Model

Screenshot 2
Interacting with the Model

Screenshot 3
Adjusting Scene Settings

📊 Future Enhancements

We plan to expand the functionality of the Model3dViewer app. Some potential features include:

  • Model Library: A built-in library of common 3D models.
  • Export Options: Save modified models in various formats.
  • User Accounts: Allow users to save their favorite models and settings.
  • Enhanced Performance: Optimize rendering for better performance on lower-end devices.

🌐 Community and Support

Join our community to share your experiences, ask questions, and provide feedback. We value your input and strive to create a supportive environment for developers and users alike.

📌 Important Links

🏷️ Topics

This project covers various topics, including:

  • 3D Models
  • Android View
  • Compose
  • glb
  • glTF
  • JavaScript
  • Kotlin Android
  • Orbit Controls
  • Sensors
  • STL
  • Three.js
  • WebView

Explore these topics to deepen your understanding of the technologies involved in this project.

💡 Tips for Developers

  • Stay Updated: Keep your dependencies up to date for the best performance.
  • Experiment: Don’t hesitate to try new features or tweak existing ones.
  • Documentation: Always refer to the documentation for guidance.

🎈 Acknowledgments

Thank you to the developers and contributors of the libraries and tools used in this project. Your hard work makes this project possible.


For further information, visit the Releases section and download the latest version to experience the Model3dViewer app firsthand.

About

Proof of Concept Android app demonstrating how to embed interactive 3D models (STL & glTF) into a Jetpack Compose UI using a WebView and Three.js. Includes real-time scene configuration, model loading, and orientation control via device sensors.

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •