android 3D model viewer

Android 3D-Modellbetrachter

Dies ist eine Demo von OpenGL ES 2.0. Es handelt sich im Grunde um eine Android-Anwendung mit einer 3D-Engine, die Wavefront OBJ-, STL-, DAE- und GLTF-Dateien laden kann. Der Zweck dieser Anwendung besteht darin, zu lernen und zu teilen, wie man mit der OpenGL-Sprache zeichnet.

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

Neuigkeiten (22.10.2024)

• Gltf-Animationen :D
• Android-Ansicht mit Fragmenten
• Android-Einstellungen für Einstellungen
• Android SDK und Abhängigkeiten aktualisiert
• Loader: Integriertes Khronos-Repository

Demo

Sehen Sie sich hier die Funktionen der Anwendung an: https://www.youtube.com/watch?v=PV92DKohXXk

Android Market

Beachten

• Der Collada-Support ist begrenzt. Der Collada-Renderer unterstützt derzeit maximal 60 Bones.
• Um Modelle in der virtuellen 3D-Realität zu sehen, benötigen Sie eine Rot-Cyan- und/oder VR-Brille
• Wenn Sie ein allgemeines Problem haben, öffnen Sie bitte ein Problem und hängen Sie nach Möglichkeit ein Modell an. Geben Sie dabei die Android-Version und das Gerätemodell an.

Um

Laden Sie 3D-Modelle und sehen Sie, wie es mit dieser Open-Source-Code-Anwendung geht.

Der Hauptzweck dieser App besteht darin, zu zeigen, wie man in Android mit OpenGL 2.0 zeichnet, indem man den Quellcode teilt. Erwarten Sie also bitte nicht, dass diese Anwendung viel umfangreicher oder schöner ist als die bereits im App Store veröffentlichten, aber sie steht zumindest jedem offen, der einen Beitrag leisten oder kein ähnliches Projekt von Grund auf starten möchte.

Da dies meine erste Android-App ist und ich immer noch die OpenGL 2.0-Sprache lerne, ist es sehr wahrscheinlich, dass es Fehler gibt; Aber ich werde versuchen, die App weiter zu verbessern und weitere Funktionen hinzuzufügen. Bitte senden Sie mir Ihre Kommentare, Vorschläge oder Beschwerden, indem Sie ein Problem eröffnen.

Die App enthält einige 3D-Modelle, die über unterschiedliche Lizenzen verfügen.

Was kommt als nächstes?

• Verbessern Sie die Unterstützung für das glTF-Standardformat
• VR ohne Brille (in der Warteschleife)
• Erweiterte Realität

Merkmale

• Unterstützt >= Android 4.1 (Ice Cream Sandwich) – Min. API-Level 16 -> Ziel-API-Level 31
• OpenGL ES 2.0-API
• Mehrere Formate:
  • OBJ (Wellenfront)
  • STL (STereoLithographie)
  • DAE (Collada-BETA)
  • GLTF (GL-Übertragungsformat)
• Unterstützung für Vertex-Normalen
• Transformationsunterstützung: Skalierung, Rotation, Translation, Orientierung
• Farbunterstützung
• Texturunterstützung
• Beleuchtungsunterstützung
• Mehrere Rendering-Modi
  • Dreiecke
  • Drahtmodell
  • Punktwolke
  • Skeleton
• Kameraunterstützung
  • Perspektive
  • orthografisch
  • isometrische Ansichten
  • frei
• Skelettanimationen (Collada Dae, GLTF)
• Erkennung von Strahlenkollisionen
• stereoskopisches 3D: Anaglyph + Karton
• andere:
  • Polygon mit Löchern
  • Glätten
  • Begrenzungsrahmen
  • Skybox
  • Objektauswahl
  • Datei-Explorer
  • Repository-Explorer
  • Leicht: nur 8 Megabyte (3D-Modelle ausgenommen)

Probieren Sie es aus

Sie können die Anwendung auf eine der folgenden Arten installieren:

• Play Store: https://play.google.com/store/apps/details?id=org.andresoviedo.dddmodel2
• APK: app-release.apk
• Quellcode: Klonen Sie das Repository, kompilieren Sie es mit Gradle und installieren Sie es mit 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

Öffnen Sie die Anwendung. Sie sollten ein Menü sehen. Von dort aus können Sie Modelle laden. Sobald das Modell gerendert ist, können Sie es zusammenziehen und drehen, um die 3D-Szene aus einer anderen Perspektive zu sehen.

Screenshots

Emulator

Sie können die Anwendung in einem Emulator ausführen

 // 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

Gläser

Möglicherweise benötigen Sie eine dieser Brillen, um Modelle in der virtuellen 3D-Realität anzuzeigen.

Abhängigkeiten

Um die Anwendung zu kompilieren, müssen Sie dieses Git-Submodul einbinden

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

Dokumentation

Ich arbeite daran...

Anerkennung

• Zum Erlernen der Funktionsweise der Animations-Engine: https://github.com/TheThinMatrix/OpenGL-Animation
• Zum vielen Feedback der Benutzer: https://github.com/the3deer/android-3D-model-viewer/issues
• Für den GLTF-Parser https://github.com/javagl/JglTF
• Vielen Dank an die unzähligen kostenlosen Bildungsressourcen im Internet! :) :)

Lizenzen

Der folgende Urheberrechtshinweis und dieser Genehmigungshinweis müssen in allen Kopien oder wesentlichen Teilen der Software enthalten sein.

 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

Vermögenswerte

• Cowboy: Nicht lizenzierte Lizenz – https://github.com/TheThinMatrix/OpenGL-Animation
• fox: CC0: Low-Poly-Fox von PixelMannen, CC-BY 4.0: Rigging und Animation von @tomkranis auf Sketchfab
• Stormtrooper: MIT-Lizenz – https://github.com/hujiulong/vue-3d-model
• Spielzeugflugzeug: Nur für redaktionelle Verwendung – https://blog.turbosquid.com/turbosquid-3d-model-license/#Editorial-Usage
• Skybox-Meer: https://learnopengl.com/Advanced-OpenGL/Cubemaps
• Skybox-Sand: Copyright 2012 Mobialia – https://github.com/mobialia/jmini3d
• Modelle (Teile): Gemeinschaftsbeitrag (Professor S)