Skip to content

A simple and easy-to-use library to enjoy videogames programming, Experimental support for multiple monitors.

License

Notifications You must be signed in to change notification settings

raylib-extras/raylib_multi_window_experimental

 
 

Repository files navigation

Multi-Window Fork.

This is an experimental fork of raylib 5.0 that supports multiple windows. See the example 'core-multi-window' for info on how to create multiple windows (up to 4) There are changes to the API that are not compatible with base raylib, and signifigant limitations to how windows are used and managed. This fork is not automatically synced with mainline raylib and is manually updated when time allows. Use this code at your own risk, testing is minimal.

Useage

Call InitWindowPro instead of InitWindow. It will return a window ID. For multiple windows call InitWindowPro multiple times. The return value from InitWindowPro must be saved by the application for use in other API calls. To set the active window, call SetActiveWindowContext with the window ID of the window you want to use. This redirects all raylib and OpenGL calls to the window you specify. Call SetActiveWindowContext anytime you want to change windows.

Limitations

  • The max number of windows is hardcoded in config.h with a #define. The default is 4
  • Every window has it's own OpenGL context, thus must load it's own textures, shaders, and models. Textures, shaders, and models loaded in one window context will not be availabie in a different window context. Thus you must call LoadTexture for every window that needs a texture, even if it's the same file used in another window.
  • Only the first window gets input.
  • WindowShouldClose works on the active window, if you have multiple windows you need to check it for each window and choose when you want to exit your game loop.
  • Is is your job to know what windows are open and closed.
  • Only the call to EndDrawing for the first window will process the thread sleep/wait for any FPS counters. It is best to process the first window last.

Raylib Readme

**raylib is a simple and easy-to-use library to enjoy videogames programming.**

raylib is highly inspired by Borland BGI graphics lib and by XNA framework and it's especially well suited for prototyping, tooling, graphical applications, embedded systems and education.

NOTE for ADVENTURERS: raylib is a programming library to enjoy videogames programming; no fancy interface, no visual helpers, no debug button... just coding in the most pure spartan-programmers way.

Ready to learn? Jump to code examples!



GitHub Releases Downloads GitHub Stars GitHub commits since tagged version GitHub Sponsors Packaging Status License

Discord Members Subreddit Subscribers Youtube Subscribers Twitch Status

Windows Linux macOS WebAssembly

CMakeBuilds Windows Examples Linux Examples

features

  • NO external dependencies, all required libraries are bundled into raylib
  • Multiple platforms supported: Windows, Linux, MacOS, RPI, Android, HTML5... and more!
  • Written in plain C code (C99) using PascalCase/camelCase notation
  • Hardware accelerated with OpenGL (1.1, 2.1, 3.3, 4.3, ES 2.0, ES 3.0)
  • Unique OpenGL abstraction layer (usable as standalone module): rlgl
  • Multiple Fonts formats supported (TTF, OTF, Image fonts, AngelCode fonts)
  • Multiple texture formats supported, including compressed formats (DXT, ETC, ASTC)
  • Full 3D support, including 3D Shapes, Models, Billboards, Heightmaps and more!
  • Flexible Materials system, supporting classic maps and PBR maps
  • Animated 3D models supported (skeletal bones animation) (IQM, M3D, glTF)
  • Shaders support, including model shaders and postprocessing shaders
  • Powerful math module for Vector, Matrix and Quaternion operations: raymath
  • Audio loading and playing with streaming support (WAV, QOA, OGG, MP3, FLAC, XM, MOD)
  • VR stereo rendering support with configurable HMD device parameters
  • Huge examples collection with +140 code examples!
  • Bindings to +70 programming languages!
  • Free and open source

basic example

This is a basic raylib example, it creates a window and draws the text "Congrats! You created your first window!" in the middle of the screen. Check this example running live on web here.

#include "raylib.h"

int main(void)
{
    InitWindow(800, 450, "raylib [core] example - basic window");

    while (!WindowShouldClose())
    {
        BeginDrawing();
            ClearBackground(RAYWHITE);
            DrawText("Congrats! You created your first window!", 190, 200, 20, LIGHTGRAY);
        EndDrawing();
    }

    CloseWindow();

    return 0;
}

build and installation

raylib binary releases for Windows, Linux, macOS, Android and HTML5 are available at the Github Releases page.

raylib is also available via multiple package managers on multiple OS distributions.

Installing and building raylib on multiple platforms

raylib Wiki contains detailed instructions on building and usage on multiple platforms.

Note that the Wiki is open for edit, if you find some issues while building raylib for your target platform, feel free to edit the Wiki or open an issue related to it.

Setup raylib with multiple IDEs

raylib has been developed on Windows platform using Notepad++ and MinGW GCC compiler but it can be used with other IDEs on multiple platforms.

Projects directory contains several ready-to-use project templates to build raylib and code examples with multiple IDEs.

Note that there are lots of IDEs supported, some of the provided templates could require some review, so please, if you find some issue with a template or you think they could be improved, feel free to send a PR or open a related issue.

learning and docs

raylib is designed to be learned using the examples as the main reference. There is no standard API documentation but there is a cheatsheet containing all the functions available on the library a short description of each one of them, input parameters and result value names should be intuitive enough to understand how each function works.

Some additional documentation about raylib design can be found in raylib GitHub Wiki. Here are the relevant links:

contact and networks

raylib is present in several networks and raylib community is growing everyday. If you are using raylib and enjoying it, feel free to join us in any of these networks. The most active network is our Discord server! :)

contributors

license

raylib is licensed under an unmodified zlib/libpng license, which is an OSI-certified, BSD-like license that allows static linking with closed source software. Check LICENSE for further details.

raylib uses internally some libraries for window/graphics/inputs management and also to support different file formats loading, all those libraries are embedded with and are available in src/external directory. Check raylib dependencies LICENSES on raylib Wiki for details.

About

A simple and easy-to-use library to enjoy videogames programming, Experimental support for multiple monitors.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C 84.3%
  • Lua 9.0%
  • Makefile 2.8%
  • CMake 1.4%
  • HTML 0.7%
  • Shell 0.7%
  • Other 1.1%