Ru/StudioMDL (Source): Difference between revisions

Revision as of 04:52, 6 November 2023

Для руководства по использованию StudioMDL, смотрите Компиляция модели

StudioMDL это консольная утилита, используемая для компиляции моделей из промежуточных форматов, экспортированных из программы 3D-моделирования, в бинарный формат .mdl, читаемый движком Source.

Её можно найти в: common\<gamename>\<gamefolder>\bin\studiomdl.exe.

Примечание:Имя "studio" отсылает к разработке

Half-Life, во время которого

Valve использовали

3DS Max для создания их моделей.

Баг:Попытка использовать Studiomdl или его ярлык, закреплённый на панели задач в Windows 8, приведёт к ошибке о неверном пути, даже если указан параметр -game. Однако использование ярлыка на рабочем столе по прежнему работает. Это проблема со стороны Microsoft. [нужно проверить в ?]

Параметры

Эти параметры требуют QC файл. Все остальные должны быть "за" ними.

studiomdl [опции] <путь к QC>

Основные

-game <gamedir>: Указывает папку контента игры.
-quiet: Убирает некоторые сообщения в консоли, такие как отображение путей поиска
-x360: Включает вывод для Xbox 360, игнорируя Gameinfo.txt.
-nox360: Выключает вывод для Xbox 360, игнорируя Gameinfo.txt.
-nowarnings: Отключает предупреждения.
-maxwarnings <int>: Ограничивает количество выводимых предупреждений.

Анимация

-definebones: Смотрите $definebone.
-printbones: Выводит дополнительную информацию о костях в консоль.
-printgraph: Нужно сделать: Похоже, что выдаёт информацию xnode для каждой ноды
-overridedefinebones: Эквивалентно $unlockdefinebones в QC.
-checklengths: Выводит готовую для движка информацию о кейфреймах для каждой анимации.

Производительность

-fastbuild: Отключает обработку VTX для DX7, DX8, X360 и Software рендера (будет использовать только .dx90.vtx). Это ускоряет компиляцию.
-preview: Отключает триангуляцию модели. Это изменяет параметры рендера модели, вероятнее всего вызывая ухудшенную производительность или поломанный рендеринг в движке.
-fullcollide: Не обрезает сложные модели столкновения (Во всех играх начиная с используйте $maxconvexpieces).
-striplods: Пропускает все $lod команды.
-minlod <lod>: Пропускает все LODы выше заданного (смотрите $minlod).
-mdlreport <path\model.mdl>: Выводит информацию о производительности для уже скомпилированной модели. Для этой команды не требуется QC файл.
-perf: То же, что и -mdlreport.
-mdlreportspreadsheet: Выводит информацию о производительности каждого LOD как таблицу, разделённую через запятые в следующем формате:

Путь к VTX, расширение VTX, номер LODа (1 это корневой lod), количество треугольников, количество проходов отрисовки, количество используемых материалов

Нужно сделать: "количество проходов отрисовки" это "number of batches rendered", что это значит?

Должен использоваться с -mdlreport или -perf!

Примечание:Не записывает таблицу в память.

Отладка

-d: Выводит различные glview файлы (по 10 на каждый LOD на каждый VTX файл).
-h: Вывод hitboxов в консоль.
-n: Указывает плохие нормали.
-dumpmaterials: Выводит имена используемых материалы в консоль.
-i: Отключает предупреждения.
-t: Заменяет все материалы на стандартную розово-чёрную клетку.
-parsecompletion: Выводит просто обрабатываемое сообщение об успехе или провале компиляции.
-collapsereport: Выводит информацию о том, какие кости останутся, а какие будут пропущены.

Прочие

-nop4: Отключает интеграцию Perforce.
Совет:Если для вашей игры/мода не настроен Perforce, вы должны использовать этот параметр.
-verify: Скомпилирует модель, но не запишет результаты в память.
-a <normal_blend_angle>: Сглаживает стороны, угол между которыми равен или меньше указанному. Игнорирует всю информацию о нормалях на всех мешах.
-f (удалено начиная с ): Переворачивает нормали.
Нужно сделать: Что значит "Flip all triangles"?

Примечание:Вы можете добиться того же эффекта с помощью $body.

-vsi <path\[QC|MDL]>: Генерирует VSI файл из QC или MDL файла.
-stripmodel <path\model.mdl>: Облегчает вес модели, удаляя информацию о LODах.
-stripvhv <path\sp_hdr_x.vhv>: Облегчает (VHV) файл, удаляя информацию о LODах.
-makefile: Генерирует простой makefile для дальнейшей компиляции. Также проверяет QC файл на наличие ошибок, компилирует с параметром -quiet
-basedir <path>: Запускает StudioMDL в контексте указанного пути.
-tempcontent <path>: Добавляет указанный путь как путь поиска контента.

Нефункциональные

-r: "Tag reversed".
Нужно сделать: И что это значит?
-ihvtest: Вероятнее всего, должен проверять модель столкновений на наличие ошибок физики. Пропускает любой следующий аргумент.

Входные файлы

StudioMDL поддерживает разные форматы: SMD, DMX и OBJ для моделей-референсов, SMD и DMX для скелетной анимации, VTA и DMX файлы для повертексной и мимики. Counter-Strike: Global Offensive также поддерживает FBX, но с ограниченным функционалом: Мимика напрямую не поддерживается, как и FBX анимации, но SMD/DMX анимации могут быть использованы на FBX модели.

Примечание:Пока FBX технически поддерживает flex анимации, SMD файл требуется для генерации VTA файлов, делая использование FBX файлов для мимики бесполезным.

Выходные файлы

mymodel.mdl: Скелет, анимации, bbox и хитбоксы, материалы, список LODов…
mymodel.sw.vtx
mymodel.360.vtx
mymodel.dx80.vtx
mymodel.dx90.vtx: Оптимизированные VTX для software рендера, XBox 360, DirectX 7, 8 и 9 соответственно.
Примечание:Файлы .360.vtx это просто байтсвапнутые .dx90.vtx файлы.
mymodel.vvd: Оставшаяся независимая повертексная информация, включая UV карту
mymodel.phy: Модель столкновений

См. также

Типичные ошибки StudioMDL
Crowbar, популярный графический интерфейс для StudioMDL, также поддерживающий декомпиляцию моделей и другие продвинутые функции.
Studiocompiler, графический интерфейс для StudioMDL.
GUIStudioMDL, ещё один графический интерфейс.
Source Model Compiler, веб компилятор моделей и генератор QC файлов.
Fixing the 5% Weight Bone Link Cull, для Template:SFM

@@ Line 1: / Line 1: @@
 {{langsp}}
-: ''Для руководства по использованию StudioMDL, смотрите [[Compiling a model]]''
+: ''Для руководства по использованию StudioMDL, смотрите [[Compiling a model:ru|Компиляция модели]]''
-'''StudioMDL''' это [[command-line|консольная]] утилита, используемая для компиляции [[model|моделей]] из промежуточных форматов, экспортированных из программы 3D-моделирования, в бинарный формат .mdl, читаемым движком {{Source|4}}.
+'''StudioMDL''' это [[command-line|консольная]] утилита, используемая для компиляции [[3D Model/ru|моделей]] из промежуточных форматов, экспортированных из программы 3D-моделирования, в бинарный формат .mdl, читаемый движком {{Source|4}}.
 Её можно найти в: {{file|<nowiki>common\<gamename>\<gamefolder>\bin\studiomdl</nowiki>|exe}}.
 {{note|Имя "studio" отсылает к разработке {{hl|2}}, во время которого {{Valve|4.1}} использовали {{3dmax|2}} для создания их моделей.}}
-{{bug|Попытка использовать Studiomdl или его ярлык, закрепленный на панели задач в Windows 8, приведет к ошибке о неверном пути, даже если указан параметр <code>-game</code>. Однако использование ярлыка на рабочем столе по прежнему работает. Это проблема со стороны Microsoft.}}
+{{bug|Попытка использовать Studiomdl или его ярлык, закреплённый на панели задач в Windows 8, приведёт к ошибке о неверном пути, даже если указан параметр <code>-game</code>. Однако использование ярлыка на рабочем столе по прежнему работает. Это проблема со стороны Microsoft.}}
 == Параметры ==
@@ Line 48: / Line 48: @@
 : Отключает триангуляцию модели. Это изменяет параметры рендера модели, вероятнее всего вызывая ухудшенную производительность или поломанный рендеринг в движке.
 ; <code>-fullcollide</code>
-: Не обрезает сложные [[collision mesh|модели столкновения]] {{src07|since|addtext= используйте {{ent|$maxconvexpieces}}}}.
+: Не обрезает сложные [[collision mesh/ru|модели столкновения]] {{src07|since|addtext= используйте {{ent|$maxconvexpieces}}}}.
 ; <code>-striplods</code>
 : Пропускает все {{ent|$lod}} команды.
@@ Line 91: / Line 91: @@
 ;<code>-f</code> {{src07|removed}}
 :Переворачивает нормали. {{Todo|Что значит "Flip all triangles"?}}
+{{Note|Вы можете добиться того же эффекта с помощью {{ent|$body}}.}}
 ;<code>-vsi <path\[QC|MDL]></code>
 :Генерирует [[VSI]] файл из [[QC]] или [[MDL]] файла.
@@ Line 114: / Line 115: @@
 StudioMDL поддерживает разные форматы: [[SMD]], [[DMX]] и [https://ru.wikipedia.org/wiki/Obj OBJ] для моделей-референсов, [[SMD]] и [[DMX]] для скелетной анимации, [[VTA]] и [[DMX]] файлы для повертексной и мимики. {{csgo|2}} также поддерживает [[FBX]], но с ограниченным функционалом: [[Flex_animation|Мимика]] напрямую не поддерживается, как и FBX анимации, но SMD/DMX анимации могут быть использованы на FBX модели.
-{{note|FBX технически поддерживает flex анимации, а SMD файл требует генерации VTA файла, делая использование FBX файла для мимики бесполезным.}}
+{{note|Пока FBX технически поддерживает flex анимации, SMD файл требуется для генерации VTA файлов, делая использование FBX файлов для мимики бесполезным.}}
 == Выходные файлы ==
@@ Line 126: / Line 127: @@
 :Оптимизированные VTX для software рендера, XBox 360, DirectX 7, 8 и 9 соответственно. {{Note|Файлы <code>.360.vtx</code> это просто байтсвапнутые <code>.dx90.vtx</code> файлы.}}
 ;<code>mymodel.vvd</code>
-:Оставшаяся независимая повертексная информация, включая [[UV map]]
+:Оставшаяся независимая повертексная информация, включая [[UV map|UV карту]]
 ;<code>mymodel.phy</code>
 :Модель столкновений

Ru/StudioMDL (Source): Difference between revisions

Revision as of 04:52, 6 November 2023

Contents