19.1. Запуск программы из командной строки

Внимание! В операционных системах семейства macOS передача параметров командной строки не поддерживается.

Параметры запуска из командной строки могут быть переданы в запущенный DICOM-Просмотрщик (см. раздел "Запуск нескольких экземпляров программы").

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

[<путь_к_программе>]<имя_исполняемого_файла_программы> [ --help] | [--study-folder <path> [--open-series-images | --open-series-mpr | --open-series-volume | --open-series-
endoscopy [--series-uid <uid> | --series-index <index>]]] | [--pacs-aetitle <aetitle> [--patient-id <patientID>] [--study-uid <studyUID>] [--series-index <seriesIndex> | --series-uid <seriesUID>] [--open-series-images] ] | [--aet <aet>] | [--import-settings <path> [--use-imported-listener-aetitle | --aet <aet>] [--update-scu-aetitle]] | [--export-settings <path>]

• --help: отображается справочная информация о параметрах командной строки, программа завершает работу.

• --study-folder <path>: исследование (исследования), содержащееся в указанной папке, отображается на панели исследований. Если исследований несколько, то следующие параметры запуска применяются к первому в списке исследованию:

  • --open-series-images: первая серия исследования открывается в окне просмотра плоских изображений

  • --open-series-mpr: первая серия исследования открывается в окне мультипланарной реконструкции

  • --open-series-volume: первая серия исследования открывается в окне объёмной реконструкции

  • --open-series-endoscopy(PRO): первая серия исследования открывается в окне виртуальной эндоскопии

  • С любым из этих параметров могут использоваться параметры

    • --series-uid <seriesUID>: открывается серия с соответствующим seriesUID

    • --series-index <seriesIndex>: открывается серия с соответствующим seriesIndex

• --pacs-aetitle <aetitle>: делается попытка открыть список исследований с PACS-сервера, AE Title которого соответствует указанному AE Title. С этим параметром могут использоваться в разных сочетаниях следующие параметры:

  • --patient-id <patientID>: в списке исследований ищутся исследования с соответствующим patientID. Параметр имеет более высокий приоритет, чем --study-uid

  • --study-uid <studyUID>: в списке исследований ищутся исследования с соответствующим studyUID

  • --series-uid <seriesUID>: для выбранного исследования выбирается серия с соответствующим seriesUID. Если найдено несколько исследований, то используется первое в списке

  • --series-index <seriesIndex>: для выбранного исследования выбирается серия с соответствующим seriesIndex. Если найдено несколько исследований, то используется первое в списке

  • --open-series-images: выбранная серия открывается в окне просмотра плоских изображений. Если серия не выбрана, то открывается первая серия первого исследования

Пример: C:\Users\user\DICOMViewerPro1.9.1\viewer.exe --study-folder D:\dicom_data --open-series-images --series-index 1 откроет в окне просмотра плоских изображений серию с индексом 1 первого исследования, содержащегося в папке D:\dicom_data.

Если параметр введен неверно, отображается справочная информация о параметрах командной строки, программа завершает работу. Если значение параметра введено неверно, например, в указанной папке не содержатся DICOM-данные, не существует серии с указанным seriesUID или seriesIndex, то данный и все последующие параметры игнорируются.

Внимание! Если несколько серверов имеют одинаковые AE Title, то поиск данных выполняется на первом найденном сервере. Сортировка PACS-серверов происходит по полю "Название сервера".

Настройка подключения к PACS-серверам описана в разделе 12.2.

Длина значения AE Title не должна превышать 16 символов. Кириллические символы и знак "\" в значении AE Title не допускаются.

Следующие команды служат для изменения настроек. После выполнения любой из этих команд программа завершает работу, в случае успешного выполнения в командной строке появляется слово "Done" (выполнено).

• --aet <aetitle>: AE Title DICOM-сервиса заменится на <aetitle>

• --import-settings <file>: импортируются настройки из файла <file>.

  • --use-imported-listener-aetitle: AE Title DICOM-сервиса заменится на указанный в файле настроек

    • если одновременно используется параметр --aet <aetitle>, AE Title DICOM-сервиса заменится на <aetitle>

  • --update-scu-aetitle: Название клиента (SCU) для PACS-серверов AE Title DICOM-сервиса останется текущим

    • если одновременно используется параметр --aet <aetitle>, то Название клиента (SCU) для PACS-серверов заменится на <aetitle>

• --export-settings <file>: настройки сохраняются в файл <file>.