Piccolo

Mesin Piccolo (sebelumnya Mesin Pilot)

Prasyarat

Untuk membangun Piccolo, Anda harus menginstal alat berikut terlebih dahulu.

jendela 10/11

• Visual Studio 2019 (atau lebih baru)

• CMake 3.19 (atau lebih baru)

• Git 2.1 (atau lebih baru)

macOS >= 10.15 (x86_64)

• Xcode 12.3 (atau lebih baru)

• CMake 3.19 (atau lebih baru)

• Git 2.1 (atau lebih baru)

Ubuntu 20.04

• tepat instal paket-paket berikut

sudo apt install libxrandr-dev
sudo apt install libxrender-dev
sudo apt install libxinerama-dev
sudo apt install libxcursor-dev
sudo apt install libxi-dev
sudo apt install libglvnd-dev
sudo apt install libvulkan-dev
sudo apt install cmake
sudo apt install clang
sudo apt install libc++-dev
sudo apt install libglew-dev
sudo apt install libglfw3-dev
sudo apt install vulkan-validationlayers
sudo apt install mesa-vulkan-drivers

• Driver NVIDIA (Driver AMD dan Intel adalah sumber terbuka, dan karenanya diinstal secara otomatis oleh driver mesa-vulkan)

Bangun Piccolo

Bangun di Windows

Anda dapat menjalankan build_windows.bat . File batch ini akan menghasilkan proyek, dan membuat konfigurasi Rilis Mesin Piccolo secara otomatis. Setelah build berhasil, Anda dapat menemukan PiccoloEditor.exe di direktori bin .

Atau Anda dapat menggunakan perintah berikut untuk membuat proyek Visual Studio terlebih dahulu, lalu membuka solusi di direktori build dan membangunnya secara manual.

cmake -S . -B build

Bangun di MacOS

Petunjuk pembuatan berikut hanya diuji pada perangkat keras tertentu x86_64, dan tidak mendukung chip M1. Untuk M1 kompatibel, kami akan rilis nanti.

Untuk mengkompilasi Piccolo, Anda harus menginstal Xcode versi terbaru. Kemudian jalankan 'cmake' dari direktori root proyek, untuk menghasilkan proyek Xcode.

cmake -S . -B build -G "Xcode"

dan Anda dapat membangun proyek dengan

cmake --build build --config Release

Atau Anda dapat menjalankan build_macos.sh untuk membuat binari.

Bangun di Ubuntu 20.04

Anda dapat menjalankan build_linux.sh untuk membangun binari.

Dokumentasi

Untuk dokumentasi, silakan merujuk ke bagian Wiki.

Tambahan

Lapisan Validasi Vulkan: Kesalahan Validasi

Kami telah memperhatikan beberapa pengembang di Windows menemukan PiccoloEditor.exe dapat berjalan normal tetapi melaporkan pengecualian Lapisan Validasi Vulkan: Kesalahan Validasi saat debugging. Anda dapat mengatasi masalah ini dengan menginstal Vulkan SDK (versi terbaru resmi bisa digunakan).

Hasilkan Basis Data Kompilasi

Anda dapat membangun compile_commands.json dengan perintah berikut ketika generator Unix Makefiles tersedia. compile_commands.json adalah file yang dibutuhkan oleh server bahasa clangd , yang merupakan backend untuk mode cpp lsp di Emacs.

Untuk Windows:

 cmake -DCMAKE_TRY_COMPILE_TARGET_TYPE="STATIC_LIBRARY" -DCMAKE_EXPORT_COMPILE_COMMANDS=ON -S . -B kompilasi_db_temp -G "Unix Makefiles"salin kompilasi_db_tempile_commands.json .

Menggunakan Fisika Debug Renderer

Saat ini Physics Debug Renderer hanya tersedia di Windows. Anda dapat menggunakan perintah berikut untuk menghasilkan solusi dengan proyek debugger.

 membuat -S . -B membangun -DENABLE_PHYSICS_DEBUG_RENDERER=ON

Catatan:

1. Harap bersihkan direktori build sebelum membuat ulang solusinya. Kami mengalami masalah pembangunan saat membuat ulang secara langsung dengan CMakeCache sebelumnya.

2. Physics Debug Renderer akan berjalan saat Anda memulai PiccoloEditor. Kami telah menyinkronkan posisi kamera di antara kedua adegan. Namun mode kamera awal di Physics Debug Renderer salah. Menggulir roda mouse ke bawah sekali akan mengubah kamera Physics Debug Renderer ke mode yang benar.

Membangun Linux
Bangun macOS