102 Dalmatians: Puppies to the Rescue
Decompilation Source Reference | GitLab repository
Loading...
Searching...
No Matches
effects.c
Go to the documentation of this file.
1/* Recovered game implementation; original addresses identify provenance. */
10#include "pcdogs/math/types.h"
11#include <math.h>
12#include <stdarg.h>
13#include <string.h>
14
15// Original pcdogs.exe: 0x4114c0
16// Starts a ten-tick camera shake using the supplied amplitude.
17void Camera_StartShake(struct Math_Vec3I32 *unused_position, int16_t amplitude)
18{
19 (void)unused_position;
21 g_cameraShakeAmplitude = amplitude;
22}
23
24// Original pcdogs.exe: 0x4114e0
25// Initializes the camera roll duration, remaining ticks and amplitude.
26void Camera_StartRollEffect(int16_t amplitude, int16_t duration_ticks)
27{
28 g_cameraRollDurationTicks = duration_ticks;
29 g_cameraRollTicksRemaining = duration_ticks;
30 g_cameraRollAmplitude = amplitude;
31}
32
33// Original pcdogs.exe: 0x411500
34// Updates the base camera and entity worklists, then applies shake and roll effects in that order.
36{
37 // CAMERA EFFECTS COORDINATOR: Called each frame to update g_cameraData. Sequence: Follow -> Shake -> Fade
41}
42
43// Original pcdogs.exe: 0x411530
44// Advances the active shake and adds its Q12 offset to both eye and target Z coordinates. The remaining tick selects the shake table without a bounds check.
46{
48 int16_t *countdown = &effects->shake_ticks_remaining;
49
50 if (!*countdown)
51 return;
52
53 int16_t intensity = effects->shake_amplitude;
54
55 *countdown = (int16_t)(*countdown - 1);
56
57 int32_t offset = (int32_t)(((int64_t)intensity * g_cameraShakeParams[*countdown]) >> MATH_Q12_SHIFT);
58
59 camera->target_pos.z += offset;
60 camera->eye_pos.z += offset;
61}
62
63// Original pcdogs.exe: 0x411590
64// Advances the eased camera roll and resets it to zero on the final tick. Active interpolation requires a nonzero duration.
66{
68 int16_t remaining_ticks = effects->roll_ticks_remaining; // Check if fade timer is active
69
70 // Check if fade timer is active (remaining frames > 0)
71 // CAMERA FADE: Timer at +0x100d8, duration at +0x100da, target at +0x100dc. Uses Math_EaseInOut for
72 // smooth transitions. Fade value stored at +0x8.
73 if (!remaining_ticks)
74 return;
75
76 effects->roll_ticks_remaining = remaining_ticks - 1;
77
78 if (remaining_ticks == 1)
79 {
80 camera->view_roll = remaining_ticks - 1; // If timer reached zero, clear fade value at camera+0x8 and return
81
82 // Calculate fade progress: progress = ((duration - remaining) * 0x1000) / duration
83 // Result is 0x0000 at start, 0x1000 at end (12-bit fixed point)
84 return;
85 }
86
87 int32_t duration_ticks = (int32_t)effects->roll_duration_ticks;
88 int32_t eased_progress_q12 =
89 Math_EaseInOut((int64_t)((duration_ticks - (int32_t)(int16_t)(remaining_ticks - 1)) << MATH_Q12_SHIFT) / duration_ticks, MATH_Q12_HALF, MATH_Q12_HALF);
90 int64_t roll_product = (int64_t)effects->roll_amplitude * eased_progress_q12;
91
92 camera->view_roll = (int16_t)(roll_product >> MATH_Q12_SHIFT);
93}
#define CAMERA_SHAKE_DURATION_FRAMES
Definition constants.h:20
void Camera_UpdateShakeOffset(struct Camera_Runtime *camera)
Definition effects.c:45
void Camera_StartRollEffect(int16_t amplitude, int16_t duration_ticks)
Definition effects.c:26
void Camera_UpdateRollEffect(struct Camera_Runtime *camera)
Definition effects.c:65
void Camera_UpdateEffects()
Definition effects.c:35
void Camera_StartShake(struct Math_Vec3I32 *unused_position, int16_t amplitude)
Definition effects.c:17
void Camera_UpdateFollowAndEntityWorklists(struct Camera_Runtime *camera)
Definition tracking.c:41
#define g_cameraRollDurationTicks
Definition globals.h:75
#define g_cameraShakeTicksRemaining
Definition globals.h:66
#define g_cameraRollAmplitude
Definition globals.h:78
#define g_cameraShakeParams
Definition globals.h:24
#define g_cameraShakeAmplitude
Definition globals.h:69
#define g_cameraData
Definition globals.h:63
#define g_cameraRollTicksRemaining
Definition globals.h:72
#define MATH_Q12_SHIFT
Definition constants.h:8
#define MATH_Q12_HALF
Definition constants.h:10
int32_t Math_EaseInOut(int32_t t_q12, int32_t ease_in_q12, int32_t ease_out_q12)
int16_t shake_ticks_remaining
Definition types.h:284
int16_t roll_ticks_remaining
Definition types.h:286
struct Camera_Runtime camera
Definition types.h:282
int16_t roll_duration_ticks
Definition types.h:287
struct Math_Vec3I32XZY target_pos
Definition types.h:263
int16_t view_roll
Definition types.h:259
struct Math_Vec3I32XZY eye_pos
Definition types.h:262
int32_t z
Definition types.h:483