Add a user data handle to the world

3 files changed, 36 insertions, 1 deletions

diff --git a/pugl/detail/implementation.c b/pugl/detail/implementation.c
index 83f63ae..d3b47df 100644
--- a/pugl/detail/implementation.c
+++ b/pugl/detail/implementation.c
@@ -112,6 +112,18 @@ puglFreeWorld(PuglWorld* const world)
 	free(world);
 }
 
+void
+puglSetWorldHandle(PuglWorld* world, PuglWorldHandle handle)
+{
+	world->handle = handle;
+}
+
+PuglWorldHandle
+puglGetWorldHandle(PuglWorld* world)
+{
+	return world->handle;
+}
+
 PuglStatus
 puglSetClassName(PuglWorld* const world, const char* const name)
 {
diff --git a/pugl/detail/types.h b/pugl/detail/types.h
index 656c34d..d229848 100644
--- a/pugl/detail/types.h
+++ b/pugl/detail/types.h
@@ -76,6 +76,7 @@ struct PuglViewImpl {
 /** Cross-platform world definition. */
 struct PuglWorldImpl {
 	PuglWorldInternals* impl;
+	PuglWorldHandle     handle;
 	char*               className;
 	double              startTime;
 	size_t              numViews;
diff --git a/pugl/pugl.h b/pugl/pugl.h
index 7b45f2d..d14c086 100644
--- a/pugl/pugl.h
+++ b/pugl/pugl.h
@@ -462,6 +462,11 @@ puglStrerror(PuglStatus status);
 typedef struct PuglWorldImpl PuglWorld;
 
 /**
+   Handle for the world's opaque user data.
+*/
+typedef void* PuglWorldHandle;
+
+/**
    Create a new world.
 
    @return A new world, which must be later freed with puglFreeWorld().
@@ -476,6 +481,23 @@ PUGL_API void
 puglFreeWorld(PuglWorld* world);
 
 /**
+   Set the user data for the world.
+
+   This is usually a pointer to a struct that contains all the state which must
+   be accessed by several views.
+
+   The handle is opaque to Pugl and is not interpreted in any way.
+*/
+PUGL_API void
+puglSetWorldHandle(PuglWorld* world, PuglWorldHandle handle);
+
+/**
+   Get the user data for the world.
+*/
+PUGL_API PuglWorldHandle
+puglGetWorldHandle(PuglWorld* world);
+
+/**
    Return a pointer to the native handle of the world.
 
    @return
@@ -580,7 +602,7 @@ typedef struct PuglBackendImpl PuglBackend;
 typedef uintptr_t PuglNativeWindow;
 
 /**
-   Handle for opaque user data.
+   Handle for a view's opaque user data.
 */
 typedef void* PuglHandle;