1 Star 0 Fork 0

ZED/Piccolo

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
贡献代码
同步代码
Loading...
README
MIT

Piccolo Engine (formerly Pilot Engine)

Piccolo Engine logo

Piccolo Engine is a tiny game engine used for the GAMES104 course.

Continuous build status

Build Type Status
Build Windows Build Windows
Build Linux Build Linux
Build macOS Build macOS

Prerequisites

To build Piccolo, you must first install the following tools.

Windows 10/11

  • Visual Studio 2019 (or more recent)
  • CMake 3.19 (or more recent)
  • Git 2.1 (or more recent)

macOS >= 10.15 (x86_64)

  • Xcode 12.3 (or more recent)
  • CMake 3.19 (or more recent)
  • Git 2.1 (or more recent)

Ubuntu 20.04

  • apt install the following packages
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 driver (The AMD and Intel driver is open-source, and thus is installed automatically by mesa-vulkan-drivers)

Build Piccolo

Build on Windows

You may execute the build_windows.bat. This batch file will generate the projects, and build the Release config of Piccolo Engine automatically. After successful build, you can find the PiccoloEditor.exe at the bin directory.

Or you can use the following command to generate the Visual Studio project firstly, then open the solution in the build directory and build it manually.

cmake -S . -B build

Build on macOS

The following build instructions only tested on specific hardware of x86_64, and do not support M1 chips. For M1 compatible, we will release later.

To compile Piccolo, you must have the most recent version of Xcode installed. Then run 'cmake' from the project's root directory, to generate a project of Xcode.

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

and you can build the project with

cmake --build build --config Release

Or you can execute the build_macos.sh to build the binaries.

Build on Ubuntu 20.04

You can execute the build_linux.sh to build the binaries.

Documentation

For documentation, please refer to the Wiki section.

Extra

Vulkan Validation Layer: Validation Error

We have noticed some developers on Windows encounted PiccoloEditor.exe could run normally but reported an exception Vulkan Validation Layer: Validation Error when debugging. You can solve this problem by installing Vulkan SDK (official newest version will do).

Generate Compilation Database

You can build compile_commands.json with the following commands when Unix Makefiles generaters are avaliable. compile_commands.json is the file required by clangd language server, which is a backend for cpp lsp-mode in Emacs.

For Windows:

cmake -DCMAKE_TRY_COMPILE_TARGET_TYPE="STATIC_LIBRARY" -DCMAKE_EXPORT_COMPILE_COMMANDS=ON -S . -B compile_db_temp -G "Unix Makefiles"
copy compile_db_temp\compile_commands.json .

Using Physics Debug Renderer

Currently Physics Debug Renderer is only available on Windows. You can use the following command to generate the solution with the debugger project.

cmake -S . -B build -DENABLE_PHYSICS_DEBUG_RENDERER=ON

Note:

  1. Please clean the build directory before regenerating the solution. We've encountered building problems in regenerating directly with previous CMakeCache.
  2. Physics Debug Renderer will run when you start PiccoloEditor. We've synced the camera position between both scenes. But the initial camera mode in Physics Debug Renderer is wrong. Scrolling down the mouse wheel once will change the camera of Physics Debug Renderer to the correct mode.
Copyright (c) 2022 Contributors to the Piccolo Engine Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

简介

暂无描述 展开 收起
MIT
取消

发行版

暂无发行版

近期动态

1年多前推送了新的提交到 master 分支,6933e8f...e65eb5e
1年多前推送了新的 master 分支
1年多前创建了仓库
不能加载更多了
马建仓 AI 助手
尝试更多
代码解读
代码找茬
代码优化
1
https://gitee.com/ZED9587/Piccolo.git
git@gitee.com:ZED9587/Piccolo.git
ZED9587
Piccolo
Piccolo
main

搜索帮助