A collection of bindings for popular libraries
Mostly used in computer graphics
Explore the docs »

• About
• Getting Started
  • Installation
  • Usage
  • Green Window Example
• Contribute
• Supported Bindings
• Roadmap
• Gallery
• Contact
• Credits
• License

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 working with low level graphics development. This bindings contain several optional helper procedures to help with the development and to better suit it to the language.

We highly recommend using a Nimble project to easily add requirements such as NimGL.

1. Install Nimble, it comes pre installed with Nim. If you want to use the development NimGL version you must use a version older than 0.10.2, specifically anything after hash 7c2b9f6
2. Directly install via Nimble

nimble install nimgl # nimgl@#1.0 to use the development version

3. (Optional) Add it to your .nimble file

requires "nimgl >= 0.3.6" # nimgl >= 1.0.0 if using the development version

It is currently being developed and tested on

• Windows 10
• MacOS Mojave
• Linux Ubuntu 18.10

Please refer to each binding documentation to further understand its usage.

import nimgl/[glfw, opengl]

proc keyProc(window: GLFWWindow, key: GLFWKey, scancode: int32,
             action: GLFWKeyAction, mods: GLFWKeyMod): void {.cdecl.} =
  if key == keyESCAPE and action == kaPress:
    window.setWindowShouldClose(true)

proc main() =
  assert glfwInit()

  glfwWindowHint(whContextVersionMajor, 3)
  glfwWindowHint(whContextVersionMinor, 2)
  glfwWindowHint(whOpenglForwardCompat, GLFW_TRUE) # Used for Mac
  glfwWindowHint(whOpenglProfile, GLFW_OPENGL_CORE_PROFILE)
  glfwWindowHint(whResizable, 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.

Goals for before June of 2020:

• Implement automatic generation for all bindings, if not possible at least facilitate its manual modification.
• Add better documentation for each binding.
• Add Vulkan into the mixture.
• Create optional helper functions for each binding to further facilitate development.
• Make a thesis paper in Spanish and do my best to translate it to English.
• CI integration with Travis

You can read a small post about the future of the project here.

Please let me know if you want to be showcased or removed from here.

chip-8 emulator by @kraptor

Leonardo Mariscal - @thelmariscal - leo at ldmd dot mx

You can also contact me through the official Nim IRC channel FreeNode#nim as lmariscal where I will be notified.

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 🌹.

MIT License.

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.