aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--pugl/detail/implementation.c12
-rw-r--r--pugl/detail/types.h1
-rw-r--r--pugl/pugl.h24
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;