Spec-Zone.ru › GTK 3.24

GtkHSV

GtkHSV — Виджет «цветовой круг»

Функции

GtkWidget * gtk_hsv_new ()
void gtk_hsv_set_color ()
void gtk_hsv_get_color ()
void gtk_hsv_set_metrics ()
void gtk_hsv_get_metrics ()
gboolean gtk_hsv_is_adjusting ()
void gtk_hsv_to_rgb ()
void gtk_rgb_to_hsv ()

Сигналы

void changed Run First
void move Action

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

struct GtkHSV

Иерархия объектов

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkHSV

Реализованные интерфейсы

GtkHSV реализует AtkImplementorIface и GtkBuildable.

Файлы заголовков

#include <gtk/gtk.h>

Описание

GtkHSV — это часть виджета полного селектора цвета, представляющая собой «цветовой круг». Он позволяет выбрать цвет, определив его компоненты HSV интуитивно. Перемещение выделения по внешнему кольцу изменяет оттенок, а перемещение точки выделения внутри внутреннего треугольника изменяет значение и насыщенность.

GtkHSV устарел вместе с GtkColorSelection, где он использовался.

Функции

gtk_hsv_new ()

GtkWidget *
gtk_hsv_new (void);

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

Создаёт новый селектор цвета HSV.

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

Новый созданный селектор цвета HSV.

С: 2.14

gtk_hsv_set_color ()

void
gtk_hsv_set_color (GtkHSV *hsv,
                   double h,
                   double s,
                   double v);

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

Устанавливает текущий цвет в селекторе цвета HSV. Значения компонентов цвета должны быть в диапазоне [0.0, 1.0].

Параметры

hsv

Селектор цвета HSV

h

Оттенок

s

Насыщенность

v

Цветовой тон

С: 2.14

gtk_hsv_get_color ()

void
gtk_hsv_get_color (GtkHSV *hsv,
                   gdouble *h,
                   gdouble *s,
                   gdouble *v);

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

Запрашивает текущий цвет в селекторе цвета HSV. Возвращаемые значения будут в диапазоне [0.0, 1.0].

Параметры

hsv

Селектор цвета HSV

h

Возвращаемое значение для оттенка.

[out]

s

Возвращаемое значение для насыщенности.

[out]

v

Возвращаемое значение для цветового тона.

[out]

С: 2.14

gtk_hsv_set_metrics ()

void
gtk_hsv_set_metrics (GtkHSV *hsv,
                     gint size,
                     gint ring_width);

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

Устанавливает размер и ширину кольца селектора цвета HSV.

Параметры

hsv

Селектор цвета HSV

size

Диаметр кольца оттенков

ring_width

Ширина кольца оттенков

С: 2.14

gtk_hsv_get_metrics ()

void
gtk_hsv_get_metrics (GtkHSV *hsv,
                     gint *size,
                     gint *ring_width);

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

Запрашивает размер и ширину кольца селектора цвета HSV.

Параметры

hsv

Селектор цвета HSV

size

Возвращаемое значение для диаметра кольца оттенков.

[out]

ring_width

Возвращаемое значение для ширины кольца оттенков.

[out]

С: 2.14

gtk_hsv_is_adjusting ()

gboolean
gtk_hsv_is_adjusting (GtkHSV *hsv);

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

Селектор цвета HSV может считаться настраиваемым, если происходят многократные быстрые изменения его значения, например, когда пользователь настраивает значение с помощью мыши. Эта функция запрашивает, настраивается ли селектор цвета HSV или нет.

Параметры

hsv

Объект GtkHSV

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

TRUE если клиенты могут игнорировать изменения значения цвета, так как они могут быть временными, или FALSE если они должны рассматривать состояние значения цвета как окончательное.

С: 2.14

gtk_hsv_to_rgb ()

void
gtk_hsv_to_rgb (gdouble h,
                gdouble s,
                gdouble v,
                gdouble *r,
                gdouble *g,
                gdouble *b);

Преобразует цвет из цветового пространства HSV в RGB.

Входные значения должны быть в диапазоне [0.0, 1.0]; выходные значения будут в том же диапазоне.

Параметры

h

Оттенок

s

Насыщенность

v

Цветовой тон

r

Возвращаемое значение для красной составляющей.

[out]

g

Возвращаемое значение для зелёной составляющей.

[out]

b

Возвращаемое значение для синей составляющей.

[out]

С: 2.14

gtk_rgb_to_hsv ()

void
gtk_rgb_to_hsv (gdouble r,
                gdouble g,
                gdouble b,
                gdouble *h,
                gdouble *s,
                gdouble *v);

Преобразует цвет из цветового пространства RGB в HSV.

Входные значения должны быть в диапазоне [0.0, 1.0]; выходные значения будут в том же диапазоне.

Параметры

r

Красный

g

Зелёный

b

Синий

h

Возвращаемое значение для компонента оттенка.

[out]

s

Возвращаемое значение для компонента насыщенности.

[out]

v

Возвращаемое значение для компонента цветового тона.

[out]

С: 2.14

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

struct GtkHSV

struct GtkHSV;

Подробности сигналов

Сигнал “changed”

void
user_function (GtkHSV  *hsv,
               gpointer user_data)

Флаги: Run First

Сигнал “move”

void
user_function (GtkHSV          *hsv,
               GtkDirectionType arg1,
               gpointer         user_data)

Флаги: Действие

См. также

GtkColorSelection, GtkColorSelectionDialog

© 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/GtkHSV.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API