Piccolo

Piccolo 引擎（以前稱為 Pilot 引擎）

先決條件

要建置 Piccolo，您必須先安裝以下工具。

Windows 10/11

• Visual Studio 2019（或更高版本）

• CMake 3.19（或​​更高版本）

• Git 2.1（或更新版本）

macOS >= 10.15 (x86_64)

• Xcode 12.3（或更高版本）

• CMake 3.19（或​​更高版本）

• Git 2.1（或更新版本）

烏班圖20.04

• apt安裝以下軟體包

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

• NVIDIA 驅動程式（AMD 和 Intel 驅動程式是開源的，因此由 mesa-vulkan-drivers 自動安裝）

建構短笛

在 Windows 上建置

您可以執行build_windows.bat 。此批次檔將產生項目，並自動建置Piccolo 引擎的發布配置。建置成功後，您可以在bin目錄中找到PiccoloEditor.exe。

或者您可以使用以下命令先生成Visual Studio項目，然後在建置目錄中開啟解決方案並手動建置。

cmake -S . -B build

在 macOS 上構建

以下建置指令僅在 x86_64 的特定硬體上進行測試，不支援 M1 晶片。對於M1相容，我們將稍後發布。

要編譯 Piccolo，您必須安裝最新版本的 Xcode。然後從專案根目錄執行“cmake”，產生Xcode專案。

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

你可以用以下命令建立項目

cmake --build build --config Release

或者您可以執行build_macos.sh來建立二進位檔案。

在 Ubuntu 20.04 上構建

您可以執行build_linux.sh來建置二進位檔案。

文件

有關文檔，請參閱 Wiki 部分。

額外的

Vulkan 驗證層：驗證錯誤

我們注意到一些 Windows 上的開發者在調試時遇到 PiccoloEditor.exe 可以正常運行，但報出異常 Vulkan Validation Layer: Validation Error。您可以透過安裝Vulkan SDK來解決這個問題（官方最新版本即可）。

產生編譯資料庫

當Unix Makefiles產生器可用時，您可以使用下列命令建立compile_commands.json 。 compile_commands.json是clangd語言伺服器所需的文件，它是 Emacs 中 cpp lsp-mode 的後端。

對於 Windows：

 cmake -DCMAKE_TRY_COMPILE_TARGET_TYPE="STATIC_LIBRARY" -DCMAKE_EXPORT_COMPILE_COMMANDS=ON -S 。 -Bcompile_db_temp -G「Unix Makefiles」複製compile_db_tempcompile_commands.json。

使用物理調試渲染器

目前實體偵錯渲染器僅在 Windows 上可用。您可以使用以下命令透過偵錯器專案產生解決方案。

 cmake -S 。 -B 建置 -DENABLE_PHYSICS_DEBUG_RENDERER=ON

筆記：

1. 請在重新生成解決方案之前清理建置目錄。我們在直接使用先前的 CMakeCache 重新生成時遇到了建置問題。

2. 當您啟動 PiccoloEditor 時，物理偵錯渲染器將會運作。我們已經同步了兩個場景之間的攝影機位置。但物理調試渲染器中的初始相機模式是錯誤的。向下滾動滑鼠滾輪一次會將實體調試渲染器的相機變更為正確的模式。

建置Linux
建構 macOS