aboutsummaryrefslogtreecommitdiffstats
path: root/include
diff options
context:
space:
mode:
Diffstat (limited to 'include')
-rw-r--r--include/pugl/pugl.h14
1 files changed, 11 insertions, 3 deletions
diff --git a/include/pugl/pugl.h b/include/pugl/pugl.h
index 5a60e80..fda8af2 100644
--- a/include/pugl/pugl.h
+++ b/include/pugl/pugl.h
@@ -1163,9 +1163,7 @@ puglGetTransientParent(const PuglView* view);
Realize a view by creating a corresponding system view or window.
After this call, the (initially invisible) underlying system view exists and
- can be accessed with puglGetNativeView(). There is currently no
- corresponding unrealize function, the system view will be destroyed along
- with the view when puglFreeView() is called.
+ can be accessed with puglGetNativeView().
The view should be fully configured using the above functions before this is
called. This function may only be called once per view.
@@ -1175,6 +1173,16 @@ PuglStatus
puglRealize(PuglView* view);
/**
+ Unrealize a view by destroying the corresponding system view or window.
+
+ This is the inverse of puglRealize(). After this call, the view no longer
+ corresponds to a real system view, and can be realized again later.
+*/
+PUGL_API
+PuglStatus
+puglUnrealize(PuglView* view);
+
+/**
Show the view.
If the view has not yet been realized, the first call to this function will