Reference: Display Filters: CharMap
Move Up Move to Top
Contents: Filter Overview User Interface & Options
Example Variables
Filter Overview This display filter creates user defined character table mappings. For example, you can use this filter to map a standard codeset such as ISO-8859-1 into a nonstandard codeset defined by a custom Amiga font, or to define character translation filters such as ROT-13 or case conversion.

Back to Top

User Interface The user interface for this filter looks like this:

You may type zero or more character mapping commands into the text editor, where commands are of one of these forms:

  • c1=c2 - This maps a single character c1 in the input space to a single character c2 in the output space.

  • c1-c2=c3-c4 - This maps a range of characters c1 to c2 in the input space to a range of characters c3-c4 in the output space. There must be the same number of characters in each range.

  • DEL=c1 - This deletes character c1 entirely. It will not appear in the output space even if it was present in the input space.

Whitespace and line breaks are ignored either within a single mapping command, or between commands. Each character in a mapping command may be specified using one of these methods:

  • Hex: 0xDD - Where DD is two hex digits in the range 0-9 or A-Z. For instance, a space character is 0x20.

  • Octal: 0DDD - Where DDD are three octal digits in the range 0-7.

  • Decimal: DD or DDD - Where DD or and DDD are two and three decimal digits, respectively.

  • Literal Character: C - Where C is a character, such as the letter Z.

Thus, the following are all equivalent, and map a lower case 'a' to the '@' character:

    a=@
    a=0100
    0141=@
    0x61=@
    97=@

Back to Top

Example To create a filter that maps lower case ASCII letters to upper case:

    a-z=A-Z

To create a filter that reverses the case of ASCII letters:

    a-z=A-Z A-Z=a-z

To create an ROT-13 filter:

    a-m=n-z n-z=a-m A-M=N-Z N-Z=A-M

To create a filter that deletes all exclamation marks (!):

    DEL=!

Back to Top

Variables There are no variables supported by this filter.