Category:Ultra BASIC
This page was last modified 20:47, 31 May 2023 by Mars2000you. Based on work by Vampier and Rderooy.

Contents

Description

This BASIC extension was created by Sebastiaan (Bas) Weigel and distributed by the Dutch MSX Gids magazine in 1988. A demo is provided on the floppy disk.

To install it, you need to enter RUN"ULTRA.BAS" or BLOAD"ULTRA",R. The installation will provoke a soft reset. You need to remove the Ultra BASIC disk from the drive during this soft reset, that gives a permanent status to the extension in the RAM (see also CALL DEACTIVATE).

Instructions (general info)

Ultra BASIC comes with 42 new instructions. Some of them allow to directly use a non-documented MSX1 screen with multicolored characters, many pokes or routines are also replaced by corresponding instructions.

Note: CALL can be replaced by the character underscore (_). A space is not required after this character. See CALL for more info.

Instructions (ordered per category)

Characters

Instruction Generation Function
CALL ALTERCHR MSX1 Replaces a character by another character on the screen
CALL DEFAULTCHR MSX1 Selects the default character set to be used on next SCREEN
CALL PATTERN MSX1 Modifies the pixel pattern of a specified character
CALL SETCHR MSX1 Selects current character set, optionally modified with CALL PATTERN, for next SCREEN

Colors

Instruction Generation Function
CALL ALTERCOLOR MSX1 Replaces a color by another color on the entire screen
CALL HICOLOR MSX1 Modifies the pixels color of a specified character, allowing to use 16 colors per character
CALL HIRES MSX1 Activates the High Resolution screen mode
CALL SETCOLOR MSX1 Restores the default colors of the characters, optionally modified with CALL HICOLOR

Conditions

Instruction Generation Function
CALL DO...WHILE MSX1 Repeats a block of instructions while a condition is true

Data Storage

Instruction Generation Function
CALL DISK MSX1 Checks if the disk drive is connected with the MSX computer

Debugging

Instruction Generation Function
CALL DATLIN MSX1 Checks which number line with data is currently read

Display

Instruction Generation Function
CALL CLGRAPHIC MSX1 Fills a 16x16 block with the specified color on graphic screens 2, 4 to 8
CALL DSCROLL MSX1 Rolls all current texts on the screen to the bottom
CALL GETSCREEN MSX1 Checks if your monitor is correctly connected with the MSX computer
CALL GRAPHIC MSX1 Defines color for the specified pixel of a 16x16 block on graphic screens 2, 4 to 8
CALL INGRAPHIC MSX1 Reads a 16x16 block on graphic screens 2, 4 to 8
CALL LOWER MSX1 Sets characters of a string in small letters mode (lowercase)
CALL LSCROLL MSX1 Rolls all current texts on the screen to the left
CALL PAGE MSX1 Selects the active page and the visible page on screen 0 (with width<41)
CALL PUTGRAPHIC MSX1 Puts a previously defined or read 16x16 block on graphic screens 2, 4 to 8
CALL RSCROLL MSX1 Rolls all current texts on the screen to the right
CALL SCROFF MSX1 Turns off the screen
CALL SCRON MSX1 Turns on the screen
CALL UPPER MSX1 Converts lower case of letters to uppercase
CALL USCROLL MSX1 Rolls all current texts on the screen to the top

Keyboard

Instruction Generation Function
CALL CAPSLOCK MSX1 Sets the computer in locked uppercase mode and blocks the usage of CAPSLOCK key
CALL CAPSOFF MSX1 Turns off the CAPS led and sets the computer in small letters mode (lowercase)
CALL CAPSON MSX1 Turns on the CAPS led and sets the computer in capital letters mode (uppercase)
CALL INIFNK MSX1 Reinitializes the contents of the function keys
CALL KILLBUF MSX1 Clears the keyboard buffer

Printer

Instruction Generation Function
CALL POL MSX1 Returns the status of the printer

RAM Access

Instruction Generation Function
CALL DEEK MSX1 Returns the value read from two bytes of the memory (RAM)
CALL DOKE MSX1 Writes a value to two bytes of the memory (RAM)
CALL RCLSCREEN MSX1 Restores the text previously saved in RAM by CALL STOSCREEN
CALL STOSCREEN MSX1 Stores the current text on the screen in the memory computer

Sound and Music

Instruction Generation Function
CALL INIPSG MSX1 Initializes the PSG and silences all 3 PSG channels without producing a beep

Sprites

Instruction Generation Function
CALL CLRSPRITES MSX1 Clears all the sprites

Ultra BASIC System

Instruction Generation Function
CALL DEACTIVATE MSX1 Deactivates the permanent status of Ultra BASIC in the memory
CALL HELP MSX1 Displays the list of Ultra BASIC instructions, one by one

Windows

Instruction Generation Function
CALL CLP MSX1 Clears active part of screen 0 when you have created a window with CALL DEFPAGE
CALL DEFPAGE MSX1 Creates a kind of window (without visible borders) inside a screen 0 (with width <41)
CALL NORMAL MSX1 Leaves the window mode and goes back to the normal working of screen 0 (with width <41)

Instructions (alphabetical order)

Instruction Generation Type
CALL ALTERCHR MSX1 Characters
CALL ALTERCOLOR MSX1 Colors
CALL CAPSLOCK MSX1 Keyboard
CALL CAPSOFF MSX1 Keyboard
CALL CAPSON MSX1 Keyboard
CALL CLGRAPHIC MSX1 Display
CALL CLP MSX1 Windows
CALL CLRSPRITES MSX1 Sprites
CALL DATLIN MSX1 Debugging
CALL DEACTIVATE MSX1 Ultrabasic System
CALL DEEK MSX1 RAM Access
CALL DEFAULTCHR MSX1 Characters
CALL DEFPAGE MSX1 Windows
CALL DISK MSX1 Data Storage
CALL DO...WHILE MSX1 Conditions
CALL DOKE MSX1 RAM Access
CALL DSCROLL MSX1 Display
CALL GETSCREEN MSX1 Display
CALL GRAPHIC MSX1 Display
CALL HELP MSX1 Ultrabasic System
CALL HICOLOR MSX1 Colors
CALL HIRES MSX1 Colors
CALL INGRAPHIC MSX1 Display
CALL INIFNK MSX1 Keyboard
CALL INIPSG MSX1 Sound and Music
CALL KILLBUF MSX1 Keyboard
CALL LOWER MSX1 Display
CALL LSCROLL MSX1 Display
CALL NORMAL MSX1 Windows
CALL PAGE MSX1 Display
CALL PATTERN MSX1 Characters
CALL POL MSX1 Printer
CALL PUTGRAPHIC MSX1 Display
CALL RCLSCREEN MSX1 RAM Access
CALL RSCROLL MSX1 Display
CALL SCROFF MSX1 Display
CALL SCRON MSX1 Display
CALL SETCHR MSX1 Characters
CALL SETCOLOR MSX1 Colors
CALL STOSCREEN MSX1 RAM Access
CALL UPPER MSX1 Display
CALL USCROLL MSX1 Display