GtkGLArea

gtk_gl_area_new ()

GtkWidget *
gtk_gl_area_new (void);

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

Since: 3.16

gtk_gl_area_get_context ()

GdkGLContext *
gtk_gl_area_get_context (GtkGLArea *area);

Извлекает GdkGLContext, используемый area .

Since: 3.16

gtk_gl_area_make_current ()

void
gtk_gl_area_make_current (GtkGLArea *area);

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

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

Since: 3.16

gtk_gl_area_queue_render ()

void
gtk_gl_area_queue_render (GtkGLArea *area);

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

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

Since: 3.16

gtk_gl_area_attach_buffers ()

void
gtk_gl_area_attach_buffers (GtkGLArea *area);

Обеспечивает, что объект фреймбуфера area станет текущей целью отрисовки и чтения, и что все необходимые буферы для area созданы и привязаны к фреймбуферу.

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

Since: 3.16

gtk_gl_area_set_error ()

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

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

Since: 3.16

gtk_gl_area_get_error ()

GError *
gtk_gl_area_get_error (GtkGLArea *area);

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

Since: 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, альфа-канала не будет, и буфер полностью заменит все, что находится под виджетом.

Since: 3.16

gtk_gl_area_get_has_alpha ()

gboolean
gtk_gl_area_get_has_alpha (GtkGLArea *area);

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

Since: 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

gtk_gl_area_set_use_es ()

void
gtk_gl_area_set_use_es (GtkGLArea *area,
                        gboolean use_es);

Устанавливает, должен ли area создать контекст OpenGL или OpenGL ES.

Перед отрисовкой с помощью любого API необходимо проверить возможности GdkGLContext.

С: 3.22

gtk_gl_area_get_use_es ()

gboolean
gtk_gl_area_get_use_es (GtkGLArea *area);

Возвращает значение, установленное с помощью gtk_gl_area_set_use_es().

С: 3.22