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

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