MMORPG大型游戏设计与开发(客户端架构 part2 of vegine)
一个好的接口是尽可能让更多实用的方法进行整理封装,要记住的是不常用的方法和类最好不好封装到接口中,因为那样会造成本身的困惑。基础模块中并没有太多封装,甚至连一个类的封装也没有,而是一些很常用的工具方法,而这些工具方法在整个客户端的设计中是必须的,所以才进入了基础模块。那么,就让我们看看客户端基础的一些方法都有哪些吧。
CODE
文件util.h
/**
* PAP Engine ( -- )
* $Id util.h
* @link -- for the canonical source repository
* @copyright Copyright (c) 2013-2014 viticm( viticm@126.com )
* @license
* @user viticm<viticm@126.com/viticm.ti@gmail.com>
* @date 2014-3-18 15:33:08
* @uses vengine base util functions
*/
#ifndef VENGINE_BASE_UTIL_H_
#define VENGINE_BASE_UTIL_H_
#include "vengine/config.h"
#include "vengine/math/base.h"
#define PI (3.1415926535)
#define FLOATMIN (1.0E-9)
namespace vengine_base {
namespace util {
VENGINE_API void savelog(const char* format , ...);
//将字符串按照关键字分割
VENGINE_API int32_t convertstring_tovector(const char* str,
std::vector<STRING>& save,
const char* key = "\\/",
bool one_ofkey = true,
bool ignoreempty = true);
//取得两点间的距离
VENGINE_API float getdistance(
const vengine_math::base::twofloat_vector_t& position1,
const vengine_math::base::twofloat_vector_t& position2);
VENGINE_API float getdistance(
const vengine_math::base::threefloat_vector_t& position1,
const vengine_math::base::threefloat_vector_t& position2);
//取得两点间的距离平方
VENGINE_API float get_squaredistance(
const vengine_math::base::twofloat_vector_t& position1,
const vengine_math::base::twofloat_vector_t& position2);
VENGINE_API float get_squaredistance(
const vengine_math::base::threefloat_vector_t& position1,
const vengine_math::base::threefloat_vector_t& position2);
template<class T, class U, class V>
inline void clamp(T &v, const U &min, const V &max) {
v = (v < min) ? min : v;
v = (v > max) ? max : v;
}
//求两个向量的点积
inline float get_dotproduct(
const vengine_math::base::twofloat_vector_t& vector1,
const vengine_math::base::twofloat_vector_t& vector2) {
return vector1.x * vector2.x + vector1.y * vector2.y;
}
/*
|
| 取得从Pos1到Pos2的矢量相对于Y轴的旋转角度, 以z轴为0度
|
| ->x
| o pos1
| | |\
| z v | \
| | \
| | \
| | o pos2
|
| Return [0 ~ 2pi)
*/
VENGINE_API float get_Yangle(
const vengine_math::base::twofloat_vector_t& position1,
const vengine_math::base::twofloat_vector_t& position2);
/*
|
| 取得从Pos1与Pos2之间的中心点
|
| ->x
| o pos2
| | /
| z v o <- This point!
| /
| o
| pos1
|
*/
VENGINE_API vengine_math::base::threefloat_vector_t getcenter(
const vengine_math::base::threefloat_vector_t& position1,
const vengine_math::base::threefloat_vector_t& position2);
/*
|
| 取得v1相对于从Pos1与Pos2之间直线的镜像点
|
| ->x
| o pos2
| | v1 /
| z v \ /
| \/
| / \
| o \
| pos1 v2 <- This point!
|
*/
VENGINE_API vengine_math::base::twofloat_vector_t getreflect(
const vengine_math::base::twofloat_vector_t& position1,
const vengine_math::base::twofloat_vector_t& position2,
const vengine_math::base::twofloat_vector_t& vector1);
//从内存中读取一行文本(相当于fgets)
VENGINE_API const char* getline_frommemory(char* buffer,
int32_t size,
const char* memory,
const char* deadend);
VENGINE_API bool sheckstring_valid(const char* str);
/*
| 使目标点根据方向轴旋转,返回旋转后的坐标。
|
| position 要旋转的目标点坐标
| axis 以原点为起点的矢量方向轴
| angle 旋转的角度
|
| 注:axis会被单位化,变以原点为起始点的矢量方向。如果想根据任意轴做旋转,
| 需要先将目标点做相应的平移,调用该函数旋转后,再平移回去即可。
|
*/
VENGINE_API vengine_math::base::threefloat_vector_t rotateangle(
const vengine_math::base::threefloat_vector_t& position,
const vengine_math::base::threefloat_vector_t& axis,
float angle);
/*
| hermite曲线差值算法。曲线被划分为150段,返回所需段数的2D坐标位置
|
| x1,y1,x2,y2 曲线端点,最好数值限制在1000以内,否侧运算时会超出运算范围
| xr1,yr1,xr2,yr2 曲线两参考向量, 最好限制在1000以内
| currentiter 当前段数,值限定在150以内。
*/
//win32 POINT
POINT hermitecurve(int32_t x1,
int32_t y1,
int32_t x2,
int32_t y2,
int32_t xr1,
int32_t yr1,
int32_t xr2,
int32_t yr2,
int32_t currentiter);
//同 hermitecurve
POINT beziercurve(int32_t x1,
int32_t y1,
int32_t x2,
int32_t y2,
int32_t xr1,
int32_t yr1,
int32_t xr2,
int32_t yr2,
int32_t currentiter);
}; //namespace util
}; //namespace vengine_base
#endif //VENGINE_BASE_UTIL_H_
总结
这里没有太多复杂的方法应用,仅仅是一个记录日志的接口和一些常用的数学算法的封装,对于一个客户端(3D类型)来说这些方法基本上都是需要用到的。在这里还是强调那一点,就是必须用到的方法才加入基本模块,如果不是类的封装一般就封装在工具集合中,有些朋友更喜欢将工具集合叫做方法工厂(functions factory)。无论怎样命名,你要清楚的知道你要在什么地方会用到,以及它自身的作用范围。好了,基础模块的方法也没有什么特别需要去说明的,至于数学算法大家可以上网上去搜集资料了解一下,在这里我就不具体解释其实现的过程了。下节将为大家讲述math(数学)模块,其实天龙八部/武侠世界参考了比较好的ogre的设计,我们下节可以看到它怎样去扩展一些数学相关的数据类型的。