> For the complete documentation index, see [llms.txt](https://docs.bestway.com.ua/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.bestway.com.ua/gem-rts-v1-ru/redaktor/redaktor-fx/nastroika-vfx-na-osnove-spraita.md).

# Настройка VFX на основе спрайта

Основой спецэффекта является блок первого уровня **spriteview.**

## Блоки второго уровня

<table><thead><tr><th width="219">Название блока</th><th>Описание</th></tr></thead><tbody><tr><td>sprite</td><td>Задает используемый тип спрайта для отображения.</td></tr><tr><td>offset</td><td>Регулирует смещение спрайта относительно центральной точки самого эффекта.</td></tr><tr><td>delay</td><td>Задаёт задержку в воспроизведении спрайта после его активации.</td></tr><tr><td>nightonly</td><td>Указывает, что спрайт будет видим только ночью.</td></tr><tr><td>fire</td><td>Добавляет к спрайту свойства, имитирующие огонь.</td></tr><tr><td>ground</td><td>Устанавливает спрайт на поверхность земли.</td></tr><tr><td>layer</td><td>Определяет слой, на котором будет расположен спрайт.</td></tr><tr><td>blend</td><td>Регулирует тип смешивания спрайта с фоном.</td></tr><tr><td>orientation</td><td>Определяет ориентацию спрайта в пространстве, относительно направления самого эффекта либо относительно направления камеры игрока.</td></tr><tr><td>notifyowner</td><td>Уведомляет объект, к которому прикреплён спрайт, о событиях, связанных со спрайтом.</td></tr><tr><td>usedirection</td><td>Позволяет спрайту изменять направление в зависимости от движения.</td></tr><tr><td>usescale</td><td>Включает масштабирование спрайта.</td></tr><tr><td>autovisible</td><td>Автоматически управляет видимостью спрайта.</td></tr><tr><td>halo</td><td>Переводит спрайт в режим “свечения” - режим отображения спрайта, имитирующий источник света.</td></tr></tbody></table>

## Блоки параметров для блока sprite

<table><thead><tr><th width="223">Блок</th><th>Описание</th></tr></thead><tbody><tr><td>timer</td><td>Задает время жизни и модификации спрайта.</td></tr><tr><td>turn</td><td>Заставляет спрайт вращаться.<br>Значение указывается в градусах.<br>При модификации от минимального к максимальному, период вращения зависит от таймера.</td></tr><tr><td>light</td><td>Определяет яркость свечения спрайта.<br>При модификации от минимального к максимальному значению скорость изменения свечения зависит от таймера.</td></tr><tr><td>visibility</td><td><p>Определяет степень видимости спрайта.</p><p>При модификации от минимального к максимальному значению скорость изменения видимости зависит от таймера.</p></td></tr><tr><td>scale</td><td>Позволяет масштабировать спрайт.<br>При модификации от минимального к максимальному значению скорость изменения размера зависит от таймера.</td></tr><tr><td>scalex</td><td>Масштабирует спрайт в проекции “x” (в длину).</td></tr><tr><td>scaley</td><td>Масштабирует спрайт в проекции “y” (в ширину).</td></tr><tr><td><p>shiftx</p><p>shifty</p><p>shiftz</p></td><td>Каждый из этих параметров сдвигает спрайт по осям 0x, 0y или 0z, соответственно названию</td></tr></tbody></table>

<details>

<summary>Пример содержимого def файла спецэффекта на основе <strong>spriteview</strong></summary>

```
{fx
	{spriteview halo
		{sprite "/texture/fx/flash/flash_g01"
			{timer
				{mode play loop pingpong}
				{duration 12}
			}
			{turn 0
				{linear
					{min 1}
					{max 180}
				}
			}
			{light 1
				{peak
					{min 0}
					{max 0.5}
				}
			}
			{scale 1
				{linear
					{min 0.15}
					{max 0.25}
				}
			}
			{highlight 0xfffefc80}
		}
		{orientation trace}
		{autovisible}
		{halo}
	}
	{storeable 1}
}
```

\
Отключить ненужные блоки можно в редакторе с помощью команды контекстного меню `Turn off`

</details>