FunCodeC开发常用API

1、FunCode C开发常用APIC语言标准库函数在实验中，我们需要用到一些 C语言标准库函数，主要用于字符串处理，获得随机值, 处理数学函数等。Math.h函数原型功能与返回值参数说明与应用举例P ublic static double返回两点之间的正X：点的x坐标ata n2(切值y :点的y坐标double y, double xfloat ftan）；=ata n2(fMouseY-fY),(fMouseX-fX);float sqrt(功能：计算平方根sqrt(9) = 3float x);返回值：x的平方根Stdio.h函数原型功能与返回值参数说明与应用举例int sprintf(c

2、har *buffer, const char *format, argume nt);把格式化的数据写 入某个字符串缓冲 区。返回值：字符串长度（strlen）buffer: char型指针，指向将要写入的 字符串的缓冲区。format: char型指针，指向的内存里面 存放的将要格式字符串。argument.:可选参数，可以是任何类 型的数据。sprin tf（szUfoName,ufo_%d_%d,iLo op, iTotalUfoCo unt ）;Stri ng.h函数原型功能与返回值参数说明与应用举例extern char *strstr(找出str2 字符串strstr(szNam

3、e, feichong )!= NULLchar *str1,在str1字符串中说明szName中包含feichongchar *str2第一次出现的位置可以用来判断前一个字符串包含后面);（不包括 str2 的 串结束符）。返回值：返回该位 置的指针，如找不 至U,返回空指针。一个字符串extern int strc mp(比较字符串s1和strcmp(szName,feichong_0 ” = 0const char *s1,s2。说明 szName 与 feichong_0 相等const char * s2当s1s2时，返回可以用 来判断前后两 个字符串 的值);值s2时，返回值0ex

4、ter n char *strc py( char *dest, const char *src)；把从src地址开始 且含有NULL结束 符的字符串复制到 以dest开始的地址 空间返回指向dest的指 针。strcpy( big“” ：ufo ” );前一个字符串的内容变为” ufo ”void *memc py( const char* dest, const char *src, size_t n,);从源src所指的内 存地址的起始位置 开始拷贝n个字节 到目标dest所指 的内存地址的起始 位置中函数返回dest的值memcpy( m_iGridData, m_iLevelData

5、2, sizeof(i nt) * GRID_COUNT*GRID_COUNT );exter nun sig nedintstrle n(char*s);计算字符串s的(unsigned int 型)长度，不包括0在 内返回s的长度，不 包括结束符NULL。int iStrLen =strlen( ufo” );Fun Code C API播放静态精灵的 APIAPI功能与返回值参数说明int dCl oneSp rite(c onst char *szSrcName, const char*szMyName );1表示克隆成功，0克 隆失败。失败的原因 可能是在地图中未找 到对应名字的精灵

6、szSrcName：被复制的精灵模 板的名称szMyName指向我们复制出 来精灵的名字VoiddSetSpriteWidth( const char *szName,constfloatfWidth );设置精灵外形宽度数组szName指向我们要设置宽度的精灵的名字fWidth :宽度值，大于 0floatdGetS priteWidth(con st char*szName );获取精灵外形宽度 返回值：精灵宽度值szName：指向要获得宽度的 精灵VoiddSetS priteHeight(const设置精灵外形高度szName:指向要设置高度的 精灵的名字char*szName,c o

7、nstfloatfHeight)；fHeight :精灵高度值floatdGetS priteHeight(co nst char *szName);获取精灵外形高度szName：指向要获得咼度的 精灵的名字voiddSetS priteL in earVelocity(c onstchar *szName, constfloatfVelX, constfloatfVelY);设置精灵移动速度szName：指向要设置速度的 精灵的名字fVelX : X方向速度fVelY : Y方向速度floatdGetS priteLi nearVelocityX( const char *szName);获

8、取精灵X方向速度szName：指向要获得速度的 精灵的名字floatdGetS priteLi nearVelocityY( const char *szName);获取精灵丫方向速度szName：指向要获得速度的 精灵的名字voiddSetS priteLi nearVelocity Po lar(c onst char *szName, const float fSp eed,const float fPolar);按角度朝向设置精灵 移动速度szName：指向要设置角速度 的精灵的名字fSpeed :移动速度fPolar :角度朝向voiddSetS priteCollisio nSen

9、 d(co nst char *szName, const int iSe nd);设置精灵是否可以发 送（产生）碰撞szName：指向要设置发送碰 撞的精灵的名字iSend : 1可以发送碰撞0不可以发送碰撞voiddSetS priteCollisio nReceive (const char *szName, const int iReceive;);设置精灵是否可以接受碰撞szName：指向要设置接收碰 撞的精灵的名字iReceive :1可以接受碰撞0不接受碰撞Void dSetS priteWorldLimit( const char *szName, const EWorldLi

10、mit Limit, const float fLeft, const float flop, const float fRight, const float fBottom);设置精灵的世界边界坐标限制及碰撞模式szName:指向要设置世界边 界和碰撞模式的精灵的名字 Limit :碰撞到世界边界之后 的响应模式，如果为NULL,碰撞反应由代码决定。其它 值见 EWorldLimitfLeft :边界的左边 X坐标 fTop :边界的上边丫坐标 fRight :边界的右边X坐标 fBottom :边界的下边 丫坐标voiddSetS priteFli pX(const char *szNam

11、e, const int iFli pX);设置精灵图片 X方向 翻转显示szName:指向要翻转的精灵 的名字iFli pX : 1 翻转0不翻转（恢复原来朝向）void dSetS priteVisible( const char *szName, con st i nt iVisible);设置精灵隐藏或者显 示（可见不可见）szName:指向要隐藏的精灵 的名字iVisible : 1 可见0不可见void dDeleteS prite( const char *szName);在地图中删除与本对 象实例关联的精灵szName:指向要删除的精灵 的名字void dSp riteMove

12、To( const char *szName, co nst float fPosX, co nst float fPosY, const float fSp eed, const int iAutoSt op );让精灵按照给疋速度 移动到给定坐标点szName:指向要移动的精灵 的名字fPosX :移动的目标X坐标值 fPosY :移动的目标 丫坐标值 fSpeed :移动速度iAutoStoP :移动到终点之后 是否自动停止。1表示停止；0不停止。void dSetS priteP ositio n( cos nt char* szName,const float fPosX, cons

13、t float fPosY);设置精灵位置szName:指向要设置位置的 精灵的名字fPosX : X 坐标fPosY : Y 坐标void dSetS pritePo sitio nX( const char *szName, con st float fPosX);只设置精灵X坐标szName:指向要设置位置的 精灵的名字fPosX : X 坐标void dSetS priteP ositio nY( const char *szName, const float fPosY);只设置精灵丫坐标szName:指向要设置位置的 精灵的名字fPosY : Y 坐标float dGetS pri

14、te Positio nX( const char *szName);获取精灵X坐标。szName:指向要获得X坐标的精灵的名字float dGetS prite Positio nY( const char *szName);获取精灵丫坐标szName:指向要获得丫坐标的精灵的名字void dSetS priteRotatio n( const char *szName, const float fRot);设置精灵的旋转角度szName:指向要设置旋转的 精灵的名字参数fRot :旋转角度，范围0 - 360float dGetS priteRotatio n( const char *s

15、zName);获取精灵的旋转角度szName:指向要获得旋转角 度的精灵的名字voidSets priteLifeTime(const char *szName, const float fLifeTime);设置精灵的生命时 长。超过生命时长， 精灵被删除。szName:指向要设置精灵生 命周期的名字fLifeTime :生命时长，单位秒VoidszName:指向要设置 X方向常设置精灵X方冋吊量dSetS priteCo nsta ntForceX推力量推力的精灵的名字(const char *szName,const float fForceX);fForceX : X万向推力大小voi

16、dszName:指向要设置 丫方向常设置精灵Y方冋吊量dSetS priteCo nsta ntForceY(推力量推力的精灵的名字const char *szName, const float fForceY );fForceY : Y方向推力大小float获取精灵链接点 X坐szName:指向要获得X方向链dGetS priteL inkPointP osX(标接点的精灵的名字const char *szName,参数ild :链接点序号，第const int iId一个链接点为1,后面依次递);加float获取精灵链接点 丫坐szName:指向要获得丫方向链dGetS priteLi n

17、kP oi ntP osY(标。接点的精灵的名字const char *szName,参数ild :链接点序号，第const int iId);一个链接为1,后面依次递加void按角度朝向设置精灵szName:指向要设置瞬间推dSetS pritel mpu IseForce Pola瞬间推力力的精灵的名字r(fPolar :角度朝向const char *szName,fForce :推力大小const float fPolar,iGravitic :是否计算重力const float fForce,1:计算const int iGravitic);0:不计算float dGetS prit

18、eMass( const char *szName);获取精灵质量、亡 1t Airrr- i=r. r . . tszName:指向要获得质量的 精灵的名字返回值：质量大小播放动态精灵的 APIAPI功能与返回值参数说明intdAni mates prite PlayA ni mati on(const char *szName, const char *szA nim, const int iRestore动画精灵播放动画 返回值：是否播放 成功1表示成功，0表示不成功szName:指向要播放动画的精灵的 名字szAnim :动画名字。注意不是精灵 名称。bRestore:播放完毕后是否恢

19、复当 前动画1:恢复);0:不恢复char szGotGoldName20;设置文字精灵的 API类成员函数功能与返回值参数说明void dSetTextValue( const char *szName, int iValue);文字精灵显示某个数值szName:指向文字精灵的名字iValue :要显示的数值设置特效精灵的 APIAPI功能与返回值参数说明void dP layEfect(const char *szSrcName, const float fLifeTime, const float fPosX, const float fPosY,const float fRotati

20、on);播放一个不循环的 特效,播放完毕之后 该特效自动删除szSrcName:特效精灵的名字， fLifeTime :特效精灵的生命长度， fPosX :播放的X坐标 fPosY :播放的丫坐标 fRotation :播放的角度朝向设置播放声音的 APIAPI功能与返回值参数说明void dP laySou nd( const char *szName, const int iLo op, const float fVolume );播放声音特效szName：播放声音的路径或者名称 iLoop :是播放否循环播放1循环播放0：不循环播放fVolume : 0-1音量的大小void dSt o

21、pSound( const int iSo un dId);停止播放该声音iSoundld :播放声音的时候返回的 声音的ID系统相关功能的APIAPI功能与返回值参数说明static floatdGetScree nLeft();获取世界边界之左 边X坐标static float dGetScree nTo p();获取世界边界之上 边丫坐标static floatdGetScree nRight();获取世界边界之右 边X坐标static float dGetScree nBottom();获取世界边界之下 边丫坐标static char*dMakeS priteName( const c

22、har *sz Prev, const int iId);将前面的字符串与 后面的数字整合成 一个字符串。返回值：返回一个 字符串，比如传入szP rev： 一个非空字符串，最长不 能超过20个英文字符。iId :一个数字CSystem:MakeSpriteName( Xxx”2);static voiddSetWi ndowTitle(const char *szTitle)；static int dRandomRange( const int iMin, const int iMax)；static void dShowCursor(const bool bShow)；static void dDrawL ine( con st float fStartX, con st float fStartY , c