View source for Ru/Static Prop Combine

{{LanguageBar}}

'''Static Prop Combine''', или говоря неформально "автокомбайн", - функция в {{L|VBSP}} {{csgo|4}}. Она позволяет VBSP объединять вместе множество статичных пропов в один, либо автоматически, либо по указанным пользователем правилам. Это снижает общее количество статичных пропов на карте и количество запросов на отрисовку. Чтобы включить эту функцию, запускайте VBSP с параметром <code>-staticpropcombine</code>.
{{Tip|В {{src|4.1}} производится один запрос на отрисовку на каждый материал на каждой модели. Объединяя модели, которые используют одинаковые материалы, Вы снижаете количество запросов на отрисовку, что сильно помогает оптимизации. Со слов Valve производительность на карте Nuke повысилась на 40% после использования Static Prop Combine.
:{{Note|В связи с непостоянностью этой функции в VBSP, возможно более хорошим решением может стать использование {{TeamSpen|4.1}}. Помимо того, модели статичных пропов можно объединять вручную.}}
}}
{{tip|{{hammerpp|2}} позволяет объединять модели с использованием встроенного инструмента {{L|Hammer++/Propper++|Propper++}}}}

== Действие ==

Static Prop Combine проводит следующие действия:
;Нахождение пропов, которые будут объединены.
: Это делается на основе правил, указанных <code>spcombinerules.txt</code>, или автоматически на основе использования моделей.
: {{Note|<code>-staticpropcombine_considervis</code> - полезная команда, которая делает так, чтобы при работе Static Prop Combine брал в расчёт видимость.}}
;Сканирование исходного файла {{L|QC}} с целью взять определённую информацию.
: Это включает имена и положения основного и физического мешей, вертикальную ось модели, её скейл и является ли она вогнутой.
: QC находится при помощи параметра модели <code>qc_path</code>, который '''всегда''' считается относительным папке игры - даже если это полный путь!
: {{Note|К этому шагу относится множество ограничений, смотрите [[Ru/Static Prop Combine#Использование|Использование]] для деталей.}}
;Использовать эту информацию вместе с [[Ru/Static Prop Combine#Неполные QC|неполным QC]], чтобы сгенерировать свой QC
: {{L|$contentrootrelative}}, {{L|$appendsource}} и {{L|$addconvexsrc}} - новые команды, добавленные специально для Static Prop Combine. Последние две команды позволяют "добавить" геометрию к модели с каким-либо сдвигом, поворотом и изменённым размером.
;Вызвать {{L|studiomdl|StudioMDL}}, чтобы скомпилировать этот сгенерированный QC в комбинированную модель.
: Комбинированные модели всегда будут иметь <code>_autocombine_</code> в своём названии.
;Запаковка комбинированных моделей через {{L|BSPZIP}}
: {{Tip|Использование -keepsources отключит автоматическое удаление сгенерированных QC и распакованных файлов модели.}}

== Использование ==
=== Параметры VBSP ===
Смотрите {{L|VBSP}}.

=== Настройки в Hammer ===
Пропы, отличающиеся по указанным ниже параметрам, '''НЕ''' будут скомбинированы, если не будет указан подходящий параметр VBSP:
*'''Render in Fast Reflections''' (<code>-combineignore_fastreflection</code>) (отражаться в быстрых отражениях)
*'''Ignore Normals''' (<code>-combineignore_normals</code>) (игнорировать нормали)
*'''Disable Shadows''' (<code>-combineignore_noshadows</code>) (отключить тени)
*'''Disable Vertex lighting''' (<code>-combineignore_novertexlighting</code>) (отключить повертексное освещение)
*'''Disable Flashlight''' (<code>-combineignore_noflashlight</code>) (отключить фонарик)
*'''Disable Self-Shadowing''' (<code>-combineignore_noselfshadowing</code>) (отключить самозатенение)
*'''Disable ShadowDepth''' (<code>-combineignore_disableshadowdepth</code>) (отключить глубину теней)
В добавление, Вы можете ''отключить'' Static Prop Combine для определенных пропов, используя параметр '''Disable Prop Combine'''.

=== Подготовка пропов ===
Чтобы использовать проп со Static Prop Combine, Вы должны иметь исходные файлы модели.
{{Note|Чтобы использовать модели от Valve, Вы должны рекомпилировать их под другим названием - иначе версия модели, запакованная в VPK-архив игры заменит Вашу версию модели.}}
QC модели должен быть скомпилирован из папки контента игры. Для {{csgo|4}} это <code>SteamApps/common/content/csgo/</code>. 
{{Tip|На самом деле, место, в котором происходит поиск контента всегда будет <code>../../content/[название -game]</code>, относительно папки bin. Это может быть полезно для моддеров.}}


Есть немало ограничений, включающих:
* Будет распознан только первый параметр <code>{{L|$body}}</code>.
* <code>{{L|$model}}</code> не распознаётся.
* <code>{{L|$appendsource}}</code> и <code>{{L|$addconvexsrc}}</code> не распознаются.
* Значение <code>{{L|$upaxis}}</code> может быть только '''Z''' или '''Y'''.

=== Подготовка правил ===

Правила для Static Prop Combine объявлены в <code>scripts/hammer/spcombinerules/spcombinerules.txt</code>. Это стандартный [[KeyValues]]-форматированный текстовый файл. Каждый ввод следует этому формату:

<source>
	"example_combined" // Имя группы комбинирования, будет использовано для модели в игре
	{
		// Это неполный QC, который будет использован, чтобы генерировать комбинированные модели
		"qc_template_path"	"scripts/hammer/spcombinerules/qc_templates/example.qc"
		
		// Максимум моделей в одной комбинированной модели
		"cluster_limit" 8
		
		// Не комбинировать модели, которые находятся на большем, чем это, расстоянии
		"distance_limit" 12

		// Это модели, которые можно скомюинировать
		"peers"
		{
			"models/examples/example_A.mdl" ""
			"models/examples/example_B.mdl" ""
			"models/examples/example_C.mdl" ""
		}
	}
</source>

Если Вы не хотите утруждаться созданием правил, вы можете запустить  <code>-staticpropcombine_autocombine</code>. Однако, это может вызвать проблемы, если у Вас нет исходных файлов для моделей, которые попробует скомбинировать VBSP.
{{Bug|Пути в списке "peers" '''должны''' быть написаны с передними слэшами (/)!}}

== Неполные QC ==
'''Неполные QC''' - это файлы {{L|QC}} или {{L|QCI}}, которые содержат основу для QC, сгенерированных Static Prop Combine. В целом, они должны включать в себя только:
* {{L|$cdmaterials}}
* {{L|$surfaceprop}}
* {{L|$staticprop}}
* Любые {{L|$texturegroup|скины}}, использующиеся моделями. 
{{Tip|{{clr}}
* Static Prop Combine не объединяет модели, использующие разные скины.
* Так как объединенные модели нельзя указать в {{L|lights.rad}}, можно указать параметр {{L|$casttextureshadows}}, чтобы позволить этой модели отбрасывать {{L|Texture Shadows|текстурные тени.}}}}

=== Пример неполного QC ===
<source>
$cdmaterials models\props\de_venice\venice_window_3

$staticprop
$surfaceprop "Plaster"

$texturegroup venice_window_3 {
	{ "venice_window_3" }
	{ "venice_window_3_lit" }
}
</source>

== Смотрите также ==

*{{L|VBSP}}