mirror of
https://github.com/weyne85/DML.git
synced 2025-10-29 16:57:49 +00:00
259 lines
11 KiB
Lua
259 lines
11 KiB
Lua
cfxMX = {}
|
|
cfxMX.version = "1.2.1"
|
|
cfxMX.verbose = false
|
|
--[[--
|
|
Mission data decoder. Access to ME-built mission structures
|
|
|
|
Copyright (c) 2022 by Christian Franz and cf/x AG
|
|
|
|
Version History
|
|
1.0.0 - initial version
|
|
1.0.1 - getStaticFromDCSbyName()
|
|
1.1.0 - getStaticFromDCSbyName also copies groupID when not fetching orig
|
|
- on start up collects a cross reference table of all
|
|
original group id
|
|
- add linkUnit for statics
|
|
1.2.0 - added group name reference table
|
|
- added group type reference
|
|
- added references for allFixed, allHelo, allGround, allSea, allStatic
|
|
1.2.1 - added countryByName
|
|
- added linkByName
|
|
|
|
--]]--
|
|
cfxMX.groupNamesByID = {}
|
|
cfxMX.groupIDbyName = {}
|
|
cfxMX.groupDataByName = {}
|
|
cfxMX.countryByName ={}
|
|
cfxMX.linkByName = {}
|
|
cfxMX.allFixedByName = {}
|
|
cfxMX.allHeloByName = {}
|
|
cfxMX.allGroundByName = {}
|
|
cfxMX.allSeaByName = {}
|
|
cfxMX.allStaticByName ={}
|
|
|
|
function cfxMX.getGroupFromDCSbyName(aName, fetchOriginal)
|
|
if not fetchOriginal then fetchOriginal = false end
|
|
-- fetch the group description for goup named aName (if exists)
|
|
-- returned structure must be parsed for useful information
|
|
-- returns data, category, countyID and coalitionID
|
|
-- unless fetchOriginal is true, creates a deep clone of
|
|
-- group data structure
|
|
|
|
for coa_name_miz, coa_data in pairs(env.mission.coalition) do -- iterate all coalitions
|
|
local coa_name = coa_name_miz
|
|
if string.lower(coa_name_miz) == 'neutrals' then -- remove 's' at neutralS
|
|
coa_name = 'neutral'
|
|
end
|
|
-- directly convert coalition into number for easier access later
|
|
local coaNum = 0
|
|
if coa_name == "red" then coaNum = 1 end
|
|
if coa_name == "blue" then coaNum = 2 end
|
|
|
|
if type(coa_data) == 'table' then -- coalition = {bullseye, nav_points, name, county},
|
|
-- with county being an array
|
|
if coa_data.country then -- make sure there a country table for this coalition
|
|
for cntry_id, cntry_data in pairs(coa_data.country) do -- iterate all countries for this
|
|
-- per country = {id, name, vehicle, helicopter, plane, ship, static}
|
|
local countryName = string.lower(cntry_data.name)
|
|
local countryID = cntry_data.id
|
|
if type(cntry_data) == 'table' then -- filter strings .id and .name
|
|
for obj_type_name, obj_type_data in pairs(cntry_data) do
|
|
if obj_type_name == "helicopter" or
|
|
obj_type_name == "ship" or
|
|
obj_type_name == "plane" or
|
|
obj_type_name == "vehicle" or
|
|
obj_type_name == "static"
|
|
then -- (so it's not id or name)
|
|
local category = obj_type_name
|
|
if ((type(obj_type_data) == 'table') and obj_type_data.group and (type(obj_type_data.group) == 'table') and (#obj_type_data.group > 0)) then --there's at least one group!
|
|
for group_num, group_data in pairs(obj_type_data.group) do
|
|
if group_data.name == aName then
|
|
local theGroup = group_data
|
|
-- usually we return a copy of this
|
|
if not fetchOriginal then
|
|
theGroup = dcsCommon.clone(group_data)
|
|
end
|
|
return theGroup, category, countryID
|
|
end
|
|
end
|
|
end --if has category data
|
|
end --if plane, helo etc... category
|
|
end --for all objects in country
|
|
end --if has country data
|
|
end --for all countries in coalition
|
|
end --if coalition has country table
|
|
end -- if there is coalition data
|
|
end --for all coalitions in mission
|
|
return nil, "none", "none"
|
|
end
|
|
|
|
function cfxMX.getStaticFromDCSbyName(aName, fetchOriginal)
|
|
if not fetchOriginal then fetchOriginal = false end
|
|
-- fetch the static description for static named aName (if exists)
|
|
-- returned structure must be parsed for useful information
|
|
-- returns data, category, countyID and parent group name
|
|
-- unless fetchOriginal is true, creates a deep clone of
|
|
-- static data structure
|
|
|
|
for coa_name_miz, coa_data in pairs(env.mission.coalition) do -- iterate all coalitions
|
|
local coa_name = coa_name_miz
|
|
if string.lower(coa_name_miz) == 'neutrals' then -- remove 's' at neutralS
|
|
coa_name = 'neutral'
|
|
end
|
|
-- directly convert coalition into number for easier access later
|
|
local coaNum = 0
|
|
if coa_name == "red" then coaNum = 1 end
|
|
if coa_name == "blue" then coaNum = 2 end
|
|
|
|
if type(coa_data) == 'table' then -- coalition = {bullseye, nav_points, name, county},
|
|
-- with county being an array
|
|
if coa_data.country then -- make sure there a country table for this coalition
|
|
for cntry_id, cntry_data in pairs(coa_data.country) do -- iterate all countries for this
|
|
-- per country = {id, name, vehicle, helicopter, plane, ship, static}
|
|
local countryName = string.lower(cntry_data.name)
|
|
local countryID = cntry_data.id
|
|
if type(cntry_data) == 'table' then -- filter strings .id and .name
|
|
for obj_type_name, obj_type_data in pairs(cntry_data) do
|
|
if obj_type_name == "static"
|
|
-- obj_type_name == "helicopter" or
|
|
-- obj_type_name == "ship" or
|
|
-- obj_type_name == "plane" or
|
|
-- obj_type_name == "vehicle" or
|
|
-- obj_type_name == "static"
|
|
then -- (only look at statics)
|
|
local category = obj_type_name
|
|
if ((type(obj_type_data) == 'table') and obj_type_data.group and (type(obj_type_data.group) == 'table') and (#obj_type_data.group > 0)) then --there's at least one static in group!
|
|
for group_num, group_data in pairs(obj_type_data.group) do
|
|
-- get linkUnit info if it exists
|
|
local linkUnit = nil
|
|
if group_data and group_data.route and group_data.route and group_data.route.points[1] then
|
|
linkUnit = group_data.route.points[1].linkUnit
|
|
if linkUnit then
|
|
--trigger.action.outText("MX: found missing link to " .. linkUnit .. " in " .. group_data.name, 30)
|
|
end
|
|
end
|
|
|
|
if group_data and group_data.units and type(group_data.units) == 'table'
|
|
then --make sure - again - that this is a valid group
|
|
for unit_num, unit_data in pairs(group_data.units) do -- iterate units
|
|
if unit_data.name == aName then
|
|
local groupName = group_data.name
|
|
local theStatic = unit_data
|
|
if not fetchOriginal then
|
|
theStatic = dcsCommon.clone(unit_data)
|
|
-- copy group ID from group above
|
|
theStatic.groupId = group_data.groupId
|
|
-- copy linked unit data
|
|
theStatic.linkUnit = linkUnit
|
|
|
|
end
|
|
return theStatic, category, countryID, groupName
|
|
|
|
end -- if name match
|
|
end -- for all units
|
|
end -- has groups
|
|
|
|
end -- is a static
|
|
end --if has category data
|
|
end --if plane, helo etc... category
|
|
end --for all objects in country
|
|
end --if has country data
|
|
end --for all countries in coalition
|
|
end --if coalition has country table
|
|
end -- if there is coalition data
|
|
end --for all coalitions in mission
|
|
return nil, "<none>", "<none>", "<no group name>"
|
|
end
|
|
|
|
function cfxMX.createCrossReferences()
|
|
for coa_name_miz, coa_data in pairs(env.mission.coalition) do -- iterate all coalitions
|
|
local coa_name = coa_name_miz
|
|
if string.lower(coa_name_miz) == 'neutrals' then -- remove 's' at neutralS
|
|
coa_name = 'neutral'
|
|
end
|
|
-- directly convert coalition into number for easier access later
|
|
local coaNum = 0
|
|
if coa_name == "red" then coaNum = 1 end
|
|
if coa_name == "blue" then coaNum = 2 end
|
|
|
|
if type(coa_data) == 'table' then -- coalition = {bullseye, nav_points, name, county},
|
|
-- with county being an array
|
|
if coa_data.country then -- make sure there a country table for this coalition
|
|
for cntry_id, cntry_data in pairs(coa_data.country) do -- iterate all countries for this
|
|
-- per country = {id, name, vehicle, helicopter, plane, ship, static}
|
|
local countryName = string.lower(cntry_data.name)
|
|
local countryID = cntry_data.id
|
|
if type(cntry_data) == 'table' then -- filter strings .id and .name
|
|
for obj_type_name, obj_type_data in pairs(cntry_data) do
|
|
if obj_type_name == "helicopter" or
|
|
obj_type_name == "ship" or
|
|
obj_type_name == "plane" or
|
|
obj_type_name == "vehicle" or
|
|
obj_type_name == "static" -- what about "cargo"?
|
|
then -- (so it's not id or name)
|
|
local category = obj_type_name
|
|
if ((type(obj_type_data) == 'table') and obj_type_data.group and (type(obj_type_data.group) == 'table') and (#obj_type_data.group > 0)) then --there's at least one group!
|
|
for group_num, group_data in pairs(obj_type_data.group) do
|
|
|
|
local aName = group_data.name
|
|
local aID = group_data.groupId
|
|
-- get linkUnit info if it exists
|
|
local linkUnit = nil
|
|
if group_data and group_data.route and group_data.route and group_data.route.points[1] then
|
|
linkUnit = group_data.route.points[1].linkUnit
|
|
cfxMX.linkByName[aName] = linkUnit
|
|
end
|
|
|
|
cfxMX.groupNamesByID[aID] = aName
|
|
cfxMX.groupIDbyName[aName] = aID
|
|
cfxMX.groupDataByName[aName] = group_data
|
|
cfxMX.countryByName[aName] = cntry_id
|
|
-- now make the type-specific xrefs
|
|
if obj_type_name == "helicopter" then
|
|
cfxMX.allHeloByName[aName] = group_data
|
|
elseif obj_type_name == "ship" then
|
|
cfxMX.allSeaByName[aName] = group_data
|
|
elseif obj_type_name == "plane" then
|
|
cfxMX.allFixedByName[aName] = group_data
|
|
elseif obj_type_name == "vehicle" then
|
|
cfxMX.allGroundByName[aName] = group_data
|
|
elseif obj_type_name == "static" then
|
|
cfxMX.allStaticByName[aName] = group_data
|
|
else
|
|
-- should be impossible, but still
|
|
trigger.action.outText("+++MX: <" .. obj_type_name .. "> unknown type for <" .. aName .. ">", 30)
|
|
end
|
|
end
|
|
end --if has category data
|
|
end --if plane, helo etc... category
|
|
end --for all objects in country
|
|
end --if has country data
|
|
end --for all countries in coalition
|
|
end --if coalition has country table
|
|
end -- if there is coalition data
|
|
end --for all coalitions in mission
|
|
end
|
|
|
|
function cfxMX.catText2ID(inText)
|
|
local outCat = 0 -- airplane
|
|
local c = inText:lower()
|
|
if c == "helicopter" then outCat = 1 end
|
|
if c == "ship" then outCat = 3 end
|
|
if c == "plane" then outCat = 0 end -- redundant
|
|
if c == "vehicle" then outCat = 2 end
|
|
if c == "train" then outCat = 4 end
|
|
if c == "static" then outCat = -1 end
|
|
return outCat
|
|
end
|
|
|
|
function cfxMX.start()
|
|
cfxMX.createCrossReferences()
|
|
if cfxMX.verbose then
|
|
trigger.action.outText("cfxMX: "..#cfxMX.groupNamesByID .. " groups processed successfully", 30)
|
|
end
|
|
end
|
|
|
|
-- start
|
|
cfxMX.start()
|
|
|