View source for Ru/$alphatest

{{LanguageBar|title=<code>$alphatest</code>}}

{{this is a|shader parameter|name=$alphatest}} Он определяет бинарную маску, используемую для определения {{L|opacity|непрозрачности}}. Белый цвет обозначает полную непрозрачность, а чёрный - полную прозрачность. Промежуточные значения округляются к 0 или 1, если совместно не используется параметр <code>$allowalphatocoverage</code>. Этот эффект похож на <code>{{L|$translucent}}</code>, за исключением того, что он не может быть полупрозрачным (без {{W|Ru:Изогелия|полосности}}), визуализируется намного быстрее, и всегда правильно обрабатывается наложение (а не только  {{L|worldspawn|мир}}, исключая {{L|func_detail|элементы детализации}}).

== Синтаксис ==
 '''$alphatest	{{VT|Boolean}}'''

== Пример VMT ==
 {{L|LightmappedGeneric}}
 {
 	{{L|$basetexture}}		"glass\window001a"
 
 	'''$alphatest		1'''
 
 	'''[[#Дополнительные параметры|$alphatestreference]]	0.5'''
 
 	'''[[#Дополнительные параметры|$allowalphatocoverage]]	1'''
 }

== Дополнительные параметры ==
{{MatParamDef|$alphatestreference|nolink=1|float|Задает пороговое значение альфа-канала для перехода от непрозрачности к прозрачности. Значение "0.3" даст более широкий переход, а значение "0.7" - более тонкий переход.
{{expand|title=Примечания и предупреждения|
{{Important|Неочевидно, но значением этого параметра по умолчанию ''не'' "0.5", а равно "0.7" для оттенений LightmappedGeneric, UnlitGeneric и VertexLitGeneric. Чтобы избежать неожиданных результатов этот параметр следует указывать всегда.}}
{{bug|Обновление <code>$alphatestreference</code> в реальном времени с помощью {{L|Material proxies|подменных материалов}} не работает в игровом процессе и влияет только на проецируемые тени (например, от фонарика). {{Tip|Это ограничение можно обойти, используя <code>$alphatestreference 1</code>, и задав значения <code>{{L|$alpha}}</code> превышающие 1 (предельное значение для нормы), но это может вызвать проблемы с сортировкой).}} {{Tip|Для [[VertexLitGeneric|VertexLitGeneric]] на моделях можно использовать <code>[[$detail]]</code> с <code>$detailblendmode 3</code> и изменить значение <code>$detailblendfactor</code>. Детальная текстура должна быть копией <code>{{L|$basetexture}}</code> с отличающимся альфа-каналом.}}
}}
}} }} 

{{MatParamDef|$allowalphatocoverage|nolink=1|bool|Создаёт ступенчатые изменения прозрачности на основе значений альфа-канала. Может использоваться для получения более плавных краёв, а также значительного снижения эффекта мерцания при просмотре с дальнего расстояния.<br>Это может быть неочевидным, но параметр <code>$alphatestreference</code> применяется при использовании этого параметра для управления масками проецируемых теней, если у клиента отключено MSAA, а также в стандартной версии Hammer (где сглаживание недоступно).
{{Expand|title=Примечания и предупреждения|
{{warning|Для работы этого параметра необходимо включить {{L|Anti-aliasing#MSAA|сглаживание MSAA}}.<br>Количество переходов зависит от выбора кратности MSAA: при 2x MSAA будет меньше переходов прозрачности, чем при 8x MSAA. {{note|При 8x MSAA (Проверено в {{src13|2}}) будет 7 переходов прозрачности (9 - если считать полную непрозрачность и прозрачность).<br>
Ступени будут разделены следующим образом:<br>
<code>Нормированные значения: полностью прозрачное - 0.06 - 0.18 - 0.31 - 0.43 - 0.56 - 0.68 - 0.81 - 0.93 - полностью непрозрачное</code><br>
<code>Десятичные значения канала: полностью прозрачное - 15 - 46 - 80 - 110 - 143 - 174 - 207 - 238 - полностью непрозрачное</code><br>
(значения 0-255 округляются до большего целого. Используется формула <code>нормированное значение * 255</code>)
{{todo|Make a table for this. One that considers other MSAA Levels. There are always 1 fewer translucency steps than the number of MSAA samples (or one additional, if including fully transparent and fully opaque).}} }} }}
{{tip|Alpha to coverage works best with '''sharp, high-resolution alpha channels''', as this mitigates the inherent banding artefacts caused by the stock shaders' lack of sharpening when magnifying alpha to coverage textures.}}
}}
}}

== Сравнение ==
<div>
{|class=wikitable
! <code>$translucent</code>||<code>$alphatest</code>
|-
| [[File:Alphatest_preview_original.png|thumb|50%|center|Исходное изображение, обработанное с помощью $translucent]] || [[File:Alphatest_preview.gif|thumb|50%|center|Анимированный просмотр того же изображения, но с $alphatest. Первый кадр показывает эффект $allowalphatocoverage 1 (при 4x MSAA). Остальные показывают $alphatest с $alphatestreference в диапазоне от 0.1 до 0.9]]
|}
</div>
Обратите внимание, что правый круг, имеющий резкий переход альфа-канала почти не меняется.

==Смотреть также==
*<code>{{L|$alpha}}</code>
*<code>{{L|$distancealpha}}</code>
*<code>{{L|$vertexalpha}}</code>

{{ACategory|Shader parameters|alphatest}}