minimaps

Vars
drawn_images	assoc list of hash = image of images drawn by players
earlyadds	list of callbacks we need to invoke late because Initialize happens early, or a Z-level was loaded after init
hashed_minimaps	assoc list of minimap objects that are hashed so we have to update as few as possible
images_by_source	Assoc list of images we hold by their source
minimaps_by_z	Minimap hud display datums sorted by zlevel
removal_cbs	Assoc list of removal callbacks to invoke to remove images from the raw lists
update_targets	the update target datums, sorted by update flag type
update_targets_unsorted	Nonassoc list of updators we want to have their overlays reapplied
updators_by_datum	list of holders for data relating to tracked zlevel and tracked atum
Procs
add_marker	Adds an atom we want to track with blips to the subsystem Arguments:
add_to_updaters	Adds an atom to the processing updators that will have blips drawn on them Arguments:
fetch_minimap_object	Fetches a /atom/movable/screen/minimap instance or creates on if none exists Note this does not destroy them when the map is unused, might be a potential thing to do? Arguments:
get_drawing_image	fetches the drawing icon for a minimap flag and returns it, creating it if needed. assumes minimap_flag is ONE flag
load_new_z	Creates a minimap for a particular z level
on_z_change	Called on zlevel change of a blip-atom so we can update the image lists as needed
remove_earlyadd	Removes the object from the earlyadds list, in case it was qdel'd before the z-level was fully loaded
remove_marker	Removes an atom and it's blip from the subsystem
remove_updator	Removes a atom from the subsystems updating overlays
removeimage	removes an image from raw tracked lists, invoked by callback

Var Details

var
drawn_images
– /list/image

assoc list of hash = image of images drawn by players

var
earlyadds
– /list/list/datum/callback

list of callbacks we need to invoke late because Initialize happens early, or a Z-level was loaded after init

var
hashed_minimaps
– /list

assoc list of minimap objects that are hashed so we have to update as few as possible

var
images_by_source
– /list/image

Assoc list of images we hold by their source

var
minimaps_by_z
– /list/datum/hud_displays

Minimap hud display datums sorted by zlevel

var
removal_cbs
– /list/datum/callback

Assoc list of removal callbacks to invoke to remove images from the raw lists

var
update_targets
– /list

the update target datums, sorted by update flag type

var
update_targets_unsorted
– /list/datum/minimap_updator

Nonassoc list of updators we want to have their overlays reapplied

var
updators_by_datum
– /list/datum/minimap_updator

list of holders for data relating to tracked zlevel and tracked atum

Proc Details

proc
add_marker
(/atom/target, hud_flags, /image/blip)

Adds an atom we want to track with blips to the subsystem Arguments:

target: atom we want to track
hud_flags: tracked HUDs we want this atom to be displayed on
marker: image or mutable_appearance we want to be using on the map

proc
add_to_updaters
(/atom/target, flags, ztarget)

Adds an atom to the processing updators that will have blips drawn on them Arguments:

target: the target we want to be updating the overlays on
flags: flags for the types of blips we want to be updated
ztarget: zlevel we want to be updated with

proc
fetch_minimap_object
(zlevel, flags)

Fetches a /atom/movable/screen/minimap instance or creates on if none exists Note this does not destroy them when the map is unused, might be a potential thing to do? Arguments:

zlevel: zlevel to fetch map for
flags: map flags to fetch from

proc
get_drawing_image
(zlevel, minimap_flag)

fetches the drawing icon for a minimap flag and returns it, creating it if needed. assumes minimap_flag is ONE flag

proc
load_new_z
(/datum/dcs, /datum/space_level/z_level)

Creates a minimap for a particular z level

proc
on_z_change
(/atom/movable/source, oldz, newz)

Called on zlevel change of a blip-atom so we can update the image lists as needed

TODO gross amount of assoc usage and unneeded ALL FLAGS iteration

proc
remove_earlyadd
(/atom/source)

Removes the object from the earlyadds list, in case it was qdel'd before the z-level was fully loaded

proc
remove_marker
(/atom/source)

Removes an atom and it's blip from the subsystem

proc
remove_updator
(/atom/target)

Removes a atom from the subsystems updating overlays

proc
removeimage
(/image/blip, /atom/target, hud_flags)

removes an image from raw tracked lists, invoked by callback

minimaps /datum/controller/subsystem/minimaps

Vars

Procs

Var Details

var drawn_images – /list/image

var earlyadds – /list/list/datum/callback

var hashed_minimaps – /list

var images_by_source – /list/image

var minimaps_by_z – /list/datum/hud_displays

var removal_cbs – /list/datum/callback

var update_targets – /list

var update_targets_unsorted – /list/datum/minimap_updator

var updators_by_datum – /list/datum/minimap_updator

Proc Details

proc add_marker(/atom/target, hud_flags, /image/blip)

proc add_to_updaters(/atom/target, flags, ztarget)

proc fetch_minimap_object(zlevel, flags)

proc get_drawing_image(zlevel, minimap_flag)

proc load_new_z(/datum/dcs, /datum/space_level/z_level)

proc on_z_change(/atom/movable/source, oldz, newz)

proc remove_earlyadd(/atom/source)

proc remove_marker(/atom/source)

proc remove_updator(/atom/target)

proc removeimage(/image/blip, /atom/target, hud_flags)