EUI-NEO

EUI-NEO

简体中文 · Website

EUI-NEO is a cross-platform, high-performance, low-overhead C++17 UI framework with GLFW/SDL2 window backends and OpenGL/Vulkan render backends.

Preview

Quick Start

Requirements:

• CMake 3.14+
• A C++17 compiler: MSVC 19.29+ (Visual Studio 2019 16.11+), GCC/MinGW-w64 12+, or Clang 14+
• OpenGL development files for the default renderer

Add EUI-NEO under 3rd/EUI-NEO, then create:

If the GitHub clone fails, use the AtomGit mirror as a fallback:

git clone https://atomgit.com/sudoevolve/EUI-NEO.git 3rd/EUI-NEO

cmake_minimum_required(VERSION 3.14)
project(MyProject LANGUAGES C CXX)

set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)

add_subdirectory(3rd/EUI-NEO)

add_executable(my_app main.cpp)
eui_neo_configure_app(my_app)

main.cpp:

#include "eui_neo.h"

namespace app {

const DslAppConfig& dslAppConfig() {
    static const DslAppConfig config = DslAppConfig{}
        .title("My App")
        .pageId("my_app")
        .windowSize(960, 640);
    return config;
}

void compose(eui::Ui& ui, const eui::Screen& screen) {
    ui.column("root")
        .size(screen.width, screen.height)
        .padding(32.0f)
        .content([&] {
            ui.text("title")
                .text("Hello EUI-NEO")
                .fontSize(28.0f)
                .build();
        })
        .build();
}

} // namespace app

Build:

cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build --config Release --parallel

On Windows with the Visual Studio generator, run:

.\build\Release\my_app.exe

On Linux or macOS, run:

./build/my_app

eui_neo_configure_app() adds the selected GLFW/SDL2 entry point, links eui::neo, applies platform executable settings, and deploys the runtime assets. The application does not reference files under core/.

The release SDK supports the same target setup:

find_package(EuiNeo CONFIG REQUIRED)
add_executable(my_app main.cpp)
eui_neo_configure_app(my_app)

See the Integration Guide for installation, FetchContent, and SDL2/Vulkan selection. See Development And Release for building this repository and dependency requirements.

Optional Modules

Optional feature modules live under modules/ and are documented in the Modules Guide.

Project Layout

…

Docs

• DSL Design And Current Implementation
• Components
• Modules
• State Model
• Layout
• Events
• Animation
• Async
• Render Backend Architecture And Pipeline
• Retained Layer Cache
• Images
• Network
• Platform Capabilities
• Integration Guide
• Shadertoy Primitive
• Development And Release

License

EUI-NEO's original source code is licensed under the Apache License 2.0. Third-party code under 3rd/, optional build-time dependencies fetched by CMake, and bundled fonts or icon fonts under assets/ follow their respective upstream licenses and copyright notices.

Contributors

Thank you to everyone who has contributed code, improved the documentation, reported issues, or shared feedback with EUI-NEO.