GtkGLArea

gtk_gl_area_new ()

GtkWidget *
gtk_gl_area_new (void);

Создаёт новый виджет GtkGLArea.

С: 3.16

gtk_gl_area_get_context ()

GdkGLContext *
gtk_gl_area_get_context (GtkGLArea *area);

Возвращает GdkGLContext, используемый area .

С: 3.16

gtk_gl_area_make_current ()

void
gtk_gl_area_make_current (GtkGLArea *area);

Убеждается, что GdkGLContext, используемый area, ассоциирован с виджетом GtkGLArea.

Эта функция автоматически вызывается перед вызовом сигнала “render”, и обычно вызывать её из приложения не нужно.

С: 3.16

gtk_gl_area_queue_render ()

void
gtk_gl_area_queue_render (GtkGLArea *area);

Отмечает текущие данные рендеринга (если таковые имеются) как недействительные и добавляет в очередь перерисовку виджета, гарантируя, что сигнал “render” будет вызван во время рисования.

Это необходимо только в том случае, если функция gtk_gl_area_set_auto_render() была вызвана со значением FALSE. По умолчанию сигнал “render” вызывается при каждой отрисовке.

С: 3.16

gtk_gl_area_attach_buffers ()

void
gtk_gl_area_attach_buffers (GtkGLArea *area);

Убеждается, что фреймбуфер area установлен как текущий для отрисовки и чтения, а также созданы и привязаны все необходимые буферы для area.

Эта функция автоматически вызывается перед вызовом сигнала “render”, и обычно вызывать её из приложения не нужно.

С: 3.16

gtk_gl_area_set_error ()

void
gtk_gl_area_set_error (GtkGLArea *area,
                       const GError *error);

Устанавливает ошибку для виджета, которая будет отображена вместо рендеринга GL. Это полезно в сигнале “create-context”, если создание контекста GL завершилось ошибкой.

С: 3.16

gtk_gl_area_get_error ()

GError *
gtk_gl_area_get_error (GtkGLArea *area);

Получает текущую ошибку, установленную для area .

С: 3.16

gtk_gl_area_set_has_alpha ()

void
gtk_gl_area_set_has_alpha (GtkGLArea *area,
                           gboolean has_alpha);

Если has_alpha равно TRUE, то буфер, выделенный виджетом, будет иметь альфа-компонент, а при рендеринге в окно результат будет композирован поверх того, что находится под виджетом.

Если has_alpha равно FALSE, то альфа-компонента не будет, и буфер полностью заменит всё, что находится под виджетом.

С: 3.16

gtk_gl_area_get_has_alpha ()

gboolean
gtk_gl_area_get_has_alpha (GtkGLArea *area);

Возвращает, имеет ли виджет альфа-компонент.

С: 3.16

gtk_gl_area_set_has_depth_buffer ()

void
gtk_gl_area_set_has_depth_buffer (GtkGLArea *area,
                                  gboolean has_depth_buffer);

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

С версии: 3.16

gtk_gl_area_get_has_depth_buffer ()

gboolean
gtk_gl_area_get_has_depth_buffer (GtkGLArea *area);

Возвращает значение, указывающее, имеет ли область буфер глубины.

С версии: 3.16

gtk_gl_area_set_has_stencil_buffer ()

void
gtk_gl_area_set_has_stencil_buffer (GtkGLArea *area,
                                    gboolean has_stencil_buffer);

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

С версии: 3.16

gtk_gl_area_get_has_stencil_buffer ()

gboolean
gtk_gl_area_get_has_stencil_buffer (GtkGLArea *area);

Возвращает значение, указывающее, имеет ли область буфер трафарета.

С версии: 3.16

gtk_gl_area_set_auto_render ()

void
gtk_gl_area_set_auto_render (GtkGLArea *area,
                             gboolean auto_render);

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

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

С версии: 3.16

gtk_gl_area_get_auto_render ()

gboolean
gtk_gl_area_get_auto_render (GtkGLArea *area);

Возвращает значение, указывающее, находится ли область в режиме автоматической отрисовки.

С версии: 3.16

gtk_gl_area_get_required_version ()

void
gtk_gl_area_get_required_version (GtkGLArea *area,
                                  gint *major,
                                  gint *minor);

Возвращает требуемую версию OpenGL, заданную с помощью gtk_gl_area_set_required_version().

С версии: 3.16

gtk_gl_area_set_required_version ()

void
gtk_gl_area_set_required_version (GtkGLArea *area,
                                  gint major,
                                  gint minor);

Устанавливает требуемую версию OpenGL, которая будет использоваться при создании контекста для виджета.

Эта функция должна быть вызвана до того, как область будет реализована.

С версии: 3.16