@nataliapc/mcp-openmsx 1.1.14 → 1.2.2

package/resources/programming/basic_wiki/CALL_PCMREC.md

@@ -0,0 +1,70 @@
+# CALL PCMREC
+
+## Effect
+
+Records a PCM audio file by using the built-in microphone of the _MSX turbo R_ computers. It can be done to computer RAM, computer VRAM or an array.
+
+If the computer mode is _Z80_ mode, the mode is automatically switched to the _R800_ mode before the execution, and after finishing the _Z80_ mode is restored.
+
+If the _STOP_ key is pushed during the recording, the program execution is quit and returns to BASIC.
+
+## Syntaxes
+
+`CALL PCMREC(@<StartAddress>, <EndAddress>, <SamplingFrequency>,<TriggerLevel>,<CompressionSwitch>,S)`
+
+The three last parameters are optional. Parameters can not end with a comma alone.
+
+`CALL PCMREC(<Array>,<Length>,<SamplingFrequency>,<TriggerLevel>,<CompressionSwitch>])`
+
+`<Length>` and the two last parameters are optional. Parameters can not end with a comma alone.
+
+## Parameters
+
+`<StartAddress>` and `<EndAddress>` are used to specify the area of the computer RAM (or VRAM). The `<start address>` needs always to be preceded by `@`.
+
+`<SamplingFrequency>` is a number between 0 and 3 to choose one of the four available sampling frequencies:
+```
+ 0 = 15.75 KHz
+ 1 = 7.875 KHz
+ 2 = 5.25 KHz
+ 3 = 3.9375 KHz
+```
+
+If you specify the sampling rate to 15.75 KHz under `Z80` mode or `R800` ROM mode, you get _"Illegal function call"_ error message.
+
+`<TriggerLevel>` is a number between 0 and 127 to specify the required input level to start the recording.  If this is omitted or is 0, the recording is started immediately.
+
+`<CompressionSwitch>` allows to enable or disable the silent data compression: data format is absolutely binary and 1 to 255 is normal data. When two or more data near the 0 level (126 to 128) are consecutive, the data can be compressed by recording a 0 and count of the consecutive data.
+
+```
+ 0 (default value) = no silent data compression
+ 1 = silent data compression
+```
+
+The parameter `S` is used to record to VRAM instead of RAM -  This can be done in any screen mode but only the active pages are valid when the screen mode is higher than 4.
+
+`<Array>` must be a numeric type variable array.
+
+`<Length>` can generally be omitted. When specified, the recording to an array will be stopped when this length is reached.
+
+_Note: To save the PCM audio file to disk, you need to use `BSAVE` when you have recorded it to computer RAM or VRAM, or COPY when you have recorded it to an array._
+
+## Example
+
+```basic
+10 CLEAR 300,&HB000
+20 CALL PCMREC(@&HB000,&HDFFF,1,32,1)
+30 BSAVE"PCMTEST.BIN",&HB000,&HDFFF
+```
+
+## Related to
+
+`BSAVE`, `CALL PCMPLAY`, `COPY`
+
+## Compatibility
+
+MSX-BASIC 4.0 or higher
+
+## Source
+
+Retrieved from "https://www.msx.org/wiki/CALL_PCMREC"

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

@@ -0,0 +1,36 @@
+# CDBL()
+
+## Effect
+
+Converts a integer or single precision value to a double precision value. Double precision numbers have an accuracy of 14 digits. This function exists for compatibility reasons only and has no practical benefits in MSX environment.
+
+## Syntax
+
+`CDBL(<Value>)`
+
+## Parameter
+
+`<Value>` can be a value, a numeric variable or an mathematical expression.
+
+## Example
+
+```basic
+10 PRINT "7 divided by 6 is ";CDBL(7/6)
+20 PRINT "10 divided by 11 ";CDBL(10/11)
+ 
+RUN
+7 divided by 6 is 1.1666666666667
+10 divided by 11 is .90909090909091
+```
+
+## Related to
+
+`CINT`, `CSNG`
+
+## Compatibility
+
+MSX-BASIC 1.0 or higher
+
+## Source
+
+Retrieved from "https://www.msx.org/wiki/CDBL()"

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

@@ -0,0 +1,51 @@
+# CHR$()
+
+## Effect
+
+Converts a value to the corresponding MSX character.
+
+## Syntax
+
+`CHR$(<CodeNumber>)`
+
+_Notes:_
+- Used in instruction `PRINT` you can display 32 extended graphic characters by adding `CHR$(1)` before the character with a code number between 64 and 95. (see example below for use and see this page for details of codes).
+- It can be combined with `INKEY$` to detect if a specific key has been pressed; it's useful not only for the alphanumeric keys, but also the special keys.
+
+## Parameter
+
+`<CodeNumber>` is the code number of a character between 0 and 255. (See this page about codes description).
+
+According the localisation of the used MSX computer or the used mode on Arabic machines, the results can vary.
+
+_Note: In Kanji modes, this instruction is limited to the characters 33 to 128, 161 to 223, 253 and 254, and the character displayed for `CHR$(128)`, `CHR$(253)` and `CHR$(254)` is not correct in Kanji modes 0 and 2 (bug in Kanji BASIC?)_
+
+## Examples
+
+```basic
+10 PRINT "The character with ASCII code 67 is ";CHR$(67)
+20 PRINT "I like ";CHR$(77);CHR$(83);CHR$(88)
+ 
+RUN
+The character with ASCII code 67 is B
+I like MSX
+```
+```basic
+5 'How to print an extended graphic character
+10 PRINT CHR$(1);CHR$(65);
+20 PRINT CHR$(1)+CHR$(66)
+```
+
+The printed character will be a smiling face on European machines and a kana on Japanese machines.
+
+## Related to
+
+`ASC()`, `INKEY$`, `PRINT`, `STRING$()`
+
+## Compatibility
+
+MSX-BASIC 1.0 or higher
+
+## Source
+
+Retrieved from "https://www.msx.org/wiki/CHR$()"

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

@@ -0,0 +1,36 @@
+# CINT()
+
+## Effect
+
+Converts a value to an integer number by truncating the numbers after the decimal point.
+
+## Syntax
+
+`CINT(<Value>)`
+
+## Parameter
+
+`<Value>` must be an expression, a numeric variable or a value between -32768 and 32767. Digits after the decimal point will be simply ignored.
+
+## Example
+
+```basic
+10 PRINT "1.23 converted to integer is ";CINT(1.23)
+20 PRINT "1.99 converted to integer is ";CINT(1.99)
+ 
+RUN
+1.23 converted to integer is 1
+1.99 converted to integer is 1
+```
+
+## Related to
+
+`CDBL`, `CSNG`, `FIX`, `INT`
+
+## Compatibility
+
+MSX-BASIC 1.0 or higher
+
+## Source
+
+Retrieved from "https://www.msx.org/wiki/CINT()"

package/resources/programming/basic_wiki/CIRCLE.md

@@ -0,0 +1,51 @@
+# CIRCLE
+
+## Effect
+
+Draws a circle, arc or ellipse on a graphic screen (2 to 8, 10 to 12).
+
+## Syntax
+
+`CIRCLE STEP(<X>,<Y>),<Radius>,<Color>,<TracingStart>,<TracingEnd>,<Aspect>`
+
+_Note: Do not put a comma if no parameters are behind._
+
+## Parameters
+
+`<X>` is coordinate X of the centre of the circle (0-255/511).
+
+`<Y>` is coordinate Y of the centre of the circle (0-191/211).
+
+Coordinates cannot be omitted.
+
+If `STEP` is used before these coordinates, they are interpreted relative to the current cursor position. In this case the values can also be negative.
+
+`<Radius>` is the radius of the biggest main axis.
+
+`<Color>` is the color to be used = 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.
+
+`<TracingStart>` and `<TracingEnd>` are used to draw a partial circle. These values must be between 0 and 2π. By default, the tracing starts at 0 (the point at the extreme left of the circle) and the tracing ends at 2π (by turning clockwise). Using negative value will cause line to be drawn from end of arch to midpoint.
+
+`<Aspect>` is used to define the ratio between the horizontal and vertical radius. The results of "aspect ratio" will be different depending on your screens refresh frequency, 50 Hz (PAL) or 60 Hz (NTSC). This difference is generally not supported in the emulators.
+
+## Example
+
+```basic
+10 SCREEN 2
+20 CIRCLE (127,95),50,,,,1.4
+30 GOTO 30
+```
+
+It will draw a circle on a 50 Hz computer and an ellipse on a 60 Hz computer.
+
+## Related to
+
+`CLS`, `COLOR`, `DRAW`, `LINE`, `PAINT`, `POINT`, `PRESET`, `PSET`, `SCREEN`
+
+## Compatibility
+
+MSX-BASIC 1.0 or higher
+
+## Source
+
+Retrieved from "https://www.msx.org/wiki/CIRCLE"

package/resources/programming/basic_wiki/CLEAR.md

@@ -0,0 +1,39 @@
+# CLEAR
+
+## Effect
+
+Clears the contents of all variables, including functions defined with `DEF FN`, and all dimensions of arrays, sets all numeric variables to zero, all strings to null, closes all open files, and frees up memory.
+
+Optionally reserves a specified number of bytes for storing string variables in a program and/or defines the highest memory location that may be used by MSX-BASIC.
+
+After execution, you can check the result of the first parameter with `PRINT FRE("")` and the new available free space memory for MSX-BASIC with `PRINT FRE(0)`.
+
+## Syntax
+
+`CLEAR <StringsArea>,<UpperAddress>`
+
+_Note: Parameters can not end with a comma alone._
+
+## Parameters
+
+`<StringsArea>` is the amount of bytes to be reserved for storing string variables. (200 by default).
+
+`<UpperAddress>` is the highest memory location that may be used by MSX-BASIC. This address can vary between 831Fh and F380h. It is stored into variable system `HIMEM` (FC4Ah).
+
+## Example
+
+`CLEAR 300, &HC000`
+
+**PLEASE NOTE:** MSX1 has a bug that allows string space to be exceeded by a byte. This problem can be fixed by adding another `CLEAR` instruction without parameters after the actual `CLEAR` instruction.
+
+## Related to
+
+`DEF FN`, `DIM`, `END`, `ERASE`, `FN`, `FRE`, `MAXFILES`, `NEW`
+
+## Compatibility
+
+MSX-BASIC 1.0 or higher
+
+## Source
+
+Retrieved from "https://www.msx.org/wiki/CLEAR"

package/resources/programming/basic_wiki/CLOAD.md

@@ -0,0 +1,27 @@
+# CLOAD
+
+## Effect 
+
+Loads a BASIC program from cassette if this program has been saved in tokenized mode with `CSAVE`.
+
+## Syntax
+
+`CLOAD "<Filename>"`
+
+## Parameter
+
+`"<Filename>"` is the name of the BASIC program to be loaded. When not specified, `CLOAD` will load the first or next BASIC program in tokenized mode found on tape. `"<Filename>"` can be replaced by a alphanumeric variable containing the name.
+
+The format of file name is case sensitive and limited to 6 characters without extension.
+
+## Related to
+
+`CLOAD?`, `CSAVE`, `LOAD`, `RUN`, `SAVE`
+
+## Compatibility
+
+MSX-BASIC versions before 4.0
+
+## Source
+
+Retrieved from "https://www.msx.org/wiki/CLOAD"

package/resources/programming/basic_wiki/CLOAD?.md

@@ -0,0 +1,31 @@
+# CLOAD?
+
+## Effect
+
+Verifies whether or not a BASIC file has been successfully saved to cassette with `CSAVE` in tokenized format. This instruction compares the program in memory with the program on tape and searches for differences.
+
+## Syntax
+
+`CLOAD?["<Filename>"]`
+
+## Parameter
+
+`"<Filename>"` is the specific name of the BASIC program to be verified. When not specified, `CLOAD?` will verify the first or next BASIC program in tokenized mode found on tape.
+
+The format of file name is case sensitive and limited to 6 characters without extension.
+
+## Example
+
+`CLOAD?("test")`
+
+## Related to
+
+`CLOAD`, `CSAVE`
+
+## Compatibility
+
+MSX-BASIC versions before 4.0
+
+## Source
+
+Retrieved from "https://www.msx.org/wiki/CLOAD%3F"

package/resources/programming/basic_wiki/CLOSE.md

@@ -0,0 +1,44 @@
+# CLOSE
+
+## Effect
+
+Closes one or more opened files and frees corresponding I/O buffer(s). 
+
+## Syntax
+
+`CLOSE #<Number1>,#<Number2>...`
+
+_Note: Parameters can not end with a comma alone._
+
+## Parameters
+
+`#` is optional and can be omitted.
+
+`<Number1>`, `<Number2>`... correspond to the numbers assigned to the files opened with the `OPEN` instruction.
+
+Without using parameters, all opened files are closed.
+
+If it concerns a file opened on a linked computer, the `EOF` character is sent.
+
+## Example
+
+```basic
+10 MAXFILES=2
+20 OPEN "CAS:DEMO" FOR INPUT AS #1
+30 OPEN "LPT:" FOR OUTPUT AS #2
+40 INPUT #1,A$
+50 PRINT #2,A$
+60 CLOSE #1,#2
+```
+
+## Related to
+
+`CLEAR`, `END`, `EOF`, `MAXFILES`, `OPEN`
+
+## Compatibility
+
+MSX-BASIC 1.0 or higher
+
+## Source
+
+Retrieved from "https://www.msx.org/wiki/CLOSE"

package/resources/programming/basic_wiki/CLS.md

@@ -0,0 +1,51 @@
+# CLS
+
+## Effect
+
+Clears the screen in any 'standard' screen mode with the last background color specified and resets the cursor coordinates for text.
+
+When used with _Delta BASIC_, it can also clear the content of a window.
+
+_Notes:_
+- In text mode, the text of function keys displayed by `KEY ON` stays on screen.
+- The sprites stay on screen as is.
+- To clear the screen in `KANJI` text modes, you need to use `CALL CLS`. This command can also be useful in `SCREEN 9` when the screen is not correctly cleared with `CLS`.
+
+## Syntaxes
+
+`CLS`
+
+`CLS #<WindowNumber>` (only with _Delta BASIC_) - As alternative, you can also use `FILL#<WindowNumber>,32`
+
+## Parameter (Delta BASIC)
+
+`<WindowNumber>` is a number between 1 and 9. It must always be preceded by `#` and correspond to a window previously defined with the `WINDOW` instruction.
+
+## Example (Delta BASIC)
+
+```basic
+10 SCREEN0:KEYOFF:WIDTH40
+20 WINDOW#1,1,1,38,3
+30 WBOX#1
+40 FILL#1,78
+50 FOR I=1 TO 100: NEXT I
+60 CLS#1
+```
+
+`CLS#1` can be replaced by `FILL#1,32`
+
+## Related to
+
+Standard instruction: `CALL CLS`, `COLOR`, `KEY`, `SCREEN`
+
+Delta BASIC: `FILL`, `WINDOW`
+
+## Compatibility
+
+MSX-BASIC 1.0 or higher
+
+Delta BASIC
+
+## Source
+
+Retrieved from "https://www.msx.org/wiki/CLS"

package/resources/programming/basic_wiki/COLOR.md

@@ -0,0 +1,143 @@
+# COLOR
+
+# Effect
+
+Changes the color(s) to be used for the foreground, background and border.
+
+_Notes:_
+- If you use `COLOR` after `SCREEN`, you need to use `CLS` after `COLOR` on a graphic screen to initialize it with the new colors.
+- For screens 0 to 5, 7, 9 and 10, it's useful to use `COLOR` before switching to the desired screen with `SCREEN`.
+- For the Kanji text modes, it's useful to use `COLOR` before switching to the desired screen with `CALL KANJI`.
+- For screen 6, using of the border colors 16 to 31 is only possible after the `SCREEN 6` instruction.
+- For screens 8, 11, and 12, `COLOR` must be used after `SCREEN` when you want to use colors higher than 15.
+- When all parameters are omitted on MSX2 or higher, the effect will be the same as `COLOR=NEW`, except in Kanji text mode. The color palette will be initialized.
+
+## Syntax
+
+`COLOR <ForegroundColor>,<BackgroundColor>,<BorderColor>`
+
+_Notes:_
+- It's possible to 'skip' a color by using just a comma. Each parameter is optional except the last specified. Do not put a comma after this parameter.
+- `COLOR` without any parameter on MSX1 results to _"Missing parameter"_ error. On MSX2 and up it has same functionality as `COLOR=NEW` (see `COLOR=`).
+
+## Parameters
+
+`<ForegroundColor>` is the color used for the text or the drawing in graphic modes. This parameter can be omitted on MSX1 only if another parameter is placed behind it.
+
+`<BackgroundColor>` is the color used for the background.  By default in text screen modes, background of all screen changes. In graphic modes, the parameter seems to have not effect but it will be taken in account when returning to another screen mode. 
+
+`<BorderColor>` is the color used for the borders (top, bottom, left, right) of the screen. There are no borders in screen 0, so if you use this parameter in screen 0, it seems to have not effect but il will be taken in account when going to another screen mode.
+
+Remarks about using of `COLOR` when you are in a Kanji text mode:
+- the text displayed before the execution of `COLOR` does not switch to the new color specified as `<ForegroundColor>`.
+- the background color displayed before the execution of `COLOR` does not change when specifying a new `<BackgroundColor>`, only the background of the new texts are changed, but the new color is also applied to he border color and the keylist (check it by pressing SHIFT!). Besides, the cursor will be displayed in another color, different from the foreground color, and that will vary depending on the general background color.
+- if you specify a new `<BorderColor>`, it seems to have not effect but the new color will be taken in account when returning to another screen mode.
+- to change the general background color, you need to enter `COLOR ,<BackgroundColor>: CALL CLS`.
+
+Value of each color can vary and depends from the mode set with `SCREEN` or `CALL KANJI`/`CALL ANK`.
+
+|SCREEN|COLOR|
+|---|---|
+|0-5|0 - 15|
+|6<sup>(*)</sup>|0 - 31|
+|7|0 - 15|
+|8|0 - 255|
+|9-10|0 - 15|
+|11-12|0 - 255|
+|KANJI0-3|0 - 15|
+
+<sup>(*)</sup> See below for the specific working of `COLOR` in this screen.
+
+The palette of colors 0 to 15 can be altered with the `COLOR=` instruction in all screen modes except screens 8, 11, 12. To alter MSX color palette in `KANJI` text modes, you need to use `CALL PALETTE`.
+
+## Examples
+
+```basic
+COLOR 1, 13, 5
+```
+```basic
+COLOR 10
+```
+```basic
+COLOR ,,13
+```
+```basic
+10 SCREEN 8: COLOR 100,150,200
+20 GOTO 20
+```
+
+## Specific working of COLOR in SCREEN 6
+
+`SCREEN 6` uses only 4 colors (0-3). The default MSX palette for these colors is used if other palette is not defined. (See `COLOR=` command).
+
+In case color number 0-15 is used, only bits 0 and 1 of VDP Control Register 7 will have effect, what implies these correspondances:
+- color 0 = color 4 = color 8 = color 12
+- color 1 = color 5 = color 9 = color 13
+- color 2 = color 6 = color 10 = color 14
+- color 3 = color 7 = color 11 = color 15
+
+Border color in `SCREEN 6` has colors defined for odd and even pixels independently. This color encoding method is generated in order to implement high resolution sprites. When using `COLOR` command in `SCREEN 6` BASIC expects that you want to define both colors at a same time and uses bits 0 and 1 for color number.
+
+This can be prevented by setting bit 4 of VDP Control Register 7 to 1 (using color values 16-31). In this case bits 0 and 1 will set color for odd pixels and bits 2 and 3 will set color for even pixels. Note also that bit 4 status is not stored and when screen mode changes the border color is not converted, but native 4 bit border color representation is always used as is.
+
+## Specific working of COLOR in SCREEN 8
+
+The colors in SCREEN 8 are fixed in a binary format &B11111111 where:
+- the highest three bits are for R (red)
+- the next three bits are for G (green)
+- the lowest two bits are for B (blue)
+
+Use this formula for the color code in decimal format:  
+```
+Color code = 32 x (Green intensity) + 4 x (Red intensity) + (Blue intensity)
+```
+
+with :
+- Green intensity: an integer from 0 to 7
+- Red intensity: an integer from 0 to 7
+- Blue intensity: an integer from 0 to 3
+
+## Default values
+
+### SCREEN 0 to 5 and 7 
+
+|Machines|Foreground|Background|Border|
+|---|:-:|:-:|:-:|
+|Arabic MSX1 <sup>(*)</sup> booting in Arabic mode|15 - white|4 - dark blue|7 - sky blue|
+|Arabic MSX1/2 booting in European mode|15 - white|4 - dark blue|4 - dark blue|
+|Arabic Sakhr MSX2|15 - white|4 - dark blue|4 - dark blue <sup>(**)</sup>|
+|Brazilian Ciel MSX2+|15 - white|4 - dark blue|7 - sky blue|
+|Brazilian Gradiente MSX|15 - white|1 - black|1 - black|
+|Brazilian Sharp MSX|15 - white|4 - dark blue|4 - dark blue|
+|Daewoo CPC-300/300E MSX2|15 - white|4 - dark blue|7 - sky blue|
+|Daewoo CPC-400/400S MSX2|15 - white|4 - dark blue|4 - dark blue|
+|European and Russian MSX/MSX2|15 - white|4 - dark blue|4 - dark blue|
+|Frael Bruc MSX|1 - black|13 - magenta|13 - magenta|
+|Japanese MSX/MSX2/MSX2+/MSXturboR|15 - white|4 - dark blue|7 - sky blue|
+|Korean MSX computers and MSX2 consoles|15 - white|4 - dark blue|7 - sky blue|
+|Korean MSX consoles|15 - white|1 - black|1 - black|
+
+<sup>(*)</sup> also Bawareth Perfect MSX2.  
+<sup>(**)</sup> "forced" to 7 when using `CALL DCOLOR`.
+
+### KANJI text modes
+
+When using the command `CALL KANJI`, the foreground and background colors of previously used mode (especially `SCREEN 0`, `SCREEN 1` and `SCREEN 9`) are directly transferred to the KANJI text mode and the background color is also used for the border.
+
+### How to change the default values
+
+On MSX2 and higher machines, you can change these default values by using first `COLOR`, then `SET SCREEN` to save the new parameters in the Real Time Clock (RTC). It is not possible to change the default values for the Japanese KANJI text modes.
+
+If you use `SET SCREEN` when you are on `SCREEN 9`, the computer will display the MSX-BASIC screen after booting in `SCREEN 9` instead of `SCREEN 0` or `1`; the parameters of the other screens, especially `SCREEN 0` and `SCREEN 1`, will also be modified.
+
+## Related to
+
+`CALL CLS`, `CALL DCOLOR`, `CALL KANJI`, `CALL PALETTE`, `CLS`, `COLOR=`, `SCREEN`, `SET SCREEN`
+
+# Compatibility 
+
+MSX-BASIC 1.0 or higher
+
+## Source
+
+Retrieved from "https://www.msx.org/wiki/COLOR"

package/resources/programming/basic_wiki/COLOR=.md

@@ -0,0 +1,93 @@
+# COLOR=
+
+## Effect
+
+Alters MSX color palette, loads default color palette or restores color palette from VRAM. It can be used in all screen modes, but has no visual effect in `SCREEN 8`.
+
+_Remark: To alter MSX color palette in KANJI text modes, you need to use `CALL PALETTE`._
+
+## Syntaxes
+
+`COLOR = (<Color>,<RedLuminance>,<GreenLuminance>,<BlueLuminance>)`  
+`COLOR = NEW`  
+`COLOR = RESTORE`
+
+_Note: No parameter can be omitted._
+
+## Parameters
+
+`<Color>` is a number between 0 and 15. It can be a numerical constant variable, an array variable or an expression.
+
+_Note that color 0 is a transparent color, it means that border space is seen transparently - to handle it as a 'normal' color, you need to use `VDP(9)=VDP(9) OR &H20` (back to transparent feature with `VDP(9)=VDP(9) AND &HDF`)._
+
+`<RedLuminance>`, `<GreenLuminance>` and `<BlueLuminance>` are numbers between 0 and 7.
+
+`NEW` allows to load the default MSX color palette, as it was when you turn on the computer. It can be a good idea to place this statement at the beginning and the end of your program.
+
+`RESTORE` allows to restore the color palette from VRAM, for example when it has been stored by a graphic program.
+
+If you `BSAVE` with `,S` option, you can save the contents of VRAM to the disk along with color palette infos. If you `BLOAD` with `,S` option, you can load such palette data to VRAM, but there are not yet any changes to the actually displayed colors. If you execute `COLOR=RESTORE`, you can display the picture in the same colors at the time you saved with `BSAVE` `,S`.
+
+## Examples
+
+```basic
+COLOR=(7,4,3,5)
+```
+```basic
+10 SCREEN 2
+20 BLOAD "BOX",S
+30 COLOR=RESTORE
+40 GOTO 40
+```
+
+## Default palette
+
+|Color|R|G|B|
+|-----|:-:|:-:|:-:|
+|0|0|0|0|
+|1|0|0|0|
+|2|1|6|1|
+|3|3|7|3|
+|4|1|1|7|
+|5|2|3|7|
+|6|5|1|1|
+|7|2|6|7|
+|8|7|1|1|
+|9|7|3|3|
+|10|6|6|1|
+|11|6|6|4|
+|12|1|4|1|
+|13|6|2|5|
+|14|5|5|5|
+|15|7|7|7|
+
+## Storage of palette in VRAM
+
+MSX-BASIC stores/restores palette to/from VRAM, but the address is different for each screen mode. The palette is stored in VDP native format: `(R*16+B, G)`.
+
+Here is list of addresses for each mode:
+
+|SCREEN|Decimal|Hexadecimal|
+|---|:-:|:-:|
+|0, WIDTH 40|1024|0400|
+|0, WIDTH 80|3840|0F00|
+|1|8224|2020|
+|2|7040|1B80|
+|3|8224|2020|
+|4|7808|1E80|
+|5-6|30336|7680|
+|7-8|64128|FA80|
+|9|30336|7680|
+|10-12|64128|FA80|
+
+## Related to
+
+`CALL PALETTE`, `COLOR`, `SCREEN`, `SET PAGE`, `WIDTH`
+
+## Compatibility
+
+MSX-BASIC 2.0 or higher
+
+## Source
+
+Retrieved from "https://www.msx.org/wiki/COLOR%3D"