Как преобразовать файлы DM-скрипта (* .s) в файл плагина (* .gtk) - PullRequest
0 голосов
/ 03 ноября 2018

Я написал несколько файлов сценариев DM ( .s), и поэтому я хотел бы преобразовать (скомпилировать?) Их в файлы плагинов ( .gtk). В этом случае я должен подготовить какой-то компилятор и пакет Gatan Software Development Kit (SDK), или другие? Если есть хороший способ, пожалуйста, обучите процедуре подробно. Буду очень признателен, если вы поделитесь мудростью в создании файлов * .gtk.

1 Ответ

0 голосов
/ 04 ноября 2018

.GTK-файлы не скомпилированы - вы не получите никакого преимущества в скорости, если будете иметь их в файле .gtk (или .gt1, .gt2). Они только упакованы в эти файлы для удобства совместного использования и распространения их без совместного использования исходного кода.

Тем не менее, способ "упаковать" сценарии в эти файлы - это использовать саму команду-скрипт, то есть написать сценарий, который создает эти файлы из набора файлов .s на жестком диске.

Команда для добавления файла сценария в пакет сценария: AddScriptFileToPackage с синтаксисом:

void AddScriptFileToPackage( String file_path, String packageName, Number packageLevel, String packageLocation, String command_name, String menu_name, String sub_menu_name, Boolean isLibrary )
void AddScriptFileToPackage( String file_path, String packageName, Number packageLevel, String command_name, String menu_name, String sub_menu_name, Boolean isLibrary )

Команда для добавления скрипта (строки) в пакет скриптов: AddScriptToPackage с синтаксисом:

void AddScriptToPackage( String script, String packageName, Number packageLevel, String packageLocation, String command_name, String menu_name, String sub_menu_name, Boolean isLibrary )
void AddScriptToPackage( String script, String packageName, Number packageLevel, String command_name, String menu_name, String sub_menu_name, Boolean isLibrary )

Параметры в двух командах:

Parameters of AddScriptFileToPackage

Обратите внимание, что созданный файл плагина по умолчанию появится в расположении user_plugin:

C:\Users\USERNAME\AppData\Local\Gatan\Plugins

Второй синтаксис позволяет указать путь, где параметром packageLocation может быть любое из имен, также принятых в команде GetApplicationDirectory, чаще всего это либо user_plugin (см. Выше), либо просто plugin со ссылкой на текущая папка подключаемого модуля DigitalMicrograph.exe, т. е.

.\Plugins относительно того, где находится DigitalMicrograph.exe, обычно C:\Program Files\Gatan\Plugins\

Обратите внимание, что можно добавлять сценарии к существующему файлу, но нельзя "удалить" один из них. В этом случае нужно удалить файл и заново создать его. Кроме того, если в сценариях, которые будут добавлены, возникает ошибка, они не будут установлены правильно, и вам может потребоваться начать заново.

Справочная документация F1 (из более поздних версий GMS) содержит пример сценария, показывающий, как обычно использовать команду: F1 help


Разница между libary и командой install такая же, как и при использовании команды File-Menu для «установки скрипта». Библиотека обычно представляет собой набор методов (или классов), которые при установке остаются доступными и находятся в памяти. Команда устанавливает скрипт как команду меню для пользовательского интерфейса. т.е. при выборе меню выполняется проверка (один раз). В то время как «File / Install Script» устанавливает вещи в общий файл настроек DigitalMicrograph, указанные выше команды создают отдельные файлы .gtk, которые загружаются при запуске, если они находятся в папке плагинов. Любой код, установленный как «библиотека», запускается один раз при запуске.

...