summaryrefslogtreecommitdiffstats
path: root/include/swaybar/tray/sni.h
diff options
context:
space:
mode:
Diffstat (limited to 'include/swaybar/tray/sni.h')
-rw-r--r--include/swaybar/tray/sni.h81
1 files changed, 81 insertions, 0 deletions
diff --git a/include/swaybar/tray/sni.h b/include/swaybar/tray/sni.h
new file mode 100644
index 00000000..83809b2d
--- /dev/null
+++ b/include/swaybar/tray/sni.h
@@ -0,0 +1,81 @@
1#ifndef _SWAYBAR_SNI_H
2#define _SWAYBAR_SNI_H
3
4#include <stdbool.h>
5#include <client/cairo.h>
6
7struct StatusNotifierItem {
8 /* Name registered to sni watcher */
9 char *name;
10 /* Unique bus name, needed for determining signal origins */
11 char *unique_name;
12 bool kde_special_snowflake;
13
14 cairo_surface_t *image;
15 bool dirty;
16};
17
18/* Each output holds an sni_icon_ref of each item to render */
19struct sni_icon_ref {
20 cairo_surface_t *icon;
21 struct StatusNotifierItem *ref;
22};
23
24struct sni_icon_ref *sni_icon_ref_create(struct StatusNotifierItem *item,
25 int height);
26
27void sni_icon_ref_free(struct sni_icon_ref *sni_ref);
28
29/**
30 * Will return a new item and get its icon. (see warning below)
31 */
32struct StatusNotifierItem *sni_create(const char *name);
33
34/**
35 * `item` must be a struct StatusNotifierItem *
36 * `str` must be a NUL terminated char *
37 *
38 * Returns 0 if `item` has a name of `str`
39 */
40int sni_str_cmp(const void *item, const void *str);
41
42/**
43 * Returns 0 if `item` has a unique name of `str` or if
44 * `item->unique_name == NULL`
45 */
46int sni_uniq_cmp(const void *item, const void *str);
47
48/**
49 * Gets an icon for the given item if found.
50 *
51 * XXX
52 * This function keeps a reference to the item until it gets responses, make
53 * sure that the reference and item are valid during this time.
54 */
55void get_icon(struct StatusNotifierItem *item);
56
57/**
58 * Calls the "activate" method on the given StatusNotifierItem
59 *
60 * x and y should be where the item was clicked
61 */
62void sni_activate(struct StatusNotifierItem *item, uint32_t x, uint32_t y);
63
64/**
65 * Asks the item to draw a context menu at the given x and y coords
66 */
67void sni_context_menu(struct StatusNotifierItem *item, uint32_t x, uint32_t y);
68
69/**
70 * Calls the "secondary activate" method on the given StatusNotifierItem
71 *
72 * x and y should be where the item was clicked
73 */
74void sni_secondary(struct StatusNotifierItem *item, uint32_t x, uint32_t y);
75
76/**
77 * Deconstructs `item`
78 */
79void sni_free(struct StatusNotifierItem *item);
80
81#endif /* _SWAYBAR_SNI_H */