FunCode C 开发常用API说课讲解.docx

1、FunCode C 开发常用API说课讲解FunCode C 开发常用APIFunCode 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) = 3Std

2、io.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 *st

3、rstr(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相

4、等可以用来判断前后两个字符串的值相等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

5、, sizeof(int) * GRID_COUNT * GRID_COUNT );extern unsigned int strlen(char *s);计算字符串s的（unsigned int型）长度，不包括0在内返回s的长度，不包括结束符NULL。int iStrLen = strlen(“ufo” );FunCode C API播放静态精灵的APIAPI功能与返回值参数说明int dCloneSprite(const char *szSrcName, const char *szMyName );1表示克隆成功，0克隆失败。失败的原因可能是在地图中未找到对应名字的精灵szSrcName

6、：被复制的精灵模板的名称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:指

7、向要设置高度的精灵的名字fHeight：精灵高度值float dGetSpriteHeight(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方向速度szNa

8、me：指向要获得速度的精灵的名字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, co

9、nst 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, co

10、nst float fTop, const float fRight, const float fBottom );设置精灵的世界边界坐标限制及碰撞模式szName:指向要设置世界边界和碰撞模式的精灵的名字Limit：碰撞到世界边界之后的响应模式，如果为NULL，碰撞反应由代码决定。其它值见 EWorldLimitfLeft：边界的左边X坐标fTop：边界的上边Y坐标fRight：边界的右边X坐标fBottom：边界的下边Y坐标void dSetSpriteFlipX( const char *szName,const int iFlipX );设置精灵图片X方向翻转显示szName:指向要翻

11、转的精灵的名字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, c

12、onst 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 dSetSpritePosit

13、ionX( 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 *sz

14、Name);获取精灵Y坐标szName:指向要获得Y坐标的精灵的名字void dSetSpriteRotation( const char *szName,const float fRot);设置精灵的旋转角度szName:指向要设置旋转的精灵的名字参数fRot：旋转角度，范围0 - 360float dGetSpriteRotation(const char *szName);获取精灵的旋转角度szName:指向要获得旋转角度的精灵的名字void SetSpriteLifeTime( const char *szName,const float fLifeTime );设置精灵的生命时长。超

15、过生命时长，精灵被删除。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方向推力大小flo

16、at 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 *s

17、zName，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

18、,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功能与

19、返回值参数说明void dPlayEffect( 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

20、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 float dGetScreenRig

21、ht();获取世界边界之右边X坐标 static float dGetScreenBottom();获取世界边界之下边Y坐标static char* dMakeSpriteName(const char *szPrev, const int iId);将前面的字符串与后面的数字整合成一个字符串。返回值：返回一个字符串，比如传入(xxx, 2),则返回xxx2szPrev：一个非空字符串，最长不能超过20个英文字符。iId：一个数字CSystem: MakeSpriteName(“xxx”,2);得到xxx2的字符串static void dSetWindowTitle( const char

22、*szTitle );设置窗口名字/标题szTitle：非空字符串static int dRandomRange( const int iMin, const int iMax );获取一个位于参数1到参数2之间的随机数返回值：int，范围iMin - iMaxiMin：小于iMax的整数iMax：大于iMin的整数static void dShowCursor( const bool bShow );隐藏/显示鼠标bShow：true 为显示false 为隐藏static void dDrawLine( const float fStartX,const float fStartY, con

23、st float fEndX, const float fEndY, const float fLineWidth, const int iLayer, const int iRed, const int iGreen, const int iBlue, const int iAlpha );在两点之间画一条线fStartX：起始坐标XfStartY：起始坐标YfEndX：终点坐标XfEndY：终点坐标YfLineWidth：线的粗细，大于等于1iLayer：改线所在的层，与编辑器里设置的精灵的层级是同一个概念。范围0 - 31。参数 iRed, iGreen, iBlue : 红绿蓝三原色的颜色值，范围 0 - 255参数 iAlpha：线的透明度，范围0-255. 0为全透明，255为不透明Static floatdRotationToVectorX( const float fRotation );计算某个角度对应的直线向量的X方向返回值 ：该直线向量的X值fRotation：角度，范围0 - 360static floatdRotationToVectorY( const float fRotation );计算某个角度对应的直线向量的Y方向返回值 ：该直线向量的Y值fRotation：角度，范围0 - 360