# Настройка 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://bestway-1.gitbook.io/documentation/gem-rts-v1-ru/redaktor/redaktor-fx/nastroika-vfx-na-osnove-spraita.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
