Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sardemff7/libgwater
A collection of GSources
https://github.com/sardemff7/libgwater
Last synced: 5 days ago
JSON representation
A collection of GSources
- Host: GitHub
- URL: https://github.com/sardemff7/libgwater
- Owner: sardemff7
- Created: 2014-03-10T19:42:52.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2024-02-22T14:49:58.000Z (9 months ago)
- Last Synced: 2024-08-01T15:35:23.813Z (3 months ago)
- Language: C
- Size: 81.1 KB
- Stars: 16
- Watchers: 5
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
libgwater
=========
libgwater provides several GSources to integrate various events to the GLib main loop.
Composition of a GSource
------------------------
Each GSource is composed of three parts:
- An m4 macro for Autoconf: `GW_CHECK_`
It takes two optional arguments:
1. Additionnal `pkg-config` packages to check
2. Additionnal headers to check
- A `Makefile.am` snippet for Automake: `libgwater/.mk`
You have to include it in your `Makefile.am`. It defines two variables:
- `GW__CFLAGS`: contains all the needed `CFLAGS` (including those from the `pkg-config` packages you passed to the m4 macro)
- `GW__LIBS`: contains all the needed `LIBS` (including those from the `pkg-config` packages you passed to the m4 macro)
This snippet is using Automake 1.14 features and Libtool. If you do not use both in your project, you need to adapt and ship it in your project.
- A really basic API:
- A `GWaterSource` opaque struct
- One or more `g_water__source_new()` constructor for said struct
- One free function `g_water__source_free()`
- Usually a getter, to access the underlaying struct used by the communication library
Non-Autotools setup are not covered upstream but should be easy enough to use.
Example usage of XCB GSource
----------------------------
1. Create your project with Autotools files
2. Add libgwater as a Git submodule
```shell
git submodule add https://github.com/sardemff7/libgwater
```
3. Add the m4 macro call to your `configure.ac` (with an additionnal package, `xcb-util`)
```m4
GW_CHECK_XCB([xcb-util])
```
4. Make sure aclocal will find the m4 file by adding the directory to `ACLOCAL_AMFLAGS` in your `Makefile.am`
```Makefile
ACLOCAL_AMFLAGS = -I libgwater ${ACLOCAL_FLAGS}
```
5. Include the `Makefile.am` snippet
```Makefile
include $(top_srcdir)/libgwater/xcb.mk
```
6. Use the `Makefile.am` variables
```Makefile
xcb_example_client_SOURCES = client.c
xcb_example_client_CFLAGS = $(GW_XCB_CFLAGS)
xcb_example_client_LDADD = $(GW_XCB_LIBS)
```
7. Use the GSource in your `client.c`
```c
#include
#include
gboolean
callback(xcb_generic_event_t *event, gpointer user_data)
{
if ( event == NULL )
{
/* Error occured */
return FALSE;
}
return TRUE;
}
int
main()
{
GWaterXcbSource *source;
GMainLoop *loop;
loop = g_main_loop_new(NULL, FALSE);
source = g_water_xcb_source_new(NULL, NULL, NULL, callback, NULL, NULL);
g_main_loop_run(loop);
g_main_loop_unref(loop);
g_xcb_source_free(source);
return 0;
}
```
Dependencies
------------
- Common dependencies
- GLib 2.36 (or newer)
- Wayland source
- libwayland 1.1.91 (or newer)
- XCB source
- libxcb
- MPD source
- libmpdclient2
- ALSA Mixer source
- alsa-lib
- Netlink protocol source
- libnl-3.0
- Windows source
- `Windows.h`
Licence
-------
libgwater is licenced under the terms of the [MIT license](//opensource.org/licenses/MIT)
Author / Contact
----------------
Morgane “Sardem FF7” Glidic ([email protected]) — [My other Free Software projects](//www.val-sans-retour.fr/en/foss/)