@nataliapc/mcp-openmsx 1.1.15 → 1.2.2

package/resources/programming/basic_wiki/INTERVAL.md

@@ -0,0 +1,57 @@
+# INTERVAL
+
+## Effect
+
+Changes the way BASIC timer interrupts are handled.
+
+## Syntax
+
+`INTERVAL ON|OFF|STOP`
+
+## Parameters
+
+This instruction is always combined with `ON INTERVAL GOSUB`.
+
+With `INTERVAL ON`, the computer will check if a specified time interval has been elapsed and the subroutine specified with `ON INTERVAL GOSUB` is executed immediately.
+
+With `INTERVAL OFF`, this checking is disabled.
+
+With `INTERVAL STOP`, the checking is made, but the execution of the subroutine specified with `ON INTERVAL GOSUB` will happen only when an `INTERVAL ON` instruction is executed later in the program.
+
+## Example
+
+```basic
+10 ON INTERVAL=60 GOSUB 50
+20 INTERVAL ON
+30 X=X+1:IF INKEY$="" THEN 30
+40 END
+50 PRINT X:RETURN
+```
+
+```basic
+10 ON INTERVAL=300 GOSUB 60
+20 INTERVAL ON
+30 FOR I=1 TO 10000:NEXT I
+40 INTERVAL OFF
+50 END
+60 K=K+6:PRINT K;"seconds"
+70 RETURN
+ 
+RUN
+ 6 seconds
+ 12 seconds
+ 18 seconds
+ 24 seconds
+```
+
+## Related to
+
+`ON INTERVAL GOSUB`
+
+## Compatibility
+
+MSX-BASIC 1.0 or higher
+
+## Source
+
+Retrieved from "https://www.msx.org/wiki/INTERVAL"

package/resources/programming/basic_wiki/KEY().md

@@ -0,0 +1,51 @@
+# KEY()
+
+## Effect
+
+Enables/disables/stops a function key.
+
+## Syntax
+
+`KEY (<Number>) ON|OFF|STOP`
+
+## Parameters
+
+`<Number>` is the function key number. It can vary between 1 and 10.
+
+`ON`, `OFF` or `STOP` enables, disables or stops the call caused by the corresponding function key.
+
+## Example
+
+```basic
+10 FOR I = 1 TO 3: KEY(I) STOP: NEXT ' F1 to F3 are stopped
+20 FOR I = 4 TO 10: KEY(I) OFF: NEXT ' F4 to F10 are disabled
+30 ON KEY GOSUB 170, 180, 190 ' Subroutine will only be active from line 130
+40 CLS
+50 PRINT"TEST 1"
+60 PRINT
+70 PRINT"Press a function key or ESC key"
+80 A$=INPUT$(1)
+90 IF A$ = CHR$(27) THEN 100 ELSE 80
+100 CLS
+110 PRINT"TEST 2"
+120 PRINT"Press a function key"
+130 KEY(1) ON:KEY(2) ON:KEY(3) ON ' F1 to F3 and the subroutine in line 30 are enabled
+140 GOTO 160
+150 PRINT " pressed"
+160 GOTO 160
+170 PRINT:PRINT "F1";:RETURN 150
+180 PRINT:PRINT "F2";:RETURN 150
+190 PRINT:PRINT "F3";:RETURN 150
+```
+
+## Related to
+
+`KEY`, `ON KEY GOSUB`
+
+## Compatibility
+
+MSX-BASIC 1.0 or higher
+
+## Source
+
+Retrieved from "https://www.msx.org/wiki/KEY()"

package/resources/programming/basic_wiki/KEY.md

@@ -0,0 +1,254 @@
+# KEY
+
+## Effect
+
+Lists the contents of the function keys (`KEY LIST`).
+
+Enables (`KEY ON`) or disables (`KEY OFF`) the display of their content
+- on line 24 of text modes SCREEN 0, 1, 9.
+- on line 13 of Kanji text modes 0 and 1, activated with `CALL KANJI`, `CALL KANJI0` or `CALL KANJI1`.
+- on line 24 of Kanji text modes 2 and 3, activated with `CALL KANJI2` or `CALL KANJI3`.
+
+Changes the text displayed at the bottom of the screen.
+
+## Syntaxes
+
+`KEY LIST`
+
+`KEY ON|OFF`
+
+`KEY <Number>,"<String>"`
+
+## Parameters
+
+`ON`/`OFF` enables/disables display of the function key text at the bottom of the screen. It is only displayed in text screen modes.
+
+`LIST` is used to list the contents of the function keys.
+
+`<Number>` is the function key number. (1~10)
+
+`<String>` is a text of up to 15 characters allocated for each function key. This string is executed as a BASIC program line when the corresponding key is pressed.
+
+When pressing the specific function key in direct mode the text is displayed at the location of the cursor. This allows quick entry of text or instructions that are often used. The function key text will also be displayed on the last line of the screen, if this feature is active, which is the default.
+
+If the text contains an instruction and you want to have it automatically executed upon pressing the function key, add `+CHR$(13)` at the end of the string. This corresponds to the RETURN/ENTER key. See MSX Characters & Control Codes for other character codes.
+
+During a program execution pressing a function key will have the same effect as you press each key corresponding at characters in text with in extra the call to the routine defined by `ON KEY GOSUB`. The text will not be displayed except during the execution of `INPUT`.
+
+_Note: To go back completely to the default function keys, you need to use `DEFUSR=&H3E : X=USR(0) : KEY ON`_
+
+## Example
+
+```basic
+10 A$="FILES"+CHR$(13)
+20 KEY 1,A$+"?DSKF(0)"+CHR$(13)
+```
+
+## Standard function keys
+
+By default, the contents of the function keys are as follows (complete display with `KEY LIST`):
+
+### Japanese and Korean machines
+
+Also for Philips VG-8000 and VG-8010 (not the 8010F version), Sanyo PHC-28S.
+
+|Key|Display|String|
+|---|---|---|
+|F1|color|"color"|
+|F2|auto|"auto"|
+|F3|goto|"goto"|
+|F4|list|"list"|
+|F5|run|"run"+CHR$(13)|
+|F6|color 15,4,7|"color 15,4,7"+CHR$(13)|
+|F7 <sup>(*)</sup>|cload"|"cload"+CHR$(34)|
+|F8|cont|"cont"+CHR$(13)|
+|F9|list.|"list."+CHR$(13)|
+|F10|run|CHR$(12)+"run"+CHR$(13)|
+
+<sup>(*)</sup> `cload"` for `"load"+CHR$(34)` on MSX2+ and MSX turbo R machines.
+
+### European, Argentinian and Russian MSX/MSX2 machines
+
+Also for Sharp HB-8000-11 and HB-8000-12, Arabic versions of Spectravideo SVI-728 and SVI-738, Arabic machines in European mode.
+
+On Yamaha YIS-503IIR, the network needs to be disabled: boot while pressing `DEL` key.
+On Arabic machines, the Arabic mode needs to be disabled: boot while presssing `CTRL` key.
+
+|Key|Display|String|
+|---|---|---|
+|F1|color|"color"|
+|F2|auto|"auto"|
+|F3|goto|"goto"|
+|F4|list|"list"|
+|F5|run|"run"+CHR$(13)|
+|F6|color 15,4,4|"color 15,4,4"+CHR$(13)|
+|F7|cload"|"cload"+CHR$(34)|
+|F8|cont|"cont"+CHR$(13)|
+|F9|list.|"list."+CHR$(13)|
+|F10|run|CHR$(12)+"run"+CHR$(13)|
+
+### Brazilian MSX machines
+
+|Key|Display|String|
+|---|---|---|
+|F1|color|"color"|
+|F6 <sup>(*)</sup>|color 15,1,1|"color 15,1,1"+CHR$(13)|
+|F2|auto|"auto"|
+|F7|cload"|"cload"+CHR$(34)|
+|F3|goto|"goto"|
+|F8|cont|"cont"+CHR$(13)|
+|F4|list|"list"|
+|F9|list.|"list."|
+|F5|run|"run"+CHR$(13)|
+|F10|run|"run"|
+
+<sup>(*)</sup> `color 15,4,4` for `"color 15,4,4"+CHR$(13)` on Sharp HB-8000-14.
+
+## Non-standard function keys
+
+### Daewoo Zemmix CPC-50, CPC-50A, CPC-50B and CPC-51
+
+These machines are conceived as consoles, not as computers. On the real hardware, it's impossible to use MSX-BASIC. On emulators, you can access to MSX-BASIC but by default, the contents of the function keys are empty.
+
+### Frael Bruc 100
+
+This MSX clone never displays the contents of the function keys, even if you use KEY ON. However, you can list these contents with KEY LIST (or by pressing the F1 key) and use KEY to change them.
+
+|Key|Display|String|
+|---|---|---|
+|F1 <sup>(*)</sup>|keylist|"keylist"+CHR$(13)|
+|F6|color|"color|
+|F2|cload"|"cload"+CHR$(34)|
+|F7|csave"|"csave"+CHR$(34)|
+|F3|auto|"auto"|
+|F8|renum|"renum"|
+|F4|list .|"list ."+CHR$(13)|
+|F9|list|"list"|
+|F5|run|"RUN "|
+|F10|cont|"cont"+CHR$(13)|
+
+<sup>(*)</sup> displays the contents of all function keys.
+
+### Philips NMS 800 and NMS 801
+
+|Key|Display|String|
+|---|---|---|
+|F1|run"cas:"|"run"+CHR$(34)+"cas:"+CHR$(13)|
+|F2|bload"cas:",r|"bload"+CHR$(34)+"cas:"+CHR$(34)+",r"+CHR$(13)|
+|F3|cload|"cload"+CHR$(13)|
+|F4|load"cas:",r|"load"+CHR$(34)+"cas:"+CHR$(34)+",r"+CHR$(13)|
+|F5|run|"run"+CHR$(13)|
+|F6|color 15,4,4|"color 15,4,4"+CHR$(13)|
+|F7|cont|"cont"+CHR$(13)|
+|F8|cload"|"cload"+CHR$(34)|
+|F9|list|"list"|
+|F10|run|CHR$(12)+"run"+CHR$(13)|
+
+### Brazilian MSX2 machines with MSX-BASIC 2.2
+
+|Key|Display|String|
+|---|---|---|
+|F1|copy|"copy"|
+|F2|files|"files"+CHR$(13)|
+|F3|bload"|"bload"+CHR$(34)|
+|F4|list|"list"|
+|F5|run|"run"+CHR$(13)|
+|F6|color 15,1,1|"color 15,1,1"+CHR$(13)|
+|F7|_format|"_format"+CHR$(13)|
+|F8|_system|"_system"+CHR$(13)|
+|F9|load"|"load"+CHR$(34)|
+|F10|save"|"save"+CHR$(34)|
+
+### Brazilian MSX2+ machines with MSX-BASIC 3.1 or 3.2
+
+|Key|Display|String|
+|---|---|---|
+|F1|files|"files"+CHR$(13)|
+|F2|bload"|"bload"+CHR$(34)|
+|F3|copy|"copy"|
+|F4|list|"list"|
+|F5|run|"run"+CHR$(13)|
+|F6|color 15,0,0|"color 15,0,0"+CHR$(13)|
+|F7|load"|"load"+CHR$(34)|
+|F8|_format|"_format"+CHR$(13)|
+|F9|_system|"_system"+CHR$(13)|
+|F10|run|CHR$(12)+"run"+CHR$(13)|
+
+## Function keys defined by software
+
+### Firmware of Arabic MSX/MSX2 machines
+
+By default, the Arabic mode of these computers (except Arabic versions of Spectravideo SVI-728 and SVI-738) is enabled and the content of the function keys is modified for F2 and F6 to F8 (F9 on Bawareth Perfect machines with 1990 version of Arabic Basic):
+
+|Key|Display|String|
+|---|---|---|
+|F1|color|"color"|
+|F2|_arb1|"_arb1"|
+|F3|goto|"goto"|
+|F4|list|"list"|
+|F5|run|"run"+CHR$(13)|
+|F6 <sup>(*)</sup>|_dcolor|"_dcolor"|
+|F7 <sup>(**)</sup>|_arb2 or _arb0|"_arb2" or "_arb0"|
+|F8 <sup>(***)</sup>|_engl|"_engl"|
+|F9 <sup>(****)</sup>|list|"list."+CHR$(13)|
+|F10|run|CHR$(12)+"run"+CHR$(13)|
+
+<sup>(\*)</sup> not on Bawareth Perfect computers with a 1987 Arabic BASIC version (3.21 - 3.30).  
+<sup>(\*\*)</sup> see below.  
+<sup>(\*\*\*)</sup> _latin for "_latin" on Sakhr AX-170F and AX-350IIF.  
+<sup>(\*\*\*\*\*)</sup> _arb0 on Bawareth Perfect machines with 1990 version of Arabic Basic
+
+#### Contents of F7 key
+
+- _arb2 on Sakhr MSX1 computers.
+- _arb0 on Sakhr MSX2 computers and Bawareth Perfect machines with 1987 version of Arabic Basic.
+- _auto for "_auto" on Bawareth Perfect machines with 1990 version of Arabic Basic.
+- _trans when using an Arabic Sakhr Basic cartridge or the equivalent option on Sakhr AX-370: Arabic/English toggle for MSX-BASIC programming.
+
+### Firmware of Yamaha YIS-503IIR
+
+By default, the network firmware is enabled and the content of the function keys is modified for F1 and F6 to F10:
+
+|Key|Display|String|
+|---|---|---|
+|F1|color|"color"|
+|F2|auto|"auto"|
+|F3|goto|"goto"|
+|F4|list|"list"|
+|F5|run|"run"+CHR$(13)|
+|F6|run"COM:"|"run"+CHR$(34)+"COM:"+CHR$(34)|
+|F7|save"COM:"|"save"+CHR$(34)+"COM:"+CHR$(34)|
+|F8|load"COM:"|"load"+CHR$(34)+"COM:"+CHR$(34)|
+|F9|merge"COM:"|"merge"+CHR$(34)+"COM:"+CHR$(34)|
+|F10|_comterm|"_comterm"+CHR$(13)|
+
+### Connection of a Quick Disk Drive
+
+When booting a MSX computer with a Quick Disk Drive connected, you will see that the contents of most function keys have been modified as follows:
+
+|Key|Display|String|
+|---|---|---|
+|F1|_RUN|"_RUN "|
+|F2|_LOAD|"_LOAD "|
+|F3|_BLOAD|"_BLOAD"|
+|F4 (*)|list|"list "|
+|F5 (*)|run|"run"+CHR$(13)|
+|F6 (**)|color 15,4,7|"color 15,4,7"+CHR$(13)|
+|F7|_QDKEY|"_QDKEY "|
+|F8|_SAVE("QD:|"_SAVE("+CHR$(34)+"QD:"|
+|F9|_BSAVE("QD:|"_BSAVE("+CHR$(34)+"QD:"|
+|F10|_QDFILES|"_QDFILES"|
+
+<sup>(\*)</sup> Generally unchanged.  
+<sup>(\*\*)</sup> Same as Japanese machines, Korean machines, Philips VG-8000 and VG-8010 (not the 8010F version), Sanyo PHC-28S.
+
+## Related to
+
+`KEY()`, `ON KEY GOSUB`
+
+## Compatibility
+
+MSX-BASIC 1.0 or higher
+
+## Source
+Retrieved from "https://www.msx.org/wiki/KEY"

package/resources/programming/basic_wiki/LEFT$().md

@@ -0,0 +1,39 @@
+# LEFT$()
+
+## Effect
+
+Returns a string corresponding to a specified number of the leftmost characters from an original string.
+
+_Note: For strings with Japanese or Korean characters, you need to use `CALL KMID`._
+
+## Syntax
+
+`LEFT$("<String>",<Length>)`
+
+## Parameters
+
+`<String>` is a string of characters between double quotes `"`. It can include non-printable characters and be replaced by a numeric or string variable (also named as alphanumeric variable).
+
+`<Length>` is a number between 0 and 255.
+
+## Example
+
+```basic
+10 A$=LEFT$("MSX Forever!",3)
+20 PRINT A$
+ 
+RUN
+MSX
+```
+
+## Related to
+
+`CALL KMID`, `MID$`, `RIGHT$`
+
+## Compatibility
+
+MSX-BASIC 1.0 or higher
+
+## Source
+
+Retrieved from "https://www.msx.org/wiki/LEFT$()"

package/resources/programming/basic_wiki/LEN().md

@@ -0,0 +1,36 @@
+# LEN()
+
+## Effect
+
+Returns the length of a string, including all non-printable characters.
+
+_Note: For strings with Japanese or Korean characters, you need to use `CALL KLEN`._
+
+## Syntax
+
+`LEN("<String>")`
+
+## Parameter
+
+`<String>` is a string of characters between double quotes `"`. It can include non-printable characters and be replaced by a string variable (also named as alphanumeric variable).
+
+## Examples
+
+```basic
+PRINT LEN("MSX")
+ 3
+A$="MSX":PRINT LEN(A$)
+ 3
+```
+
+## Related to
+
+`CALL KLEN`
+
+## Compatibility
+
+MSX-BASIC 1.0 or higher
+
+## Source
+
+Retrieved from "https://www.msx.org/wiki/LEN()"

package/resources/programming/basic_wiki/LET.md

@@ -0,0 +1,68 @@
+# LET
+
+## Effect
+
+Assigns a value to a specified variable. 
+
+_Note: Only the first two letters are taken into account as variable name, but different variable types and tables are considered different even if they have same name (please see the examples)._
+
+## Syntax
+
+`LET <Variable> = <Value>`
+
+The `LET` instruction itself is optional and can be skipped except if you use the _Exprif BASIC_ extension.
+
+## Parameters
+
+`<Variable>` is a numeric  or alphanumeric variable.
+
+`<Value>` is a numeric value or a character string (between quotation mark). It can be also an expression.
+
+## Examples
+
+```basic
+10 LET A=10
+20 LET B$="Hello"
+30 C=20
+40 D$="World!"
+50 CLS
+60 PRINT A;C
+70 PRINT
+80 PRINT B$;" "; D$
+
+RUN
+ 10 20
+
+Hello World!
+Ok
+```
+
+```basic
+10 SIZE=1:SIDE=2:SI=6
+20 PRINT SIZE
+
+RUN
+ 6
+Ok
+```
+
+```basic
+10 XY$="Values:":XY#=1:XY!=2:XY%=3:XY#(0)=4:XY!(0)=5:XY%(0)=6
+20 PRINT XY$;XY#;XY!;XY%;XY#(0);XY!(0);XY%(0)
+
+RUN
+Values: 1 2 3 4 5 6
+Ok
+```
+
+## Related to
+
+`DEFDBL`, `DEFINT`, `DEFSNG`, `DEFSTR`, `DIM`, `SWAP`
+
+## Compatibility
+
+MSX-BASIC 1.0 or higher
+
+## Source
+
+Retrieved from "https://www.msx.org/wiki/LET"

package/resources/programming/basic_wiki/LINE.md

@@ -0,0 +1,74 @@
+# LINE
+
+## Effect
+
+Draws a line or a rectangle between absolute or relative coordinates on a graphic screen (2 to 8, 10 to 12).
+
+## Syntaxes
+
+`LINE STEP(<X1>,<Y1>)-STEP(<X2>,<Y2>),<Color>,<Shape>,<Operator>`
+
+`LINE -STEP(<X2>,<Y2>),<Color>,<Shape>,<Operator>`
+
+_Notes:_
+- Parameters can not end with a comma alone.
+- Current cursor coordinates are used as starting coordinates with the second syntax.
+
+## Parameters
+
+`STEP` can be put before coordinates, to specify relative coordinates to the current cursor position. In this case the values can also be negative.
+
+`<X1>` is coordinate X of the starting point of the line (0-255/511).
+
+`<Y1>` is coordinate Y of the starting point of the line (0-191/211).
+
+When `<X1>` and `<Y1>` are omitted, the coordinates of the last drawn point are used as starting point.
+
+`<X2>` is coordinate X of the end point of the line (0-255/511).
+
+`<Y2>` is coordinate Y of the end point of the line (0-191/211).
+
+`<Color>` is the color to be used for drawing the line = 0 to 15 (screens 2 to 5, 7 and 10), 0 to 3 (screen 6), 0 to 255 (screens 8, 11, 12). If `<Color>` is not specified the current foreground color is used.
+
+`<Shape>` define the shape to draw. It can be `B` to draw an empty rectangle or `BF` for filled rectangle. A line is drawn when this parameter is omited.
+
+`<Operator>` is the logical operation to be performed between the color of the old pixel and the new color. This parameter can be used only on screens 5 to 8 and 10 to 12, it requires a MSX2 or higher computer.
+
+The available operators are `AND`, `OR`, `PRESET`, `PSET` (default), `TAND`, `TOR`, `TPRESET`, `TPSET`, `TXOR`, `XOR`. Specifying a logical operation preceded by "T" causes nothing to be done when specified color is transparent (color 0).
+
+The effect of the operators is done on each corresponding bit as shown in the following table.
+
+|Current bit|Copied color bit|AND|OR|PRESET|PSET|XOR|
+|:-:|:-:|:-:|:-:|:-:|:-:|:-:|
+|0|0|0|0|1|0|0|
+|0|1|0|1|0|1|1|
+|1|0|0|1|1|0|1|
+|1|1|1|1|0|1|0|
+
+## Examples
+
+```basic
+10 SCREEN 2
+20 FOR I=0 TO 95 STEP 2
+30 LINE (128-I,95-I)-(128+I,95+I),1,B
+40 NEXT
+50 GOTO 50
+```
+
+```basic
+10 SCREEN 7
+20 LINE (10,10)-(500,200),13,BF
+30 GOTO 30
+```
+
+## Related to
+
+`CIRCLE`, `COLOR`, `DRAW`, `PAINT`, `POINT`, `PRESET`, `PSET`, `SCREEN`
+
+## Compatibility
+
+MSX-BASIC 1.0 or higher
+
+## Source
+
+Retrieved from "https://www.msx.org/wiki/LINE"

package/resources/programming/basic_wiki/LINE_INPUT.md

@@ -0,0 +1,79 @@
+# LINE INPUT
+
+## Effect
+
+Retrieves a complete string from the keyboard or a sequential file, storing the input of maximum 254 characters into a variable.
+
+_Note: Contrary to `INPUT`, this instruction does not go to text screen mode when it is executed in a graphic screen mode but the input is not done correctly._
+
+## Syntaxes
+
+`LINE INPUT["<Prompt>";]<Variable>`
+
+`LINE INPUT#<FileNumber>,<Variable>`
+
+## Parameters
+
+`<Prompt>` is the text displayed to ask what you need to input, but contrary to `INPUT`, it is not followed by a question mark.
+
+`<Variable>` is a string variable that will take the input string.
+
+`<FileNumber>` is the number of file opened by `OPEN`.
+
+_Note: With this parameter and device `"CON"`, only the characters that has been typed will be retrieved, other characters on same input line will not be retrieved._
+
+## Examples
+
+```basic
+10 LINE INPUT "What is your favorite computer system ?";A$
+20 PRINT A$
+ 
+RUN
+What is your favorite computer system ?
+MSX
+```
+
+```basic
+10 OPEN "CAS:DATA" FOR INPUT AS #1
+20 IF EOF(1) THEN 40
+30 LINE INPUT#1,A$ : PRINT A$ : GOTO 20
+40 CLOSE#1 : END
+```
+
+```basic
+10 COLOR 15,4,4: SCREEN 2
+20 OPEN"con" FOR INPUT AS #1
+30 LINE INPUT#1,A$: CLOSE#1
+40 PSET(124-(LEN(A$)*4),92),4
+50 OPEN"grp:" AS #1
+60 PRINT#1,A$: CLOSE#1
+70 IF NOT STRIG(0)THEN 70 ' Press Space key to exit
+```
+
+## Data
+
+### Retrieved from keyboard
+
+The data retrieved from the keyboard are stored in only one value (not several values) and it's always a string (never a number).
+
+`LINE INPUT` accepts all types of characters. Only pressing the `RETURN/ENTER` key will specify the end of the string.
+
+### Read from sequential file
+
+The data read from a sequential file are stored in only one value (not several values) and it's always a string (never a number).
+
+`LINE INPUT` accepts all types of characters. Only a `RETURN` character is viewed as the end of a string.
+
+This instruction is very useful to read a MSX-BASIC program as datafile, if it was saved (by using the `SAVE` instruction) in ASCII text.
+
+## Related to
+
+`INPUT`, `INPUT$`, `OPEN`, `PRINT`, `SAVE`
+
+## Compatibility
+
+MSX-BASIC 1.0 or higher
+
+## Source
+
+Retrieved from "https://www.msx.org/wiki/LINE_INPUT"