git.cworth.org Git - apitrace-tests/blob - trim_stress/README.markdown

   1 This directory performs stress testing of "apitrace trim".
   2
   3 For each trace file in this directory the trim_stress.py test driver
   4 will perform the following operations:
   5
   6 Given <program>.trace:
   7
   8     1. Generate snapshots of original trace in ./<program>-ref/, (this
   9        step is skipped if the <program>-ref directory already exists.
  10        Simply delete this directory before "make test" to force new
  11        generation of reference images.
  12
  13     2. For each frame of the trace:
  14
  15         1. Use "apitrace trim" to trim <program>.trace to a
  16            single-frame trace in <program>-trim.trace
  17
  18         2. Generate a snapshot of the trimmed frame to
  19            ./<program>-tmp-out/<frame>.png
  20
  21         3. Use "apitrace diff-images" to compare this one frame with
  22            the corresponding reference image in ./<program>-ref.  If
  23            the images differ the entire process is interrupted here.
  24
  25         4. Move the frame snapshot from ./<program>-tmp-out to
  26            ./<program>-out
  27
  28 Note that you can also put traces in the sub-directory local and they
  29 will be tested as well. The difference is that those files will be
  30 ignored by git. This can be useful for traces that are too large to be
  31 considered for inclusion for git, or for traces that cannot be shared
  32 due to proprietary contents.