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

打開應用程式。您應該會看到一個菜單。您可以從那裡載入模型。

截圖

模擬器

您可以在模擬器中運行應用程式

 // 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教授）