20.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>: исследование (исследования), содержащееся в указанной папке, отображается на панели исследований. Применяются следующие параметры запуска:

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

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

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

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

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

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

    • --study-uid ";<studyUID 1> \…\<studyUID N>";: открывается первая серия из каждого выбранного исследования в списке с соответствующим studyUID

    • --series-uid ";<seriesUID 1> \…\<seriesUID N>";: открываются серии из списка с соответствующим seriesUID

    • --series-index ";<seriesIndex 1> \…\<seriesIndex N>";: открываются серии из списка с соответствующим seriesIndex. Нумерация параметра seriesIndex начинается с нуля и зависит от текущего типа сортировки серий в исследовании

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

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

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

  • --series-uid ";<seriesUID 1> \…\<seriesUID N>";: для выбранных исследований выбираются серии с соответствующим seriesUID

  • --series-index ";<seriesIndex 1> \…\<seriesIndex N>";: для выбранных исследований выбираются серии с соответствующим seriesIndex. Нумерация параметра seriesIndex начинается с нуля и зависит от текущего типа сортировки серий в исследовании

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

Список значений параметров передаётся одной строкой с разделителем в виде символа "\". Список значений параметров study-uid и series-uid составляются следующим образом: первому значению параметра из списка study-uid должно соответствовать первое значение параметра из списка series-uid, второму значению параметра из списка study-uid — второе значению параметра из списка series-uid и т.д. Если в одном из списков меньше значений параметров, чем в другом, то он дополняется пустыми значениями. Пустые значения можно передавать в начале и в середине списка.

Внимание! Список значений параметров не должен завершаться символом "\".

Аналогичным образом связаны списки параметров, передаваемые в study-uid и в series-index. Значения из списка series-uid имеют более высокий приоритет относительно значений из списка series-index. Если передаётся непустое значение параметра series-uid, то соответствующее значение параметра series-index игнорируется. Ниже приведён пример передачи списков параметров study-uid, series-uid и series-index в консольную команду:

C:\Users\user\DICOMViewerPro2.16.0\viewer.exe --study-folder D:\dicom_data --study-uid ";\