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	объект GtkGradient
offset	смещение для цвета остановки
color	используемый цвет

С версии: 3.0

gtk_gradient_ref ()

GtkGradient *
gtk_gradient_ref (GtkGradient *gradient);

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

GtkGradient устарела.

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

Параметры

gradient

объект GtkGradient

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

Тот же gradient

С версии: 3.0

gtk_gradient_unref ()

void
gtk_gradient_unref (GtkGradient *gradient);

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

GtkGradient устарела.

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

Параметры

gradient

объект 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	объект 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.22/gtk3-GtkGradient.html