git.cworth.org Git - apitrace/blob - README

   1                                    D3D Trace
   2
   3
   4 = About =
   5
   6 Wrapper DLLs to trace D3D8 and D3D9 APIs calls.
   7
   8 Based on the idea from Michael Koch.
   9
  10 See also:
  11 * http://www.mikoweb.eu/index.php?node=21
  12 * http://www.codeguru.com/cpp/g-m/directx/directx8/article.php/c11453/
  13 * http://doc.51windows.net/Directx9_SDK/?url=/directx9_sdk/graphics/programmingguide/TutorialsAndSamplesAndToolsAndTips/Tools/D3DSpy.htm
  14
  15
  16 = Status =
  17
  18 * Only Direct3D 8 and 9 are supported at the moment.
  19 * It has not been tested with many applications. Bugs may cause the application to crash.
  20
  21
  22 = Building from source =
  23
  24 Requirements:
  25 * Python (tested with version 2.5)
  26 * SCons (tested with 0.98.4)
  27 * Microsoft Visual Studio (tested with 2005 version)
  28 * Microsoft DirectX SDK (tested with August 2007 release)
  29
  30 Instructions:
  31
  32 * Invoke scons:
  33
  34  scons debug=no dxsdk=C:\DXSDK
  35
  36 * You can write those options to a file named config.py:
  37
  38  # config.py
  39  debug=1
  40  dxsdk='C:\\DXSDK'
  41
  42 * Invoke
  43
  44   scons -h
  45
  46 See the scons manpage for more info.
  47
  48
  49 = Usage =
  50
  51 * Copy d3d8.dll/d3d9.dll, d3dtrace.xsl, d3dtrace.css to the directory with the application you want to trace.
  52 * Run the application.
  53 * Open the output XML file with Firefox or Internet Explorer to view the log.
  54 * For long XML files is better to use the d3dtrace-txt.xsl stylesheet together with a dedicated XSL processor like xsltproc, or msxsl.
  55
  56
  57 --
  58 Jose Fonseca <jrfonseca@tungstengraphics.com>