View source for Ru/Adding PBR to Your Mod

{{LanguageBar|title = Добавление PBR в ваш мод}}


{{warning
|text =  ''Этот шейдер не работает с LightMapped брашами, однако технически он совместим с ними.''
{{code fix|text = В {{Path|src/utils/common/utilmatlib|cpp|icon=file}} найдите метод {{code|InitMaterialSystem}} и в самом конце добавьте {{code|g_pMaterialSystem->ModInit();}}, и попробуйте пересобрать инструменты. ''}}
{{note| В некоторых сторонних версиях {{L|VBSP}} эта проблема исправлена. Например в {{strata|2}}, {{mapbase|2}} & {{slamminsrc|2}}.}}
}}


[[File:PBR comparison.png|420px|thumb|right|<center>'''Сравнение PBR'''</center><br> Слева: Базовый шейдер Source Engine.<br> Справа: PBR шейдер.]]

{{distinguish|Adapting PBR Textures to Source}}

Цель этой статьи - показать вам, как реализовать [https://github.com/thexa4/source-pbr Thexa4's PBR шейдер] в вашем {{src13|4}} моде. Реализация этого шейдера позволит вам использовать metalness/roughness PBR поверхности в материалах.


== Вступление ==

{{main|Physically Based Rendering}}

== Требования ==

* Умение компилировать шейдеры.
* Умение компилировать решения.


{{note|Если вы не знаете, как компилировать шейдеры, или еще не работали с шейдерами в {{src|4}}, рекомендуется сначала прочитать эти статьи: {{L|Shader Authoring|Разработка шейдеров}} & {{L|Source_SDK_2013:_Your_First_Shader|Ваш первый шейдер}}}}

== Реализация == 

Прежде чем делать что-то, нам нужно скачать файлы.


Вы можете сделать это перейдя по ссылкам ниже, нажмите кнопку "Raw" и как только страница загрузится кликните правой кнопкой мыши и выберите "Save As...".

Все что от вас требуется, это сохранить эти файлы в директорию с исходным кодом вашего мода в {{Path|src/materialsystem/stdshaders/}}.

* [https://github.com/thexa4/source-pbr/blob/feature/pbr-base/mp/src/materialsystem/stdshaders/pbr_dx9.cpp pbr_dx9.cpp]
* [https://github.com/thexa4/source-pbr/blob/feature/pbr-base/mp/src/materialsystem/stdshaders/pbr_vs30.fxc pbr_vs30.fxc]
* [https://github.com/thexa4/source-pbr/blob/feature/pbr-base/mp/src/materialsystem/stdshaders/pbr_ps30.fxc pbr_ps30.fxc]
* [https://github.com/thexa4/source-pbr/blob/feature/pbr-base/mp/src/materialsystem/stdshaders/pbr_vs20b.fxc pbr_vs20b.fxc]
* [https://github.com/thexa4/source-pbr/blob/feature/pbr-base/mp/src/materialsystem/stdshaders/pbr_ps20b.fxc pbr_ps20b.fxc]
* [https://github.com/thexa4/source-pbr/blob/feature/pbr-base/mp/src/materialsystem/stdshaders/pbr_common_ps2_3_x.h pbr_common_ps2_3_x.h]


После того как вы завершите сохранение файлов, откройте {{Path|src/materialsystem/stdshaders/game_shader_dx9_*|vpc|icon=file}} в соответствии с базированием вашего мода (base/hl2mp/hl2/episodic), и добавьте файлы PBR внутрь {{Code|select=all|$Project "Shaders"}} вот так:
{{CodeBlock|lines=33|<nowiki>$Project "Shaders"
{
	$Folder "Header Files"
	{
		$File	"common_vertexlitgeneric_dx9.h"
		$File	"common_lightmappedgeneric_fxc.h"
		$File	"common_flashlight_fxc.h"
	}

	$Folder "Shader Source"
	{
		$Folder "fxc"
		{
			$File	"pbr_ps30.fxc"
			$File	"pbr_vs30.fxc"
			$File	"pbr_ps20b.fxc"
			$File	"pbr_vs20b.fxc"
		}

		$Folder "Headers"
		{
			$File	"pbr_common_ps2_3_x.h"
		}

		$File	"mymod_dx9_30.txt"
		$File	"mymod_dx9_20b.txt"
	}

	$Folder "Source Files"
	{
		$File	"pbr_dx9.cpp"
	}
}</nowiki>}}

Мы делаем это для того, чтобы когда мы обновим решение, файлы появились в обозревателе решений.


=== Компиляция шейдеров ===

Нам нужно скомпилировать шейдеры перед их использованием. Создайте 2 файла в  {{Path|src/materialsystem/stdshaders/}} с именем {{Code|select=all|mymod_dx9_30.txt}} и {{Code|select=all|mymod_dx9_20b.txt}}, и вставьте это внутрь:
{{CodeBlock|lines=11|src=mymod_dx9_30.txt|<nowiki>//
// vs 3.0   ps 3.0   shaders collection
//
//  These shaders are forced to compile as shader model 3.0
//  using the new compiler.
//	    _ps30.vcs
//	    _vs30.vcs
//

pbr_vs30.fxc
pbr_ps30.fxc</nowiki>}}

{{CodeBlock|lines=11|src=mymod_dx9_20b.txt|<nowiki>//
// Standard shaders collection
//
//  These shaders are compiled as the following shader models:
//	    _ps20.vcs
//	    _ps20b.vcs
//	    _vs20.vcs
//

pbr_vs20b.fxc
pbr_ps20b.fxc</nowiki>}}


Добавление этих новых текстовых файлов для компиляции шейдера, позволит вам скомпилировать PBR шейдер без влияния на стандартные {{Shader_Name|LightmappedGeneric}} шейдеры.

Это также значительно сократит время компиляции.



Теперь откройте {{Path|buildsdkshaders|bat|icon=file}} используя текстовый редактор и измените эту часть:

C:
{{CodeBlock|%BUILD_SHADER% stdshader_dx9_20b		-game %GAMEDIR% -source %SOURCEDIR%
%BUILD_SHADER% stdshader_dx9_30			-game %GAMEDIR% -source %SOURCEDIR% -dx9_30	-force30}}

На:
{{CodeBlock|%BUILD_SHADER% mymod_dx9_20b			-game %GAMEDIR% -source %SOURCEDIR%
%BUILD_SHADER% mymod_dx9_30				-game %GAMEDIR% -source %SOURCEDIR% -dx9_30	-force30}}

Это позволит вам использовать наши текстовые файлы, которые мы создали ранее, чтобы скомпилировать наш PBR шейдер.


{{ModernImportant|Если вы используете Visual Studio 2013 не забудьте поменять версию инстурментов в {{Path|buildsdkshaders|bat|icon=file}}


C:
{{CodeBlock|call "%VS100COMNTOOLS%vsvars32.bat"}}

На:
{{CodeBlock|call "%VS120COMNTOOLS%vsvars32.bat"}}
}}


После этого, мы можем начать компиляцию нашего шейдера запустив {{Path|buildhl2mpshaders|bat|icon=file}}, {{Path|buildhl2shaders|bat|icon=file}} или {{Path|buildepisodicshaders|bat|icon=file}} в зависимости от того, на чем базируется ваш мод.

Убедитесь что следовали статье {{L|Shader Authoring|Разработка шейдеров}} до того момента, когда вновь скомпилированные шейдеры будут правильно помещены в папку вашего мода {{Path|shaders/fxc/}}.

{{note|В зависимости от вашего ПК и сложности шейдера, это может занять некоторое время.}}


Если шейдеры скомпилировались без проблем, вернитесь назад в вашу директорию с исходым кодом {{Path|src/}} и запустите {{Path|createallprojects|bat|icon=file}}.


Откройте решение и скомпилируйте шейдеры в {{Code|Release}}.

{{note|Если {{Path|pbr_dx9|cpp}} нету в {{Code|Shader}} проекте. Убедитесь, что вы правильно подключили его в {{Code|.vpc}} файле который вы редактировали ранее.}}


== Исправления ==

Физические пропы становятся черными, если используют материал с PBR шейдером, после 2-3 секунд из-за Prop Sleeping. После указанного времени, пропы "запекают" свой свет для оптимизации.

Вы можете обойти это написав {{code|select=all|r_PhysPropStaticLighting 0}} в консоли или прописать в {{Path|src/game/client/c_physicsprop|cpp|icon=file}}.

Вот, как вы можете прописать это в коде:

Под {{code|select=all|<nowiki>#include "tier0/memdbgon.h"</nowiki>}} добавьте это:
<source lang="cpp">
#define PBR_CHANGE
</source>

Затем найдите {{code|select=all|ConVar r_PhysPropStaticLighting("r_PhysPropStaticLighting", "1");}} и замените его данным условием:
<source lang="cpp">
#ifdef PBR_CHANGE
	ConVar r_PhysPropStaticLighting( "r_PhysPropStaticLighting", "0" );
#else
	ConVar r_PhysPropStaticLighting( "r_PhysPropStaticLighting", "1" );
#endif
</source>


== Параметры ==

* {{ent|$basetexture}} - Albedo текстура.
* '''$normaltexture''' - карта нормалей (для обратной совместимости).
* {{ent|$bumpmap}} - карта нормалей (новый вариант указания карты нормалей).
* '''$mraotexture''' - Текстура с metalness на красном канале, roughness на зеленом канале и ambient occlusion на синем канале.
* '''$speculartexture''' - Включает использование цветной F0 (карты отражений), перезаписывая текстуру с metalness из MRAO текстуры. 
* '''$emissiontexture''' - Позволяет установить текстуру c emission. Включает [[Glowing_Textures#$selfillum|self illumination 
 .]]
* '''$useenvambient''' <{{ent|boolean}}> - Позволяет использовать самый низкий уровень mip карт кубмапов для окружающего освещения вместо кубов окружения. Может вызывать артефакты при перемещении пропов.
* {{ent|$envmap}} - По умолчанию <code>"env_cubemap"</code>, но также позволяет исвользовать свой вариант.
* {{ent|$surfaceprop}} - Связывает поверхность {{L|Material|материала}} или {{L|model|модели}} с набором физических свойств.
*<code>{{L|$model (VMT)|$model}}</code> - Должно иметь значение "1" если материал используется для пропа.
* {{ent|$translucent}} - Установка данного параметра на "1" включает Alpha-смешивание.
* {{ent|$basetexturetransform}} - Выглядит так: "center 0.5 0.5 scale 0.1025 0.1025 rotate 0 translate 0 0" для 2m на 2m текстуры.
* {{ent|$alphatest}} - Позволяет обрезать пиксели, когда альфа-значение опускается ниже {{L|$alphatest#Доп._параметры|$alphatestreference.}}
* {{L|$alphatest#Доп._параметры|$alphatestreference}} - Задаёт минимальное значение цвета альфа-канала, в котором эффект округляется до 255. Значение «.3» создаст более толстую форму, а значение «.7» создаст более тонкую форму.
* {{ent|%keywords}} - Список ключевых слов разделенных запятыми. Примеры ключевых слов: architectural,brown,gray,grime,hanger,industrial,metal,modern,shed,urban,wall,floor
* $useparallax <{{ent|boolean}}> - Использовать Parallax Occlusion Mapping.
* $parallaxdepth <{{ent|float}}> - Гулибна Parallax карты.
* $parallaxcenter <{{ent|float}}> - Средняя глубина Parallax карты

{{note|$emissiontexture - текcтура содержит цвет, это не маска.}}

{{bug|По умолчанию, все тени направлены относительно игрока, как если бы он держал источник света у себя в руках, а не использовал внешние.}}


== Примеры ==
=== Браш (не модельные поверхности), образец материала ===
{{CodeBlock|lines=10|<nowiki>PBR
{
        $basetexture      "pbr_asset/texture_albedo"
        $bumpmap          "pbr_asset/texture_normal"
        $mraotexture      "pbr_asset/texture_mrao"

        $envmap           "env_cubemap"
        $surfaceprop      "metal"
        $model            0
}</nowiki>}}

=== Модель, образец материала ===
{{CodeBlock|lines=10|<nowiki>PBR
{
        $basetexture      "models/pbr_asset/texture_albedo"
        $bumpmap          "models/pbr_asset/texture_normal"
        $mraotexture      "models/pbr_asset/texture_mrao"

        $envmap           "env_cubemap"
        $surfaceprop      "metal"
        $model            1
}</nowiki>}}

=== Модель, образец материала с картой отражений ===
{{Note|Канал Metalness игнорируется и {{Shader_Name|$basetexture|type=param}} обрабатывается как diffuse.}}
{{CodeBlock|lines=11|<nowiki>PBR
{
        $basetexture      "models/pbr_asset/texture_diffuse"
        $bumpmap          "models/pbr_asset/texture_normal"
        $mraotexture      "models/pbr_asset/texture_mrao"
        $speculartexture  "models/pbr_asset/texture_specular"

        $envmap           "env_cubemap"
        $surfaceprop      "metal"
        $model            1
}
</nowiki>}}


{{note|В {{Shader_Name|$envmap|type=param}} следует оставить<code>"env_cubemap".</code>}}

{{warning|Для работы материалов моделей, с использованием PBR, {{Shader_Name|{{L|$model_(VMT)|$model 1}}|type=param}} '''''ДОЛЖЕН'''''  быть добавлен в материал!}}

== Вывод ==

Вот и все! Теперь в вашем моде есть PBR.

{{ACategory|Modding}}
{{ACategory|Tutorials}}
{{ACategory|Shaders}}

==See also==
*[[PBR (shader)]]
{{ACategory|Modding}}
{{ACategory|Tutorials}}
{{ACategory|PBR}}