readme.txt

3号作品是分析WarCraft III游戏的replay文件的命令行工具

Simple Replay Viewer

1. OVERVIEW
  Simple Replay Viewer(SRV) is a tool to read the replay files of Warcraft III
(.w3g files). It can tell you about the basic infomation in the replay files and
calculate the APMs (Actions Per Minute) of the players.

2. INSTALLATION
  Extract SRV.exe in any directory you like. Put zlib1.dll in the same directory
or in %windir%\system32.

3. USAGE
  Run SRV.exe either with a file path or without. Type "IN" or "INPUT" to link
a replay file. Type "INFO" to display the basic infomation. Type "P" or "PLAYER"
to show the player infomation. Type "APM" to calculate the APMs and display the
results.
  Type "HELP" for more.

4. FAQ
Q The playtime is not always equal to the time in the parameters of the command
  "APM". Why is that?
A One possible reason is that the player left the game before the end time of
  the parameter. Another possible reason is the structure of the replay file. It
  stores actions in about every 100 ms or 250 ms in a block, depending on the 
  game type. The tool can't tell whether the actions in a block containing the
  time spot are before it or after it. It only calculates the APMs AFTER the
  start time and BEFORE the end time. For more, please refer to w3g_format.txt
  in the source code file.

Q Why is the APMs calculated in SRV different from those calculated in other
  similar tools?
A It is normal if the difference is less than 1. Different tools have different
  ways to deal with some difficult situations, and that leads to the difference.
  But if the difference is larger than 10, the "APM" calculated by that tool is
  not APM. That is "TureAPM", "RealAPM", "MyAPM", or something else. Please send
  an email to that author to ask for a correction.

Q SRV has too few functions! It even can't tell me who has won the game!
A I have to admit that SRV is really simple, but you should know that it's quite
  difficult to tell who has won the game. Even the latest replay reader cannot
  precisely tell it.
  The project SRV will be continued in the summer vacation, maybe. And if I have
  time after the CLI tool has been completed, I will consider about whether it
  needs a GUI.

5. Credits
  Simple Replay Viewer is made by Zeng Yuxiao([e-mail]) for the
homework of Advanced C lab. It is based on the analysis of the replay files,
which is done by blue, nagger and their friends. It is compiled with gcc-3.4.5-3
and mingw-runtime-3.14(http://www.mingw.org). It is using the source code to
calculate CRC32 checksum, which is provided by Krzysztof Dabrowski and ElysiuM
deeZine(http://www.koders.com/). It is zlib(http://www.zlib.net). Special thanks
to IceThunder, for the advice and some instructions.