summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorEmmanuele Bassi <ebassi@gnome.org>2022-01-07 18:30:54 +0000
committerEmmanuele Bassi <ebassi@gnome.org>2022-01-07 18:30:54 +0000
commit8a6dd2805ff77113db5d8d64fd2c10c36cf67607 (patch)
tree096dbd8657ff75e16fde4988031a229ab0b768aa
parentfef179b625689dd781f5ef9160854c1a76fa189b (diff)
downloadgtk+-8a6dd2805ff77113db5d8d64fd2c10c36cf67607.tar.gz
Document side effect of GLArea:has-depth-buffer
We enable depth testing when creating a depth buffer. Fixes: #838
-rw-r--r--gtk/gtkglarea.c4
1 files changed, 4 insertions, 0 deletions
diff --git a/gtk/gtkglarea.c b/gtk/gtkglarea.c
index de7cc7fa0f..af4d46ec91 100644
--- a/gtk/gtkglarea.c
+++ b/gtk/gtkglarea.c
@@ -833,6 +833,10 @@ gtk_gl_area_class_init (GtkGLAreaClass *klass)
*
* If set to %TRUE the widget will allocate and enable a depth buffer for the
* target framebuffer.
+ *
+ * Setting this property will enable GL's depth testing as a side effect. If
+ * you don't need depth testing, you should call `glDisable(GL_DEPTH_TEST)`
+ * in your `GtkGLArea::render` handler.
*/
obj_props[PROP_HAS_DEPTH_BUFFER] =
g_param_spec_boolean ("has-depth-buffer",