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 )