Merge branch 'develop/3.0' into dependabot/nuget/develop/3.0/multi-62…

…30e5459e

eng/silktouch/sdl/SDL3/generate.rsp

@@ -7,6 +7,8 @@ SDL_SIZE_MAX
 SDL_memcpy
 SDL_memmove
 SDL_memset
+SDL_BeginThreadFunction
+SDL_EndThreadFunction
 --file
 sdl-SDL.h
 --methodClassName

generator.json

@@ -43,6 +43,7 @@
         "ExtractNestedTyping",
         "TransformHandles",
         "TransformFunctions",
+        "TransformProperties",
         "PrettifyNames",
         "AddVTables"
       ],
@@ -71,6 +72,7 @@
         "AddIncludes",
         "ClangScraper",
         "AddApiProfiles",
+        "BakeSourceSets",
         "MixKhronosData",
         "AddOpaqueStructs",
         "TransformFunctions",
@@ -88,29 +90,33 @@
         "Profiles": [
           {
             "Profile": "gl",
-            "SourceSubdirectory": "glcompat",
-            "BakedOutputSubdirectory": "gl"
+            "SourceSubdirectory": "glcompat"
           },
           {
             "Profile": "glcore",
             "SourceSubdirectory": "glcore",
-            "BakedOutputSubdirectory": "gl",
             "MinVersion": "3.2"
           },
           {
             "Profile": "gles1",
             "SourceSubdirectory": "gles1",
-            "BakedOutputSubdirectory": "gl",
             "MaxVersion": "2.0"
           },
           {
             "Profile": "gles2",
             "SourceSubdirectory": "gles2",
-            "BakedOutputSubdirectory": "gl",
             "MinVersion": "2.0"
           }
         ]
       },
+      "BakeSourceSets": {
+        "SourceSets": {
+          "glcompat": "gl",
+          "glcore": "gl",
+          "gles1": "gl",
+          "gles2": "gl"
+        }
+      },
       "AddOpaqueStructs": {
         "Names": [
           "GLsync"

sources/Core/Core/Abstractions/Utf8String.cs

@@ -0,0 +1,81 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+using System.Runtime.InteropServices;
+
+namespace Silk.NET.Core;
+
+/// <summary>
+/// Represents a target type for UTF-8 string literals.
+/// </summary>
+/// <param name="bytes">The UTF-8 bytes.</param>
+public readonly ref struct Utf8String(ReadOnlySpan<byte> bytes)
+{
+    /// <summary>
+    /// Gets the UTF-8 byte representation of this string.
+    /// </summary>
+    public ReadOnlySpan<byte> Bytes { get; } = bytes;
+
+    /// <summary>
+    /// Converts this string to a <see cref="Ref{T}"/>.
+    /// </summary>
+    /// <param name="str">The string.</param>
+    /// <returns>The ref.</returns>
+    public static implicit operator Ref<byte>(Utf8String str) => str.Bytes;
+
+    /// <summary>
+    /// Converts this string to a <see cref="Ref{T}"/>.
+    /// </summary>
+    /// <param name="str">The string.</param>
+    /// <returns>The ref.</returns>
+    public static implicit operator Ref<sbyte>(Utf8String str) => (ReadOnlySpan<sbyte>)str;
+
+    /// <summary>
+    /// Converts this string to a <see cref="ReadOnlySpan{T}"/>.
+    /// </summary>
+    /// <param name="str">The string.</param>
+    /// <returns>The span.</returns>
+    public static implicit operator ReadOnlySpan<byte>(Utf8String str) => str.Bytes;
+
+    /// <summary>
+    /// Converts this string to a <see cref="Ref{T}"/>.
+    /// </summary>
+    /// <param name="str">The string.</param>
+    /// <returns>The span.</returns>
+    public static implicit operator ReadOnlySpan<sbyte>(Utf8String str) =>
+        MemoryMarshal.Cast<byte, sbyte>(str);
+
+    // TODO add ptr casts once we have an analyzer for e.g. [KnownImmovable]
+
+    /// <summary>
+    /// Converts this string to a <see cref="Ref"/>.
+    /// </summary>
+    /// <param name="str">The string.</param>
+    /// <returns>The ref.</returns>
+    public static implicit operator Ref(Utf8String str) => (Ref<byte>)str.Bytes;
+
+    /// <summary>
+    /// Converts this string to a <see cref="string"/>.
+    /// </summary>
+    /// <param name="str">The string.</param>
+    /// <returns>The string.</returns>
+    public static implicit operator string(Utf8String str) => str.ToString();
+
+    /// <summary>
+    /// Converts the given UTF-8 bytes to a <see cref="Utf8String"/>.
+    /// </summary>
+    /// <param name="bytes">The bytes.</param>
+    /// <returns>The string.</returns>
+    public static implicit operator Utf8String(ReadOnlySpan<byte> bytes) => new(bytes);
+
+    /// <summary>
+    /// Converts the given UTF-8 bytes to a <see cref="Utf8String"/>.
+    /// </summary>
+    /// <param name="bytes">The bytes.</param>
+    /// <returns>The string.</returns>
+    public static implicit operator Utf8String(ReadOnlySpan<sbyte> bytes) =>
+        MemoryMarshal.Cast<sbyte, byte>(bytes);
+
+    /// <inheritdoc />
+    public override string ToString() => (string)(Ref<byte>)this;
+}

sources/Core/Core/Pointers/Ref.generic.cs

@@ -132,12 +132,21 @@ public ref T this[nuint index]
     public static bool operator !=(NullPtr lh, Ref<T> rh) => (Ref<T>)lh != rh;
 
     /// <summary>
-    /// Creates a <see cref="Ref{T}"/> from a span
+    /// Creates a <see cref="Ref{T}"/> from a span.
     /// </summary>
-    /// <param name="span"></param>
+    /// <param name="span">The span to create the ref from.</param>
     [MethodImpl(MethodImplOptions.AggressiveInlining | MethodImplOptions.AggressiveOptimization)]
     public static implicit operator Ref<T>(Span<T> span) => new(ref span.GetPinnableReference());
 
+    /// <summary>
+    /// Creates a <see cref="Ref{T}"/> from a readonly span.
+    /// </summary>
+    /// <param name="span">The span to create the ref from.</param>
+    [MethodImpl(MethodImplOptions.AggressiveInlining | MethodImplOptions.AggressiveOptimization)]
+    // TODO const correctness analyzers
+    public static implicit operator Ref<T>(ReadOnlySpan<T> span) =>
+        new(ref Unsafe.AsRef(in span.GetPinnableReference()));
+
     /// <summary>
     /// Creates a <see cref="Ref{T}"/> from a byte reference
     /// </summary>