Fireworks Engine Options Reference

How to read this file Как читать этот документ

• Paths use the exact property names from index.d.ts. Пути (Paths) используют точные имена свойств из index.d.ts.
• There are 3 scopes: Существует 3 области видимости (scopes):
  • Persistent engine config: createFireworksEngine({ ... }) Постоянная конфигурация движка: createFireworksEngine({ ... })
  • Start-time config: engine.start(config) and engine.startPreset(name) Конфигурация при старте: engine.start(config) и engine.startPreset(name)
  • Launch-time config: boom, burst, confetti, launchRocketAt, launchRocketFromTo, launchRocket Конфигурация при запуске: boom, burst, confetti, launchRocketAt, launchRocketFromTo, launchRocket
• launchRocket(options) uses count as a batch size, and launchPresetAt(name, x, y, options) also honors count for repeated same-point launches. launchRocket(options) использует count как размер пакета (batch size), а launchPresetAt(name, x, y, options) также учитывает count для повторных запусков в одной точке.
• rocket.durationMin, rocket.durationMax, and rocket.cascade are launch-time rocket extras, not persistent engine defaults. rocket.durationMin, rocket.durationMax и rocket.cascade — это дополнительные параметры ракеты во время запуска, а не постоянные настройки движка.
• Many particle count fields are sizeScale-aware in the launch builders, so sizeScale can affect more than just visible size. Многие поля количества частиц зависят от sizeScale в функциях-строителях, поэтому sizeScale может влиять не только на визуальный размер.
• If a field is omitted, the runtime uses the default listed here or inherits from the current engine / launch context. Если поле опущено, среда выполнения использует значение по умолчанию, указанное здесь, или наследует его из текущего контекста движка/запуска.

Scope map Карта областей видимости (Scope map)

Start-time controls

These are start-time controls. They are read by start(config) / startPreset(name); if you pass them to createFireworksEngine(), they are not stored as persistent engine defaults.

Это элементы управления во время старта. Они считываются через start(config) / startPreset(name); если вы передадите их в createFireworksEngine(), они не будут сохранены как постоянные значения по умолчанию.

Canvas (Монтаж и DOM)

Runtime (Интеграция хоста)

These options are integration hooks, not visual tuning knobs.

Эти опции являются хуками интеграции, а не визуальными настройками.

Performance (Производительность)

Rocket (Ракета)

These fields are part of the persistent rocket config stored on the engine.

Эти поля являются частью постоянной конфигурации ракеты, хранящейся в движке.

Rocket Launch Extras (Экстра параметры при запуске)

These fields are accepted when launching rockets, but they are not stored as persistent engine defaults.

Принимаются при запуске ракет, но не сохраняются в движке.

Rocket Cascade (rocket.cascade.*)

Rocket Tail Embers (Дымный след)

The white ember plume behind the rocket. Tune brightness, fade, and spread; there is no separate color palette.

Белый шлейф искр за ракетой. Цвет не настраивается (только яркость, затухание и разброс).

Burst Forms (Частицы-формы / Конфетти)

Burst Sparks (Искры взрыва)

Burst Center Flash (Центральная вспышка)

Burst Twinkle Cloud (Мерцающее облако)

These particles are white. Tune brightness, size, duration, and spread instead of color.

Эти частицы всегда белые. Настраивается яркость, размер, длительность и разброс.

Helper Shortcuts (Методы-сокращения)

Presets (Готовые пресеты)

These are authored bundles, not the same thing as raw engine defaults.

Это авторские сборки настроек, отличающиеся от сырых дефолтов движка.

This table covers the engine start presets used by startPreset(name). Point-based launch presets are listed below and launched through launchPresetAt(name, x, y).

Эта таблица описывает стартовые пресеты движка, которые используются в startPreset(name). Точечные launch-пресеты перечислены ниже и запускаются через launchPresetAt(name, x, y).

The four engine presets above are scheduled scene starters. They choose their launch targets internally; when a preset uses rocket flight, the rocket start point is also selected by the runtime. Use them when you want a ready-made show rather than a point-targeted reaction.

Четыре engine-пресета выше запускают готовую сцену по расписанию. Они сами выбирают точки целей; если пресет использует полет ракеты, точка старта ракеты тоже выбирается runtime. Используйте их, когда нужен готовый эффект, а не реакция в конкретной точке.

Launch presets

Practical tuning order (Порядок настройки)

If you only want to change one thing at a time, tune in this order:

Если вы хотите менять настройки поэтапно (по одной вещи за раз), следуйте этому порядку: