FunCodeC開發(fā)常用API

1、FunCode C開發(fā)常用APIC語(yǔ)言標(biāo)準(zhǔn)庫(kù)函數(shù)在實(shí)驗(yàn)中，我們需要用到一些 C語(yǔ)言標(biāo)準(zhǔn)庫(kù)函數(shù)，主要用于字符串處理，獲得隨機(jī)值, 處理數(shù)學(xué)函數(shù)等。Math.h函數(shù)原型功能與返回值參數(shù)說(shuō)明與應(yīng)用舉例P ublic static double返回兩點(diǎn)之間的正X：點(diǎn)的x坐標(biāo)ata n2(切值y :點(diǎn)的y坐標(biāo)double y, double xfloat ftan）；=ata n2(fMouseY-fY),(fMouseX-fX);float sqrt(功能：計(jì)算平方根sqrt(9) = 3float x);返回值：x的平方根Stdio.h函數(shù)原型功能與返回值參數(shù)說(shuō)明與應(yīng)用舉例int sprintf(c

2、har *buffer, const char *format, argume nt);把格式化的數(shù)據(jù)寫 入某個(gè)字符串緩沖 區(qū)。返回值：字符串長(zhǎng)度（strlen）buffer: char型指針，指向?qū)⒁獙懭氲?字符串的緩沖區(qū)。format: char型指針，指向的內(nèi)存里面 存放的將要格式字符串。argument.:可選參數(shù)，可以是任何類 型的數(shù)據(jù)。sprin tf（szUfoName,ufo_%d_%d,iLo op, iTotalUfoCo unt ）;Stri ng.h函數(shù)原型功能與返回值參數(shù)說(shuō)明與應(yīng)用舉例extern char *strstr(找出str2 字符串strstr(szNam

3、e, feichong )!= NULLchar *str1,在str1字符串中說(shuō)明szName中包含feichongchar *str2第一次出現(xiàn)的位置可以用來(lái)判斷前一個(gè)字符串包含后面);（不包括 str2 的 串結(jié)束符）。返回值：返回該位 置的指針，如找不 至U,返回空指針。一個(gè)字符串extern int strc mp(比較字符串s1和strcmp(szName,feichong_0 ” = 0const char *s1,s2。說(shuō)明 szName 與 feichong_0 相等const char * s2當(dāng)s1s2時(shí)，返回可以用 來(lái)判斷前后兩 個(gè)字符串 的值);值s2時(shí)，返回值0ex

4、ter n char *strc py( char *dest, const char *src)；把從src地址開始 且含有NULL結(jié)束 符的字符串復(fù)制到 以dest開始的地址 空間返回指向dest的指 針。strcpy( big“” ：ufo ” );前一個(gè)字符串的內(nèi)容變?yōu)椤?ufo ”void *memc py( const char* dest, const char *src, size_t n,);從源src所指的內(nèi) 存地址的起始位置 開始拷貝n個(gè)字節(jié) 到目標(biāo)dest所指 的內(nèi)存地址的起始 位置中函數(shù)返回dest的值memcpy( m_iGridData, m_iLevelData

5、2, sizeof(i nt) * GRID_COUNT*GRID_COUNT );exter nun sig nedintstrle n(char*s);計(jì)算字符串s的(unsigned int 型)長(zhǎng)度，不包括0在 內(nèi)返回s的長(zhǎng)度，不 包括結(jié)束符NULL。int iStrLen =strlen( ufo” );Fun Code C API播放靜態(tài)精靈的 APIAPI功能與返回值參數(shù)說(shuō)明int dCl oneSp rite(c onst char *szSrcName, const char*szMyName );1表示克隆成功，0克 隆失敗。失敗的原因 可能是在地圖中未找 到對(duì)應(yīng)名字的精靈

6、szSrcName：被復(fù)制的精靈模 板的名稱szMyName指向我們復(fù)制出 來(lái)精靈的名字VoiddSetSpriteWidth( const char *szName,constfloatfWidth );設(shè)置精靈外形寬度數(shù)組szName指向我們要設(shè)置寬度的精靈的名字fWidth :寬度值，大于 0floatdGetS priteWidth(con st char*szName );獲取精靈外形寬度 返回值：精靈寬度值szName：指向要獲得寬度的 精靈VoiddSetS priteHeight(const設(shè)置精靈外形高度szName:指向要設(shè)置高度的 精靈的名字char*szName,c o

7、nstfloatfHeight)；fHeight :精靈高度值floatdGetS priteHeight(co nst char *szName);獲取精靈外形高度szName：指向要獲得咼度的 精靈的名字voiddSetS priteL in earVelocity(c onstchar *szName, constfloatfVelX, constfloatfVelY);設(shè)置精靈移動(dòng)速度szName：指向要設(shè)置速度的 精靈的名字fVelX : X方向速度f(wàn)VelY : Y方向速度f(wàn)loatdGetS 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);按角度朝向設(shè)置精靈 移動(dòng)速度szName：指向要設(shè)置角速度 的精靈的名字fSpeed :移動(dòng)速度f(wàn)Polar :角度朝向voiddSetS priteCollisio nSen

9、 d(co nst char *szName, const int iSe nd);設(shè)置精靈是否可以發(fā) 送（產(chǎn)生）碰撞szName：指向要設(shè)置發(fā)送碰 撞的精靈的名字iSend : 1可以發(fā)送碰撞0不可以發(fā)送碰撞voiddSetS priteCollisio nReceive (const char *szName, const int iReceive;);設(shè)置精靈是否可以接受碰撞szName：指向要設(shè)置接收碰 撞的精靈的名字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);設(shè)置精靈的世界邊界坐標(biāo)限制及碰撞模式szName:指向要設(shè)置世界邊 界和碰撞模式的精靈的名字 Limit :碰撞到世界邊界之后 的響應(yīng)模式，如果為NULL,碰撞反應(yīng)由代碼決定。其它 值見 EWorldLimitfLeft :邊界的左邊 X坐標(biāo) fTop :邊界的上邊丫坐標(biāo) fRight :邊界的右邊X坐標(biāo) fBottom :邊界的下邊 丫坐標(biāo)voiddSetS priteFli pX(const char *szNam

11、e, const int iFli pX);設(shè)置精靈圖片 X方向 翻轉(zhuǎn)顯示szName:指向要翻轉(zhuǎn)的精靈 的名字iFli pX : 1 翻轉(zhuǎn)0不翻轉(zhuǎn)（恢復(fù)原來(lái)朝向）void dSetS priteVisible( const char *szName, con st i nt iVisible);設(shè)置精靈隱藏或者顯 示（可見不可見）szName:指向要隱藏的精靈 的名字iVisible : 1 可見0不可見void dDeleteS prite( const char *szName);在地圖中刪除與本對(duì) 象實(shí)例關(guān)聯(lián)的精靈szName:指向要?jiǎng)h除的精靈 的名字void dSp riteMove

12、To( const char *szName, co nst float fPosX, co nst float fPosY, const float fSp eed, const int iAutoSt op );讓精靈按照給疋速度 移動(dòng)到給定坐標(biāo)點(diǎn)szName:指向要移動(dòng)的精靈 的名字fPosX :移動(dòng)的目標(biāo)X坐標(biāo)值 fPosY :移動(dòng)的目標(biāo) 丫坐標(biāo)值 fSpeed :移動(dòng)速度iAutoStoP :移動(dòng)到終點(diǎn)之后 是否自動(dòng)停止。1表示停止；0不停止。void dSetS priteP ositio n( cos nt char* szName,const float fPosX, cons

13、t float fPosY);設(shè)置精靈位置szName:指向要設(shè)置位置的 精靈的名字fPosX : X 坐標(biāo)fPosY : Y 坐標(biāo)void dSetS pritePo sitio nX( const char *szName, con st float fPosX);只設(shè)置精靈X坐標(biāo)szName:指向要設(shè)置位置的 精靈的名字fPosX : X 坐標(biāo)void dSetS priteP ositio nY( const char *szName, const float fPosY);只設(shè)置精靈丫坐標(biāo)szName:指向要設(shè)置位置的 精靈的名字fPosY : Y 坐標(biāo)float dGetS pri

14、te Positio nX( const char *szName);獲取精靈X坐標(biāo)。szName:指向要獲得X坐標(biāo)的精靈的名字float dGetS prite Positio nY( const char *szName);獲取精靈丫坐標(biāo)szName:指向要獲得丫坐標(biāo)的精靈的名字void dSetS priteRotatio n( const char *szName, const float fRot);設(shè)置精靈的旋轉(zhuǎn)角度szName:指向要設(shè)置旋轉(zhuǎn)的 精靈的名字參數(shù)fRot :旋轉(zhuǎn)角度，范圍0 - 360float dGetS priteRotatio n( const char *s

15、zName);獲取精靈的旋轉(zhuǎn)角度szName:指向要獲得旋轉(zhuǎn)角 度的精靈的名字voidSets priteLifeTime(const char *szName, const float fLifeTime);設(shè)置精靈的生命時(shí) 長(zhǎng)。超過(guò)生命時(shí)長(zhǎng)， 精靈被刪除。szName:指向要設(shè)置精靈生 命周期的名字fLifeTime :生命時(shí)長(zhǎng)，單位秒VoidszName:指向要設(shè)置 X方向常設(shè)置精靈X方冋吊量dSetS priteCo nsta ntForceX推力量推力的精靈的名字(const char *szName,const float fForceX);fForceX : X萬(wàn)向推力大小voi

16、dszName:指向要設(shè)置 丫方向常設(shè)置精靈Y方冋吊量dSetS priteCo nsta ntForceY(推力量推力的精靈的名字const char *szName, const float fForceY );fForceY : Y方向推力大小float獲取精靈鏈接點(diǎn) X坐szName:指向要獲得X方向鏈dGetS priteL inkPointP osX(標(biāo)接點(diǎn)的精靈的名字const char *szName,參數(shù)ild :鏈接點(diǎn)序號(hào)，第const int iId一個(gè)鏈接點(diǎn)為1,后面依次遞);加float獲取精靈鏈接點(diǎn) 丫坐szName:指向要獲得丫方向鏈dGetS priteLi n

17、kP oi ntP osY(標(biāo)。接點(diǎn)的精靈的名字const char *szName,參數(shù)ild :鏈接點(diǎn)序號(hào)，第const int iId);一個(gè)鏈接為1,后面依次遞加void按角度朝向設(shè)置精靈szName:指向要設(shè)置瞬間推dSetS pritel mpu IseForce Pola瞬間推力力的精靈的名字r(fPolar :角度朝向const char *szName,fForce :推力大小const float fPolar,iGravitic :是否計(jì)算重力const float fForce,1:計(jì)算const int iGravitic);0:不計(jì)算float dGetS prit

18、eMass( const char *szName);獲取精靈質(zhì)量、亡 1t Airrr- i=r. r . . tszName:指向要獲得質(zhì)量的 精靈的名字返回值：質(zhì)量大小播放動(dòng)態(tài)精靈的 APIAPI功能與返回值參數(shù)說(shuō)明intdAni mates prite PlayA ni mati on(const char *szName, const char *szA nim, const int iRestore動(dòng)畫精靈播放動(dòng)畫 返回值：是否播放 成功1表示成功，0表示不成功szName:指向要播放動(dòng)畫的精靈的 名字szAnim :動(dòng)畫名字。注意不是精靈 名稱。bRestore:播放完畢后是否恢

19、復(fù)當(dāng) 前動(dòng)畫1:恢復(fù));0:不恢復(fù)char szGotGoldName20;設(shè)置文字精靈的 API類成員函數(shù)功能與返回值參數(shù)說(shuō)明void dSetTextValue( const char *szName, int iValue);文字精靈顯示某個(gè)數(shù)值szName:指向文字精靈的名字iValue :要顯示的數(shù)值設(shè)置特效精靈的 APIAPI功能與返回值參數(shù)說(shuō)明void dP layEfect(const char *szSrcName, const float fLifeTime, const float fPosX, const float fPosY,const float fRotati

20、on);播放一個(gè)不循環(huán)的 特效,播放完畢之后 該特效自動(dòng)刪除szSrcName:特效精靈的名字， fLifeTime :特效精靈的生命長(zhǎng)度， fPosX :播放的X坐標(biāo) fPosY :播放的丫坐標(biāo) fRotation :播放的角度朝向設(shè)置播放聲音的 APIAPI功能與返回值參數(shù)說(shuō)明void dP laySou nd( const char *szName, const int iLo op, const float fVolume );播放聲音特效szName：播放聲音的路徑或者名稱 iLoop :是播放否循環(huán)播放1循環(huán)播放0：不循環(huán)播放fVolume : 0-1音量的大小void dSt o

21、pSound( const int iSo un dId);停止播放該聲音iSoundld :播放聲音的時(shí)候返回的 聲音的ID系統(tǒng)相關(guān)功能的APIAPI功能與返回值參數(shù)說(shuō)明static floatdGetScree nLeft();獲取世界邊界之左 邊X坐標(biāo)static float dGetScree nTo p();獲取世界邊界之上 邊丫坐標(biāo)static floatdGetScree nRight();獲取世界邊界之右 邊X坐標(biāo)static float dGetScree nBottom();獲取世界邊界之下 邊丫坐標(biāo)static char*dMakeS priteName( const c

22、har *sz Prev, const int iId);將前面的字符串與 后面的數(shù)字整合成 一個(gè)字符串。返回值：返回一個(gè) 字符串，比如傳入szP rev： 一個(gè)非空字符串，最長(zhǎng)不 能超過(guò)20個(gè)英文字符。iId :一個(gè)數(shù)字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