X-Git-Url: https://git.cworth.org/git?a=blobdiff_plain;f=README.markdown;h=af54b7f959a86da9ae3483f1611473f54b54b8a4;hb=44d6e82ea0c10fe5c798b22fa25c2186dc77a6c0;hp=68c9c4af378d59e19588fd5e0915a285ff89c75d;hpb=77653bfda5aff9930096d1ca2db9db13eeabe2ac;p=apitrace diff --git a/README.markdown b/README.markdown index 68c9c4a..af54b7f 100644 --- a/README.markdown +++ b/README.markdown @@ -51,7 +51,7 @@ Replay an OpenGL trace with glretrace application.trace -Pass the `-sb` option to use a single buffered visual. Pass `--help` to +Pass the `--sb` option to use a single buffered visual. Pass `--help` to `glretrace` for more options. EGL traces must be replayed with `eglretrace` instead of `glretrace`. @@ -282,8 +282,14 @@ From OpenGL ES applications you can embed annotations in the trace file through extension. -For Direct3D applications you can follow the same procedure used for -[instrumenting an application for PIX](http://technet.microsoft.com/en-us/query/ee417250) +For Direct3D applications you can follow the standard procedure for +[adding user defined events to Visual Studio Graphics Debugger / PIX](http://msdn.microsoft.com/en-us/library/vstudio/hh873200.aspx): + +- `D3DPERF_BeginEvent`, `D3DPERF_EndEvent`, and `D3DPERF_SetMarker` for D3D9 applications. + +- `ID3DUserDefinedAnnotation::BeginEvent`, + `ID3DUserDefinedAnnotation::EndEvent`, and + `ID3DUserDefinedAnnotation::SetMarker` for D3D11.1 applications. Dump GL state at a particular call @@ -335,11 +341,11 @@ Profiling a trace You can perform gpu and cpu profiling with the command line options: - * `-pgpu` record gpu times for frames and draw calls. + * `--pgpu` record gpu times for frames and draw calls. - * `-pcpu` record cpu times for frames and draw calls. + * `--pcpu` record cpu times for frames and draw calls. - * `-ppd` record pixels drawn for each draw call. + * `--ppd` record pixels drawn for each draw call. The results from this can then be read by hand or analysed with a script. @@ -348,7 +354,7 @@ table which displays profiling results per shader. For example, to record all profiling data and utilise the per shader script: - ./glretrace -pgpu -pcpu -ppd foo.trace | ./scripts/profileshader.py + ./glretrace --pgpu --pcpu --ppd foo.trace | ./scripts/profileshader.py Advanced usage for OpenGL implementors