41 lines
		
	
	
		
			1.9 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			41 lines
		
	
	
		
			1.9 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
/*
 | 
						|
 * This file is part of OpenTTD.
 | 
						|
 * OpenTTD is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2.
 | 
						|
 * OpenTTD is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 | 
						|
 * See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenTTD. If not, see <http://www.gnu.org/licenses/>.
 | 
						|
 */
 | 
						|
 | 
						|
/** @file newgrf_sound.h Functions related to NewGRF provided sounds. */
 | 
						|
 | 
						|
#ifndef NEWGRF_SOUND_H
 | 
						|
#define NEWGRF_SOUND_H
 | 
						|
 | 
						|
#include "sound_type.h"
 | 
						|
#include "tile_type.h"
 | 
						|
#include "vehicle_type.h"
 | 
						|
 | 
						|
/** Events at which a sound might be played. */
 | 
						|
enum VehicleSoundEvent {
 | 
						|
	VSE_START         = 1, ///< Vehicle starting, i.e. leaving, the station.
 | 
						|
	VSE_TUNNEL        = 2, ///< Train entering a tunnel.
 | 
						|
	VSE_BREAKDOWN     = 3, ///< Vehicle breaking down.
 | 
						|
	VSE_RUNNING       = 4, ///< Vehicle running normally.
 | 
						|
	VSE_TOUCHDOWN     = 5, ///< Whenever a plane touches down.
 | 
						|
	VSE_VISUAL_EFFECT = 6, ///< Vehicle visual effect (steam, diesel smoke or electric spark) is shown.
 | 
						|
	VSE_RUNNING_16    = 7, ///< Every 16 ticks while the vehicle is running (speed > 0).
 | 
						|
	VSE_STOPPED_16    = 8, ///< Every 16 ticks while the vehicle is stopped (speed == 0).
 | 
						|
	VSE_LOAD_UNLOAD   = 9, ///< Whenever cargo payment is made for a vehicle.
 | 
						|
};
 | 
						|
 | 
						|
 | 
						|
SoundEntry *AllocateSound(uint num);
 | 
						|
void InitializeSoundPool();
 | 
						|
bool LoadNewGRFSound(SoundEntry *sound);
 | 
						|
SoundID GetNewGRFSoundID(const struct GRFFile *file, SoundID sound_id);
 | 
						|
SoundEntry *GetSound(SoundID sound_id);
 | 
						|
uint GetNumSounds();
 | 
						|
bool PlayVehicleSound(const Vehicle *v, VehicleSoundEvent event);
 | 
						|
void PlayTileSound(const struct GRFFile *file, SoundID sound_id, TileIndex tile);
 | 
						|
 | 
						|
#endif /* NEWGRF_SOUND_H */
 |