View source for Ru/VBSP

{{LanguageBar}}
{{Source topicon}}
{{map compile pipeline|source1}}
{{langsp|VBSP}}

{{finishtranslation}}

{{toc-right}}

'''VBSP''' — это инструмент, который компилирует сырой {{L|VMF}} файл в файл формата {{L|Binary Space Partition}}. Обычно за ним следуют {{L|VVIS}} и {{L|VRAD}}.

Что делает VBSP:

* конвертирует {{L|brush|браши}} в полигоны
* генерирует {{L|visleaf|листья видимости}}
* генерирует {{L|detail props}}
* swallow most {{L|internal entity|internal entities}} into {{L|the world}}
* заменяет {{L|$envmap|specular materials}} {{L|patch|пропатченными}} версиями, которые ссылаются на ближайшие {{L|env_cubemap|cubemap}}'ы
* встраивает {{L|entity block}}
* {{csgo}} объединяет группы {{L|prop_static|статичных пропов}} с одинаковым {{L|Material|материалом}}

Не смотря на то что результирующий {{L|BSP}} файл уже может быть использован, он не имеет контроля видимости (низкая производительность) и освещения.

{{bug|<code>.mdl</code> файлы имеющие <code>IDST1</code> заголовок не будут загружаться для VBSP, см. баги {{L|VRAD}}.}}

== Синтаксис ==

 vbsp [options...] vmf_file

Пример:

 "Half-Life 2\bin\vbsp.exe" -onlyents sdk_trainstation_01

Это повторно встроит entity block без влияния на остальной мир.

== Основные параметры ==

{{Note|<code>-onlyents</code> и <code>-keepstalezip</code> пометит карту как "устаревшую" встроив файл stale.txt в ее BSP. При загрузке "устаревших" карт в консоли движка появится предупреждение "This map is not final!!".}}

; <code>-v</code>
; <code>-verbose</code>
: Включает подробный вывод (также показывает больше параметров командной строки). Используется без каких-либо других параметров.
; <code>-onlyents</code>
: Импортирует из VMF только entities. Браши и internal entities не изменяются. Сохраняет текущие данные освещения.
; <code>-onlyprops</code>
: Обновляет только static и detail props (например, internal entities). Не генерирует .prt файл (making VVIS fail).
; <code>-glview</code>
: Записывает {{L|glview}} данные в директорию VMF. При использовании <code>-tmpout</code>, файлы будут записаны в <code>\tmp</code>.
; <code>-nodetail</code>
: Убирает {{L|func_detail}} браши. Остаётся только геометрия влияющая на видимость.
; <code>-nowater</code>
: Избавляется от брашей воды.
; <code>-low</code>
: Запускает как процесс с базовым приоритетом.
; <code>-vproject <directory></code>
: Перезаписывает переменную среды {{L|VPROJECT}}.
; <code>-game <directory></code>
: Определяет папку с файлом <code>gameinfo.txt</code>
; <code>-embed <directory></code>
: Встраивает содержание <directory> в packfile

== Расширенные параметры ==

{{ColumnBox|count=2|
; <code>-novconfig</code>
: Не открывать графический интерфейс при ошибках vproject.
; <code>-threads</code>
: Контролирует количество используемых потоков (threads) (по-умолчанию — количество процессоров (x2 для процессоров с Hypertreading/SMT) на вашем компьютере).
; <code>-verboseentities</code>
: Если использован параметр <code>-v</code>, то подробный вывод для подмодулей отключается.
; <code>-noweld</code>
: Не объединять вершины граней.
; <code>-nocsg</code>
: Не вырезать пересекающиеся участки брашей.
; <code>-noshare</code>
: Emit unique face edges instead of sharing them.
; <code>-notjunc</code>
: Не исправлять t-junctions.
; <code>-noopt</code>
: По-умолчанию, vbsp убирает "наружную оболочку" карты, которая состоит из граней, которые вы не можете видеть, потому что вы не можете выбраться за карту. <code>-noopt</code> отключает такое поведение.
; <code>-noprune</code>
: Don't prune neighboring solid nodes.
; <code>-nomerge</code>
: Don't merge together chopped faces on nodes.
; <code>-nomergewater</code>
: Don't merge together chopped faces on water.
; <code>-nosubdiv</code>
: Don't subdivide faces for lightmapping.
; <code>-micro <#></code>
: vbsp предупредит, если результирующие браши будут меньше указанного объема (по-умолчанию: 1.0).
; <code>-fulldetail</code>
: Mark all detail geometry as normal geometry (so all detail geometry will affect visibility).
; <code>-leaktest</code>
: Остановит процесс, если будет замечена утечка. Файл утечки будет создан и записан в <название vmf>.lin, вне зависимости от использования этого флага.
; <code>-bumpall</code>
: Force all surfaces to be bump mapped.
; <code>-snapaxial</code>
: Snap axial planes to integer coordinates.
; <code>-block # #</code>
: Control the grid size mins that vbsp chops the level on.
; <code>-blocks # # # #</code>
: Устанавливает минимальное и максимальное значение сетки для vbsp.
; <code>-dumpstaticprops</code>
: Записывает все static props в staticprop*.txt
; <code>-dumpcollide</code>
: Записывает файлы с информацией о коллизиях.
; <code>-luxelscale #</code>
: Scale all lightmaps by this amount (default: 1.0).
; <code>-lightifmissing</code>
: Force lightmaps to be generated for all surfaces even if they don't need lightmaps.
; <code>-localphysx</code>
: {{todo|???}}
; <code>-keepstalezip</code>
: Keep the BSP's zip files intact but regenerate everything else.
; <code>-replacematerials</code>
: Замена материалов в соответствии с materialsub.txt в content\maps
; <code>-FullMinidumps</code>
: Записывает полный дамп при краше.
}}

=== {{CSGO add|Static Prop Combine}} === 
{{ColumnBox|count=2|
; <code>-StaticPropCombine</code>
: Merges static props together according to the rules defined in <code>scripts/hammer/spcombinerules/spcombinerules.txt</code>. This lowers the number of draw calls, increasing performance. It can also be used to lower the number of static props present in a map. See {{L|Static Prop Combine}}.
; <code>-StaticPropCombine_AutoCombine</code>
: Automatically generate static prop combine rules for props that VBSP deems should be combined. {{Note|This does not write to <code>spcombinerules.txt.</code>}}
; <code>-StaticPropCombine_ConsiderVis</code>
: Instead of using the distance limit, combine all props in the group that share visclusters.
; <code>-StaticPropCombine_SuggestRules</code>
: Lists models sharing the same material that should be added to <code>spcombinerules.txt</code>.
; <code>-StaticPropCombine_MinInstances <{{L|int}}></code>
: Установите минимальное количество пропов в объединенной группе, необходимое для создания объединенного пропа.
: {{Tip|Valve had this set to 3 for the new Dust 2.}}
; <code>-StaticPropCombine_PrintCombineRules</code>
: {{Confirm|Prints the combine rules? Hasn't been working for me.}}
; <code>-StaticPropCombine_ColorInstances</code>
: {{Confirm|Does this color the instances?}}
; <code>-KeepSources</code>
: Don't delete the autogenerated QCs and unpacked model files after finishing.
; <code>-CombineIgnore_FastReflection</code>
: Combine props, even if they have differing '''Render in Fast Reflections''' settings.
; <code>-CombineIgnore_Normals</code>
: Combine props, even if they have differing '''Ignore Normals''' settings.
; <code>-CombineIgnore_NoShadow</code>
: Combine props, even if they have differing '''Disable Shadows''' settings.
; <code>-CombineIgnore_NoVertexLighting</code>
: Combine props, even if they have differing '''Disable Vertex lighting''' settings.
; <code>-CombineIgnore_NoFlashlight</code>
: Combine props, even if they have differing '''Disable flashlight''' settings.
; <code>-CombineIgnore_NoSelfShadowing</code>
: Combine props, even if they have differing '''Disable Self-Shadowing''' settings.
; <code>-CombineIgnore_DisableShadowDepth</code>
: Combine props, even if they have differing '''Disable ShadowDepth''' settings.
}}

== Нефункциональные параметры ==

; <code>-linuxdata</code>
: Force it to write physics data for linux multiplayer servers. ( It will automatically write this data if it finds certain entities like info_player_terrorist, info_player_deathmatch, info_player_teamspawn, info_player_axis, or info_player_coop. )
; <code>-nolinuxdata</code>
: Force it to not write physics data for linux multiplayer servers, even if there are multiplayer entities in the map.
; <code>-virtualdispphysics</code>
: Use virtual (not precomputed) displacement collision models 
; <code>-xbox</code>
: Включить обязательную оптимизацию для Xbox 1.

== См. также ==
* {{L|Map Compiling Theory|Теория компиляции карт}}
* {{L|Decompiling Maps|Декомпиляция карт}}

{{sdktools|suf=:ru}}

{{ACategory|Level Design}}

{{sdktools}}

{{ACategory|Official Source Tools}}
{{ACategory|Source 1 BSP compilers}}