DrawPic

void DrawPic(number picNum, [number animation, bool clear, number defaultPalette])

Draws a picture on the screen. The last three parameters are optional. If specified, they can define how the picture is displayed. If unspecified, the last used (or default) parameters are used.

  • The animation is executed when the Animate() kernel is called. It can be set to one of the following values (defined in SCI.SH):
    dpOPEN_INSTANTLY display instantly
    dpOPEN_HCENTER horizontally open from center
    dpOPEN_VCENTER vertically open from center
    dpOPEN_RIGHT open from right
    dpOPEN_LEFT open from left
    dpOPEN_BOTTOM open from bottom
    dpOPEN_TOP open from top
    dpOPEN_EDGECENTER open from edges to center
    dpOPEN_CENTEREDGE open from center to edges
    dpOPEN_CHECKBOARD open random checkboard
    dpCLOSEREOPEN_HCENTER horizontally close to center, reopen from center
    dpCLOSEREOPEN_VCENTER vertically close to center, reopen from center
    dpCLOSEREOPEN_RIGHT close to right, reopen from right
    dpCLOSEREOPEN_LEFT close to left, reopen from left
    dpCLOSEREOPEN_BOTTOM close to bottom, reopen from bottom
    dpCLOSEREOPEN_TOP close to top, reopen from top
    dpCLOSEREOPEN_EDGECENTER close from center to edges, reopen from edges to center
    dpCLOSEREOPEN_CENTEREDGE close from edges to center, reopen from center to edges
    dpCLOSEREOPEN_CHECKBOARD close random checkboard, reopen
  • If the clear flag is set, the screen will be cleared before drawing the picture. The flag's values are defined in SCI.SH as follows:
    dpCLEAR Clear the screen before drawing
    dpNO_CLEAR Don't clear the screen before drawing
  • defaultPalette specifies the default palette to be used for drawing it (0-3). The palettes are contained in the pic files and can be edited with SCI Studio's picture editor. This is useful for displaying your picture in day/night colours.
Example

DrawPic(100 dpCLOSEREOPEN_EDGECENTER dpCLEAR 1)
/* draws PIC.100 closing the existing picture from center to the edges, reopens with the new picture from the edges to center, clearing the screen before drawing and using palette[1] as the default. */