updated version and release notes

CMakeLists.txt

@@ -1,8 +1,8 @@
 cmake_minimum_required(VERSION 3.5)
 
 set(emscripten-glfw_RELEASE_YEAR  "2024")
-set(emscripten-glfw_RELEASE_MONTH "09"  )
-set(emscripten-glfw_RELEASE_DAY   "07"  )
+set(emscripten-glfw_RELEASE_MONTH "10"  )
+set(emscripten-glfw_RELEASE_DAY   "04"  )
 
 set(emscripten-glfw_GLFW_VERSION "3.4.0")
 

README.md

@@ -4,12 +4,16 @@ Introduction
 This project is an Emscripten port of GLFW written in C++ for the web/wasm platform. The currently supported
 GLFW API is 3.4.
 
-[![emscripten - 3.1.66](https://img.shields.io/badge/emscripten-3.1.66-blue)](https://emscripten.org)
-[![Latest - 3.4.0.20240907](https://img.shields.io/badge/Latest-3.4.0.20240907-blue)](https://github.com/pongasoft/emscripten-glfw/releases/latest)
+[![emscripten - TBD](https://img.shields.io/badge/emscripten-TBD-blue)](https://emscripten.org)
+[![Latest - 3.4.0.20241004](https://img.shields.io/badge/Latest-3.4.0.20241004-blue)](https://github.com/pongasoft/emscripten-glfw/releases/latest)
 [![GLFW - 3.4.0](https://img.shields.io/badge/GLFW-3.4.0-blue)](https://www.glfw.org/)
+[![License](https://img.shields.io/badge/License-Apache%20License%202.0-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0)
 ![Compiles](https://github.com/pongasoft/emscripten-glfw/actions/workflows/main.yml/badge.svg)
 
-[![License](https://img.shields.io/badge/License-Apache%20License%202.0-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0)
+[![emscripten - 3.1.66](https://img.shields.io/badge/emscripten-3.1.66-blue)](https://emscripten.org)
+[![Previous - 3.4.0.20240907](https://img.shields.io/badge/Previous-3.4.0.20240907-blue)](https://github.com/pongasoft/emscripten-glfw/releases/latest)
+[![GLFW - 3.4.0](https://img.shields.io/badge/GLFW-3.4.0-blue)](https://www.glfw.org/)
+
 
 Goal
 ----
@@ -36,7 +40,7 @@ Main features:
 * joystick/gamepad
 * fullscreen
 * Hi DPI 
-* all glfw cursors
+* all GLFW cursors and custom cursors
 * window opacity
 * size constraints (size limits and aspect ratio)
 * visibility
@@ -193,6 +197,7 @@ emcc --use-port=contrib.glfw3:disableWarning=true:disableMultiWindow=true main.c
 > #### Note about availability in Emscripten
 > | Emscripten | this port      |
 > |------------|----------------|
+> | TBD        | 3.4.0.20241004 |
 > | 3.1.66     | 3.4.0.20240907 |
 > | 3.1.65     | 3.4.0.20240817 |
 > | 3.1.63     | 3.4.0.20240627 |
@@ -224,6 +229,12 @@ Note that care has been taken to be backward compatible with the pure JavaScript
 
 Release Notes
 -------------
+#### 3.4.0.20241004 - 2024-10-04 | Emscripten TBD
+
+- Implemented custom cursors (`glfwCreateCursor`)
+  - uses a canvas to draw the cursor image into it and convert it into a URL (`canvas.toDataURL()`)
+  - uses the CSS property syntax: `cursor: url(xxx) xhot yhot, auto` when calling `glfwSetCursor` with a custom cursor
+
 #### 3.4.0.20240907 - 2024-09-07 | Emscripten 3.1.66
 
 - Fixed Meta/Super key workaround to also handle the rare (but possible) use-case of having other keys down before

docs/Comparison.md

@@ -104,7 +104,7 @@ This section describes the main features implemented by both libraries.
     <td><img alt="No" src="https://img.shields.io/badge/No-aaaaaa"></td>
   </tr>
   <tr>
-    <td>Cursors</td>
+    <td>Cursors (Standard + Custom)</td>
     <td><img alt="Yes" src="https://img.shields.io/badge/Yes-00aa00"></td>
     <td><img alt="No" src="https://img.shields.io/badge/No-aaaaaa"></td>
   </tr>

docs/Usage.md

@@ -553,7 +553,7 @@ This table contains the list of all the GLFW functions API and whether they are
   </tr>
   <tr>
     <td>glfwCreateCursor</td>
-    <td><img alt="No" src="https://img.shields.io/badge/No-aaaaaa"></td>
+    <td><img alt="Yes" src="https://img.shields.io/badge/Yes-00aa00"> Custom cursors are supported</td>
     <td><img alt="No" src="https://img.shields.io/badge/No-aaaaaa"></td>
   </tr>
   <tr>

include/GLFW/emscripten_glfw3_version.h

@@ -24,8 +24,8 @@
 // #if EMSCRIPTEN_GLFW_VERSION >= 3'4'0'20240801
 // .... code that can be used past a certain release
 // #endif
-#define EMSCRIPTEN_GLFW_VERSION 3'4'0'20240907
+#define EMSCRIPTEN_GLFW_VERSION 3'4'0'20241004
 
-#define EMSCRIPTEN_GLFW_FULL_VERSION_STR "3.4.0.20240907"
+#define EMSCRIPTEN_GLFW_FULL_VERSION_STR "3.4.0.20241004"
 
 #endif

port/emscripten-glfw3.py

@@ -17,8 +17,8 @@
 import os
 from typing import Union, Dict
 
-TAG = '3.4.0.20240907'
-HASH = '48aba179ef50b5efd564535cd549528d06f74d18f7028a06212fccc425b784106b0efb3aa7bf72da6fb80c32a31b410f13a87d4599417cad8dc3af15664fa1b2'
+TAG = '3.4.0.20241004'
+HASH = 'd2745e9f621090b6f78e1c8122d1e6a2e7e774d27799f14945ddcfd543aedeac0e6acdecf42fe74f9ecdbc25aa3599372798ecfc55ddd941661e0628c494cda6'
 ZIP_URL = f'https://github.com/pongasoft/emscripten-glfw/releases/download/v{TAG}/emscripten-glfw3-{TAG}.zip'
 
 # contrib port information (required)