GtkGLArea

Рисование с GtkGLArea

Самый простой способ рисования с помощью команд OpenGL в GtkGLArea — это создать экземпляр виджета и подключиться к сигналу “render”:

Функция render() будет вызываться, когда GtkGLArea готов для рисования его содержимого:

Если вам необходимо инициализировать состояние OpenGL, например, объекты буферов или шейдеры, используйте сигнал “realize”; для очистки используйте сигнал “unrealize”. Поскольку создание и инициализация GdkGLContext может завершиться ошибкой, вам необходимо проверять ошибки с помощью gtk_gl_area_get_error(). Пример безопасной инициализации состояния GL:

Если вам нужно изменить параметры создания GdkGLContext, используйте сигнал “create-context”.

struct GtkGLArea

struct GtkGLArea;

A GtkWidget для рисования с помощью OpenGL.

struct GtkGLAreaClass

struct GtkGLAreaClass {
  gboolean       (* render)         (GtkGLArea        *area,
                                     GdkGLContext     *context);
  void           (* resize)         (GtkGLArea        *area,
                                     int               width,
                                     int               height);
  GdkGLContext * (* create_context) (GtkGLArea        *area);
};

Структура GtkGLAreaClass содержит только закрытые данные.

Свойство “auto-render”

  “auto-render”              gboolean

Если установлено TRUE, сигнал “render” будет испускаться каждый раз, когда виджет рисуется. Это значение по умолчанию и полезно, если отрисовка виджета происходит быстро.

Если установлено FALSE, данные с предыдущей отрисовки сохраняются и используются для отрисовки виджета в следующий раз, если только окно не будет переразмеренно. Чтобы принудительно выполнить отрисовку, необходимо вызвать gtk_gl_area_queue_render(). Этот режим полезен, когда сцена меняется редко, но занимает много времени для перерисовки.

Владелец: GtkGLArea

Флаги: Чтение/Запись

Значение по умолчанию: TRUE

Свойство “context”

  “context”                  GdkGLContext *

Используемый GdkGLContext виджетом GtkGLArea.

Виджет GtkGLArea отвечает за создание экземпляра GdkGLContext. Если вам нужно работать с другими типами буферов (маски, глубины и т. д.), используйте буферы рендеринга.

Владелец: GtkGLArea

Флаги: Чтение

Свойство “has-depth-buffer”

  “has-depth-buffer”         gboolean

Если установлено TRUE, виджет выделит и включит буфер глубины для целевого буфера кадра.

Владелец: GtkGLArea

Флаги: Чтение/Запись

Значение по умолчанию: FALSE

Свойство “has-stencil-buffer”

  “has-stencil-buffer”       gboolean

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

Владелец: GtkGLArea

Флаги: Чтение/Запись

Значение по умолчанию: FALSE

Свойство “use-es”

  “use-es”                   gboolean

Если установлено TRUE, виджет попытается создать GdkGLContext с помощью OpenGL ES вместо OpenGL.

См. также: gdk_gl_context_set_use_es()

Владелец: GtkGLArea

Флаги: Чтение/Запись

Значение по умолчанию: FALSE

Сигнал “create-context”

GdkGLContext*
user_function (GtkGLArea *area,
               gpointer   user_data)

Сигнал ::create-context генерируется при реализации виджета и позволяет переопределить создание контекста OpenGL. Это полезно, если нужно повторно использовать существующий контекст OpenGL или при попытке создания различных вариантов OpenGL.

Если создание контекста завершилось неудачно, обработчик сигнала может использовать gtk_gl_area_set_error(), чтобы получить более подробную информацию об ошибке.

Флаги: Run Last

Сигнал “render”

gboolean
user_function (GtkGLArea    *area,
               GdkGLContext *context,
               gpointer      user_data)

Сигнал ::render генерируется каждый раз, когда необходимо перерисовать содержимое GtkGLArea.

Параметр context привязан к area перед вызовом этой функции, и буферы выводятся на окно после завершения генерации сигнала.

Флаги: Run Last

Сигнал “resize”

void
user_function (GtkGLArea *area,
               int        width,
               int        height,
               gpointer   user_data)

Сигнал ::resize генерируется один раз при реализации виджета, а затем каждый раз, когда виджет изменяется при реализации. Это полезно для поддержания состояния OpenGL в соответствии с размером виджета, например, для свойств камеры, которые могут зависеть от соотношения сторон ширины и высоты.

Гарантируется, что контекст OpenGL для области будет текущим при генерации этого сигнала.

Обработчик по умолчанию настраивает область обзора OpenGL.

Флаги: Run Last