ImGui-Beef
November 26, 2020 ยท View on GitHub
imgui-beef is a Beef wrapper library for Dear ImGui v1.75
Attention! This binding is still in development, bugs may occur.
This wrapper currently uses cimgui bindings, since I couldn't wrap the c++ api of ImGui because of the hidden "bf" namespace when using [StdCall] property.
IMPORTANT CAVEAT!
As of the current Beef version (0.42.3) the SDL bindings need two modifications to work properly with the official SDL bindings included with Beef. These modifications will be part of the 0.42.4 release:
What is done
- Bindings for:
- The main ImGui API more or less complete
- Several ImGui structs used for communicating with ImGui
- Windowing / Input backends:
- SDL, converted to Beef based on offical ImGui implementation. Needs offical SDL Beef bindings.
- GLFW, converted to Beef based on offical ImGui implementation. Needs GLFW Beef bindings: https://github.com/MineGame159/glfw-beef
- Rendering backends:
- SDL Renderer, converted to Beef based on: https://github.com/Tyyppi77/imgui_sdl
- OpenGL3, converted to Beef based on offical ImGui implementation with slight change to initialization.
TODO:
- Finish bindings for main ImGui structs and their public API
- Windowing / Input backends:
- Allegro 5
- GLUT/FreeGLUT
- OSX / Cocoa
- Windows API
- Rendering backends:
- DirectX9
- DirectX10
- DirectX11
- DirectX12
- Metal
- OpenGL2
- Vulkan
- Combined backends:
- Marmalade + IwGx
Quick Start (using Beef IDE)
- Download imgui-beef and copy the main project and the backend projects here: C:\Program Files\BeefLang\BeefLibs.
- Right-click on your workspace and select Add from Installed and choose imgui-beef + your desired backends.
- Make imgui-beef + your desired backends as a dependency of your project.
Tip & Tricks
- You should make your workspace looks like this
Workspace-Folder\
|__ Project1\
|__ Project2\
|__ Project3\
|__ imgui-beef\
|__ imgui-impl-sdl-beef\
|__ imgui-impl-sdl-renderer-beef\
|__ some-other-lib\
More Info
- Thank you for M0n7y5, whose raylib bindings' readme structure gave heavy inspiration for this readme document.
- For any questions, I'm usually lurking in BeefLang discord channel: https://discord.gg/rnsc9YP
Contribution
I'll be glad for any contribution & pull requests