Ru/Detail props: Difference between revisions
No edit summary |
No edit summary |
||
Line 24: | Line 24: | ||
Detail props могут быть размещены в ручную в паре с [[prop_detail]] и [[prop_detail_sprite]] энтити, но это редкая практика. | Detail props могут быть размещены в ручную в паре с [[prop_detail]] и [[prop_detail_sprite]] энтити, но это редкая практика. | ||
{{ | {{tip|Стандартный VBSP файл находится в root\detail.vbsp (например Half-life 2/ep2/detail.vbsp), но вы можете создать и свой собственный, только не забудьте изменить в Valve Hammer переменную “Detail vbsp file” во вкладке (Map > Map Properties…) | ||
.}} | .}} | ||
{{ | {{tip|Используйте брашевую энтити {{l4D add|[[func_detail_blocker]]}} (впервые появился в Left 4 Dead) для подавления генерации detail sprites в нежелательных зонах. | ||
.}} | .}} | ||
Line 217: | Line 217: | ||
: Это имя дитейла указанного в VMT материала <code>%detailtype</code>. | : Это имя дитейла указанного в VMT материала <code>%detailtype</code>. | ||
:; <code>density <[[float]]></code> | :; <code>density <[[float]]></code> | ||
:: Плотность генерации detail пропов на поверхности материала. {{ | :: Плотность генерации detail пропов на поверхности материала. {{tip|<code>Значение 1000000</code>означает, что на каждом юните будет по 1 пропу. Средняя плотность детейлов 1000-1500. (128 юнитов - 2 пропа - 256 плотность) | ||
}} | }} | ||
; Group | ; Group | ||
Line 234: | Line 234: | ||
; <code>minangle <float></code> | ; <code>minangle <float></code> | ||
; <code>maxangle <float></code> | ; <code>maxangle <float></code> | ||
: Регулирует генерацию на крутых поверхностях. Стандартное значение для обоих 180 градусов (без ограничений). . {{ | : Регулирует генерацию на крутых поверхностях. Стандартное значение для обоих 180 градусов (без ограничений). . {{tip|Если выставить 180 и 180 (min-max) Ваша трава будет расти даже на потолке. Если выставить 0 и 180, трава будет расти всюду, кроме потолка. 45 и 180, стена под косым углом ВНИЗ - редкая растительность. 180 и 45, стена под косым углом ВВЕРХ - редкая растительность. Значение 0 и 90 - трава только на земле и склонах, но на прямой стене и потолке её не будет. | ||
}} | }} | ||
==== | ==== Спрайты ==== | ||
; <code>sprite <[[int]]|X, Y, W, H, VTF | ; <code>sprite <[[int]]|X, Y, W, H, VTF координаты и масштабы></code> | ||
: | : Это координаты на общей VTF текстуре, откуда берется рендер каждой отдельной травинки. | ||
:* X/Y | :* X/Y это горизонтальная и вертикальная координаты. | ||
:* W/H | :* W/H это размеры (ширина, высота). [[texel]]s | ||
:* | :* {{bug|Любая пользовательская текстура растительности должна быть краткой дефолтной detail\detailsprites! Иначе будет искривление рендера.. Править это можно вот тут. | ||
[[Detail props/Aspect ratio fix|Get the fix here.]]}} | |||
; <code>spritesize <normal|U, V> <[[float]]|W, H></code> | ; <code>spritesize <normal|U, V> <[[float]]|W, H></code> | ||
: | : Размеры спрайта в самой игре, (U/V) - смещение.относительно точки опоры и (W/H) Ширина и высота спрайта. (U/V лучше не трогать) | ||
; <code>spriterandomscale <normal></code> | ; <code>spriterandomscale <normal></code> | ||
: | : Размер спрайта не должен быть указан как 1 и 1, его не будет в игре. Оптимальный размер от 10 до 20. | ||
; <code>detailOrientation <int></code> | ; <code>detailOrientation <int></code> | ||
: | : Будет ли спрайт поворачиваться своим “лицом” к камере игрока. | ||
:* 0: | :* 0: не будет. | ||
:* 1: | :* 1: спрайт всегда смотрит в камеру игрока, даже когда игрок стоит над спратом, тот словно наклоняется. | ||
:* 2: | :* 2: Спрайт всегда смотрит в камеру игрока, однако вращается только вокруг Z оси, по кругу. | ||
==== | ==== Шейпы (сложные фигуры) ==== | ||
[[File:Detail shape tri.jpg|thumb|200px|<code>sprite_shape tri</code>]] | [[File:Detail shape tri.jpg|thumb|200px|<code>sprite_shape tri</code>]] | ||
[[File:Detail shape cross.jpg|thumb|200px|<code>sprite_shape cross</code>]] | [[File:Detail shape cross.jpg|thumb|200px|<code>sprite_shape cross</code>]] | ||
Шейпы это пропы, где два или три спрайта собраны в трехмерную форму. Они могут покачиваться на ветру или под воздействием проходящего игрока. | |||
{{warning|Генерация шейпов сильнее грузят GPU, в то время покачивание шейпов нагружает CPU. Используйте их как можно меньше. (Команда разработчиков Dear Esther разработала покачивания шейпов с обработкой на GPU, они более реалистичные и быстрые, но их код не вошел в релиз.)}} | |||
Detail shapes доступны всего в нескольких играх, например, [[Day of Defeat: Source]], [[Counter-Strike: Source]], [[Counter-Strike: Global Offensive]], [[Garry's Mod]] в коде. Если вы попытаетесь создать шейпы в игре, где нет их поддержки, то detail props вообще не будут сгенерированы. | |||
{{ | {{tip|Для включения шейпов в свой мод, или скомпилируйте его с <code>SDK_DLL</code> либо отредактируйте <code>\game\client\detailobjectsystem.cpp</code> и удалите>#ifdef</code> из строки 27.}} | ||
; <code>sprite_shape <choices></code> | ; <code>sprite_shape <choices></code> | ||
: | : Создает набор спрайтов под разными углами, разрешая эффект псевдо-3D. | ||
:; <code>tri</code> | :; <code>tri</code> | ||
:: | :: tri - три спрайта посажены на одинаковом расстоянии друг от друга по углам треугольника. | ||
:; <code>cross</code> | :; <code>cross</code> | ||
:: | :: два спрайта пересекают друг друга крестиком по центру | ||
; <code>sway <[[normal]]></code> | ; <code>sway <[[normal]]></code> | ||
: | : Процент от <code>cl_detail_max_sway</code> определяющий насколько проп может наклониться (по умолчанию?) {{tip| Не обязательно указывать <code>sprite_shape</code> чтобы шейп покачивался, но обязательно нужна поддержка шейпов в вашей игре.}} | ||
; <code>shape_angle <[[float]]></code> | ; <code>shape_angle <[[float]]></code> | ||
: '' | : ''Актуально только для варианта tri'' Число градусов снаружи, под которыми повернуты отдельные спрайты. Внешний угол, под которым повернуты отдельные спрайты. К сожалению, нельзя указать внутренний угол по некоторым причинам! Полезные значения параметра от 0-45. | ||
; <code>shape_size <normal></code> | ; <code>shape_size <normal></code> | ||
: ''sprite_shape | : ''Актуально только для варианта tri (sprite_shape)'' Процент ширины спрайта, определяющий расстояние от центра треугольника до спрайтов. 0 означает, что все спрайты будут расти из 1 точки. | ||
Есть также несколько консольных команд, которые воздействуют на шейпы: | |||
; <code>cl_detail_avoid_force</code> | ; <code>cl_detail_avoid_force</code> | ||
: | : Избегать генерации при воздействии игрока. | ||
; <code>cl_detail_avoid_radius</code> | ; <code>cl_detail_avoid_radius</code> | ||
: | :круг спрайта; если игрок находится в его пределах, спрайт не будет сгенерирован. (по умолчанию? должно быть это значение, если включено предыдущее) | ||
; <code>cl_detail_avoid_recover_speed</code> | ; <code>cl_detail_avoid_recover_speed</code> | ||
: | : определяет насколько быстро восстанавливается спрайт после взаимодействия с игроком. | ||
; <code>cl_detail_max_sway</code> | ; <code>cl_detail_max_sway</code> | ||
: | : Амплитуда покачиваний detail prop | ||
Если в игре вы не нашли этих команд, значит, игра не поддерживает шейпы. | |||
==== Модели ==== | |||
Помните, что модели отнимают намного больше ресурсов, чем спрайты. Используйте их крайне осторожно. | |||
Хорошими кандидатами для 3д флоры являются, маленькие камушки, упавшие ветви, продолговатые растения, как плющ или кусты сложной формы. Для простой вертикальной растительности лучше выбирать спрайты. | |||
; <code>model <[[string]]></code> | ; <code>model <[[string]]></code> | ||
: | : Чтобы модель могла быть использована как Prop Detail, внутри её QC должна быть строка $staticprop, а материал vmt должен использовать шейдер UnlitGeneric. | ||
Размещайте модели в папке Models и не путайтесь в путях. | |||
{{ | {{tip|Если вы коддер и вам нужно разрешить модели использовать шейдер VertexLitGeneric, откройте файл game\client\detailobjectsystem.cpp и удалите блок CDetailObjectSystem::UnserializeModelDict() | ||
}} | |||
== | == Новые detail материалы == | ||
[[File:Detail forest.png|thumb|200px|The [[#New detail types|sample .VBSP]]'s detail texture.]] | [[File:Detail forest.png|thumb|200px|The [[#New detail types|sample .VBSP]]'s detail texture.]] | ||
При создании новых материалов Вы не должны забывать о: | |||
нужно оставлять хотя бы 1 пиксель между двумя изображениями растительности внутри общего кастомного detailsprites, иначе в игре будет заметен переход по краям двух спрайтов. | |||
* Материал должен использовать шейдер UnlitGeneric. Возможно Вам пригодятся и другие переменные - $vertexcolor, $receiveflashlight, $nocull и $translucent . | |||
Если Вы решили заменить стандартный detail\detailsprites.vmt, не забудьте указать в свойствах карты .Map > Map Properties.... путь и имя новой текстуры. | |||
{{bug| | {{bug|Любая пользовательская текстура растительности должна быть краткой дефолтной detail\detailsprites! Иначе будет искривление рендера.. Править это можно вот тут. | ||
.}} | |||
== | == Блокировка Detail props в нежелательных зонах. == | ||
Если вам нужно исключить генерацию пропов в определенной зоне, воспользуйтесь энтити [[func_detail_blocker]] (Доступно только в [[Portal 2]], [[Alien Swarm]], [[Left 4 Dead 2]], [[Counter-Strike: Global Offensive]], и [[Garry's Mod]].) | |||
[[Category:Level Design]] | [[Category:Level Design]] |
Revision as of 04:27, 2 February 2020


Detail props это дешевые, бесплотные объекты, которые случайным образом появляются на поверхности специальных материалов. Они исчезают из вида на определенном расстоянии от игрока (по умолчанию это 1200 юнитов). Это значит, что они годятся только для небольших объектов, таких как трава или прочая мелкая растительность.
Detail props бывает двух типов:
- Спрайты
- двух полигональный плоский квадрат, использующий параметр $translucent внутри материала. Объект может быть настроен так, чтобы он всегда “смотрел” в сторону камеры игрока, покачивался на ветру (что уже будет ресурсоемко) и прогибался под шагами идущего. Спрайт не может проходить сквозь водную поверхность.
- Модели
- 3д модели следует использовать очень редко, если вообще использовать. Каждая модель расходует видео ресурсы DirectX, вне зависимости от того, сколько у модели полигонов, нагрузка всегда будет выше приемлемой.
Использование
Типы покрытия detail prop ("detail types") определяются скриптом файла .vbsp (Формат ANSI), и описаны в материалах с помощью параметра %detailtype. Затем VBSP рандомно генерирует detail props на поверхностях, покрытых этим материалом, при компиляции карты.
Detail props могут быть размещены в ручную в паре с prop_detail и prop_detail_sprite энтити, но это редкая практика.


Базовые типы detail
Эти типы detail доступны Source SDK Base:
Эти типы detail присутствуют, но доступны только на 3D моделях:
- swamp_land_001
- swamp_water_001
- grassland1
- grassland2
- grassland3
- rocks3
- test
- coast_pebbles
- street_junk
Новые типы detail
Здесь отображен пользовательский VBSP файл. Требуется поддержка detail shape. используется эта текстура с этим шаблоном.
detail
{
forest_floor_01
{
density 1600
GrassTex
{
alpha 0
RoseFlower
{
sprite "0 0 83 128 512"
spritesize "0.5 0.05 7 13"
spriterandomscale .3
amount 0.02
detailorientation 2
sway 0.2
upright 1
maxangle 70
}
FernShrub
{
sprite "120 0 136 256 512"
spritesize "0.5 0.05 17 28"
spriterandomscale .15
amount 0.03
sprite_shape tri
shape_size 0
sway 0.3
upright 1
maxangle 50
}
GrassTuft
{
sprite "0 199 120 57 512"
spritesize "0.5 0 20 10"
spriterandomscale .2
amount .6
sprite_shape cross
sway .1
maxangle 95
}
PinkFlower
{
sprite "83 0 38 128 512"
spritesize "0.5 0 6 18"
spriterandomscale .1
amount 0.02
detailorientation 2
sway 0.3
upright 1
maxangle 70
}
LushShrub
{
sprite "256 128 172 128 512"
spritesize "0.5 0 32 21"
spriterandomscale .3
amount 0.01
sprite_shape tri
shape_size 0.1
sway 0.1
maxangle 40
}
}
LeavesTex
{
alpha 1
DriedGrass
{
sprite "256 0 92 120 512"
spritesize "0.5 0 13 17"
spriterandomscale .15
amount .3
sprite_shape cross
sway .3
maxangle 95
}
GrassTuft
{
sprite "0 199 120 57 512"
spritesize "0.5 0 20 10"
spriterandomscale .2
amount .6
sprite_shape cross
sway .1
maxangle 95
}
RoseFlower
{
sprite "0 0 83 128 512"
spritesize "0.5 0.05 7 13"
spriterandomscale .3
amount 0.02
detailorientation 2
sway 0.2
upright 1
maxangle 70
}
}
}
}
Простой Шаблон:
detail
{
<Detail type>
{
density <float>
<Group>
{
alpha <normal>
<Prop>
{
<settings>
}
}
}
}
Обозначение команд::
- Detail type
- Это имя дитейла указанного в VMT материала
%detailtype
.density <float>
- Плотность генерации detail пропов на поверхности материала.
Совет:
Значение 1000000
означает, что на каждом юните будет по 1 пропу. Средняя плотность детейлов 1000-1500. (128 юнитов - 2 пропа - 256 плотность)
- Group
- Даже если вам требуется определить всего один detail prop, вам все равно необходимо создать группу (group). Имя вряд ли где-то используется, оно нужно просто для справки.
Примечание: поверхности Non-displacement используют только первую группу detail!
alpha <normal>
- Значение сдвига alpha, при котором генерируется данная группа detail проп. Каждый раз при генерации detail проп VBSP выбирает группу с ближайшим значением alpha к текущему в данной локации (месте). Если alpha не определена, все группы появятся во всех областях.
- Prop
- Определяет detail prop. И хотя у него есть уникальное имя, нет возможности ссылаться на существующий проп позже в .VBSP: он должен быть переопределен всякий раз, когда он нужен. И все же использовать понятные имена это неплохая идея.
Prop настройки
amount <normal>
- Доля от общего числа всех моделей (спрайтов) относительно указанной плотности из переменной
density
Обычно 0.1. upright <bool>
- Если указано (не важно какое значение) модель всегда будет “смотреть” вверх. Если переменной нет, модель будет ориентироваться относительно материала поверхности на которой она должна генерироваться. (расти из земли вертикально)
minangle <float>
maxangle <float>
- Регулирует генерацию на крутых поверхностях. Стандартное значение для обоих 180 градусов (без ограничений). .
Совет:Если выставить 180 и 180 (min-max) Ваша трава будет расти даже на потолке. Если выставить 0 и 180, трава будет расти всюду, кроме потолка. 45 и 180, стена под косым углом ВНИЗ - редкая растительность. 180 и 45, стена под косым углом ВВЕРХ - редкая растительность. Значение 0 и 90 - трава только на земле и склонах, но на прямой стене и потолке её не будет.
Спрайты
sprite <int|X, Y, W, H, VTF координаты и масштабы>
- Это координаты на общей VTF текстуре, откуда берется рендер каждой отдельной травинки.
- X/Y это горизонтальная и вертикальная координаты.
- W/H это размеры (ширина, высота). texels
Баг:Любая пользовательская текстура растительности должна быть краткой дефолтной detail\detailsprites! Иначе будет искривление рендера.. Править это можно вот тут.
Get the fix here. [нужно проверить в ?]
spritesize <normal|U, V> <float|W, H>
- Размеры спрайта в самой игре, (U/V) - смещение.относительно точки опоры и (W/H) Ширина и высота спрайта. (U/V лучше не трогать)
spriterandomscale <normal>
- Размер спрайта не должен быть указан как 1 и 1, его не будет в игре. Оптимальный размер от 10 до 20.
detailOrientation <int>
- Будет ли спрайт поворачиваться своим “лицом” к камере игрока.
- 0: не будет.
- 1: спрайт всегда смотрит в камеру игрока, даже когда игрок стоит над спратом, тот словно наклоняется.
- 2: Спрайт всегда смотрит в камеру игрока, однако вращается только вокруг Z оси, по кругу.
Шейпы (сложные фигуры)
Шейпы это пропы, где два или три спрайта собраны в трехмерную форму. Они могут покачиваться на ветру или под воздействием проходящего игрока.

Detail shapes доступны всего в нескольких играх, например, Day of Defeat: Source, Counter-Strike: Source, Counter-Strike: Global Offensive, Garry's Mod в коде. Если вы попытаетесь создать шейпы в игре, где нет их поддержки, то detail props вообще не будут сгенерированы.

SDK_DLL
либо отредактируйте \game\client\detailobjectsystem.cpp
и удалите>#ifdef из строки 27.sprite_shape <choices>
- Создает набор спрайтов под разными углами, разрешая эффект псевдо-3D.
tri
- tri - три спрайта посажены на одинаковом расстоянии друг от друга по углам треугольника.
cross
- два спрайта пересекают друг друга крестиком по центру
sway <normal>
- Процент от
cl_detail_max_sway
определяющий насколько проп может наклониться (по умолчанию?)Совет: Не обязательно указывать
sprite_shape
чтобы шейп покачивался, но обязательно нужна поддержка шейпов в вашей игре. shape_angle <float>
- Актуально только для варианта tri Число градусов снаружи, под которыми повернуты отдельные спрайты. Внешний угол, под которым повернуты отдельные спрайты. К сожалению, нельзя указать внутренний угол по некоторым причинам! Полезные значения параметра от 0-45.
shape_size <normal>
- Актуально только для варианта tri (sprite_shape) Процент ширины спрайта, определяющий расстояние от центра треугольника до спрайтов. 0 означает, что все спрайты будут расти из 1 точки.
Есть также несколько консольных команд, которые воздействуют на шейпы:
cl_detail_avoid_force
- Избегать генерации при воздействии игрока.
cl_detail_avoid_radius
- круг спрайта; если игрок находится в его пределах, спрайт не будет сгенерирован. (по умолчанию? должно быть это значение, если включено предыдущее)
cl_detail_avoid_recover_speed
- определяет насколько быстро восстанавливается спрайт после взаимодействия с игроком.
cl_detail_max_sway
- Амплитуда покачиваний detail prop
Если в игре вы не нашли этих команд, значит, игра не поддерживает шейпы.
Модели
Помните, что модели отнимают намного больше ресурсов, чем спрайты. Используйте их крайне осторожно.
Хорошими кандидатами для 3д флоры являются, маленькие камушки, упавшие ветви, продолговатые растения, как плющ или кусты сложной формы. Для простой вертикальной растительности лучше выбирать спрайты.
model <string>
- Чтобы модель могла быть использована как Prop Detail, внутри её QC должна быть строка $staticprop, а материал vmt должен использовать шейдер UnlitGeneric.
Размещайте модели в папке Models и не путайтесь в путях.

Новые detail материалы

При создании новых материалов Вы не должны забывать о: нужно оставлять хотя бы 1 пиксель между двумя изображениями растительности внутри общего кастомного detailsprites, иначе в игре будет заметен переход по краям двух спрайтов.
- Материал должен использовать шейдер UnlitGeneric. Возможно Вам пригодятся и другие переменные - $vertexcolor, $receiveflashlight, $nocull и $translucent .
Если Вы решили заменить стандартный detail\detailsprites.vmt, не забудьте указать в свойствах карты .Map > Map Properties.... путь и имя новой текстуры.

Блокировка Detail props в нежелательных зонах.
Если вам нужно исключить генерацию пропов в определенной зоне, воспользуйтесь энтити func_detail_blocker (Доступно только в Portal 2, Alien Swarm, Left 4 Dead 2, Counter-Strike: Global Offensive, и Garry's Mod.)