代码分析演示Second Reality

• 团队合作。
• 混淆。

第1部分：简介

演示版

首次接触代码

git clone git@github.com:mtuomi/SecondReality.git

    -------------------------------------------------------------------------------
                                                   
    -------------------------------------------------------------------------------
    Assembly                        99           3029           1947          33350
    C++                            121           1977            915          24551
    C/C++ Header                     8             86            240            654
    make                            17            159             25            294
    DOS Batch                       71              3              1            253
    -------------------------------------------------------------------------------
    SUM:                           316           5254           3128          59102
    -------------------------------------------------------------------------------

• «» 50% .
• Doom.
• 它有十七个makefile。为什么不只是一个？

启动演示

        CD主
        移动U2.EXE数据/ SECOND.EXE
        CD数据
        第二个EXE

建筑

    。<目录> 08/08/2013 16:40
    .. <DIR> 2013/08/01 16:40
    FCINFO10 TXT 48,462 04-10-1993 11:48
    FILE_ID DIZ 378 04-10-1993 11:30
    README 1ST 4.222 1993年10月10日12:59
    现实FC 992.188 07-10-1993 12:59 
    第二个EXE 1,451,093 1993-07-10 13:35
        5个文件2.496,343字节。
        2 Dir（s）262,111,744字节免费。

• SECOND.EXE：在可执行文件中具有所有效果的引擎。
• REALITY.FC：la WADDoom游戏中专有/加密格式的资产（音乐，声音效果，图像）。

• REALITY.FC 包含两个在演示过程中播放的音乐作品（用于填充混淆，并在开始时添加了填充和标记）。
• SECOND.EXE 包含引导加载程序和演示中断服务器（DIS）。
• 最后SECOND.EXE，演示的32个部分（PART）被添加为可执行的DOS文件（已加密）。

• : PART , _start (450 ).
• EXE SECOND.EXE -.
• : Loader DIS 20 . DOS .
• : PART PART .
• / : , PART ( ), : EXE , .
• 任何语言都可以用于PART编程：在代码中，我们可以找到C，Assembly ...和Pascal。

推荐读物

• VGA体系结构：FreeVGA项目
• 大会的艺术（尤其是关于中断和ISR的第17章）。
• 编程PIT 8254
• 由于源代码中充满了“ FAR”和“ NEAR”指针，因此阅读英特尔的基本体系结构文档，尤其是有关指针数据类型的第4.3章，将很有用。
• 综合文章从迈克尔·亚伯拉什图形编程黑皮书：第3章：（禅定时器和PIT），第24章：VGA旅游，章节47，48和49：（模式X）。

第2部分：第二现实引擎

• 引导加载程序作为DOS可执行文件。
• 内存管理器（简单的堆栈池）
• 演示中断服务器（DIS）。

引擎代码

• MAIN/U2.ASM （核心）。
• MAIN/U2A.ASM （公用事业）。
• MAIN/VMODE.ASM （VGA程序）。

    exemus  db 'STARTMUS.EXE',0
    exe0    db 'START.EXE',0
    ...
    exe23   db 'ENDSCRL.EXE',0

    start:
       cli                         ; Disable all interrupts
       mov     ah,4ah              ; Deallocate all memory
       call checkall               ; Check for 570,000 bytes of mem, 386 CPU and VGA
       call file_getexepath        
       call dis_setint             ; Install Demo Interrupt Server on Interrupt 0fch
       call file_initpacking       ; Check exe signature (no tempering) !
       call file_setint            ; Replace DOS routines (only OPENFILE, SEEK and READ) on Interrupt 021h
       call flushkbd               ; Flush the keyboard buffer
       
       call  checkcmdline          ; check/process commandline

       ;======== Here we go! ========
       call vmode_init             ; Init VGA (not necessarly Mode13h or ModeX), each PARTs had its own resolution

       mov si,OFFSET exe0
       call executehigh            ; loaded to high in memory. Used for loading music loaders and stuff.
   
       call  _zinit ; Start music
       call  restartmus

       mov   si,OFFSET exe1     ;Parameter for partexecute: Offset to exec name
       call  partexecute
       ; Execute all parts until exe23

       call fademusic
       ;======== And Done! (or fatal exit) ========

    fatalexit:
       mov cs:notextmode,0
       call vmode_deinit

1. 将DIS中断服务器设置为interrupt 0fch。
2. 在中断时替换DOS系统调用021h（有关更多详细信息，请参见“开发和生产模式”部分）。
3. 通过EMS存储器将音乐下载到声卡。
4. 运行音乐。
5. 执行演示的每个部分。
6. 做完了！

 execute:
      cld
      call  openfile ; Open the DOS executable for this PART
      call  loadexe  ; loads the specified exe file to memory, does relocations and creates psp
      call  closefile
      call  runexe   ;runs the exe file loaded previously with loadexe.
                     ; returns after exe executed, and frees the memory
                     ; it uses.

内存管理器

第3部分：DIS

DIS服务

• 在不同的PART（dis_msgarea）之间交换：DIS提供了三个每个64字节的缓冲区，以便PART可以从前一个PART的加载程序中接收参数。
• Emulation Copper（dis_setcopper）：Amiga Copper模拟器，允许您执行通过VGA状态切换的操作。
• Dev / Prod（dis_indemo）模式：允许PART知道它正在DEV模式下运行（这意味着它必须初始化视频）或以PROD模式从引导加载程序启动。
• VGA帧数（_dis_getmframe）
• 等待VGA逆止器（dis_waitb）。

演示中断服务器代码

• DIS/DIS.ASM（将中断处理程序设置为int 0fch）。
• DIS/DISINT.ASM （DIS程序本身）。
• 由于Second Reality也部分用C编写，因此代码具有C：DIS/DIS.H和的接口DIS/DISC.ASM。

怎么运行的

                          //让我们假装我们是FC开发人员，想直接启动STAR部分。
  C：\> CD DDSTARS            
  C：\ DDSTARS> K

  错误：未加载DIS。 

                          //糟糕，PART在int 0fch处找不到DIS。
  C：\ DDSTARS> CD .. \ DIS
  C：\ DIS> DIS

  演示服务器（DIS）V1.0版权所有（C）1993 The Future Crew
  测试版-编译：93年7月26日03:15:53 
  已安装（int fc）。
  注意：此DIS服务器不支持铜线或音乐同步！
                          // DIS已安装，让我们再试一次。

  C：\ DIS> CD ../DDSTARS
  C：\ DDSTARS> K

铜

• 放置0：打开显示器后（大约在扫描线25上）
• 位置1：反向光束扫描后立即发生（有可能避免）
• 位置2：位于扫描光束的反向光束中

1. 8254芯片的计时器配置为以所需频率触发IRQ0。
2. 8h中断处理程序（在收到IRQ0之后由8259 PIC调用）在此处被替换为过程intti8。

第4部分：开发和生产模式

开发模式

• DIS被加载到驻留的TSR中并通过中断进行访问0cfh。
• 引导加载程序导致DOS中断21h打开，读取，搜索和关闭文件。

• 每个编码人员和美术人员都可以处理可执行文件并分别对其进行测试，而不会影响团队的其他成员。
• 随时可以使用一个较小的演示版SECOND.EXE（无需在末尾添加所有EXE）来测试完整的演示版。每个PART的可执行文件都是使用DOS中断021h从单独的文件加载的。

生产（演示模式）

• 通过中断仍然可以访问DIS 0fch。
• DOS 21h中断API由其自己的Future Crew例程进行了修补，该例程从大文件的末尾打开文件SECOND.EXE。

第5部分：单独的部分

分开的部分

标题	可执行文件	编码器	屏幕截图	资源
	启动文件			主/ STARTMUS.C
	启动文件	威尔迪		START / MAIN.c
隐藏部分	DDSTARS.EXE	威尔迪		DDSTARS / STARS.ASM
Alkutekstit i	可执行文件	威尔迪		阿尔库/ MAIN.C
Alkutekstit II	U2A.EXE	PSI		VISU / C / CPLAY.C
Alkutekstit III	可执行文件	卡车/野生		PAM /
	BEGLOGO.EXE			BEG / BEG.C
格伦茨	可执行文件	PSI		格伦茨/
多图尼	隧道文件	拖把		TUNNELI / TUN10.PAS
Techno	技术文件	PSI		TECHNO / KOEA.ASM
Panicfake	潘宁	PSI		恐慌
Vuori滚动	MNTSCRL.EXE			森林/ READ2.PAS
沙漠之梦星	DDSTARS.EXE	拖把
镜片		PSI
旋转唑	LNS和ZOOM.EXE	PSI		镜片 /
等离子体		威尔迪
血浆	PLZPART.EXE	威尔迪		PLZPART /
迷你矢量球	MINVBALL.EXE	PSI		点/
佩利帕洛斯克罗尔	RAYSCRL.EXE	拖把		水/DEMO.PAS
3D窦场	3DSINFLD.EXE	PSI		科曼/ DOLOOP.C
果冻	JPLOGO.EXE	PSI		JPLOGO / JP.C
向量第二部分	U2E文件	PSI		VISU / C / CPLAY.C
字幕/致谢
	ENDLOGO.EXE			END / END.C
	可执行文件	威尔迪		学分/ MAIN.C
	ENDSCRL.EXE			ENDSCRL / MAIN.C

Alkutekstit（贷方）序列
WILDFIRE的ALKU	PSI的U2A	PAM by TRUG / WILDFIRE

资产

内部单元PART

• ASM。
• C。
• PASCAL：黄铜指关节怪兽（MNTSCRL.EXE），虚线隧道（TUNNELI.EXE）和射线追踪剑（RAYSCRL.EXE）。
• 一些部件甚至走得更远，并使用C生成ASM代码：GLENZ / DOLOOP.C（可下载的多面体）和水效果（3DSINFLD.EXE）。

• 恐慌
• 格伦茨

3D引擎第二现实

• CITY.C（主代码）。
• VISU.C（库visu.lib）。
• AVID.ASM（优化的汇编器视频（清洁，屏幕复制等）。
• ADRAW.ASM（绘制对象和截断）。
• ACALC.ASM（矩阵和快速sin / cos计算）。

      main(){

            scenem=readfile(tmpname);  // Load materials
            scene0=readfile(tmpname);  // Load animation

            for(f=-1,c=1;c<d;c++){  //Load objects
              sprintf(tmpname,"%s.%03i",scene,e);
              co[c].o=vis_loadobject(tmpname);
            }

            vid_init(1);
            vid_setpal(cp);

            for(;;){

                vid_switch();
                _asm mov bx,1   _asm int 0fch // waitb for retrace via copper simulator interrupt call 
                vid_clear();
                
                // parse animation stream, update objects
                for(;;){}

                vid_cameraangle(fov); // Field of vision

                // Calc matrices and add to order list (only enabled objects)
                for(a=1;ac<conum;a++) if(co[a].on) /* start at 1 to skip camera */
                    calc_applyrmatrix(o->r,&cam);

                // Zsort via Bubble Sort
                for(a=0;ac<ordernum;a++)
                    for(b=a-1;b>=0 && dis>co[order[b]].dist;b--)

                // Draw
                for(a=0;ac<ordernum;a++)
                    vis_drawobject(o);
              }
            }
            return(0);
     }

现代系统的端口