Propper++

From Valve Developer Community
< Ru‎ | Hammer++
Jump to navigation Jump to search
English (en)Português do Brasil (pt-br)Русский (ru)Translate (Translate)

Инструмент Propper++ в Hammer++ Hammer++ позволяет превращать брашворк в модели, или объединять разные модели в одну. Он полностью заменяет устаревший Propper(en).

Интерфейс Propper++

Установка

Перед использованием Propper++ нужно указать StudioMDL(en) в Tools -> Options -> Build Programs -> MDL executable. Это компилятор, который сделает модели для движка.

Warning.pngПредупреждение: (только в Ветвь Team Fortress 2) 64-битный StudioMDL не работает. Вы должны использовать 32-битный, который находится в папке bin (не bin/win64!).

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

Браши

Выберите браши, которые Вы хотите превратить в модели. Если Вы хотите превратить их в одну модель, а не в несколько, то сначала нужно их сгруппировать - либо через инструменты группирования(en), либо через превращение их в одну энтити. Затем откройте Propper++ в меню Tools -> Propper++ или используя сочетание клавиш Ctrl + Shift + P.

Вы увидите множество опций. Практически все из них сейчас не нужны, кроме Model Path + Name сверху. Это путь к итоговой модели относительно папки models. Название в конце параметра станет именем Вашей модели. Поменяйте его на что-нибудь подходящее для модели, например props_furniture/moykrutoystul.

Нажмите Build + Compile, и браши будут скомпилированы в модель. Превращенная геометрия будет перенесена в визгруппу Propper. Этим можно воспользоваться, чтобы при необходимости вернуть изначальную геометрию (например чтобы её отредактировать)

Note.pngПримечание: Так как получившаяся модель - собственный ассет, необходимо запаковать его вместе с проектом. Такие инструменты, как CompilePal(en) или VIDE(en) могут помочь Вам с этим.
Warning.pngПредупреждение: Осторожно с превращением очень детализированной геометрии (сотни, тысячи граней). Получится сложная модель коллизии, которая вызовет плохую производительность. В таком случае стоит или разделить геометрию на несколько групп, или указать группу брашей как упрощённую модель коллизии, используя настройку Entity name as physics mesh
Icon-Bug.pngБаг:Брашевые энтити вне FGD(en) не распознаются Propper++.


Изменение размера пропов

В добавок к превращению брашей в модели, Propper++ поддерживает перенос моделей в другие папки и соединение с другими моделями. Пропущенные через Propper++ модели по умолчанию сохраняют свои скины, бодигруппы и скейлинг. Это полезно, например, для лёгкого изменения размеров prop_static(en) в играх, которые это не поддерживают, вместо использования неудобного метода декомпиляции и последующей рекомпиляции моделей вручную.

Чтобы изменить размер prop_static(en) во всех направлениях одновременно, превратите его в prop_dynamic(en) и поменяйте Model Scale, или же добавьте значение modelscale, выключив SmartEdit(en).

Tip.pngСовет: В Hammer++ Hammer++ размер выделенного в 3D окне пропа можно изменить, зажав Ctrl и вращая колёсико мыши. Если зажать Shift, шаг снизится с 0.5 до 0.05.

Также можно поменять Scale в меню Propper++. Можно использовать отрицательные значения, чтобы отразить модель по какой-либо из осей.

Объединение брашей и моделей

Также можно объединять браши и модели в общую модель. Чтобы это сделать, нужно сгруппировать выделение, используя инструменты группирования(en), а затем использовать Propper++ как обычно.

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

Редактирование перед компиляцией

Иногда полезно изменить сгенерированные файлы модели. Например, чтобы добавить параметры (такие как $texturegroup(en)), или чтобы изменить меши. В Propper++ это поддерживается за счёт двухэтапного процесса: Build и Compile. Обычно оба этих шага запускаются одновременно, но при необходимости их можно запустить вручную по отдельности..

  • Кнопка Build сгенерирует файлы QC(en) и SMD(en) для модели.
  • Кнопка Compile отправит сгенерированные файлы в компилятор, а потом заменит выделенные объекты, если включена такая опция.

Таким образом, вы можете нажать Build-Only, отредактировать получившиеся файлы, а затем нажать Compile-Only, чтобы скомпилировать модель.

Tip.pngСовет: Используйте кнопку Explore, чтобы быстро открыть папку со сгенерированными файлами.

Передвижение ориджина модели или точки освещения

По умолчанию, ориджин(en) сгенерированной модели и точка освещения(en) распожены в центре границ(en) выбранной геометрии.

При использовании Propper++ на брашевой энтити с параметром origin будет использовано значение из этого параметра Положение освещения можно заменить, указав свою точку освещения(en) на любой выбранной модели. Propper++ будет использовать первую найденную точку освещения как новый $illumposition(en).

Confirm.pngПодтвердить: Что насчёт использования Propper++ на группах, включающих пропы? Может ли ориджин быть указан каким-либо другим методом?


Добавление скинов

Смотрите $texturegroup(en), чтобы получить больше информации про добавление скинов.

Откройте Ваш кастомный QC(en), созданный Propper++, и добавьте следующий код куда-нибудь внутрь файла:

$cdmaterials(en) "models/mycustomfolder" "models/lorem/mycustomfolder2"
$texturegroup(en) "skinfamilies"
{
	{ "default_texture"  } // Скин 0 - по умолчанию
	{ "custom_texture_1" } // Скин 1
	{ "custom_texture_2" } // Скин 2
	{ "custom_texture_3" } // Скин 3
	[...]
}

Стандартный вариант (скин 0) должен быть текстурой по умолчанию, а скины 1 - 32 должны быть текстурами, заменяющими обычную.

Если Вы хотите заменить больше одной текстуры, Вы можете добавить следующий код:

$cdmaterials "models/mycustomfolder" "models/lorem/mycustomfolder2"
$texturegroup "skinfamilies"
{
	{ "(1)random_texture" "(2)random_texture" [...] } // Случайные стандартные текстуры как пример
	{ "baggagecarousel04" "helicopter_news2"  [...] } // Пример
	{ "baggagecarousel04" "acvent05"          [...] } // Пример
	{ "acunit01"          "acvent05"          [...] } // Пример
	[...]
}

Первая колонка заменит первую стандартную текстуру (1), а вторая колонка будет заменять вторую текстуру (2).

После добавления скинов нужно нажать кнопку Compile Only в меню Propper++, чтобы рекомпилировать модель.

Tip.pngСовет: Сконвертируйте несколько наборов брашей с разными текстурами, которые будут использованы в скинах. Это освободит Вас от ручного создания материалов для скинов.

Массовая конвертация

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

Дисплейсменты

Дисплейсменты(en) так же можно конвертировать, используя Propper++. Однако в отличие от брашей, для дисплейсментов не будет создана коллизия. Это намеренно сделанная особенность, так как автоматически сгенерированная модель коллизии для дисплейсментов была бы очень дорогой(en) и возможно вызывала бы задержки на сервере (каждый треугольник должен быть отдельной невогнутой частью коллизии). Если нужна коллизия для дисплейсментов, сделайте их упрощённые версии из брашей и укажите их как Entity name as physics mesh.

Также невозможно использовать смешанные текстуры: после конвертации появятся только первая текстура в материале, так как модели не поддерживают повертексное смешивание текстур.

Объединение статичных пропов

Сравнение производительности 240 статичных пропов деревьев на пустой карте: не используя настроек, используя расстояние пропадания и объединение через Propper++.
Скопление коробок с использованием r_colorstaticprops 1. Вместе они хороший кандидат для объединения, т.к. это сократит 3 запроса на отрисовку до 1.

Propper++ так же может быть использован для объединения пропов с целью оптимизации по типу Static Prop Combine(en) в более новых играх. Демонстрация прироста производительности от объединения статичных пропов в один находится справа.

Объединение улучшает производительность, уменьшая количество запросов на отрисовку. Вкратце: запросы на отрисовку - метод, которым пользуется процессор, чтобы сказать видеокарте, что и как нужно отрисовать. Это взаимодействие медленное: современные игры обычно стараются как можно больше сократить количество запросов на отрисовку. Каждый проп в игре будет создавать новый запрос на отрисовку. Если в пропе несколько материалов, то каждый из них тоже будет создавать новый запрос на отрисовку. Объединение пропов сниажет количество запросов на отрисовку. Со слов Valve: использование объединения статичных пропов на картах CS:GO (которые используют очень много статичных пропов) улучшило производительность на 40%.

При поиске моделей для объединения следуйте этим принципам:

  • Объединять можно только те модели, которые используют одни и те же материалы - иначе пользы от объединения не будет. Разные материалы всё ещё будут создавать новые запросы на отрисовку. Например, не объединяйте дерево с коробкой, но объединяйте коробку с другими такими же коробками.
  • Объединять стоит только модели, которые находятся рядом. Объединение моделей расширяет границы пропов, что делает отрезку его рендера ареапорталами или чем-либо ещё менее частой.
  • Не нужно объединять далёкие друг от друга модели с коллизией, так как движок физики не сможет эффективно оптимизировать такие модели. Если этого нельзя избежать, то лучше целиком отключить коллизию или сделать упрощённую физическую модель вручную.
  • Не объединяйте объекты, проходящие через границу тени, если материалы этой модели не поддерживают повертексное освещение (т.е. ни один из материалов не имеет $bumpmap(en) или $phong(en)). Объединенный проп будет использовать освещение только из своего центра и по этой причине может смотреться странно в месте, где проходит тень. Можно разделить объединенный проп напополам по границе тени, чтобы обе стороны получали правильное освещение.

Чтобы легко найти скопления пропов, которые нужно объединить, используйте команду r_colorstaticprops 1 в игре. Каждый проп со своим цветом создаёт свой запрос на отрисовку. После объединения пропов, Вы заметите, что они имеют один цвет (что хорошо).

Если Вы видите плохое освещение на объединенных пропах (например, такие пропы становятся очень тёмными), то причиной этого может быть точка освещения, находящаяся в другой геометрии. Чтобы это исправить, используйте info_lighting(en).

Note.pngПримечание: Помните, что объединение множества пропов может привести к заметному увеличению размера файла карты. Однако, если Ваша игра поддерживает сжатие BSP(en), то это не станет большой проблемой, так как модели имеют очень хорошую степень сжатия.
Note.pngПримечание: Движок имеет ограничение по количеству вертексов в меше. Propper++ автоматически разделяет модель на разные меши, если есть больше чем 65535 вертексов.
Warning.pngПредупреждение: При объединении множества детализированных моделей компилятор может крашнуться. В таком случае объедините сначала одну половину выделения, а потом вторую отдельно.

Освещение статичных пропов

В некоторых играх prop_static(en) поддерживает использование лайтмапа, сгенерированного VRAD(en). Однако у этой функции есть большие ограничения:

  • Пропы с пересекающейся UV(en)-развёрткой или несколькими материалами не могут быть правильно освещены.
  • Брашевая геометрия, превращённая в модели, не может быть правильно освещена в связи с искажённой UV(en)-развёрткой.
  • Материалы, использующие $bumpmap(en) или $phong(en) не могут быть освещены.

Функция Lightmap Atlas обходит все эти ограничения. Она берёт выбранные модели и (или) браши и генерирует одну непересекающуюся UV(en)-развёртку (или "атлас") для всей модели, а потом накладывает на неё текстуры. Она также автоматически убирает карты нормалей и фонг с материалов.

Чтобы использовать эту функцию, включите Generate atlas.

Измените ширину и высоту атласа на своё усмотрение. Внешний вид будет зависеть от самой геометрии, от количества объединенных объектов и так далее, так что экспериментируйте с этим. Оставляйте разрешение степенью двойки. Более высокие разрешения будут иметь более хорошее качество текстур и больший вес. Это не размер лайтмапа - он указывается отдельно в настройках prop_static(en).

Есть 4 формата сжатия на выбор: DXT1, DXT5, RGB888 и RGBA8888. Форматы DXT сжаты, остальные - нет, и поэтому имеют улучшенное качество, но гораздо больший размер файла. DXT1 и RGB888 не поддерживают прозрачность, снижая размер файла. Не нужно использовать DXT5 или RGBA8888, если не нужен альфа-канал для чего-либо (например для маски для $envmap(en))

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

После построения и компиляции модели она будет готова для лайтмапного освещения. За подробностями посмотрите статью prop_static(en). Если текстура смотрится слишком мыльно, избавьтесь от невидных полигонов (сделайте их nodraw), увеличьте разрешение атласа и уменьшите количество объединяемых пропов.

Текстуры-атласы сохраняются в Material Path + Model Name.

Warning.pngПредупреждение: Лайтмапы на пропах не только много весят, но и долго компилируются. Не надо их включать на всём подряд.
Warning.pngПредупреждение: Браши занимают много пространства в атласе, так как их текстуры обычно большие и часто повторяются. Это может привести к тому, что все остальные элементы (например модели или другие более маленькие браши) станут непропорционально низкокачественным в атласе. Желательно использовать модели. Если же Вам нужно использовать браши, используйте nodraw на как можно большем количестве сторон, чтобы те не появлялись в атласе.

Запечение Ambient Occlusion

Сравнение внешнего вида моделей, сгенерированных при помощи Propper++, с AO и без (слева: без AO, справа: с запеченным AO)

Добавлено в сборке 8870: теперь в атлас можно запечь ambient occlusion. Это полезно для создания более естественно выглядящих пропов, так как VRAD VRAD по умолчанию не использует ambient occlusion.

Для включения этой функции выставьте галочку у Bake AO. У запечения есть некоторые настройки, которые можно изменить.

Samples
Количество семплов (проб), влияющее на качество AO. Большее количество семплов займёт больше времени. Hammer++ распределяет запечение на несколько потоков, но этот процесс всё равно может занять несколько секунд с высоким количеством семплов.
Radius
Радиус эффекта AO. Чем меньше значение, тем менее заметны изменения.
Margin
Отступ от краёв AO для избежания проблем. Бóльшие значения предотвращают заметные швы, однако они могут вызвать наплыв эффекта на соседние UV-острова.
Opacity
Непрозрачность AO при умножении на основную текстуру.

Настройки

  • Model Path + Name

Это путь и название модели, которая будет сгенерирована. Он находится относительно папки models в Вашей игре. Например, в Garry's Mod, "propper/moykrutoystul" сгенерирует модель по этому пути:

<path-to-exe>/garrysmod/models/propper/moykrutoystul.mdl

Все маркеры $vmf будут заменены на название текущего VMF(en). Это удобно для организации файлов и для отсутствия конфликтов между картами, если они используют модели с одинаковыми названиями.

  • Add incremental suffix if already existing MDL name is found

Когда включено, то при нахождении MDL(en) с таким же названием, как в Model Path + Name, к названию модели будет добавлен номер (_0, _1 и так дале). Этот номер будет увеличиваться, пока не найдётся неконфликтующее название. Параметр полезен для предотвращения случайной перезаписи существующих моделей, после которой прежние файлы было бы невозможно восстановить. Отключите эту опцию, если Вы хотите перезаписать модель новыми файлами (или просто удалите существующую модель).

  • Source file directory

Это место, где будут расположены файлы, необходимые для компиляции итоговой модели. Как и в предыдущих параметрах, этот путь может быть либо относительно директории игры, либо полным путём до любой директории в файловой системе. Этот параметр так же поддерживает маркеры $vmf. Пример с Garry's Mod: modelsrc/propper/rpassets положит исходные файлы (SMD(en) и QC(en)) в эту директорию:

<path-to-exe>/garrysmod/modelsrc/propper/rpassets

  • Material path

Это папка, в которой появятся сконвертированные материалы. Материалы для брашей обычно используют шейдер LightmappedGeneric(en), несовместимый с моделями, так что Propper++ переделывает материалы в шейдер VertexLitGeneric(en). Как и ранее, этот параметр относителен папки materials в директории игры. Поддерживаются маркеры $vmf, которые автоматически заменяются на название файла, который сейчас открыт в Hammer. Пример использования с Garry's Mod: выставленный путь models/propper/rpassets сгенерирует материалы в эту директорию:

<path-to-exe>/garrysmod/materials/models/propper/rpassets

  • Entity name as physics mesh

Указывает, какая названная энтити должна быть использована как модель коллизии. Это полезно для создания упрощённых физических моделей для сложной геометрии. Поставив этот параметр на $self, модель будет использовать выделение как физическую модель. Если оставить этот параметр пустым, то коллизии не будет. Имена энтити не будут работать, если выделить несколько групп объектов.

  • Entity classname

Если включен параметр Creaty entity after compile, то выделенные объекты будет заменены энтити с этим классом и сгенерированной моделью.

  • Surfaceprop

$surfaceprop(en) модели. Если оставить пустым, то материал, который покрывает самую большую площадь, будет выбран как материал поверхности. Если в выделении есть модели, то будет использован $surfaceprop(en) той модели, которая появляется чаще остальных.

  • Scale

Размер по осям X, Y и Z для модели. Поддерживаются отрицательные числа: если их ввести, то Propper++ автоматически исправит направление, в которое смотрят стороны.

  • Mass

Заменяет массу модели. Если оставить пустым, то масса будет автоматически вычислена компилятором через $automass(en).

  • Smoothing angle

Сглаживает нормали вертексов, угол между которыми меньше, чем значение этого параметра. Похож на -smooth в VRAD(en). 0 полностью отключает сглаживание. Полезно для округлых форм: цилиндров, сфер, арок.

  • Relocate materials

Если включено, передвигает брашевые материалы в папку, указанную в Material path. Это предотвращает замену обычных материалов на новые.

  • Rename shaders

Если включено, то шейдеры LightmappedGeneric(en), WorldVertexTransition(en) и Water(en) будут переименованы в VertexLitGeneric(en).

  • $concave collision

Включает $concave(en) (вогнутые) модели коллизии. Если выключено, то компилятор сделает shrinkwrap на модели, чтобы создать новую модель коллизии.

  • Remove bad collision faces

Маленькие или тонкие стороны брашей могут вызывать проблемы при компиляции коллизии. Этот параметр автоматически удалит такие стороны (добавив $remove2d в $collisionmodel(en)).

  • Skip nodraw faces

Пропускает добавление полигонов, покрытых tools/toolsnodraw, к видимой геометрии. Они всё ещё будут добавлены к модели коллизии.

  • Wait for keypress after compile

Если включено, то закрытие окна компилятора не произойдёт, пока не будет нажата какая-либо клавиша. Полезно для проверки на предупреждения или ошибки.

  • Create entity after compile

Если включено, то заменит выделение новой энтити со сгенерированной моделью.

  • Move selection to 'Propper' visgroup

Если включено, то выделение сохраняется в визгруппу под названием "Propper" после компиляции.

  • $casttextureshadows

Добавляет команду $casttextureshadows(en) в QC(en). Полезно для работы теней от полупрозрачных поверхностей в VRAD(en) (с -textureshadows) без ручного добавления модели в lights.rad(en)

  • Lightmap Atlas

Смотрите секцию про продвинутое использование выше.

Параметры

Propper++ использует следующие параметры:

Origin (origin) <origin(en)>
Если в данной группе есть только одна энтити, то параметр Origin будет использован, как ориджин получившейся SMD-модели.
Pitch Yaw Roll (Y Z X) (angles) <углы(en)>
Поворачивает получившуюся SMD-модель.
Name (targetname) <имя объекта(en)>
Lighting Origin (lightingorigin) <целевой объект(en)>
Выставляет $illumposition(en) на основе положения указанной именной энтити.
Model (model) <путь к модели(en)>
MDL(en) для использования.
Skin (skin) <целое число(en)>
Скин(en) используемой MDL(en).
Bodygroup (body) <целое число(en)>
Бодигруппы(en) модели(en).
Uniform Model Scale (modelscale) <число с плавающей запятой(en)>
Масштабирует получившийся меш по всем осям.