From ba11bb80c96fc9c9124ba2fa929425f558f86824 Mon Sep 17 00:00:00 2001 From: David Robillard Date: Sat, 7 Jan 2023 19:27:05 -0500 Subject: Rename create/destroy events to realize/unrealize As evidence that this was confusing, the documentation for these was an outright lie, and I've burned quite a bit of time in the past few days trying to rework things based around that flawed understanding. These names make it clear what these events actually are. If we need actual create/destroy events with a broader scope, they'll have to be added, but I suspect those aren't actually useful anyway. --- doc/c/events.rst | 8 ++++---- doc/c/view.rst | 4 ++-- doc/cpp/view.rst | 4 ++-- 3 files changed, 8 insertions(+), 8 deletions(-) (limited to 'doc') diff --git a/doc/c/events.rst b/doc/c/events.rst index 86f7c63..804c724 100644 --- a/doc/c/events.rst +++ b/doc/c/events.rst @@ -24,9 +24,9 @@ For example, a basic event handler might look something like this: MyApp* app = (MyApp*)puglGetHandle(view); switch (event->type) { - case PUGL_CREATE: + case PUGL_REALIZE: return setupGraphics(app); - case PUGL_DESTROY: + case PUGL_UNREALIZE: return teardownGraphics(app); case PUGL_CONFIGURE: return resize(app, event->configure.width, event->configure.height); @@ -69,8 +69,8 @@ OpenGL Context The OpenGL context is only active during the handling of these events: -- :struct:`PuglCreateEvent` -- :struct:`PuglDestroyEvent` +- :struct:`PuglRealizeEvent` +- :struct:`PuglUnrealizeEvent` - :struct:`PuglConfigureEvent` - :struct:`PuglExposeEvent` diff --git a/doc/c/view.rst b/doc/c/view.rst index faf926f..ea261ff 100644 --- a/doc/c/view.rst +++ b/doc/c/view.rst @@ -167,8 +167,8 @@ If you need to perform some setup using the OpenGL API, there are two ways to do so. The OpenGL context is active when -:enumerator:`PUGL_CREATE ` and -:enumerator:`PUGL_DESTROY ` +:enumerator:`PUGL_REALIZE ` and +:enumerator:`PUGL_UNREALIZE ` events are dispatched, so things like creating and destroying shaders and textures can be done then. diff --git a/doc/cpp/view.rst b/doc/cpp/view.rst index 5366731..49940c9 100644 --- a/doc/cpp/view.rst +++ b/doc/cpp/view.rst @@ -160,8 +160,8 @@ If you need to perform some setup using the OpenGL API, there are two ways to do so. The OpenGL context is active when -:type:`CreateEvent` and -:type:`DestroyEvent` +:type:`RealizeEvent` and +:type:`UnrealizeEvent` events are dispatched, so things like creating and destroying shaders and textures can be done then. -- cgit v1.2.1