GpuParticles3D

public int Amount { get; set; }

Вместимость, не менее 1. Изменение в текущем RenderingDevice освобождает данные частиц и сбрасывает фазу для перевыделения. Для доли эмиссии без смены вместимости используйте AmountRatio. Не является точным числом видимых частиц.

public float AmountRatio { get; set; }

Доля эмиссии от выделенного Amount; задавайте 0–1. Не уменьшает выделенную вместимость и не удаляет мгновенно живые частицы. Рождение также зависит от материала симуляции.

public float CollisionBaseSize { get; set; }

Базовый размер для столкновений частиц. Отличается от масштаба меша и VisibilityAabb; взаимодействие масштаба настраивает CollisionUseScale материала. Нужны CollisionMode и коллайдер GPU-частиц.

public GpuParticles3D.DrawOrderEnum DrawOrder { get; set; }

Порядок отрисовки частиц. Примечание: GpuParticles3D.DrawOrderEnum.Index — единственный параметр, поддерживающий векторы движения для эффектов типа TAA. Рекомендуется использовать этот порядок отрисовки, если частицы непрозрачны, чтобы исправить артефакты двоения.

public Mesh DrawPass1 { get; set; }

Меш первого прохода отображения. Его поверхность определяет вид отдельно от ProcessMaterial. Null скрывает геометрию прохода, но не останавливает симуляцию.

public Mesh DrawPass2 { get; set; }

Mesh, который рисуется для второго прохода рисования.

public Mesh DrawPass3 { get; set; }

Mesh, который рисуется для третьего прохода рисования.

public Mesh DrawPass4 { get; set; }

Mesh, который рисуется для четвертого прохода рисования.

public int DrawPasses { get; set; }

Количество проходов отрисовки при рендеринге частиц.

public bool Emitting { get; set; }

Управляет рождением новых частиц. False не удаляет живые частицы и не ставит симуляцию на паузу; у one-shot может появиться до исчезновения эффекта. Для нового цикла используйте Restart: повторное true в активном one-shot может отменить уведомление Finished.

public float Explosiveness { get; set; }

Сжатие интервала рождения: 0 распределяет частицы по циклу, 1 собирает рождения в начале всплеска. Не задаёт скорость разлёта или силу ProcessMaterial.

public int FixedFps { get; set; }

Частота фиксированных шагов моделирования, не лимит кадров отрисовки. Положительное значение задаёт шаг 1/FPS. При 0 текущий RD использует переменную дельту для обычных частиц, но trails могут потребовать внутренний фиксированный шаг. По умолчанию 30; пример явно выбирает 60.

public bool FractDelta { get; set; }

Уточняет долю DELTA для рождения частицы внутри шага. Это не общая точность float и не интерполяция изображения. В текущем RD действует при расчёте фазы обычной эмиссии; не приписывайте тот же эффект всем ручным/sub-emission путям.

public float InterpToEnd { get; set; }

Значение, передаваемое particle-шейдеру как INTERPOLATE_TO_END. Ограничивается диапазоном 0–1. Готовый ParticleProcessMaterial использует его в расчёте возраста; собственный ShaderMaterial должен учитывать его явно. Это не длительность Lifetime и не интерполяция кадров Interpolate.

public bool Interpolate { get; set; }

Интерполяция отображения между шагами моделирования. Не заменяет FixedFps, не добавляет вызовы process() и не является InterpToEnd. В текущем RD влияет на остаток времени при подготовке данных экземпляров.

public double Lifetime { get; set; }

Время жизни/цикла в секундах, строго больше нуля. Вместе с Amount и расписанием рождения влияет на плотность; не равно времени до прекращения Emitting или точному числу кадров.

public bool LocalCoords { get; set; }

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

public bool OneShot { get; set; }

Один цикл вместо повторения. Finished сообщает о завершении one-shot, а не каждой ручной остановки непрерывного источника. Взрывной цикл может прекратить рождение до истечения жизни частиц.

public double Preprocess { get; set; }

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

public Material ProcessMaterial { get; set; }

Материал симуляции, например ParticleProcessMaterial. Управляет поведением, а не поверхностью меша. Для видимого эффекта отдельно нужен draw-pass mesh с материалом поверхности.

public float Randomness { get; set; }

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

public uint Seed { get; set; }

Зерно случайности частиц. Для сохранения при Restart включите UseFixedSeed либо передайте keepSeed=true. Само зерно не фиксирует все условия и шаги симуляции.

public double SpeedScale { get; set; }

Масштаб хода симуляции. Ноль приостанавливает обычное продвижение, но не скрывает живую геометрию. Камера и трансформация при LocalCoords могут менять изображение даже на паузе. Не является FPS рендеринга. Ограничение времени в 1.0.0: после длительной паузы SpeedScale = 0 и возврата к 1 проверенный one-shot может выдать Finished, пока GPU-частицы ещё видны. Таймер Entity умножает накопленное время на текущий масштаб скорости; это не GPU-подтверждение истечения жизни. Не возвращайте эффект с меняющимся временем в пул только по этому сигналу. Фиксированная скорость простого one-shot исключает именно этот случай паузы/возобновления; при изменении времени отдельно проверьте политику жизненного цикла.

public EntityPath SubEmitter { get; set; }

Путь от этого источника к существующей целевой GpuParticles3D. Назначайте после создания обеих Entity; для рождений нужен режим основного ProcessMaterial. Не создаёт Entity на каждую частицу. Не используйте ссылки на себя/циклы; после изменения иерархии перепроверьте путь.

public bool TrailEnabled { get; set; }

Включает историю шлейфа. Нужны совместимые mesh-позы и UseParticleTrails активной поверхности. Текущий RenderingDevice перестраивает данные при назначении этого параметра; не обновляйте его каждый кадр как дешёвую анимацию.

public double TrailLifetime { get; set; }

Длительность истории в секундах, не Lifetime частицы и не длина исходного меша. Минимум около 0.01; текущий RD-бэкенд ограничивает историю 10 секундами, хотя getter сцены хранит запрос. Изменение перестраивает данные/фазу; учитывайте движение, шаг и бюджет.

public GpuParticles3D.TransformAlignEnum TransformAlign { get; set; }

Выравнивание отображаемой трансформации частицы. YToVelocity — исходный вариант для направленной геометрии/шлейфов в примере. Не меняет скорость и не гарантирует отсутствие скрутки или уплощения на любом пути.

public RenderingServer.ParticlesTransformAlignAxis TransformAlignAxis { get; set; }

При использовании функции Преобразовать локальный рекламный щит указывается, какую ось использовать для билбординга. Поддерживаются только оси X или Y.

public RenderingServer.ParticlesTransformAlignCustomSrc TransformAlignChannelFilter { get; set; }

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

public bool UseFixedSeed { get; set; }

Сохраняет заданный Seed при обычных перезапусках. Помогает повторять эффект, но не гарантирует побитовую детерминированность между драйверами, шагами времени и сборками.

public Aabb VisibilityAabb { get; set; }

Пользовательская граница отсечения всего источника. Вне кадра она может скрыть частицы, которые сами были бы видимы. Не является CaptureAabb текущего кадра, ограничителем траектории или коллайдером; охватите весь эффект и размеры мешей.

public Aabb CaptureAabb();

Считывает текущие активные границы частиц. Наблюдение работающего эффекта не охватывает все будущие траектории и не назначает VisibilityAabb автоматически. Чтение данных GPU может иметь стоимость.

public void ConvertFromParticles(Entity particles);

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

public void EmitParticle(Transform3D xform, Vector3 velocity, Color color, Color custom, uint flags);

Запрашивает ручной выпуск одной GPU-частицы. Флаги задают присутствующие компоненты; start() собственного шейдера должен проверять RESTART_POSITION/ROT_SCALE/VELOCITY/COLOR/CUSTOM, чтобы не затереть входные данные. Частица не является новым Entity. Нужны доступная ёмкость, ProcessMaterial, материал отрисовки и корректные границы; метод не возвращает подтверждение видимости.

public int GetAmount();

Возвращает Amount. Вместимость, не менее 1. Изменение в текущем RenderingDevice освобождает данные частиц и сбрасывает фазу для перевыделения. Для доли эмиссии без смены вместимости используйте AmountRatio. Не является точным числом видимых частиц.

public float GetAmountRatio();

Возвращает AmountRatio. Доля эмиссии от выделенного Amount; задавайте 0–1. Не уменьшает выделенную вместимость и не удаляет мгновенно живые частицы. Рождение также зависит от материала симуляции.

public Mesh GetDrawPassMesh(int pass);

Возвращает Mesh, который нарисован по индексу pass.

public float GetExplosivenessRatio();

Возвращает Explosiveness. Сжатие интервала рождения: 0 распределяет частицы по циклу, 1 собирает рождения в начале всплеска. Не задаёт скорость разлёта или силу ProcessMaterial.

public int GetFixedFps();

Частота фиксированных шагов моделирования, не лимит кадров отрисовки. Положительное значение задаёт шаг 1/FPS. При 0 текущий RD использует переменную дельту для обычных частиц, но trails могут потребовать внутренний фиксированный шаг. По умолчанию 30; пример явно выбирает 60.

public bool GetFractionalDelta();

Уточняет долю DELTA для рождения частицы внутри шага. Это не общая точность float и не интерполяция изображения. В текущем RD действует при расчёте фазы обычной эмиссии; не приписывайте тот же эффект всем ручным/sub-emission путям.

public float GetInterpToEnd();

Значение, передаваемое particle-шейдеру как INTERPOLATE_TO_END. Ограничивается диапазоном 0–1. Готовый ParticleProcessMaterial использует его в расчёте возраста; собственный ShaderMaterial должен учитывать его явно. Это не длительность Lifetime и не интерполяция кадров Interpolate.

public bool GetInterpolate();

Интерполяция отображения между шагами моделирования. Не заменяет FixedFps, не добавляет вызовы process() и не является InterpToEnd. В текущем RD влияет на остаток времени при подготовке данных экземпляров.

public double GetLifetime();

Возвращает Lifetime. Время жизни/цикла в секундах, строго больше нуля. Вместе с Amount и расписанием рождения влияет на плотность; не равно времени до прекращения Emitting или точному числу кадров.

public bool GetOneShot();

Возвращает OneShot. Один цикл вместо повторения. Finished сообщает о завершении one-shot, а не каждой ручной остановки непрерывного источника. Взрывной цикл может прекратить рождение до истечения жизни частиц.

public Material GetProcessMaterial();

Возвращает ProcessMaterial. Материал симуляции, например ParticleProcessMaterial. Управляет поведением, а не поверхностью меша. Для видимого эффекта отдельно нужен draw-pass mesh с материалом поверхности.

public uint GetSeed();

Возвращает Seed. Зерно случайности частиц. Для сохранения при Restart включите UseFixedSeed либо передайте keepSeed=true. Само зерно не фиксирует все условия и шаги симуляции.

public double GetSpeedScale();

Возвращает SpeedScale. Масштаб хода симуляции. Ноль приостанавливает обычное продвижение, но не скрывает живую геометрию. Камера и трансформация при LocalCoords могут менять изображение даже на паузе. Не является FPS рендеринга. Ограничение времени в 1.0.0: после длительной паузы SpeedScale = 0 и возврата к 1 проверенный one-shot может выдать Finished, пока GPU-частицы ещё видны. Таймер Entity умножает накопленное время на текущий масштаб скорости; это не GPU-подтверждение истечения жизни. Не возвращайте эффект с меняющимся временем в пул только по этому сигналу. Фиксированная скорость простого one-shot исключает именно этот случай паузы/возобновления; при изменении времени отдельно проверьте политику жизненного цикла.

public EntityPath GetSubEmitter();

Возвращает SubEmitter. Путь от этого источника к существующей целевой GpuParticles3D. Назначайте после создания обеих Entity; для рождений нужен режим основного ProcessMaterial. Не создаёт Entity на каждую частицу. Не используйте ссылки на себя/циклы; после изменения иерархии перепроверьте путь.

public double GetTrailLifetime();

Возвращает TrailLifetime. Длительность истории в секундах, не Lifetime частицы и не длина исходного меша. Минимум около 0.01; текущий RD-бэкенд ограничивает историю 10 секундами, хотя getter сцены хранит запрос. Изменение перестраивает данные/фазу; учитывайте движение, шаг и бюджет.

public GpuParticles3D.TransformAlignEnum GetTransformAlign();

Возвращает TransformAlign. Выравнивание отображаемой трансформации частицы. YToVelocity — исходный вариант для направленной геометрии/шлейфов в примере. Не меняет скорость и не гарантирует отсутствие скрутки или уплощения на любом пути.

public bool GetUseFixedSeed();

Возвращает UseFixedSeed. Сохраняет заданный Seed при обычных перезапусках. Помогает повторять эффект, но не гарантирует побитовую детерминированность между драйверами, шагами времени и сборками.

public bool GetUseLocalCoordinates();

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

public Aabb GetVisibilityAabb();

Возвращает VisibilityAabb. Пользовательская граница отсечения всего источника. Вне кадра она может скрыть частицы, которые сами были бы видимы. Не является CaptureAabb текущего кадра, ограничителем траектории или коллайдером; охватите весь эффект и размеры мешей.

public bool IsEmitting();

Возвращает Emitting. Управляет рождением новых частиц. False не удаляет живые частицы и не ставит симуляцию на паузу; у one-shot может появиться до исчезновения эффекта. Для нового цикла используйте Restart: повторное true в активном one-shot может отменить уведомление Finished.

public bool IsTrailEnabled();

Возвращает TrailEnabled. Включает историю шлейфа. Нужны совместимые mesh-позы и UseParticleTrails активной поверхности. Текущий RenderingDevice перестраивает данные при назначении этого параметра; не обновляйте его каждый кадр как дешёвую анимацию.

public void RequestParticlesProcess(float processTime);

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

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

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

public void Restart();

Очищает/перезапускает цикл и включает эмиссию. Может намеренно прервать живой эффект: ждать Finished перед каждым вызовом не обязательно. Новое зерно выбирается только без UseFixedSeed и без keepSeed.

public void Restart(bool keepSeed = false);

Очищает/перезапускает цикл и включает эмиссию. Может намеренно прервать живой эффект: ждать Finished перед каждым вызовом не обязательно. Новое зерно выбирается только без UseFixedSeed и без keepSeed.

public void SetAmount(int amount);

Задаёт Amount. Вместимость, не менее 1. Изменение в текущем RenderingDevice освобождает данные частиц и сбрасывает фазу для перевыделения. Для доли эмиссии без смены вместимости используйте AmountRatio. Не является точным числом видимых частиц.

public void SetAmountRatio(float ratio);

Задаёт AmountRatio. Доля эмиссии от выделенного Amount; задавайте 0–1. Не уменьшает выделенную вместимость и не удаляет мгновенно живые частицы. Рождение также зависит от материала симуляции.

public void SetDrawPassMesh(int pass, Mesh mesh);

Устанавливает Mesh, который рисуется по индексу pass.

public void SetEmitting(bool emitting);

Задаёт Emitting. Управляет рождением новых частиц. False не удаляет живые частицы и не ставит симуляцию на паузу; у one-shot может появиться до исчезновения эффекта. Для нового цикла используйте Restart: повторное true в активном one-shot может отменить уведомление Finished.

public void SetExplosivenessRatio(float ratio);

Задаёт Explosiveness. Сжатие интервала рождения: 0 распределяет частицы по циклу, 1 собирает рождения в начале всплеска. Не задаёт скорость разлёта или силу ProcessMaterial.

public void SetFixedFps(int fps);

Частота фиксированных шагов моделирования, не лимит кадров отрисовки. Положительное значение задаёт шаг 1/FPS. При 0 текущий RD использует переменную дельту для обычных частиц, но trails могут потребовать внутренний фиксированный шаг. По умолчанию 30; пример явно выбирает 60.

public void SetFractionalDelta(bool enable);

Уточняет долю DELTA для рождения частицы внутри шага. Это не общая точность float и не интерполяция изображения. В текущем RD действует при расчёте фазы обычной эмиссии; не приписывайте тот же эффект всем ручным/sub-emission путям.

public void SetInterpToEnd(float interp);

Значение, передаваемое particle-шейдеру как INTERPOLATE_TO_END. Ограничивается диапазоном 0–1. Готовый ParticleProcessMaterial использует его в расчёте возраста; собственный ShaderMaterial должен учитывать его явно. Это не длительность Lifetime и не интерполяция кадров Interpolate.

public void SetInterpolate(bool enable);

Интерполяция отображения между шагами моделирования. Не заменяет FixedFps, не добавляет вызовы process() и не является InterpToEnd. В текущем RD влияет на остаток времени при подготовке данных экземпляров.

public void SetLifetime(double secs);

Задаёт Lifetime. Время жизни/цикла в секундах, строго больше нуля. Вместе с Amount и расписанием рождения влияет на плотность; не равно времени до прекращения Emitting или точному числу кадров.

public void SetOneShot(bool enable);

Задаёт OneShot. Один цикл вместо повторения. Finished сообщает о завершении one-shot, а не каждой ручной остановки непрерывного источника. Взрывной цикл может прекратить рождение до истечения жизни частиц.

public void SetProcessMaterial(Material material);

Задаёт ProcessMaterial. Материал симуляции, например ParticleProcessMaterial. Управляет поведением, а не поверхностью меша. Для видимого эффекта отдельно нужен draw-pass mesh с материалом поверхности.

public void SetSeed(uint seed);

Задаёт Seed. Зерно случайности частиц. Для сохранения при Restart включите UseFixedSeed либо передайте keepSeed=true. Само зерно не фиксирует все условия и шаги симуляции.

public void SetSpeedScale(double scale);

Задаёт SpeedScale. Масштаб хода симуляции. Ноль приостанавливает обычное продвижение, но не скрывает живую геометрию. Камера и трансформация при LocalCoords могут менять изображение даже на паузе. Не является FPS рендеринга. Ограничение времени в 1.0.0: после длительной паузы SpeedScale = 0 и возврата к 1 проверенный one-shot может выдать Finished, пока GPU-частицы ещё видны. Таймер Entity умножает накопленное время на текущий масштаб скорости; это не GPU-подтверждение истечения жизни. Не возвращайте эффект с меняющимся временем в пул только по этому сигналу. Фиксированная скорость простого one-shot исключает именно этот случай паузы/возобновления; при изменении времени отдельно проверьте политику жизненного цикла.

public void SetSubEmitter(EntityPath path);

Задаёт SubEmitter. Путь от этого источника к существующей целевой GpuParticles3D. Назначайте после создания обеих Entity; для рождений нужен режим основного ProcessMaterial. Не создаёт Entity на каждую частицу. Не используйте ссылки на себя/циклы; после изменения иерархии перепроверьте путь.

public void SetTrailEnabled(bool enabled);

Задаёт TrailEnabled. Включает историю шлейфа. Нужны совместимые mesh-позы и UseParticleTrails активной поверхности. Текущий RenderingDevice перестраивает данные при назначении этого параметра; не обновляйте его каждый кадр как дешёвую анимацию.

public void SetTrailLifetime(double secs);

Задаёт TrailLifetime. Длительность истории в секундах, не Lifetime частицы и не длина исходного меша. Минимум около 0.01; текущий RD-бэкенд ограничивает историю 10 секундами, хотя getter сцены хранит запрос. Изменение перестраивает данные/фазу; учитывайте движение, шаг и бюджет.

public void SetTransformAlign(GpuParticles3D.TransformAlignEnum align);

Задаёт TransformAlign. Выравнивание отображаемой трансформации частицы. YToVelocity — исходный вариант для направленной геометрии/шлейфов в примере. Не меняет скорость и не гарантирует отсутствие скрутки или уплощения на любом пути.

public void SetUseFixedSeed(bool useFixedSeed);

Задаёт UseFixedSeed. Сохраняет заданный Seed при обычных перезапусках. Помогает повторять эффект, но не гарантирует побитовую детерминированность между драйверами, шагами времени и сборками.

public void SetUseLocalCoordinates(bool enable);

Задаёт LocalCoords. При true живые частицы следуют трансформации источника; при false рождённые частицы остаются в мировом пространстве при его перемещении. Выбирайте пространство до запуска: переключение живого эффекта не гарантирует сохранения вида.

public void SetVisibilityAabb(Aabb aabb);

Задаёт VisibilityAabb. Пользовательская граница отсечения всего источника. Вне кадра она может скрыть частицы, которые сами были бы видимы. Не является CaptureAabb текущего кадра, ограничителем траектории или коллайдером; охватите весь эффект и размеры мешей.

public event Action Finished;

Завершение one-shot-цикла. Подключайте до запуска. Не является общим событием исчезновения частиц после ручной остановки непрерывного источника; повторное Emitting=true в активном one-shot может отменить уведомление. Ограничение времени в 1.0.0: после длительной паузы SpeedScale = 0 и возврата к 1 проверенный one-shot может выдать Finished, пока GPU-частицы ещё видны. Таймер Entity умножает накопленное время на текущий масштаб скорости; это не GPU-подтверждение истечения жизни. Не возвращайте эффект с меняющимся временем в пул только по этому сигналу. Фиксированная скорость простого one-shot исключает именно этот случай паузы/возобновления; при изменении времени отдельно проверьте политику жизненного цикла.

public const long MaxDrawPasses = 4;

Максимальное поддерживаемое количество проходов рисования.