[rcore] Porting raylib to iOS and implement rcore_ios.c

.github/workflows/ios.yml

@@ -0,0 +1,35 @@
+name: iOS
+
+on:
+  workflow_dispatch:
+  push:
+    paths:
+      - 'src/**'
+      - 'examples/**'
+      - '.github/workflows/android.yml'
+  pull_request:
+    paths:
+      - 'src/**'
+      - 'examples/**'
+      - '.github/workflows/android.yml'
+  release:
+    types: [published]
+
+jobs:
+  build:
+    runs-on: macos-latest
+    steps:
+    - name: Checkout
+      uses: actions/checkout@master
+    - name: Build Xcode15 project
+      run: |
+        cd projects/Xcode15
+        curl -L https://github.com/raysan5/raylib/files/14743869/libEGL.xcframework.zip --output libEGL.xcframework.zip
+        curl -L https://github.com/raysan5/raylib/files/14743873/libGLESv2.xcframework.zip --output libGLESv2.xcframework.zip
+        mkdir -p raylib/Frameworks
+        unzip -q libEGL.xcframework.zip -d raylib/Frameworks/libEGL.xcframework
+        unzip -q libGLESv2.xcframework.zip -d raylib/Frameworks/libGLESv2.xcframework
+        rm libEGL.xcframework.zip
+        rm libGLESv2.xcframework.zip
+        xcodebuild -project raylib.xcodeproj -scheme raylib -sdk iphonesimulator -destination 'platform=iOS Simulator,name=iPhone 14' build
+  

parser/output/raylib_api.json

@@ -335,6 +335,12 @@
       "type": "UNKNOWN",
       "value": "SHADER_LOC_MAP_METALNESS",
       "description": ""
+    },
+    {
+      "name": "GetMouseRay",
+      "type": "UNKNOWN",
+      "value": "GetScreenToWorldRay",
+      "description": "Compatibility hack for previous raylib versions"
     }
   ],
   "structs": [
@@ -3873,12 +3879,12 @@
     },
     {
       "name": "GetScreenToWorldRay",
-      "description": "Get a ray trace from mouse position",
+      "description": "Get a ray trace from screen position (i.e mouse)",
       "returnType": "Ray",
       "params": [
         {
           "type": "Vector2",
-          "name": "mousePosition"
+          "name": "position"
         },
         {
           "type": "Camera",
@@ -3888,12 +3894,12 @@
     },
     {
       "name": "GetScreenToWorldRayEx",
-      "description": "Get a ray trace from mouse position in a viewport",
+      "description": "Get a ray trace from screen position (i.e mouse) in a viewport",
       "returnType": "Ray",
       "params": [
         {
           "type": "Vector2",
-          "name": "mousePosition"
+          "name": "position"
         },
         {
           "type": "Camera",

parser/output/raylib_api.lua

@@ -335,6 +335,12 @@ return {
       type = "UNKNOWN",
       value = "SHADER_LOC_MAP_METALNESS",
       description = ""
+    },
+    {
+      name = "GetMouseRay",
+      type = "UNKNOWN",
+      value = "GetScreenToWorldRay",
+      description = "Compatibility hack for previous raylib versions"
     }
   },
   structs = {
@@ -3636,19 +3642,19 @@ return {
     },
     {
       name = "GetScreenToWorldRay",
-      description = "Get a ray trace from mouse position",
+      description = "Get a ray trace from screen position (i.e mouse)",
       returnType = "Ray",
       params = {
-        {type = "Vector2", name = "mousePosition"},
+        {type = "Vector2", name = "position"},
         {type = "Camera", name = "camera"}
       }
     },
     {
       name = "GetScreenToWorldRayEx",
-      description = "Get a ray trace from mouse position in a viewport",
+      description = "Get a ray trace from screen position (i.e mouse) in a viewport",
       returnType = "Ray",
       params = {
-        {type = "Vector2", name = "mousePosition"},
+        {type = "Vector2", name = "position"},
         {type = "Camera", name = "camera"},
         {type = "float", name = "width"},
         {type = "float", name = "height"}

parser/output/raylib_api.txt

@@ -1,5 +1,5 @@
 
-Defines found: 56
+Defines found: 57
 
 Define 001: RAYLIB_H
   Name: RAYLIB_H
@@ -281,6 +281,11 @@ Define 056: SHADER_LOC_MAP_SPECULAR
   Type: UNKNOWN
   Value: SHADER_LOC_MAP_METALNESS
   Description: 
+Define 057: GetMouseRay
+  Name: GetMouseRay
+  Type: UNKNOWN
+  Value: GetScreenToWorldRay
+  Description: Compatibility hack for previous raylib versions
 
 Structures found: 34
 
@@ -1424,14 +1429,14 @@ Function 083: UnloadShader() (1 input parameters)
 Function 084: GetScreenToWorldRay() (2 input parameters)
   Name: GetScreenToWorldRay
   Return type: Ray
-  Description: Get a ray trace from mouse position
-  Param[1]: mousePosition (type: Vector2)
+  Description: Get a ray trace from screen position (i.e mouse)
+  Param[1]: position (type: Vector2)
   Param[2]: camera (type: Camera)
 Function 085: GetScreenToWorldRayEx() (4 input parameters)
   Name: GetScreenToWorldRayEx
   Return type: Ray
-  Description: Get a ray trace from mouse position in a viewport
-  Param[1]: mousePosition (type: Vector2)
+  Description: Get a ray trace from screen position (i.e mouse) in a viewport
+  Param[1]: position (type: Vector2)
   Param[2]: camera (type: Camera)
   Param[3]: width (type: float)
   Param[4]: height (type: float)

parser/output/raylib_api.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="Windows-1252" ?>
 <raylibAPI>
-    <Defines count="56">
+    <Defines count="57">
         <Define name="RAYLIB_H" type="GUARD" value="" desc="" />
         <Define name="RAYLIB_VERSION_MAJOR" type="INT" value="5" desc="" />
         <Define name="RAYLIB_VERSION_MINOR" type="INT" value="1" desc="" />
@@ -57,6 +57,7 @@
         <Define name="MATERIAL_MAP_SPECULAR" type="UNKNOWN" value="MATERIAL_MAP_METALNESS" desc="" />
         <Define name="SHADER_LOC_MAP_DIFFUSE" type="UNKNOWN" value="SHADER_LOC_MAP_ALBEDO" desc="" />
         <Define name="SHADER_LOC_MAP_SPECULAR" type="UNKNOWN" value="SHADER_LOC_MAP_METALNESS" desc="" />
+        <Define name="GetMouseRay" type="UNKNOWN" value="GetScreenToWorldRay" desc="Compatibility hack for previous raylib versions" />
     </Defines>
     <Structs count="34">
         <Struct name="Vector2" fieldCount="2" desc="Vector2, 2 components">
@@ -902,12 +903,12 @@
         <Function name="UnloadShader" retType="void" paramCount="1" desc="Unload shader from GPU memory (VRAM)">
             <Param type="Shader" name="shader" desc="" />
         </Function>
-        <Function name="GetScreenToWorldRay" retType="Ray" paramCount="2" desc="Get a ray trace from mouse position">
-            <Param type="Vector2" name="mousePosition" desc="" />
+        <Function name="GetScreenToWorldRay" retType="Ray" paramCount="2" desc="Get a ray trace from screen position (i.e mouse)">
+            <Param type="Vector2" name="position" desc="" />
             <Param type="Camera" name="camera" desc="" />
         </Function>
-        <Function name="GetScreenToWorldRayEx" retType="Ray" paramCount="4" desc="Get a ray trace from mouse position in a viewport">
-            <Param type="Vector2" name="mousePosition" desc="" />
+        <Function name="GetScreenToWorldRayEx" retType="Ray" paramCount="4" desc="Get a ray trace from screen position (i.e mouse) in a viewport">
+            <Param type="Vector2" name="position" desc="" />
             <Param type="Camera" name="camera" desc="" />
             <Param type="float" name="width" desc="" />
             <Param type="float" name="height" desc="" />

projects/Xcode15/main.c

@@ -0,0 +1,120 @@
+/*******************************************************************************************
+*
+*   raylib [core] example - Input Gestures Detection
+*
+*   Example originally created with raylib 1.4, last time updated with raylib 4.2
+*
+*   Example licensed under an unmodified zlib/libpng license, which is an OSI-certified,
+*   BSD-like license that allows static linking with closed source software
+*
+*   Copyright (c) 2016-2024 Ramon Santamaria (@raysan5)
+*
+********************************************************************************************/
+
+#include "raylib.h"
+
+int MAX_GESTURE_STRINGS = 20;
+int screenWidth = 0;
+int screenHeight = 0;
+Vector2 touchPosition;
+Rectangle touchArea;
+int gesturesCount = 0;
+char gestureStrings[100][32];
+int currentGesture = GESTURE_NONE;
+int lastGesture = GESTURE_NONE;
+
+void ios_ready(){
+    InitWindow(0, 0, "raylib [core] example - input gestures");
+
+    screenWidth = GetScreenWidth();
+    screenHeight = GetScreenHeight();
+
+    touchPosition = (Vector2){ 0, 0 };
+    touchArea = (Rectangle){ 220, 10, screenWidth - 230.0f, screenHeight - 20.0f };
+
+    //SetGesturesEnabled(0b0000000000001001);   // Enable only some gestures to be detected
+    SetTargetFPS(60);
+    MAX_GESTURE_STRINGS = (screenHeight - 50) / 20;
+}
+
+static void add_gesture(const char* title){
+    if (gesturesCount >= MAX_GESTURE_STRINGS)
+    {
+        for (int i = 0; i < MAX_GESTURE_STRINGS; i++) TextCopy(gestureStrings[i], "\0");
+        gesturesCount = 0;
+    }
+    TextCopy(gestureStrings[gesturesCount], title);
+    gesturesCount++;
+}
+
+void ios_update()
+{
+    lastGesture = currentGesture;
+    currentGesture = GetGestureDetected();
+    touchPosition = GetTouchPosition(0);
+
+    if(IsMouseButtonPressed(0)) add_gesture("MouseButtonPressed");
+    if(IsMouseButtonReleased(0)) add_gesture("MouseButtonReleased");
+
+    if (CheckCollisionPointRec(touchPosition, touchArea) && (currentGesture != GESTURE_NONE))
+    {
+        if (currentGesture != lastGesture)
+        {
+            // Store gesture string
+            switch (currentGesture)
+            {
+                case GESTURE_TAP: add_gesture( "GESTURE TAP"); break;
+                case GESTURE_DOUBLETAP: add_gesture( "GESTURE DOUBLETAP"); break;
+                case GESTURE_HOLD: add_gesture( "GESTURE HOLD"); break;
+                case GESTURE_DRAG: add_gesture( "GESTURE DRAG"); break;
+                case GESTURE_SWIPE_RIGHT: add_gesture( "GESTURE SWIPE RIGHT"); break;
+                case GESTURE_SWIPE_LEFT: add_gesture( "GESTURE SWIPE LEFT"); break;
+                case GESTURE_SWIPE_UP: add_gesture( "GESTURE SWIPE UP"); break;
+                case GESTURE_SWIPE_DOWN: add_gesture( "GESTURE SWIPE DOWN"); break;
+                case GESTURE_PINCH_IN: add_gesture( "GESTURE PINCH IN"); break;
+                case GESTURE_PINCH_OUT: add_gesture( "GESTURE PINCH OUT"); break;
+                default: break;
+            }
+        }
+    }
+
+    // Draw
+    //----------------------------------------------------------------------------------
+    BeginDrawing();
+
+    ClearBackground(RAYWHITE);
+
+    DrawRectangleRec(touchArea, GRAY);
+    DrawRectangle(225, 15, screenWidth - 240, screenHeight - 30, RAYWHITE);
+
+    DrawText("GESTURES TEST AREA", screenWidth - 270, screenHeight - 40, 20, Fade(GRAY, 0.5f));
+
+    for (int i = 0; i < gesturesCount; i++)
+    {
+        if (i % 2 == 0){
+            DrawRectangle(10, 30 + 20*i, 200, 20, Fade(LIGHTGRAY, 0.5f));
+        }else{
+            DrawRectangle(10, 30 + 20*i, 200, 20, Fade(LIGHTGRAY, 0.3f));
+        }
+        if (i < gesturesCount - 1){
+            DrawText(gestureStrings[i], 35, 36 + 20*i, 10, DARKGRAY);
+        }else{
+            DrawText(gestureStrings[i], 35, 36 + 20*i, 10, MAROON);
+        }
+    }
+
+    DrawRectangleLines(10, 29, 200, screenHeight - 50, GRAY);
+    DrawText(
+             TextFormat("TOUCH COUNT: %d", GetTouchPointCount()),
+             50, 15, 10, GRAY
+             );
+
+    for(int i=0; i < GetTouchPointCount(); i++){
+        DrawCircleV(GetTouchPosition(i), 30, MAROON);
+    }
+    EndDrawing();
+}
+
+void ios_destroy(){
+    CloseWindow();        // Close window and OpenGL context
+}