Piccolo

Piccolo Engine (anteriormente Pilot Engine)

Pré-requisitos

Para construir o Piccolo, você deve primeiro instalar as seguintes ferramentas.

Janelas 10/11

• Visual Studio 2019 (ou mais recente)

• CMake 3.19 (ou mais recente)

• Git 2.1 (ou mais recente)

macOS >= 10.15 (x86_64)

• Xcode 12.3 (ou mais recente)

• CMake 3.19 (ou mais recente)

• Git 2.1 (ou mais recente)

Ubuntu 20.04

• apt instale os seguintes pacotes

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 (o driver AMD e Intel é de código aberto e, portanto, é instalado automaticamente pelos drivers mesa-vulkan)

Construir Piccolo

Construir no Windows

Você pode executar build_windows.bat . Este arquivo em lote irá gerar os projetos e construir a configuração de lançamento do Piccolo Engine automaticamente. Após a compilação bem-sucedida, você pode encontrar o PiccoloEditor.exe no diretório bin .

Ou você pode usar o seguinte comando para gerar o projeto do Visual Studio primeiro e, em seguida, abrir a solução no diretório de construção e compilá-la manualmente.

cmake -S . -B build

Crie no macOS

As instruções de construção a seguir foram testadas apenas em hardware específico de x86_64 e não oferecem suporte a chips M1. Para compatível com M1, lançaremos mais tarde.

Para compilar o Piccolo, você deve ter a versão mais recente do Xcode instalada. Em seguida, execute 'cmake' no diretório raiz do projeto, para gerar um projeto do Xcode.

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

e você pode construir o projeto com

cmake --build build --config Release

Ou você pode executar build_macos.sh para construir os binários.

Construir no Ubuntu 20.04

Você pode executar build_linux.sh para construir os binários.

Documentação

Para documentação, consulte a seção Wiki.

Extra

Camada de validação Vulkan: erro de validação

Notamos que alguns desenvolvedores no Windows encontraram que PiccoloEditor.exe poderia ser executado normalmente, mas relataram uma exceção Camada de validação Vulkan: Erro de validação durante a depuração. Você pode resolver esse problema instalando o Vulkan SDK (a versão oficial mais recente serve).

Gerar banco de dados de compilação

Você pode construir compile_commands.json com os seguintes comandos quando os geradores Unix Makefiles estiverem disponíveis. compile_commands.json é o arquivo exigido pelo servidor de linguagem clangd , que é um backend para o modo cpp lsp no Emacs.

Para Windows:

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

Usando o renderizador de depuração de física

Atualmente, o Physics Debug Renderer está disponível apenas no Windows. Você pode usar o comando a seguir para gerar a solução com o projeto do depurador.

 cmake -S . -B compilação -DENABLE_PHYSICS_DEBUG_RENDERER=ON

Observação:

1. Limpe o diretório de construção antes de regenerar a solução. Encontramos problemas de construção na regeneração direta com o CMakeCache anterior.

2. O Physics Debug Renderer será executado quando você iniciar o PiccoloEditor. Sincronizamos a posição da câmera entre as duas cenas. Mas o modo inicial da câmera no Physics Debug Renderer está errado. Rolar a roda do mouse uma vez mudará a câmera do Physics Debug Renderer para o modo correto.

Construir Linux
Construir macOS