diff options
author | Dave Davenport <qball@blame.services> | 2021-06-15 17:22:39 +0200 |
---|---|---|
committer | Dave Davenport <qball@blame.services> | 2021-06-15 17:22:39 +0200 |
commit | 6e2584ffc8d3e06bea98823d6b9985e5cb1b4fff (patch) | |
tree | 9553b1d3e211934b7d65d7502c3ad94a4b5e6d88 | |
parent | 4c1a74e15ed3fe35538a00d5351cebfd7ab574af (diff) |
[Doc] Add some header documentation.
-rw-r--r-- | include/rofi-icon-fetcher.h | 14 |
1 files changed, 14 insertions, 0 deletions
diff --git a/include/rofi-icon-fetcher.h b/include/rofi-icon-fetcher.h index 958f0a67..968dbc3a 100644 --- a/include/rofi-icon-fetcher.h +++ b/include/rofi-icon-fetcher.h @@ -35,6 +35,20 @@ void rofi_icon_fetcher_destroy ( void ); * @returns the uid identifying the request. */ uint32_t rofi_icon_fetcher_query ( const char *name, const int size ); + +/** + * @param name The name of the icon to fetch. + * @param wsize The width of the icon to fetch. + * @param hsize The height of the icon to fetch. + * + * Query the icon-theme for icon with name and size. + * The returned icon will be the best match for the requested size, it should still be resized to the actual size. + * For icons it will take the min of wsize and hsize. + * + * name can also be a full path, if prefixed with file://. + * + * @returns the uid identifying the request. + */ uint32_t rofi_icon_fetcher_query_advanced ( const char *name, const int wsize, const int hsize ); /** |