aboutsummaryrefslogtreecommitdiffstats
path: root/pugl/pugl.h
AgeCommit message (Collapse)AuthorFilesLines
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
2019-09-03Use consistent naming conventionsDavid Robillard1-17/+17
2019-09-03Add swap interval hintDavid Robillard1-0/+1
2019-09-03Add functions to get and set view size and positionDavid Robillard1-2/+29
2019-09-03Add puglDispatchEvents()David Robillard1-1/+14
2019-09-03Add puglPollEvents()David Robillard1-1/+19
This allows waiting for events for any view in the world. It also improves on puglWaitForEvent() by the addition of a time parameter that allows indefinite blocking, non-blocking polling, and blocking polling with a timeout.
2019-09-03Move puglGetTime() to PuglWorldDavid Robillard1-10/+10
2019-09-03Add PuglWorldDavid Robillard1-4/+55
The old API was broken for programs that manage multiple views, since it was impossible to wait for events on any view. There are also several functions in the API which are not actually associated with views at all, so those can now be moved to the more appropriate PuglWorld to make this more clear. The old puglInit() and puglDestroy() functions are preserved for compatibility, but marked as deprecated.
2019-09-03Add puglHasFocus()David Robillard1-0/+6
2019-09-03Simplify hints implementationDavid Robillard1-0/+2
2019-08-02Replace puglIgnoreKeyRepeat() with a hintDavid Robillard1-1/+4
2019-07-30Fix incorrect commentssj711-1/+1
The comment was missed when merging the new text API from a branch based on the old integer milliseconds time.
2019-07-29Reorganize source to separate private implementation detailsDavid Robillard1-1/+1
Taking a page from C++ convention, where "detail" is for things that should not be included in user code.
2019-07-29Clean up file documentationDavid Robillard1-1/+1
2019-07-29Completely separate backends from platform implementationDavid Robillard1-13/+12
This removes PuglContextType and allows the user to pass a backend directly. Normally this would come from one of the two accessors declared in the headers, but it would be possible to add backends without changing any of the existing code at all. Unfortunately, it is not possible to preserve backwards compatibility and achieve the ultimate goal of linking only to the required dependencies, so puglInitContextType() has just been removed.
2019-07-29Expose PuglBackend typeDavid Robillard1-0/+5
2019-07-29Add deprecation macro and deprecate puglInitResizable()David Robillard1-1/+11
2019-07-28Windows: Factor out GL backendDavid Robillard1-1/+4
2019-07-28Make enterContext take a drawing parameter like leaveContextDavid Robillard1-7/+14
These need to be symmetric because sometimes different things need to happen in either situation when entering the context as well.
2019-07-26Windows: Implement size constraintsDavid Robillard1-0/+4
There are two possible approaches to take here: try to expand dimensions that are not being explicitly resized (for example expand the bottom when dragging right), or just stop single-dimension resizes if they would go out of range. I chose the latter here for two reasons: it's hard to always do something smooth and unsurprising with the first approach (and it would require more code), and it can be nice from the user's perspective to easily be able to resize the window to exactly one of its aspect ratio limits. For example, it is very easy to drag pugl_test to 1:1 or 16:9. In other words, simplicity and user power wins.
2019-07-25Fix type of PuglEventText::timeDavid Robillard1-1/+1
2019-07-24Support additional special keysDavid Robillard1-1/+15
2019-07-24Unify key and character fields and separate text eventsDavid Robillard1-34/+45
Only one field is necessary to store any kind of key, including special keys, since PuglKey occupies a reserved Unicode region. This is generally much simpler to deal with since there is only one value to dispatch on. Text events are separated from key events (like Windows but unlike MacOS or X11) because it is not possible to derive text events from key press events when they occur on Windows. Since merging the two has been the source of some confusion, this approach has some advantages anyway, even though it introduces the need to handle another event type. In the process, text input has been almost completely rewritten. I have tested this with a compose key on X11 and dead keys on Windows and MacOS and everything seems to work correctly, though there may (as always) still be issues with more exotic input methods.
2019-07-24Rename PuglEventKey::utf8 to "string" with char typeDavid Robillard1-11/+11
This matches Gtk and is generally less annoying to work with.
2019-07-24Remove view pointer from eventsDavid Robillard1-10/+0
This makes events POD, which is generally nice. The view was originally added to reflect the display and window references in XEvent, but doesn't seem very useful in Pugl applications.
2019-07-24Represent event time as double in seconds on all platformsStefan Westerfeld1-5/+5
generated by cgit v1.2.1 (git 2.18.0) at 2024-11-23 10:24:41 +0000