X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=README.markdown;h=48748747dff85d2d914c87b1b4aa010db4995e2f;hb=4ce88b87e64c56b2638ee2b6b4785b4ed35aabd6;hp=5f97d871ca2b40c2888fe3df16eab9e92571b292;hpb=1b76958d7305090006e13314f9d580c66c700633;p=apitrace diff --git a/README.markdown b/README.markdown index 5f97d87..4874874 100644 --- a/README.markdown +++ b/README.markdown @@ -145,10 +145,6 @@ If you are an application developer, you can avoid this either by linking with See the `ld.so` man page for more information about `LD_PRELOAD` and `LD_LIBRARY_PATH` environment flags. -To trace the application inside gdb, invoke gdb as: - - gdb --ex 'set exec-wrapper env LD_PRELOAD=/path/to/glxtrace.so' --args /path/to/application - ### Android ### To trace standalone native OpenGL ES applications, use @@ -201,15 +197,23 @@ to hook only the APIs of interest. Emitting annotations to the trace --------------------------------- -From OpenGL applications you can embed annotations in the trace file through the -[`GL_GREMEDY_string_marker`](http://www.opengl.org/registry/specs/GREMEDY/string_marker.txt) -and -[`GL_GREMEDY_frame_terminator`](http://www.opengl.org/registry/specs/GREMEDY/frame_terminator.txt) -GL extensions. +From whitin OpenGL applications you can embed annotations in the trace file +through the following extensions: + +* [`GL_KHR_debug`](http://www.opengl.org/registry/specs/KHR/debug.txt) + +* [`GL_ARB_debug_output`](http://www.opengl.org/registry/specs/ARB/debug_output.txt) -**apitrace** will advertise and intercept these GL extensions independently of -the GL implementation. So all you have to do is to use these extensions when -available. +* [`GL_AMD_debug_output`](http://www.opengl.org/registry/specs/AMD/debug_output.txt) + +* [`GL_GREMEDY_string_marker`](http://www.opengl.org/registry/specs/GREMEDY/string_marker.txt) + +* [`GL_GREMEDY_frame_terminator`](http://www.opengl.org/registry/specs/GREMEDY/frame_terminator.txt) + +**apitrace** will advertise and intercept these GL extensions regardless the GL +implementation supports them or not. So all you have to do is to use these +extensions when available, and you can be sure they will be available when +tracing inside **apitrace**. For example, if you use [GLEW](http://glew.sourceforge.net/) to dynamically detect and use GL extensions, you could easily accomplish this by doing: @@ -230,8 +234,13 @@ detect and use GL extensions, you could easily accomplish this by doing: This has the added advantage of working equally well with gDEBugger. +Also, provided that the OpenGL implementation supports `GL_KHR_debug`, labels +defined via glObjectLabel() , and the labels of several objects (textures, +framebuffers, samplers, etc. ) will appear in the GUI state dumps, in the +parameters tab. + -From OpenGL ES applications you can embed annotations in the trace file through the +For OpenGL ES applications you can embed annotations in the trace file through the [`GL_EXT_debug_marker`](http://www.khronos.org/registry/gles/extensions/EXT/EXT_debug_marker.txt) extension.