ChrisDill
8b522882f6
- Matrix in raylib is column major whereas in numerics it is row major. The type marshals and works but it needs to be transposed before it can be used. At first I looked into keeping the matrix type and converting between the 2 as that made sense but I think using just the on type and documenting the difference is a better tradeoff. It may be easy to create bugs by forgetting to transpose but with good documentation I think this is better than having to deal with the 2 types. I may be wrong about this so we will see how it goes.
Raylib-cs
C# bindings for raylib 3.0, a simple and easy-to-use library to learn videogames programming (www.raylib.com)
Installation - NuGet
This is the prefered method to get started - The package is still new so please report any issues.
dotnet add package Raylib-cs
Currently supported are netstandard2.0 (which should include Framework 4.7.2+) and netcore3.1
If you need to edit Raylib-cs source then you will need to add the bindings as a project (see below).
Installation - Manual
-
Download/Clone this repo
-
Add Raylib-cs/Raylib-cs.csproj to your project as an exisitng project. See the Tests projects for reference.
-
Download the native libraries for the platforms you want to build for using the official 3.0 release.
NOTE: the MSVC version is required for Windows platforms -
(Recommended) Put the native library for each platform under
Raylib-cs/runtimes/{platform}/native/
(Optional) If you want to handle the native libraries yourself, make sure they are either in the same directory as the executable and/or can be found in the search path. See https://www.mono-project.com/docs/advanced/pinvoke/ for details. -
Start coding!
using Raylib_cs;
static class Program
{
public static void Main()
{
Raylib.InitWindow(800, 480, "Hello World");
while (!Raylib.WindowShouldClose())
{
Raylib.BeginDrawing();
Raylib.ClearBackground(Color.WHITE);
Raylib.DrawText("Hello, world!", 12, 12, 20, Color.BLACK);
Raylib.EndDrawing();
}
Raylib.CloseWindow();
}
}
Physac-cs and Raygui-cs
These are unfinished EXPERIMENTAL bindings to physac and raygui. They were initially added as a test to Raylib-cs but caused confusion and issues in project setup so they were moved into their own libraries Physac-cs and Raygui-cs that depend on Raylib-cs.
Examples
The Examples for Raylib-cs have moved and can be found at Raylib-cs-Examples.
Tech notes
-
Certain functions take a enum instead of a int such as
IsKeyPressed. -
Colours moved into the
Colorstruct as static members.REDchanges toColor.RED. -
Uses
string.Formatinstead ofTextFormat. -
Adds constructors for some of the structs(WIP).
-
Adds operator overloads for math structs.
Contributing
If you have any ideas, feel free to open an issue and tell me what you think. If you'd like to contribute, please fork the repository and make changes as you'd like. Pull requests are warmly welcome.
If you want to request features or report bugs related to the library (in contrast to this binding), please refer to the author's project repo.
License
raylib-cs (and raylib) is licensed under an unmodified zlib/libpng license, which is an OSI-certified, BSD-like license that allows static linking with closed source software. Check LICENSE for further details.