From 1a1e00e4e1e08d7844d117a978a19451dcf3c36b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Vladim=C3=ADr=20Vondru=C5=A1?= Date: Sat, 5 Sep 2015 19:52:43 +0200 Subject: [PATCH] doc: explicitly mention undefined behavior when using unsupported GL API. --- doc/opengl-wrapping.dox | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/doc/opengl-wrapping.dox b/doc/opengl-wrapping.dox index bc0afacd2..27b2b2f0b 100644 --- a/doc/opengl-wrapping.dox +++ b/doc/opengl-wrapping.dox @@ -151,6 +151,11 @@ else format = TextureFormat::DepthComponent24; @endcode +@attention Using API that requires OpenGL version or extension that is not + provided by the driver results in undefined behavior -- the best you can + get is GL error, it may lead to strange behavior and even crashes when + calling GL functions that are not available. + Some functionality can be emulated by Magnum -- it detects available extensions and selects best possible code path for optimal performance. On startup, the application prints list of extensions that were used to improve the default