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 )