A stable modding interface between Techblox and mods https://mod.exmods.org/
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

381 lines
13KB

  1. using System;
  2. using Gamecraft.Wires;
  3. using Svelto.DataStructures;
  4. using Svelto.ECS;
  5. using TechbloxModdingAPI.Engines;
  6. using TechbloxModdingAPI.Utility;
  7. namespace TechbloxModdingAPI.Blocks.Engines
  8. {
  9. /// <summary>
  10. /// Engine which executes signal actions
  11. /// </summary>
  12. public class SignalEngine : IApiEngine, IFactoryEngine
  13. {
  14. public const float POSITIVE_HIGH = 1.0f;
  15. public const float NEGATIVE_HIGH = -1.0f;
  16. public const float HIGH = 1.0f;
  17. public const float ZERO = 0.0f;
  18. public string Name { get; } = "TechbloxModdingAPISignalGameEngine";
  19. public EntitiesDB entitiesDB { set; private get; }
  20. public IEntityFactory Factory { get; set; }
  21. public bool isRemovable => false;
  22. public bool IsInGame = false;
  23. public void Dispose()
  24. {
  25. IsInGame = false;
  26. }
  27. public void Ready()
  28. {
  29. IsInGame = true;
  30. }
  31. // implementations for block wiring
  32. public WireEntityStruct CreateNewWire(EGID startBlock, byte startPort, EGID endBlock, byte endPort)
  33. {
  34. EGID wireEGID = new EGID(BuildModeWiresGroups.NewWireEntityId, BuildModeWiresGroups.WiresGroup.Group);
  35. EntityInitializer wireInitializer = Factory.BuildEntity<WireEntityDescriptor>(wireEGID);
  36. wireInitializer.Init(new WireEntityStruct
  37. {
  38. sourceBlockEGID = startBlock,
  39. sourcePortUsage = startPort,
  40. destinationBlockEGID = endBlock,
  41. destinationPortUsage = endPort,
  42. ID = wireEGID
  43. });
  44. return wireInitializer.Get<WireEntityStruct>();
  45. }
  46. public ref WireEntityStruct GetWire(EGID wire)
  47. {
  48. if (!entitiesDB.Exists<WireEntityStruct>(wire))
  49. {
  50. throw new WiringException($"Wire {wire} does not exist");
  51. }
  52. return ref entitiesDB.QueryEntity<WireEntityStruct>(wire);
  53. }
  54. public ref PortEntityStruct GetPort(EGID port)
  55. {
  56. if (!entitiesDB.Exists<PortEntityStruct>(port))
  57. {
  58. throw new WiringException($"Port {port} does not exist (yet?)");
  59. }
  60. return ref entitiesDB.QueryEntity<PortEntityStruct>(port);
  61. }
  62. public ref PortEntityStruct GetPortByOffset(BlockPortsStruct bps, byte portNumber, bool input)
  63. {
  64. ExclusiveGroup group = input
  65. ? NamedExclusiveGroup<BuildModeWiresGroups.InputPortsGroup>.Group
  66. : NamedExclusiveGroup<BuildModeWiresGroups.OutputPortsGroup>.Group;
  67. uint id = (input ? bps.firstInputID : bps.firstOutputID) + portNumber;
  68. EGID egid = new EGID(id, group);
  69. if (!entitiesDB.Exists<PortEntityStruct>(egid))
  70. {
  71. throw new WiringException("Port does not exist");
  72. }
  73. return ref entitiesDB.QueryEntity<PortEntityStruct>(egid);
  74. }
  75. public ref PortEntityStruct GetPortByOffset(Block block, byte portNumber, bool input)
  76. {
  77. var bps = entitiesDB.QueryEntityOptional<BlockPortsStruct>(block);
  78. if (!bps)
  79. {
  80. throw new BlockException("Block does not exist");
  81. }
  82. return ref GetPortByOffset(bps, portNumber, input);
  83. }
  84. public ref T GetComponent<T>(EGID egid) where T : unmanaged, IEntityComponent
  85. {
  86. return ref entitiesDB.QueryEntity<T>(egid);
  87. }
  88. public bool Exists<T>(EGID egid) where T : struct, IEntityComponent
  89. {
  90. return entitiesDB.Exists<T>(egid);
  91. }
  92. public bool SetSignal(EGID blockID, float signal, out uint signalID, bool input = true)
  93. {
  94. signalID = GetSignalIDs(blockID, input)[0];
  95. return SetSignal(signalID, signal);
  96. }
  97. public bool SetSignal(uint signalID, float signal, bool input = true)
  98. {
  99. var (array, count) = GetSignalStruct(signalID, out uint index, input);
  100. if (count > 0) array[index].valueAsFloat = signal;
  101. return false;
  102. }
  103. public float AddSignal(EGID blockID, float signal, out uint signalID, bool clamp = true, bool input = true)
  104. {
  105. signalID = GetSignalIDs(blockID, input)[0];
  106. return AddSignal(signalID, signal, clamp, input);
  107. }
  108. public float AddSignal(uint signalID, float signal, bool clamp = true, bool input = true)
  109. {
  110. var (array, count) = GetSignalStruct(signalID, out uint index, input);
  111. if (count > 0)
  112. {
  113. ref var channelData = ref array[index];
  114. channelData.valueAsFloat += signal;
  115. if (clamp)
  116. {
  117. if (channelData.valueAsFloat > POSITIVE_HIGH)
  118. {
  119. channelData.valueAsFloat = POSITIVE_HIGH;
  120. }
  121. else if (channelData.valueAsFloat < NEGATIVE_HIGH)
  122. {
  123. channelData.valueAsFloat = NEGATIVE_HIGH;
  124. }
  125. return channelData.valueAsFloat;
  126. }
  127. }
  128. return signal;
  129. }
  130. public float GetSignal(EGID blockID, out uint signalID, bool input = true)
  131. {
  132. signalID = GetSignalIDs(blockID, input)[0];
  133. return GetSignal(signalID, input);
  134. }
  135. public float GetSignal(uint signalID, bool input = true)
  136. {
  137. var (array, count) = GetSignalStruct(signalID, out uint index, input);
  138. return count > 0 ? array[index].valueAsFloat : 0f;
  139. }
  140. public uint[] GetSignalIDs(EGID blockID, bool input = true)
  141. {
  142. ref BlockPortsStruct bps = ref entitiesDB.QueryEntity<BlockPortsStruct>(blockID);
  143. uint[] signals;
  144. if (input) {
  145. signals = new uint[bps.inputCount];
  146. for (uint i = 0u; i < bps.inputCount; i++)
  147. {
  148. signals[i] = bps.firstInputID + i;
  149. }
  150. } else {
  151. signals = new uint[bps.outputCount];
  152. for (uint i = 0u; i < bps.outputCount; i++)
  153. {
  154. signals[i] = bps.firstOutputID + i;
  155. }
  156. }
  157. return signals;
  158. }
  159. public EGID[] GetSignalInputs(EGID blockID)
  160. {
  161. BlockPortsStruct ports = entitiesDB.QueryEntity<BlockPortsStruct>(blockID);
  162. EGID[] inputs = new EGID[ports.inputCount];
  163. for (uint i = 0; i < ports.inputCount; i++)
  164. {
  165. inputs[i] = new EGID(i + ports.firstInputID, NamedExclusiveGroup<BuildModeWiresGroups.InputPortsGroup>.Group);
  166. }
  167. return inputs;
  168. }
  169. public EGID[] GetSignalOutputs(EGID blockID)
  170. {
  171. BlockPortsStruct ports = entitiesDB.QueryEntity<BlockPortsStruct>(blockID);
  172. EGID[] outputs = new EGID[ports.outputCount];
  173. for (uint i = 0; i < ports.outputCount; i++)
  174. {
  175. outputs[i] = new EGID(i + ports.firstOutputID, NamedExclusiveGroup<BuildModeWiresGroups.OutputPortsGroup>.Group);
  176. }
  177. return outputs;
  178. }
  179. public OptionalRef<PortEntityStruct> MatchBlockIOToPort(Block block, byte portUsage, bool output)
  180. {
  181. return MatchBlockIOToPort(block.Id, portUsage, output);
  182. }
  183. public OptionalRef<PortEntityStruct> MatchBlockIOToPort(EGID block, byte portUsage, bool output)
  184. {
  185. if (!entitiesDB.Exists<BlockPortsStruct>(block))
  186. return default;
  187. var group = output
  188. ? NamedExclusiveGroup<BuildModeWiresGroups.OutputPortsGroup>.Group
  189. : NamedExclusiveGroup<BuildModeWiresGroups.InputPortsGroup>.Group;
  190. BlockPortsStruct ports = entitiesDB.QueryEntity<BlockPortsStruct>(block);
  191. if (!entitiesDB.TryQueryMappedEntities<PortEntityStruct>(group, out var mapper))
  192. return default;
  193. for (uint i = 0; i < (output ? ports.outputCount : ports.inputCount); ++i)
  194. {
  195. uint entityID = (output ? ports.firstOutputID : ports.firstInputID) + i;
  196. if (!mapper.TryGetArrayAndEntityIndex(entityID, out var index, out var array) ||
  197. array[index].usage != portUsage) continue;
  198. return new OptionalRef<PortEntityStruct>(array, index);
  199. }
  200. return default;
  201. }
  202. public ref WireEntityStruct MatchPortToWire(PortEntityStruct port, EGID blockID, out bool exists)
  203. {
  204. var (wires, count) = entitiesDB.QueryEntities<WireEntityStruct>(NamedExclusiveGroup<BuildModeWiresGroups.WiresGroup>.Group);
  205. for (uint i = 0; i < count; i++)
  206. {
  207. if ((wires[i].destinationPortUsage == port.usage && wires[i].destinationBlockEGID == blockID)
  208. || (wires[i].sourcePortUsage == port.usage && wires[i].sourceBlockEGID == blockID))
  209. {
  210. exists = true;
  211. return ref wires[i];
  212. }
  213. }
  214. exists = false;
  215. WireEntityStruct[] defRef = new WireEntityStruct[1];
  216. return ref defRef[0];
  217. }
  218. public EGID MatchBlocksToWire(EGID startBlock, EGID endBlock, byte startPort = byte.MaxValue, byte endPort = byte.MaxValue)
  219. {
  220. EGID[] startPorts;
  221. if (startPort == byte.MaxValue)
  222. {
  223. // search all output ports on source block
  224. startPorts = GetSignalOutputs(startBlock);
  225. }
  226. else
  227. {
  228. BlockPortsStruct ports = entitiesDB.QueryEntity<BlockPortsStruct>(startBlock);
  229. startPorts = new EGID[] {new EGID(ports.firstOutputID + startPort, NamedExclusiveGroup<BuildModeWiresGroups.OutputPortsGroup>.Group) };
  230. }
  231. EGID[] endPorts;
  232. if (startPort == byte.MaxValue)
  233. {
  234. // search all input ports on destination block
  235. endPorts = GetSignalInputs(endBlock);
  236. }
  237. else
  238. {
  239. BlockPortsStruct ports = entitiesDB.QueryEntity<BlockPortsStruct>(endBlock);
  240. endPorts = new EGID[] {new EGID(ports.firstInputID + endPort, NamedExclusiveGroup<BuildModeWiresGroups.InputPortsGroup>.Group) };
  241. }
  242. var (wires, count) = entitiesDB.QueryEntities<WireEntityStruct>(NamedExclusiveGroup<BuildModeWiresGroups.WiresGroup>.Group);
  243. for (int endIndex = 0; endIndex < endPorts.Length; endIndex++)
  244. {
  245. PortEntityStruct endPES = entitiesDB.QueryEntity<PortEntityStruct>(endPorts[endIndex]);
  246. for (int startIndex = 0; startIndex < startPorts.Length; startIndex++)
  247. {
  248. PortEntityStruct startPES = entitiesDB.QueryEntity<PortEntityStruct>(startPorts[startIndex]);
  249. for (int w = 0; w < count; w++)
  250. {
  251. if ((wires[w].destinationPortUsage == endPES.usage && wires[w].destinationBlockEGID == endBlock)
  252. && (wires[w].sourcePortUsage == startPES.usage && wires[w].sourceBlockEGID == startBlock))
  253. {
  254. return wires[w].ID;
  255. }
  256. }
  257. }
  258. }
  259. return default;
  260. }
  261. public OptionalRef<ChannelDataStruct> GetChannelDataStruct(EGID portID)
  262. {
  263. var port = GetPort(portID);
  264. var (channels, count) = entitiesDB.QueryEntities<ChannelDataStruct>(NamedExclusiveGroup<BuildModeWiresGroups.ChannelDataGroup>.Group);
  265. return port.firstChannelIndexCachedInSim < count
  266. ? new OptionalRef<ChannelDataStruct>(channels, port.firstChannelIndexCachedInSim)
  267. : default;
  268. }
  269. public EGID[] GetElectricBlocks()
  270. {
  271. var res = new FasterList<EGID>();
  272. foreach (var ((coll, count), _) in entitiesDB.QueryEntities<BlockPortsStruct>())
  273. {
  274. for (int i = 0; i < count; i++)
  275. {
  276. ref BlockPortsStruct s = ref coll[i];
  277. //res.Add(s.ID); - TODO
  278. }
  279. }
  280. return res.ToArray();
  281. }
  282. public EGID[] WiredToInput(EGID block, byte port)
  283. {
  284. WireEntityStruct[] wireEntityStructs = Search(NamedExclusiveGroup<BuildModeWiresGroups.WiresGroup>.Group,
  285. (WireEntityStruct wes) => wes.destinationPortUsage == port && wes.destinationBlockEGID == block);
  286. EGID[] result = new EGID[wireEntityStructs.Length];
  287. for (uint i = 0; i < wireEntityStructs.Length; i++)
  288. {
  289. result[i] = wireEntityStructs[i].ID;
  290. }
  291. return result;
  292. }
  293. public EGID[] WiredToOutput(EGID block, byte port)
  294. {
  295. WireEntityStruct[] wireEntityStructs = Search(NamedExclusiveGroup<BuildModeWiresGroups.WiresGroup>.Group,
  296. (WireEntityStruct wes) => wes.sourcePortUsage == port && wes.sourceBlockEGID == block);
  297. EGID[] result = new EGID[wireEntityStructs.Length];
  298. for (uint i = 0; i < wireEntityStructs.Length; i++)
  299. {
  300. result[i] = wireEntityStructs[i].ID;
  301. }
  302. return result;
  303. }
  304. private T[] Search<T>(ExclusiveGroup group, Func<T, bool> isMatch) where T : unmanaged, IEntityComponent
  305. {
  306. FasterList<T> results = new FasterList<T>();
  307. var (components, count) = entitiesDB.QueryEntities<T>(group);
  308. for (uint i = 0; i < count; i++)
  309. {
  310. if (isMatch(components[i]))
  311. {
  312. results.Add(components[i]);
  313. }
  314. }
  315. return results.ToArray();
  316. }
  317. private EntityCollection<ChannelDataStruct> GetSignalStruct(uint signalID, out uint index, bool input = true)
  318. {
  319. ExclusiveGroup group = input
  320. ? NamedExclusiveGroup<BuildModeWiresGroups.InputPortsGroup>.Group
  321. : NamedExclusiveGroup<BuildModeWiresGroups.OutputPortsGroup>.Group;
  322. if (entitiesDB.Exists<PortEntityStruct>(signalID, group))
  323. {
  324. index = entitiesDB.QueryEntity<PortEntityStruct>(signalID, group).firstChannelIndexCachedInSim;
  325. var channelData =
  326. entitiesDB.QueryEntities<ChannelDataStruct>(NamedExclusiveGroup<BuildModeWiresGroups.ChannelDataGroup>.Group);
  327. return channelData;
  328. }
  329. index = 0;
  330. return default; //count: 0
  331. }
  332. }
  333. }