EDIT.MAP

EDIT.MAP

Top  Previous  Next

 

The EDIT.MAP command modifies a character map.

 

 

Format

 

EDIT.MAP name

 

where

 

nameis 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:

CodeptThe code point value for the character described by this line. This is shown as a hexadecimal value prefixed with "U+".
CharThe actual character. This will only be displayed correctly if the terminal device supports the character.
ASet to Y of this character is alphabetic.
NContains the numeric value for characters that represent digits.
GSet to Y if this character is a graphic (printing) character.
SSet to Y if this character is whitespace (space, tab, etc).
WSet to Y if this is a double width character (ECS mode systems only).
ZSet to Y if this is character has the user defined attribute set. See IS.USER.CHAR().
UppercaseThe code point value and character that should be returned by the QMBasic UPCASE() function.
LowercaseThe code point value and character that should be returned by the QMBasic DOWNCASE() function.
SortThe sort weight of this character as a hexadecimal value.
TransTransliteration 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:

AToggle alphabetic attribute.
0 - 9Set digit attribute with the given numeric value assigned to the character.
NClear numeric attribute.
GToggle graphic attribute.
LSet lowercase character pairing. The L key should be followed by the character to be assigned as the lower case equivalent of the selected character.
SToggle space attribute.
TSet 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.
USet uppercase character pairing. The U key should be followed by the character to be assigned as the upper case equivalent of the selected character.
WToggle wide character attribute (ECS mode systems only).
|ZToggle 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 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.

 

 

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=nSet or clear alphabetic status (n = 0 to clear, 1 to set).
G=nSet or clear graphic status.
LC=nnnnSet lowercase pair as codepoint nnnn.
N=0Clear numeric status.
N=1:nSet numeric status with digit value n.
S=nSet or clear space status.
T=Clear transliteration.
T=nnSet transliteration as single 8-bit character with hexadecimal value nn
T=nn nnSet transliteration as two 8-bit characters with hexadecimal values nn nn
W=nSet or clear double width character status.
UC=nnnnSet uppercase pair as codepoint nnnn.
Z=nSet 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.

 

 

See also:

Extended character set, ECS.MAP, CHAR.MAP