*****************************************************************
***              SpecialChar AkelPad plugin v7.1              ***
*****************************************************************

2007-2024 Шенгальц Александр aka Instructor (Shengalts@mail.ru)


*** Описание ***

Отображение и подсветка:
- специальных символов (пробел, табуляция, новая строка, конец файла,
  перенос, вертикальная табуляция, прогон листа, нулевой символ);
- любых указанных символов;
- отступа текста.

Замечания:
- Если в настройках новый символ для табуляции равен \x0000, то табуляция отображается как
  стрелка на всю длину.
- Если в настройках новый символ для новой строки равен \x0000, то новая строка отображается как
  "rn" или "rrn" - Win, "n" - Unix, "r" - Mac.
- Если в настройках новый символ для конца файла равен \x0000, то конец файла отображается как
  "eof".
- Если в настройках новый символ для переноса строки равен \x0000, то перенос строки отображается как
  стрелка вниз.


*** Функции ***

SpecialChar::Main
Главная функция для запуска и остановки плагина.

SpecialChar::Settings
Диалог настроек плагина.


*** Внешний вызов SpecialChar::Settings ***

Call("SpecialChar::Settings", 1, "OLDSYMBOLS", "#RRGGBB", "#RRGGBB", BASICCOLORENABLE, SELCOLORENABLE, "NEWSYMBOLS")
  Параметры:
    1
      Установить настройки для указанных символов (старый метод).
    "OLDSYMBOLS"
      Набор символов через запятую, например: "\x20,1,\x09". Символы указываются в шестнадцатеричном формате, а также могут быть использованы специальные символы:
        1  Пробел
        2  Табуляция
        3  Новая строка
        4  Вертикальная табуляция
        5  Прогон листа
        6  Нулевой символ
        7  Перенос
        8  Линия отступа
        9  Конец файла
    "#RRGGBB"
      Цвет текста. Если "0", не меняется. Если 0, используется цвет по умолчанию.
    "#RRGGBB"
      Цвет в выделении. Если "0", не меняется. Если 0, используется цвет по умолчанию.
    BASICCOLORENABLE (один из следующих):
      -3  инвертировать включенность цвета текста первого символа в группе и установить данное значение для всех символов группы.
      -2  не менять включенность цвета текста (по умолчанию).
      -1  инвертировать включенность цвета текста.
       0  отключить цвет текста.
       1  включить цвет текста.
    SELCOLORENABLE (один из следующих):
      -2  не менять включенность цвета в выделении (по умолчанию).
      -1  инвертировать включенность цвета в выделении.
       0  отключить цвет в выделении.
       1  включить цвет в выделении.
    "NEWSYMBOLS"
      Набор символов, отображаемых вместо OLDSYMBOLS, через запятую, например: "\xB7,\x00,\x00". Символы указываются в шестнадцатеричном формате. По умолчанию: "".

Call("SpecialChar::Settings", 3, "OLDSYMBOLS", "NEWSYMBOLS", BASICCOLORENABLE, BASICFONTSTYLE, "#RRGGBB", "#RRGGBB", SELCOLORENABLE, SELFONTSTYLE, "#RRGGBB", "#RRGGBB")
  Параметры:
    3
      Установить настройки для указанных символов (новый метод).
    "OLDSYMBOLS"
      Набор символов через запятую, например: "\x20,-3,\x09". Символы указываются в шестнадцатеричном формате, а также могут быть использованы специальные символы:
        -2  Новая строка
        -3  Перенос
        -4  Линия отступа
        -5  Конец файла
    "NEWSYMBOLS"
      Набор символов, отображаемых вместо OLDSYMBOLS, через запятую, например: "\xB7,\x00,\x00". Символы указываются в шестнадцатеричном формате. По умолчанию: "".
    BASICCOLORENABLE (один из следующих):
      -3  инвертировать включенность цвета текста первого символа в группе и установить данное значение для всех символов группы.
      -2  не менять включенность цвета текста (по умолчанию).
      -1  инвертировать включенность цвета текста.
       0  отключить цвет текста.
       1  включить цвет текста.
    BASICFONTSTYLE (один из следующих):
       0  не менять стиль шрифта (по умолчанию).
       1  обычный стиль шрифта.
       2  жирный стиль шрифта.
       3  курсивный стиль шрифта.
       4  жирный курсив.
    "#RRGGBB"
      Цвет текста. Если "0", не меняется. Если 0, используется цвет по умолчанию.
    "#RRGGBB"
      Цвет фона. Если "0", не меняется. Если 0, используется цвет по умолчанию.
    SELCOLORENABLE (один из следующих):
      -3  инвертировать включенность цвета в выделении первого символа в группе и установить данное значение для всех символов группы.
      -2  не менять включенность цвета в выделении (по умолчанию).
      -1  инвертировать включенность цвета в выделении.
       0  отключить цвет в выделении.
       1  включить цвет в выделении.
    SELFONTSTYLE (один из следующих):
       0  не менять стиль шрифта (по умолчанию).
       1  обычный стиль шрифта.
       2  жирный стиль шрифта.
       3  курсивный стиль шрифта.
       4  жирный курсив.
    "#RRGGBB"
      Цвет текста в выделении. Если "0", не меняется. Если 0, используется цвет по умолчанию.
    "#RRGGBB"
      Цвет фона в выделении. Если "0", не меняется. Если 0, используется цвет по умолчанию.
