android 3D model viewer

Visionneuse de modèles 3D Android

Ceci est une démo d'OpenGL ES 2.0. Il s'agit essentiellement d'une application Android avec un moteur 3D capable de charger des fichiers Wavefront OBJ, STL, DAE et GLTF. Le but de cette application est d'apprendre et de partager comment dessiner en utilisant le langage OpenGL.

• Format Wafefront (OBJ) : https://en.wikipedia.org/wiki/Wavefront_.obj_file
• Format STéréoLithographie (STL) : https://en.wikipedia.org/wiki/STL_(file_format)
• Format Collada (DAE) : https://en.wikipedia.org/wiki/COLLADA
• Format GLTF (gltf) : https://www.khronos.org/gltf/

Actualités (22/10/2024)

• Gltf Animations :D
• Vue Android à l'aide de Fragments
• Préférences Android pour les paramètres
• SDK Android et dépendances mis à jour
• Loader : référentiel Khronos intégré

Démo

Consultez ceci pour voir les fonctionnalités de l'application : https://www.youtube.com/watch?v=PV92DKohXXk

Marché Android

Avis

• La prise en charge de Collada est limitée. Le moteur de rendu Collada prend actuellement en charge un maximum de 60 os.
• Pour voir des modèles en réalité virtuelle 3D, vous avez besoin de lunettes rouge-cyan et/ou VR
• Si vous rencontrez un problème en général, veuillez ouvrir un problème et joindre le modèle si possible, en spécifiant la version Android et le modèle de l'appareil.

À propos

Chargez des modèles 3D et voyez comment le faire avec cette application de code open source.

L'objectif principal de cette application est de montrer comment dessiner sous Android en utilisant OpenGL 2.0 en partageant le code source. Alors s'il vous plaît, ne vous attendez pas à ce que cette application soit beaucoup plus riche ou plus agréable que celles déjà publiées dans l'App Store, mais au moins elle est ouverte à tous ceux qui souhaitent contribuer ou qui ne veulent pas démarrer un projet similaire à partir de zéro.

Comme il s'agit de ma première application Android et que j'apprends toujours le langage OpenGL 2.0, il est fort probable qu'il y ait des bugs ; mais j'essaierai de continuer à améliorer l'application et à ajouter plus de fonctionnalités. Alors n'hésitez pas à m'envoyer vos commentaires, suggestions ou plaintes en ouvrant un numéro.

L'application est livrée avec certains modèles 3D inclus qui ont des licences différentes.

Quelle est la prochaine étape

• Améliorer la prise en charge du format standard glTF
• VR sans lunettes (en attente)
• Réalité augmentée

Caractéristiques

• Prise en charge >= Android 4.1 (Ice Cream Sandwich) - Niveau API minimum 16 -> Niveau API cible 31
• API OpenGL ES 2.0
• Formats multiples :
  • OBJ (front d'onde)
  • STL (STéréoLithographie)
  • DAE (Collada-BETA)
  • GLTF (format de transmission GL)
• Prise en charge des normales de sommet
• Prise en charge de la transformation : mise à l'échelle, rotation, translation, orientation
• Prise en charge des couleurs
• Prise en charge des textures
• Prise en charge de l'éclairage
• Plusieurs modes de rendu
  • triangles
  • filaire
  • nuage de points
  • squelette
• prise en charge de la caméra
  • perspective
  • orthographique
  • vues isométriques
  • gratuit
• animations squelettiques (collada dae, gltf)
• détection de collision de rayons
• 3D stéréoscopique : anaglyphe + carton
• autre:
  • Polygone avec des trous
  • Lissage
  • Boîte englobante
  • Skybox
  • Sélection d'objets
  • explorateur de fichiers
  • explorateur de référentiel
  • léger : seulement 8 Mégaoctets (modèles 3D exclus)

Essayez-le

Vous pouvez installer l'application de l'une des manières suivantes :

• Play Store : https://play.google.com/store/apps/details?id=org.andresoviedo.dddmodel2
• APK : app-release.apk
• Code source : cloner le référentiel, compiler avec gradle et installer avec adb

    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.the3deer.app.model3D.MainActivity

Ouvrez l'application. Vous devriez voir un menu. À partir de là, vous pouvez charger des modèles. Une fois le modèle rendu, pincez et faites pivoter pour voir la scène 3D sous une autre perspective.

Captures d'écran

Émulateur

Vous pouvez exécuter une application dans un émulateur

 // install some file provider (i.e. es file explorer)
adb devices -l
adb -s emulator-5554 install .com.estrongs.android.pop_4.0.3.4-250_minAPI8(armeabi,x86)(nodpi).apk
// push some files to test file loading
adb -s emulator-5554 push .appsrcmainassetsmodels /sdcard/download

Lunettes

Vous aurez peut-être besoin d'une de ces lunettes pour visualiser des modèles en réalité virtuelle 3D.

Dépendances

Afin de compiler l'application, vous devez inclure ce sous-module git

 git submodule add https://github.com/the3deer/android-3D-engine.git engine

Documentation

J'y travaille...

Reconnaissance

• Pour enseigner le fonctionnement du moteur d'animation : https://github.com/TheThinMatrix/OpenGL-Animation
• Au grand nombre de retours d'utilisateurs : https://github.com/the3deer/android-3D-model-viewer/issues
• Pour l'analyseur GLTF https://github.com/javagl/JglTF
• Aux nombreuses ressources pédagogiques infinies trouvées gratuitement sur Internet, merci ! :)

Licences

L'avis de droit d'auteur suivant et cet avis d'autorisation doivent être inclus dans toutes les copies ou parties substantielles du logiciel.

 MIT License - Copyright (c) 2022 The 3Deer - https://github.com/the3deer
GNU LGPL v2.1 Copyright (c) 2001, 2002 Dipl. Ing. P. Szawlowski - STL Parser
MIT License - https://github.com/javagl/JglTF - GLTF Parser    
ISC License - Earcut - https://github.com/the3deer/earcut

Actifs

• cowboy : licence sans licence - https://github.com/TheThinMatrix/OpenGL-Animation
• fox : CC0 : Low poly fox par PixelMannen, CC-BY 4.0 : Rigging et animation par @tomkranis sur Sketchfab
• stormtrooper : Licence MIT - https://github.com/hujiulong/vue-3d-model
• avion jouet : utilisations éditoriales uniquement - https://blog.turbosquid.com/turbosquid-3d-model-license/#Editorial-Usage
• mer skybox : https://learnopengl.com/Advanced-OpenGL/Cubemaps
• sable skybox : Copyright 2012 Mobialia - https://github.com/mobialia/jmini3d
• maquettes (pièces) : Contribution communautaire (Professeur S)