cyborg_model_gallery

Public stock artwork is encoded once per catalog generation, independently of private layouts. Keep file resources and small indexes, not duplicate JSON lists.

Vars
assets	Owned resources are registered only on acquisition, avoiding global preloading.
catalog	The model catalog the gallery was last built from
catalog_asset	Asset name of the gallery's model list
department_assets	Asset name of each department's thumbnails, by department
generating	Whether or not a build is running, so everyone else waits for it
generation	Hash of the gallery's contents, which names its asset files
generation_failure	The exception the running or last build threw, thrown again to everyone who waited on that build
Procs
assets_for_department	Unknown departments select only the finite catalog, never a new resource.
build_catalog	Rebuilds the gallery's files when the catalog changed - its model list and each department's thumbnails. A failed build keeps the old files and throws to everyone waiting
ensure_ready	Waits out a running build, and throws again whatever that build threw
get_url_mappings	Returns the URL of each of the gallery's files
json_resource	Only a temporary serialization buffer exists; the round retains the file resource.
owned_asset	Reuse an identical current item without registering new global/preload entries.
register	Builds the gallery for the current catalog when assets load
send_to_viewer	Called before private state is captured. Native acquisition can yield while flushing.
ui_descriptor	No waits or generation here: the preflight already acquired this public selection.
unregister	Unregisters the gallery's files and forgets them

Var Details

var
assets
– /list

Owned resources are registered only on acquisition, avoiding global preloading.

var
catalog
– /list

The model catalog the gallery was last built from

var
catalog_asset

Asset name of the gallery's model list

var
department_assets
– /list

Asset name of each department's thumbnails, by department

var
generating

Whether or not a build is running, so everyone else waits for it

var
generation

Hash of the gallery's contents, which names its asset files

var
generation_failure
– /exception

The exception the running or last build threw, thrown again to everyone who waited on that build

Proc Details

proc
assets_for_department
(department)

Unknown departments select only the finite catalog, never a new resource.

proc
build_catalog
(/list/source_catalog)

Rebuilds the gallery's files when the catalog changed - its model list and each department's thumbnails. A failed build keeps the old files and throws to everyone waiting

↑
ensure_ready
()

Waits out a running build, and throws again whatever that build threw

get_url_mappings
()

Returns the URL of each of the gallery's files

proc
json_resource
(/list/data)

Only a temporary serialization buffer exists; the round retains the file resource.

proc
owned_asset
(asset_name, resource, content_hash)

Reuse an identical current item without registering new global/preload entries.

register
()

Builds the gallery for the current catalog when assets load

proc
send_to_viewer
(/mob/user, department)

Called before private state is captured. Native acquisition can yield while flushing.

proc
ui_descriptor
(department)

No waits or generation here: the preflight already acquired this public selection.

↑
unregister
()

Unregisters the gallery's files and forgets them

cyborg_model_gallery /datum/asset/cyborg_model_gallery

Vars

Procs

Var Details

var assets – /list

var catalog – /list

var catalog_asset

var department_assets – /list

var generating

var generation

var generation_failure – /exception

Proc Details

proc assets_for_department(department)

proc build_catalog(/list/source_catalog)

↑ensure_ready()

get_url_mappings()

proc json_resource(/list/data)

proc owned_asset(asset_name, resource, content_hash)

register()

proc send_to_viewer(/mob/user, department)

proc ui_descriptor(department)

↑unregister()