Files
Batrachophreno c2f054fd81 DMdocs (#21103)
Progress on DMDocs. PRing progress so far so there's not one mega PR
later with 1500 affected files.

I want my goddamn highlight text on what all these goddamn procs goddamn
do goddamnit. >:(

No actual code change anywhere in this PR, only comments.

---------

Signed-off-by: Batrachophreno <Batrochophreno@gmail.com>
2025-08-09 12:22:56 +00:00

159 lines
4.8 KiB
Plaintext

SUBSYSTEM_DEF(radiation)
name = "Radiation"
wait = 2 SECONDS
priority = SS_PRIORITY_RADIATION
flags = SS_NO_INIT
/// All radiation source datums.
var/list/sources = list()
/// Sources indexed by turf for de-duplication.
var/list/sources_assoc = list()
/// Cache of turf's radiation resistance.
var/list/resistance_cache = list()
var/list/current_sources = list()
var/list/current_res_cache = list()
var/list/listeners = list()
/datum/controller/subsystem/radiation/fire(resumed = FALSE)
if (!resumed)
current_sources = sources.Copy()
current_res_cache = resistance_cache.Copy()
listeners = GLOB.living_mob_list.Copy()
while(length(current_sources))
var/datum/radiation_source/S = current_sources[length(current_sources)]
LIST_DEC(current_sources)
if(QDELETED(S))
sources -= S
else if(S.decay)
S.update_rad_power(S.rad_power - RADIATION_DECAY_RATE)
if (MC_TICK_CHECK)
return
while(length(current_res_cache))
var/turf/T = current_res_cache[length(current_res_cache)]
LIST_DEC(current_res_cache)
if(QDELETED(T))
resistance_cache -= T
else if((length(T.contents) + 1) != resistance_cache[T])
resistance_cache -= T // If its stale REMOVE it! It will get added if its needed.
if (MC_TICK_CHECK)
return
if(!length(sources))
listeners.Cut()
while(length(listeners))
var/atom/A = listeners[length(listeners)]
LIST_DEC(listeners)
if(!QDELETED(A))
var/atom/location = A.loc
var/rads = 0
if(istype(location))
rads = location.get_rads()
if(rads)
A.rad_act(rads)
if (MC_TICK_CHECK)
return
/**
* Ray trace from all active radiation sources to T and return the strongest effect.
*/
/datum/controller/subsystem/radiation/proc/get_rads_at_turf(turf/T)
. = 0
if(!istype(T))
return
for(var/value in sources)
var/datum/radiation_source/source = value
if(source.rad_power < .)
continue // Already being affected by a stronger source
if(source.source_turf.z != T.z)
continue // Radiation is not multi-z
if(source.respect_rad_shielding)
var/area/A = T.loc
if(A.area_flags & AREA_FLAG_RAD_SHIELDED)
continue // In shielded area
var/dist = get_dist(source.source_turf, T)
if(dist > source.range)
continue // Too far to possibly affect
if(source.flat)
. = max(., source.rad_power)
continue // No need to ray trace for flat field
// Okay, now ray trace to find resistence!
var/turf/origin = source.source_turf
var/working = source.rad_power
// Ray tracing.
while(origin != T)
origin = get_step_towards(origin, T)
// Only get the resistance if we don't already know it.
if(!resistance_cache[origin])
origin.calc_rad_resistance()
if(origin.cached_rad_resistance)
working = round((working / (origin.cached_rad_resistance * RADIATION_RESISTANCE_MULTIPLIER)), 0.1)
// Already affected by a stronger source (or its zero...)
if((working <= .) || (working <= RADIATION_THRESHOLD_CUTOFF))
break
// Butchered version of the inverse square law. Works for this purpose.
. = max((working / (dist ** 2)), .)
if(. <= RADIATION_THRESHOLD_CUTOFF)
. = 0
/**
* Add a /datum/radiation_source instance to the repository. It will override any existing source on the same turf.
*/
/datum/controller/subsystem/radiation/proc/add_source(datum/radiation_source/S)
if(!isturf(S.source_turf))
return
var/datum/radiation_source/existing = sources_assoc[S.source_turf]
if(existing)
qdel(existing)
sources += S
sources_assoc[S.source_turf] = S
/**
* Creates a /datum/radiation_source that will decay over time.
*
* This source will send out regular radiation pulses that take walls and distance into account.
*/
/datum/controller/subsystem/radiation/proc/radiate(source, power)
if(!(source && power)) //Sanity checking
return
var/datum/radiation_source/S = new()
S.source_turf = get_turf(source)
S.update_rad_power(power)
add_source(S)
/**
* Creates a /datum/radiation_source that will decay over time.
*
* This source will send out regular radiation pulses that will deliver
* identical radiation doses to everyone in range, irrespective of barriers
* in the way or their distance from the source.
*/
/datum/controller/subsystem/radiation/proc/flat_radiate(source, power, range, respect_rad_shielding = FALSE)
if(!(source && power && range))
return
var/datum/radiation_source/S = new()
S.flat = TRUE
S.range = range
S.respect_rad_shielding = respect_rad_shielding
S.source_turf = get_turf(source)
S.update_rad_power(power)
add_source(S)
/**
* Irradiates a full Z-level. Hacky way of doing it, but not too expensive.
*/
/datum/controller/subsystem/radiation/proc/z_radiate(atom/source, power, respect_rad_shielding = FALSE)
if(!(power && source))
return
var/turf/epicentre = locate(round(world.maxx / 2), round(world.maxy / 2), source.z)
flat_radiate(epicentre, power, world.maxx, respect_rad_shielding)