A collection of bindings for popular libraries
Mostly used in computer graphics
Explore the docs »
NimGL (Nim Game Library) is a collection of bindings for popular libraries, mostly used in computer graphics. A library of libraries.
This collection of bindings is heavily inspired by LWJGL3. It enables low level access and it is not a framework, so we highly encourage you to use a game engine if you do not have experience in working with low level graphics development. These bindings contain several optional helper procedures to help with development and to better suit it to the language.
We highly recommend using a Nimble project to easily add requirements such as NimGL.
- Install Nimble, it comes preinstalled with Nim.
- Add it to your .nimble file.
requires "nimgl >= 1.0.0"- Build with nimble.
nimble build- Install Nimble, it comes preinstalled with Nim.
- Install NimGL with Nimble.
nimble install nimgl- Build with Nim.
nim c -r main.nim- Install Nimble, it comes preinstalled with Nim.
- Clone and link with Nimble in another directory.
nimble develop nimgl- Build with either Nim or Nimble.
It is currently being developed and tested on
- Windows 10
- MacOS Catalina
- Linux Ubuntu 18.10
Please refer to each binding documentation to further understand its usage.
import nimgl/[glfw, opengl]
proc keyProc(window: GLFWWindow, key: int32, scancode: int32,
action: int32, mods: int32): void {.cdecl.} =
if key == GLFWKey.ESCAPE and action == GLFWPress:
window.setWindowShouldClose(true)
proc main() =
assert glfwInit()
glfwWindowHint(GLFWContextVersionMajor, 3)
glfwWindowHint(GLFWContextVersionMinor, 3)
glfwWindowHint(GLFWOpenglForwardCompat, GLFW_TRUE) # Used for Mac
glfwWindowHint(GLFWOpenglProfile, GLFW_OPENGL_CORE_PROFILE)
glfwWindowHint(GLFWResizable, GLFW_FALSE)
let w: GLFWWindow = glfwCreateWindow(800, 600, "NimGL")
if w == nil:
quit(-1)
discard w.setKeyCallback(keyProc)
w.makeContextCurrent()
assert glInit()
while not w.windowShouldClose:
glfwPollEvents()
glClearColor(0.68f, 1f, 0.34f, 1f)
glClear(GL_COLOR_BUFFER_BIT)
w.swapBuffers()
w.destroyWindow()
glfwTerminate()
main()Your contributions truly mean the world to this project. If you are missing some
procedures, bindings or functionality feel free to open an Issue with the
specification and some example on how to properly implement it. For the
adventurous also feel free to open a Pull Request which will be greatly
appreciated.
Thank you so much 🎉
Read the Contribution Guide for more information.
| Library | Description |
|---|---|
| GLFW | Create multiple windows, handle user input (keyboard, mouse, gaming peripherals) and manage contexts. Also features multi-monitor support, clipboard access, file drag-n-drop, and much more. |
| Vulkan | A new generation graphics and compute API that provides high-efficiency, cross-platform access to modern GPUs used in a wide variety of devices from PCs and consoles to mobile phones and embedded platforms. |
| OpenGL | Open Graphics Library is a cross-language, cross-platform application programming interface for rendering 2D and 3D vector graphics. NimGL only supports modern OpenGL. |
| ImGUI | Dear ImGui is a bloat-free graphical user interface library for C++. It outputs optimized vertex buffers that you can render anytime in your 3D-pipeline enabled application. |
Please let me know if you want to be showcased or removed from here.
chip-8 emulator by @kraptor
Developed by Leonardo Mariscal and all the amazing contributors in GitHub.
Heavily inspired by LWJGL3 and GLAD.
Each binding contains a small credits comment at the top of the file, but in general thank you to every contributor of each individual library used in this project 🌹.
NimGL is open source and is under the MIT License, we highly encourage every developer that uses it to make improvements and fork them here.