CrossWindow-Graphics

A header only library to simplify creating and managing data structures needed for graphics APIs such as a Vulkan vk::Surface, an OpenGL context, a DirectX IDXGISwapChain1, or Metal CAMetalLayer.

Supports

• 🌋 Vulkan
• ⚪ OpenGL
• ⚪ OpenGL ES
• 🌐 WebGL
• ❎ DirectX 12.x
• ✖️ DirectX 11.x
• 🤖 Metal

Installation

First add the repo as a submodule in your dependencies folder such as external/:

cd external
git submodule add https://github.com/alaingalvan/crosswindow-graphics.git

Then in your CMakeLists.txt file, include the following:

add_subdirectory(external/crosswindow-graphics)
target_link_libraries(
${PROJECT_NAME}CrossWindowGraphics
)

Usage

#include"CrossWindow/CrossWindow.h"
#include"CrossWindow/Graphics.h"voidxmain(int argc, char** argv)
{
// 🖼️ Create your xwin::Window...
xwin::Window window;
// ...
#if defined(XGFX_VULKAN)
// 🌋 Vulkan Surface
vk::Surface surface = xwin::createSurface(&window, instance);
#elif defined(XGFX_OPENGL)
// ⚪ OpenGL / OpenGL ES / 🌐 WebGL platform specific context data
xgfx::OpenGLDesc desc;
xgfx::OpenGLState state = xgfx::createContext(&window, desc);
// ⬇️ Set the contextxgfx::setContext(state);
// 🔀 Refresh your windowxgfx::swapBuffers(state);
// ⬆️ Unset the contextxgfx::unsetContext(state);
// ⬅️ Destroy the contextxgfx::destroyContext(state);
#elif defined(XGFX_DIRECTX12)
// ❎ DirectX 12.x Swapchain
IDXGISwapChain1* swapchain = xgfx::createSwapchain(window, factory, commandQueue, &swapchainDesc);
#elif defined(XGFX_DIRECTX11)
// ✖️ DirectX 11.x Swapchain
IDXGISwapChain* swapchain = xgfx::createSwapchain(window, factory, device, &swapchainDesc);
#elif defined(XWIN_METAL)
// 🤖 Metal Layerxgfx::createMetalLayer(&window);
// 🍮 Access the layer from your window
CAMetalLayer* layer = (CAMetalLayer*)window.layer;
#endif
}

Preprocessor Definitions

CMake Options	Description
XGFX_API	The graphics API you're targeting, defaults to VULKAN, can be can be VULKAN, OPENGL, DIRECTX12, METAL, or NONE.

Alternatively you can set the following preprocessor definitions manually:

Definition	Description
XGFX_VULKAN	Vulkan
XGFX_OPENGL	OpenGL / OpenGL ES / WebGL
XGFX_DIRECTX12	DirectX 12.x
XGFX_DIRECTX11	DirectX 11.x
XGFX_METAL	Metal

Design Decisions

The official Khronos Group's Vulkan Samples features an OpenGL driver info example and Vulkan cube example that the OpenGL/Vulkan portions of this library pull heavily from, but diverges with the decision to separate operating systems by protocol (similar to the design of CrossWindow).

You can read more in our docs.

License

CrossWindow is licensed as either MIT or Apache-2.0, whichever you would prefer.