Piccolo

ピッコロエンジン（旧パイロットエンジン）

前提条件

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 (またはそれ以降)

Ubuntu 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 Engineのリリース構成を自動的に構築します。ビルドが成功すると、 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は、Emacs の cpp lsp-mode のバックエンドであるclangd言語サーバーに必要なファイルです。

Windowsの場合:

 cmake -DCMAKE_TRY_COMPILE_TARGET_TYPE="STATIC_LIBRARY" -DCMAKE_EXPORT_COMPILE_COMMANDS=ON -S 。 -B コンパイル_db_temp -G "Unix Makefiles" コンパイル_db_tempcompile_commands.json をコピーします。

物理デバッグレンダラーの使用

現在、Physics Debug Renderer は Windows でのみ使用できます。次のコマンドを使用して、デバッガー プロジェクトでソリューションを生成できます。

 cmake -S 。 -B ビルド -DENABLE_PHYSICS_DEBUG_RENDERER=ON

注記：

1. ソリューションを再生成する前に、ビルド ディレクトリをクリーンアップしてください。以前の CMakeCache を使用して直接再生成すると、ビルドの問題が発生しました。

2. PiccoloEditor を起動すると、Physics Debug Renderer が実行されます。両方のシーン間でカメラの位置を同期しました。しかし、Physics Debug Renderer の初期カメラ モードが間違っています。マウス ホイールを下に 1 回スクロールすると、Physics Debug Renderer のカメラが正しいモードに変更されます。

Linuxを構築する
macOSを構築する