读取TX文件，供大家学习参考；希望大家能有用到。仅供参考。代码是VC++VC读取TX文件下载

weixin_39821526 2019-06-13 09:30:13

读取TX文件，供大家学习参考；希望大家能有用到。仅供参考。代码是VC++；读取TX文件，供大家学习参考；希望大家能有用到。仅供参考。代码是VC++读取TX文件，供大家学习参考；希望大家能有用到。仅供参考。代码是VC++
相关下载链接：//download.csdn.net/download/zfbipt2/2561912?utm_source=bbsseo

...全文

12 回复打赏收藏转发到动态举报

写回复

回复

切换为时间正序

请发表友善的回复…

发表回复

读取TX文件，供大家学习参考；希望大家能有用到。仅供参考。代码是VC++；读取TX文件，供大家学习参考；希望大家能有用到。仅供参考。代码是VC++读取TX文件，供大家学习参考；希望大家能有用到。仅供参考。代码是VC++

摘自：http://mbstudio.spaces.live.com/blog/cns!C898C3C40396DC11!955.entry 2007/1/30 oSIP协议栈(及eXoSIP,Ortp等)使用入门（原创更新中）（CopyLeft by Meineson | www.mbstudio.cn，原创文章，欢迎转载，但请保留出处说明！）本文档最新版本及文中提到的相关源码及VC6工程文件请在本站找，嘿嘿~~ （首页的SkyDriver公开文件夹中，可能需要用代理才能正常访问该空间——空间绝对稳定，不会丢失文件！） (最近工作重心不在SIP开发，SO本文档也没有机会更新，有技术问题也请尽量咨询他人，本人不一定能及时回复。) 　　一直没空仔细研究下oSIP，最近看到其版本已经到了3.x版本，看到网上的许多帮助说明手册都过于陈旧，且很多文档内容有点误人子弟的嫌疑～～　　Ｌｉｎｕｘ下ｏＳＩＰ的编译使用应该是很简单的，其Ｉｎｓｔａｌｌ说明文档里也介绍的比较清楚，本文主要就ｏＳＩＰ在Ｗｉｎｄｏｗｓ平台下ＶＣ６．０开发环境下的使用作出描述。　　虽然ｏＳＩＰ的开发人员也说明了，ｏＳＩＰ只使用了标准Ｃ开发库，但许多人在Ｗｉｎｄｏｗｓ下使用ｏＳＩＰ时，第一步就被卡住了，得不到ｏＳＩＰ的ＬＩＢ库和ＤＬＬ库，也就没有办法将ｏＳＩＰ使用到自己的程序中去，所以第一步，我们将学习如何得到ｏＳＩＰ的静态和动态链接库，以便我们自己的程序能够使用它们来成功编译和执行我们的程序。第一阶段：－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－　　先创建新工程，网上许多文档都介绍创建一个Ｗｉｎ３２动态链接库工程，我们这里也一样，创建一个空白的工程保存。　　同样，将ｏＳＩＰ２版本３．０．１ src目录下的Ｏｓｉｐｐａｒｓｅｒ２目录下的所有文件都拷到我们刚创建的工程的根目录下，在ＶＣ６上操作：Ｐｒｏｊｅｃｔ－Ａｄｄ　Ｔｏ　Ｐｒｏｊｅｃｔ－Ｆｉｌｅｓ　　将所有的源程序和头文件都加入到工程内，保存工程。　　这时，我们可以尝试编译一下工程，你会得到许多错误提示信息，其内容无非是找不到osipparser2/xxxxx.h头文件之类。　　处理：在Ｌｉｎｕｘ下，我们一般是将头文件，ｌｉｂ库都拷到/usr/inclue;/usr/lib之类的目录下，ｃ源程序里直接写#include 时，能直接去找到它们，在ＶＣ里，同样的，最简单的方法就是将ｏＳＩＰ２源码包中的Ｉｎｃｌｕｄｅ目录下的 osipparser2目录直接拷到我们的Ｗｉｎｄｏｗｓ下默认包含目录即可，这个目录在ＶＣ６的Ｔｏｏｌ－Ｏｐｔｉｏｎｓ－Ｄｉｒｅｃｔｏｒｉｅｓ里设置，（当然，如果你知道这一步，也可以不用拷贝文件，直接在这里把ｏＳＩＰ源码包所在目录加进来就可以了），默认如果装在Ｃ盘，目录则为 C:\Program Files\Microsoft Visual Studio\VC98\Include。　　这时，我们再次编译我们的工程，顺利编译，生成osipparser2.dll，这时，网上很多文档里可能直接就说，这一步也会生成libs目录，里面里osipparser2.lib文件，但我们这里没有生成：）　　最简单的方法，不用深究，直接再创建一个工程，同上述创建动态链接库方法，创建一个Ｗｉｎ３２静态链接库工程，直接编译，即可得到osipparser2.lib。－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－　　上面，我们得到了Ｏｓｉｐ的解析器开发库，下面再编译完整的Ｏｓｉｐ协议栈开发库，同样照上述方法，分别创建动态链接库工程和静态链接库工程，只是要拷的文件换成src下的osip目录下文件和include下的osip目录，得到osip2.dll和osip2.lib。　　在编译osip2.dll这一步可能会再次得到错误，内容含义是找不到链接库，所以，我们要把前面编译得到的osipparser2.lib也拷到osip工程目录下，并在ＶＣ６中操作：　　Ｐｒｏｊｅｃｔ－Ｓｅｔｔｉｎｇ－Ｌｉｎｋ中的Ｏｂｊｅｃｔ／Ｌｉｂｒａｒｙ　Ｍｏｄｕｌｅｓ： kernel32.lib user32.lib ... xxx.lib之类的内容最后增加: osipparser2.lib 　　保存工程后再次编译，即可成功编译osip2.dll。－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－　　至此，我们得到了完整的ｏＳＩＰ开发库，使用时，只需在我们的程序里包含ｏＳＩＰ的头文件，工程的链接参数里增加osipparser2.lib和osip2.lib即可。－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－　　下面我们验证一下我们得到的开发库，并大概了解一下ＯＳＩＰ的语法规范。　　在VC里创建win32控制台程序工程，将libosip源码包的SRC目录下的Test目录内的C源程序随便拷一个到工程时，直接编译（工程设置里照前文方法在link选项里增加osip2.lib,osipparser2.lib引用我们之前成功编译得到的静态库文件）就可以运行（带参数运行，参数一般为一个文本文件，同样从Test目录的res目录里拷一个与源文件同名的纯文本文件到工程目录下即可）。　　该目录下的若干文件基本上是测试了Osip的一些基本功能函数，例如URI解析之类，可以大概了解一下oSIP的语法规范和调用方法，同时也能校验一下之前编译的OSIP开发库能否正常使用，成功完成本项工作后，可以进入下一步具体的oSIP的使用学习了。－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－　　由于ｏＳＩＰ是比较底层的ＳＩＰ协议栈实现，新手较难上手，而官方的示例大都是一些伪代码，需要有实际的例子程序参考学习，而最好的例子就是同样官方发布的ｏＳＩＰ的扩展开发库exosip２，使用ｅｘｏＳＩＰ可以很方便地快速创建一个完整的ＳＩＰ程序（只针对性地适用于SIP终端开发用，所以我们这里只是用它快速开发一个SIP终端，用来更方便地学习oSIP，要想真正掌握SIP的开发，需要掌握oSIP并熟读RFC文档才行，exoSIP不是我们的最终学习目的），通过成功编译运行一个自己动手开发出的程序，再由浅入深应该是初学都最好的学习方法通过对使用exosip开发库的使用创建自己的ＳＩＰ程序，熟悉后再一个函数一个函数地深入学习exosip提供的接口函数，就可以深入理解osip 了，达到间接学习ｏＳＩＰ的目的，同时也能从eXoSIP中学习到正确使用ｏＳＩＰ的良好的编程风格和语法格式。　　而要成功编译ＥｘｏＳＩＰ，似乎许多人被难住了，直接在ＸＰ－ｓｐ２上，用ＶＣ６，虽然你使用了ｅＸｏＳＩＰ推荐的winsock2.h，但是会得到一个 sockaddr_storage结构不能识别的错误，因为vc6自带的开发库太古董了，需要升级系统的Ｐｌａｔｆｏｒｍ　ＳＤＫ，下载地址如下： http://www.microsoft.com/msdownl ... PSP2FULLInstall.htm（ＶＣ６的支持已经停止，这是ＶＣ６能使用的最新ＳＤＫ）　　成功安装后编译前需加OSIP_MT宏，以启用线程库，否则在程序中使用eXoSIP库时会出错，而编译时也会得到许多函数未定义的Warning提示，编译得到exosip2.lib供我们使用，当然，在此之前需要成功编译了osip2和osipparser2，而在之后的实际使用时，发现ｏＳＩＰ也需要增加ＯＳＩＰ＿ＭＴ宏，否则ＯＳＩＰ＿ＭＴ调用ｏＳＩＰ的线程库时会出错，所以我们需要重新编译ｏＳＩＰ了：），因为ｅＸｏｓｉｐ是基于ｏＳＩＰ的（同上方式创建静态和动态链接库工程，并需在Ｌｉｎｋ中手工添加ｏＳＩＰ和ｏＳＩＰｐａｒｓｅｒ的lib库）。－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－　　创建新工程，可以是任意工程，我们从最简单的Ｗｉｎ３２控制台程序开始，为了成功使用ｏＳＩＰ，我们需要引用相关库，调用相关头文件，经过多次试验，发现需要引用如下的库： exosip2.lib osip2.lib osipparser2.lib WSock32.Lib IPHlpApi.Lib WS2_32.Lib Dnsapi.lib 　　其中，除了我们上面编译得到的三个oSIP库外，其它库都是系统库，其中有一些是新安装的Ｐｌａｔｆｏｒｍ　ＳＤＫ所新提供的。　　至此，我们有了一个简单的开发环境了，可以充分利用网上大量的以ｏＳＩＰ为基础的代码片段和官方说明文档开始具体函数功能的测试和使用了：）－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－　　我们先进行一个简单的纯ＳＩＰ信令（不带语音连接建立）的ＵＡＣ的ＳＩＰ终端的程序开发的试验（即一个只能作为主叫不能作为被叫的的ＳＩＰ软电话模型），我们创建一个ＭＦＣ应用程序，对话框模式，照上面的说明，设置工程包含我们上面得到的ｏＳＩＰ的相关开发库及ＳＤＫ的一些开发库，并且由于默认ＬＩＢＣ的冲突，需要排除MSVCRT[D]开发库（其中Ｄ代表Ｄｅｂｕｇ模式下，没有Ｄ表示Ｒｅｌｅａｓｅ模式下），直接使用ｅＸｏｓｉｐ的几个主要函数就可以创建一个基本的ＳＩＰ软电话模型。　　其主要流程为：　　初始化ｅＸｏｓｉｐ库－启动事件监听线程－向ＳＩＰ　Ｐｒｏｘｙ注册－向某ＳＩＰ终端（电话号码）发起呼叫－建立连接－结束连接　　初始化代码： int ret = 0; ret = eXosip_init (); eXosip_set_user_agent("##YouToo0.1"); if(0 != ret) { AfxMessageBox("Couldn't initialize eXosip!\n"); return false; } ret = eXosip_listen_addr (IPPROTO_UDP, NULL, 0, AF_INET, 0); if(0 != ret) { eXosip_quit (); AfxMessageBox("Couldn't initialize transport layer!\n"); return false; } 　　启动事件监听线程： AfxBeginThread(sip_uac,(void *)this); 　　向ＳＩＰ　Ｐｒｏｘｙ注册： eXosip_clear_authentication_info(); eXosip_add_authentication_info(uname, uname, upwd, "md5", NULL); real_send_register(30);　　/* 自定义函数代码请见源码 */ 　　发起呼叫（构建假的ＳＤＰ描述，实际软电话使用它构建ＲＴＰ媒体连接）： osip_message_t *invite = NULL; /* 呼叫发起消息体 */ int i = eXosip_call_build_initial_invite (&invite, dest_call, source_call, NULL, "## YouToo test demo!"); if (i != 0) { AfxMessageBox("Intial INVITE failed!\n"); } char localip[128]; eXosip_guess_localip (AF_INET, localip, 128); snprintf (tmp, 4096, "v=0\r\n" "o=josua 0 0 IN IP4 %s\r\n" "s=conversation\r\n" "c=IN IP4 %s\r\n" "t=0 0\r\n" "m=audio %s RTP/AVP 0 8 101\r\n" "a=rtpmap:0 PCMU/8000\r\n" "a=rtpmap:8 PCMA/8000\r\n" "a=rtpmap:101 telephone-event/8000\r\n" "a=fmtp:101 0-11\r\n", localip, localip, "9900"); osip_message_set_body (invite, tmp, strlen(tmp)); osip_message_set_content_type (invite, "application/sdp"); eXosip_lock (); i = eXosip_call_send_initial_invite (invite); eXosip_unlock (); 　　挂断或取消通话： int ret; ret = eXosip_call_terminate(call_id, dialog_id); if(0 != ret) { AfxMessageBox("hangup/terminate Failed!"); } 　　可以看到非常简单，再借助于ｏＲＴＰ和Ｍｅｄｉａｓｔｒｅａｍｅｒ开发库，来快速为我们的ＳＩＰ软电话增加ＲＴＰ和与系统语音ＡＰＩ接口交互及语音编码功能，即可以快速开发出一个可用的ＳＩＰ软电话，关于ｏＲＴＰ和Ｍｅｄｉａｓｔｒｅａｍｅｒ的相关介绍不是本文重点，将在有空的时候考虑增加相应使用教程，文章前提到的地方可以下载基本可用的完整ＳＩＰ软电话的ＶＣ源码工程文件供参考使用，完全ＣｏｐｙＬｅｆｔ，欢迎转载，但请在转载时注明作者信息，谢谢！第二阶段：－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－　　得到了一个ＳＩＰ软电话模型后，我们可以根据软电话的实际运行表现（结合用Ethereal抓包分析）来进行代码的分析，以达到利用eXoSIP来辅助我们学习ｏＳＩＰ的最终目的（如要快速开发一个可用的ＳＩＰ软电话，请至前面提到的论坛去下载使用ｏＲＴＰ和Ｍｅｄｉａｓｔｒｅａｍｅｒ快速搭建的一个基本完整可用的ＳＩＰ软电话##YouToo 0.1版本的ＶＣ源码工程文件作参考）。　　现在从eXosip的初始化函数开始入手，来分析oSIP的使用，这是第二阶段，第三阶段就是深入学习oSIP的源码了，但大多数情况下应该没有必要了，因为在第二阶段就有部分涉及到第三阶段的工作了，而且ｏＳＩＰ的源码也就大多是一些ＳＩＰ数据的语法解析和状态机的实现，能深入理解了ＳＩＰ协议后，这些只是一种实现方式，没必要完全去接受，而是可以用自己的方式和风格来实现一套，比如，更轻量化更有适用目的性的方式，ｏＳＩＰ则只起参考作用了。　　eXosip_init()是ｅＸｏｓｉｐ的初始化函数，我们来看看它的内部实现: 　　首行是定义的　osip_t *osip，这在oSIP的官方手册里我们看到，所有使用oSIP的程序都要在最开始处声明一个osip_t的指针，并使用 osip_init(&osip)来初始化这个指针，销毁这个资源使用osip_release(osip)即可。　　我们可以在代码中看到很多OSIP_TRACE，这是调试输出宏调用了函数osip_trace，可以用ENABLE_TRACE宏来打开调试以方便我们开发调试。　　其它就是很多的eXosip_t的全局变量eXosip的一些初始化操作，包括最上面的memset (&eXosip, 0, sizeof (eXosip))完全清空和下面的类似eXosip.user_agent = osip_strdup ("eXosip/" EXOSIP_VERSION)的exosip变量的一些初始值设置，其中有一个eXosip.j_stop_ua = 0应该是一个状态机开关，后面可以看到很多代码检测这个变量来决定是否继续流程处理，默认置成了0表示现在exosip的处理流程是就绪的，即ua是 not stop的。　　　　osip_set_application_context (osip, &eXosip)是比较有意思的，它让下面的eXosip_set_callbacks (osip)给osip设置大量的回调函数时，能让osip能访问到eXosip这个全局变量中设置的大量程序运行时交互的信息，相当于我们在ＶＣ下开启一个线程时，给线程传入的一个ｖｏｉｄ指针指向我们的ＭＦＣ应用程序的当前dialog对象实例，可以用void *osip_get_application_context (osip_t * osip)这个函数来取出指针来使用，不过好象exosip中并没有用到它，可能是留给个人自已扩展的吧:) 　　　　还能看到初始化代码前面有一段ＷＩＮ３２平台下的ＳＯＣＫ的初始化代码，可以知道eXosip是用的原生的winsock api函数，也就是我们可能以前学过的用VC和WINAPI写sock程序时(不是ＭＦＣ)，用到的那段ＳＯＣＫ初始代码，还有一段有意思的代码，就是 jpipe()函数，它们返回的是一个管道，一个有２个整型数值的数组（一个进一个出），查看其代码发现，非WIN32平台是直接使用的pipe系统函数，而ＷＩＮ３２下则是用一对ＴＣＰ的本地ＳＯＣＫ连接来模拟的管道，一个ＳＯＣＫ写一个ＳＯＣＫ读，这段代码是比较有参考价值的：） j = 50; while (aport++ && j-- > 0) { 　　raddr.sin_port = htons ((short) aport); 　　if (bind (s, (struct sockaddr *) &raddr, sizeof (raddr)) transactionid)); } 　　即，只是打印一下调试，并没有完整实现什么功能，我们学习时，完全可以用相同的方法，定义一大堆回调函数，并不忙想怎么完全实现，先都是只打印一下调试信息，看具体的应用逻辑根据抓包测试分析和看调试看程序走到了哪一步，调用了哪一个回调，来明白具体回调函数要实现什么用途，再来实现代码就方便多了，当然，如果看透了ＲＦＣ文档，应该从字面就能知道各个回调函数的用途了，这是后话，不是谁都能快速完全看懂ＲＦＣ的，所以我们要参考eXosip：）　　　　我们对其中的重要的回调函数进行逐个的分析：　　－－－－－－－－－－－－－－－－－－－－－－－－－－－　　osip_set_cb_send_message (osip, &cb_snd_message)　ＳＩＰ消息发送回调函数　　这个函数可能是最重要的回调函数之一，消息发送，包括请求消息和回应消息，一般情况下，状态机的状态就是由它控制的，发起一个消息初始化一个状态机，回应一个消息对状态机修改，终结消息发送结束状态机…… 　　看cb_snd_message的函数实现，要以发现，其主要代码是对参数中的要发送的消息osip_message_t * sip进行分析，找出消息要发送的真实char *host,int port的值（这些参数可以省略，但要发送消息肯定需要host和port，所以要从sip中解析），最后根据sip中解析出的传输方式是TCP还是 UDP选择最终进行消息发送处理的函数cb_udp_snd_message，cb_tcp_snd_message处理（它们的参数一致，即本函数只是补全一些省略的参数并对消息进行合法性检查）。　　**毕竟eXosip是一个通用的开发库，它考虑了要支持TCP,UDP,TCPs,IPV4,IPV6，WIN32,*nix,WINCE等等多样化的复杂环境，所以，我们可以略过我们暂时不需要的部分，比如，ＩＰＶ６相关的代码实现等。　　　　由于我们大多数情况下ＳＩＰ是用的ＵＤＰ，所以先来看一下cb_udp_snd_message的实现，它从全局变量exosip中获取可用的 sock，并尽最大能力解析出host和port（？？难道前面的函数还不够解析彻底？？如最终仍无port信息则默认设置为5060），使用 osip_message_to_str (sip, &message, &length)函数将要发送的格式化的ＳＩＰ消息转换成能用ＳＯＣＫ传输的简单数据并发送即完成消息发送，代码中有许多复杂的环境探测和错误控制等等等等，我们可以暂时不用过多关注，可以继续向下，结尾处有一个keeplive相关代码，从代码字面分析，可能是ＳＩＰ的Register消息的自动重发相关代码，可以在后面再细化分析。　　cb_tcp_snd_essage的函数实现要比上文的udp的实现简单很多，主要是环境探测错误控制方面，因为毕竟tcp是稳定连接的，对比一下代码，可以看到主要流程还是将ＳＩＰ消息转换后，发送到从ＳＩＰ消息中解析出的host和port对应的目标。　　　　看完两个函数，可以知道，eXosip需要有两个sock，是一个数组，0是给ＵＤＰ用的，１是给ＴＣＰ用的，要用ＳＯＣＫ当然要初始化，就是下文要介绍的eXosip的网络相关的初始化了，上面的exosip_init可以看成是这个开发库的系统初始化吧：）　　　至些，我们应该知道了ｏＳＩＰ开发的ＳＩＰ应用程序的消息是从哪里发出的吧，对了，就是从这个回调函数里，所谓万事开头难，就象开发ＷＩＮ３２应用程序时，找到了ＷＩＮ３２程序的main函数入口下面的工作就好办了，下面就都是为一些事件消息开发对应的处理函数而已了：）　　osip_set_kill_transaction_callback　事务终结回调函数　　对应ＩＣＴ，ＩＳＴ，ＮＩＣＴ，ＮＩＳＴ客户/服务器注册/非注册事务状态机的终结，主要是使用osip_remove_transaction (eXosip.j_osip, tr)将当前tr事务删除，再加上一系列的清理工作，其中，NICT即客户端的非Ｉｎｖｉｔｅ事务的清理比较复杂一些，要处理的内容也比较多，可以根据实际应用的情况进行有必要的清理工作：）　　cb_transport_error　传输失败处理回调　　对应于上面说到的四种事务状态机，如果它们在处理时失败，则在这时进行统一处理。　　从代码可知，只是在NOTIFY,SUBSCRIBE,OPTION操作失败才进行处理，其它错误可直接忽略。　　osip_set_message_callback　消息发送处理回调　　根据type不同，表示不同的消息发送状态　　OSIP_XXX_AGAIN 重发相关消息　　OSIP_ICT_INVITE_SENT 发起呼叫　　OSIP_ICT_ACK_SENT　ＡＣＫ回应　　OSIP_NICT_REGISTER_SENT　发起注册　　OSIP_NICT_BYE_SENT　ＢＹＥ发出　　OSIP_NICT_CANCEL_SENT　Ｃａｎｃｅｌ发出　　OSIP_NICT_INFO_SENT，OSIP_NICT_OPTIONS_SENT，OSIP_NICT_SUBSCRIBE_SENT，OSIP_NICT_NOTIFY_SENT，OSIP_NICT_UNKNOWN_REQUEST_SENT 　　我们可以看到，eXosip没有对它们作任何处理，我们可以根据自己需要，比如，重发2xx消息前记录一下日志之类的，扩展一下retransmission的处理方式，发起Invite前记录一下通话日志等等。　　OSIP_ICT_STATUS_1XX_RECEIVED　uac收到1xx消息，一般是表示对端正在处理中，这时，主要是设置一下事务状态机的状态值，并对会话中的osip的一些参数根据返回值进行相应设置，里面有许多条件判断，但我们常用的一般是100,180,183的判断而已，暂时可以忽略里面复杂的判断代码。　　OSIP_ICT_STATUS_2XX_RECEIVED uac收到2xx消息，这里主要跟踪一下Register情况下的2xx，表示注册成功，这时会更新一下exosip的注册字段值，以便让eXosip能自动维护uac的注册，ＢＹＥ的２ｘｘ回应是终结消息，Invite的2xx回应，则主要是初始化一下会话相关的数据，表示已成功建立连接。　　其它４ｘｘ，５ｘｘ，６ｘｘ则分别是对应的处理，根据实现情况进行概要的查看即可。　　report_event (je, sip)是代码中用来进行事件处理的一个函数，跟踪后发现，其最终是使用了我们上文提到的ｊｐｉｐｅ管道，以便在状态机外实时观测状态机内的处理信息。　　　　OSIP_NIST_STATUS_XXX_SENT即对应于上面的uac的处理，这里是uas的对应的消息处理，相比较于uac简单一点。　　前面简单介绍了一下大量的回调函数及它们的概要处理逻辑，可能会比较混乱，暂时不用管它，只需要记得一个大概的形象，知道一个ＳＩＰ处理程序是通过osip_set_cb_send_message回调函数来实现真实地发送各种ＳＩＰ消息，并且ＳＩＰ的标准事务模型是由ｏＳＩＰ实现好了，我们只需要给不同的事务状态设置不同的回调处理函数来处理事务，具体的状态变化和内部逻辑不用管就可以了。　　下面来说一下消息处理回调函数用到的ＳＯＣＫ的初始化函数，即我们上面说的除了系统初始化外的网络初始化函数eXosip_listen_addr：　　从上文知道了，系统将初始化两个ＳＯＣＫ，一个ＵＤＰ一个ＴＣＰ，但查看代码发现还有第三个，ＴＣＰｓ的，但好象还不能实用，现在不管它，代码首先是根据传输是ＵＤＰ还是ＴＣＰ来设置对应的数组值，并且如果没有提供ＩＰ地址和端口号，系统会自动取出本机网络接口并创建可用的ＳＯＣＫ（http_port 的方式暂不用考虑）。　　ＳＯＣＫ初始化后，如何开始ＳＩＰ事务的呢？看到这个调用eXosip.j_thread = (void *) osip_thread_create (20000, _eXosip_thread, NULL)，对的，这里启用了一个线程，即，ｅＸｏｓｉｐ是调用ｏＳＩＰ的线程函数（没用系统提供的线程函数，是为了跨平台）进行事务处理的状态机逻辑是在一个线程中处理的，这样就明白了为什么一直没能看到顺序执行下来的程序启动代码了，接下去看，线程实际处理函数是_eXosip_thread，这里面的代码中，我们看到了上文提到的状态机控制开关变量while (eXosip.j_stop_ua == 0)，即，当j_stop_ua设置为1时，osip_thread_exit ()结束事务处理即程序终结，再接下去看，_eXosip_execute是最终的处理函数了，而且它在程序未终结情况下是一直逻辑在执行，注意，要启用ｏＳＩＰ的多线程宏OSIP_MT。　　　　看到_eXosip_execute的代码中有很多时间函数和变量，仔细看，除去一些控制代码，主要处理函数是eXosip_read_message (1, lower_tv.tv_sec, lower_tv.tv_usec)，即取出消息，1表示只取出一条消息，其代码量非常的大，但同样的，其中也许多的控制代码和错误检测代码，我们在查看时可以暂时忽略掉它们。　　eXosip_read_message读取消息时，即没有采用sock的block也没有用非block方式，而是采用了select方式，具体应用可查询fd_set相关文档。　　根据jpipe_read (eXosip.j_socketctl, buf2, 499)，我们可以估计，buf2中应该是保存的我们的控制管道的数据，具体作用至些还没有表现出来，应该是用来反映一些状态机内部的警示之类的信息，实际的ＳＩＰ的处理的状态机的数据是存放在buf中，使用_eXosip_recvfrom获取的，获取后sipevent = osip_parse (buf, i)解析，使用osip_find_transaction_and_add_event (eXosip.j_osip, sipevent)来查询事件对应的事务状态机，找到后就如同其注解所说明的，/* handled by oSIP ! */，即我们上文设置的那一大堆回调函数，至此，我们知道了整个ＳＩＰ应用所处理的大概流程了。　　如果没有找到事务状态机呢？直接丢弃吗？不是的，如果这是一个回应消息，但没有事务状态机处理它，那它是一个错误的，要进行清理后才能丢弃，而如果是一个请求，那更不能丢弃了，因为UAS事务状态机要由它来启动创建的(回应消息表示本地发出了请求消息，即ＵＡＣ行为，事务状态机应是由启动ＵＡＣ的代码初始化启动的)，整个逻辑应该是很简单的，但ｅＸｏｓｉｐ的实现代码却非常多，可见其花了非常多的精力在保证会话的稳定性和应付网络复杂情况上，我们可以对其进行大量的精简来构建满足我们需求的代码实现。　　先来看错误的回应消息的处理函数eXosip_process_response_out_of_transaction，可以看到其代码就是一大堆的赋值语句，XXX= NULL，即将一大堆的运行时变量清空，再调用osip_event_free清空事件，或者就是一些复杂的情况下，需要通过解析现在的运行时数据，从中分析出“可能”的正在等待回应的对端，并发送相关终结通知消息等等，可以根据实际需要进行简化。　　请求事件的处理 eXosip_process_newrequest，首先是对事件进行探测，MSG_IS_INVITE、MSG_IS_ACK、 MSG_IS_REQUEST……，对事件进行所属状态机分类，随后使用_eXosip_transaction_init (&transaction,(osip_fsm_type_t) tx_type,eXosip.j_osip, evt->sip)根据探测结果进行状态机初始化，实际调用的是osip_transaction_init，初始化后即将事件入状态机 osip_transaction_add_event (transaction, evt)，由状态机自动处理后调用相应回调函数处理逻辑了。当然，ｅＸｏｓｉｐ为方便快速开发ＳＩＰ终端应用，在下面又添加了许多自动化的处理代码，来和我们在回调函数中设置的处理代码相区分。　　线程调用的事件处理函数代码最后是 if (eXosip.keep_alive > 0) { 　　_eXosip_keep_alive (); } 　　这段代码印证了上文提到了，keep_alive是用来设置是否自动重新注册，由_eXosip_keep_alive函数来实现自动将eXosip全局变量中保存的注册消息解析后自动根据需要重新向ＳＩＰ服务器发起Ｒｅｇｉｓｔｅｒ注册。　　同样，因为注册消息发起是ＵＡＣ的行为，将它放在这里，可以看出来所有事件消息的事务状态机处理都是在这里，只不过这里只创建ＵＡＳ的事务状态机，ＵＡＣ的事务状态机的创建则要继续到下面找了，从我们的ＹｏｕＴｏｏ软电话代码中可知，发起呼叫和发起注册分别调用了 eXosip_call_send_initial_invite，eXosip_register_send_register这两个函数（另外用到的两个build函数则是分别构建这两个send函数要发送的ＳＩＰ消息），查看这两个函数可知，ＵＡＣ的事务处理状态机是在这里进行初始化的。　　eXosip_register_send_register中可以看到是_eXosip_transaction_init (&transaction, NICT, eXosip.j_osip, reg)初始化ＵＡＣ状态机，实际也同ＵＡＳ是调用的osip_transaction_init函数，同样使用 osip_transaction_add_event (transaction, sipevent)将事件入状态机，状态机随后将自动处理调用相应回调函数处理逻辑了。　　另有osip_new_outgoing_sipmessage(reg)，表示发送消息，到这里，我们应该可以理解，真实的发送操作，是要到由状态机处理后，调用了消息发送回调函数才真正地将注册消息发送出去的。　　同注册消息发送，它是ＮＩＣＴ状态机，呼叫消息的发送是ＩＣＴ，由eXosip_call_send_initial_invite处理，_eXosip_transaction_init (&transaction, ICT, eXosip.j_osip, invite)初始化了状态机，之前还有一个eXosip_call_init是用来初始化eXosip的一些参数的，暂时不管它，同样 osip_new_outgoing_sipmessage (invite)发送呼叫消息，但实际还是要状态机处理后调用消息发送回调函数真实发送呼叫请求函数的，osip_transaction_add_event (transaction, sipevent)则标准地，将事件入状态机，状态机将能处理随后的应用逻辑调用相应的回调函数了。　　好了，作了这么多的分析，我们了解了ｅＸｏｓｉｐ是怎样调用ｏＳＩＰ来形成被我能方便地再次调用的了，可以看到，为了实现最大限度的跨平台和兼容性，代码中有大量的测试代码，宏定义和错误再处理代码，看起来非常吃力，但了解了其主要的调用框架：　　初始化，回调函数设置，ＵＡＣ和ＵＡＳ事务处理状态机的启动，事件处理流程等，就可以基本明白了ｏＳＩＰ各个函数的主要作用和正确的用法了，下一步，可以参考ｅＸｏｓｉｐ来针对某个应用，去除掉大量暂时用不到的代码，来构建一个简单的ＳＩＰ软电话和ＳＩＰ服务器，来进一步深入ｏＳＩＰ学习应用了。　－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－－ [下回预告：完全基于ｏＳＩＰ的软电话实现及ｏＳＩＰ进一步学习] （CopyLeft by Meineson | www.mbstudio.cn，原创文章，欢迎转载，但请保留出处说明！）附件为原作者提供的

文件包含漏洞是一种最常见的漏洞类型，它会影响依赖于脚本运行时的web应用程序。当应用程序使用黑客控制的变量构建可执行代码的路径时，文件包含漏洞会导致黑客任意控制运行时执行的文件。文件包含漏洞分为本地文件包含(Loacl File Inclusion,LFI)和远程文件包含(Remote File Inclusion,RFI)。这种漏洞貌不惊人，却危害很大。通过文件包含漏洞，可以读取系统中的敏感文件，源代码文件等，如密码文件，通过对密码文件进行暴力破解。若破解成功则可获取操作系统的用户账户，甚至可通过开放的远程连接服务进行连接控制。另外不管是本地文件包含还是远程文件包含，文件包含漏洞还可能导致执行任意代码。本节课程通过代码讲解文件包含漏洞的实战，深入理解文件包含漏洞的原理。

HGE 系列教材（1） --- 简介 HGE 是一个硬件加速（Hardware accelerated）的2D 游戏引擎（Game Engine）， HGE 是一个富有特性的中间件，可以用于开发任何类型的2D 游戏。HGE 封装性良好，以至于你仅仅需要关系游戏逻辑（Game Logic），而不需要在意DirectX，Windows 消息循环等。 HGE 架构在DirectX 8.0 之上，能够跑在大多数的Windows 系统上。 1. 选用HGE 的理由： 1）专业化--- 专注于2D 领域 2）简单化--- 非常容易使用 3）技术优势--- 基于Direct3D API 有较好的性能和特性 4）免费--- 对于个人或者商业用户都免费，遵循zlib/libpng license 5）代码高度的一致性--- 代码是否具有一致性，是衡量代码质量的标准之一（《Co de Reading: The Open Source Perspective》） 2. 体系结构： HGE 有3 个抽象层（layers of abstraction）： 1）核心函数（Core Functions）处于核心的函数和例程（routines），被整个系统所依赖。 2）辅助类（Helper Classes）游戏对象相关的类，架构于HGE Core Functions 层之上，辅助用户进行游戏开发。 3）创作工具（Authoring Tools）用于游戏开发的一组工具。从上图可以看见： 1）用于代码只需要架构在HGE Helper Classes 之上 2）通常游戏资源（Game Resources）需要使用HGE 创作工具来产生 3. 体系结构概述： 1）Core Functions 层 <1> 图形格式支持：支持BMP, JPG, PNG, TGA, DDS, DIB 文件格式 <2> 支持窗口模式和全屏模式 <3> 音频支持和音乐回放（music playback）：支持WAV, MP3, MP2, MP1 an d OGG 音频文件格式（audio file formats），支持MO3, IT, XM, S3M, MTM, MO D and UMX 音乐文件格式（music file formats），支持压缩流的回放。声音大小和声道的控制 <4> 输入设备支持：鼠标和键盘 <5> 资源：读取硬盘上的资源，支持ZIP 打包的文件格式 <6> 日志支持 2）Helper Classes 层 <1> 精灵（Sprites）和动画（Animations）对于所有硬件设备特性的直接支持：锚点（anchor）支持，伸展、缩放、旋转的支持，不同的回放模式的支持 <2> 字体读取和渲染（render）位图字体，多种字体排列方式，旋转和缩放字体，字符串宽度计算等 <3> 粒子系统（particle systems）和网格变形（distortion mesh）高效的粒子系统，可用于创建烟雾、爆炸、魔法效果等，提供粒子系统的管理，支持定界盒（bounding box）计算和冲突检测（collision detection） <4> 资源管理：通过简单的函数调用，来创建复杂的对象，自动的内存管理。对于资源组（resource groups）采用预先缓存和特殊的清除处理（这是一种通过控制对象分配和释放来提高效率的方法） <5> GUI：强大而灵活的GUI 管理，支持动画式的GUI <6> 矢量（Vectors），对于2D 矢量的完全支持 3）Authoring Tools 层 <1> 资源的打包（pack）：HGE 使用ZIP 格式的资源包，你可以使用任何的打包工具，甚至还可以给资源包加密 <2> 纹理（Texture）工具 <3> 粒子系统编辑器：能够设定粒子的速度，方向，生命周期，轨迹，颜色，透明等 <4> 位图字体编辑器：运行通过系统中已经安装的字体来创建位图字体，你可以使用图形编辑器来为位图字体添加额外的效果 HGE 系列教材（2） --- 安装 HGE 在HGE 的文档中有详细谈到如何安装的问题，这里讲一下VC6 平台的安装问题： 1. 下载完HGE 之后，需要使用到lib\vc 文件夹下的库文件以及include 目录下的头文件 2. 打开 Tools->Options->Directories 如上两图，添加路径 3. 在游戏开发中使用HGE 首先建立一个空的Win32 工程，然后选择Project->Settings...->Link 按图所示，输入hge.lib 和hgehelp.lib 当然，也可以使用预编译器指令pragram 来打到同样的目的。 HGE 系列教材（3） --- 初试 HGE 当HGE 安装完成之后，就可以使用了，关于HGE 的安装，可以参考《HGE 系列教材（2） --- 安装HGE》现在使用HGE 开发一个极小的程序： 1. 包含hge.h 文件，并且定义一个HGE 的指针，通过这个指针，我们可以访问HGE Core Functions 层的函数。 #include HGE *pHge = 0; 使用完HGE 指针之后，需要释放这个指针，pHGE->Release(); 2. 帧函数（Frame Function）是一个用户定义的函数，每一帧时间，它会被HGE Engi ne 调用一次，函数返回true，则调用停止： bool FrameFunc() { if (hge->Input_GetKeyState(HGEK_ESCAPE)) { return true; } return false; } 3. 建立一个WinMain 函数，WinMain 函数是标准的Windows 应用程序入口，这里，我们首先初始化HGE 指针： int WINAPI WinMain( HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nShowCmd) { pHge = hgeCreate(HGE_VERSION); // ... pHge->Release(); return 0; } 通过HGE 指针，我们才可以访问HGE Engine 的接口。调用了hgeCreate 函数之后，不要忘记了使用Release 函数释放资源。 4. 初始化操作: 有一些初始化操作需要完成，使得程序能够跑起来： // 设置帧函数 pHge->System_SetState(HGE_FRAMEFUNC, FrameFunc); // 设置窗口模式 pHge->System_SetState(HGE_WINDOWED, true); // 设置不使用声音 pHge->System_SetState(HGE_USESOUND, false); // 设置标题为"Minimal HGE" pHge->System_SetState(HGE_TITLE, "Minimal HGE"); 最后需要调用函数System_Initiate 来完成初始化操作，这个函数返回值是一个bool 类型的变量，如果是true 那么表示初始化成功，如果是false 表示出错，这时候可以通过System_GetErrorMessage 函数来获取错误消息： if (pHge->System_Initiate()) { pHge->System_Start(); } else { MessageBox(NULL, pHge->System_GetErrorMessage(), "Error", MB_O K | MB_ICONERROR | MB_APPLMODAL); } 再程序结束的时候，需要释放资源： pHge->System_Shutdown(); pHge->Release(); 5. 整个完整的程序如下： #include HGE* pHge = 0; bool FrameFunc() { if (pHge->Input_GetKeyState(HGEK_ESCAPE)) { return true; } return false; } int WINAPI WinMain( HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nShowCmd) { pHge = hgeCreate(HGE_VERSION); pHge->System_SetState(HGE_FRAMEFUNC, FrameFunc); pHge->System_SetState(HGE_WINDOWED, true); pHge->System_SetState(HGE_USESOUND, false); pHge->System_SetState(HGE_TITLE, "HGE 小程序"); if (pHge->System_Initiate()) { pHge->System_Start(); } else { MessageBox(NULL, pHge->System_GetErrorMessage(), "Error", MB_O K | MB_ICONERROR | MB_APPLMODAL); } pHge->System_Shutdown(); pHge->Release(); return 0; } 注意，程序运行之后，一直调用函数FrameFunc 直到用户按下ESC，那么跳到pHge- HGE 系列教材（4） --- 初探 HGE Core Functions 层 HGE Core Functions 层中的函数需要通过HGE 指针来访问，就如《HGE 系列教材（3） --- 初试HGE》所谈到的一样，通过调用hgeCreate 函数来初始化HGE 指针， HGE Core Functions 层中的函数，大致分层一下几类： 1. 接口函数（Interface functions）： hgeCreate --- 初始化HGE 指针，这是一个全局函数，除了这个函数，HGE Cor e Funtions 中所有的函数都需要通过HGE 指针调用。 Release --- 释放HGE 接口，调用了hgeCreate 就应该调用Release 释放。 2. 系统函数（System functions）：这类函数都是以System_ 开头，后面加上表示函数意义的单词（不出现下划线），之后介绍的函数也将使用这种命名方式，即类型前缀+ 有意义的单词： System_Initiate 初始化相关软件和硬件 System_Shutdown 恢复声音模式并且释放资源 System_Start 开始运行用户定义的帧函数 System_SetState 设置系统内部状态 System_GetState 返回内部状态的值 System_GetErrorMessage 返回最后出错的HGE 错误描述符 System_Log 在日志文件中书写格式化消息 System_Launch 运行一个URL 或者外部的可执行文件或数据文件 System_Snapshot 截屏并保存到一个文件 3. 资源函数（Resource functions）： Resource_Load 从硬盘上读取资源到内存中 Resource_Free 从内存中删除读取的资源 Resource_AttachPack 附加一个资源包 Resource_RemovePack 移除一个资源包 Resource_RemoveAllPacks 移除之前关联的所有资源包 Resource_MakePath 建立一个绝对文件路径 Resource_EnumFiles 通过通配符来枚举文件 4. 初始化文件函数（initialization file functions） Ini_SetInt 在初始化文件中写入一个整数值 Ini_GetInt 从初始化文件中读取一个整数值 Ini_SetFloat 在初始化文件中写入一个浮点值（float） Ini_GetFloat 从初始化文件中读取一个浮点值（float） Ini_SetString 在初始化文件中写入一个字符串 Ini_GetString 从初始化文件中读取一个字符串 5. 随机数参数函数（Random number generation functions） Random_Seed 设置随机数产生器的种子 Random_Int 产生int 类型的随机数 Random_Float 产生float 类型的随机数 6. 计时函数（Timer functions） Timer_GetTime 返回从调用System_Initiate 函数到现在所用的时间（单位为秒） Timer_GetDelta 返回上一次调用帧函数到现在所用的时间（单位为秒） Timer_GetFPS 返回当前FPS 的值 7. 声效函数（Sound effect functions） Effect_Load 载入从硬盘载入声音到内存 Effect_Free 从内存中删除载入的音效和相关的资源 Effect_Play 开始播放音效 Effect_PlayEx 开始播放音效，这个函数含有更多的参数 8. 更多查看HGE 的文档 HGE 系列教材（5） --- 输入、声音和渲染建议读者对应HGE 的官方的例子：Tutorial 02 - Using input, sound and renderi ng 来阅读本文渲染：在HGE 中，四边形是一种图元，对应了结构体hgeQuad，另外还有三角形图元，对应 hgeTriple，为了渲染，我们现在需要使用hgeQuad 结构体，这个结构体如下： struct hgeQuad { hgeVertex v[4]; // 顶点描述了这个四边形 HTEXTURE tex; // 纹理的句柄或者为0 int blend; // 混合模式（blending mode） }; HGE 中图元对应的结构体总含有这3 个部分：顶点，纹理句柄，混合模式 struct hgeVertex { float x, y; // 屏幕的x，y 坐标 float z; // Z-order，范围[0, 1] DWORD col; // 顶点的颜色 float tx, ty; // 纹理的 x，y 坐标（赋值前需要规格化坐标间隔，使得 tx，ty 取值范围在[0,1]） }; 规格化坐标间隔在后面的例子中会谈到 1. 颜色的表示：颜色使用32 位表示，从左开始，8 位为Alpha 通道，8 位红色，8 位绿色，8 位蓝色对于后24 位，如果全部为0，表示黑色，如果全部为1，表示白色 2. 定义颜色的运算：我们把颜色看成一个四维向量，即alpha 通道，红色，绿色，蓝色这四个分量 <1> 颜色是可以相乘的颜色的相乘是对应的四个分量分别相乘的结果，即：alpha 通道的值与alpha 通道的值相乘，红色的值与红色的值相乘，绿色的值与绿色的值相乘，蓝色的值与蓝色的值相乘。 <2> 颜色是可以相加的同上，对应分量相加。颜色的每个分量使用浮点数表示，范围是[0-1]，相加操作可能导致溢出，一种处理的方式就是，如果溢出，则设定值为1。 3. 混合模式： 1）BLEND_COLORADD 表示顶点的颜色与纹理的纹元（texel）颜色相加，这使得纹理变亮，可见顶点颜色为0x0 0000000 将不造成任何影响。 2）BLEND_COLORMUL 表示顶点的颜色与纹理的纹元颜色相乘，这使得纹理变暗，可见顶点颜色为0xFFFFFFFF 将不造成任何影响。注意：必须在1），2）中做一个选择，且只能选择1），2）中的一个。处理的对象是纹理颜色和顶点颜色。这里有一个技巧：如果我们需要在程序中显示一个气球，这个气球的颜色不断变化，这时候我们并不需要准备多张不同颜色的气球纹理，而只需要一张白色的气球纹理，设置blend 为BLEND_COL ORMUL，白色的R,G,B 值被表示成1.0，也就是说，纹理颜色和顶点颜色相乘的结果是顶点的颜色，那么就可以通过修改顶点颜色，得到任意颜色的气球了。 3）BLEND_ALPHABLEND 渲染时，将对象的像素颜色（而非顶点的颜色）与当前屏幕的对应像素颜色进行alpha 混合。alpha 混合使用到alpha 通道，对于两个像素颜色进行如下操作，得到一个颜色： R(C)=alpha*R(B)+(1-alpha)*R(A) G(C)=alpha*G(B)+(1-alpha)*G(A) B(C)=alpha*B(B)+(1-alpha)*B(A) 这里的BLEND_ALPHABLEND 使用的是对象像素的颜色的alpha 通道。可见如果对象像素颜色alpha 通道为0，那么结果就是只有当前屏幕的像素颜色，也就是常常说的100 % 透明，因此，我们可以理解alpha 混合就是一个是图像透明的操作，0 表示完全透明， 255 表示完全不透明。 4）BLEND_ALPHAADD 渲染时，将对象的像素颜色与当前屏幕的对应像素颜色相加，结果是有了变亮的效果。注意：这里的3），4）必选其一，且只能选其一。处理的对象是对象像素颜色和屏幕像素颜色。 5）BLEND_ZWRITE 渲染时，写像素的Z-order 到Z-buffer 6）BLEND_NOZWRITE 渲染时，不写像素的Z-order 到Z-buffer 这里一样是二者选一设置举例： quad.blend=BLEND_ALPHAADD | BLEND_COLORMUL | BLEND_ZWRITE; // quad 为hgeQuad 变量 4. HGE 渲染 1）定义和初始化hgeQuad 结构体： hgeQuad quad; // 定义四边形 2）初始化hgeQuad 变量： // 设置混合模式 quad.blend=BLEND_ALPHAADD | BLEND_COLORMUL | BLEND_ZWRITE; // 加载纹理 quad.tex = pHGE->Texture_Load("particles.png"); 注意，读取硬盘上资源的时候，可能会失败，因此通常都需要检查，例如： if (!quad.tex) { MessageBox(NULL, "Load particles.png", "Error", 0); } // 初始化顶点 for(int i=0;i<4;i++) { // 设置顶点的z 坐标 quad.v[i].z=0.5f; // 设置顶点的颜色，颜色的格式为0xAARRGGBB quad.v[i].col=0xFFFFA000; } // 这里假定载入的纹理大小为128*128，现在截取由点（96，64），（128，64），（128，96），（96，96）这四个点围成的图形。 quad.v[0].tx=96.0/128.0; quad.v[0].ty=64.0/128.0; // 规格化坐标间隔 quad.v[1].tx=128.0/128.0; quad.v[1].ty=64.0/128.0; quad.v[2].tx=128.0/128.0; quad.v[2].ty=96.0/128.0; quad.v[3].tx=96.0/128.0; quad.v[3].ty=96.0/128.0; 注意，对于hgeQuad 结构体，顶点quad.v[0] 表示左上那个点，quad.v[1] 表示右上的点，quad.v[2] 表示右下的点，quad.v[3] 表示左下的点。 // 设置hgeQuad 在屏幕中的位置 float x=100.0f, y=100.0f; quad.v[0].x=x-16; quad.v[0].y=y-16; quad.v[1].x=x+16; quad.v[1].y=y-16; quad.v[2].x=x+16; quad.v[2].y=y+16; quad.v[3].x=x-16; quad.v[3].y=y+16; System_SetState(HGE_RENDERFUNC,RenderFunc); RenderFunc 原型和帧函数一样： bool RenderFunc(); 4）编写RenderFunc 函数： bool RenderFunc() { pHGE->Gfx_BeginScene(); // 在如何渲染之前，必须调用这个函数 pHGE->Gfx_Clear(0); // 清屏，使用黑色，即颜色为0 pHGE->Gfx_RenderQuad(&quad); // 渲染 pHGE->Gfx_EndScene(); // 结束渲染，并且更新窗口 return false; // 必须返回false } 补充：Load 函数是和Free 函数成对出现的，即在硬盘上加载了资源之后，需要Free 它们，例如： quad.tex = pHGE->Texture_Load("particles"); // ... pHGE->Texture_Free(quad.tex); 音效：使用音效是很简单的 1. 载入音效： HEFFECT hEffect = pHGE->Effect_Load("sound.mp3"); 2. 播放： pHGE->Effect_PlayEx(hEffect); 或者pHGE->Effect_Play(hEffect); 1）Effect_Play 函数只接受一个参数就是音效的句柄HEFFECT xx; 2）Effect_PlayEx 函数较为强大，一共有四个参数： HCHANNEL Effect_PlayEx( HEFFECT effect, // 音效的句柄 int volume = 100, // 音量，100 为最大，范围是[0, 100] int pan = 0, // 范围是[-100, 100]，-100 表示只使用左声道， 100 表示只使用右声道 float pitch = 1.0, // 播放速度，1.0 表示正常速度，值越大播放速度越快，值越小播放越慢。这个值要大于0 才有效（不可以等于0） bool loop = false // 是否循环播放，false 表示不循环 ); 输入：仅仅需要调用函数pHGE->Input_GetKeyState(HGEK_xxx); 来判断输入，应该在帧函数中调用它，例如： bool FrameFunc() { if (pHGE->Input_GetKeyState(HGEK_LBUTTOM)) // ... if (pHGE->Input_GetKeyState(HGEK_UP)) // ... } HGE 系列教材（6） --- 程序流程与细节 HGE 的一些细节，通过源码可以更加清楚的了解，通过读源码，可以更加高效的使用HG E Engine。必要的第一步： Help Classes 层建立于Core Functions 层之上，这并不意味着用户只需要关心Help Classes 而忽略Core Functions，因此我们需要获得一个HGE 指针，来使用Core F unctions 的函数： <1> 获取HGE 指针： HGE* pHGE = pgeCreate(HGE_VERSION); <2> 释放HGE 指针：使用之后，需要释放HGE 指针。 pHGE->Release(); Create 和Release 过程使用了引用计数，也就是说，一般来看，除了第一次的Create 调用之外几乎不消耗CPU 时间和资源，每调用一次Create 函数，引用计数器就加一，只有在第一次调用的时候才会真正的分配空间，调用Release 会使得引用计数器减一，当它为0 的时候，才真正是释放资源。因此以下代码是可用的： while(true) { HGE* pHGE = pgeCreate(HGE_VERSION); // 确保不是第一次调用pgeCre ate 函数，因为如果是第一次调用，会分配内存。 // ... do something pHGE->Release(); } 此外，要成对的调用pgeCreate 和Release 函数，每次调用Release 之后，调用它的指针将被赋值为0，例如： HGE* pHGE = hgeCreate(HGE_VERSION); pHGE->Release(); pHGE->Release(); // ERROR: pHGE == 0 另外，pHGE->Release 会调用pHGE->System_Shutdown(); 必要的第二步：初始化： pHGE->System_Initiate(); 初始化语句放在Windows 入口函数中，这个函数将按顺序完成 1）窗口类的注册 2）创建窗口 3）初始化子系统 4）显示一个HGE 的LOGO（这个东西在HGE 里面被称之为HGE splash）一般使用System_Initiate() 都会是这样的： if (pHGE->System_Initiate()) { pHGE->System_Start(); } else { MessageBox(NULL, pHGE->System_GetErrorMessage(), "Error", MB_O K | MB_ICONERROR | MB_APPLMODAL); } 必要的第三步：调用： pHGE->System_Start(); 调用了System_Start 的目的是开始消息循环，见必要的第二步代码 pHGE->System_Start 和pHGE->System_Shutdown 是成对出现的，处于某些原因，即使我们知道pHGE->Release 会调用System_Shutdown 函数，我们还是应该去显示的调用System_Shutdown 函数。System_Shutdown 相比Release 要安全，我们可以这样调用，而不会出错： pHGE->System_Start(); // ... Something pHGE->System_Shutdown(); pHGE->System_Shutdown(); // OK 不论如何，Create 和Release 成对调用，Start 和Shutdown 成对调用，那么就不会有问题出现。还有什么是需要的？ System_SetState 函数常常需要设置窗口大小或者是设置为全屏模式，需要设置是否使用声音等，这一系列操作被称之为设置系统状态，统一通过调用pHGE->System_SetState 函数来完成，最为关键的是设置帧函数，调用了pHGE->System_Start 之后，会在绘制每帧图像时调用帧函数。 pHGE->System_SetState(XXX, XXX) 通常可以在如何地方，如何情况下调用，不要认为它们只能在pHGE->System_Initiate 之前调用 System_SetState 函数的第一个参数表示状态，在内部实现时，它是FSM 的状态，而第二个参数表示值，通过这个函数，可以绑定状态和相关的值补充一下，帧函数必须是一个全局函数，而不能是一个类的成员函数，并且帧函数的原型必须是： bool FunName(void); 惯用法：我们通常会在程序初始化之前设置状态，即在System_Initiate 调用之前，例如： int WINAPI WinMain( HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nShowCmd) { pHGE->System_SetState(HGE_FRAMEFUNC, FrameFunc); pHGE->System_SetState(HGE_WINDOWED, true); pHGE->System_SetState(HGE_USESOUND, false); pHGE->System_SetState(HGE_TITLE, "HGE"); pHGE->System_SetState(HGE_SHOWSPLASH, false); // 用于去除 L OGO if (pHGE->System_Initiate()) { pHGE->System_Start(); } { MessageBox(NULL, pHGE->System_GetErrorMessage(), "Error", MB_O K | MB_ICONERROR | MB_APPLMODAL); } pHGE->System_Shutdown(); pHGE->Release(); return 0; } HGE 系列教材（7） --- 使用 Helper Classes 字体的使用： 1. 头文件 #include 2. 载入字体 hgeFont* pFont; pFont = new hgeFont("font1.fnt"); // 不要忘记delete fnt 文件是一个字体描述文件（font description file），可以通过创作工具产生 3. 打印字体 pFont->printf(5, 5, HGETEXT_LEFT, "dt:%.3f\nFPS:%d (constant)", // 使用中文将出现“??” pHGE->Timer_GetDelta(), pHGE->Timer_GetFPS() ); 在渲染函数中打印文字，HGE 到目前版本1.81 依然不支持中文，只能使用第三方支持。建议使用微妙的平衡(BOGY)提供的解决方案。粒子系统的使用： 1. 建立一个hgeSprite 对象，hgeSprite 类的构造函数如下： hgeSprite( HTEXTURE tex, // 纹理的句柄 float x, // sprite 对应的纹理的x 坐标 float y, // sprite 对应的纹理的y 坐标（区别于顶点中的纹理坐标，这里无需规格化坐标间隔） float w, // sprite 的宽 float h // sprite 的高 ); 注意，sprite 对应的纹理的坐标，是sprite 的左上的坐标。由此可见，一个精灵对应了纹理中的一个四边形区域，实际的源码中，sprite 类含有一个hgeQuad 成员变量。如果tex 为0，那么就使用白色作为纹理的数据（texture data） hgeSprite* pSpt = new hgeSprite(tex, 32, 32, 32, 32); 2. 设置混合模式，根据情况设置混合模式，后面详细讨论： pSpt->SetBlendMode(BLEND_COLORMUL | BLEND_ALPHAADD | BLEND_N OZWRITE); // 建议使用BLEND_ALPHAADD，这样看起来效果会好很多（增亮）。 3. 设置锚点（似乎和函数名字有点不符） void SetHotSpot( float x, // 锚点的x 坐标 float y // 锚点的y 坐标 ); 锚点是这样的一个点：进行一些操作的中心点。例如进行旋转操作的中心点，即旋转操作依赖于这个点。通常设置sprite 的中心点为锚点。 4. 关联hgeParticleSystem pPar = new hgeParticleSystem("trail.psi", m_pSpt); // 关联hgeParticleSys tem psi 文件被称之为粒子系统描述文件（particle system description file），这个文件是 hgeParticleSystemInfo 结构对象的硬盘镜像，这里不做详细介绍。 5. 粒子系统中的基本参数介绍：系统生命周期（System lifetime）：粒子系统的生命周期，在这个周期内会产生新粒子 Emission：每秒产生多少个新的粒子粒子生命周期（Particle lifetime）：特定的某个粒子的生命周期 6. 设定Emission： pPar->info.nEmission=10; 7. 调用Fire 函数 pPar->Fire() 函数会重启粒子系统，但它不会影响当前活跃粒子 pPar->Render(); 9. MoveTo 函数 pPar->MoveTo(x, y); 用于移动粒子系统到（x，y）处 10. Update 函数 pPar->Update(m_pHGE->Timer_GetDelta()); 在帧函数中应该调用Update 且使用参数为m_pHGE->Timer_GetDelta() 使用 hgeSprite 渲染：前面说了为了渲染，使用了hgeQuad，那样做是复杂的，我们完全可以使用sprite 来实现，而不需要使用到过多的Core Functions 层的函数。 1. 创建sprite pSpt = new hgeSprite(tex, 96, 64, 32, 32); 2. 设置颜色 pSpr->SetColor(0xFFFFA000); SetColor 函数将为sprite 添加颜色，添加的方式由混合模式决定，设置混合模式，通过调用函数pSpr->SetBlendMode 实现。注意，这里设置的颜色是sprite 中hgeQuad 对象的顶点的颜色，四个顶点颜色将设为相同，而混合模式设置的是sprite 中的hgeQuad 对象的blend 值。 pSpr->SetBlendMode(BLEND_COLORMUL | BLEND_ALPHAADD | BLEND_NO ZWRITE); // 这里使用的纹理是alpha 通道渐变，颜色为白色的纹理，因此会使用到B LEND_COLORMUL，这点在《HGE 系列教材（5） --- 输入、声音和渲染》做了详细的说明 3. 设置锚点： pSpr->SetHotSpot(16, 16); 4. 渲染在渲染函数中，调用pSpr->Render(x, y); 方可 HGE 系列教材（8） --- hgeResourceManager helper class（本文未完成） hgeResourceManager 是一个资源管理类 1. 构造函数 hgeResourceManager( const char* scriptname = 0 ); scriptname 表示资源脚本文件名（Resource script filename），如果此参数为0，表示不使用Resource script file 现在来介绍一下资源脚本：资源脚本是一个文本文件，用于定义资源。资源文件由多个（或一个）命令（command）组成，格式如下： Command ResourceName : BaseResourceName { Parameter1=Value1 ; 这里是注释 Parameter2=Value2 ... ParameterN=ValueN } 我们来看一个例子： Resource level1 { filename=levels\level1.dat resgroup=1 } 这里只有一个命令：Resource，Resource 命令定义了一个原生资源（raw resource）注意，资源文件是大小写敏感的，资源文件中可以有注释，使用“;”开头。资源文件的参数（parameter）是没有顺序限制的。同种类型的资源，不可以使用相同的资源名（Resource Name）。在定义资源名或者文件路径时，出现空格或者特殊字符，需要把整个字符串用双引号引起来。 BaseResourceName 是可选的，如果被指定，那么就表示对BaseResourceName 对应的参数（Parameters）的拷贝，例如： Sprite wizard { texture=characters rect=0,0,32,32 hotspot=16,16 blendmode=COLORMUL,ALPHABLEND,NOZWRITE resgroup=1 } Sprite orc : wizard { rect=0,64,32,32 ; 设定新值 color=FF808000 ; 设定新值 } 这里orc 除了rect 和color 两个参数以外，其他参数值都和wizard 一样。 hgeResourceManager 是可以容错的，如果脚本出现错误，不会导致程序的终止，错误信息将被写入日志文件。 1）Command（命令） Command 表明了资源的含义，含有以下几种： Include，Resource，Texture，Sound，Music，Stream，Target，Sprite，Animat ion，Font，Particle，Distortion，StringTable <1> Include 命令：Include 命令用于导入其他的资源脚本文件，例如： Include level2.res ; level2.res 是一个资源脚本文件注意，自引用和循环引用是可行的，它们会被检查出来，并报告在日志文件中，例如： <2> Resource 命令：定义原生资源（raw resource）参数： filename，resgroup。例如： Resource level1 { filename=levels\level1.dat ; 可以使用绝对或者相对路径，相对路径是相对于应用程序所在的文件夹或者是相对于资源包的根目录，特别应该注意的是，如果它是一个相对路径，相对的是应用程序或者资源包的根目录而不是脚本文件 resgroup=1 ; 资源组（resource group）标识符，0 表示没有特定的组 } <3> Texture 命令：定义一个纹理参数：filename，mipmap，resgroup。例如： Texture background { filename=images\bg.jpg resgroup=1 } 由于没有设定mipmap 参数的值，因此它取默认值。 <4> Sound 命令：定义一个音效参数：filename，resgroup。例如： Sound explosion1 { filename=sounds\expl1.ogg resgroup=1 } <5> Music 命令 HGE 系列教材（9） --- GUI（本文未完成） 1. hge 中GUI 对象和控件 hge 中GUI 对象被看作是一个控件的容器，hge 提供了创建GUI 对象的类hgeGUI 类 2. hgeGUI 类 1）AddCtrl 函数 void AddCtrl( hgeGUIObject *ctrl // hgeGUIObject 对象的指针 ); 我们通常可以有这样的写法： gui->AddCtrl(new hgeGUIMenuItem(1,fnt,snd,400,200,0.0f,"Play")); 这里hgeGUIMenuItem 是一个控件，继承于hgeGUIObject 类，注意，我们创建了 hgeGUIObject 对象，但是却没有去销毁它，因为hgeGUI 类的析构函数会去处理这些问题。 2）SetNavMode 设置GUI 导航模式（Navigate mode）： void SetNavMode( int navmode ); HGEGUI_NONAVKEYS - 无键盘导航 HGEGUI_LEFTRIGHT - 左右按键导航 HGEGUI_UPDOWN - 上下按键导航 HGEGUI_CYCLED - 循环默认情况下，navmode 被设置为HGEGUI_NONAVKEYS，对于一个菜单，我们可以这样设置： SetNavMode(HGEGUI_UPDOWN | HGEGUI_CYCLED); 使用上下键导航，并且循环。设置光标sprite： void SetCursor( hgeSprite *sprite ); 设置光标对应的sprite，如果为0，表示不显示光标，默认情况为0。注意，光标不受G UI 对象的管理，也就是用户必须自己释放光标资源。 4）SetFocus void SetFocus( int id ); 每个控件都有一个对应的ID 号，这个ID 号被称之为控件的标识符，这里通过控件标识符来设置焦点。键盘事件只会被分发到成为焦点的控件上。 5）Enter 开始GUI Enter 动画 3. hgeGUIObject hgeGUIObject 是一个抽象类，它有一个纯虚函数Render hgeGUIObject 类的子类的对象并不是GUI 对象，而是GUI 控件，这一点应该清楚 1）hgeGUIObject 的成员变量 hgeGUIObject 的成员变量都为public： // 必须在构造函数中初始化的变量 int id; // 控件标识符 bool bStatic; // 如果为true 控件无法成为焦点也不会接受键盘事件，同时它将被 navigate 例程忽略（前面已谈到设置navigate） bool bVisible; // 控件是否可见，如果为false，控件将不被渲染 bool bEnabled; // false 时，控件对用户的输入不作出任何回应，但是控件是可以接受到用户的通知（区别于bStatic） hgeRect rect; // 控件有界框（bounding box）在屏幕上的区域 DWORD color; // 控件颜色 // 不需要在构造函数中初始化的变量 hgeGUI *gui; // GUI 对象指针 hgeGUIObject *prev; // 连接GUI 对象中的所有控件，子类不需要改变它 // hge 指针 static HGE *hge; 2）void Render(void) 渲染控件到屏幕 3）void Update(float fDt) fDt 上次调用Update 函数到现在所用的时间（单位是秒） 4）void Enter(void) 控件出现在屏幕上的时候被调用，用于播放控件出现时的动画 5）void Leave(void) 控件离开屏幕的时候被调用，用于播放控件离开屏幕的动画 6）bool IsDone(void) 判断控件出现动画和控件离开动画是否播放完毕 7）void Focus(bool bFocused) 控件获得焦点，bFocused 为true，反之为false 8）bool MouseMove(float x, float y) 以控件左上为原点，鼠标指针的坐标。如果控件状态改变，需要通知调用者，那么返回tr ue，否则返回false 9）bool MouseLButton( bool bDown) bDown 如果为true，表示按下鼠标左键，如果bDown 为false，表示松开鼠标左键 10）bool KeyClick( int key, int chr) key 表示按键的虚拟代码（Virtual code of the pressed key），见下表： HGEK_LBUTTON Left mouse button HGEK_RBUTTON Right mouse button HGEK_MBUTTON Middle mouse button (wheel button) HGEK_BACKSPACE BACKSPACE key HGEK_TAB TAB key HGEK_ENTER Any of the two ENTER keys HGEK_SPACE SPACE key HGEK_SHIFT Any of the two SHIFT keys HGEK_CTRL Any of the two CTRL keys HGEK_ALT Any of the two ALT keys HGEK_LWIN Left WINDOWS key HGEK_RWIN Right WINDOWS key HGEK_APPS APPLICATIONS key HGEK_PAUSE PAUSE key HGEK_CAPSLOCK CAPS LOCK key HGEK_NUMLOCK NUM LOCK key HGEK_SCROLLLOCK SCROLL LOCK key HGEK_PGUP PAGE UP key HGEK_PGDN PAGE DOWN key HGEK_HOME HOME key HGEK_END END key HGEK_INSERT INSERT key HGEK_DELETE DELETE key HGEK_LEFT LEFT ARROW key HGEK_UP UP ARROW key HGEK_RIGHT RIGHT ARROW key HGEK_DOWN DOWN ARROW key HGEK_0 Main keyboard '0' key HGEK_1 Main keyboard '1' key HGEK_2 Main keyboard '2' key HGEK_3 Main keyboard '3' key HGEK_4 Main keyboard '4' key HGEK_5 Main keyboard '5' key HGEK_6 Main keyboard '6' key HGEK_7 Main keyboard '7' key HGEK_8 Main keyboard '8' key HGEK_9 Main keyboard '9' key HGEK_A 'A' key HGEK_B 'B' key HGEK_C 'C' key HGEK_D 'D' key HGEK_E 'E' key HGEK_F 'F' key HGEK_G 'G' key HGEK_H 'H' key HGEK_I 'I' key HGEK_J 'J' key HGEK_K 'K' key HGEK_L 'L' key HGEK_M 'M' key HGEK_N 'N' key HGEK_O 'O' key HGEK_P 'P' key HGEK_Q 'Q' key HGEK_R 'R' key HGEK_S 'S' key HGEK_T 'T' key HGEK_U 'U' key HGEK_V 'V' key HGEK_W 'W' key HGEK_X 'X' key HGEK_Y 'Y' key HGEK_Z 'Z' key HGEK_GRAVE Grave accent (`) HGEK_MINUS Main keyboard MINUS key (-) HGEK_EQUALS Main keyboard EQUALS key (=) HGEK_BACKSLASH BACK SLASH key (\) HGEK_LBRACKET Left square bracket ([) HGEK_RBRACKET Right square bracket (]) HGEK_SEMICOLON Semicolon (;) HGEK_APOSTROPHE Apostrophe (') HGEK_COMMA Comma (,) HGEK_PERIOD Main keyboard PERIOD key (.) HGEK_SLASH Main keyboard SLASH key (/) HGEK_NUMPAD0 Numeric keyboard '0' key HGEK_NUMPAD1 Numeric keyboard '1' key HGEK_NUMPAD2 Numeric keyboard '2' key HGEK_NUMPAD3 Numeric keyboard '3' key HGEK_NUMPAD4 Numeric keyboard '4' key HGEK_NUMPAD5 Numeric keyboard '5' key HGEK_NUMPAD6 Numeric keyboard '6' key HGEK_NUMPAD7 Numeric keyboard '7' key HGEK_NUMPAD8 Numeric keyboard '8' key HGEK_NUMPAD9 Numeric keyboard '9' key HGEK_MULTIPLY Numeric keyboard MULTIPLY key (*) HGEK_DIVIDE Numeric keyboard DIVIDE key (/) HGEK_ADD Numeric keyboard ADD key (+) HGEK_SUBTRACT Numeric keyboard SUBTRACT key (-) HGEK_DECIMAL Numeric keyboard DECIMAL key (.) HGEK_F1 F1 key HGEK_F2 F2 key HGEK_F3 F3 key HGEK_F4 F4 key HGEK_F5 F5 key HGEK_F6 F6 key HGEK_F7 F7 key HGEK_F8 F8 key HGEK_F9 F9 key HGEK_F10 F10 key HGEK_F11 F11 key HGEK_F12 F12 key 如果控件状态修改了，希望通知调用者，那么返回true，否则为false

短信收发控件使用说明： Build 20040606(Beta 1)使用时不能将控件直接放在窗体上，需要定义并自己创建，具体使用方法参看示例程序。控件只提供dcu文件。控件从SPComm继承，并且增加了短信收发功能，对于SPComm的相关属性和事件不在此进行说明，下面只介绍与短信相关的属性、方法和事件。Delphi 7下、wavecom 设备下调试通过。开发计划：1.解决直接放置在窗体上使用的问题。2.提供dll、OCX,供vb,vc等程序使用。3.提供源码(暂不提供，请不要联系索要)计划只是计划,看看有没有时间，比竟还有工作...^_^一、属性1.AutoDeleteMsg:Boolean 自动删除短信如果设置为True,则在读取短信时自动删除该短信，收到新短信时读取后也自动删除。二、方法1.WriteCommDataAT(AT:String);发送AT命令,立即执行2.PushCommand(AT:String;ATType:Integer);将命令压入命令队列，由控件在设备空闲时自动发出ATType备用，可写任意整数3.SendSMS(PhoneNO:String;Msg:String): Integer;立即发送短信命令PhoneNO:手机号码Msg:短信内容4.PushSMS(SMSID:Integer;SMSPhoneNO,SMSMsg:String;SMSSendTime:TDatetime)将短信压入待发短信队列，牙控件在设备空闲时自动发出SMSID:短信序列号，在控件的OnSMSSendOKEvent事件中将返回发送成功的SMSID,建议使用数据库中的ID字段进行标志PhoneNO:手机号码Msg:短信内容SMSSendTime:发送时间，备用，为定时发送而设5.SetOpenProcess(Value:Boolean);启动/停止命令执行，包括发送短信进程6.InitSMS(CenterNO:String);初始化短信设备，设置为PDU格式，并且初始化短信中心CenterN：短信中心号码，不带加号，如：86130101665007.GetCommandQueueCount: Integer;返回命令队列中待发命令个数8.GetSendQueueCount: Integer;返回命令队列中待发短信个数三、事件1.OnSMSNewEvent(PhoneNO,Msg,MsgTime:String);收到短信事件PhoneNO:手机号码Msg：短信内容MsgTime：收到时间2.OnSMSSendOKEvent(ID:Integer);短信发送成功事件ID:发送成功短信索引，为在PushSMS中所设的SMSID作者保留所有权力。共享版在发送短信前会加上adsg@tom.com的信息! adsg http://www.tinsoftware.com adsg@Tom.com

下载资源悬赏专区

12,831

社区成员

12,362,639

社区内容

发帖

与我相关

我的任务

其他技术论坛（原bbs）

社区管理员

加入社区

近7日
近30日
至今

加载中

查看更多榜单

社区公告

暂无公告

试试用AI创作助手写篇文章吧

+ 用AI写文章