EasyWin32 - C++ wrapper for Win32 window management

Warning

This project is in development. The API is unstable, features may be added or removed, and breaking changes are likely to occur frequently and without notice as the design is refined.

Overview

EasyWin32 is a lightweight, header-only C++ wrapper for Win32 window management, designed for scenarios where cross-platform compatibility is not required. It is ideal for rapid prototyping and quick result previews during the development stage.

Key Features:

• Header-only and lightweight: EasyWin32 requires no additional libraries or dependencies, making integration simple and efficient.
• Fine-grained event handling: Offers more detailed control over Win32 events than libraries like GLFW, allowing developers to handle window messages with greater precision.
• High code readability: The API is developer-friendly and easy to understand, making maintenance and extension straightforward.

Installation

Prerequisites

• CMake (version 3.10 or above)
• C++17 compatible compiler

Build Instructions

git clone https://github.com/WenchaoHuang/EasyWin32.git
cd EasyWin32
mkdir build
cd build
cmake ..

Example:

#define EZWIN32_IMPLEMENTATION
#include "easywin32.h"

EzWindow myWindow;
myWindow.setTitle(L"EasyWin32");
myWindow.setPos(100, 100, 900, 700);
myWindow.setStyle(EzStyle::Overlapped);
myWindow.open();
myWindow.show();

// Setup callbacks
myWindow.onKeyboardPress = [&](EzKey key, EzKeyAction action)
{
    if ((key == EzKey::Escape) && (action == EzKeyAction::Press))
    {
        myWindow.close();
    }

    return 0;
};

// Main loop
while (myWindow.isOpen())
{
    if (!myWindow.processEvent())
    {
        std::this_tread::sleep_for(1ms);  // lazy wait
    }
}

License

EasyWin32 is distributed under the terms of the MIT License.