Перейти к содержанию

Частицы и визуальные эффекты

pygine.effects

Система частиц и визуальных эффектов.

Particle

Базовая частица для системы эффектов.

Source code in pygine/effects.py 
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
class Particle:
    """Базовая частица для системы эффектов."""

    def __init__(
        self,
        x: float,
        y: float,
        velocity: Tuple[float, float] = (0, 0),
        lifetime: float = 1.0,
        color: Tuple[int, int, int] = (255, 255, 255),
    ):
        self.x = x
        self.y = y
        self.velocity = list(velocity)
        self.lifetime = lifetime
        self.max_lifetime = lifetime
        self.color = color
        self.size = 2
        self.alive = True

    def update(self, dt: float) -> None:
        """Обновить состояние частицы."""
        if not self.alive:
            return

        self.x += self.velocity[0] * dt
        self.y += self.velocity[1] * dt
        self.lifetime -= dt

        if self.lifetime <= 0:
            self.alive = False

    def draw(self, screen: pygame.Surface) -> None:
        """Нарисовать частицу на экране."""
        if self.alive:
            pygame.draw.circle(
                screen, self.color, (int(self.x), int(self.y)), self.size
            )

draw(screen)

Нарисовать частицу на экране.

Source code in pygine/effects.py 
43
44
45
46
47
48
def draw(self, screen: pygame.Surface) -> None:
    """Нарисовать частицу на экране."""
    if self.alive:
        pygame.draw.circle(
            screen, self.color, (int(self.x), int(self.y)), self.size
        )

update(dt)

Обновить состояние частицы.

Source code in pygine/effects.py 
31
32
33
34
35
36
37
38
39
40
41
def update(self, dt: float) -> None:
    """Обновить состояние частицы."""
    if not self.alive:
        return

    self.x += self.velocity[0] * dt
    self.y += self.velocity[1] * dt
    self.lifetime -= dt

    if self.lifetime <= 0:
        self.alive = False

ParticleSystem

Система для управления множеством частиц.

Source code in pygine/effects.py 
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
class ParticleSystem:
    """Система для управления множеством частиц."""

    def __init__(self):
        self.particles: List[Particle] = []

    def add_particle(self, particle: Particle) -> None:
        """Добавить частицу в систему."""
        self.particles.append(particle)

    def update(self, dt: float) -> None:
        """Обновить все частицы."""
        for particle in self.particles[:]:
            particle.update(dt)
            if not particle.alive:
                self.particles.remove(particle)

    def draw(self, screen: pygame.Surface) -> None:
        """Нарисовать все частицы."""
        for particle in self.particles:
            particle.draw(screen)

    def clear(self) -> None:
        """Удалить все частицы."""
        self.particles.clear()

add_particle(particle)

Добавить частицу в систему.

Source code in pygine/effects.py 
57
58
59
def add_particle(self, particle: Particle) -> None:
    """Добавить частицу в систему."""
    self.particles.append(particle)

clear()

Удалить все частицы.

Source code in pygine/effects.py 
73
74
75
def clear(self) -> None:
    """Удалить все частицы."""
    self.particles.clear()

draw(screen)

Нарисовать все частицы.

Source code in pygine/effects.py 
68
69
70
71
def draw(self, screen: pygame.Surface) -> None:
    """Нарисовать все частицы."""
    for particle in self.particles:
        particle.draw(screen)

update(dt)

Обновить все частицы.

Source code in pygine/effects.py 
61
62
63
64
65
66
def update(self, dt: float) -> None:
    """Обновить все частицы."""
    for particle in self.particles[:]:
        particle.update(dt)
        if not particle.alive:
            self.particles.remove(particle)

ScreenShake

Система тряски экрана для создания эффектов воздействия.

Source code in pygine/effects.py 
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
class ScreenShake:
    """Система тряски экрана для создания эффектов воздействия."""

    def __init__(self):
        self.intensity = 0.0  # Текущая интенсивность тряски
        self.duration = 0.0   # Оставшееся время тряски
        self.frequency = 30.0 # Частота тряски (в герцах)
        self.time = 0.0       # Внутренний таймер

    def start_shake(self, intensity: float, duration: float, frequency: float = 30.0) -> None:
        """
        Начать эффект тряски экрана.

        Аргументы:
            intensity: Интенсивность тряски (в пикселях)
            duration: Продолжительность тряски (в секундах)
            frequency: Частота тряски (колебаний в секунду)
        """
        self.intensity = max(intensity, self.intensity)  # Берём максимальную интенсивность
        self.duration = max(duration, self.duration)     # Продлеваем время, если нужно
        self.frequency = frequency

    def update(self, dt: float) -> None:
        """Обновить состояние тряски."""
        if self.duration > 0:
            self.duration -= dt
            self.time += dt

            # Уменьшаем интенсивность со временем
            if self.duration <= 0:
                self.intensity = 0.0
                self.duration = 0.0
                self.time = 0.0

    def get_offset(self) -> Tuple[float, float]:
        """
        Получить текущее смещение для тряски.

        Возвращает:
            Кортеж (offset_x, offset_y) в пикселях
        """
        if self.duration <= 0 or self.intensity <= 0:
            return (0.0, 0.0)

        # Создаём случайное смещение на основе времени и частоты
        angle = self.time * self.frequency * 2 * math.pi
        random_factor = random.uniform(0.7, 1.0)  # Добавляем случайность

        offset_x = math.sin(angle) * self.intensity * random_factor
        offset_y = math.cos(angle * 1.3) * self.intensity * random_factor  # Разная частота для Y

        return (offset_x, offset_y)

    def is_active(self) -> bool:
        """Проверить, активна ли тряска."""
        return self.duration > 0 and self.intensity > 0

get_offset()

Получить текущее смещение для тряски.

Возвращает

Кортеж (offset_x, offset_y) в пикселях

Source code in pygine/effects.py 
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
def get_offset(self) -> Tuple[float, float]:
    """
    Получить текущее смещение для тряски.

    Возвращает:
        Кортеж (offset_x, offset_y) в пикселях
    """
    if self.duration <= 0 or self.intensity <= 0:
        return (0.0, 0.0)

    # Создаём случайное смещение на основе времени и частоты
    angle = self.time * self.frequency * 2 * math.pi
    random_factor = random.uniform(0.7, 1.0)  # Добавляем случайность

    offset_x = math.sin(angle) * self.intensity * random_factor
    offset_y = math.cos(angle * 1.3) * self.intensity * random_factor  # Разная частота для Y

    return (offset_x, offset_y)

is_active()

Проверить, активна ли тряска.

Source code in pygine/effects.py 
131
132
133
def is_active(self) -> bool:
    """Проверить, активна ли тряска."""
    return self.duration > 0 and self.intensity > 0

start_shake(intensity, duration, frequency=30.0)

Начать эффект тряски экрана.

Аргументы

intensity: Интенсивность тряски (в пикселях) duration: Продолжительность тряски (в секундах) frequency: Частота тряски (колебаний в секунду)

Source code in pygine/effects.py 
87
88
89
90
91
92
93
94
95
96
97
98
def start_shake(self, intensity: float, duration: float, frequency: float = 30.0) -> None:
    """
    Начать эффект тряски экрана.

    Аргументы:
        intensity: Интенсивность тряски (в пикселях)
        duration: Продолжительность тряски (в секундах)
        frequency: Частота тряски (колебаний в секунду)
    """
    self.intensity = max(intensity, self.intensity)  # Берём максимальную интенсивность
    self.duration = max(duration, self.duration)     # Продлеваем время, если нужно
    self.frequency = frequency

update(dt)

Обновить состояние тряски.

Source code in pygine/effects.py 
100
101
102
103
104
105
106
107
108
109
110
def update(self, dt: float) -> None:
    """Обновить состояние тряски."""
    if self.duration > 0:
        self.duration -= dt
        self.time += dt

        # Уменьшаем интенсивность со временем
        if self.duration <= 0:
            self.intensity = 0.0
            self.duration = 0.0
            self.time = 0.0

create_explosion(x, y, size=20)

Создать эффект взрыва в указанной позиции.

Source code in pygine/effects.py 
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
def create_explosion(x: float, y: float, size: int = 20) -> None:
    """Создать эффект взрыва в указанной позиции."""
    for _ in range(size):
        angle = random.uniform(0, 2 * math.pi)
        speed = random.uniform(50, 150)
        vx = math.cos(angle) * speed
        vy = math.sin(angle) * speed

        particle = Particle(
            x,
            y,
            (vx, vy),
            lifetime=random.uniform(0.5, 1.5),
            color=(255, random.randint(100, 255), 0),
        )
        _particle_system.add_particle(particle)

create_smoke(x, y, amount=10)

Создать эффект дыма в указанной позиции.

Source code in pygine/effects.py 
161
162
163
164
165
166
167
168
169
170
171
def create_smoke(x: float, y: float, amount: int = 10) -> None:
    """Создать эффект дыма в указанной позиции."""
    for _ in range(amount):
        vx = random.uniform(-20, 20)
        vy = random.uniform(-50, -20)

        gray = random.randint(100, 200)
        particle = Particle(
            x, y, (vx, vy), lifetime=random.uniform(1.0, 3.0), color=(gray, gray, gray)
        )
        _particle_system.add_particle(particle)

create_sparkles(x, y, amount=15)

Создать эффект искр в указанной позиции.

Source code in pygine/effects.py 
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
def create_sparkles(x: float, y: float, amount: int = 15) -> None:
    """Создать эффект искр в указанной позиции."""
    for _ in range(amount):
        angle = random.uniform(0, 2 * math.pi)
        speed = random.uniform(30, 100)
        vx = math.cos(angle) * speed
        vy = math.sin(angle) * speed

        particle = Particle(
            x,
            y,
            (vx, vy),
            lifetime=random.uniform(0.3, 1.0),
            color=(255, 255, random.randint(100, 255)),
        )
        _particle_system.add_particle(particle)

draw_effects(screen)

Отрисовать все эффекты. Вызывать из игрового цикла.

Source code in pygine/effects.py 
234
235
236
def draw_effects(screen: pygame.Surface) -> None:
    """Отрисовать все эффекты. Вызывать из игрового цикла."""
    _particle_system.draw(screen)

get_screen_shake_offset()

Получить текущее смещение для тряски экрана.

Возвращает

Кортеж (offset_x, offset_y) в пикселях для применения к камере или отрисовке

Source code in pygine/effects.py 
208
209
210
211
212
213
214
215
def get_screen_shake_offset() -> Tuple[float, float]:
    """
    Получить текущее смещение для тряски экрана.

    Возвращает:
        Кортеж (offset_x, offset_y) в пикселях для применения к камере или отрисовке
    """
    return _screen_shake.get_offset()

is_screen_shaking()

Проверить, активна ли тряска экрана.

Возвращает

True, если тряска активна

Source code in pygine/effects.py 
218
219
220
221
222
223
224
225
def is_screen_shaking() -> bool:
    """
    Проверить, активна ли тряска экрана.

    Возвращает:
        True, если тряска активна
    """
    return _screen_shake.is_active()

start_screen_shake(intensity, duration, frequency=30.0)

Запустить эффект тряски экрана.

Аргументы

intensity: Интенсивность тряски (в пикселях, рекомендуется 1-10) duration: Продолжительность тряски (в секундах) frequency: Частота тряски (колебаний в секунду, по умолчанию 30)

Пример

start_screen_shake(5, 0.5) # Средняя тряска на полсекунды start_screen_shake(10, 1.0, 20) # Сильная тряска на секунду с низкой частотой

Source code in pygine/effects.py 
192
193
194
195
196
197
198
199
200
201
202
203
204
205
def start_screen_shake(intensity: float, duration: float, frequency: float = 30.0) -> None:
    """
    Запустить эффект тряски экрана.

    Аргументы:
        intensity: Интенсивность тряски (в пикселях, рекомендуется 1-10)
        duration: Продолжительность тряски (в секундах)
        frequency: Частота тряски (колебаний в секунду, по умолчанию 30)

    Пример:
        >>> start_screen_shake(5, 0.5)  # Средняя тряска на полсекунды
        >>> start_screen_shake(10, 1.0, 20)  # Сильная тряска на секунду с низкой частотой
    """
    _screen_shake.start_shake(intensity, duration, frequency)

update_effects(dt)

Обновить все эффекты. Вызывать из игрового цикла.

Source code in pygine/effects.py 
228
229
230
231
def update_effects(dt: float) -> None:
    """Обновить все эффекты. Вызывать из игрового цикла."""
    _particle_system.update(dt)
    _screen_shake.update(dt)