This section describes functions related to Sysquake instances, i.e. particular SQ files loaded in Sysquake. Public handlers permit to execute code in the context of another instance, to get or change its variables and to trigger an update of its figures.
Execute a public handler.
(out1,...) = sqcall(id, name, in1, ...)
sqcall(id,name,...) executes the public handler whose name is given by the string name in the context of the SQ file instance identified by id. Remaining input arguments are passed as additional input arguments to the public handler; output arguments are trailing output arguments of the handler once leading arguments have been assigned to the SQ variables enumerated in the handler declaration. If necessary, make handlers are called to generate input arguments of the public handler, and draw handlers are called to update the graphics.
Get the ID of the current SQ file instance.
id = sqcurrentinstance
sqcurrentinstance gives the ID of the current SQ file instance.
Get the IDs of all SQ file instances.
idvec = sqinstances
sqinstances gives a vector of IDs of all SQ file instances.
Get the title of an SQ file instance.
str = sqinstancetitle(id)
sqinstancetitle gives the title string of the SQ file instance specified by id.