4fbb06e0f6I accidentally made the mistake of trying to use NuGet in the solution folder and it took a few minutes to figure out what I was doing wrong.
So, I added this sentence here to help clarify what to do for this (probably common) problem since Visual Studio is fairly likely to start the working directory for the command prompt in the solution directory, which may not be the same as the project directory.
I think since raylib attracts many new users it is best to make the install info as easy as possible, thus my justification for adding this here.
Installs should be as frictionless as possible. I hope you'll consider adding my suggestion here. 🙂
90 lines
3.5 KiB
Markdown
90 lines
3.5 KiB
Markdown
|
|
|
|
# Raylib-cs
|
|
|
|
C# bindings for raylib, a simple and easy-to-use library to learn videogames programming (www.raylib.com)
|
|
|
|
[](https://github.com/ChrisDill/Raylib-cs/graphs/contributors)
|
|
[](LICENSE)
|
|
|
|
[](https://discord.gg/raylib)
|
|
[](https://github.com/ChrisDill/Raylib-cs/stargazers)
|
|
|
|
[](https://github.com/ChrisDill/Raylib-cs/actions?query=workflow%3ABuild)
|
|
|
|
Raylib-cs targets net5.0 and net6.0.
|
|
|
|
## Installation - NuGet
|
|
|
|
This is the prefered method to get started.
|
|
|
|
```
|
|
dotnet add package Raylib-cs --version 4.2.0.2
|
|
```
|
|
|
|
[](https://www.nuget.org/packages/Raylib-cs/)
|
|
|
|
If you need to edit Raylib-cs source then you will need to add the bindings as a project (see below).
|
|
|
|
If you are new to using NuGet (or you've forgotten) and are trying to run the above command in the command prompt, remember that you need to be *inside the intended project directory* (not just inside the solution directory) otherwise the command won't work.
|
|
|
|
## Installation - Manual
|
|
|
|
1. Download/Clone this repo
|
|
|
|
2. Add [Raylib-cs/Raylib-cs.csproj](Raylib-cs/Raylib-cs.csproj) to your project as an existing project.
|
|
|
|
3. Download the native libraries for the platforms you want to build for using the [official 4.5.0 release](https://github.com/raysan5/raylib/releases/tag/4.5.0).
|
|
**NOTE: the MSVC version is required for Windows platforms**
|
|
|
|
4. **(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.
|
|
|
|
5. Start coding!
|
|
|
|
## Hello, World!
|
|
|
|
```csharp
|
|
using Raylib_cs;
|
|
|
|
namespace HelloWorld
|
|
{
|
|
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();
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
## Documentation
|
|
|
|
Examples for Raylib-cs can be found at [Raylib-cs-Examples](https://github.com/ChrisDill/Raylib-cs-Examples).
|
|
|
|
Details about Raylib-cs can be found on the [Raylib-cs wiki](https://github.com/ChrisDill/Raylib-cs/wiki).
|
|
|
|
## 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 raylib directly (in contrast to this binding), please refer to the [author's project repo](https://github.com/raysan5/raylib).
|
|
|
|
## License
|
|
|
|
See [LICENSE](LICENSE) for details.
|