Display (Kernel)¶

Display(text [params...])¶

Displays the specified text to the screen.

Following the text, you can specify how the string is displayed or handled with parameters. Each parameter has a type ID, specified in sci.sh.

Allowed parameters:

dsCOORD

2 parameters: (x, y) coordinates at which to display the text.

dsALIGN

1 parameter: alRIGHT, alLEFT or alCENTER.

dsCOLOUR

1 parameter: set the colour.

dsBACKGROUND

1 parameter: set the background colour. -1 will use a transparent background.

dsDISABLED

1 parameter: set the disabled (grey) flag. 1 will draw disabled text.

dsFONT

1 parameter: the resource number of the font to use.

dsWIDTH

1 parameter: the width to wrap the text.

dsSAVEPIXELS

no parameters: set the “save under” flag to save a copy of the pixels before writing the text. The handle to the saved pixels is returned.

dsRESTOREPIXELS

1 parameter: handle to the saved pixels. With this command, the text and all the other parameters are ignored.

Examples:

(Display "Hello World")

(Display
        "Hello World"
        dsCOORD 60 80
        dsCOLOUR clRED
        dsBACKGROUND clYELLOW
        dsFONT 4
        dsALIGN alCENTER
        dsWIDTH 200
)