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, подходящее для использования в файлах CSS GTK.

Параметры

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.20/gtk3-GtkGradient.html