Ksp reference Manual

2.2. on async_complete
on async_complete
async complete callback, triggered after the execution of any load/save command
Callbacks
2
KSP Reference Manual

---

Remarks
To resolve synchronization issues, the commands mentioned above return unique IDs when being
used. Upon completion of the command’s action, the on 
async_complete
callback gets triggered
and the built-in variable 
$NI_ASYNC_ID
is updated with the ID of the command that triggered the
callback. If the command was completed successfully (for example if the file was found and suc-
cessfully loaded), the internal value 
$NI_ASYNC_EXIT_STATUS
is set to 1, otherwise it is 0.
Examples
on init
declare $load_midi_file_id
declare ui_button $load_midi_file
end on
on ui_control ($load_midi_file)
$load_midi_file_id := load_midi_file()
while ($load_midi_file_id # -1)
wait (1)
end while
message ("MIDI file loaded")
end on
on async_complete
if ($NI_ASYNC_ID = $load_midi_file_id)
$load_midi_file_id := -1
end if
end on
Example that pauses the ui_control callback until the file is loaded
See Also
$NI_ASYNC_EXIT_STATUS
$NI_ASYNC_ID
Load/Save Commands