Signals to an LSL script that it has been started on the SCI stack and sends its launch parameters and contextual cache.
Trigger: Sent after the SCI has started a script, either because it has been newly executed or because it has resumed execution from the background.
Target: LINK_SET.
link_message(integer sender_num, integer 0, string "BIOS_SCI_STARTED", key [script_name] + "|" + [cache_data] + "|" + [parent_exit_data] + "|" + [launch_parameters])
| • integer | n/a |
| • key | [script_name]|[cache_data]|[parent_exit_data]|[launch_parameters] |
| Parameter | Description |
|---|---|
[script_name] |
String. Will be the name of the LSL script that has been started. Software that receives this system call should first validate this parameter against llGetScriptName, because it may be intended for another script. |
[cache_data] |
String. Will be the contextual cache data for this instance of the LSL script. For services and libraries, this will be a blank string. For programs, this will originally be a random UUID. If the program launches another program and is suspended in the background, any future BIOS_SCI_STARTED call after this instance is resumed from the background will include the same [cache_data] value. If this instance of the program on the SCI stack has had its cache modified using BIOS_SCI_CACHE, that data will be sent instead.Generally, this parameter is only useful for multi-context aware programs and may be safely ignored otherwise. See the SCI documentation for more information on mutli-context aware programs. |
[parent_exit_data] |
String. Will be the [exit_data] passed with BIOS_SCI_TERMINATE if the LSL script is a program and it is starting because the previous running program was terminated.If the previous running program was launched via BIOS_SCI_INTERRUPT_REQUEST, this field is blank. Programs launched via interrupt cannot pass exit data to the programs they interrupted. If the LSL script is a service or library, this field is blank. Only programs can receive parent exit data. |
[launch_parameters] |
String. Will be the [launch_parameters] passed with BIOS_SCI_EXECUTE to launch this instance of the program.For services and libraries, this will be a blank string. This value will be saved and resent with any subsequent BIOS_SCI_STARTED call for this instance of the program; however, unlike [cache_data], it cannot be overwritten. |