android 3D model viewer

Средство просмотра 3D-моделей Android

Это демо-версия OpenGL ES 2.0. По сути, это приложение для Android с 3D-движком, которое может загружать файлы Wavefront OBJ, STL, DAE и GLTF. Цель этого приложения — изучить и поделиться тем, как рисовать с использованием языка OpenGL.

• Формат Wafefront (OBJ): https://en.wikipedia.org/wiki/Wavefront_.obj_file
• Формат STereoLithography (STL): https://en.wikipedia.org/wiki/STL_(file_format)
• Формат Collada (DAE): https://en.wikipedia.org/wiki/COLLADA
• Формат GLTF (gltf): https://www.khronos.org/gltf/

Новости (22.10.2024)

• Глтф-анимации :D
• Представление Android с использованием фрагментов
• Настройки Android
• Android SDK и зависимости обновлены.
• Загрузчик: Встроенный репозиторий Khronos.

Демо

Посмотрите это, чтобы увидеть возможности приложения: https://www.youtube.com/watch?v=PV92DKohXXk

Android Маркет

Уведомление

• Поддержка Collada ограничена. В настоящее время средство визуализации Collada поддерживает максимум 60 костей.
• Чтобы увидеть модели в виртуальной 3D-реальности, вам потребуются красно-голубые и/или VR-очки.
• Если у вас возникла какая-либо проблема в целом, откройте ее и, если возможно, прикрепите модель, указав версию Android и модель устройства.

О

Загрузите 3D-модели и узнайте, как это сделать с помощью этого приложения с открытым исходным кодом.

Основная цель этого приложения — показать, как рисовать в Android с использованием OpenGL 2.0, поделившись исходным кодом. Поэтому, пожалуйста, не ожидайте, что это приложение будет намного богаче или лучше, чем те, которые уже опубликованы в магазине приложений, но, по крайней мере, оно открыто для всех, кто хочет внести свой вклад или не хочет начинать аналогичный проект с нуля.

Поскольку это мое первое приложение для Android, и я все еще изучаю язык OpenGL 2.0, весьма вероятно, что в нем есть ошибки; но я постараюсь продолжать улучшать приложение и добавлять новые функции. Поэтому, пожалуйста, присылайте мне свои комментарии, предложения или жалобы, открыв вопрос.

Приложение поставляется с некоторыми 3D-моделями, имеющими разные лицензии.

Что дальше

• Улучшена поддержка стандартного формата glTF.
• VR без очков (в ожидании)
• Дополненная реальность

Функции

• Поддерживает >= Android 4.1 (Ice Cream Sandwich) — минимальный уровень API 16 -> целевой уровень API 31.
• API OpenGL ES 2.0
• Несколько форматов:
  • OBJ (волновой фронт)
  • STL (СТереолитография)
  • ДАЭ (Коллада-БЕТА)
  • GLTF (формат передачи GL)
• Поддержка нормалей вершин
• Поддержка трансформаций: масштабирование, вращение, перевод, ориентация.
• Поддержка цветов
• Поддержка текстур
• Поддержка освещения
• Несколько режимов рендеринга
  • треугольники
  • каркасный
  • облако точек
  • скелет
• поддержка камеры
  • перспектива
  • орфографический
  • изометрические виды
  • бесплатно
• скелетная анимация (collada dae, gltf)
• обнаружение столкновений лучей
• стереоскопическое 3D: анаглиф + картон
• другой:
  • Многоугольник с дырками
  • Сглаживание
  • Ограничительная рамка
  • Скайбокс
  • Выбор объекта
  • файловый менеджер
  • обозреватель репозитория
  • легкий: всего 8 Мегабайт (кроме 3D-моделей)

Попробуйте это

Установить приложение можно любым из этих способов:

• Магазин Play: https://play.google.com/store/apps/details?id=org.andresoviedo.dddmodel2.
• APK: app-release.apk
• Исходный код: клонируйте репозиторий, скомпилируйте с помощью gradle и установите с помощью 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

Откройте приложение. Вы должны увидеть меню. Отсюда вы можете загружать модели. После визуализации модели сведите пальцы и поверните ее, чтобы увидеть трехмерную сцену с другой точки зрения.

Скриншоты

Эмулятор

Вы можете запустить приложение в эмуляторе

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

Очки

Вам может понадобиться один из этих очков для просмотра моделей в виртуальной 3D-реальности.

Зависимости

Чтобы скомпилировать приложение, вы должны включить этот подмодуль git.

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

Документация

Работаю над этим...

Благодарность

• Для обучения работе механизма анимации: https://github.com/TheThinMatrix/OpenGL-Animation.
• К отзывам пользователей: https://github.com/the3deer/android-3D-model-viewer/issues
• Для парсера GLTF https://github.com/javagl/JglTF
• Спасибо множеству бесконечных образовательных ресурсов, которые можно найти в Интернете бесплатно! :)

Лицензии

Следующее уведомление об авторских правах и данное уведомление о разрешении должны быть включены во все копии или существенные части Программного обеспечения.

 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

Ресурсы

• ковбой: Нелицензионная лицензия — https://github.com/TheThinMatrix/OpenGL-Animation
• fox: CC0: низкополигональная лиса от PixelMannen, CC-BY 4.0: оснастка и анимация от @tomkranis на Sketchfab
• штурмовик: Лицензия MIT — https://github.com/hujiulong/vue-3d-model
• toyplane: Только для редакционного использования — https://blog.turbosquid.com/turbosquid-3d-model-license/#Editorial-Usage
• морской скайбокс: https://learnopengl.com/Advanced-OpenGL/Cubemaps
• песок для скайбокса: Copyright Mobialia, 2012 г. - https://github.com/mobialia/jmini3d
• модели (части): вклад сообщества (профессор С)