GtkGradient

GtkGradient — Градиенты

Функции

GtkGradient *	gtk_gradient_new_linear ()
GtkGradient *	gtk_gradient_new_radial ()
void	gtk_gradient_add_color_stop ()
GtkGradient *	gtk_gradient_ref ()
void	gtk_gradient_unref ()
gboolean	gtk_gradient_resolve ()
cairo_pattern_t *	gtk_gradient_resolve_for_context ()
char *	gtk_gradient_to_string ()

Типы и значения

GtkGradient

Включения

#include <gtk/gtk.h>

Описание

GtkGradient — это упакованный тип, представляющий градиент. Он является результатом разбора выражения градиента. Для получения градиента, представленного GtkGradient, необходимо выполнить его разрешение с помощью gtk_gradient_resolve(), который заменяет все символические ссылки на цвета цветами, на которые они ссылаются (в данном контексте), и создаёт значение cairo_pattern_t.

Обычно нет необходимости работать напрямую с GtkGradients, поскольку они в основном используются в фоновом режиме GtkStyleContext и GtkCssProvider.

GtkGradient устарел. Он использовался в движке CSS GTK для представления градиентов. Поскольку его обработка не соответствует современным веб-стандартам, он больше не используется. Если вы хотите использовать градиенты в собственном коде, используйте Cairo напрямую.

Функции

gtk_gradient_new_linear ()

GtkGradient *
gtk_gradient_new_linear (gdouble x0,
                         gdouble y0,
                         gdouble x1,
                         gdouble y1);

gtk_gradient_new_linear было устаревшим с версии 3.8 и не должно использоваться в новом коде.

GtkGradient устарело.

Создаёт новый линейный градиент по линии, заданной (x0, y0) и (x1, y1). Перед использованием градиента необходимо добавить несколько цветов остановок с помощью gtk_gradient_add_color_stop().

Параметры

x0	Координата X начальной точки
y0	Координата Y начальной точки
x1	Координата X конечной точки
y1	Координата Y конечной точки

Возвращаемое значение

Созданный GtkGradient

С версии: 3.0

gtk_gradient_new_radial ()

GtkGradient *
gtk_gradient_new_radial (gdouble x0,
                         gdouble y0,
                         gdouble radius0,
                         gdouble x1,
                         gdouble y1,
                         gdouble radius1);

gtk_gradient_new_radial было устаревшим с версии 3.8 и не должно использоваться в новом коде.

GtkGradient устарело.

Создаёт новый радиальный градиент по двум окружностям, заданным (x0, y0, radius0) и (x1, y1, radius1). Перед использованием градиента необходимо добавить несколько цветов остановок с помощью gtk_gradient_add_color_stop().

Параметры

x0	Координата X начальной окружности
y0	Координата Y начальной окружности
radius0	Радиус начальной окружности
x1	Координата X конечной окружности
y1	Координата Y конечной окружности
radius1	Радиус конечной окружности

Возвращаемое значение

Созданный GtkGradient

С версии: 3.0

gtk_gradient_add_color_stop ()

void
gtk_gradient_add_color_stop (GtkGradient *gradient,
                             gdouble offset,
                             GtkSymbolicColor *color);

gtk_gradient_add_color_stop было устаревшим с версии 3.8 и не должно использоваться в новом коде.

GtkGradient устарело.

Добавляет цвет остановки к gradient .

Параметры

gradient	a GtkGradient
offset	смещение для остановки цвета
color	используемый цвет

С версии: 3.0

gtk_gradient_ref ()

GtkGradient *
gtk_gradient_ref (GtkGradient *gradient);

gtk_gradient_ref было устаревшим с версии 3.8 и не должно использоваться в новом коде.

GtkGradient устарело.

Увеличивает счётчик ссылок gradient .

Параметры

gradient

a GtkGradient

Возвращаемое значение

Тот же gradient

С версии: 3.0

gtk_gradient_unref ()

void
gtk_gradient_unref (GtkGradient *gradient);

gtk_gradient_unref было устаревшим с версии 3.8 и не должно использоваться в новом коде.

GtkGradient устарело.

Уменьшает счётчик ссылок gradient, освобождая память, если счётчик ссылок достигнет 0.

Параметры

gradient

a GtkGradient

С версии: 3.0

gtk_gradient_resolve ()

gboolean
gtk_gradient_resolve (GtkGradient *gradient,
                      GtkStyleProperties *props,
                      cairo_pattern_t **resolved_gradient);

gtk_gradient_resolve было устаревшим с версии 3.8 и не должно использоваться в новом коде.

GtkGradient устарело.

Если gradient разрешим, resolved_gradient будет заполнен разрешённым градиентом как cairo_pattern_t, и будет возвращено TRUE. Как правило, если gradient не может быть разрешен, это связано с тем, что он определён на основе имени цвета, которого нет в props.

Параметры

gradient	a GtkGradient
props	GtkStyleProperties для использования при разрешении именованных цветов
resolved_gradient	место для возвращения разрешённого рисунка.	[out]

Возвращаемое значение

TRUE если градиент был разрешён

С версии: 3.0

gtk_gradient_resolve_for_context ()

cairo_pattern_t *
gtk_gradient_resolve_for_context (GtkGradient *gradient,
                                  GtkStyleContext *context);

gtk_gradient_resolve_for_context устарело и не должно использоваться в новом коде.

gtk_gradient_to_string ()

char *
gtk_gradient_to_string (GtkGradient *gradient);

gtk_gradient_to_string было устаревшим с версии 3.8 и не должно использоваться в новом коде.

GtkGradient устарело.

Создаёт строковое представление gradient, подходящее для использования в файлах GTK CSS.

Параметры

gradient

градиент для вывода

Возвращаемое значение

Строковое представление gradient

Типы и значения

GtkGradient

typedef struct _GtkGradient GtkGradient;

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer.gnome.org/gtk3/3.24/gtk3-GtkGradient.html