https://github.com/sbarisic/nukleardotnet

.NET binding for the Nuklear immediate mode GUI
https://github.com/sbarisic/nukleardotnet

binding csharp dotnet dotnet-framework gui imgui nuklear pinvoke

Last synced: 6 days ago
JSON representation

.NET binding for the Nuklear immediate mode GUI

• Host: GitHub
• URL: https://github.com/sbarisic/nukleardotnet
• Owner: sbarisic
• License: other
• Created: 2018-01-09T02:45:19.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2023-12-26T13:27:25.000Z (almost 1 year ago)
• Last Synced: 2024-11-23T13:28:18.911Z (about 1 month ago)
• Topics: binding, csharp, dotnet, dotnet-framework, gui, imgui, nuklear, pinvoke
• Language: C#
• Size: 5.39 MB
• Stars: 188
• Watchers: 13
• Forks: 15
• Open Issues: 9
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# NuklearDotNet

LICENSE: Dual-licensed under MIT and The Unlicense. Your choice.

.NET binding for the Nuklear immediate mode GUI

https://github.com/vurtun/nuklear

NuklearSharp ( https://github.com/leafi/NuklearSharp ) was my original inspiration for this.

No original nuklear source files were modified. A project was created with some support code 

to build Nuklear.dll (x64) with all API functions exported and ready to be used from .NET

Updating should be as easy as updating the submodule and rebuilding the project.

Currently this binding is used in my game engine project, so i implement stuff as i need it.

https://github.com/sbarisic/libTech

Contributions welcome.

# Implemented devices

* Raylib

In the example project, this binding was directly included

https://github.com/ChrisDill/Raylib-cs

* SFML

# Screenshots

![alt text](https://raw.githubusercontent.com/sbarisic/NuklearDotNet/master/screenshots/a.png "Hello World!")

# Code samples

The custom device class implements actual drawing functions,

it has to inherit from at least NuklearDevice.

NuklearDeviceTex allows you to specify your custom texture class which

replaces the internal texture handle integers, just for convenience. You can return

your own texture handle integers in NuklearDevice and handle textures manually.

Optionally it can implement the IFrameBuffered interface which calls the Render

function only when the GUI actually changes. It it supposed to be rendered to a framebuffer

which is in turn rendered to the screen every frame in RenderFinal

```cs

class Device : NuklearDeviceTex, IFrameBuffered {

	public override Texture CreateTexture(int W, int H, IntPtr Data) {

		// Create a texture from raw image data

		return null;

	}

	void IFrameBuffered.BeginBuffering() {

		// Begin rendering to framebuffer

	}

	

	public override void SetBuffer(NkVertex[] VertexBuffer, ushort[] IndexBuffer) {

		// Called once before Render, upload your vertex buffer and index buffer here

	}

	public override void Render(NkHandle Userdata, Texture Texture, NkRect ClipRect, uint Offset, uint Count) {

		// Render to either framebuffer or screen

		// If IFrameBuffered isn't implemented, it's called every frame, else only when the GUI actually changes

		// Called multiple times per frame, uses the vertex and index buffer that has been sent to SetBuffer

	}

	void IFrameBuffered.EndBuffering() {

		// End rendering to frame buffer

	}

	void IFrameBuffered.RenderFinal() {

		// Called each frame, render to screen finally

	}

}

```

Sending events; just call these when you capture the events from your input API. It's irrelevant when they're called.

They are internally queued and dispatched to Nuklear on every frame.

```cs

	Device.OnMouseButton(Button, X, Y, Down)

	Device.OnMouseMove(X, Y)

	Device.OnScroll(X, Y)

	Device.OnText(Text)

	Device.OnKey(Key, Down)

```

Using the GUI, note that the while loop represents an OnRender function in your renderer code. At the end of the Frame

call, the actual rendering functions are dispatched.

```cs

NuklearAPI.Init(Device);

while (true) {

	// Optional

	NuklearAPI.SetDeltaTime(Dt);

	

	NuklearAPI.Frame(() => {

		NuklearAPI.Window("Test Window", 100, 100, 200, 200, Flags, () => {

			NuklearAPI.LayoutRowDynamic(35);

			

			if (NuklearAPI.ButtonLabel("Some Button"))

				Console.WriteLine("You pressed Some Button!");

		});

	});

}

```

# TODO

* Demo application

* Higher level binding

* Support for multiple contexts, want to draw a GUI and some example on a 3D in-game screen at the same time?