Piccolo

Piccolo Engine (anteriormente Pilot Engine)

Requisitos previos

Para construir Piccolo, primero debes instalar las siguientes herramientas.

Ventanas 10/11

• Visual Studio 2019 (o más reciente)

• CMake 3.19 (o más reciente)

• Git 2.1 (o más reciente)

MacOS >= 10.15 (x86_64)

• Xcode 12.3 (o más reciente)

• CMake 3.19 (o más reciente)

• Git 2.1 (o más reciente)

ubuntu 20.04

• apto instalar los siguientes paquetes

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

• Controlador NVIDIA (el controlador AMD e Intel es de código abierto y, por lo tanto, los controladores mesa-vulkan lo instalan automáticamente)

construir piccolo

Construir en Windows

Puede ejecutar build_windows.bat . Este archivo por lotes generará los proyectos y creará la configuración de lanzamiento de Piccolo Engine automáticamente. Después de una compilación exitosa, puede encontrar PiccoloEditor.exe en el directorio bin .

O puede usar el siguiente comando para generar el proyecto de Visual Studio primero, luego abrir la solución en el directorio de compilación y compilarla manualmente.

cmake -S . -B build

Construir en macOS

Las siguientes instrucciones de compilación solo se probaron en hardware específico de x86_64 y no son compatibles con chips M1. Para compatibilidad con M1, lo lanzaremos más adelante.

Para compilar Piccolo, debes tener instalada la versión más reciente de Xcode. Luego ejecute 'cmake' desde el directorio raíz del proyecto para generar un proyecto de Xcode.

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

y puedes construir el proyecto con

cmake --build build --config Release

O puede ejecutar build_macos.sh para compilar los binarios.

Construir en Ubuntu 20.04

Puede ejecutar build_linux.sh para compilar los binarios.

Documentación

Para obtener documentación, consulte la sección Wiki.

Extra

Capa de validación de Vulkan: error de validación

Hemos notado que algunos desarrolladores en Windows encontraron que PiccoloEditor.exe podía ejecutarse normalmente, pero informaron una excepción en la Capa de validación de Vulkan: Error de validación al depurar. Puede resolver este problema instalando Vulkan SDK (la versión oficial más reciente servirá).

Generar base de datos de compilación

Puede compilar compile_commands.json con los siguientes comandos cuando los generadores Unix Makefiles estén disponibles. compile_commands.json es el archivo requerido por el servidor de lenguaje clangd , que es un backend para cpp lsp-mode en Emacs.

Para ventanas:

 cmake -DCMAKE_TRY_COMPILE_TARGET_TYPE="STATIC_LIBRARY" -DCMAKE_EXPORT_COMPILE_COMMANDS=ON -S . -B compile_db_temp -G "Unix Makefiles"copiar compile_db_tempcompile_commands.json.

Uso del renderizador de depuración física

Actualmente, Physics Debug Renderer solo está disponible en Windows. Puede utilizar el siguiente comando para generar la solución con el proyecto del depurador.

 cmake-S. -B compilación -DENABLE_PHYSICS_DEBUG_RENDERER=ON

Nota:

1. Limpie el directorio de compilación antes de regenerar la solución. Hemos encontrado problemas de compilación al regenerar directamente con CMakeCache anterior.

2. Physics Debug Renderer se ejecutará cuando inicie PiccoloEditor. Hemos sincronizado la posición de la cámara entre ambas escenas. Pero el modo de cámara inicial en Physics Debug Renderer es incorrecto. Al desplazarse hacia abajo con la rueda del mouse una vez, la cámara de Physics Debug Renderer cambiará al modo correcto.

Construir Linux
Construir MacOS