eae459e826 | ||
---|---|---|
.github | ||
build | ||
documentation | ||
examples | ||
src | ||
.editorconfig | ||
.gitignore | ||
.gitmodules | ||
LICENSE | ||
README.md | ||
Silk.NET.sln | ||
Silk.NET.sln.DotSettings | ||
azure-pipelines-cd.yml | ||
azure-pipelines.yml | ||
clean.bat | ||
clean.sh | ||
generator.bat | ||
generator.sh | ||
global.json |
README.md
Silk.NET
Silk.NET is a high-speed, advanced library, providing bindings to popular low-level APIs such as OpenGL and OpenAL. Use Silk.NET to add cross-platform 3D graphics, audio, compute and haptics to your C# application.
Silk.NET works on any .NET Standard 2.0 compliant platform. This includes Xamarin, .NET Framework 4.6.1+, and .NET Core 2.0+.
Features
- Performance: We use lesser-known techniques for our native interop which makes our bindings blazing fast.
- Up-to-date: We've built Silk.NET around the latest versions of the Khronos specifications. This means that Silk.NET includes OpenGL 4.6 (and its NVIDIA ray-tracing extensions), OpenGLES 3.2.
- High-level utilities: We provide high-level abstractions around Windowing and Input APIs, which means your apps can run on any platform without changing a single line.
- Game-ready: Making games or game engines with Silk.NET is a breeze as you already have everything a game needs - Graphics, Audio, Input, and Windowing; all in one product!
The team
We currently have 2 maintainers:
As well as 3 community members who we consult with to influence Silk.NET's design:
- Maximiliano L. - developer of Project Hedra using Silk.NET
- Aaron P. - Chief Technology Officer at Ultz
- Frederik A. - imparting knowledge on those using Silk.NET.
- Robert S. - developer of freeserf.net and lead developer of SilkUI
Silk.NET is governed by the Silk Working Group, made up of all of the above members. Only 2 seats are occupied by members of Ultz, demonstrating and emphasising our commitment to open-source software.
Building from source
- Make sure you have the .NET Core SDK installed
- Clone the repository
- Run
generator.bat
orgenerator.sh
(to generate the bindings) - Run
dotnet build
Contributing
Silk.NET uses and encourages Early Pull Requests. Please don't wait until you're done to open a PR!
- Install Git and the .NET Core SDK
- Fork Silk.NET
- Create a branch on your fork.
- Add an empty commit to start your work off (and let you open a PR):
git commit --allow-empty -m "start of [thing you're working on]"
- Open a Pull request with
[WIP]
in the title. Do this before you actually start working. - Make your commits in small, incremental steps with clear descriptions.
- Tag a maintainer when you're done and ask for a review!
Documentation
Nothing here yet, but don't worry - we're working on it.
Several examples can be found in the examples
folder.
You can find the Lab in the src/Lab
folder. While many of these projects demonstrate functionality of Silk, these are intended more as experiments and tests for the library itself, and often demonstrate bad programming practices. Use with caution!
Join the conversation
Come chat with us on Discord!
License
Silk.NET is distributed under the very permissive MIT/X11 license and all dependencies are distributed under MIT-compatible licenses.