EDIT.MAP

The EDIT.MAP command modifies a character map.

Format

EDIT.MAP name

where

name	is the name of the map to be modified.

This command performs a closely related function on ECS and non-ECS systems but the latter has reduced capability.

EDIT.MAP on ECS Mode Systems

This command allows an application developer to modify an ECS character map. The standard BASE map cannot be modified.

If the named map does not exist, the EDIT.MAP command will prompt to confirm that a new map is to be created and then ask for the name of the map that is to be used as the starting point, defaulting to the BASE map.

The format of data displayed by this command is as below:

Codept Char A N G S W Z Uppercase.. Lowercase.. Sort Trans...

>U+004C L Y . Y . . . U+004C L U+006C l 004C 00 00 .

U+004D M Y . Y . . . U+004D M U+006D m 004D 00 00 .

U+004E N Y . Y . . . U+004E N U+006E n 004E 00 00 .

U+004F O Y . Y . . . U+004F O U+006F o 004F 00 00 .

U+0050 P Y . Y . . . U+0050 P U+0070 p 0050 00 00 .

U+0051 Q Y . Y . . . U+0051 Q U+0071 q 0051 00 00 .

U+0052 R Y . Y . . . U+0052 R U+0072 r 0052 00 00 .

U+0053 S Y . Y . . . U+0053 S U+0073 s 0053 00 00 .

U+0054 T Y . Y . . . U+0054 T U+0074 t 0054 00 00 .

...etc...

EDIT.MAP on Non-ECS Mode Systems

This command allows an application developer to create or modify a character map that can be used to replace the default mapping.

If the named map does not exist, the EDIT.MAP command will prompt to confirm that a new map is to be created and then ask for the name of the map that is to be used as the starting point.

The format of data displayed by this command is as below:

Codept Char A N G S Z Uppercase Lowercase Sort

>U+4C L Y . Y . . U+4C L U+6C l 4C

U+4D M Y . Y . . U+4D M U+6D m 4D

U+4E N Y . Y . . U+4E N U+6E n 4E

U+4F O Y . Y . . U+4F O U+6F o 4F

U+50 P Y . Y . . U+50 P U+70 p 50

U+51 Q Y . Y . . U+51 Q U+71 q 51

U+52 R Y . Y . . U+52 R U+72 r 52

U+53 S Y . Y . . U+53 S U+73 s 53

U+54 T Y . Y . . U+54 T U+74 t 54

...etc...

Using EDIT.MAP (All Systems)

The columns of this display are:

Codept

The code point value for the character described by this line. This is shown as a hexadecimal value prefixed with "U+".

Char	The actual character. This will only be displayed correctly if the terminal device supports the character.

A	Set to Y of this character is alphabetic.

N	Contains the numeric value for characters that represent digits.

G	Set to Y if this character is a graphic (printing) character.

S	Set to Y if this character is whitespace (space, tab, etc).

W	Set to Y if this is a double width character (ECS mode systems only).

Z	Set to Y if this is character has the user defined attribute set. See IS.USER.CHAR().

Uppercase

The code point value and character that should be returned by the QMBasic UPCASE() function.

Lowercase

The code point value and character that should be returned by the QMBasic DOWNCASE() function.

Sort	The sort weight of this character as a hexadecimal value.

Trans

Transliteration character(s) for 8-bit representation of data (ECS mode systems only).

The currently selected character is shown by a > marker at the left of the line.

There is a command prompt line under the displayed data. The commands and special keys available are:

CLEAR.ALL x		Clear character type attribute x from all characters
EXPORT path		Export map to path
HELP	F1	Display help text
IMPORT path		Import map changes from path
QUIT or Q		Exist from the character map editor.
SAVE		Save changes. Users of the map being edited will see the changes immediately.
SEQ	F4	Toggle sort order. The characters are shown initially in code point value order. This command toggles an alternative display in which the characters are shown in sort order.
SORT		Amend sort order (see below).
U+nnnn		Position on the character with the given code point value. On non-ECS systems, this is two digits.
blank line		Edit the attributes of the selected character (see below).
	Cursor down	Select the next character on the page.
	Cursor up	Select the previous character on the page.
	Page down	Move to the next page.
	Page up	Move to the previous page.

Editing Character Attributes

The character attributes of the selected character can be edited by entering a blank line at the command prompt to highlight the character. Then use any of the following to amend the attributes:

A	Toggle alphabetic attribute.

0 - 9

Set digit attribute with the given numeric value assigned to the character.

N	Clear numeric attribute.

G	Toggle graphic attribute.

L	Set lowercase character pairing. The L key should be followed by the character to be assigned as the lower case equivalent of the selected character.

S	Toggle space attribute.

T	Set transliteration character (ECS mode systems only). The T key should be followed by one or two 8-bit character(s) to be used for transliteration and the Return key. Return alone removes transliteration.

U	Set uppercase character pairing. The U key should be followed by the character to be assigned as the upper case equivalent of the selected character.

W	Toggle wide character attribute (ECS mode systems only).

Z	Toggle user defined character attribute (ECS mode systems only).

When all attributes that are to be changed have been amended, press the return key to exit from this mode.

For operations that require entry of a character (e.g case pairing), this may be entered by use of the escape key followed by its four (ECS) or two (non-ECS) digit hexadecimal codepoint value. This is particularly useful when a character is required that is not present on the keyboard in use.

Amending the Sort Order

The sort order is amended by entering SORT at the EDIT.MAP command prompt. Then enter a series of characters (not their codepoint values) in the desired sort order. The first character in this list acts as an index point in the sort sequence. The remaining characters will be moved from their previous positions to immediately follow the index point. For example, to reverse the sort order of the letters A to E, type

SORT

EDCBA

Importing Map Changes

The IMPORT command reads a text file from the given pathname and applies changes to the map. Each line of this file represents changes to a single codepoint in the form

0054 A=1, LC=0074

where the first item is the hexadecimal codepoint value of the entry to be modified followed by at least one space and a series of comma separated items that modify character attributes or case pairings. Items not specified retain their existing values. The items allowed are:

A=n	Set or clear alphabetic status (n = 0 to clear, 1 to set).

G=n	Set or clear graphic status.

LC=nnnn

Set lowercase pair as codepoint nnnn.

N=0	Clear numeric status.

N=1:n

Set numeric status with digit value n.

S=n	Set or clear space status.

T=	Clear transliteration.

T=nn	Set transliteration as single 8-bit character with hexadecimal value nn

T=nn nn

Set transliteration as two 8-bit characters with hexadecimal values nn nn

W=n	Set or clear double width character status.

UC=nnnn

Set uppercase pair as codepoint nnnn.

Z=n	Set or clear user defined status.

Blank lines and lines beginning with a # symbol are ignored. The IMPORT command does not provide a way to modify the sort order.

In all cases, codepoint values are four digits on an ECS mode system and two digits on a non-ECS mode system.

Exporting Map Data

The EXPORT command writes a text file containing details of each character in the form used by IMPORT. This file is typically around 3.75Mb on an ECS mode system and is intended only as a starting point for creating an import file.