GpuParticles2D

public int Amount { get; set; }

Количество частиц, подлежащих выбросам в рамках одного цикла выбросов. (amount * amount_ratio) / lifetime Более высокие значения увеличивают требования к ГПУ, даже если не все частицы видны в данный момент времени или если GpuParticles2D.AmountRatio уменьшается. Примечание: Изменение этого значения приведет к возобновлению работы системы частиц. GpuParticles2D.AmountRatio вместо этого.

public float AmountRatio { get; set; }

Соотношение частиц, которые должны быть фактически испущены. Если установлено значение ниже 1.0, это установит количество испускаемых частиц за время жизни на amount * amount_ratio. В отличие от изменения GpuParticles2D.Amount, изменение GpuParticles2D.AmountRatio во время испускания не влияет на уже испущенные частицы и не приводит к перезапуску системы частиц. GpuParticles2D.AmountRatio можно использовать для создания эффектов, которые заставляют количество испускаемых частиц меняться со временем. Примечание: Уменьшение GpuParticles2D.AmountRatio не дает выигрыша в производительности, поскольку ресурсы должны быть выделены и обработаны для общего GpuParticles2D.Amount частиц независимо от GpuParticles2D.AmountRatio. Если вы не собираетесь изменять количество испускаемых частиц во время испускания частиц, убедитесь, что GpuParticles2D.AmountRatio установлено на 1 и вместо этого измените GpuParticles2D.Amount по своему усмотрению.

public float CollisionBaseSize { get; set; }

Множитель для радиуса столкновения частиц. 1.0 Если при столкновении частицы погружаются в землю, увеличивайте это значение. float При столкновении понижайте это значение. ParticleProcessMaterial.CollisionMode это ParticleProcessMaterial.CollisionModeEnum.Rigid или ParticleProcessMaterial.CollisionModeEnum.HideOnContact. Примечание: Частицы всегда имеют сферическую форму столкновения.

public GpuParticles2D.DrawOrderEnum DrawOrder { get; set; }

Порядок отрисовки частиц.

public bool Emitting { get; set; }

Разрешает появление новых частиц. false не удаляет уже живущие частицы: они продолжают существовать до завершения жизни. Это не эквивалент полной паузы или Restart. Для OneShot отслеживайте Finished, а не считайте Emitting=false доказательством пустого экрана.

public float Explosiveness { get; set; }

Насколько быстро выбрасываются частицы в цикле эмиссии. Если больше 0, то будет разрыв в эмиссии до начала следующего цикла.

public int FixedFps { get; set; }

Частота кадров системы частиц зафиксирована на значении. Например, изменение значения на 2 заставит частицы рендериться со скоростью 2 кадра в секунду. Обратите внимание, что это не замедляет симуляцию самой системы частиц.

public bool FractDelta { get; set; }

Если true, то выполняется дробный расчет дельты, который обеспечивает более плавный эффект отображения частиц.

public float InterpToEnd { get; set; }

Заставляет все частицы в этом узле интерполироваться к концу своего жизненного цикла. Примечание: Это работает только при использовании с ParticleProcessMaterial. Это необходимо вручную реализовать для шейдеров пользовательских процессов.

public bool Interpolate { get; set; }

Включает интерполяцию частиц, которая делает движение частиц более плавным, когда их GpuParticles2D.FixedFps ниже частоты обновления экрана.

public double Lifetime { get; set; }

Количество времени, в течение которого каждая частица будет существовать (в секундах). Эффективная скорость эмиссии равна (amount * amount_ratio) / lifetime частиц в секунду.

public bool LocalCoords { get; set; }

Выбирает пространство симуляции. При true уже выпущенные частицы следуют трансформации эмиттера; при false остаются в мировом canvas-пространстве при последующем перемещении эмиттера. Выбирайте до запуска эффекта и отдельно учитывайте область видимости.

public bool OneShot { get; set; }

Если true, происходит только один цикл эмиссии. Если установить true во время цикла, эмиссия прекратится в конце цикла.

public double Preprocess { get; set; }

Система частиц запускается так, как будто она уже работала столько секунд. Примечание: Это может быть очень затратно, если установлено большое число, так как это требует запуска шейдера частиц количество раз, равное GpuParticles2D.FixedFps (или 30, если GpuParticles2D.FixedFps равен 0) для каждой секунды. В крайних случаях это может даже привести к сбою графического процессора из-за объема работы, выполненной за один кадр.

public Material ProcessMaterial { get; set; }

Материал симуляции, например ParticleProcessMaterial или ShaderMaterial с particle-шейдером; это не материал отрисовки CanvasItem. При назначении ParticleProcessMaterial с выключенным DisableZ и стандартной гравитацией (0,-9.8,0) реализация включает DisableZ и меняет гравитацию на (0,98,0). Общий ресурс при этом тоже изменяется. Задавайте нужные 2D-параметры явно до назначения.

public float Randomness { get; set; }

Коэффициент случайности времени жизни излучения.

public uint Seed { get; set; }

Устанавливает случайное семя, используемое системой частиц. Действует только если GpuParticles2D.UseFixedSeed равен true.

public double SpeedScale { get; set; }

Коэффициент масштабирования скорости работы системы частиц. Значение 0 может использоваться для остановки частиц.

public EntityPath SubEmitter { get; set; }

Путь к другому узлу GpuParticles2D, который будет использоваться как субэмиттер (см. ParticleProcessMaterial.SubEmitterMode). Субэмиттеры можно использовать для достижения таких эффектов, как фейерверк, искры при столкновении, пузыри, лопающиеся в каплях воды, и многое другое. Примечание: Когда задан GpuParticles2D.SubEmitter, целевой узел GpuParticles2D больше не будет испускать частицы самостоятельно.

public Texture2D Texture { get; set; }

Текстура частиц. Если null, частицы будут квадратами размером 1×1 пиксель. Примечание: Чтобы использовать текстуру флипбука/атласа спрайтов, назначьте новый CanvasItemMaterial свойству CanvasItem.Material GpuParticles2D, затем включите CanvasItemMaterial.ParticlesAnimation и установите CanvasItemMaterial.ParticlesAnimHFrames, CanvasItemMaterial.ParticlesAnimVFrames и CanvasItemMaterial.ParticlesAnimLoop для соответствия текстуре флипбука/атласа спрайтов.

public bool TrailEnabled { get; set; }

Если true, включает следы частиц с использованием системы скиннинга сетки. Примечание: В отличие от GpuParticles3D, количество секций и подразделений следа задается свойствами GpuParticles2D.TrailSections и GpuParticles2D.TrailSectionSubdivisions.

public double TrailLifetime { get; set; }

Количество времени, которое должен представлять след частицы (в секундах). Действует только если GpuParticles2D.TrailEnabled равен true.

public int TrailSectionSubdivisions { get; set; }

Количество подразделений, используемых для рендеринга следа частиц. Более высокие значения могут привести к более плавным кривым следа за счет производительности из-за повышенной сложности сетки. См. также GpuParticles2D.TrailSections. Действует только если GpuParticles2D.TrailEnabled имеет значение true.

public int TrailSections { get; set; }

Количество секций, используемых для рендеринга следа частиц. Более высокие значения могут привести к более плавным кривым следа за счет производительности из-за повышенной сложности сетки. См. также GpuParticles2D.TrailSectionSubdivisions. Действует только если GpuParticles2D.TrailEnabled имеет значение true.

public bool UseFixedSeed { get; set; }

Если true, частицы будут использовать одно и то же семя для каждой симуляции, используя семя, определенное в GpuParticles2D.Seed. Это полезно в ситуациях, когда визуальный результат должен быть согласованным между повторами, например, при использовании режима Создатель кино.

public Rect2 VisibilityRect { get; set; }

Заданная область видимости GPU-эффекта. Используется для culling; не задаёт траекторию и не является физической или обрезающей границей каждой частицы. Рассчитайте запас под всю жизнь, размеры текстуры и движение эмиттера. В проверенном Compatibility CaptureRect ошибается для 2D, поэтому пример задаёт консервативную область явно.

public Rect2 CaptureRect();

Запрашивает текущие границы частиц у рендерера. В проверенной сборке 1.0.0 Compatibility/OpenGL вызов для 2D воспроизвёл ошибки чтения буфера и пустой Rect2. Не используйте такой результат как доказательство отсутствия частиц или как надёжную основу VisibilityRect.

Явные границы для полного примера.

public void ConvertFromParticles(Entity particles);

Устанавливает свойства этого узла в соответствии с заданным узлом CpuParticles2D.

public void EmitParticle(Transform2D xform, Vector2 velocity, Color color, Color custom, uint flags);

Одна частица. xform, velocity, color и custom применяются в зависимости от стоимости flagsСм. GpuParticles2D.EmitFlags. По умолчанию ParticleProcessMaterial должны быть ParticleProcessMaterial.ParticleFlagPreserveColor установлен в true правильно использовать цвет, указанный в этой функции. Кроме того, она будет использовать содержание custom как (rotation, lifetime, animation, lifetime randomness). Примечание: GpuParticles2D.EmitParticle , поддерживается только методами "переднего+" и "Мобильного перевода", а не совместимостью.

public void RequestParticlesProcess(float processTime);

Запрашивает у частиц дополнительное время обработки в течение одного кадра. process_time определяет время обработки частиц при включенном излучении. process_time_residual определяет время обработки частиц при выключенном излучении для моделирования. В сочетании с GpuParticles2D.SpeedScale, установленным на 0.0, это полезно для возможности поиска временной шкалы системы частиц.

public void RequestParticlesProcess(float processTime, float processTimeResidual = 0f);

Запрашивает у частиц дополнительное время обработки в течение одного кадра. process_time определяет время обработки частиц при включенном излучении. process_time_residual определяет время обработки частиц при выключенном излучении для моделирования. В сочетании с GpuParticles2D.SpeedScale, установленным на 0.0, это полезно для возможности поиска временной шкалы системы частиц.

public void Restart();

Перезапускает систему частиц. Для явного управления seed используйте перегрузку Restart(bool keepSeed). Перезапуск отличается от простого Emitting=true и начинает эффект заново.

public void Restart(bool keepSeed = false);

Сбрасывает состояние симуляции и включает эмиссию. Seed сохраняется при keepSeed=true или UseFixedSeed=true; новое случайное значение выбирается только когда оба флага false. Изменение изображения появляется после обработки/отрисовки кадра.

public event Action Finished;

Вызывается, когда все активные частицы завершили обработку. Чтобы немедленно перезапустить цикл испускания, вызовите GpuParticles2D.Restart. Этот сигнал никогда не вызывается, когда GpuParticles2D.OneShot отключен, так как частицы будут испускаться и обрабатываться непрерывно. Примечание: Для эмиттеров GpuParticles2D.OneShot, поскольку частицы вычисляются на GPU, может быть короткий период после получения сигнала, в течение которого установка GpuParticles2D.Emitting на true не перезапустит цикл испускания. Эта задержка устраняется путем вызова GpuParticles2D.Restart.