Spec-Zone.ru › GTK 3.20

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

A 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)

Флаги: Выполнять сначала

Сигнал “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.20/GtkHSV.html

Spec-Zone.ru

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