aboutsummaryrefslogtreecommitdiffstats
path: root/pugl/pugl.h
AgeCommit message (Collapse)AuthorFilesLines
2020-03-15Cleanup: Fix documentation linksDavid Robillard1-2/+2
2020-03-15Unify event loop functions as puglUpdate()David Robillard1-17/+47
The previous separation between polling and dispatching was a lie, especially on MacOS where it is impossible to only poll for events without dispatching anything. Providing such an API is misleading, and problematic in various other ways. So, merge them into a single puglUpdate() function which can do the right thing on all platforms. This also adds the behaviour of actually processing all events in the given time interval, which is almost always what clients actually want to do when using a positive timeout (naively doing this before caused terrible input lag).
2020-03-15Add type and flags to worldDavid Robillard1-2/+29
Unfortunately this is an API break, but there's no reasonable way to deprecate the old function and this is required for things to work correctly. The type will be used in following commits to tick the main loop and dispatch events correctly for either case.
2020-03-14Add logging APIDavid Robillard1-0/+38
2020-03-09Deprecate puglEnterContext() and puglLeaveContext()David Robillard1-29/+33
These are prone to abuse, and have caused confusion with people who try to use them like in other libraries that support explicit drawing in the main loop. The drawing parameter was also wrong, and these were already just compatibility veneers since the internal context API needs to be more expressive. So, now that PUGL_CREATE and PUGL_DESTROY exist, they can be deprecated to force clients to draw only at the correct time.
2020-03-09Add PuglEventClient and puglSendEvent()David Robillard1-1/+28
This event makes it possible to send an arbitrary event to a view, which is useful for many things. In particular, this method of communication with views will wake up the event loop, unlike hacks in applications that share data in some other way.
2020-03-09Add create, destroy, map, and unmap eventsDavid Robillard1-1/+9
These can be used to do things when a view is created or destroyed, in particular set up the GL context in a more controlled way. Map and unmap events are also added for when views are shown and hidden so application can react to this as well. Towards the deprecation of puglEnterContext() and puglLeaveContext(), which are prone to abuse. squash! Remove client event stuff
2020-03-08Add a user data handle to the worldDavid Robillard1-1/+23
2020-03-08Link event types to the corresponding structDavid Robillard1-14/+14
2020-03-08Remove redundant PuglEventCloseDavid Robillard1-12/+0
This is identical to PuglEventAny.
2020-03-07Fix overly long lineDavid Robillard1-2/+2
2020-03-07Organize documentation into groupsDavid Robillard1-9/+41
2020-03-07Improve documentationDavid Robillard1-82/+184
2020-03-06Use terse Doxygen ref syntaxDavid Robillard1-3/+3
2020-03-06Move puglSetBackend() to init groupDavid Robillard1-11/+11
2020-03-06Move puglSetEventFunc() to init groupDavid Robillard1-6/+6
2020-03-06Move puglPostRedisplay() and friend to graphics groupDavid Robillard1-12/+12
2020-03-06Move puglGetClipboard() after puglGetClipboard() for consistencyDavid Robillard1-11/+11
2020-03-06Move puglHasFocus() after puglGrabFocus() for consistencyDavid Robillard1-6/+6
2020-03-06Move puglGetVisible() to more sensible locationDavid Robillard1-6/+6
2020-03-06Move type definitions to the group they are relevant toDavid Robillard1-72/+72
2020-03-06Clean up event field documentationDavid Robillard1-53/+54
2020-03-02Strengthen ultra-strict warnings with clangDavid Robillard1-2/+2
2020-03-01Put PuglEventAny member of PuglEvent first for easy initializationDavid Robillard1-1/+1
2020-03-01Add PUGL_BEGIN_DECLS and PUGL_END_DECLS macrosDavid Robillard1-4/+8
Just to keep the C++ noise out of the headers.
2019-12-09Cleanup: Fix whitespaceDavid Robillard1-1/+1
2019-11-21Rename "backend" headersDavid Robillard1-2/+2
Working on Vulkan clarified what has always been slightly smelly about the design and organization here: not everything that is API specific is really in a "backend" (a PuglBackend). The concrete example is puglGetProcAddress(), which only makes sense for GL and is actually implemented in the "backend" files. Arguably puglGetContext() is also such a thing. So, rename the headers so they can be the place where API-specific things go in general, which happens to include a backend most of the time. The stub is a bit of an exception to this, but whatever. The includes look tidier this way. In place of the old headers are compatibility stubs that just emit a warning and include the new version, which will be maintained for a while.
2019-11-21Use consistent include guardsDavid Robillard1-3/+3
2019-11-18Move puglGetProcAddress to pugl_gl_backend.hDavid Robillard1-11/+0
This establishes a general pattern for backend-specific APIs, so that pugl.h doesn't become a mess. The name of these headers, and the definition of "backend", is a little fuzzy here, but it was before in reality anyway.
2019-11-17Use typedefs for flag typesDavid Robillard1-72/+82
This doesn't change anything about type-safety (C can't do that), but at least makes the intent of things clearer.
2019-11-17Cleanup: Use consistent formatting for field documentationDavid Robillard1-141/+141
2019-11-09Add puglStrerror() and improve test program error reportingDavid Robillard1-0/+7
2019-11-03Remove redisplay flag and add puglPostRedisplayRect()David Robillard1-1/+7
2019-11-03Add puglGetNativeWorld()David Robillard1-0/+10
2019-09-14Add support for using a debug OpenGL contextDavid Robillard1-0/+1
2019-09-14Wrap deprecated declarations in PUGL_DISABLE_DEPRECATEDDavid Robillard1-0/+4
This allows projects that use strict warning flags to suppress warning noise.
2019-09-07Improve documentation and use LV2 documentation styleDavid Robillard1-22/+27
2019-09-07Clean up error handlingDavid Robillard1-7/+10
2019-09-07Add clipboard supportDavid Robillard1-0/+27
2019-09-03Make almost everything return a statusDavid Robillard1-10/+10
Prepares the API for proper error handling, even though there isn't any for these functions yet.
2019-09-03Make event handler return a statusDavid Robillard1-1/+1
Currently unused, but this is to leave open the possibility of event propagation or better errror handling.
2019-09-03Reorganize header and documentation into coherent sectionsDavid Robillard1-96/+98
2019-09-03Add puglSetWindowTitle()David Robillard1-0/+10
2019-09-03Rename remaining init functionsDavid Robillard1-15/+53
This finishes the removal of the init/set split. While these ones are superficial, the general idea here is to provide general functions that work before or after window creation where possible. This prevents the situation where ever more dynamic counterparts to existing init functions get added over time.
2019-09-03Add puglSetClassName()David Robillard1-6/+21
2019-09-03Replace puglInitTransientFor() with puglSetTransientFor()David Robillard1-9/+21
2019-09-03Replace size and aspect ratio init functions with dynamic onesDavid Robillard1-23/+50
2019-09-03Move trivial deprecated implementations to headerDavid Robillard1-12/+44
Again just makes non-deprecated things easier to read and review, and also cleans up the symbol table.
2019-09-03Move deprecated API to a separate section of the headerDavid Robillard1-78/+87
This just makes things easier to read.
2019-09-03Add puglGetWorld()David Robillard1-0/+6
generated by cgit v1.2.1 (git 2.18.0) at 2024-11-23 17:34:17 +0000