rofi/include/theme.h

454 lines
10 KiB
C
Raw Normal View History

/*
* rofi
*
* MIT/X11 License
* Copyright © 2013-2017 Qball Cow <qball@gmpclient.org>
*
* Permission is hereby granted, free of charge, to any person obtaining
* a copy of this software and associated documentation files (the
* "Software"), to deal in the Software without restriction, including
* without limitation the rights to use, copy, modify, merge, publish,
* distribute, sublicense, and/or sell copies of the Software, and to
* permit persons to whom the Software is furnished to do so, subject to
* the following conditions:
*
* The above copyright notice and this permission notice shall be
* included in all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
* OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
*
*/
2016-12-09 18:49:49 +00:00
#ifndef THEME_H
#define THEME_H
#include <glib.h>
2016-12-11 11:19:46 +00:00
#include <cairo.h>
2017-01-04 21:27:27 +00:00
#include <widgets/widget.h>
#include <settings.h>
#include "theme.h"
/** Style of text highlight */
typedef enum
{
/** no highlight */
HL_NONE = 0,
/** bold */
HL_BOLD = 1,
/** underline */
HL_UNDERLINE = 2,
/** italic */
HL_ITALIC = 4,
/** color */
HL_COLOR = 8
} HighlightStyle;
2017-01-08 15:23:17 +00:00
/** Style of line */
typedef enum
{
2017-01-08 15:23:17 +00:00
/** Solid line */
2017-01-04 21:27:27 +00:00
SOLID,
2017-01-08 15:23:17 +00:00
/** Dashed line */
2017-01-04 21:27:27 +00:00
DASH
} LineStyle;
2017-01-08 15:23:17 +00:00
/**
* Distance unit type.
*/
typedef enum
{
/** PixelWidth in pixels. */
2016-12-31 21:47:22 +00:00
PW_PX,
/** PixelWidth in EM. */
2016-12-31 21:47:22 +00:00
PW_EM,
/** PixelWidget in percentage */
PW_PERCENT,
2016-12-31 21:47:22 +00:00
} PixelWidth;
/**
* Structure representing a distance.
*/
typedef struct
{
/** Distance */
2016-12-31 22:27:17 +00:00
double distance;
/** Unit type of the distance */
2016-12-31 21:47:22 +00:00
PixelWidth type;
2017-01-04 21:27:27 +00:00
/** Style of the line */
LineStyle style;
2016-12-31 21:47:22 +00:00
} Distance;
/**
* Type of orientation.
*/
typedef enum
{
ORIENTATION_VERTICAL,
ORIENTATION_HORIZONTAL
} Orientation;
/**
* Type of property
*/
typedef enum
{
/** Integer */
2016-12-09 18:49:49 +00:00
P_INTEGER,
/** Double */
2016-12-09 21:16:31 +00:00
P_DOUBLE,
/** String */
2016-12-09 18:49:49 +00:00
P_STRING,
/** Boolean */
2016-12-09 18:49:49 +00:00
P_BOOLEAN,
/** Color */
P_COLOR,
/** Padding */
P_PADDING,
2017-01-05 17:22:34 +00:00
/** Link to global setting */
P_LINK,
/** Position */
P_POSITION,
/** Highlight */
P_HIGHLIGHT,
2016-12-09 18:49:49 +00:00
} PropertyType;
/**
* Represent the color in theme.
*/
2016-12-10 18:48:44 +00:00
typedef struct
{
/** red channel */
double red;
/** green channel */
double green;
/** blue channel */
double blue;
/** alpha channel */
double alpha;
} ThemeColor;
/**
* Padding
*/
2016-12-27 21:19:15 +00:00
typedef struct
{
2016-12-31 21:47:22 +00:00
Distance top;
Distance right;
2016-12-31 21:47:22 +00:00
Distance bottom;
Distance left;
2016-12-27 21:19:15 +00:00
} Padding;
/**
* Theme highlight.
*/
typedef struct
{
/** style to display */
HighlightStyle style;
/** Color */
ThemeColor color;
} ThemeHighlight;
2017-01-08 15:23:17 +00:00
/**
* Property structure.
*/
typedef struct Property
{
2017-01-08 15:23:17 +00:00
/** Name of property */
char *name;
2017-01-08 15:23:17 +00:00
/** Type of property. */
2016-12-09 18:49:49 +00:00
PropertyType type;
2017-01-08 15:23:17 +00:00
/** Value */
union
{
2017-01-08 15:23:17 +00:00
/** integer */
int i;
2017-01-08 15:23:17 +00:00
/** Double */
double f;
2017-01-08 15:23:17 +00:00
/** String */
char *s;
2017-01-08 15:23:17 +00:00
/** boolean */
gboolean b;
2017-01-08 15:23:17 +00:00
/** Color */
2016-12-10 18:48:44 +00:00
ThemeColor color;
2017-01-08 15:23:17 +00:00
/** Padding */
Padding padding;
2017-01-08 15:23:17 +00:00
/** Reference */
struct
{
2017-01-08 15:23:17 +00:00
/** Name */
char *name;
2017-01-08 15:23:17 +00:00
/** Cached looked up ref */
2017-01-05 17:22:34 +00:00
struct Property *ref;
} link;
/** Highlight Style */
ThemeHighlight highlight;
2016-12-09 18:49:49 +00:00
} value;
} Property;
/**
* ThemeWidget.
*/
typedef struct ThemeWidget
{
int set;
char *name;
2016-12-09 18:49:49 +00:00
unsigned int num_widgets;
struct ThemeWidget **widgets;
2016-12-09 18:49:49 +00:00
GHashTable *properties;
2016-12-09 18:49:49 +00:00
struct ThemeWidget *parent;
} ThemeWidget;
2016-12-10 18:48:44 +00:00
/**
* Global pointer to the current active theme.
*/
extern ThemeWidget *rofi_theme;
2016-12-09 18:49:49 +00:00
/**
* @param base Handle to the current level in the theme.
* @param name Name of the new element.
*
* Create a new element in the theme structure.
*
* @returns handle to the new entry.
*/
2017-01-04 14:49:05 +00:00
ThemeWidget *rofi_theme_find_or_create_name ( ThemeWidget *base, const char *name );
2016-12-09 18:49:49 +00:00
/**
* @param widget The widget handle.
*
* Print out the widget to the commandline.
*/
void rofi_theme_print ( ThemeWidget *widget );
2016-12-09 18:49:49 +00:00
/**
* @param type The type of the property to create.
*
* Create a theme property of type.
*
* @returns a new property.
*/
2016-12-09 18:49:49 +00:00
Property *rofi_theme_property_create ( PropertyType type );
/**
* @param p The property to free.
*
* Free the content of the property.
*/
2016-12-09 18:49:49 +00:00
void rofi_theme_property_free ( Property *p );
/**
2017-04-23 13:17:15 +00:00
* @param widget
*
* Free the widget and alll children.
*/
2017-04-23 13:17:15 +00:00
void rofi_theme_free ( ThemeWidget *widget );
/**
2017-01-04 21:27:27 +00:00
* @param file filename to parse.
*
* Parse the input theme file.
*
* @returns returns TRUE when error.
*/
gboolean rofi_theme_parse_file ( const char *file );
/**
* @param string to parse.
*
* Parse the input string in addition to theme file.
*
* @returns returns TRUE when error.
*/
2017-01-08 15:34:50 +00:00
gboolean rofi_theme_parse_string ( const char *string );
/**
* @param widget The widget handle.
* @param table HashTable containing properties set.
*
* Merge properties with widgets current property.
*/
void rofi_theme_widget_add_properties ( ThemeWidget *widget, GHashTable *table );
2016-12-09 21:16:31 +00:00
/**
* Public API
*/
/**
2017-01-04 21:27:27 +00:00
* @param widget The widget to query
* @param property The property to query.
* @param def The default value.
*
* Obtain the distance of the widget.
*
2017-01-04 21:27:27 +00:00
* @returns The distance value of this property for this widget.
*/
2017-01-04 21:27:27 +00:00
Distance rofi_theme_get_distance ( const widget *widget, const char *property, int def );
/**
2017-01-04 21:27:27 +00:00
* @param widget The widget to query
* @param property The property to query.
* @param def The default value.
*
* Obtain the integer of the widget.
*
2017-01-04 21:27:27 +00:00
* @returns The integer value of this property for this widget.
*/
int rofi_theme_get_integer ( const widget *widget, const char *property, int def );
/**
* @param widget The widget to query
* @param property The property to query.
* @param def The default value.
*
* Obtain the position of the widget.
*
* @returns The position value of this property for this widget.
*/
int rofi_theme_get_position ( const widget *widget, const char *property, int def );
/**
* @param widget The widget to query
* @param property The property to query.
* @param def The default value.
*
* Obtain the integer of the widget.
*
* @returns The integer value of this property for this widget.
*/
int rofi_theme_get_integer_exact ( const widget *widget, const char *property, int def );
/**
2017-01-04 21:27:27 +00:00
* @param widget The widget to query
* @param property The property to query.
* @param def The default value.
*
* Obtain the boolean of the widget.
*
2017-01-04 21:27:27 +00:00
* @returns The boolean value of this property for this widget.
*/
int rofi_theme_get_boolean ( const widget *widget, const char *property, int def );
/**
2017-01-04 21:27:27 +00:00
* @param widget The widget to query
* @param property The property to query.
* @param def The default value.
*
* Obtain the string of the widget.
*
2017-01-04 21:27:27 +00:00
* @returns The string value of this property for this widget.
*/
const char *rofi_theme_get_string ( const widget *widget, const char *property, char *def );
/**
2017-01-04 21:27:27 +00:00
* @param widget The widget to query
* @param property The property to query.
* @param def The default value.
*
* Obtain the padding of the widget.
*
2017-01-04 21:27:27 +00:00
* @returns The double value of this property for this widget.
*/
double rofi_theme_get_double ( const widget *widget, const char *property, double def );
/**
2017-01-04 21:27:27 +00:00
* @param widget The widget to query
* @param property The property to query.
2017-01-04 21:27:27 +00:00
* @param d The drawable to apply color.
*
2017-01-01 17:40:49 +00:00
* Obtain the color of the widget and applies this to the drawable d.
*
*/
void rofi_theme_get_color ( const widget *widget, const char *property, cairo_t *d );
/**
2017-01-04 21:27:27 +00:00
* @param widget The widget to query
* @param property The property to query.
2017-01-01 17:40:49 +00:00
* @param pad The default value.
*
* Obtain the padding of the widget.
*
2017-01-04 21:27:27 +00:00
* @returns The padding of this property for this widget.
*/
2017-01-04 21:27:27 +00:00
Padding rofi_theme_get_padding ( const widget *widget, const char *property, Padding pad );
2016-12-31 22:27:17 +00:00
/**
* @param widget The widget to query
* @param property The property to query.
* @param th The default value.
*
* Obtain the highlight .
*
* @returns The highlight of this property for this widget.
*/
ThemeHighlight rofi_theme_get_highlight ( widget *widget, const char *property, ThemeHighlight th );
/**
* @param d The distance handle.
* @param ori The orientation.
*
* Convert Distance into pixels.
* @returns the number of pixels this distance represents.
*/
int distance_get_pixel ( Distance d, Orientation ori );
2017-01-04 21:27:27 +00:00
/**
* @param d The distance handle.
* @param draw The cairo drawable.
*
* Set linestyle.
*/
void distance_get_linestyle ( Distance d, cairo_t *draw );
/**
* Low-level functions.
* These can be used by non-widgets to obtain values.
*/
/**
* @param name The name of the element to find.
* @param state The state of the element.
* @param exact If the match should be exact, or parent can be included.
*
* Find the theme element. If not exact, the closest specified element is returned.
*
* @returns the ThemeWidget if found, otherwise NULL.
*/
ThemeWidget *rofi_theme_find_widget ( const char *name, const char *state, gboolean exact );
/**
* @param widget The widget to find the property on.
* @param type The %PropertyType to find.
* @param property The property to find.
* @param exact If the property should only be found on this widget, or on parents if not found.
*
* Find the property on the widget. If not exact, the parents are searched recursively until match is found.
*
* @returns the Property if found, otherwise NULL.
*/
Property *rofi_theme_find_property ( ThemeWidget *widget, PropertyType type, const char *property, gboolean exact );
/**
* Checks if a theme is set, or is empty.
* @returns TRUE when empty.
*/
gboolean rofi_theme_is_empty ( void );
2017-04-03 10:04:07 +00:00
#ifdef THEME_CONVERTER
/**
* Convert old theme colors into default one.
*/
void rofi_theme_convert_old ( void );
2017-05-04 05:56:40 +00:00
#endif
/**
2017-04-23 13:17:15 +00:00
* @param file File name passed to option.
*
* @returns path to theme or copy of filename if not found.
*/
2017-04-23 13:17:15 +00:00
char *helper_get_theme_path ( const char *file );
#endif