atom

Any floor or wall. What makes up the station and the rest of the map.

Vars
always_lit	Bool, whether this turf will always be illuminated no matter what area it is in
archived_cycle	used to determine whether we should archive
atmos_adjacent_turfs	list of turfs adjacent to us that air can flow onto
atmos_supeconductivity	bitfield of dirs in which we are superconducitng
directional_opacity	Which directions does this turf block the vision of, taking into account both the turf's opacity and the movable opacity_sources.
dynamic_lumcount	Lumcount added by sources other than lighting datum objects, such as the overlay lighting component.
fixed_underlay	Icon-smoothing variable to map a diagonal wall corner with a fixed underlay.
heat_capacity	Amount of heat necessary to activate some atmos processes (there is a weird usage of this var because is compared directly to the temperature instead of heat energy)
holodeck_compatible	the holodeck can load onto this turf if TRUE
initial_gas_mix	used for mapping and for breathing while in walls (because that's a thing that needs to be accounted for...) string parsed by /datum/gas/proc/copy_from_turf approximation of MOLES_O2STANDARD and MOLES_N2STANDARD pending byond allowing constant expressions to be embedded in constant strings If someone will place 0 of some gas there, SHIT WILL BREAK. Do not do that.
lighting_corner_NE	Lighting Corner datums.
lighting_object	Our lighting object.
opacity_sources	Lazylist of movable atoms providing opacity sources.
overfloor_placed	If there's a tile over a basic floor that can be ripped out
rcd_memory	If this turf contained an RCD'able object (or IS one, for walls) but is now destroyed, this will preserve the value. See _DEFINES/construction.dm for RCD_MEMORY*.
temperature_archived	Archived version of the temperature on a turf
thermal_conductivity	used for temperature calculations in superconduction
turf_flags	Turf bitflags, see code/__DEFINES/flags.dm
underfloor_accessibility	How accessible underfloor pieces such as wires, pipes, etc are on this turf. Can be HIDDEN, VISIBLE, or INTERACTABLE.
Procs
Initialize	Turf Initialize
LinkBlockedWithAccess	For seeing if we can actually move between 2 given turfs while accounting for our access and the caller's pass_flags
ScrapeAway	Take off the top layer turf and replace it with the next baseturf down
add_opacity_source	Proc to add movable sources of opacity on the turf and let it handle lighting code.
air_update_turf	A helper proc for dealing with atmos changes
clear_signal_refs	WARNING WARNING Turfs DO NOT lose their signals when they get replaced, REMEMBER THIS It's possible because turfs are fucked, and if you have one in a list and it's replaced with another one, the list ref points to the new turf We do it because moving signals over was needlessly expensive, and bloated a very commonly used bit of code
conductivity_directions	SUPERCONDUCTIVITY ALLLLLLLLLLLLLLLLLLLLRIGHT HERE WE GOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO
consider_superconductivity	Should we attempt to superconduct?
expose_reagents	Handles exposing a turf to reagents.
fromShuttleMove	Base procs
get_atmos_adjacent_turfs	returns a list of adjacent turfs that can share air with this one. alldir includes adjacent diagonal tiles that can share air with both of the related adjacent cardinal tiles
is_blocked_turf	Check whether the specified turf is blocked by something dense inside it with respect to a specific atom.
is_blocked_turf_ignore_climbable	Checks whether the specified turf is blocked by something dense inside it, but ignores anything with the climbable trait
is_nearby_planetary_atmos	Runs through all adjacent open turfs and checks if any are planetary_atmos returns true if even one passes.
neighbor_conduct_with_src	These two procs are a bit of a web, I belive in you
reachableAdjacentTurfs	Returns adjacent turfs to this turf that are reachable, in all cardinal directions
recalculate_directional_opacity	Calculate on which directions this turfs block view.
remove_opacity_source	Proc to remove movable sources of opacity on the turf and let it handle lighting code.
return_turf_delta_p	Finds the greatest difference in pressure across a turf, only considers open turfs.
wash	Called when this turf is being washed. Washing a turf will also wash any mopable floor decals

Var Details

var
always_lit
–

Bool, whether this turf will always be illuminated no matter what area it is in

var
archived_cycle
–

used to determine whether we should archive

var
atmos_adjacent_turfs
– /list

list of turfs adjacent to us that air can flow onto

var
atmos_supeconductivity
–

bitfield of dirs in which we are superconducitng

var
directional_opacity
–

Which directions does this turf block the vision of, taking into account both the turf's opacity and the movable opacity_sources.

var
dynamic_lumcount
–

Lumcount added by sources other than lighting datum objects, such as the overlay lighting component.

var
fixed_underlay
– /list

Icon-smoothing variable to map a diagonal wall corner with a fixed underlay.

var
heat_capacity
–

Amount of heat necessary to activate some atmos processes (there is a weird usage of this var because is compared directly to the temperature instead of heat energy)

var
holodeck_compatible
–

the holodeck can load onto this turf if TRUE

var
initial_gas_mix
–

used for mapping and for breathing while in walls (because that's a thing that needs to be accounted for...) string parsed by /datum/gas/proc/copy_from_turf approximation of MOLES_O2STANDARD and MOLES_N2STANDARD pending byond allowing constant expressions to be embedded in constant strings If someone will place 0 of some gas there, SHIT WILL BREAK. Do not do that.

var
lighting_corner_NE
– /tmp/datum/lighting_corner

Lighting Corner datums.

var
lighting_object
– /tmp/datum/lighting_object

Our lighting object.

var
opacity_sources
– /list/atom/movable

Lazylist of movable atoms providing opacity sources.

var
overfloor_placed
–

If there's a tile over a basic floor that can be ripped out

var
rcd_memory
–

If this turf contained an RCD'able object (or IS one, for walls) but is now destroyed, this will preserve the value. See _DEFINES/construction.dm for RCD_MEMORY*.

var
temperature_archived
–

Archived version of the temperature on a turf

var
thermal_conductivity
–

used for temperature calculations in superconduction

var
turf_flags
–

Turf bitflags, see code/__DEFINES/flags.dm

var
underfloor_accessibility
–

How accessible underfloor pieces such as wires, pipes, etc are on this turf. Can be HIDDEN, VISIBLE, or INTERACTABLE.

Proc Details

↑
Initialize
(mapload)

Turf Initialize

Doesn't call parent, see /atom/proc/Initialize Please note, space tiles do not run this code. This is done because it's called so often that any extra code just slows things down too much If you add something relevant here add it there too /turf/open/space/Initialize

proc
LinkBlockedWithAccess
(/turf/destination_turf, caller, ID)

For seeing if we can actually move between 2 given turfs while accounting for our access and the caller's pass_flags

Arguments:

caller: The movable, if one exists, being used for mobility checks to see what tiles it can reach
ID: An ID card that decides if we can gain access to doors that would otherwise block a turf
simulated_only: Do we only worry about turfs with simulated atmos, most notably things that aren't space?

proc
ScrapeAway
(amount, flags)

Take off the top layer turf and replace it with the next baseturf down

proc
add_opacity_source
(/atom/movable/new_source)

Proc to add movable sources of opacity on the turf and let it handle lighting code.

air_update_turf
(update, remove)

A helper proc for dealing with atmos changes

Ok so this thing is pretty much used as a catch all for all the situations someone might wanna change something About a turfs atmos. It's real clunky, and someone needs to clean it up, but not today. Arguments:

update - Has the state of the structures in the world changed? If so, update our adjacent atmos turf list, if not, don't.
remove - Are you removing an active turf (Read wall), or adding one

↑
clear_signal_refs
()

WARNING WARNING Turfs DO NOT lose their signals when they get replaced, REMEMBER THIS It's possible because turfs are fucked, and if you have one in a list and it's replaced with another one, the list ref points to the new turf We do it because moving signals over was needlessly expensive, and bloated a very commonly used bit of code

proc
conductivity_directions
()

SUPERCONDUCTIVITY ALLLLLLLLLLLLLLLLLLLLRIGHT HERE WE GOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOOO

Read the code for more details, but first, a brief concept discussion/area

Our goal here is to "model" heat moving through solid objects, so walls, windows, and sometimes doors. We do this by heating up the floor itself with the heat of the gasmix ontop of it, this is what the coeffs are for here, they slow that movement Then we go through the process below.

If an active turf is fitting, we add it to processing, conduct with any covered tiles, (read windows and sometimes walls) Then we space some of our heat, and think about if we should stop conducting.

proc
consider_superconductivity
(starting)

Should we attempt to superconduct?

↑
expose_reagents
(/list/reagents, /datum/reagents/source, methods, volume_modifier, show_message)

Handles exposing a turf to reagents.

proc
fromShuttleMove
(/turf/newT, move_mode)

Base procs

proc
get_atmos_adjacent_turfs
(alldir)

returns a list of adjacent turfs that can share air with this one. alldir includes adjacent diagonal tiles that can share air with both of the related adjacent cardinal tiles

proc
is_blocked_turf
(exclude_mobs, source_atom, /list/ignore_atoms)

Check whether the specified turf is blocked by something dense inside it with respect to a specific atom.

Returns truthy value TURF_BLOCKED_TURF_DENSE if the turf is blocked because the turf itself is dense. Returns truthy value TURF_BLOCKED_CONTENT_DENSE if one of the turf's contents is dense and would block a source atom's movement. Returns falsey value TURF_NOT_BLOCKED if the turf is not blocked.

Arguments:

exclude_mobs - If TRUE, ignores dense mobs on the turf.
source_atom - If this is not null, will check whether any contents on the turf can block this atom specifically. Also ignores itself on the turf.
ignore_atoms - Check will ignore any atoms in this list. Useful to prevent an atom from blocking itself on the turf.

proc
is_blocked_turf_ignore_climbable
()

Checks whether the specified turf is blocked by something dense inside it, but ignores anything with the climbable trait

Works similar to is_blocked_turf(), but ignores climbables and has less options. Primarily added for jaunting checks

proc
is_nearby_planetary_atmos
()

Runs through all adjacent open turfs and checks if any are planetary_atmos returns true if even one passes.

proc
neighbor_conduct_with_src
(/turf/open/other)

These two procs are a bit of a web, I belive in you

proc
reachableAdjacentTurfs
(caller, ID, simulated_only)

Returns adjacent turfs to this turf that are reachable, in all cardinal directions

Arguments:

caller: The movable, if one exists, being used for mobility checks to see what tiles it can reach
ID: An ID card that decides if we can gain access to doors that would otherwise block a turf
simulated_only: Do we only worry about turfs with simulated atmos, most notably things that aren't space?

proc
recalculate_directional_opacity
()

Calculate on which directions this turfs block view.

proc
remove_opacity_source
(/atom/movable/old_source)

Proc to remove movable sources of opacity on the turf and let it handle lighting code.

proc
return_turf_delta_p
()

Finds the greatest difference in pressure across a turf, only considers open turfs.

↑
wash
(clean_types)

Called when this turf is being washed. Washing a turf will also wash any mopable floor decals

turf /turf inherits /atom

Vars

Procs

Var Details

var always_lit –

var archived_cycle –

var atmos_adjacent_turfs – /list

var atmos_supeconductivity –

var directional_opacity –

var dynamic_lumcount –

var fixed_underlay – /list

var heat_capacity –

var holodeck_compatible –

var initial_gas_mix –

var lighting_corner_NE – /tmp/datum/lighting_corner

var lighting_object – /tmp/datum/lighting_object

var opacity_sources – /list/atom/movable

var overfloor_placed –

var rcd_memory –

var temperature_archived –

var thermal_conductivity –

var turf_flags –

var underfloor_accessibility –

Proc Details

↑Initialize(mapload)

proc LinkBlockedWithAccess(/turf/destination_turf, caller, ID)

proc ScrapeAway(amount, flags)

proc add_opacity_source(/atom/movable/new_source)

air_update_turf(update, remove)

↑clear_signal_refs()

proc conductivity_directions()

proc consider_superconductivity(starting)

↑expose_reagents(/list/reagents, /datum/reagents/source, methods, volume_modifier, show_message)

proc fromShuttleMove(/turf/newT, move_mode)

proc get_atmos_adjacent_turfs(alldir)

proc is_blocked_turf(exclude_mobs, source_atom, /list/ignore_atoms)

proc is_blocked_turf_ignore_climbable()

proc is_nearby_planetary_atmos()

proc neighbor_conduct_with_src(/turf/open/other)

proc reachableAdjacentTurfs(caller, ID, simulated_only)

proc recalculate_directional_opacity()

proc remove_opacity_source(/atom/movable/old_source)

proc return_turf_delta_p()

↑wash(clean_types)

turf
/turf
inherits /atom

var
always_lit
–

var
archived_cycle
–

var
atmos_adjacent_turfs
– /list

var
atmos_supeconductivity
–

var
directional_opacity
–

var
dynamic_lumcount
–

var
fixed_underlay
– /list

var
heat_capacity
–

var
holodeck_compatible
–

var
initial_gas_mix
–

var
lighting_corner_NE
– /tmp/datum/lighting_corner

var
lighting_object
– /tmp/datum/lighting_object

var
opacity_sources
– /list/atom/movable

var
overfloor_placed
–

var
rcd_memory
–

var
temperature_archived
–

var
thermal_conductivity
–

var
turf_flags
–

var
underfloor_accessibility
–

↑
Initialize
(mapload)

proc
LinkBlockedWithAccess
(/turf/destination_turf, caller, ID)

proc
ScrapeAway
(amount, flags)

proc
add_opacity_source
(/atom/movable/new_source)

air_update_turf
(update, remove)

↑
clear_signal_refs
()

proc
conductivity_directions
()

proc
consider_superconductivity
(starting)

↑
expose_reagents
(/list/reagents, /datum/reagents/source, methods, volume_modifier, show_message)

proc
fromShuttleMove
(/turf/newT, move_mode)

proc
get_atmos_adjacent_turfs
(alldir)

proc
is_blocked_turf
(exclude_mobs, source_atom, /list/ignore_atoms)

proc
is_blocked_turf_ignore_climbable
()

proc
is_nearby_planetary_atmos
()

proc
neighbor_conduct_with_src
(/turf/open/other)

proc
reachableAdjacentTurfs
(caller, ID, simulated_only)

proc
recalculate_directional_opacity
()

proc
remove_opacity_source
(/atom/movable/old_source)

proc
return_turf_delta_p
()

↑
wash
(clean_types)