From 9a7cd95ac3cd616fde00b39dd9dea8c76355a6b0 Mon Sep 17 00:00:00 2001
From: "Ryan C. Gordon" <[EMAIL REDACTED]>
Date: Wed, 8 Oct 2025 21:50:18 -0400
Subject: [PATCH] properties: Added SDL_PROP_NAME_STRING.
Fixes #14155.
---
include/SDL3/SDL_properties.h | 16 ++++++++++++++++
1 file changed, 16 insertions(+)
diff --git a/include/SDL3/SDL_properties.h b/include/SDL3/SDL_properties.h
index 0054e069e9e85..7e2800e44e7fc 100644
--- a/include/SDL3/SDL_properties.h
+++ b/include/SDL3/SDL_properties.h
@@ -80,6 +80,22 @@ typedef enum SDL_PropertyType
SDL_PROPERTY_TYPE_BOOLEAN
} SDL_PropertyType;
+/**
+ * A generic property for naming things.
+ *
+ * This property is intended to be added to any property set that needs the
+ * set named, or needs a generic name for the object that the properties are
+ * associated with. It is not guaranteed that any property set will include
+ * this property, but it is convenient to have a standard property name that
+ * any piece of code could reasonable agree to use.
+ *
+ * There is no format for the value set with this key; it is expected to be
+ * human-readable.
+ *
+ * \since This macro is available since SDL 3.4.0.
+ */
+#define SDL_PROP_NAME_STRING "SDL.name"
+
/**
* Get the global SDL properties.
*