aboutsummaryrefslogtreecommitdiffstats
path: root/pugl/pugl.h
AgeCommit message (Collapse)AuthorFilesLines
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
2019-07-21Add puglRequestAttention()David Robillard1-0/+10
2019-06-27Add puglGetTime()David Robillard1-0/+10
2019-06-27Fix documentationDavid Robillard1-6/+0
2019-06-27Consistently use uint32_t everywhereDavid Robillard1-8/+8
2019-06-25Fix void function prototypesDavid Robillard1-1/+1
2019-02-17Add puglGetProcAddress for using OpenGL extensionsDavid Robillard1-0/+11
2019-02-17Squash blank lineDavid Robillard1-1/+0
2019-02-17Add configuration APIDavid Robillard1-0/+33
2019-02-16Clean up includesDavid Robillard1-4/+3
2019-02-15Remove PUGL_CAIRO_GLDavid Robillard1-3/+2
The old cairo_gl.h header or something similar is easy enough to use in application code if someone wants to do this, and maintaining a separate context type for it is a hassle and arguably out of scope.
2016-09-20Move entire API to pugl.hDavid Robillard1-21/+339