Перейти к содержимому
GPPL IDESOLIDCAM / INVENTORCAM

Найдите сведения об установке, настройках, возможностях и кодах диагностики.

Tab — выбрать · Enter — открыть · Esc — закрыть
Установить Community ↗

Настройка подсветки

Измените цвет нужной категории, сохранив свою тему оформления. Здесь собраны справочник токенов и настройки, которые можно скопировать в VS Code.

  1. Откройте локальный файл .gpp. Убедитесь, что индикатор языка в правом нижнем углу показывает GPPL.
  2. Нажмите Ctrl+Shift+P и выполните Preferences: Open User Settings (JSON) — «Параметры: Открыть параметры пользователя (JSON)». Нужны редактируемые пользовательские настройки, а не параметры по умолчанию, доступные только для чтения.
  3. Добавьте настройки ниже внутрь внешних { }. Если такие ключи уже есть, объедините их содержимое вместо создания второй копии. Сохраните остальные параметры, в том числе кодировку файлов.
  4. Сохраните settings.json и вернитесь к файлу .gpp. Строки в одинарных кавычках должны стать оранжевыми, в двойных — светло-голубыми. Перезагрузка расширения обычно не нужна.
settings.json — работает в Community 1.6.3
{
"[gppl]": {
"editor.semanticHighlighting.enabled": true
},
"editor.semanticTokenColorCustomizations": {
"rules": {
"string:gppl": "#9CDCFE",
"string.format:gppl": "#FF8000"
}
}
}

Замените #FF8000 на нужный шестнадцатеричный цвет. Цвета примеров рассчитаны на тёмный фон; подберите читаемые сочетания для своей темы. Чтобы вернуть цвет темы, удалите только добавленное правило.

Селектор string.format:gppl означает: тип string, модификатор format, язык gppl. Базовое правило string:gppl действует и на строки с модификаторами; более точное string.format:gppl позволяет отдельно оформить одинарные кавычки. Это правила для категорий, а не способ назначить цвет одной переменной по имени. Сохраняйте написание селектора из примера, даже если имена в GPPL-коде записаны заглавными буквами.

С версии 1.7.0: пример охватывает все базовые типы и дополнительные категории. Он работает с выбранной вами темой; включать GPPL Classic Dark необязательно. Объедините его с существующими настройками, как описано выше.

settings.json — версия 1.7.0
{
"[gppl]": {
"editor.semanticHighlighting.enabled": true,
"editor.bracketPairColorization.enabled": false
},
"editor.semanticTokenColorCustomizations": {
"rules": {
"variable:gppl": "#D4D4D4",
"variable.readonly.defaultLibrary:gppl": {
"foreground": "#9CDCFE", "italic": true
},
"variable.readonly.defaultLibrary.boolean:gppl": {
"foreground": "#FFC042", "italic": false, "underline": false
},
"parameter:gppl": "#B5CEA8",
"function:gppl": "#DCDCAA",
"function.defaultLibrary:gppl": "#00CACA",
"function.systemProcedure:gppl": "#4EC9B0",
"function.userProcedure:gppl": "#F5CB49",
"keyword:gppl": "#C586C0",
"keyword.interrupt:gppl": {
"foreground": "#FF6666", "bold": true, "italic": true
},
"keyword.line:gppl": "#D7BA7D",
"namespace:gppl": "#C586C0",
"class:gppl": "#FF8000",
"string:gppl": "#CE9178",
"string.format:gppl": "#FF8000",
"number:gppl": "#B5CEA8",
"comment:gppl": "#8A9980",
"operator:gppl": "#D4D4D4",
"operator.comparison:gppl": "#F78C6C",
"operator.logical:gppl": "#C586C0",
"operator.generation:gppl": "#FFD700",
"operator.separator:gppl": "#89DDFF"
}
}
}

Здесь отключено раскрашивание пар скобок, чтобы был виден цвет из operator.generation. Поиск парных скобок и команда Go to Bracket продолжают работать. Если предпочитаете цвета пар скобок VS Code, оставьте раскрашивание включённым и не добавляйте этот параметр.

Сохраните пример в отдельный локальный файл .gpp и изучите категории. Это упражнение для редактора, а не полноценный постпроцессор станка. Блок кода на сайте использует статическую синтаксическую подсветку; цвета в VS Code определяются вашими настройками.

highlighting-example.gpp
@init_post
global numeric demo_value
demo_value = abs(-2)
endp
@start_of_file
; Compare the word and symbolic forms.
if demo_value eq 2 and not(active(demo_value)) then
{nb "X" demo_value:'5.3'}
endif
if demo_value != 0 then
change(demo_value) = true
call @usr_demo(demo_value)
endif
endp
@usr_demo(numeric demo_argument)
print demo_argument:'5.3'
endp

@init_post и @start_of_file — системные процедуры, хотя их тела пишете вы. @usr_demo — пользовательская процедура, demo_argument — параметр, а abs, active и change — встроенные функции. У eq и != намеренно разные селекторы; см. таблицу операторов ниже.

Для удобства чтения в таблицах опущен суффикс :gppl. Добавляйте его в настройках, чтобы изменить только GPPL. Категории описывают подсветку IDE, а не поведение кода при выполнении или корректность имени.

Все десять базовых типов есть в 1.6.3 и сохраняются в версии 1.7.0. Их правила действуют и на варианты с модификаторами.

Селектор Элементы GPPL
variable Локальные/глобальные переменные и неразрешённые обычные идентификаторы; у системных имён есть дополнительные модификаторы.
parameter Параметры процедур в объявлениях и разрешённых ссылках.
function Имена процедур, токены функций и завершение процедуры endp.
keyword Управление выполнением (if, then, elseif, else, endif, while, endw), call, inc, print, input, trace, col, colrel.
namespace Слова области видимости global и local; название токена не означает наличие пространств имён в GPPL.
class Слова типов integer, numeric, logical, string; это имя категории подсветки, а не объектно-ориентированный класс.
string Строковые литералы; одинарные кавычки дополнительно получают format.
number Целые числа, десятичные числа и научная запись.
comment Комментарии с точки с запятой, включая документационные ;;;.
operator Арифметика, присваивание и символьные сравнения; версия 1.7.0 добавляет подгруппы ниже.
Селектор Что выбирает
string.format Все литералы в одинарных кавычках, например '5.3'; категорию определяют кавычки, а не содержимое.
keyword.interrupt abort, exit, break, return.
variable.readonly.defaultLibrary Системные переменные из каталога, например xpos и pi.
variable.readonly.defaultLibrary.boolean Литералы true и false.
variable.declaration Объявления переменных.
parameter.declaration Объявления параметров.
function.declaration Объявления процедур; в версии 1.7.0 можно дополнительно указать модификатор категории процедуры.

Модификатор readonly также используется для оформления системных имён. Он не доказывает, что присваивание переменной запрещено. Ограничения записи проверяются диагностикой отдельно, например для pi. Отдельных семантических селекторов для имён локальных и глобальных переменных или переменных VMID нет; namespace окрашивает сами слова local и global.

С версии 1.7.0: группы настраиваются независимо. Они не выделяют отдельные токены внутри строк, комментариев или длинных идентификаторов вроде eq_value.

Селектор Токены
operator + - * / ^ = == != < > <= >= без модификатора подгруппы. Общее правило также действует на подгруппы, если стиль не задан более точным правилом.
operator.comparison Только словесные сравнения: eq ne lt gt le ge.
operator.logical and or not !, включая not(...) и !(...).
operator.generation Пара { }, ограничивающая вывод при генерации. Другие скобки в эту группу не входят.
operator.separator : перед форматом вывода в блоке генерации, print или tostr, а также перед уровнем в trace "all":5.

== и != входят в общую operator; отдельной категории для каждого из них нет. != — сравнение, а не логическое отрицание; его ! не является отдельным токеном. В 1.6.3 словесные сравнения и and/or/not относятся к ключевым словам, а ! — к обычным операторам; новые селекторы подгрупп требуют версии 1.7.0.

С версии 1.7.0: для трёх независимых цветов используйте три селектора функций.

Селектор Примеры и границы
function.defaultLibrary Встроенные функции из каталога: abs, tostr, get_axis_vector, change, active, even, odd, date, time. Логические функции сохраняют категорию по обе стороны присваивания.
function.systemProcedure Системные @-процедуры из каталога: объявления с пользовательским телом и вызовы. Например, @init_post.
function.userProcedure Остальные @-имена, включая пользовательские процедуры и неразрешённые имена. Этот цвет не означает, что процедура найдена.
keyword.line nb и nl, управляющие блоком или строкой вывода.

endp остаётся обычной function. В 1.6.3 change, active, even, odd и nb/nl относятся к ключевым словам; три группы функций ещё не разделены последовательно описанным выше способом. Объявленная переменная с именем, похожим на builtin, не становится автоматически вызовом функции.

Используются модификаторы declaration, readonly, defaultLibrary, boolean, interrupt, format, а в версии 1.7.0 — также comparison, logical, generation, line, systemProcedure, userProcedure, separator. definition зарезервирован в легенде, но сейчас не выдаётся; правило с ним не выделит объявления.

При необходимости объединяйте модификаторы: function.userProcedure.declaration:gppl выбирает объявления пользовательских процедур, а function.userProcedure:gppl — и объявления, и вызовы. Например, добавьте "function.userProcedure.declaration:gppl": { "bold": true } в объект rules. Можно задавать foreground, bold, italic, underline и strikethrough; указание одного цвета не отменяет существующие стили шрифта.

Для обычной работы IDE используйте семантические правила выше. Если вы намеренно отключили семантическую подсветку, цвета определяются лексическими TextMate scopes через editor.tokenColorCustomizations.

В 1.6.3 наша TextMate-грамматика покрывает только строки и комментарии. Расширенная таблица ниже относится к версии 1.7.0 и режиму языка GPPL.

TextMate scope Элементы
comment.line.semicolon.gppl Комментарии.
string.quoted.single.gppl Литералы в одинарных кавычках.
string.quoted.double.gppl Литералы в двойных кавычках.
constant.character.escape.gppl Распознанные escape-последовательности внутри строк.
entity.name.function.procedure.gppl Все имена @-процедур вместе.
support.function.builtin.gppl Имена builtin-функций, определяемые лексически.
keyword.control.gppl Ключевые слова управления выполнением, операторов языка и endp.
keyword.control.interrupt.gppl abort/exit/break/return.
keyword.control.line.gppl nb/nl.
entity.name.namespace.gppl global/local.
entity.name.type.class.gppl Слова типов данных.
constant.language.boolean.gppl true/false.
constant.numeric.gppl Числа.
keyword.operator.gppl Арифметика, присваивание и символьные сравнения.
keyword.operator.comparison.word.gppl Словесные сравнения.
keyword.operator.logical.gppl Логические операторы.
punctuation.section.generation.gppl { }.
keyword.operator.separator.gppl :.

Лексическая подсветка не различает обычные переменные, параметры, системные переменные и места объявления. Все @-процедуры имеют общий scope, а для builtin-имён не учитывается затенение переменной. При включённой семантической подсветке токен всей строки может также перекрыть TextMate-цвет escape-последовательности. Это ограничения резервной подсветки, а не дополнительные семантические селекторы.

settings.json — TextMate, версия 1.7.0
{
"[gppl]": {
"editor.semanticHighlighting.enabled": false,
"editor.bracketPairColorization.enabled": false
},
"editor.tokenColorCustomizations": {
"textMateRules": [
{
"scope": "keyword.operator.comparison.word.gppl",
"settings": { "foreground": "#F78C6C" }
},
{
"scope": "punctuation.section.generation.gppl",
"settings": { "foreground": "#FFD700" }
},
{
"scope": "entity.name.function.procedure.gppl",
"settings": { "foreground": "#F5CB49", "fontStyle": "bold" }
}
]
}
}

Чтобы добавить категорию, скопируйте один объект в массив textMateRules и замените его scope значением из таблицы. Семантические настройки находятся в rules, настройки TextMate — в textMateRules. Это разные форматы.

Для режима GPP расширения SolidCAM замените :gppl на :gpp в семантических селекторах, а [gppl] на [gpp] в языковых настройках. Если используете оба режима, сохраните оба набора. Сервер GPPL IDE поддерживает оба идентификатора. При отключённой семантической подсветке GPP использует грамматику установленного расширения SolidCAM: приведённые выше GPPL scopes в этом режиме не гарантируются.

Примеры находятся вне блока с именем темы, поэтому действуют при смене тем. Выбор встроенной темы описан в разделе Цветовая тема и подсветка. Отображаемое имя — GPPL Classic Dark, но идентификатор настройки остаётся GPPL UltraEdit, в том числе в блоках [GPPL UltraEdit]. Существующие правила для конкретной темы могут влиять на результат; проверьте их при переключении.

  1. Убедитесь, что установленная версия поддерживает селектор. Новые категории не начнут работать в 1.6.3.
  2. Проверьте режим языка и суффикс: GPPL использует gppl, режим GPP от SolidCAM — gpp.
  3. В настройках проверьте действующее значение Editor: Semantic Highlighting Enabled для этого языка, включая переопределения рабочей области. Для семантических правил нужно true, для примера TextMate — false.
  4. Установите курсор на токен и выполните Developer: Inspect Editor Tokens and Scopes из палитры команд. Проверьте семантический тип, модификаторы, TextMate scopes и правило, задающее цвет текста. Закройте инспектор клавишей Esc.
  5. Найдите более точное правило, блок для конкретной темы или повторяющиеся ключи настроек. Для { } отключите Editor: Bracket Pair Colorization Enabled, чтобы увидеть цвет категории. Общее правило function или operator действует и на токены с модификаторами.
  6. Если семантический токен не показан, убедитесь, что расширение активно для открытого файла. Если другие языковые функции тоже недоступны, откройте Решение проблем. Удалите добавленное правило, чтобы сравнить с цветом темы по умолчанию.

Синтаксис селекторов и параметры оформления VS Code описаны в официальных руководствах по семантической подсветке и настройке тем.