android 3D model viewer

Android 3D 模型查看器

这是 OpenGL ES 2.0 的演示。它基本上是一个带有 3D 引擎的 Android 应用程序，可以加载 Wavefront OBJ、STL、DAE 和 GLTF 文件。该应用程序的目的是学习和分享如何使用OpenGL语言进行绘图。

• Wafefront 格式 (OBJ)：https://en.wikipedia.org/wiki/Wavefront_.obj_file
• 立体光刻格式 (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)

• Gltf 动画 :D
• 使用 Fragment 的 Android 视图
• Android 偏好设置
• Android SDK 和依赖项已更新
• 加载器：集成 Khronos 存储库

演示

查看此应用程序的功能：https://www.youtube.com/watch?v=PV92DKohXXk

安卓市场

注意

• Collada 支持有限。 Collada 渲染器目前最多支持 60 个骨骼。
• 为了在 3D 虚拟现实中查看模型，您需要红青色和/或 VR 眼镜
• 如果您遇到任何一般问题，请打开问题并附上型号（如果可能），并指定 Android 版本和设备型号。

关于

加载 3D 模型并了解如何使用此开源代码应用程序执行此操作。

这个应用程序的主要目的是通过分享源代码来展示如何使用OpenGL 2.0在android中绘图。因此，请不要指望这个应用程序比应用程序商店中已经发布的应用程序更丰富或更好，但至少它向任何想要贡献或不想从头开始启动类似项目的人开放。

由于这是我的第一个 Android 应用程序，而且我仍在学习 OpenGL 2.0 语言，因此很可能存在错误；但我会尝试继续改进应用程序并添加更多功能。因此，请通过提出问题向我发送您的意见、建议或投诉。

该应用程序附带了一些具有不同许可证的 3D 模型。

接下来是什么

• 改进对 glTF 标准格式的支持
• 裸眼 VR（暂停）
• 增强现实

特征

• 支持 >= Android 4.1（冰淇淋三明治） - 最低 API 级别 16 -> 目标 API 级别 31
• OpenGL ES 2.0 API
• 多种格式：
  • OBJ（波前）
  • STL（立体光刻）
  • DAE（Collada-BETA）
  • GLTF（GL 传输格式）
• 顶点法线支持
• 变换支持：缩放、旋转、平移、方向
• 颜色支持
• 纹理支持
• 灯光支持
• 多种渲染模式
  • 三角形
  • 线框
  • 点云
  • 骨骼
• 相机支持
  • 看法
  • 正字法
  • 等距视图
  • 自由的
• 骨骼动画（collada dae、gltf）
• 射线碰撞检测
• 立体 3D：浮雕 + 纸板
• 其他：
  • 带孔的多边形
  • 平滑
  • 边界框
  • 天空盒
  • 物体拾取
  • 文件浏览器
  • 存储库浏览器
  • 轻量级：仅 8 MB（不包括 3D 模型）

尝试一下

您可以通过以下任一方式安装该应用程序：

• Play 商店：https://play.google.com/store/apps/details?id=org.andresoviedo.dddmodel2
• APK：应用程序发布.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

打开应用程序。您应该会看到一个菜单。您可以从那里加载模型。渲染模型后，捏合并旋转以从另一个角度查看 3D 场景。

截图

模拟器

您可以在模拟器中运行应用程序

 // 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
• 狐狸：CC0：PixelMannen 的低多边形狐狸，CC-BY 4.0：Sketchfab 上的@tomkranis 的绑定和动画
• 冲锋队：麻省理工学院许可证 - https://github.com/hujiulong/vue-3d-model
• toyplane：仅供编辑使用 - https://blog.turbosquid.com/turbosquid-3d-model-license/#Editorial-Usage
• 天空盒海：https://learnopengl.com/Advanced-OpenGL/Cubemaps
• skybox 沙子：版权所有 2012 Mobialia - https://github.com/mobialia/jmini3d
• 模型（部分）：社区贡献（S教授）