十二、艦隊相關函數(unlocalised.php)
本節將把艦隊派遣相關的函數做個說明,繼續以注釋方式說明;由於這次涉及的函數比較多,需要花不少時間來整理消化。
// ------------------------------------------------------------------- // // 以下是艦隊派遣需要用到的函數列表 // // ------------------------------------------------------------------- // 計算兩個星球之間的距離 function GetTargetDistance ($OrigGalaxy, $DestGalaxy, $OrigSystem, $DestSystem, $OrigPlanet, $DestPlanet) // 計算艦隊到達指定距離需要的時間,這裡會考慮服務器的倍速設置 function GetMissionDuration ($GameSpeed, $MaxFleetSpeed, $Distance, $SpeedFactor) // 取得游戲設置後的艦隊速度 function GetGameSpeedFactor () // 計算艦隊的最大速度 function GetFleetMaxSpeed ($FleetArray, $Fleet, $Player) // 計算單個艦種的HH消耗 function GetShipConsumption ( $Ship, $Player ) // 計算艦隊的HH消耗,這裡就是實際的HH消耗量,傳入了很多參數 function GetFleetConsumption ($FleetArray, $SpeedFactor, $MissionDuration, $MissionDistance, $FleetMaxSpeed, $Player) // ------------------------------------------------------------------- // // 以下是字符串的格式化顯示函數列表 // // ------------------------------------------------------------------- // 格式化時間,形如:xxd xxh xxm function pretty_time ($seconds) // 格式化分鐘,形如:xxmin function pretty_time_hour ($seconds) // 建造時間格式,前面會有說明 function ShowBuildTime ($time) //孤立函數,沒有被調用 function add_points ($resources, $userid) //孤立函數,沒有被調用 function remove_points ($resources, $userid) //孤立函數,沒有被調用 function get_userdata () // ------------------------------------------------------------------- // // 以下是模板文件的讀/寫/使用函數列表 // // ------------------------------------------------------------------- // 根據文件名讀取文件內容 function ReadFromFile($filename) //孤立函數,沒有被調用 function SaveToFile ($filename, $content) //前面介紹過,用$array的值進行替換 function parsetemplate ($template, $array) //也介紹過,就是取得指定模板文件的內容 function gettemplate ($templatename) // include不同語言文件 function includeLang ($filename, $ext = '.mo') // ------------------------------------------------------------------- // // 以下是艦隊鏈接類函數列表 // // ------------------------------------------------------------------- // 構造一個艦隊起始星球的星圖超鏈接 function GetStartAdressLink ( $FleetRow, $FleetType ) // 構造一個艦隊目的星球的星圖超鏈接 function GetTargetAdressLink ( $FleetRow, $FleetType ) // 構造一個指定星球的星圖超鏈接 function BuildPlanetAdressLink ( $CurrentPlanet ) // 構造一個給攻擊者的發送消息到超鏈接 function BuildHostileFleetPlayerLink ( $FleetRow ) // 取得下次月門的開啟時間 function GetNextJumpWaitTime ( $CurMoon ) // 構造一個攻擊艦隊明細列表 function CreateFleetPopupedFleetLink ( $FleetRow, $Texte, $FleetType ) //構造一個返回艦隊的明細列表,包括有無資源 function CreateFleetPopupedMissionLink ( $FleetRow, $Texte, $FleetType )