android 3D model viewer

Visor de modelos 3D de Android

Esta es una demostración de OpenGL ES 2.0. Básicamente es una aplicación de Android con un motor 3D que puede cargar archivos Wavefront OBJ, STL, DAE y GLTF. El propósito de esta aplicación es aprender y compartir cómo dibujar usando el lenguaje OpenGL.

• Formato Wafefront (OBJ): https://en.wikipedia.org/wiki/Wavefront_.obj_file
• Formato STereoLithography (STL): https://en.wikipedia.org/wiki/STL_(file_format)
• Formato collada (DAE): https://en.wikipedia.org/wiki/COLLADA
• Formato GLTF (gltf): https://www.khronos.org/gltf/

Noticias (22/10/2024)

• Animaciones Gltf :D
• Vista de Android usando Fragmentos
• Preferencias de Android para la configuración
• SDK de Android y dependencias actualizadas
• Cargador: repositorio Khronos integrado

Manifestación

Consulte esto para ver las características de la aplicación: https://www.youtube.com/watch?v=PV92DKohXXk

Mercado Android

Aviso

• El soporte de Collada es limitado. El renderizador Collada actualmente admite un máximo de 60 huesos.
• Para ver modelos en realidad virtual 3D necesitas gafas rojo-cian y/o VR
• Si tiene algún problema en general, abra un problema y adjunte el modelo si es posible, especificando la versión de Android y el modelo del dispositivo.

Acerca de

Cargue modelos 3D y vea cómo hacerlo con esta aplicación de código abierto.

El objetivo principal de esta aplicación es mostrar cómo dibujar en Android usando OpenGL 2.0 compartiendo el código fuente. Así que, por favor, no esperéis que esta aplicación sea mucho más rica ni más bonita que las que ya están publicadas en la tienda de aplicaciones, pero al menos está abierta a cualquiera que quiera contribuir o no quiera empezar un proyecto similar desde cero.

Como esta es mi primera aplicación para Android y todavía estoy aprendiendo el lenguaje OpenGL 2.0, es muy probable que haya errores; pero intentaré seguir mejorando la aplicación y agregando más funciones. Entonces envíeme sus comentarios, sugerencias o quejas abriendo un problema.

La aplicación viene con algunos modelos 3D incluidos que tienen diferentes licencias.

¿Qué sigue?

• Mejorar el soporte para el formato estándar glTF
• VR sin gafas (en espera)
• realidad aumentada

Características

• Compatible con >= Android 4.1 (Ice Cream Sandwich) - Nivel mínimo de API 16 -> Nivel API objetivo 31
• API OpenGL ES 2.0
• Múltiples formatos:
  • OBJ (frente de onda)
  • STL (STereoLitografía)
  • DAE (Collada-BETA)
  • GLTF (formato de transmisión GL)
• Soporte de Normales de Vértice
• Soporte de transformación: escalado, rotación, traslación, orientación.
• Soporte de colores
• Soporte de texturas
• Soporte de iluminación
• Múltiples modos de renderizado
  • triangulos
  • estructura alámbrica
  • nube de puntos
  • esqueleto
• soporte de cámara
  • perspectiva
  • ortográfico
  • vistas isometricas
  • gratis
• animaciones esqueléticas (collada dae, gltf)
• detección de colisión de rayos
• 3D estereoscópico: anaglifo + cartón
• otro:
  • Polígono con agujeros
  • Suavizado
  • cuadro delimitador
  • Skybox
  • Recogida de objetos
  • explorador de archivos
  • explorador de repositorios
  • ligero: sólo 8 Megabytes (excluidos los modelos 3D)

Pruébalo

Puede instalar la aplicación de cualquiera de estas formas:

• Play Store: https://play.google.com/store/apps/details?id=org.andresoviedo.dddmodel2
• APK: lanzamiento de aplicación.apk
• Código fuente: clonar el repositorio, compilar con gradle e instalar con 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

Abra la aplicación. Deberías ver un menú. Desde allí puedes cargar modelos. Una vez renderizado el modelo, pellizca y gira para ver la escena 3D desde otra perspectiva.

Capturas de pantalla

Emulador

Puedes ejecutar la aplicación en un emulador.

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

Anteojos

Es posible que necesites una de estas gafas para ver modelos en realidad virtual 3D.

Dependencias

Para poder compilar la aplicación debes incluir este submódulo de git

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

Documentación

Trabajando en ello...

Reconocimiento

• Para enseñar cómo funciona el motor de animación: https://github.com/TheThinMatrix/OpenGL-Animation
• A muchos comentarios de los usuarios: https://github.com/the3deer/android-3D-model-viewer/issues
• Para el analizador GLTF https://github.com/javagl/JglTF
• A los infinitos recursos educativos que se encuentran en Internet de forma gratuita, ¡gracias! :)

Licencias

El siguiente aviso de derechos de autor y este aviso de permiso se incluirán en todas las copias o partes sustanciales del Software.

 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

Activos

• vaquero: Licencia sin licencia - https://github.com/TheThinMatrix/OpenGL-Animation
• fox: CC0: Low poly fox de PixelMannen, CC-BY 4.0: Rigging y animación de @tomkranis en Sketchfab
• soldado de asalto: Licencia MIT - https://github.com/hujiulong/vue-3d-model
• toyplane: solo para usos editoriales: https://blog.turbosquid.com/turbosquid-3d-model-license/#Editorial-Usage
• skybox mar: https://learnopengl.com/Advanced-OpenGL/Cubemaps
• skybox arena: Copyright 2012 Mobialia - https://github.com/mobialia/jmini3d
• Modelos (partes): Contribución comunitaria (Profesor S)