camerachunk

A 16x16 grid of the map with a list of turfs that can be seen, are visible and are dimmed.
Allows Camera Eyes to stream these chunks and know what it can and cannot see.

Vars
active_static_images	images currently in use on obscured turfs.
cameras	cameras that can see into our grid indexed by the string z level of the camera this could one day be an alist but vv doesn't work with it yet
currently_updating	Are we currently being updated by the cameras subsystem?
obscuredTurfs	turfs our cameras cant see but are inside our grid. associative list of the form: list(obscured turf = static image on that turf)
processing_cameras	List of cameras that need to be processed. For use in yielding when being lazyupdated by the cameras subsystem
processing_visible_turfs	List of newly visible turfs that are currently being generated. For use in lazyupdating.
seenby	Camera mobs that can see turfs in our grid
turfs	list of all turfs, associative with that turf's static image turf -> /image
update_sources	List of atoms that caused the chunk to update - assoc atom ref() to opacity on queue
visibleTurfs	turfs our cameras can see inside our grid
Procs
New	Create a new camera chunk, since the chunks are made as they are needed.
add	Add a camera eye to the chunk, updating the chunk if necessary.
force_update	Forces the chunk to update immediately
queue_update	Queues the chuck to be updated after a delay.
remove	Remove a camera eye from the chunk
reset_update	Reset any in progress update
update	Perfroms a full update of the chunk
update_with_turfs	Takes a list of newly visible turfs, updates our static images to match
yield_update	Updates our chunk in a lazy fashion, so large amounts of cameras don't lead to overtime spikes Returns FALSE if the update is unfinished, TRUE if it's complete

Var Details

var
active_static_images
– /list

images currently in use on obscured turfs.

var
cameras
– /list/list

cameras that can see into our grid indexed by the string z level of the camera this could one day be an alist but vv doesn't work with it yet

var
currently_updating

Are we currently being updated by the cameras subsystem?

var
obscuredTurfs
– /list

turfs our cameras cant see but are inside our grid. associative list of the form: list(obscured turf = static image on that turf)

var
processing_cameras
– /list/list

List of cameras that need to be processed. For use in yielding when being lazyupdated by the cameras subsystem

var
processing_visible_turfs
– /list

List of newly visible turfs that are currently being generated. For use in lazyupdating.

var
seenby
– /list

Camera mobs that can see turfs in our grid

var
turfs
– /list

list of all turfs, associative with that turf's static image turf -> /image

var
update_sources
– /list

List of atoms that caused the chunk to update - assoc atom ref() to opacity on queue

var
visibleTurfs
– /list

turfs our cameras can see inside our grid

Proc Details

New
(x, y, lower_z)

Create a new camera chunk, since the chunks are made as they are needed.

proc
add
(/mob/eye/camera/eye)

Add a camera eye to the chunk, updating the chunk if necessary.

proc
force_update
(only_if_necessary)

Forces the chunk to update immediately

only_if_necessary - if TRUE, will not update the chunk unless it's been marked to update.

proc
queue_update
(/atom/update_source, update_delay_buffer)

Queues the chuck to be updated after a delay.

update_source - the atom that caused the update
update_delay_buffer - the delay before the update is performed. Defaults to 0 (instant).

proc
remove
(/mob/eye/camera/ai/eye)

Remove a camera eye from the chunk

proc
reset_update
()

Reset any in progress update

proc
update
()

Perfroms a full update of the chunk

proc
update_with_turfs
(/list/updated_visible_turfs)

Takes a list of newly visible turfs, updates our static images to match

proc
yield_update
()

Updates our chunk in a lazy fashion, so large amounts of cameras don't lead to overtime spikes Returns FALSE if the update is unfinished, TRUE if it's complete

camerachunk /datum/camerachunk

Vars

Procs

Var Details

var active_static_images – /list

var cameras – /list/list

var currently_updating

var obscuredTurfs – /list

var processing_cameras – /list/list

var processing_visible_turfs – /list

var seenby – /list

var turfs – /list

var update_sources – /list

var visibleTurfs – /list