FunCode C 开发常用API.doc

FunCode C开发常用APIC语言标准库函数在实验中，我们需要用到一些C语言标准库函数，主要用于字符串处理，获得随机值，处理数学函数等。Math.h函数原型功能与返回值参数说明与应用举例public static double atan2(double y, double x)；返回两点之间的正切值x:点的x坐标y：点的y坐标float ftan= atan2(fMouseY-fY),(fMouseX-fX);float sqrt( float x );功能：计算平方根返回值：x的平方根sqrt(9) = 3Stdio.h函数原型功能与返回值参数说明与应用举例int sprintf( char *buffer, const char *format, argument );把格式化的数据写入某个字符串缓冲区。返回值：字符串长度（strlen）buffer：char型指针，指向将要写入的字符串的缓冲区。format：char型指针，指向的内存里面存放的将要格式字符串。argument.：可选参数，可以是任何类型的数据。sprintf(szUfoName,ufo_%d_%d, iLoop, iTotalUfoCount );String.h函数原型功能与返回值参数说明与应用举例extern char *strstr(char *str1, char *str2);找出str2字符串在str1字符串中第一次出现的位置（不包括str2的串结束符）。 返回值：返回该位置的指针，如找不到，返回空指针。strstr(szName, “feichong”) != NULL说明szName中包含feichong可以用来判断前一个字符串包含后面一个字符串extern int strcmp(const char *s1,const char * s2);比较字符串s1和s2。当s1s2时，返回值s2时，返回值0strcmp(szName, “feichong_0”) = 0说明szName与feichong_0相等可以用来判断前后两个字符串的值相等extern char *strcpy(char *dest,const char *src);把从src地址开始且含有NULL结束符的字符串复制到以dest开始的地址空间返回指向dest的指针。strcpy(“big”, ”ufo” );前一个字符串的内容变为”ufo”void *memcpy(const char* dest,const char *src,size_t n,);从源src所指的内存地址的起始位置开始拷贝n个字节到目标dest所指的内存地址的起始位置中函数返回dest的值memcpy( m_iGridData, m_iLevelData2, sizeof(int) * GRID_COUNT * GRID_COUNT );extern unsigned int strlen(char *s);计算字符串s的（unsigned int型）长度，不包括0在内返回s的长度，不包括结束符NULL。intiStrLen=strlen(“ufo” );FunCode C API播放静态精灵的APIAPI功能与返回值参数说明intdCloneSprite(const char *szSrcName, const char *szMyName );1表示克隆成功，0克隆失败。失败的原因可能是在地图中未找到对应名字的精灵szSrcName：被复制的精灵模板的名称szMyName：指向我们复制出来精灵的名字VoiddSetSpriteWidth( const char *szName, const float fWidth );设置精灵外形宽度数组szName：指向我们要设置宽度的精灵的名字fWidth：宽度值，大于0float dGetSpriteWidth( const char *szName );获取精灵外形宽度返回值：精灵宽度值szName：指向要获得宽度的精灵Void dSetSpriteHeight( const char *szName,const float fHeight );设置精灵外形高度szName:指向要设置高度的精灵的名字fHeight：精灵高度值floatdGetSpriteHeight(const char *szName);获取精灵外形高度szName：指向要获得高度的精灵的名字void dSetSpriteLinearVelocity(const char *szName, const float fVelX, const float fVelY );设置精灵移动速度szName：指向要设置速度的精灵的名字fVelX：X方向速度fVelY：Y方向速度float dGetSpriteLinearVelocityX(const char *szName);获取精灵X方向速度szName：指向要获得速度的精灵的名字float dGetSpriteLinearVelocityY(const char *szName);获取精灵Y方向速度szName：指向要获得速度的精灵的名字void dSetSpriteLinearVelocityPolar(const char *szName, const float fSpeed, const float fPolar );按角度朝向设置精灵移动速度szName：指向要设置角速度的精灵的名字fSpeed：移动速度fPolar：角度朝向void dSetSpriteCollisionSend(const char *szName, const int iSend);设置精灵是否可以发送(产生)碰撞szName：指向要设置发送碰撞的精灵的名字iSend：1可以发送碰撞 0不可以发送碰撞void dSetSpriteCollisionReceive( const char *szName,const int iReceive; );设置精灵是否可以接受碰撞szName：指向要设置接收碰撞的精灵的名字iReceive： 1 可以接受碰撞 0不接受碰撞Void dSetSpriteWorldLimit(const char *szName, const EWorldLimit Limit, const float fLeft, const float fTop, const float fRight, const float fBottom );设置精灵的世界边界坐标限制及碰撞模式szName:指向要设置世界边界和碰撞模式的精灵的名字Limit：碰撞到世界边界之后的响应模式，如果为NULL，碰撞反应由代码决定。其它值见 EWorldLimitfLeft：边界的左边X坐标fTop：边界的上边Y坐标fRight：边界的右边X坐标fBottom：边界的下边Y坐标voiddSetSpriteFlipX( const char *szName,const int iFlipX );设置精灵图片X方向翻转显示szName:指向要翻转的精灵的名字iFlipX：1 翻转 0不翻转(恢复原来朝向)void dSetSpriteVisible( const char *szName,const int iVisible );设置精灵隐藏或者显示(可见不可见)szName:指向要隐藏的精灵的名字iVisible：1可见 0不可见void dDeleteSprite(const char *szName);在地图中删除与本对象实例关联的精灵szName:指向要删除的精灵的名字void dSpriteMoveTo( const char *szName, const float fPosX, const float fPosY, const float fSpeed, const int iAutoStop );让精灵按照给定速度移动到给定坐标点szName:指向要移动的精灵的名字fPosX：移动的目标X坐标值fPosY：移动的目标Y坐标值fSpeed：移动速度iAutoStop：移动到终点之后是否自动停止。1表示停止；0不停止。void dSetSpritePosition( cosnt char* szName， const float fPosX, const float fPosY );设置精灵位置szName:指向要设置位置的精灵的名字fPosX：X坐标fPosY：Y坐标void dSetSpritePositionX( const char *szName,const float fPosX);只设置精灵X坐标szName:指向要设置位置的精灵的名字fPosX：X坐标void dSetSpritePositionY( const char *szName, const float fPosY );只设置精灵Y坐标szName:指向要设置位置的精灵的名字fPosY：Y坐标float dGetSpritePositionX( const char *szName);获取精灵X坐标。szName:指向要获得X坐标的精灵的名字float dGetSpritePositionY(const char *szName);获取精灵Y坐标szName:指向要获得Y坐标的精灵的名字void dSetSpriteRotation( const char *szName,const float fRot);设置精灵的旋转角度szName:指向要设置旋转的精灵的名字参数fRot：旋转角度，范围0 - 360float dGetSpriteRotation(const char *szName);获取精灵的旋转角度szName:指向要获得旋转角度的精灵的名字voidSetSpriteLifeTime( const char *szName,const float fLifeTime );设置精灵的生命时长。超过生命时长，精灵被删除。szName:指向要设置精灵生命周期的名字fLifeTime：生命时长，单位秒Void dSetSpriteConstantForceX( const char *szName，const float fForceX);设置精灵X方向常量推力szName:指向要设置X方向常量推力的精灵的名字fForceX：X方向推力大小void dSetSpriteConstantForceY( const char *szName, const float fForceY );设置精灵Y方向常量推力szName:指向要设置Y方向常量推力的精灵的名字fForceY：Y方向推力大小float dGetSpriteLinkPointPosX( const char *szName, const int iId );获取精灵链接点X坐标szName:指向要获得X方向链接点的精灵的名字参数 iId：链接点序号，第一个链接点为1，后面依次递加floatdGetSpriteLinkPointPosY( const char *szName,const int iId );获取精灵链接点Y坐标。szName:指向要获得Y方向链接点的精灵的名字参数 iId：链接点序号，第一个链接为1，后面依次递加void dSetSpriteImpulseForcePolar( const char *szName，const float fPolar, const float fForce, const int iGravitic );按角度朝向设置精灵瞬间推力szName:指向要设置瞬间推力的精灵的名字fPolar：角度朝向fForce：推力大小iGravitic：是否计算重力1：计算0：不计算float dGetSpriteMass(const char *szName);获取精灵质量返回值 ：质量大小szName:指向要获得质量的精灵的名字播放动态精灵的APIAPI功能与返回值参数说明int dAnimateSpritePlayAnimation( const char *szName,const char *szAnim, const int iRestore );动画精灵播放动画返回值：是否播放成功 1表示成功，0表示不成功szName:指向要播放动画的精灵的名字szAnim：动画名字。注意不是精灵名称。bRestore：播放完毕后是否恢复当前动画1：恢复 0：不恢复char szGotGoldName20;设置文字精灵的API类成员函数功能与返回值参数说明void dSetTextValue( const char *szName,int iValue );文字精灵显示某个数值szName:指向文字精灵的名字iValue：要显示的数值设置特效精灵的APIAPI功能与返回值参数说明voiddPlayEffect( const char *szSrcName,const float fLifeTime, const float fPosX, const float fPosY, const float fRotation);播放一个不循环的特效,播放完毕之后该特效自动删除szSrcName:特效精灵的名字，fLifeTime：特效精灵的生命长度，fPosX：播放的X坐标 fPosY：播放的Y坐标fRotation：播放的角度朝向设置播放声音的APIAPI功能与返回值参数说明void dPlaySound(const char *szName, const int iLoop, const float fVolume );播放声音特效szName：播放声音的路径或者名称iLoop：是播放否循环播放1：循环播放0：不循环播放fVolume ：0-1音量的大小void dStopSound( const int iSoundId);停止播放该声音iSoundId：播放声音的时候返回的声音的ID系统相关功能的APIAPI功能与返回值参数说明static floatdGetScreenLeft();获取世界边界之左边X坐标static floatdGetScreenTop();获取世界边界之上边Y坐标static floatdGetScreenRight();获取世界边界之右边X坐标static floatdGetScreenBottom();获取世界边界之下边Y坐标static char* dMakeSpriteName(const char *szPrev, const int iId);将前面的字符串与后面的数字整合成一个字符串。返回值：返回一个字符串，比如传入(xxx, 2),则返回xxx2szPrev：一个非空字符串，最长不能超过20个英文字符。iId：一个数字CSystem: MakeSpriteName(“xxx”,2);得到xxx2的字符串static voiddSetWindowTitle( const char *szTitle );设置窗口名字/标题szTitle：非空字符串static intdRandomRange( const int iMin, const int iMax );获取一个位于参数1到参数2之间的随机数返回值：int，范围iMin - iMaxiMin：小于iMax的整数iMax：大于iMin的