mirror of
https://github.com/cocos/cocos4.git
synced 2026-11-21 08:02:39 +08:00
62d8b4daae
The operation of swapping (presenting) buffers is done in gfx::Device::present. To swap multi-systemwindows, multiple gfx swapchains need be created, and relevant gfx backend will iterate each swapchain and present them. Therefore, `swap buffers` operation doesn't need to be in SystemWindow or SystemWindowManager.
```c++
void GLES3Device::present() {
CC_PROFILE(GLES3DevicePresent);
auto *queue = static_cast<GLES3Queue *>(_queue);
_numDrawCalls = queue->_numDrawCalls;
_numInstances = queue->_numInstances;
_numTriangles = queue->_numTriangles;
bool isGFXDeviceNeedsPresent = _xr ? _xr->isGFXDeviceNeedsPresent(_api) : true;
for (auto *swapchain : _swapchains) { // We iterate each swapchain and do the present thing here.
if (isGFXDeviceNeedsPresent) _gpuContext->present(swapchain);
}
if (_xr) _xr->postGFXDevicePresent(_api);
// Clear queue stats
queue->_numDrawCalls = 0;
queue->_numInstances = 0;
queue->_numTriangles = 0;
}
```
Besides, `SDL_GL_SwapWindow` invocation is doing nothing on Windows & Linux platforms, it will generate an SDL an error that `The specified window isn't an OpenGL window` because GL context is not created by SDL_GL_CreateContext. We create contexts in our gfx code.
https://github.com/libsdl-org/SDL/blob/main/src/video/SDL_video.c#L4192
```c++
#define NOT_AN_OPENGL_WINDOW "The specified window isn't an OpenGL window"
int
SDL_GL_SwapWindowWithResult(SDL_Window * window)
{
CHECK_WINDOW_MAGIC(window, -1);
if (!(window->flags & SDL_WINDOW_OPENGL)) {
return SDL_SetError(NOT_AN_OPENGL_WINDOW);
}
if (SDL_GL_GetCurrentWindow() != window) {
return SDL_SetError("The specified window has not been made current");
}
return _this->GL_SwapWindow(_this, window);
}
void
SDL_GL_SwapWindow(SDL_Window * window)
{
SDL_GL_SwapWindowWithResult(window);
}
```
Also, SDL_GL_SwapWindow could not take any effect if running on gfx Vulkan backend.
```c++
void SDLHelper::swapWindow(SDL_Window *window) {
SDL_GL_SwapWindow(window);
}
```
cocos-engine native part
It is the native backend of Cocos Creator. It works on iOS, Android, macOS and Windows.
Coding format and coding style
The coding format file is .clang-format, and the coding style format file is .clang-tidy. Please use clang-format to format the codes and use clang-tidy to fix the coding style before committing codes. See the linter auto-fix guide for more information.
Build Requirements
- Xcode 11.5+ to build mac games
- or Visual Studio 2017 15.7+ / Visual Studio 2019 to build win64 games
- NDK 21-22 is required to build Android games (23+ is not supported)
- Cmake 3.8+ is required
System Requirements
- macOS 10.14+
- iOS 11.0+
- iOS Simulator 13.0+
- 64-bit Windows 7+
- with vulkan 1.0 to 1.2 if want to run with vulkan
- Android 4.4+
- Android 7+ if want to run with vulkan
C++ related
Use C++17.
These C++17 features are tested and supported by all platforms
std::string_viewconstexpr if
The following features are not supported
std::optionalis not supported by iOS 11.
Other C++17 features are not tested.