Eshi 🧑‍🎨 (絵師)

A high-performance, hybrid CPU/GPU shader engine and video generator.

Warp

🖼️ Showcase

Deep Sea	Fractal	Polar
Raymarch	Ripple	Starfield
Tzozen	Voronoi	Bubbles

Eshi (Japanese for "painter" or "artist") is a minimal C++ framework that turns mathematical formulas into video. It allows you to write GLSL-style logic directly in C++, rendering procedural art to high-quality video files (.mp4) or a live window preview.

"Painting pixels with math." 🥴🍹💫 -me

---

🎨 Origins & Credits

This project is heavily inspired by and builds upon the foundational concepts of Tzozen's checker.c.

Eshi evolves this concept by embedding the encoding pipeline directly into the application, supporting multi-threaded CPU rendering (OpenMP), GPU acceleration (CUDA & OpenGL), and live previews (SDL2).

---

✨ Features

• Hybrid Rendering: Seamlessly switch between CPU (OpenMP), GPU (CUDA), and GPU (OpenGL) rendering engines.
• Live Preview: Tweak your shaders in real-time with an SDL2 window (--live).
• Zero-IO Video: Renders directly to H.264 (.mp4) in memory using linked FFmpeg libraries.
• Modern CLI: Beautiful terminal UI powered by Gum.
• C++ Shaders: A robust math library (glsl_core.h) that emulates GLSL types (vec2, vec4) and intrinsics in standard C++.
• Arm64 Support: Native compilation and hardware acceleration on Windows on Arm (Snapdragon) devices.

---

🛠️ Build & Dependencies

🐧 Linux (Debian/Ubuntu/Arch)

1. System Libraries:

# Core Dependencies
sudo apt install pkg-config libavcodec-dev libavformat-dev libavutil-dev libswscale-dev libomp-dev libsdl2-dev

# Install Gum (for the CLI dashboard)
sudo mkdir -p /etc/apt/keyrings
curl -fsSL [https://repo.charm.sh/apt/gpg.key](https://repo.charm.sh/apt/gpg.key) | sudo gpg --dearmor -o /etc/apt/keyrings/charm.gpg
echo "deb [signed-by=/etc/apt/keyrings/charm.gpg] [https://repo.charm.sh/apt/](https://repo.charm.sh/apt/) * *" | sudo tee /etc/apt/sources.list.d/charm.list
sudo apt update && sudo apt install gum

2. Compile:

make -j$(nproc)

(Note: If nvcc is found in your PATH, Eshi automatically compiles with CUDA support.)

Troubleshooting CUDA Paths: If the build fails with /usr/bin/ld: cannot find -lcudart, your CUDA installation may be in a non-standard location (common on Arch/CachyOS). You can fix this by editing the CUDA_PATH_LINUX variable at the top of the Makefile, or by passing it directly to make:

# Example for Arch Linux / CachyOS
make CUDA_PATH_LINUX=/opt/cuda -j$(nproc)

🪟 Windows (x64)

1. Prerequisites:

• Visual Studio (MSVC C++ Compiler)
• CUDA Toolkit (Must be installed and nvcc reachable)
• vcpkg package manager

2. Install Dependencies: Open a terminal in the project root and run:

vcpkg install --triplet x64-windows

3. Configure & Compile:

1. Open build_all.bat in a text editor.
2. Update VCPKG_ROOT and CUDA_PATH variables.
3. Run build_all.bat.

🐲 Windows (Arm64 / Snapdragon)

1. Prerequisites:

• Visual Studio 2022 (Ensure "ARM64 build tools" are installed)
• vcpkg package manager
• OpenCL™ and OpenGL® Compatibility Pack (Install from Microsoft Store to enable Adreno GPU support)

2. Install Dependencies: Open a terminal in the project root and run:

vcpkg install --triplet arm64-windows

3. Configure & Compile:

1. Open the ARM64 Native Tools Command Prompt for VS 2022.
2. Open build.arm64.bat and update VCPKG_ROOT.
3. Run the build script:

   build.arm64.bat

4. Executables will be generated in build/.

---

🚀 Usage

1. The Interactive Dashboard (Recommended)

The easiest way to run demos is with the beautified shell script (Linux/WSL only currently):

./run_demos.sh

This launches a GUI-like menu in your terminal to select CPU/GPU modes and shows progress bars for renders.

2. Manual CLI

You can also run the built binaries directly from the build/ folder:

Render to Video:

# Linux
./build/deepsea
# Windows
.\build\deepsea.exe

# Output: deepsea.mp4 (in build/)

Live Preview:

./build/deepsea --live
# Opens a window. Press ESC to close.

Options:

• --gpu: Use hardware acceleration (CUDA on x64, OpenGL on Arm64).
• --live: Render to window instead of file.
• --res WxH: Set resolution (e.g., --res 1920x1080). Default is 960x540.

---

🧑‍💻 Writing Shaders

Define your art in shader.cpp using the mainImage function (Shadertoy style):

void mainImage(vec4 &fragColor, vec2 fragCoord, vec2 iResolution, float iTime) {
    vec2 uv = fragCoord / iResolution.y;
    // ... your GLSL logic here ...
    fragColor = vec4(uv.x, uv.y, 0.5f + 0.5f*sinf(iTime), 1.0f);
}

Rebuild to update the binary.

---

🏛️ License

This project retains the MIT License of the original code.

---

📝 Finally

З.Ы. Если вы дочитали до этого места, буду благодарен за звезду!

---

🥂 За здоровье!