Special Stages: fade out music near the finish line

src/k_kart.c

@@ -10663,6 +10663,12 @@ void K_KartUpdatePosition(player_t *player)
 		player->topinfirst = 0;
 	}
 
+	// Special stages: fade out music near the finish line
+	if (P_IsLocalPlayer(player))
+	{
+		K_FadeOutSpecialMusic(player->distancetofinish);
+	}
+
 	player->position = position;
 }
 

src/k_specialstage.c

@@ -21,6 +21,7 @@
 #include "z_zone.h"
 #include "k_waypoint.h"
 #include "k_objects.h"
+#include "music.h"
 
 struct specialstageinfo specialstageinfo;
 
@@ -127,6 +128,11 @@ void K_TickSpecialStage(void)
 	K_MoveExitBeam();
 }
 
+/*--------------------------------------------------
+	mobj_t *K_GetPossibleSpecialTarget(void)
+
+		See header file for description.
+--------------------------------------------------*/
 mobj_t *K_GetPossibleSpecialTarget(void)
 {
 	if (specialstageinfo.valid == false)
@@ -141,3 +147,20 @@ mobj_t *K_GetPossibleSpecialTarget(void)
 
 	return specialstageinfo.ufo;
 }
+
+/*--------------------------------------------------
+	void K_FadeOutSpecialMusic(UINT32 distance)
+
+		See header file for description.
+--------------------------------------------------*/
+void K_FadeOutSpecialMusic(UINT32 distance)
+{
+	if (specialstageinfo.valid == false)
+	{
+		return;
+	}
+
+	const UINT32 threshold = FixedMul(16000, mapobjectscale);
+
+	Music_LevelVolume(min(distance, threshold) * 100 / threshold);
+}

src/k_specialstage.h

@@ -68,6 +68,18 @@ void K_TickSpecialStage(void);
 
 mobj_t *K_GetPossibleSpecialTarget(void);
 
+/*--------------------------------------------------
+	void K_FadeOutSpecialMusic(UINT32 distance)
+
+		Fade level music out at the end of a special stage.
+
+	Input Arguments:-
+		distance - Distance from the finish line.
+
+--------------------------------------------------*/
+
+void K_FadeOutSpecialMusic(UINT32 distance);
+
 #ifdef __cplusplus
 } // extern "C"
 #endif