Raylib-CsLo 4.0.0-alpha.2

<h1 align="center"> <a href="#"><img align="center" src="meta/logos/raylib-cslo_128x128.png" height="96"> Raylib-CsLo</a> <br /> </h1>

<div align="center">

</div>

Raylib-CsLo

LowLevel autogen bindings to Raylib 4.0 and convenience wrappers on top.

• Requires use of unsafe
• A focus on performance. No runtime allocations if at all possible.
• because these are autogen, there won't be any intellisense docs. read the raylib cheatsheet for docs

Table of Contents

• Raylib-CsLo
• Table of Contents
• 🚧🚨🚧 UNDER CONSTRUCTION 🚧🚨🚧
  • Release timeline
    • ALPHA
    • BETA
    • RELEASE
• Differences from raylib-cs
• Usage Tips / FAQ
• How to Contribute
• ChangeLog

🚧🚨🚧 UNDER CONSTRUCTION 🚧🚨🚧

Currently the bindings work, but because these are bare-bones, autogen bindings, they are not user friendly, even for unsafe use. Right now only the Core Examples have been ported.

Release timeline

ALPHA

• The current status.
• A Nuget package is now avalable
• All the core examples are ported. This ensures a minimal set of convenience wrappers are in place, so things don't get too miserable.

BETA

• Triggered when the model and shaders examples are ported.

RELEASE

• Triggered when all examples are ported. You can contribute to make this happen.

Differences from raylib-cs

Usage Tips / FAQ

• Is there a wrapper for this function? or do I have to really cast my Enum to int?
  • The autogen bindings are left untouched, however convenience wrappers are added. Usually these will automagically "work" via function overloads, but where this is not possible, try adding an underscore _ to the end of the function/property. For example: Camera3D.projection_ = CameraProjection.CAMERA_ORTHOGRAPHIC; or Gesture gesture = Raylib.GetGestureDetected_();
• I ran the examples in a profiler. What are all these sbyte[] arrays being allocated?
  • A pool of sbyte[] is allocated for string marshall purposes, to avoid runtime allocations.
• Why don't you add wrappers for the Math helpers?
  • The RayMath helper functions have been translated into C# code. This is because crossing between Managed and Native code isn't free. Better you do all your maths in managed code, and pass the final result to raylib.
• Why are my matricies corrupt?
  • Raylib/OpenGl uses column-major matricies, while dotnet/vulkan/directx uses row-major. When passing your final calculated matrix to raylib for rendering, call Matrix4x4.Transpose(yourMatrix)

How to Contribute

0. assume you are using Visual Studio (or maybe rider?) and can run dev.sln
1. fork the repo, build and try out the example project
2. Look at how a lot of the raylib functions used in the core examples have convenience wrappers.
3. Pick one of the raylib example groups not being worked on, and let novaleaf know either on discord or via an issue
4. port the example group, following the general design as the core examples.

ChangeLog

• 4.0.0-alpha.2 (2021/11/18): Model examples ported. AutoGen Bindings expanded to include all api's exposed by Raylib.dll (adding RayMath, RlGl, RayGui)
• 4.0.0-alpha.1 (2021/11/16): all core examples ported, so "feature complete" for the workflows used in those examples (and, complete only for those workflows)