android 3D model viewer

Penampil Model 3D Android

Ini adalah demo OpenGL ES 2.0. Ini pada dasarnya adalah aplikasi android dengan mesin 3D yang dapat memuat file Wavefront OBJ, STL, DAE & GLTF. Tujuan dari aplikasi ini adalah untuk mempelajari dan berbagi cara menggambar menggunakan bahasa OpenGL.

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

Berita (22/10/2024)

• Animasi Gltf :D
• Tampilan Android menggunakan Fragmen
• Preferensi Android untuk Pengaturan
• Android SDK dan dependensi diperbarui
• Loader: Repositori Khronos terintegrasi

Demo

Lihat ini untuk melihat fitur aplikasi: https://www.youtube.com/watch?v=PV92DKohXXk

Pasar Android

Melihat

• Dukungan Collada terbatas. Penyaji Collada saat ini mendukung maksimal 60 tulang.
• Untuk melihat model dalam realitas virtual 3D, Anda memerlukan kacamata sian merah dan/atau VR
• Jika Anda memiliki masalah apa pun secara umum, silakan buka masalah dan lampirkan model jika memungkinkan, tentukan versi Android dan model Perangkat.

Tentang

Muat model 3D dan lihat cara melakukannya dengan aplikasi kode sumber terbuka ini.

Tujuan utama dari aplikasi ini adalah untuk menunjukkan cara menggambar di android menggunakan OpenGL 2.0 dengan membagikan kode sumber. Jadi tolong, jangan berharap aplikasi ini lebih kaya atau lebih bagus dari yang sudah dipublikasikan di app store, tapi setidaknya terbuka untuk siapa saja yang ingin berkontribusi atau tidak ingin memulai proyek serupa dari awal.

Karena ini adalah aplikasi Android pertama saya dan saya masih mempelajari bahasa OpenGL 2.0, kemungkinan besar ada bug; tapi saya akan mencoba untuk terus meningkatkan aplikasi dan menambahkan lebih banyak fitur. Jadi tolong kirimkan saya komentar, saran atau keluhan Anda dengan membuka masalah.

Aplikasi ini hadir dengan beberapa model 3D yang disertakan dan memiliki lisensi berbeda.

Apa selanjutnya

• Tingkatkan dukungan untuk format standar glTF
• VR tanpa kacamata (ditahan)
• realitas tertambah

Fitur

• Mendukung >= Android 4.1 (Ice Cream Sandwich) - API Min Level 16 -> Target API Level 31
• API OpenGL ES 2.0
• Berbagai Format:
  • OBJ (muka gelombang)
  • STL (STereoLitografi)
  • DAE (Collada-BETA)
  • GLTF (Format Transmisi GL)
• Dukungan Vertex Normal
• Dukungan transformasi: penskalaan, rotasi, terjemahan, orientasi
• Dukungan warna
• Dukungan tekstur
• Dukungan pencahayaan
• Beberapa Mode Rendering
  • segitiga
  • gambar rangka
  • titik awan
  • kerangka
• dukungan kamera
  • perspektif
  • ortografis
  • tampilan isometrik
  • bebas
• animasi kerangka (collada dae, gltf)
• deteksi tabrakan sinar
• stereoskopis 3D: anaglyph + karton
• lainnya:
  • Poligon berlubang
  • Menghaluskan
  • Kotak pembatas
  • kotak langit
  • Pemetikan objek
  • penjelajah file
  • penjelajah repositori
  • ringan: hanya 8 Megabyte (tidak termasuk model 3d)

Cobalah

Anda dapat menginstal aplikasi dengan salah satu cara berikut:

• Play Store: https://play.google.com/store/apps/details?id=org.andresoviedo.dddmodel2
• APK: rilis-aplikasi.apk
• Kode sumber: kloning repositori, kompilasi dengan gradle dan instal dengan 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

Buka aplikasi. Anda akan melihat menu. Dari sana Anda dapat memuat model Setelah model dirender, cubit dan putar untuk melihat pemandangan 3D dari perspektif lain.

Tangkapan layar

Emulator

Anda dapat menjalankan aplikasi di emulator

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

Kacamata

Anda mungkin memerlukan salah satu kacamata ini untuk melihat model dalam realitas virtual 3D.

Ketergantungan

Untuk mengkompilasi aplikasi Anda harus menyertakan submodul git ini

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

Dokumentasi

Sedang mengerjakannya...

Pengakuan

• Untuk mengajarkan cara kerja mesin animasi: https://github.com/TheThinMatrix/OpenGL-Animation
• Untuk banyak masukan pengguna: https://github.com/the3deer/android-3D-model-viewer/issues
• Untuk pengurai GLTF https://github.com/javagl/JglTF
• Kepada banyaknya sumber daya pendidikan tak terbatas yang dapat ditemukan di Internet secara gratis, terima kasih! :)

Lisensi

Pemberitahuan hak cipta berikut dan pemberitahuan izin ini akan disertakan dalam semua salinan atau sebagian besar Perangkat Lunak.

 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

Aktiva

• koboi : Lisensi Tanpa Lisensi - https://github.com/TheThinMatrix/OpenGL-Animation
• fox : CC0: Rubah poli rendah oleh PixelMannen, CC-BY 4.0: Rigging dan animasi oleh @tomkranis di Sketchfab
• stormtrooper : Lisensi MIT - https://github.com/hujiulong/vue-3d-model
• pesawat mainan : Hanya Penggunaan Editorial - https://blog.turbosquid.com/turbosquid-3d-model-license/#Editorial-Usage
• skybox laut : https://learnopengl.com/Advanced-OpenGL/Cubemaps
• pasir skybox : Hak Cipta 2012 Mobilia - https://github.com/mobialia/jmini3d
• model (bagian): Kontribusi masyarakat (Profesor S)