Add SkSL image filter support (ToImageFilter / SKRuntimeImageFilterBuilder)

binding/SkiaSharp/SKRuntimeEffect.cs

@@ -75,6 +75,13 @@
 			return new SKRuntimeBlenderBuilder (effect);
 		}
 
+		public static SKRuntimeImageFilterBuilder BuildImageFilter (string sksl)
+		{
+			var effect = CreateShader (sksl, out var errors);
+			ValidateResult (effect, errors);
+			return new SKRuntimeImageFilterBuilder (effect);
+		}
+
 		private static void ValidateResult (SKRuntimeEffect effect, string errors)
 		{
 			if (effect is null) {
@@ -190,6 +197,73 @@
 			}
 		}
 
+		// ToImageFilter - single-child
+
+		public SKImageFilter ToImageFilter () =>
+			ToImageFilterSingle (null, null, null, null, 0);
+
+		public SKImageFilter ToImageFilter (string? childShaderName, SKImageFilter? input) =>
+			ToImageFilterSingle (null, null, childShaderName, input, 0);
+
+		public SKImageFilter ToImageFilter (string? childShaderName, SKImageFilter? input, float maxSampleRadius) =>
+			ToImageFilterSingle (null, null, childShaderName, input, maxSampleRadius);
+
+		public SKImageFilter ToImageFilter (SKRuntimeEffectUniforms uniforms, SKRuntimeEffectChildren children) =>
+			ToImageFilterSingle (uniforms, children, null, null, 0);
+
+		public SKImageFilter ToImageFilter (SKRuntimeEffectUniforms uniforms, SKRuntimeEffectChildren children, string? childShaderName, SKImageFilter? input) =>
+			ToImageFilterSingle (uniforms, children, childShaderName, input, 0);
+
+		public SKImageFilter ToImageFilter (SKRuntimeEffectUniforms uniforms, SKRuntimeEffectChildren children, string? childShaderName, SKImageFilter? input, float maxSampleRadius) =>
+			ToImageFilterSingle (uniforms, children, childShaderName, input, maxSampleRadius);
+
+		// ToImageFilter - with SKRuntimeEffectImageFilterInputs
+
+		public SKImageFilter ToImageFilter (SKRuntimeEffectUniforms uniforms, SKRuntimeEffectChildren children, SKRuntimeEffectImageFilterInputs inputs) =>
+			ToImageFilter (uniforms, children, inputs, 0);
+
+		public SKImageFilter ToImageFilter (SKRuntimeEffectUniforms uniforms, SKRuntimeEffectChildren children, SKRuntimeEffectImageFilterInputs inputs, float maxSampleRadius)
+		{
+			if (inputs.Count == 0)
+				return ToImageFilterSingle (uniforms, children, null, null, maxSampleRadius);
+
+			return ToImageFilterMulti (uniforms, children, inputs, maxSampleRadius);
+		}
+
+		// ToImageFilter - private implementations
+
+		private SKImageFilter ToImageFilterSingle (SKRuntimeEffectUniforms uniforms, SKRuntimeEffectChildren children, string? childShaderName, SKImageFilter? input, float maxSampleRadius)
+		{
+			using var uniformData = uniforms?.ToData ();
+			var uniformsHandle = uniformData?.Handle ?? IntPtr.Zero;
+			using var childrenHandles = Utils.RentHandlesArray (children?.AsArray (), true);
+
+			fixed (IntPtr* ch = childrenHandles) {
+				return SKImageFilter.GetObject (SkiaApi.sk_runtimeeffect_make_image_filter (
+					Handle, uniformsHandle, ch, (IntPtr)childrenHandles.Length,
+					maxSampleRadius, childShaderName ?? string.Empty, input?.Handle ?? IntPtr.Zero));
+			}
+		}
+
+		private SKImageFilter ToImageFilterMulti (SKRuntimeEffectUniforms uniforms, SKRuntimeEffectChildren children, SKRuntimeEffectImageFilterInputs inputs, float maxSampleRadius)
+		{
+			var count = inputs.Count;
+			using var uniformData = uniforms?.ToData ();
+			var uniformsHandle = uniformData?.Handle ?? IntPtr.Zero;
+			using var childrenHandles = Utils.RentHandlesArray (children?.AsArray (), true);
+			using var nameRental = Utils.RentArray<string> (count);
+			using var filterRental = Utils.RentArray<SKImageFilter?> (count);
+			inputs.WriteTo (nameRental.Array, filterRental.Array);
+			using var inputHandles = Utils.RentHandlesArray (filterRental.Array, true);
+
+			fixed (IntPtr* ch = childrenHandles)
+			fixed (IntPtr* ih = inputHandles) {
+				return SKImageFilter.GetObject (SkiaApi.sk_runtimeeffect_make_image_filter_with_children (
+					Handle, uniformsHandle, ch, (IntPtr)childrenHandles.Length,
+					maxSampleRadius, nameRental.Array, ih, count));
+			}
+		}
+
 		//
 
 		internal static SKRuntimeEffect GetObject (IntPtr handle) =>
@@ -317,6 +391,7 @@
 			return SKData.CreateCopy (data.Data, data.Size);
 		}
 
+
 		IEnumerator IEnumerable.GetEnumerator () =>
 			GetEnumerator ();
 
@@ -404,6 +479,8 @@
 		public SKObject[] ToArray () =>
 			children.ToArray ();
 
+		internal SKObject[] AsArray () => children;
+
 		IEnumerator IEnumerable.GetEnumerator () =>
 			GetEnumerator ();
 
@@ -415,6 +492,72 @@
 		}
 	}
 
+	public unsafe class SKRuntimeEffectImageFilterInputs : IEnumerable<string>, IDisposable
+	{
+		private readonly HashSet<string> validNames;
+		private readonly Dictionary<string, SKImageFilter?> inputs;
+
+		public SKRuntimeEffectImageFilterInputs (SKRuntimeEffect effect)
+		{
+			_ = effect ?? throw new ArgumentNullException (nameof (effect));
+
+			validNames = new HashSet<string> ();
+			var allChildren = effect.Children;
+			for (var i = 0; i < allChildren.Count; i++) {
+				SKRuntimeEffectChildNative child;
+				SkiaApi.sk_runtimeeffect_get_child_from_index (effect.Handle, i, &child);
+				if (child.fType == SKRuntimeEffectChildTypeNative.Shader)
+					validNames.Add (allChildren[i]);
+			}
+			inputs = new Dictionary<string, SKImageFilter?> ();
+		}
+
+		public IReadOnlyCollection<string> Names =>
+			inputs.Keys;
+
+		public int Count =>
+			inputs.Count;
+
+		public void Reset () =>
+			inputs.Clear ();
+
+		public bool Contains (string name) =>
+			inputs.ContainsKey (name);
+
+		public SKImageFilter? this[string name] {
+			set => Add (name, value);
+		}
+
+		public void Add (string name, SKImageFilter? value)
+		{
+			if (!validNames.Contains (name))
+				throw new ArgumentOutOfRangeException (nameof (name), name, $"Shader child was not found for name: '{name}'.");
+
+			inputs[name] = value;
+		}
+
+		internal int WriteTo (string[] names, SKImageFilter?[] filters)
+		{
+			var i = 0;
+			foreach (var kvp in inputs) {
+				names[i] = kvp.Key;
+				filters[i] = kvp.Value;
+				i++;
+			}
+			return inputs.Count;
+		}
+
+		IEnumerator IEnumerable.GetEnumerator () =>
+			GetEnumerator ();
+
+		public IEnumerator<string> GetEnumerator () =>
+			inputs.Keys.GetEnumerator ();
+
+		public void Dispose ()
+		{
+		}
+	}
+
 	public unsafe readonly ref struct SKRuntimeEffectUniform
 	{
 		internal enum DataType
@@ -668,6 +811,23 @@
 			Effect.ToShader (Uniforms, Children, localMatrix);
 	}
 
+	public class SKRuntimeImageFilterBuilder : SKRuntimeEffectBuilder
+	{
+		public SKRuntimeImageFilterBuilder (SKRuntimeEffect effect)
+			: base (effect)
+		{
+			Inputs = new SKRuntimeEffectImageFilterInputs (effect);
+		}
+
+		public SKRuntimeEffectImageFilterInputs Inputs { get; }
+
+		public SKImageFilter Build () =>
+			Effect.ToImageFilter (Uniforms, Children, Inputs);
+
+		public SKImageFilter Build (float maxSampleRadius) =>
+			Effect.ToImageFilter (Uniforms, Children, Inputs, maxSampleRadius);
+	}
+
 	public class SKRuntimeColorFilterBuilder : SKRuntimeEffectBuilder
 	{
 		public SKRuntimeColorFilterBuilder (SKRuntimeEffect effect)

binding/SkiaSharp/SkiaApi.generated.cs

@@ -13619,6 +13619,44 @@ internal static sk_runtimeeffect_t sk_runtimeeffect_make_for_shader (sk_string_t
 			(sk_runtimeeffect_make_for_shader_delegate ??= GetSymbol<Delegates.sk_runtimeeffect_make_for_shader> ("sk_runtimeeffect_make_for_shader")).Invoke (sksl, error);
 		#endif
 
+		// sk_imagefilter_t* sk_runtimeeffect_make_image_filter(sk_runtimeeffect_t* effect, sk_data_t* uniforms, sk_flattenable_t** children, size_t childCount, float maxSampleRadius, const char* childShaderName, const sk_imagefilter_t* input)
+		#if !USE_DELEGATES
+		#if USE_LIBRARY_IMPORT
+		[LibraryImport (SKIA)]
+		internal static partial sk_imagefilter_t sk_runtimeeffect_make_image_filter (sk_runtimeeffect_t effect, sk_data_t uniforms, sk_flattenable_t* children, /* size_t */ IntPtr childCount, Single maxSampleRadius, [MarshalAs (UnmanagedType.LPStr)] String childShaderName, sk_imagefilter_t input);
+		#else // !USE_LIBRARY_IMPORT
+		[DllImport (SKIA, CallingConvention = CallingConvention.Cdecl)]
+		internal static extern sk_imagefilter_t sk_runtimeeffect_make_image_filter (sk_runtimeeffect_t effect, sk_data_t uniforms, sk_flattenable_t* children, /* size_t */ IntPtr childCount, Single maxSampleRadius, [MarshalAs (UnmanagedType.LPStr)] String childShaderName, sk_imagefilter_t input);
+		#endif
+		#else
+		private partial class Delegates {
+			[UnmanagedFunctionPointer (CallingConvention.Cdecl)]
+			internal delegate sk_imagefilter_t sk_runtimeeffect_make_image_filter (sk_runtimeeffect_t effect, sk_data_t uniforms, sk_flattenable_t* children, /* size_t */ IntPtr childCount, Single maxSampleRadius, [MarshalAs (UnmanagedType.LPStr)] String childShaderName, sk_imagefilter_t input);
+		}
+		private static Delegates.sk_runtimeeffect_make_image_filter sk_runtimeeffect_make_image_filter_delegate;
+		internal static sk_imagefilter_t sk_runtimeeffect_make_image_filter (sk_runtimeeffect_t effect, sk_data_t uniforms, sk_flattenable_t* children, /* size_t */ IntPtr childCount, Single maxSampleRadius, [MarshalAs (UnmanagedType.LPStr)] String childShaderName, sk_imagefilter_t input) =>
+			(sk_runtimeeffect_make_image_filter_delegate ??= GetSymbol<Delegates.sk_runtimeeffect_make_image_filter> ("sk_runtimeeffect_make_image_filter")).Invoke (effect, uniforms, children, childCount, maxSampleRadius, childShaderName, input);
+		#endif
+
+		// sk_imagefilter_t* sk_runtimeeffect_make_image_filter_with_children(sk_runtimeeffect_t* effect, sk_data_t* uniforms, sk_flattenable_t** children, size_t childCount, float maxSampleRadius, const char** childShaderNames, const sk_imagefilter_t** inputs, int inputCount)
+		#if !USE_DELEGATES
+		#if USE_LIBRARY_IMPORT
+		[LibraryImport (SKIA)]
+		internal static partial sk_imagefilter_t sk_runtimeeffect_make_image_filter_with_children (sk_runtimeeffect_t effect, sk_data_t uniforms, sk_flattenable_t* children, /* size_t */ IntPtr childCount, Single maxSampleRadius, [MarshalAs (UnmanagedType.LPArray, ArraySubType = UnmanagedType.LPStr)] String[] childShaderNames, sk_imagefilter_t* inputs, Int32 inputCount);
+		#else // !USE_LIBRARY_IMPORT
+		[DllImport (SKIA, CallingConvention = CallingConvention.Cdecl)]
+		internal static extern sk_imagefilter_t sk_runtimeeffect_make_image_filter_with_children (sk_runtimeeffect_t effect, sk_data_t uniforms, sk_flattenable_t* children, /* size_t */ IntPtr childCount, Single maxSampleRadius, [MarshalAs (UnmanagedType.LPArray, ArraySubType = UnmanagedType.LPStr)] String[] childShaderNames, sk_imagefilter_t* inputs, Int32 inputCount);
+		#endif
+		#else
+		private partial class Delegates {
+			[UnmanagedFunctionPointer (CallingConvention.Cdecl)]
+			internal delegate sk_imagefilter_t sk_runtimeeffect_make_image_filter_with_children (sk_runtimeeffect_t effect, sk_data_t uniforms, sk_flattenable_t* children, /* size_t */ IntPtr childCount, Single maxSampleRadius, [MarshalAs (UnmanagedType.LPArray, ArraySubType = UnmanagedType.LPStr)] String[] childShaderNames, sk_imagefilter_t* inputs, Int32 inputCount);
+		}
+		private static Delegates.sk_runtimeeffect_make_image_filter_with_children sk_runtimeeffect_make_image_filter_with_children_delegate;
+		internal static sk_imagefilter_t sk_runtimeeffect_make_image_filter_with_children (sk_runtimeeffect_t effect, sk_data_t uniforms, sk_flattenable_t* children, /* size_t */ IntPtr childCount, Single maxSampleRadius, [MarshalAs (UnmanagedType.LPArray, ArraySubType = UnmanagedType.LPStr)] String[] childShaderNames, sk_imagefilter_t* inputs, Int32 inputCount) =>
+			(sk_runtimeeffect_make_image_filter_with_children_delegate ??= GetSymbol<Delegates.sk_runtimeeffect_make_image_filter_with_children> ("sk_runtimeeffect_make_image_filter_with_children")).Invoke (effect, uniforms, children, childCount, maxSampleRadius, childShaderNames, inputs, inputCount);
+		#endif
+
 		// sk_shader_t* sk_runtimeeffect_make_shader(sk_runtimeeffect_t* effect, sk_data_t* uniforms, sk_flattenable_t** children, size_t childCount, const sk_matrix_t* localMatrix)
 		#if !USE_DELEGATES
 		#if USE_LIBRARY_IMPORT

binding/libSkiaSharp.json

@@ -511,6 +511,16 @@
           "3": "[MarshalAs (UnmanagedType.LPArray, ArraySubType = UnmanagedType.LPStr)] String[]"
         }
       },
+      "sk_runtimeeffect_make_image_filter": {
+        "parameters": {
+          "5": "[MarshalAs (UnmanagedType.LPStr)] String"
+        }
+      },
+      "sk_runtimeeffect_make_image_filter_with_children": {
+        "parameters": {
+          "5": "[MarshalAs (UnmanagedType.LPArray, ArraySubType = UnmanagedType.LPStr)] String[]"
+        }
+      },
       "sk_path_parse_svg_string": {
         "parameters": {
           "1": "[MarshalAs (UnmanagedType.LPStr)] String"