/* Pins both hold data for circuits, as well move data between them. Some also cause circuits to do their function. DATA_CHANNEL pins are the data holding/moving kind, where as PULSE_CHANNEL causes circuits to work() when their pulse hits them. A visualization of how pins work is below. Imagine the below image involves an addition circuit. When the bottom pin, the activator, receives a pulse, all the numbers on the left (input) get added, and the answer goes on the right side (output). Inputs Outputs A [2]\ /[8] result B [1]-\|++|/ C [4]-/|++| D [1]/ || || Activator */ /datum/integrated_io var/name = "input/output" var/obj/item/integrated_circuit/holder = null var/weakref/data = null // This is a weakref, to reduce typecasts. Note that oftentimes numbers and text may also occupy this. var/list/linked = list() var/io_type = DATA_CHANNEL /datum/integrated_io/New(var/newloc, var/name, var/new_data) ..() src.name = name if(!isnull(new_data)) src.data = new_data holder = newloc if(!istype(holder)) message_admins("ERROR: An integrated_io ([src.name]) spawned without a valid holder! This is a bug.") /datum/integrated_io/Destroy() disconnect() data = null holder = null . = ..() /datum/integrated_io/tgui_host() return holder.tgui_host() /datum/integrated_io/proc/data_as_type(var/as_type) if(!isweakref(data)) return var/weakref/w = data var/output = w.resolve() return istype(output, as_type) ? output : null /datum/integrated_io/proc/display_data(var/input) if(isnull(input)) return "(null)" // Empty data means nothing to show. if(istext(input)) return "(\"[input]\")" // Wraps the 'string' in escaped quotes, so that people know it's a 'string'. /* list[]( "A", "B", "C" ) */ if(islist(input)) var/list/my_list = input var/result = "list\[[my_list.len]\](" if(my_list.len) result += "
" var/pos = 0 for(var/line in my_list) result += "[display_data(line)]" pos++ if(pos != my_list.len) result += ",
" result += "
" result += ")" return result if(isweakref(input)) var/weakref/w = input var/atom/A = w.resolve() //return A ? "([A.name] \[Ref\])" : "(null)" // For refs, we want just the name displayed. return A ? "(\ref[A] \[Ref\])" : "(null)" return "([input])" // Nothing special needed for numbers or other stuff. /datum/integrated_io/activate/display_data() return "(\[pulse\])" /datum/integrated_io/proc/display_pin_type() return IC_FORMAT_ANY /datum/integrated_io/activate/display_pin_type() return IC_FORMAT_PULSE /datum/integrated_io/proc/scramble() if(isnull(data)) return if(isnum(data)) write_data_to_pin(rand(-10000, 10000)) if(istext(data)) write_data_to_pin("ERROR") push_data() /datum/integrated_io/activate/scramble() push_data() /datum/integrated_io/proc/write_data_to_pin(var/new_data) if(isnull(new_data) || isnum(new_data) || istext(new_data) || isweakref(new_data)) // Anything else is a type we don't want. if(istext(new_data)) new_data = sanitizeSafe(new_data, MAX_MESSAGE_LEN, 0, 0) data = new_data holder.on_data_written() /datum/integrated_io/proc/push_data() for(var/datum/integrated_io/io in linked) io.write_data_to_pin(data) /datum/integrated_io/activate/push_data() for(var/datum/integrated_io/io in linked) io.holder.check_then_do_work() /datum/integrated_io/proc/pull_data() for(var/datum/integrated_io/io in linked) write_data_to_pin(io.data) /datum/integrated_io/proc/get_linked_to_desc() if(linked.len) return "the [english_list(linked)]" return "nothing" /datum/integrated_io/proc/disconnect() //First we iterate over everything we are linked to. for(var/datum/integrated_io/their_io in linked) //While doing that, we iterate them as well, and disconnect ourselves from them. for(var/datum/integrated_io/their_linked_io in their_io.linked) if(their_linked_io == src) their_io.linked.Remove(src) else continue //Now that we're removed from them, we gotta remove them from us. src.linked.Remove(their_io) /datum/integrated_io/proc/ask_for_data_type(mob/user, var/default, var/list/allowed_data_types = list("string","number","null")) var/type_to_use = tgui_input_list(usr, "Please choose a type to use.","[src] type setting", allowed_data_types) if(!holder.check_interactivity(user)) return var/new_data = null switch(type_to_use) if("string") new_data = input(usr, "Now type in a string.","[src] string writing", istext(default) ? default : null) as null|text if(istext(new_data) && holder.check_interactivity(user) ) to_chat(user, "You input [new_data] into the pin.") return new_data if("number") new_data = input(usr, "Now type in a number.","[src] number writing", isnum(default) ? default : null) as null|num if(isnum(new_data) && holder.check_interactivity(user) ) to_chat(user, "You input [new_data] into the pin.") return new_data if("null") if(holder.check_interactivity(user)) to_chat(user, "You clear the pin's memory.") return new_data // Basically a null check /datum/integrated_io/proc/is_valid() return !isnull(data) // This proc asks for the data to write, then writes it. /datum/integrated_io/proc/ask_for_pin_data(mob/user, obj/item/I) var/new_data = ask_for_data_type(user) write_data_to_pin(new_data) /datum/integrated_io/activate/ask_for_pin_data(mob/user) // This just pulses the pin. holder.check_then_do_work(ignore_power = TRUE) to_chat(user, "You pulse \the [holder]'s [src] pin.") /datum/integrated_io/activate name = "activation pin" io_type = PULSE_CHANNEL /datum/integrated_io/activate/out // All this does is just make the UI say 'out' instead of 'in' data = 1