Difference between revisions of "VOGL"

From ArchWiki
Jump to: navigation, search
m (Capturing a tracefile)
(Update with latest changes to the package (binaries are no longer in /opt/vogl, the samples were removed))
Line 10: Line 10:
 
==Installation==
 
==Installation==
  
The development version {{AUR|vogl-git}} is available on the [[AUR]].
+
The development version {{AUR|vogl-git}} is available on the [[AUR]].
The resulting binaries are installed into /opt/vogl. 
 
  
 
==Capturing a tracefile==
 
==Capturing a tracefile==
Line 19: Line 18:
 
{{Warning| These files get big very fast! 1-2 minutes result in about 1GB of captured calls.  }}
 
{{Warning| These files get big very fast! 1-2 minutes result in about 1GB of captured calls.  }}
  
 
+
VOGL ships with various OpenGL samples that can be used for testing in its sources. These are not part of the package but they can be built manually. You can also grab the latest OpenGL samples from the [http://ogl-samples.g-truc.net/ OpenGL Samples Pack] or from [http://www.openglsuperbible.com/ OpenGL SuperBible].
 
 
VOGL ships with several sample files from the OpenGL SuperBible book for testing.
 
 
 
{{bc|1=$ VOGL_CMD_LINE="--vogl_tracefile /tmp/vogltrace.bin" LD_PRELOAD=/opt/vogl/libvogltrace64.so /opt/vogl/OGLSuperBible/fogged_ch664}}
 
  
 
==Replaying the tracefile==
 
==Replaying the tracefile==
Line 29: Line 24:
 
To replay your trace launch the voglreplayer from within your vogl directory.
 
To replay your trace launch the voglreplayer from within your vogl directory.
  
{{bc|$ ./voglreplay64 /tmp/vogltrace.bin}}
+
{{bc|$ voglreplay64 /tmp/vogltrace.bin}}
  
 
==Inspecting the tracefile==
 
==Inspecting the tracefile==
Line 35: Line 30:
 
Launch the vogleditor binary and open the tracefile.bin with the "File - Open Trace" menu.
 
Launch the vogleditor binary and open the tracefile.bin with the "File - Open Trace" menu.
  
{{bc|$ ./vogleditor64}}
+
{{bc|$ vogleditor64}}
  
 
==Limitations==
 
==Limitations==
  
 
Read about the limitations on this [http://richg42.blogspot.it/2014/03/current-vogl-limitations.html blog post.]
 
Read about the limitations on this [http://richg42.blogspot.it/2014/03/current-vogl-limitations.html blog post.]

Revision as of 16:56, 14 March 2014

VOGL is a tool created by Valve Software and RAD Game Tools for OpenGL debugging. It is able to capture, replay and inspect OpenGL call tracefiles.

Installation

The development version vogl-gitAUR is available on the AUR.

Capturing a tracefile

To obtain a tracefile run the following command.

$ VOGL_CMD_LINE="--vogl_tracefile /tmp/vogltrace.bin" LD_PRELOAD=/opt/vogl/libvogltrace64.so <command>

Where <command> is the command to launch your OpenGL application. Your tracefile will be created in your /tmp directory.

Warning: These files get big very fast! 1-2 minutes result in about 1GB of captured calls.

VOGL ships with various OpenGL samples that can be used for testing in its sources. These are not part of the package but they can be built manually. You can also grab the latest OpenGL samples from the OpenGL Samples Pack or from OpenGL SuperBible.

Replaying the tracefile

To replay your trace launch the voglreplayer from within your vogl directory.

$ voglreplay64 /tmp/vogltrace.bin

Inspecting the tracefile

Launch the vogleditor binary and open the tracefile.bin with the "File - Open Trace" menu.

$ vogleditor64

Limitations

Read about the limitations on this blog post.