Add cross-platform ColorRGBA/Texture2D helpers to ShaderUtils; enable terrain in iOS examples

- Add mix(ColorRGBA, ColorRGBA, float) as cross-platform replacement for removed mix(java.awt.Color, ...)
- Add getImageDataFromTexture(Texture2D) as cross-platform replacement for removed getImageDataFromImage(BufferedImage)
- Remove jme3test.terrain. from iOS example chooser excluded prefixes
- Move jme3-terrain from iosIncludeAwtUnsafeModules conditional to unconditional iOS dependencies

Agent-Logs-Url: https://github.com/jMonkeyEngine/jmonkeyengine/sessions/612baf0b-d7a0-4d66-bc40-412519339e72

Co-authored-by: riccardobl <4943530+riccardobl@users.noreply.github.com>

Author: Copilot

jme3-ios-examples/build.gradle

@@ -35,8 +35,7 @@ def iosChooserExcludedPrefixes = [
     'jme3test.awt.',
     'jme3test.bullet.',
     'jme3test.niftygui.',
-    'jme3test.opencl.',
-    'jme3test.terrain.'
+    'jme3test.opencl.'
 ]
 def iosChooserExcludedNames = [
     'jme3test.app.TestChangeAppIcon',
@@ -311,10 +310,10 @@ dependencies {
     implementation project(':jme3-plugins')
     implementation project(':jme3-plugins-json')
     implementation project(':jme3-plugins-json-gson')
+    implementation project(':jme3-terrain')
 
     if ((findProperty('iosIncludeAwtUnsafeModules') ?: 'false').toString().toBoolean()) {
         implementation project(':jme3-niftygui')
-        implementation project(':jme3-terrain')
     }
 }
 

jme3-terrain/src/main/java/com/jme3/terrain/noise/ShaderUtils.java

@@ -29,6 +29,10 @@
  */
 package com.jme3.terrain.noise;
 
+import com.jme3.math.ColorRGBA;
+import com.jme3.texture.Texture2D;
+import java.nio.ByteBuffer;
+
 /**
  * Helper class containing useful functions explained in the book:
  * Texturing & Modeling - A Procedural Approach
@@ -61,6 +65,14 @@ public static final int mix(final int a, final int b, final float f) {
         return (int) ((1 - f) * a + f * b);
     }
 
+    public static final ColorRGBA mix(final ColorRGBA a, final ColorRGBA b, final float f) {
+        return new ColorRGBA(
+            ShaderUtils.mix(a.r, b.r, f),
+            ShaderUtils.mix(a.g, b.g, f),
+            ShaderUtils.mix(a.b, b.b, f),
+            ShaderUtils.mix(a.a, b.a, f));
+    }
+
     public static final float[] mix(final float[] c1, final float[] c2, final float f) {
         return new float[] { ShaderUtils.mix(c1[0], c2[0], f), ShaderUtils.mix(c1[1], c2[1], f), ShaderUtils.mix(c1[2], c2[2], f) };
     }
@@ -242,6 +254,10 @@ public static final float length(final float[] v) {
         return (float) Math.sqrt(s);
     }
 
+    public static final ByteBuffer getImageDataFromTexture(final Texture2D texture) {
+        return texture.getImage().getData(0);
+    }
+
     public static float frac(float f) {
         return f - ShaderUtils.floor(f);
     }