Difference between revisions of "SCI/Specifications/SCI virtual machine/Kernel functions"

 

===Kernel function 0x08: DrawPic(word[, word, word, word])===

The animation is executed when kAnimate() (see [[SCI/Specifications/SCI in action/Views and animation in SCI|Views and animation in SCI]] section) is invoked. If not specified, it is assumed to be the same animation as last time.

This function draws a background picture plus some views to the foreground. If the background picture had not been drawn previously, it is animated with the animation style set during kDrawPic (see section Kernel function 0x08). Drawing the views is a rather complex issue. Refer to Views and animation in SCI section for its description.

This function stores the list of PicViews for later use by the Animate() syscall. See Kernel function 0x0b section for more details.

This function creates a window (see also Windows, Dialogs and Controls section), sets this window as the active port, draws the window (if neccessary), and returns with the window's heap address.

This function draws a Control (see Windows, Dialogs and Controls section for details). Please note that the correct port must be selected beforehand.

This function will apply the event provided to edit a type 3 (Edit window) Control (see Windows, Dialogs and Controls section for a description of the control system). Normal keypresses are added to the area pointed to by Control::text, unless the total string length would be greater than Control::max. Cursor keys, backspace and a few other keys may be used to manipulate the control. In FreeSCI, some of the libreadline control keys can be used to edit and move the cursor as well. If it is called to edit a Control which is not of type 3, it returns without error. Please note that the correct port (usually the window which the Control was drawn in) must be selected beforehand.

After this is done, the engine restarts at a certain point (see Interpreter initialization and the main execution loop section for more details), re-initializes the stack, and executes the replay method of the game object.