quake源代码阅读分析(1)

Quake3源码分析之一
                  ----盲人摸象

    不可置否,quake3太大太复杂让人顺藤也摸不到瓜.于是只能通过最原始的方式,架起VC,一步步调试,走走看看.
每天读懂一些东西也是一点进步.
   
    1,winMain函数之命令行参数
      set sv_pure 0 +set vm_cgame 0 +set vm_game 0 +set vm_ui 0 +set r_fullscreen 0
      其中set vm_cgame 0,set vm_game 0,set vm_ui 0,set r_fullscreen 0 在窗口模式下(非全屏)运行quake,
      并且不使用pk3文件里的虚拟机代码(vm code,也许执行效率会比较高,也许就是lib)而是使用由cgame,game,
      ui对应的dll.
     
    2,Q_strncpyz()函数
      与标准库中的strcpy类似,但其检查了参数是否为空,且将目标缓冲区的最后字节置0,以保用其它诸如printf
      之流的函数访问不会越界.
   
    3,Sys_CreateConsole函数
      生成一个窗口,用于接收运行或错误信息.
      其中有两个窗口函数InputLineWndProc和ConWndProc.用于处理用户的输入.
     
    4,Sys_InitStreamThread 函数没有使用.当前运行并没有编译进去.暂不去研究它.
   
    5,Com_Init函数
      (1)要注意C语言中处理异常的机制是setjmp和longjmp,其中包括另外一个函数Com_error.
      (2)介绍一重要的数据结构之com_pushedEvents结构体.
         com_pushedEvents是一个结构数组,类型为sysEvent_t.其定义如下:
         typedef struct
         {
  int    evTime;
  sysEventType_t   evType;
  int    evValue, evValue2;
  int    evPtrLength; // bytes of data pointed to by evPtr, for journaling
  void   *evPtr;   // this must be manually freed if not NULL
  } sysEvent_t;
         其中sysEventType_t定义如下:
         typedef enum {
  SE_NONE = 0, // evTime is still valid
  SE_KEY,  // evValue is a key code, evValue2 is the down flag
  SE_CHAR, // evValue is an ascii char
  SE_MOUSE, // evValue and evValue2 are reletive signed x / y moves
  SE_JOYSTICK_AXIS, // evValue is an axis number and evValue2 is the current state (-127 to 127)
  SE_CONSOLE, // evPtr is a char*
  SE_PACKET // evPtr is a netadr_t followed by data bytes to evPtrLength
  } sysEventType_t;
             
         从注释可以看到sysEventType_t是对sysEvent_t的一个说明,相当于数据访问须知,说明各字段当前是一个什么意义.
         com_pushedEventsHead和com_pushedEventsTail是对以上的数组的首尾位置的一个标记.
        
        (3)Com_InitSmallZoneMemory();
         估计是测试是否有足够的内存.
        
        (4)又一个重要的数据结构之cvar_t结构体
    typedef struct cvar_s {
   char  *name;
   char  *string;
   char  *resetString;  // cvar_restart will reset to this value
   char  *latchedString;  // for CVAR_LATCH vars
   int   flags;
   qboolean modified;   // set each time the cvar is changed
   int   modificationCount; // incremented each time the cvar is changed
   float  value;    // atof( string )
   int   integer;   // atoi( string )
   struct cvar_s *next;
   struct cvar_s *hashNext;
  } cvar_t;
    从其定义来看,很显然这个结构体应用于构建一个链表.与其对应的还有HASh运算.重点看看是如何应用的这个链表的.
    如果从面向对象的角度来看的话,cvar.h 和 cvar.c便是一个变量或函数管理的类.
   
    工作原理好像是这样的,在这个命令管理链表里装都是一些有函数调用的相关信息,如函数指针,参数等.Cmd_AddCommand做的就
    是这个工作.如果想调用某个函数,则只需要提交相应的参数给链表,链表便会逐一运行起来.
   
    实际上这也是一个面向对象的封装思想,对于很多变量并非直接访问,而是通过函数.
   
 (5)分析命令函数之Com_ParseCommandLine
      把第(1)点所讲命令行分成五个单独的命令.