Руководство по RealityScan CLI: от фотографий к 3D-модели

Что вы узнаете из этого руководства?

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

Этот способ не гарантирует автоматизацию каждой операции. Например, команда -start запускает операции, заранее настроенные для кнопки Start в RealityScan. Поэтому настройки приложения и этапы командной строки следует рассматривать вместе.

Требования

В официальной документации примеры командной строки приведены для RealityScan.exe. Далее описаны действия для командной строки Windows и .bat-файлов. В документации не указаны обязательная версия, требования к аппаратному обеспечению, тип аккаунта или стоимость. Поэтому перед началом проекта отдельно проверьте используемую установку и условия лицензии.

В примере для папки с фотографиями и файла проекта используются пути C:\RS\Images и C:\RS\Interior.rsproj. Создайте такие папки на своём компьютере и разместите изображения в подходящем каталоге. Если в путях к файлам есть пробелы, проверьте на своей установке, как будут разбираться параметры; в примерах используются пути без пробелов.

Добавление папки RealityScan в системную переменную PATH избавит от необходимости каждый раз указывать полный путь к приложению. В официальной документации отмечено, что приведённая ниже строка PATH действует только в текущем сеансе командной строки.

Шаги по порядку

1. Выполните черновое выравнивание фотографий

Сначала добавьте изображения и запустите быстрое черновое выравнивание. В этом примере папка приложения добавляется в PATH, затем фотографии импортируются из папки, а проект сохраняется:

set PATH=%PATH%;C:\Program Files\Epic Games\RealityScan\
RealityScan.exe -addFolder C:\RS\Images -save C:\RS\Interior.rsproj -draft -quit

Параметр -draft запускает выравнивание в черновом режиме. Такая предварительная проверка помогает понять, складываются ли фотографии в единую сцену. Вместо того чтобы переходить к полному выравниванию, не проверив результат, безопаснее открыть проект в приложении и осмотреть его.

2. При необходимости включите вложенные папки

Если изображения распределены по вложенным каталогам, перед добавлением включите параметр сканирования подкаталогов:

RealityScan.exe -set "appIncSubdirs=true" -addFolder C:\RS\Images -save C:\RS\Interior.rsproj -draft -quit

Эта настройка позволяет команде -addFolder учитывать и вложенные папки. Если все изображения находятся в одном каталоге, дополнительная настройка не нужна. Вместо последовательного запуска обоих примеров для одного проекта выберите один вариант, подходящий к структуре папок с фотографиями.

3. Выполните полное выравнивание

Проверив черновой результат, повторно загрузите сохранённый проект и запустите полное выравнивание:

RealityScan.exe -load C:\RS\Interior.rsproj -align -save C:\RS\Interior.rsproj -quit

Команды выполняются последовательно: проект открывается, запускается выравнивание, затем результат сохраняется в тот же файл проекта. Параметры командной строки выполняют операции, аналогичные действиям в приложении; приложение может открыться в обычном режиме и допускать взаимодействие с пользователем во время обработки. В документации также описан параметр -headless, который скрывает интерфейс, однако при первых запусках может быть удобнее проверять результат на экране.

4. Запустите настроенный в приложении рабочий процесс

После выравнивания настройте в кнопке Start программы RealityScan необходимые операции для создания модели. Согласно официальной документации, команда -start запускает процессы, назначенные этой кнопке. Поэтому не следует полагать, что нужные этапы построения модели определяются простым добавлением команды.

RealityScan.exe -load C:\RS\Interior.rsproj -start -save C:\RS\Interior.rsproj -quit

Параметры, используемые во время обработки, следует проверить в приложении с учётом проекта и поставленной задачи. Командная строка упрощает повторный запуск заранее настроенного процесса, но сама по себе не гарантирует, что настройки подходят для конкретной задачи.

5. Упростите и экспортируйте модель

Если вам известно имя модели в проекте, выберите её с помощью -selectModel, задайте целевое количество треугольников командой -simplify и экспортируйте с помощью -exportSelectedModel. В примере ниже указано имя Model1 и целевое количество 1.000.000 треугольников. Это не рекомендация по качеству, а лишь демонстрация использования команды.

RealityScan.exe -load C:\RS\Interior.rsproj -selectModel Model1 -simplify 1000000 -exportSelectedModel C:\RS\Interior.obj -save C:\RS\Interior.rsproj -quit

Замените имя модели на фактическое имя в проекте. Если требуется точнее управлять параметрами упрощения и экспорта, к командам можно добавить необязательный файл params.xml, экспортированный из соответствующих инструментов приложения. Доступные настройки зависят от того, как файл был подготовлен в приложении.

Распространённые ошибки

• Если запускать RealityScan.exe не из папки установки приложения, исполняемый файл может не найтись. Укажите полный путь к приложению или добавьте строку PATH в текущий сеанс командной строки.

• Не считайте, что изображения из вложенных папок добавляются автоматически. Если это необходимо, используйте настройку appIncSubdirs.

• Не принимайте черновое выравнивание за окончательный результат. Параметры -draft и -align запускают разные режимы выравнивания; проверьте проект после чернового этапа.

• Не пытайтесь угадать, какие операции запустит команда -start. Заранее настройте параметры кнопки Start в приложении.

• Выбор модели под неверным именем или ошибка в пути к проекту могут помешать выполнению команд с нужным файлом. Сверьте названия проекта и модели с теми, что указаны в приложении.

Как это влияет на рабочий процесс в архитектуре, интерьерах и archviz

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

В проектах, над которыми работают несколько сотрудников, важно поддерживать единообразие структуры папок, названий проектов и настроек обработки в приложении. Документация RealityScan не содержит сведений о совместимости с конкретными программами для archviz, необходимом оборудовании или стоимости лицензии. Поэтому использование экспортированного файла в целевом приложении, влияние оборудования на длительность обработки и условия лицензирования следует отдельно проверить на реальных данных проекта.

Что делать дальше

Когда базовый процесс заработает, изучите другие команды проекта — например, добавление изображений с помощью image list, загрузку проекта и его сохранение. Для выравнивания предусмотрены параметры экспорта и повторного использования метаданных камеры XMP. В документации также описаны инструменты модели для очистки, закрытия отверстий, расчёта текстур и различных вариантов экспорта. Новые команды лучше сначала проверять на небольшой копии проекта — это поможет снизить риск перезаписи текущей работы.

Источник и лицензия

Руководство основано на разделах официальной документации Epic Games по командной строке RealityScan: о командах проекта и изображений, командах выравнивания и инструментах модели. Источники отмечены как распространяемые по свободной лицензии; материал изложен на турецком языке, а примеры адаптированы для этого руководства.