6 Copyright 2008-2009 VMware, Inc.
8 This program is free software: you can redistribute it and/or modify it
9 under the terms of the GNU Lesser General Public License as published
10 by the Free Software Foundation, either version 3 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU Lesser General Public License for more details.
18 You should have received a copy of the GNU Lesser General Public License
19 along with this program. If not, see <http://www.gnu.org/licenses/>.
24 Wrapper DLLs to trace D3D8 and D3D9 APIs calls.
26 Based on the idea from Michael Koch.
29 * http://www.mikoweb.eu/index.php?node=21
30 * http://www.codeguru.com/cpp/g-m/directx/directx8/article.php/c11453/
31 * http://doc.51windows.net/Directx9_SDK/?url=/directx9_sdk/graphics/programmingguide/TutorialsAndSamplesAndToolsAndTips/Tools/D3DSpy.htm
36 * Only Direct3D 8 and 9 are supported at the moment.
37 * It has not been tested with many applications. Bugs may cause the application to crash.
40 = Building from source =
46 * Python (tested with version 2.5)
47 * SCons (tested with 0.98.4)
48 * Microsoft Visual Studio (tested with 2005 version)
49 * Microsoft DirectX SDK (tested with August 2007 release)
55 scons debug=no dxsdk=C:\DXSDK
58 == MinGW crosscompiler ==
61 * apt-get install mingw32
65 scons platform=windows machine=x86 toolchain=crossmingw opengl32.dll
70 * Copy d3d8.dll, d3d9.dll, or opengl32.dll and apitrace.xsl to the directory with the application you want to trace.
71 * Run the application.
72 * Decompress the output .xml.gz and open the XML with Firefox or Internet Explorer to view the log. On Firefox hover on the arguments to see their contents.
73 * For long XML files is better to use xml2txt.py script directly on the .xml.gz file, as:
75 python xml2txt.py d3d9.xml.gz > d3d9.log
77 See also http://jrfonseca.blogspot.com/2008/07/tracing-d3d-applications.html