@nataliapc/mcp-openmsx 1.1.15 → 1.2.2

package/resources/programming/basic_wiki/VPOKE.md

@@ -0,0 +1,48 @@
+# VPOKE
+
+## Effect
+
+Writes a value to a byte of the video memory (VRAM).
+
+## Syntax
+
+`VPOKE <Address>,<Value>`
+
+## Parameters
+
+`<Address>` must be in the range -32768 to 65535 (&H0000 to &HFFFF).
+
+On MSX1 the usable VRAM area is 0-16383.
+
+On MSX2 and up the usable VRAM area is 0-65535. In order to address all of the 128kB VRAM, `SET PAGE` instruction must be used. Please note that VRAM addressing is different (interleaved) in `SCREEN` modes 7, 8, 10, 11 and 12. However this is important to notice only if you switch between these two addressing modes between reading / writing.
+
+`<Value>` is a decimal number between 0 and 255.
+
+## Example
+
+```basic
+10 SC=PEEK(&HFCAF) ' Current screen mode (= 0/1 for text)
+11 A=ASC("!")*8+BASE(SC*5+2) ' VRAM address for "!"-font outlook
+12 FOR I=0 TO 7: READ D$: VPOKEA+I,VAL("&B"+D$): NEXT I
+13 'New look (Note: Two last columns are not in use in screen 0)
+14 DATA 00110000
+15 DATA 01111000
+16 DATA 01111000
+17 DATA 00110000
+18 DATA 00000000
+19 DATA 00110000
+20 DATA 00110000
+21 DATA 00000000
+```
+
+## Related to
+
+`BASE()`, `SCREEN`, `SET PAGE`, `VDP()`, `VPEEK()`
+
+## Compatibility
+
+MSX-BASIC 1.0 or higher
+
+## Source
+
+Retrieved from "https://www.msx.org/wiki/VPOKE"

package/resources/programming/basic_wiki/WAIT.md

@@ -0,0 +1,38 @@
+# WAIT
+
+## Effect
+
+Reads the specified I/O port and suspends the BASIC program execution until the result of value read at `<PortNumber> XOR <Value2> AND <Value1>` equals zero.
+
+## Syntax
+
+`WAIT <PortNumber>,<Value1>,<Value2>`
+
+_Note: Parameters can not end with a comma alone._
+
+## Parameters
+
+`<PortNumber>` is the I/O port to read until the operation equals 0.
+
+`<Value1>` is a value between 0 and 255. It can be a variable or an expression.
+
+`<Value2>` is a optional value between 0 and 255. It can be a variable or an expression. By default it is 0.
+
+## Example
+
+```basic
+10 ' Wait until user toggles CAPS LOCK on.
+20 WAIT 170,64,64
+```
+
+## Related to
+
+`AND`, `INP()`, `OUT`, `SOUND`, `VDP()`, `XOR`
+
+## Compatibility
+
+MSX-BASIC 1.0 or higher
+
+## Source
+
+Retrieved from "https://www.msx.org/wiki/WAIT"

package/resources/programming/basic_wiki/WIDTH.md

@@ -0,0 +1,76 @@
+# WIDTH
+
+## Effect
+
+Sets the number of columns on current or last used text mode.
+
+## Syntax
+
+`WIDTH <Columns>`
+
+## Parameter
+
+`<Columns>` is a value between 1 and 32/40/80. The highest value depends on the mode set with `SCREEN` or `CALL KANJI`, and the type of MSX used. Kanji modes don't accept a value lower than 26.
+
+|SCREEN|MSX type|Columns|
+|:--|:--|:-:|
+|0|MSX1 <sup>(*)</sup>|1-40|
+|0|MSX2 and higher <sup>(*)</sup>|1-80|
+|1|MSX1 and higher|1-32|
+|9|Korean MSX2|1-80|
+|KANJI0|Japanese MSX2+ and higher|26-64|
+|KANJI1|Japanese MSX2+ and higher|26-80|
+|KANJI2|Japanese MSX2+ and higher|26-64|
+|KANJI3|Japanese MSX2+ and higher|26-80|
+
+
+<sup>(*)</sup> Special case: the Yamaha CX5MII and CX5MII/128 are MSX1 computers with an additional ROM allowing to use the 80 column text mode.
+
+### Default values
+
+The default values according the MSX.
+
+|SCREEN|Machines|Default width|
+|:-:|:--|:--|
+|0|Ascii One Chip MSX (improved)|80|
+|0|Ascii One Chip MSX (original)|40|
+|0|Brazilian Ciel and Sharp machines|39|
+|0|Most Brazilian Gradiente machines|40|
+|0|Most European machines|37|
+|0|Japanese, Korean and Russian machines|39|
+|1|All machines|29|
+|9|Korean MSX2 computers|80|
+|9|Korean MSX2 consoles|29 (takes the width of previous text mode)|
+|KANJI0|Japanese MSX2+ and higher|29 (takes the width of previous text mode until the limit possible)|
+|KANJI1|Japanese MSX2+ and higher|39 (takes the width of previous text mode until the limit possible)|
+|KANJI2|Japanese MSX2+ and higher|29 (takes the width of previous text mode until the limit possible)|
+|KANJI3|Japanese MSX2+ and higher|39 (takes the width of previous text mode until the limit possible)|
+
+_Note: On MSX2 and higher machines, the instruction `SET SCREEN` saves the current parameter for screen 0 and 1; it's not possible to save this parameter for the Kanji modes.  When you restart the MSX the saved parameter is used as default value. On Korean MSX2 the Hangul mode is kept only if `SET SCREEN` is executed in this mode._
+
+## Examples
+
+```basic
+10 SCREEN 0: SCREEN 2
+20 WIDTH 39: END
+```
+```basic
+10 SCREEN 1: SCREEN 2
+20 WIDTH 39: END
+```
+
+_Note: The second example causes an "Illegal function call" error._
+
+## Related to
+
+`CALL KANJI`, `SCREEN`, `SET SCREEN`
+
+## Compatibility
+
+MSX-BASIC 1.x
+
+MSX-BASIC 2.0 or higher according the parameter.
+
+## Source
+
+Retrieved from "https://www.msx.org/wiki/WIDTH"

package/resources/programming/basic_wiki/XOR.md

@@ -0,0 +1,72 @@
+# XOR
+
+## Effect
+
+Performs a bitwise XOR-operation (logical exclusive or) between two expressions.
+
+The bit is set if one bit is set and the other one isn't:
+```
+0 XOR 0  =  0 
+0 XOR 1  =  1 
+1 XOR 0  =  1 
+1 XOR 1  =  0 
+```
+
+## Syntax
+
+`<Value> XOR <Value>`
+
+## Parameter
+
+`<Value>` is a value between -32768 and 32767. It can also be a a numeric variable, a mathematical expression or expression from a condition.
+
+_Notes:_
+- If you use binary expressions, it is best to put the first expression in parenthesis to avoid the bug in interpreter that causes a syntax error. This problem does not happen with decimal, hexadecimal or octal expressions.
+- When the expression performed in a condition (`IF...THEN...ELSE` or `IF...GOTO...ELSE`) if the result of the whole expression is zero the value is taken as false, otherwise it's taken as true.
+
+## Examples
+
+```basic
+PRINT 15 XOR 11
+4
+```
+Binary explanation:
+```
+1111 
+1011  XOR
+----
+0100
+```
+---
+```basic
+PRINT 5 XOR 13
+8
+```
+Binary explanation:
+```
+0101 
+1101  XOR
+----
+1000
+```
+---
+```basic
+PRINT &B00001111 XOR &B11110001
+15
+Syntax error
+Ok
+PRINT (&B00001111) XOR &B11110001
+254
+```
+
+## Related to
+
+`AND`, `EQV`, `IMP`, `MOD`, `NOT`, `OR`
+
+## Compatibility
+
+MSX-BASIC 1.0 or higher
+
+## Source
+
+Retrieved from "https://www.msx.org/wiki/XOR"