eye
/mob/camera/eye

Camera eyes are remote-control mobs that can move and see throughout the global cameranet. They're used in AI eyes, holograms, advanced camera consoles, abductor consoles, shuttle consoles, and xenobiology consoles. When created, the user with which they are initialized will be granted control, and their movements will be relayed to the camera eye instead. When destroyed, the user's control of the camera eye will be released; if they were previously remote controlling another object (such as another camera eye) then they will be put back in control of that object; otherwise they will return to their body.

Vars
acceleration	Toggles camera acceleration on or off.
acceleration_rate	The amount that sprint is increased per move
ai_detector_visible	Toggles whether this eye is detectable by AI Detectors.
cooldown	The absolute time that sprint will reset to its initial value
cooldown_rate	The time after which sprint should be reset to its initial state, if no movements are made
max_sprint	The maximum sprint value - this caps acceleration
networks	The list of cameranets that this camera eye can see and access.
origin	The object that created the eye.
relay_speech	If true, speech near the camera eye will be relayed to its controller.
sprint	Keeps track of acceleration - movement rate is 1 + round(sprint / sprint_threshold)
sprint_threshold	The minimum sprint needed to increase base velocity
static_visibility_range	Sets the camera eye visibility range; does not expand viewport, only affects cameranet obscuring
user	The user controlling the eye.
user_image	The in-memory image of the camera eye's icon.
user_previous_remote_control	The thing that the user was previously remote controlling before this eye.
visible_camera_chunks	The list of camera chunks currently visible to the camera eye.
visible_icon	Toggles whether the eye's icon should be visible to its user.
Procs
Move	Disables independent movement by camera eyes; camera eyes must be controlled by relaymove.
first_active_camera	Returns the turf of the first active camera in the global cameranet.
get_viewer_client	Returns the user's client, if it exists; otherwise returns null.
give_control	Forces this eye's current user to release control, renames this eye, and grants `new_user` control of this eye.
hear_say	If `relay_speech` is truthy, allows the camera eye's user to hear speech spoken at the eye's location.
refresh_visible_icon	Refreshes user_image in the user's client.images.
relaymove	Called when the user controlling this eye attempts to move; uses camera acceleration settings.
release_chunks	Remove this eye from all chunks containing it.
release_control	Calls `remove_images`, changes the user's remote control from this camera eye to `user_previous_remote_control`.
remove_images	Removes obscured chunk images and user_images from the user's client.images.
rename_camera	Renames the camera eye (only visible in observer Orbit menu)
set_loc	Sets the camera eye's location to T, updates global cameranet visibility, and refreshes user_images.
update_visibility	Updates what the global cameranet can see with respect to this eye and its user's client.
validate_active_cameranet	Validates that there is an active cameranet. If strict is 0, does nothing. Returns 1 if there is an active cameranet. Warns the user and returns 0 if there is not.

Var Details

var
acceleration
–

Toggles camera acceleration on or off.

var
acceleration_rate
–

The amount that sprint is increased per move

var
ai_detector_visible
–

Toggles whether this eye is detectable by AI Detectors.

var
cooldown
–

The absolute time that sprint will reset to its initial value

var
cooldown_rate
–

The time after which sprint should be reset to its initial state, if no movements are made

var
max_sprint
–

The maximum sprint value - this caps acceleration

var
networks
– /list

The list of cameranets that this camera eye can see and access.

var
origin
–

The object that created the eye.

var
relay_speech
–

If true, speech near the camera eye will be relayed to its controller.

var
sprint
–

Keeps track of acceleration - movement rate is 1 + round(sprint / sprint_threshold)

var
sprint_threshold
–

The minimum sprint needed to increase base velocity

var
static_visibility_range
–

Sets the camera eye visibility range; does not expand viewport, only affects cameranet obscuring

var
user
– /mob/living

The user controlling the eye.

var
user_image
– /image

The in-memory image of the camera eye's icon.

var
user_previous_remote_control
–

The thing that the user was previously remote controlling before this eye.

var
visible_camera_chunks
– /list

The list of camera chunks currently visible to the camera eye.

var
visible_icon
–

Toggles whether the eye's icon should be visible to its user.

Proc Details

Move
()

Disables independent movement by camera eyes; camera eyes must be controlled by relaymove.

proc
first_active_camera
()

Returns the turf of the first active camera in the global cameranet.

proc
get_viewer_client
()

Returns the user's client, if it exists; otherwise returns null.

proc
give_control
(/mob/new_user)

Forces this eye's current user to release control, renames this eye, and grants new_user control of this eye.

hear_say
(/list/message_pieces, verb, italics, /mob/speaker, /sound/speech_sound, sound_vol, sound_frequency, use_voice)

If relay_speech is truthy, allows the camera eye's user to hear speech spoken at the eye's location.

proc
refresh_visible_icon
()

Refreshes user_image in the user's client.images.

relaymove
(/mob/user, direct)

Called when the user controlling this eye attempts to move; uses camera acceleration settings.

proc
release_chunks
()

Remove this eye from all chunks containing it.

proc
release_control
()

Calls remove_images, changes the user's remote control from this camera eye to user_previous_remote_control.

proc
remove_images
()

Removes obscured chunk images and user_images from the user's client.images.

proc
rename_camera
(new_name)

Renames the camera eye (only visible in observer Orbit menu)

↑
set_loc
(T)

Sets the camera eye's location to T, updates global cameranet visibility, and refreshes user_images.

proc
update_visibility
()

Updates what the global cameranet can see with respect to this eye and its user's client.

proc
validate_active_cameranet
(strict)

Validates that there is an active cameranet. If strict is 0, does nothing. Returns 1 if there is an active cameranet. Warns the user and returns 0 if there is not.

eye /mob/camera/eye

Vars

Procs

Var Details

var acceleration –

var acceleration_rate –

var ai_detector_visible –

var cooldown –

var cooldown_rate –

var max_sprint –

var networks – /list

var origin –

var relay_speech –

var sprint –

var sprint_threshold –

var static_visibility_range –

var user – /mob/living

var user_image – /image

var user_previous_remote_control –

var visible_camera_chunks – /list

var visible_icon –