RayMap v1.1.0

[grerfou]

raymap

raymap is a simple and easy-to-use projection mapping and surface warping library for raylib.

raymap provides tools to warp rectangular surfaces into arbitrary quadrilaterals using bilinear
interpolation or perspective-correct homography. Designed for video mapping installations,
multi-projector setups and interactive surfaces.

NOTE: raymap is a header-only library, just copy raymap.h into your project and define
RAYMAP_IMPLEMENTATION in one .c file before including it. Ready to use!

#define RAYMAP_IMPLEMENTATION
#include "raymap.h"

• Header-only, no build system required
• Bilinear and homography-based surface warping
• Interactive corner calibration with mouse drag
• Configuration save/load (text format)
• Point mapping utilities (screen ↔ texture space)
• Optional FFmpeg video extension (raymapvid.h)
• Written in plain C99, zlib/libpng license

dependencies

raymap.h

• raylib 5.0+

raymapvid.h (optional)

• FFmpeg 4.4+ (libavcodec, libavformat, libavutil, libswscale)

installation (Ubuntu/Debian)

sudo apt install libraylib-dev

# For video support
sudo apt install libavcodec-dev libavformat-dev libavutil-dev libswscale-dev

installation (macOS)

brew install raylib

# For video support
brew install ffmpeg

basic usage

#include "raylib.h"

#define RAYMAP_IMPLEMENTATION
#include "raymap.h"

int main(void)
{
    InitWindow(1920, 1080, "raymap - minimal example");

    RM_Surface *surface = RM_CreateSurface(800, 600, RM_MAP_HOMOGRAPHY);
    RM_Calibration calib = RM_CalibrationDefault(surface);

    while (!WindowShouldClose())
    {
        RM_UpdateCalibrationInput(&calib, KEY_C);

        RM_BeginSurface(surface);
            ClearBackground(DARKBLUE);
            DrawText("Hello raymap!", 200, 250, 60, WHITE);
        RM_EndSurface(surface);

        BeginDrawing();
            ClearBackground(BLACK);
            RM_DrawSurface(surface);
            RM_DrawCalibration(calib);
        EndDrawing();
    }

    RM_DestroySurface(surface);
    CloseWindow();
    return 0;
}

Compile:

gcc example.c -o example -lraylib -lm

Controls: C toggle calibration · Mouse drag corners

examples

cd examples/core
make

example	description
01_minimal_surface	basic surface creation and rendering
02_basic_warping	bilinear vs homography comparison
03_interactive_calibration	full calibration workflow with save/load
04_mesh_resolution	mesh resolution vs quality trade-off
05_point_mapping	screen ↔ texture coordinate mapping

video extension

#define RAYMAP_IMPLEMENTATION
#include "raymap.h"
#include "raymapvid.h"

RMV_Video *video = RMV_LoadVideo("content.mp4");
RMV_SetVideoLoop(video, true);
RMV_PlayVideo(video);

// in main loop:
RMV_UpdateVideo(video, GetFrameTime());
RM_BeginSurface(surface);
    DrawTexture(RMV_GetVideoTexture(video), 0, 0, WHITE);
RM_EndSurface(surface);

Compile with video support:

gcc example.c -o example -lraylib -lm -lavcodec -lavformat -lavutil -lswscale

api reference

Full API documentation available in docs/API.md.

license

raymap is licensed under the zlib/libpng license, same as raylib.

Copyright (c) 2026 grerfou

FFmpeg notice: raymapvid.h uses FFmpeg libraries (LGPL 2.1+) via dynamic linking.

---

This discussion was created from the release RayMap v1.1.0.