SET TITLE
This page was last modified 15:40, 8 December 2016 by Mars2000you. Based on work by Gdx.

Contents

Effect

Specifies the title and the colors of the initial logo screen at system startup, and saves these parameters in the SRAM of the Real Time Clock (RTC).

Syntax

SET TITLE [<title>],[<logo screen mode>]

A least one parameter needs to be used.

Do not put a comma if no parameters are behind.

Parameters

<title> is a string (between quotes) or a string variable. Only the 6 first characters will be displayed below the logo screen and the computer will wait for the pressing on a key to quit this screen.

Remark: SET PASSWORD and SET PROMPT use also such a string of characters. Only the last entered instruction will be saved in the Real Time Clock (RTC).

<logo screen mode> is a number to specify the type of logo screen:
1: dark blue background, MSX white logo in black rectangle
2: green background, MSX white logo in light blue rectangle
3: red background, MSX white logo in purple rectangle
4: yellow background, MSX white logo in red rectangle

Remark: if you change only the logo screen mode, so you are free to use later SET PASSWORD or SET PROMPT without losing the new colors for the logo screen.

Examples

SET TITLE "hello!" ' change only the title text
SET TITLE ,3 ' change only the logo screen mode

Storage in the RTC

The Real Time Clock (RTC) is a small storage of generally 53 bytes in blueMSX (52 bytes in openMSX). However, the Russian Yamaha computers with network have an additionnal byte that comes after #26 in blueMSX, so, for these machines, #27 to #34 are replaced by #28 to #35 in blueMSX.

The data saved with SET TITLE are stored as following:

  • #26 in blueMSX (#25 in openMSX)
Value Logo screen Background MSX logo Logo rectangle
00 1 Dark blue White Black
01 2 Green White Light blue
02 3 Red White Purple
03 4 Yellow White Red


  • #28 in blueMSX (#27 in openMSX)

This byte has always the value 00 when the string of characters X$ is used for SET TITLE

  • #29 to #34 in blueMSX (#28 to #33 in openMSX)

These bytes store the 6 first characters of the string X$, by using 2 bytes for saving the ASCII code of each character.

Example with SET TITLE "hello!"

- #29: 08 - #2A: 06 - ASCII code of 'h' is 68
- #2B: 05 - #2C: 06 - ASCII code of 'e' is 65
- #2D: 0C - #2D: 06 - ASCII code of 'l' is 6C
- #2E: 0C - #30: 06 - ASCII code of 'l' is 6C
- #31: 0F - #32: 06 - ASCII code of 'o is 6F
- #33: 01 - #34: 02 - ASCII code of '!' is 21

Related to

SET PASSWORD, SET PROMPT

Compatibility

MSX-BASIC 2.0 or higher