Space Station 13 - Modules - TypesVar Details - Proc Details

datum

Vars

cached_refA cached version of our \ref The brunt of \ref costs are in creating entries in the string tree (a tree of immutable strings) This avoids doing that more then once per datum by ensuring ref strings always have a reference to them after they're first pulled
isprocessingUsed by SSprocessing
md5_unique_datum_idMD5'd version of the UID. Used for instances where we dont want to make clients aware of UIDs.
status_traitsStatus traits attached to this datum
tgui_shared_statesglobal

Procs

CanProcCallProc to check if a datum allows proc calls on it
DeleteComponentRemoves the component from the datum
DeleteComponentsTypeRemoves all components of a given type from the datum
GetComponentReturn any component assigned to this datum of the given type
GetComponentsGet all components of a given type that are attached to this datum
GetExactComponentReturn any component assigned to this datum of the exact given type
LoadComponentGet existing component of type, or create it and return a reference to it
MD5_UIDSafety wrapper for getting MD5 UIDs
RegisterSignalRegister to listen for a signal from the passed in target
RegisterSignalsRegisters multiple signals to the same proc.
TakeComponentTransfer this component to another parent
TransferComponentTransfer a single component from the source datum, to the target.
TransferComponentsTransfer all components to target
UIDGets or creates the UID of a datum
UnregisterSignalStop listening to a given signal from target
_AddComponentCreates an instance of new_type in the datum and attaches to it as parent
_AddElementFinds the singleton for the element type given and attaches it to src
_RemoveElementFinds the singleton for the element type given and detaches it from src You only need additional arguments beyond the type if you're using ELEMENT_BESPOKE
_SendSignalInternal proc to handle most all of the signaling procedure
declent_ruПроцедура выбора правильного падежа для любого предмета, если у него указан словарь «ru_names», примерно такой: RU_NAMES_LIST_INIT("jaws of life", "челюсти жизни", "челюстей жизни", "челюстям жизни", "челюсти жизни", "челюстями жизни", "челюстях жизни")
p_aFunctionally the \a macro, for the cases where you put a bicon between "some [bicon] pop corn"
p_areApplies "is" for singular genders, or "are" for plural ones (e.g. "he is here" Vs. "they are here").
p_doApplies "does" for singular genders, or "do" for plural ones (e.g. "she does stuff" Vs. "they do stuff").
p_esAdds an "es" to the end of a word as appropriate for a particular gender (e.g. "he screeches" and "they screech"). For verb conjugation.
p_haveApplies "has" for singular genders, or "have" for plural ones (e.g. "she has eaten" Vs. "they have eaten").
p_sUsed to add an "s" to the end of a word as appropriate for a particular gender (e.g. "she looks" and "they look"). For verb conjugation.
p_theirApplies one of "their", "its", "his", or "her" as appropriate. Set to TRUE to capitalise.
p_themApplies one of "them", "it", "him", or "her" as appropriate. Set to TRUE to capitalise.
p_themselvesApplies one of "themselves", "itself", "himself", or "herself" as appropriate. Set to TRUE to capitalise.
p_theyApplies one of "they", "it", "he", or "she" as appropriate. Set to TRUE to capitalise.
p_theyreApplies one of "they're", "it's", "he's", or "she's" as appropriate. Set to TRUE to capitalise.
p_theyveApplies one of "they've", "it's", "he's", or "she's" as appropriate. Set to TRUE to capitalise.
p_wereApplies "was" for singular genders, or "were" for plural ones (e.g. "it was huge" Vs. "they were huge").
ru_p_doПрименяет "делает" для единственного числа и "делают" для множественного ("она делает" / "они делают").
ru_p_haveПрименяет "имеет" для единственного числа и "имеют" для множественного ("она имеет" / "они имеют").
ru_p_theirsПрименяет одно из "них", "него", "него", или "нее" в зависимости от пола. Установите TRUE для заглавной буквы.
ru_p_themПрименяет одно из "их", "его", или "её" в зависимости от пола. Установите TRUE для заглавной буквы.
ru_p_themselvesПрименяет одно из "сами", "само", "сам", или "сама" в зависимости от пола. Установите TRUE для заглавной буквы.
ru_p_theyПрименяет одно из "они", "оно", "он", или "она" в зависимости от пола. Установите TRUE для заглавной буквы.
ru_p_wereПрименяет "было" для единственного числа и "были" для множественного ("оно было" / "они были").
signal_cancel_activate_selfUsed for signal registrars who wish to completely ignore all behavior in the attack chain from parent types. Should be used sparingly, as subtypes are meant to build on behavior from the parent type.
signal_cancel_attack_byUsed for signal registrars who wish to completely ignore all behavior in the attack chain from parent types calling attack_by. Should be used sparingly, as subtypes are meant to build on behavior from the parent type.
signal_qdel
string_assoc_listCaches associative lists with non-numeric stringify-able index keys and stringify-able values (text/typepath -> text/path/number).
ui_actpublic
ui_assetspublic
ui_closepublic
ui_datapublic
ui_hostprivate
ui_interactExternal tgui definitions, such as src_object APIs.
ui_modal_actCall this from a proc that is called in ui_act() to process modal actions
ui_modal_answerCalls the source's currently assigned modal's (if there is one) on_answer() proc. Private.
ui_modal_bentoOpens a bento input UI modal
ui_modal_booleanOpens a yes/no UI modal
ui_modal_choiceOpens a dropdown input UI modal
ui_modal_clearClears the current modal for a given datum
ui_modal_dataCall this from ui_data() to return modal information if needed
ui_modal_inputOpens a text input UI modal
ui_modal_messageOpens a message UI modal
ui_modal_newRegisters a given modal to a source. Private.
ui_modal_preprocess_answerPasses an answer from JS through the modal's proc.
ui_stateprivate
ui_static_datapublic
ui_statusBase state and helpers for states. Just does some sanity checks, implement a proper state for in-depth checks.
update_static_datapublic

Var Details

cached_ref

A cached version of our \ref The brunt of \ref costs are in creating entries in the string tree (a tree of immutable strings) This avoids doing that more then once per datum by ensuring ref strings always have a reference to them after they're first pulled

isprocessing

Used by SSprocessing

md5_unique_datum_id

MD5'd version of the UID. Used for instances where we dont want to make clients aware of UIDs.

status_traits

Status traits attached to this datum

tgui_shared_states

global

Associative list of JSON-encoded shared states that were set by tgui clients.

Proc Details

CanProcCall

Proc to check if a datum allows proc calls on it

Returns TRUE if you can call a proc on the datum, FALSE if you cant

DeleteComponent

Removes the component from the datum

DeleteComponentsType

Removes all components of a given type from the datum

GetComponent

Return any component assigned to this datum of the given type

This will throw an error if it's possible to have more than one component of that type on the parent

Arguments:

GetComponents

Get all components of a given type that are attached to this datum

Arguments:

GetExactComponent

Return any component assigned to this datum of the exact given type

This will throw an error if it's possible to have more than one component of that type on the parent

Arguments:

LoadComponent

Get existing component of type, or create it and return a reference to it

Use this if the item needs to exist at the time of this call, but may not have been created before now

Arguments:

MD5_UID

Safety wrapper for getting MD5 UIDs

This ensures it exists before reading it

RegisterSignal

Register to listen for a signal from the passed in target

This sets up a listening relationship such that when the target object emits a signal the source datum this proc is called upon, will receive a callback to the given proctype Return values from procs registered must be a bitfield

Arguments:

RegisterSignals

Registers multiple signals to the same proc.

TakeComponent

Transfer this component to another parent

Component is taken from source datum

Arguments:

TransferComponent

Transfer a single component from the source datum, to the target.

Arguments:

TransferComponents

Transfer all components to target

All components from source datum are taken

Arguments:

UID

Gets or creates the UID of a datum

BYOND refs are recycled, so this system prevents that. If a datum does not have a UID when this proc is ran, one will be created Returns the UID of the datum

UnregisterSignal

Stop listening to a given signal from target

Breaks the relationship between target and source datum, removing the callback when the signal fires

Doesn't care if a registration exists or not

Arguments:

_AddComponent

Creates an instance of new_type in the datum and attaches to it as parent

Sends the COMSIG_COMPONENT_ADDED signal to the datum

Returns the component that was created. Or the old component in a dupe situation where COMPONENT_DUPE_UNIQUE was set

If this tries to add a component to an incompatible type, the component will be deleted and the result will be null. This is very unperformant, try not to do it

Properly handles duplicate situations based on the dupe_mode var

_AddElement

Finds the singleton for the element type given and attaches it to src

_RemoveElement

Finds the singleton for the element type given and detaches it from src You only need additional arguments beyond the type if you're using ELEMENT_BESPOKE

_SendSignal

Internal proc to handle most all of the signaling procedure

Will runtime if used on datums with an empty component list

Use the SEND_SIGNAL define instead

declent_ru

Процедура выбора правильного падежа для любого предмета, если у него указан словарь «ru_names», примерно такой: RU_NAMES_LIST_INIT("jaws of life", "челюсти жизни", "челюстей жизни", "челюстям жизни", "челюсти жизни", "челюстями жизни", "челюстях жизни")

p_a

Functionally the \a macro, for the cases where you put a bicon between "some [bicon] pop corn"

p_are

Applies "is" for singular genders, or "are" for plural ones (e.g. "he is here" Vs. "they are here").

p_do

Applies "does" for singular genders, or "do" for plural ones (e.g. "she does stuff" Vs. "they do stuff").

p_es

Adds an "es" to the end of a word as appropriate for a particular gender (e.g. "he screeches" and "they screech"). For verb conjugation.

p_have

Applies "has" for singular genders, or "have" for plural ones (e.g. "she has eaten" Vs. "they have eaten").

p_s

Used to add an "s" to the end of a word as appropriate for a particular gender (e.g. "she looks" and "they look"). For verb conjugation.

p_their

Applies one of "their", "its", "his", or "her" as appropriate. Set to TRUE to capitalise.

p_them

Applies one of "them", "it", "him", or "her" as appropriate. Set to TRUE to capitalise.

p_themselves

Applies one of "themselves", "itself", "himself", or "herself" as appropriate. Set to TRUE to capitalise.

p_they

Applies one of "they", "it", "he", or "she" as appropriate. Set to TRUE to capitalise.

p_theyre

Applies one of "they're", "it's", "he's", or "she's" as appropriate. Set to TRUE to capitalise.

p_theyve

Applies one of "they've", "it's", "he's", or "she's" as appropriate. Set to TRUE to capitalise.

p_were

Applies "was" for singular genders, or "were" for plural ones (e.g. "it was huge" Vs. "they were huge").

ru_p_do

Применяет "делает" для единственного числа и "делают" для множественного ("она делает" / "они делают").

ru_p_have

Применяет "имеет" для единственного числа и "имеют" для множественного ("она имеет" / "они имеют").

ru_p_theirs

Применяет одно из "них", "него", "него", или "нее" в зависимости от пола. Установите TRUE для заглавной буквы.

ru_p_them

Применяет одно из "их", "его", или "её" в зависимости от пола. Установите TRUE для заглавной буквы.

ru_p_themselves

Применяет одно из "сами", "само", "сам", или "сама" в зависимости от пола. Установите TRUE для заглавной буквы.

ru_p_they

Применяет одно из "они", "оно", "он", или "она" в зависимости от пола. Установите TRUE для заглавной буквы.

ru_p_were

Применяет "было" для единственного числа и "были" для множественного ("оно было" / "они были").

signal_cancel_activate_self

Used for signal registrars who wish to completely ignore all behavior in the attack chain from parent types. Should be used sparingly, as subtypes are meant to build on behavior from the parent type.

signal_cancel_attack_by

Used for signal registrars who wish to completely ignore all behavior in the attack chain from parent types calling attack_by. Should be used sparingly, as subtypes are meant to build on behavior from the parent type.

signal_qdel

Signal qdel

Proc intended to be used when someone wants the src datum to be qdeled when a certain signal is sent to them.

Example usage: RegisterSignal(item, COMSIG_PARENT_QDELETING, TYPE_PROC_REF(/datum, signal_qdel))

string_assoc_list

Caches associative lists with non-numeric stringify-able index keys and stringify-able values (text/typepath -> text/path/number).

ui_act

public

Called on a UI when the UI receieves a href. Think of this as Topic().

required action string The action/button that has been invoked by the user. required params list A list of parameters attached to the button.

return bool If the UI should be updated or not.

ui_assets

public

Called on an object when a tgui object is being created, allowing you to push various assets to tgui, for examples spritesheets.

return list List of asset datums or file paths.

ui_close

public

Called on a UI's object when the UI is closed, not to be confused with client/verb/uiclose(), which closes the ui window

ui_data

public

Data to be sent to the UI. This must be implemented for a UI to work.

required user mob The mob interacting with the UI.

return list Data to be sent to the UI.

ui_host

private

The UI's host object (usually src_object). This allows modules/datums to have the UI attached to them, and be a part of another object.

ui_interact

External tgui definitions, such as src_object APIs.

Copyright (c) 2020 Aleksej Komarov SPDX-License-Identifier: MIT

public

Used to open and update UIs. If this proc is not implemented properly, the UI will not update correctly.

required user mob The mob who opened/is using the UI. optional ui datum/tgui The UI to be updated, if it exists.

ui_modal_act

Call this from a proc that is called in ui_act() to process modal actions

Example: /obj/machinery/chem_master/proc/ui_act_modal You can then switch based on the return value and show different modals depending on the answer. Arguments:

ui_modal_answer

Calls the source's currently assigned modal's (if there is one) on_answer() proc. Private.

Arguments:

ui_modal_bento

Opens a bento input UI modal

Internally checks if the answer is in the list of choices. Arguments:

ui_modal_boolean

Opens a yes/no UI modal

Arguments:

ui_modal_choice

Opens a dropdown input UI modal

Internally checks if the answer is in the list of choices. Arguments:

ui_modal_clear

Clears the current modal for a given datum

Arguments:

ui_modal_data

Call this from ui_data() to return modal information if needed

Arguments:

ui_modal_input

Opens a text input UI modal

Arguments:

ui_modal_message

Opens a message UI modal

Arguments:

ui_modal_new

Registers a given modal to a source. Private.

Arguments:

ui_modal_preprocess_answer

Passes an answer from JS through the modal's proc.

Used namely for cutting the text short if it's longer than an input modal's max_length. Arguments:

ui_state

private

The UI's state controller to be used for created uis This is a proc over a var for memory reasons

ui_static_data

public

Static Data to be sent to the UI.

Static data differs from normal data in that it's large data that should be sent infrequently. This is implemented optionally for heavy uis that would be sending a lot of redundant data frequently. Gets squished into one object on the frontend side, but the static part is cached.

required user mob The mob interacting with the UI.

return list Statuic Data to be sent to the UI.

ui_status

Base state and helpers for states. Just does some sanity checks, implement a proper state for in-depth checks.

Copyright (c) 2020 Aleksej Komarov SPDX-License-Identifier: MIT

public

Checks the UI state for a mob.

required user mob The mob who opened/is using the UI. required state datum/ui_state The state to check.

return UI_state The state of the UI.

update_static_data

public

Forces an update on static data. Should be done manually whenever something happens to change static data.

required user the mob currently interacting with the ui optional ui ui to be updated