android 3D model viewer

Visualizador de modelo 3D Android

Esta é uma demonstração do OpenGL ES 2.0. É basicamente um aplicativo Android com um mecanismo 3D que pode carregar arquivos Wavefront OBJ, STL, DAE e GLTF. O objetivo deste aplicativo é aprender e compartilhar como desenhar na linguagem 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/

Notícias (22/10/2024)

• Animações Gltf :D
• Visualização Android usando fragmentos
• Preferências do Android para configurações
• Android SDK e dependências atualizadas
• Loader: Repositório Khronos integrado

Demonstração

Confira isto para ver os recursos do aplicativo: https://www.youtube.com/watch?v=PV92DKohXXk

Mercado Android

Perceber

• O suporte Collada é limitado. O renderizador Collada atualmente suporta no máximo 60 ossos.
• Para ver modelos em realidade virtual 3D, você precisa de óculos vermelho-ciano e/ou VR
• Se você tiver algum problema em geral, abra um problema e anexe o modelo, se possível, especificando a versão do Android e o modelo do dispositivo.

Sobre

Carregue modelos 3D e veja como fazer isso com este aplicativo de código aberto.

O principal objetivo deste aplicativo é mostrar como desenhar no Android usando o OpenGL 2.0 compartilhando o código-fonte. Então, por favor, não espere que este aplicativo seja muito mais rico ou agradável do que os já publicados na app store, mas pelo menos ele está aberto para quem quiser contribuir ou não quiser começar um projeto semelhante do zero.

Como este é meu primeiro aplicativo Android e ainda estou aprendendo a linguagem OpenGL 2.0, é altamente provável que haja bugs; mas tentarei continuar melhorando o aplicativo e adicionando mais recursos. Então, por favor, envie-me seus comentários, sugestões ou reclamações abrindo um issue.

O aplicativo vem com alguns modelos 3D incluídos que possuem licenças diferentes.

O que vem a seguir

• Melhorar o suporte para o formato padrão glTF
• VR sem óculos (em espera)
• Realidade aumentada

Características

• Suporta >= Android 4.1 (Ice Cream Sandwich) - Nível mínimo de API 16 -> API de destino nível 31
• API OpenGL ES 2.0
• Vários formatos:
  • OBJ (frente de onda)
  • STL (ESTéreoLitografia)
  • DAE (Collada-BETA)
  • GLTF (formato de transmissão GL)
• Suporte para normais de vértice
• Suporte de transformação: dimensionamento, rotação, translação, orientação
• Suporte de cores
• Suporte a texturas
• Suporte de iluminação
• Vários modos de renderização
  • triângulos
  • estrutura de arame
  • nuvem de pontos
  • esqueleto
• suporte para câmera
  • perspectiva
  • ortográfico
  • vistas isométricas
  • livre
• animações esqueléticas (collada dae, gltf)
• detecção de colisão de raios
• 3D estereoscópico: anáglifo + papelão
• outro:
  • Polígono com buracos
  • Suavização
  • Caixa delimitadora
  • Camarote
  • Separação de objetos
  • explorador de arquivos
  • explorador de repositório
  • leve: apenas 8 Megabytes (modelos 3D excluídos)

Experimente

Você pode instalar o aplicativo de uma destas maneiras:

• Play Store: https://play.google.com/store/apps/details?id=org.andresoviedo.dddmodel2
• APK: app-release.apk
• Código fonte: clone o repositório, compile com gradle e instale com 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 o aplicativo. Você deverá ver um menu. A partir daí você pode carregar modelos. Depois que o modelo for renderizado, aperte e gire para ver a cena 3D de outra perspectiva.

Capturas de tela

Emulador

Você pode executar o aplicativo em um 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

Copos

Você pode precisar de um desses óculos para visualizar modelos em realidade virtual 3D.

Dependências

Para compilar o aplicativo você deve incluir este submódulo git

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

Documentação

Trabalhando nisso...

Reconhecimento

• Para ensinar como funciona o mecanismo de animação: https://github.com/TheThinMatrix/OpenGL-Animation
• Para muitos comentários do usuário: https://github.com/the3deer/android-3D-model-viewer/issues
• Para o analisador GLTF https://github.com/javagl/JglTF
• Aos infinitos recursos educacionais encontrados gratuitamente na Internet, obrigado! :)

Licenças

O seguinte aviso de direitos autorais e este aviso de permissão serão incluídos em todas as cópias ou partes substanciais do 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

Ativos

• cowboy: Licença não licenciada - https://github.com/TheThinMatrix/OpenGL-Animation
• fox: CC0: Low poly fox por PixelMannen, CC-BY 4.0: Rigging e animação por @tomkranis no Sketchfab
• stormtrooper: Licença MIT - https://github.com/hujiulong/vue-3d-model
• avião de brinquedo: apenas para uso editorial - https://blog.turbosquid.com/turbosquid-3d-model-license/#Editorial-Usage
• mar skybox: https://learnopengl.com/Advanced-OpenGL/Cubemaps
• areia skybox: Copyright 2012 Mobialia - https://github.com/mobialia/jmini3d
• modelos (partes): Contribuição comunitária (Professor S)