Commit: 67da0ba0a43ac706defce9e9807bee77ad694ec5 - fma (git)

First Machine Age's Mods (Combined repo.)

Commit MetaInfo

• Revision: 67da0ba0a43ac706defce9e9807bee77ad694ec5 (tree)
• Zeit: 2020-02-16 08:21:55
• Autor: melchior <melchior@user...>
• Commiter: melchior

Log Message

Concept for LogicNetwork standard interface

Ändern Zusammenfassung

• modified: FirstMachineAge_Common/Common.csproj
• add: FirstMachineAge_Common/ILogicNetNode.cs

Diff

--- a/FirstMachineAge_Common/Common.csproj
+++ b/FirstMachineAge_Common/Common.csproj
@@ -44,6 +44,7 @@
   <ItemGroup>
     <Compile Include="Helpers.cs" />
     <Compile Include="Properties\AssemblyInfo.cs" />
+    <Compile Include="ILogicNetNode.cs" />
   </ItemGroup>
   <ItemGroup>
     <Folder Include="vs_libs\" />

--- /dev/null
+++ b/FirstMachineAge_Common/ILogicNetNode.cs
@@ -0,0 +1,98 @@
+using System;
+using System.Collections.Generic;
+
+using Vintagestory.API.Common;
+using Vintagestory.API.MathTools;
+
+namespace FirstMachineAge
+{
+
+
+	/*
+	 Domain (LogicDomain) <- Circuits (LogicNetwork) <- Subcircuit <LogicNetworkSubcircuit) <- BlockFace; <EndpointDescriptor>
+	 */
+	//basic single ended, digital logic for this ... complex multi-bus / analog is a different interface
+	public interface ILogicNetNode<T> where T: Block //Blocks only, since these are meant to be placable in-world
+	{
+		ICollection<LogicDomain> DOMAINs { get; } //Rod-logic, Tension-Cable & Pulley, Electrical, Pnumatic, Hydraulic, Redstone?, more than 1 == some kinda adaptor
+
+		LogicNetwork Circuit { get; } //Per domain (AKA Network ID), encloses several 'sub' circuits (possibly monotonic), all connected (at least 1 io). Zero - considered unassigned or invalid
+
+		IDictionary<BlockFacing, LogicNetworkSubcircuit> SubCircuits { get; } //A CONNECTED 'Sub' Circuit; MUST be unique for each sub-circuit; an IO going somewhere, doing SOMETHING...
+
+		IDictionary<BlockFacing, bool> VALUEs { get; set;} //Boolean STATE - per face, may/should trigger "events" on changes forced or 'natural'
+
+		IDictionary<BlockFacing, EndpointDescriptor> AvailableConnections { get; } //Pins, sockets, connections; Inputs - Outputs, Both? Which faces?? Default Pullups/down???
+
+
+
+		bool TryGetNetwork(IWorldAccessor world, BlockPos anywhere, out LogicNetwork linkedNet);
+
+		bool HasInterface(BlockPos anywhere, BlockFacing face);
+
+		EndpointDescriptor GetInterface(BlockPos anywhere, BlockFacing face);
+
+		bool CanLink(Block otherNetBlock, BlockFacing forFace);
+
+		bool CanLink(Block otherNetBlock, EndpointDescriptor byInterface);//for a GUI to see what could connect if anything
+
+
+		LogicNetworkSubcircuit MakeConnection(BlockPos atLocation, BlockFacing forFace);//point blank connections allowed ~ depending
+
+		void BreakConnection( LogicNetworkSubcircuit cutLink);
+
+		void BreakConnection(BlockFacing cutLinkBySide);
+
+	}
+
+	public abstract class LogicDomain
+	{
+		readonly static string NAME;//TTL, CMOS, Rod-Logic, Cable-Link, Pnumatic, ect...
+		//Global ID tag?
+		//Other information about domain features
+
+	}
+
+	public abstract class LogicNetwork
+	{
+		LogicDomain ParentDomain { get; }
+		ulong NetworkID { get; }//Monotonic - reuse ID# only at own peril.
+		IList<LogicNetworkSubcircuit> ConnectedSubCircuits { get; }
+
+	}
+
+	public abstract class LogicNetworkSubcircuit
+	{
+		uint SubCircuitID { get; }
+		IList<LogicNetworkSubcircuit> AtttachedNodes { get; }
+		LogicNetwork ParentCircuit { get; }
+	}
+
+	//As it might change 'dyamically' or be editable...
+	public abstract class EndpointDescriptor
+	{
+		sbyte Number { get; }
+		readonly string Description;
+		BlockFacing ForFace { get; }
+		LogicIO EndKind { get; }
+		DefaultState Normally { get; }
+	}
+
+	public enum LogicIO
+	{
+		Input,
+		Output,
+		Both,//Just don't connect to same Sub-Circuit!
+	}
+
+	//Pullups/downs, floatin' or random?
+	public enum DefaultState
+	{
+		High,
+		Low,
+		Undefined//! - Mabey Random, or can't be determined before execution
+	}
+
+
+}
+