Коротко
- Для импорта Datasmith в проекте должен быть включён плагин Datasmith Importer.
- Импорт запускается в Unreal Editor через Create > Datasmith > File Import.
- Если исходный файл изменился, ресурс Datasmith Scene можно импортировать повторно.
- Ссылки проекта на отдельный ресурс после повторного импорта автоматически используют его обновлённую версию.
Что вы узнаете из этого руководства?
Datasmith используется для переноса контента из поддерживаемых приложений для 3D-проектирования или форматов файлов в Unreal Engine. В руководстве рассказывается, как добавить Datasmith-контент в проект, обновить его после изменений в исходном файле с помощью повторного импорта и применить эти изменения к акторам в текущем Level. Также рассматривается, как обновлять отдельные ресурсы Static Mesh, Material и Texture, не обновляя всю сцену целиком.
В этом рабочем процессе важно понимать связь между ресурсом Datasmith Scene, созданным из исходного файла, и Datasmith Scene Actor, размещённым в Level. Повторный импорт может обновить ресурсы проекта, а применение изменений к акторам сцены зависит от выбранных при повторном импорте параметров синхронизации. Рассматривая эти два аспекта по отдельности, проще контролировать объём обновления.
Требования
Перед началом откройте нужный проект в Unreal Editor и проверьте, включён ли плагин Datasmith Importer. Если плагин отключён, параметры импорта Datasmith не появятся. Если проект создан на основе шаблона Architecture или Automotive, Product Design, and Manufacturing, некоторые плагины Datasmith могут быть включены по умолчанию. Тем не менее проверьте, доступен ли нужный вариант.
В зависимости от формата исходного файла могут потребоваться дополнительные плагины или программы. В документации Epic Games приведён пример файлов .wire: для работы с ними необходимо установить совместимую версию Autodesk Alias AutoStudio. Требования для других форматов и приложений также зависят от типа исходного файла. В исходных руководствах не указаны требования к конкретной версии Unreal Engine или учётной записи, поэтому в этом материале такие условия не добавляются.
Если вы собираетесь добавить контент в существующий Level, откройте его заранее. Для отдельной сцены можно создать новый Level или использовать Level по умолчанию.
Импорт Datasmith-контента
Откройте нужный проект в Unreal Editor. Откройте существующий Level, куда будет помещён контент. Если такого Level нет, создайте новый или используйте Level по умолчанию.
Откройте меню Create на главной панели инструментов и выберите Datasmith > File Import. В окне выбора файлов укажите исходный файл и нажмите Open.
Выберите расположение контента в проекте и нажмите OK. Чтобы создать новую родительскую папку, щёлкните правой кнопкой мыши по пустому месту в окне выбора файлов. Чтобы создать вложенную папку внутри существующей, щёлкните правой кнопкой мыши по нужной папке.
В окне Datasmith Import Options укажите, какие типы контента нужно импортировать из исходного файла, и проверьте остальные параметры. Список доступных вариантов зависит от формата файла, поэтому не предполагайте, что для всех исходников настройки будут одинаковыми.
Настроив параметры, нажмите Import. Datasmith обработает исходный файл, создаст новые ресурсы в проекте и разместит Datasmith Scene в открытом Level.
Для дополнительной настройки процесса импорта можно использовать визуальное программирование Blueprints или скрипты Python. Dataprep позволяет выполнять дополнительные операции во время импорта; рецепты можно сохранять и использовать повторно. Это не обязательные этапы базового переноса файлов, а инструменты для настройки рабочего процесса.
Обновление сцены после изменения исходного файла
Если вы сохранили изменения исходной сцены в том же файле на диске, который использовался ранее, щёлкните правой кнопкой мыши по ресурсу Datasmith Scene в Content Browser и выберите Reimport. Если изменения находятся в другом файле, выберите Reimport With New File и укажите новый файл.
Во время повторного импорта доступны параметры, похожие на те, что использовались при первом импорте. Кроме того, в разделе Sync Current Level Actors можно указать, следует ли применять изменения обновлённого ресурса Datasmith Scene к соответствующим Datasmith Scene Actor в открытом Level. Настроив параметры, нажмите Import.
При повторном импорте могут измениться геометрия Static Mesh, Parent Materials и ресурсы Texture в Content Browser. Поэтому не рассматривайте эту операцию только как обновление отображения сцены: она может затронуть и ресурсы проекта. Перед началом проверьте масштаб изменений в исходном файле и параметры синхронизации.
Чтобы синхронизировать акторы во время повторного импорта, откройте нужный Level, повторно импортируйте ресурс Datasmith Scene и в разделе Sync Current Level Actors окна Import Options установите флажок Datasmith Scene Actors. Если нужно также вернуть в Level ранее удалённые акторы, включите параметр Re-Spawn Deleted Actors.
Синхронизацию можно выполнить и позже. Откройте нужный Level и выберите Datasmith Scene Actor в Outliner. В разделе Datasmith панели Details нажмите Update actors from Scene. Если нужно восстановить удалённые акторы, перед этим установите флажок Respawn deleted actors.
Обновление отдельных ресурсов
Вместо повторного импорта всего ресурса Datasmith Scene можно обновить отдельные ресурсы. В Content Browser щёлкните правой кнопкой мыши по нужному ресурсу Static Mesh, Material или Texture и выберите Reimport. Для ресурсов Material, созданных Datasmith с нуля на основе описания материала в исходном файле, доступен пункт Datasmith > Reimport Material. Согласно исходному руководству, обычно это относится к Parent Materials, импортированным из 3ds Max; для экземпляров Material, основанных на встроенных материалах Datasmith, этот пункт может отсутствовать.
При повторном импорте отдельного ресурса открывается окно с параметрами, но в нём нет настройки синхронизации акторов Level. При этом ссылки проекта автоматически используют новую версию обновлённого ресурса. Иными словами, отсутствие настройки синхронизации акторов при импорте отдельного ресурса не означает, что для обновления ссылок на него требуется отдельный этап синхронизации.
Частые ошибки и дальнейшие шаги
Если параметры Datasmith не отображаются, сначала проверьте, включён ли в проекте плагин Datasmith Importer.
Если обновление выполняется из другого исходного файла, выберите Reimport With New File, а не Reimport.
Не считайте повторный импорт и синхронизацию акторов Level одной и той же настройкой: проверьте параметр Sync Current Level Actors.
Помните, что при повторном импорте отдельного ресурса нельзя синхронизировать акторы Level, но ссылки проекта автоматически используют актуальную версию ресурса.
Учитывайте, что повторный импорт может повлиять на геометрию Static Mesh, а также на ресурсы Parent Materials и Texture.
В архитектурных, интерьерных и archviz-процессах Datasmith можно использовать для переноса контента из поддерживаемого источника проектирования в проект Unreal Engine и применения изменений исходной сцены. Важно решить, нужно ли применять изменения ко всей сцене или только к определённым ресурсам. Команды могут совместно определить, когда синхронизировать акторы сцены и следует ли возвращать удалённые акторы.
В исходной документации нет сведений о системных требованиях или стоимости лицензий, поэтому не следует делать предположений по этим вопросам. Перед началом проверьте, поддерживается ли формат исходного файла, установлено ли необходимое дополнительное ПО и включены ли плагины проекта. В качестве следующего шага можно изучить описание параметров Datasmith Import Options для используемого формата файла, а для повторяющихся операций — рассмотреть настройку процессов с помощью Blueprints, Python или Dataprep.
Источник и лицензия
Это руководство адаптировано на турецкий язык по материалам Epic Games “Importing Datasmith Content into Unreal Engine” и “Reimporting Datasmith Content into Unreal Engine”. Для обоих источников указана лицензия=свободная.
Источники
Источников: 2Тексты источников не перепечатываются; короткие цитаты отмечены, остальное — наш пересказ и комментарий.
Для архитектурных и визуализационных команд в Турции практическая ценность Datasmith заключается в том, что он позволяет перенести контент из источника проектирования в Unreal Engine, а затем применить изменения исходного файла к проекту с помощью повторного импорта. Понимание разницы между синхронизацией акторов сцены и обновлением отдельных ресурсов помогает команде лучше контролировать процесс.
Перед началом работы следует проверить плагины проекта и требования к формату исходного файла. В руководствах не указаны цена, требования к оборудованию или стоимость лицензии, поэтому не стоит делать предположений на эти темы. Повторный импорт может затронуть геометрию и ресурсы материалов, поэтому важно заранее оценить масштаб изменений.
Частые вопросы
Какой плагин нужен для импорта Datasmith в Unreal Engine?
В проекте должен быть включён плагин Datasmith Importer. Если он отключён, параметры импорта Datasmith не отображаются.
Как обновить сцену после изменения исходного файла Datasmith?
Щёлкните правой кнопкой мыши по ресурсу Datasmith Scene в Content Browser и выберите Reimport, если исходный файл тот же, или Reimport With New File, если используется другой файл. Для синхронизации акторов Level предусмотрены соответствующие параметры.
Можно ли повторно импортировать один материал с помощью Datasmith?
Да. Щёлкните правой кнопкой мыши по нужному ресурсу Material и выберите Datasmith > Reimport Material. Однако этот пункт доступен только для ресурсов Material, созданных Datasmith определённым способом.
