Download Sysquake User Manual

Transcript
SQ File Reference
107
variable _implicit
When implicit declarations are enabled, all the variables appearing in
handler declarations are managed by Sysquake exactly as if they had
been declared explicitly in variable statements. Implicit variables
cannot have the _nondumpable attribute; however, you can declare
only the nondumpable variables and have a variable _implicit
declaration for all other variables.
Definition of constants
Some numbers are used as identifiers at different places. For instance graphical objects which can be manipulated with the mouse
are tagged with an identifier when they are displayed, and this identifier is used to recognize them when the user clicks them. Numeric
ID can be replaced with more meaningful names with constant definitions. Constant definitions begin with the keyword define, followed
by the identifier, the equal character, and the integer value or the
keyword _auto. Constants defined with _auto are numbered consecutively from 1. In the example below, kGainID is 1, kDelayID is 2,
etc.
Example
define
define
define
define
kGainID = _auto
kDelayID = _auto
kMassID = _auto
kYMaxID = 1000
The definition is valid not only in the declaration part of SQ files everywhere an integer number could appear, but also in functions defined
in function blocks. If the definition is placed inside a function block, it
cannot be referenced in handler declarations.
Init and Terminate Handlers
The purpose of init handlers is to provide default values for the variables and the plot options. Variables are initialized with the values
returned by the init handler(s); other variables (those not enumerated
in the left-hand part of init handler declarations) are set to the empty
array []. Initial plots are set up with commands subplots, subplotprops, subplotpos, scalesync or subplotsync, and subplotparam.
By default, the first figure is displayed. The same functions can be
used without any argument to retrieve the corresponding values; this
is especially useful to store these settings in a data file.