Wing Commander
Reconstructed Win32 source (1996)
Loading...
Searching...
No Matches
music.c File Reference
Sound and music

Music state machine and the streaming music script. More...

#include "wc1.h"
#include <limits.h>

Go to the source code of this file.

Functions

void FadeMusic (void)
void SetMusicOn (short enabled)
void StopMusic (short unused)
void SetMusBreakpt (int first, int second)
void PaletteFadeHook (void)
void FlushSoundEffect (void)
void FlushSoundEffects (void)
void SceneLeaveHook (void)
void SelectFlightMusicTrack (int track)
int MapMusicTrackToStreamerCommand (int track)
int ProcessMusicScriptCommand (int track, int command, short enabled)
unsigned int spacetrack (int track, int mode, short enabled)
void StopMusicUnlessSuppressed (void)
unsigned short GetMusicMode (void)
void wait_for_end_of_music (void)
void WaitForMusicOrInput (void)
int report_kilrathi_rout (int mode)
short __stdcall RandomInRange (short lo, short hi)
unsigned int triumph (short obj)
int missile_on_tail (short obj)
int any_enemy_tail (short obj)
int is_ship_tailing_player_target (short obj)
int calculate_damage_level (void)
void new_space_music_changes (short attacker, short victim)
int changetrack (void)
void gametrack (void)
void servicetrack (void)
void ResetSoundState (void)
void ResetSoundStateForScene (void)
void ResetSoundStateForFlight (void)
void DisableMusicForScene (void)
void EnableMusicForScene (void)
unsigned int SoundFxTick (void)
void FlushSoundEffectsAndLog (int soundHandle, short fadeTicks)
void sound_effect (void)
void PlaySfxWaveFileByNumber (int soundNumber, int sourceObject, int looping)

Variables

short nMusicPlaybackMode = 0
static int bMusicCommandSuppressed = 0
static int DAT_0046aa00 = 0
short nMusicTrackComplete = 1
static int DAT_0046aa08 = 0
static short nMusicWaitForInput = 1
short nFuneralSequenceActive = 0
int nCurrentMusicTrack = -1
static int nMusicStreamSet = -1
static int DAT_0046aa1c = 0
static int DAT_0046aa20 = 0
int nInFlightMusicSlotA = -1
static int DAT_0046aa28 = 0
int nInFlightMusicSlotB = -1
int nWaitForMusicEnabled = 1
int nFlightSoundEffectsEnabled = 1
int nInitialFlightMusicPending = 1
int nCombatMusicActive = 0
int nInFlightMusicActive = 0
static int DAT_0046aa44 = 0
static short nPassingShipSoundObject = -1
static short nPassingShipSoundCountdown = 0
unsigned char aabSoundEffectDescriptors [37][8]
static char szSfxWavePath [0xc8]
unsigned short awObjectScales [SPACE_OBJECT_COUNT]
signed char acVduModeStackDepth [16]
signed char acShipSpawnNavPt [16]
short asShipAccumulatedDmg [SPACE_OBJECT_COUNT]
short nCurrentNavigationPoint
int nJoystickCalibrationMinimumY
int nJoystickCalibrationMinimumX
int nJoystickCalibrationMaximumX
int nJoystickCalibrationMaxY
unsigned short awPalEntryAllocation [256]
struct Shape * apCommunicationPortraitShapesTable [16]
char szHudMessageBuf [0x60]
char * aapszPilotSpeeches [14][11]
signed char abCommMenuChoiceCommands [7]

Detailed Description

Music state machine and the streaming music script.

Address range 42e320-42efbf. The routines print their own names: StopMusic, FadeMusic, SetMusicOn and others.

Definition in file music.c.

Function Documentation

◆ any_enemy_tail()

int any_enemy_tail ( short obj)

Definition at line 512 of file logic.c.

◆ calculate_damage_level()

int calculate_damage_level ( void )

Definition at line 2123 of file main.c.

◆ changetrack()

int changetrack ( void )

Definition at line 520 of file music.c.

References aeShipMissionType, aMissionObjectivesArray, cCurrentObjective, changetrack(), MISSION_TYPE_DEFEND, MISSION_TYPE_ESCORT, MISSION_TYPE_PATROL, MISSION_TYPE_RENDEZVOUS, MISSION_TYPE_STRIKE, OBJECTIVE_HOME_BASE, and triumph().

Referenced by changetrack(), gametrack(), init_3Space_objects(), and LaunchPlayerShip().

◆ DisableMusicForScene()

void DisableMusicForScene ( void )

Definition at line 692 of file music.c.

References DisableMusicForScene(), nWaitForMusicEnabled, SetMusicOn(), and StopMusicUnlessSuppressed().

Referenced by DisableMusicForScene().

◆ EnableMusicForScene()

void EnableMusicForScene ( void )

Definition at line 700 of file music.c.

References EnableMusicForScene(), nWaitForMusicEnabled, and SetMusicOn().

Referenced by EnableMusicForScene(), and init_3Space_objects().

◆ FadeMusic()

void FadeMusic ( void )

Definition at line 102 of file music.c.

References FadeMusic(), and SoundDebugPrintf().

Referenced by FadeMusic(), and init_3Space_objects().

◆ FlushSoundEffect()

void FlushSoundEffect ( void )

Definition at line 137 of file music.c.

References FlushSoundEffect(), SoundDebugPrintf(), and stop_all_sounds().

Referenced by FlushSoundEffect(), and init_3Space_objects().

◆ FlushSoundEffects()

void FlushSoundEffects ( void )

Definition at line 144 of file music.c.

References FlushSoundEffects(), SoundDebugPrintf(), and stop_all_sounds().

Referenced by FlushSoundEffects(), FlushSoundEffectsAndLog(), init_3Space_objects(), ResetSoundState(), and scramble().

◆ FlushSoundEffectsAndLog()

void FlushSoundEffectsAndLog ( int soundHandle,
short fadeTicks )

Definition at line 714 of file music.c.

References FlushSoundEffects(), FlushSoundEffectsAndLog(), szSfxWavePath, and void().

Referenced by accelerate_and_move_object(), FlushSoundEffectsAndLog(), house_keep(), init_3Space_objects(), landing(), PlayScrambleHangarScene(), scramble(), ShowCarrierLaunchSequence(), TheEndFireWorks(), and update_lights().

◆ gametrack()

void gametrack ( void )

Definition at line 552 of file music.c.

References any_enemy_tail(), calculate_damage_level(), changetrack(), gametrack(), is_ship_tailing_player_target(), missile_on_tail(), nCombatMusicActive, nCurrentMusicTrack, nCurrentSpaceFrameValue, nInFlightMusicActive, nInitialFlightMusicPending, nMusicStreamSet, nMusicTrackComplete, nTrainSimActive, report_kilrathi_rout(), SoundDebugPrintf(), and spacetrack().

Referenced by gametrack(), init_3Space_objects(), and servicetrack().

◆ GetMusicMode()

unsigned short GetMusicMode ( void )

Definition at line 426 of file music.c.

References GetMusicMode(), nMusicPlaybackMode, and nMusicTrackComplete.

Referenced by funeral_sequence(), GetMusicMode(), and init_3Space_objects().

◆ is_ship_tailing_player_target()

int is_ship_tailing_player_target ( short obj)

Definition at line 552 of file logic.c.

◆ MapMusicTrackToStreamerCommand()

int MapMusicTrackToStreamerCommand ( int track)

Definition at line 253 of file music.c.

References MapMusicTrackToStreamerCommand(), and SoundDebugPrintf().

Referenced by init_3Space_objects(), MapMusicTrackToStreamerCommand(), and ProcessMusicScriptCommand().

◆ missile_on_tail()

int missile_on_tail ( short obj)

Definition at line 562 of file logic.c.

◆ new_space_music_changes()

void new_space_music_changes ( short attacker,
short victim )

Definition at line 480 of file music.c.

References acShipRating, aeShipMissionType, aeShipSide, anShipMissionShips, MISSION_TYPE_DEFEND, MISSION_TYPE_ESCORT, new_space_music_changes(), nInFlightMusicActive, nShipMissionIndices, nTrainSimActive, nYourWingman, RandomInRange(), report_kilrathi_rout(), SIDE_IMPERIAL, SIDE_KILRATHI, and spacetrack().

Referenced by analyze_kill(), init_3Space_objects(), and new_space_music_changes().

◆ PaletteFadeHook()

void PaletteFadeHook ( void )

Definition at line 132 of file music.c.

References PaletteFadeHook().

Referenced by init_3Space_objects(), PaletteFadeHook(), and ShowCarrierLaunchSequence().

◆ PlaySfxWaveFileByNumber()

void PlaySfxWaveFileByNumber ( int soundNumber,
int sourceObject,
int looping )

Definition at line 733 of file music.c.

References aiSoundEffectSourceActiveArray, aShipPositionsArray, ComputeVectorDelta(), EYE_OBJECT, PlaySfxWaveFileByNumber(), playWAVE(), szSfxWavePath, and Vector_magnitude().

◆ ProcessMusicScriptCommand()

int ProcessMusicScriptCommand ( int track,
int command,
short enabled )

Definition at line 345 of file music.c.

References bMusicCommandSuppressed, ForceStreamerTrigger(), MapMusicTrackToStreamerCommand(), nCurrentMusicTrack, nMusicStreamSet, ProcessMusicScriptCommand(), SelectFlightMusicTrack(), SetStreamerIntensity(), SoundDebugPrintf(), StopMusic(), and Streamer_trigger().

Referenced by init_3Space_objects(), ProcessMusicScriptCommand(), and spacetrack().

◆ RandomInRange()

short __stdcall RandomInRange ( short lo,
short hi )

Definition at line 49 of file mathfp.c.

◆ report_kilrathi_rout()

int report_kilrathi_rout ( int mode)

Definition at line 391 of file logic.c.

◆ ResetSoundState()

void ResetSoundState ( void )

Definition at line 669 of file music.c.

References bAfterburnerSfxEnabled, FlushSoundEffects(), nCurrentDamageAlarmSfxHandle, and ResetSoundState().

Referenced by auto_pilot_sequence(), init_3Space_objects(), LaunchPlayerShip(), ResetSoundState(), ResetSoundStateForFlight(), ResetSoundStateForScene(), ShowCarrierLaunchSequence(), ShowGetReadyScreen(), and Title_Sequence().

◆ ResetSoundStateForFlight()

void ResetSoundStateForFlight ( void )

Definition at line 684 of file music.c.

References nFlightSoundEffectsEnabled, ResetSoundState(), and ResetSoundStateForFlight().

Referenced by HandleSpaceFlightControls(), init_3Space_objects(), and ResetSoundStateForFlight().

◆ ResetSoundStateForScene()

void ResetSoundStateForScene ( void )

Definition at line 677 of file music.c.

References nFlightSoundEffectsEnabled, ResetSoundState(), and ResetSoundStateForScene().

Referenced by HandleSpaceFlightControls(), init_3Space_objects(), and ResetSoundStateForScene().

◆ SceneLeaveHook()

void SceneLeaveHook ( void )

Definition at line 151 of file music.c.

References SceneLeaveHook().

Referenced by death_sequence(), init_3Space_objects(), PlayScrambleHangarScene(), and SceneLeaveHook().

◆ SelectFlightMusicTrack()

void SelectFlightMusicTrack ( int track)

Definition at line 156 of file music.c.

References ClearStreamerTrigger(), nMusicStreamSet, SelectFlightMusicTrack(), SoundDebugPrintf(), Streamer_close(), and Streamer_open().

Referenced by init_3Space_objects(), ProcessMusicScriptCommand(), and SelectFlightMusicTrack().

◆ servicetrack()

void servicetrack ( void )

Definition at line 605 of file music.c.

References AddFixedVectors(), aeObjectClass, aiSoundEffectSourceActiveArray, aShipPositionsArray, aShipVelocity, asObjDistancesTable, asObjectScreenXList, asPreviousObjectDistance, ComputeVectorDelta(), dot_product(), EYE_OBJECT, gametrack(), nCurrentSpaceFrameValue, nFlightSoundEffectsEnabled, nPassingShipAudioCooldown, nPassingShipSoundCountdown, nPassingShipSoundObject, OBJECT_CLASS_ASTEROID, OBJECT_CLASS_CAPITAL_SHIP, OBJECT_CLASS_SHIP, PlaySfxWaveFileByNumber(), ScaleFixedVector(), servicetrack(), and SPACE_OBJECT_COUNT.

Referenced by init_3Space_objects(), servicetrack(), and Update_3Space().

◆ SetMusBreakpt()

void SetMusBreakpt ( int first,
int second )

Definition at line 124 of file music.c.

References SetMusBreakpt(), SoundDebugPrintf(), and void().

Referenced by ejection_sequence(), funeral_sequence(), init_3Space_objects(), SetMusBreakpt(), and wait_for_end_of_music().

◆ SetMusicOn()

void SetMusicOn ( short enabled)

Definition at line 108 of file music.c.

References SetMusicOn(), and SoundDebugPrintf().

Referenced by DisableMusicForScene(), EnableMusicForScene(), init_3Space_objects(), and SetMusicOn().

◆ sound_effect()

void sound_effect ( void )

Definition at line 724 of file music.c.

References sound_effect(), szSfxWavePath, and WriteDebugString().

Referenced by init_3Space_objects(), and sound_effect().

◆ SoundFxTick()

unsigned int SoundFxTick ( void )

Definition at line 707 of file music.c.

References SoundFxTick(), and WriteDebugString().

Referenced by init_3Space_objects(), SoundFxTick(), and TheEndFireWorks().

◆ spacetrack()

unsigned int spacetrack ( int track,
int mode,
short enabled )

Definition at line 411 of file music.c.

References nMusicPlaybackMode, ProcessMusicScriptCommand(), and spacetrack().

Referenced by AwardCampaignMedal(), BarracksScreen(), death_sequence(), DeBriefing(), DrawMedalChest(), ejection_sequence(), EstablishingShot(), funeral_sequence(), gametrack(), init_3Space_objects(), landing(), LaunchPlayerShip(), LoadBriefingRoom(), new_space_music_changes(), Office(), PlayScrambleHangarScene(), RecRoom(), ReturnToBriefingLongShot(), set_up_next_wave(), ShowCampaignVictorySequence(), ShowCarrierLaunchSequence(), ShowGameOverScreen(), ShowMeanwhileTransition(), ShowTheEndScreen(), ShowTigerClawEscapeScene(), spacetrack(), Title_Sequence(), and update_missile_warning().

◆ StopMusic()

void StopMusic ( short unused)

Definition at line 114 of file music.c.

References nCurrentMusicTrack, SoundDebugPrintf(), StopMusic(), Streamer_stop(), and void().

Referenced by init_3Space_objects(), ProcessMusicScriptCommand(), ShowMeanwhileTransition(), ShowTheEndScreen(), StopMusic(), StopMusicUnlessSuppressed(), wait_for_end_of_music(), and WaitForMusicOrInput().

◆ StopMusicUnlessSuppressed()

void StopMusicUnlessSuppressed ( void )

Definition at line 419 of file music.c.

References nMusicPlaybackMode, StopMusic(), and StopMusicUnlessSuppressed().

Referenced by AwardCampaignMedal(), BarracksScreen(), death_sequence(), DeBriefing(), DisableMusicForScene(), ejection_sequence(), free_inflight_music(), funeral_sequence(), init_3Space_objects(), landing(), LaunchPlayerShip(), LoadBriefingRoom(), Office(), RecRoom(), ReturnToBriefingLongShot(), scramble(), ShowCampaignVictorySequence(), ShowCarrierLaunchSequence(), ShowGameOverScreen(), ShowMeanwhileTransition(), ShowTheEndScreen(), ShowTigerClawEscapeScene(), StopMusicUnlessSuppressed(), Title_Sequence(), and WaitForMusicOrInput().

◆ triumph()

unsigned int triumph ( short obj)

Definition at line 1328 of file logic.c.

◆ wait_for_end_of_music()

void wait_for_end_of_music ( void )

Definition at line 435 of file music.c.

References bEscapePressedFlag, CheckEscaped(), nMusicPlaybackMode, nMusicTrackComplete, nWaitForMusicEnabled, SetMusBreakpt(), StopMusic(), and wait_for_end_of_music().

Referenced by init_3Space_objects(), and wait_for_end_of_music().

◆ WaitForMusicOrInput()

void WaitForMusicOrInput ( void )

Definition at line 452 of file music.c.

References bEscapePressedFlag, CheckEscaped(), nMusicPlaybackMode, nMusicTrackComplete, nMusicWaitForInput, nWaitForMusicEnabled, StopMusic(), StopMusicUnlessSuppressed(), and WaitForMusicOrInput().

Referenced by init_3Space_objects(), and WaitForMusicOrInput().

Variable Documentation

◆ aabSoundEffectDescriptors

unsigned char aabSoundEffectDescriptors[37][8]

Definition at line 40 of file music.c.

Referenced by TheEndFireWorks().

◆ aapszPilotSpeeches

char* aapszPilotSpeeches[14][11]

Definition at line 98 of file music.c.

Referenced by free_pilot_talk(), get_pilot_talk(), real_vid_transmit(), and vid_transmit().

◆ abCommMenuChoiceCommands

signed char abCommMenuChoiceCommands[7]

Definition at line 99 of file music.c.

Referenced by AppendCommMenuChoice(), Chosen_communicate_option(), and ResetCommMenuChoices().

◆ acShipSpawnNavPt

signed char acShipSpawnNavPt[16]

Definition at line 88 of file music.c.

Referenced by set_up_action_sphere(), and Set_up_ship_info().

◆ acVduModeStackDepth

signed char acVduModeStackDepth[16]

Definition at line 87 of file music.c.

Referenced by get_mode(), GetVduModeStackDepth(), pop_mode(), push_mode(), and set_mode().

◆ apCommunicationPortraitShapesTable

struct Shape* apCommunicationPortraitShapesTable[16]

Definition at line 96 of file music.c.

Referenced by EndCommSessionWithWingman(), free_pilot_talk(), FreeCommDisplayResources(), LoadCommPortraitShape(), LoadSpaceflightResources(), real_vid_transmit(), and vid_transmit().

◆ asShipAccumulatedDmg

short asShipAccumulatedDmg[SPACE_OBJECT_COUNT]

Definition at line 89 of file music.c.

Referenced by animate_object(), calculate_damage_level(), fire_weapon(), inflict_damage(), internal_damage(), object_collision(), set_objects_data(), Set_up_ship_info(), and your_internal_damage().

◆ awObjectScales

unsigned short awObjectScales[SPACE_OBJECT_COUNT]

Definition at line 86 of file music.c.

Referenced by animate_object(), animate_shape(), Explosion(), house_keep_objects(), object_collision(), onboard_explosion(), place_exhaust_on_ships(), reposition_fixed_child_objects(), set_objects_data(), ShipExplosion(), ShowCarrierLaunchSequence(), ShowTigerClawEscapeScene(), and transform_objects_to_your_view().

◆ awPalEntryAllocation

unsigned short awPalEntryAllocation[256]

Definition at line 95 of file music.c.

Referenced by PrintPaletteAllocationMap(), ReleaseContiguousPaletteEntries(), and ReserveContiguousPaletteEntries().

◆ bMusicCommandSuppressed

int bMusicCommandSuppressed = 0
static

Definition at line 15 of file music.c.

Referenced by ProcessMusicScriptCommand().

◆ DAT_0046aa00

int DAT_0046aa00 = 0
static

Definition at line 16 of file music.c.

◆ DAT_0046aa08

int DAT_0046aa08 = 0
static

Definition at line 18 of file music.c.

◆ DAT_0046aa1c

int DAT_0046aa1c = 0
static

Definition at line 23 of file music.c.

◆ DAT_0046aa20

int DAT_0046aa20 = 0
static

Definition at line 24 of file music.c.

◆ DAT_0046aa28

int DAT_0046aa28 = 0
static

Definition at line 26 of file music.c.

◆ DAT_0046aa44

int DAT_0046aa44 = 0
static

Definition at line 33 of file music.c.

◆ nCombatMusicActive

int nCombatMusicActive = 0

Definition at line 31 of file music.c.

Referenced by gametrack(), and init_inflight_music().

◆ nCurrentMusicTrack

int nCurrentMusicTrack = -1

Definition at line 21 of file music.c.

Referenced by gametrack(), ProcessMusicScriptCommand(), and StopMusic().

◆ nCurrentNavigationPoint

short nCurrentNavigationPoint

Definition at line 90 of file music.c.

Referenced by abandoned(), arrive_from_warp(), auto_pilot_sequence(), FindNearestNavPoint(), init_intelligence_data(), orbit_sphere(), ReleaseStaleNavTarget(), set_up_action_sphere(), and set_up_next_wave().

◆ nFlightSoundEffectsEnabled

int nFlightSoundEffectsEnabled = 1

Definition at line 29 of file music.c.

Referenced by HandleSpaceFlightControls(), ResetSoundStateForFlight(), ResetSoundStateForScene(), and servicetrack().

◆ nFuneralSequenceActive

short nFuneralSequenceActive = 0

Definition at line 20 of file music.c.

Referenced by funeral_sequence().

◆ nInFlightMusicActive

int nInFlightMusicActive = 0

Definition at line 32 of file music.c.

Referenced by free_inflight_music(), gametrack(), init_inflight_music(), and new_space_music_changes().

◆ nInFlightMusicSlotA

int nInFlightMusicSlotA = -1

Definition at line 25 of file music.c.

Referenced by free_inflight_music().

◆ nInFlightMusicSlotB

int nInFlightMusicSlotB = -1

Definition at line 27 of file music.c.

Referenced by free_inflight_music().

◆ nInitialFlightMusicPending

int nInitialFlightMusicPending = 1

Definition at line 30 of file music.c.

Referenced by gametrack(), and init_inflight_music().

◆ nJoystickCalibrationMaximumX

int nJoystickCalibrationMaximumX

Definition at line 93 of file music.c.

Referenced by LoadJoystickCalibrationFile().

◆ nJoystickCalibrationMaxY

int nJoystickCalibrationMaxY

Definition at line 94 of file music.c.

Referenced by LoadJoystickCalibrationFile().

◆ nJoystickCalibrationMinimumX

int nJoystickCalibrationMinimumX

Definition at line 92 of file music.c.

Referenced by LoadJoystickCalibrationFile().

◆ nJoystickCalibrationMinimumY

int nJoystickCalibrationMinimumY

Definition at line 91 of file music.c.

Referenced by LoadJoystickCalibrationFile().

◆ nMusicPlaybackMode

short nMusicPlaybackMode = 0

Definition at line 14 of file music.c.

Referenced by funeral_sequence(), GetMusicMode(), LoadOriginFxDrivers(), main(), spacetrack(), StopMusicUnlessSuppressed(), wait_for_end_of_music(), and WaitForMusicOrInput().

◆ nMusicStreamSet

int nMusicStreamSet = -1
static

Definition at line 22 of file music.c.

Referenced by gametrack(), ProcessMusicScriptCommand(), and SelectFlightMusicTrack().

◆ nMusicTrackComplete

short nMusicTrackComplete = 1

Definition at line 17 of file music.c.

Referenced by gametrack(), GetMusicMode(), UpdateStreamerStoppedFlag(), wait_for_end_of_music(), and WaitForMusicOrInput().

◆ nMusicWaitForInput

short nMusicWaitForInput = 1
static

Definition at line 19 of file music.c.

Referenced by WaitForMusicOrInput().

◆ nPassingShipSoundCountdown

short nPassingShipSoundCountdown = 0
static

Definition at line 35 of file music.c.

Referenced by servicetrack().

◆ nPassingShipSoundObject

short nPassingShipSoundObject = -1
static

Definition at line 34 of file music.c.

Referenced by servicetrack().

◆ nWaitForMusicEnabled

int nWaitForMusicEnabled = 1

Definition at line 28 of file music.c.

Referenced by DisableMusicForScene(), EnableMusicForScene(), funeral_sequence(), wait_for_end_of_music(), and WaitForMusicOrInput().

◆ szHudMessageBuf

char szHudMessageBuf[0x60]

Definition at line 97 of file music.c.

Referenced by PromptForAnswerText(), ShowCentredPrompt(), and ShowOnScreenMessage().

◆ szSfxWavePath

char szSfxWavePath[0xc8]
static

Definition at line 82 of file music.c.

Referenced by FlushSoundEffectsAndLog(), PlaySfxWaveFileByNumber(), and sound_effect().