PHP网页游戏学习之Xnova(ogame)源码解读（九）

十二、舰队相关函数（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 )