Method LoadSound

CrySoundSystem/SoundSystem.cpp:1206–1303

/////////////////////////////////////////////////////////////////

//////////////////////////////////////////////////////////////////////
ISound* CSoundSystem::LoadSound(const char *szFile, int flags)
{
	GUARD_HEAP;
	FUNCTION_PROFILER( GetSystem(),PROFILE_SOUND );

	CSound* pSound = NULL;
	
	if (!szFile || (!szFile[0])) 
		return (NULL);

	//if (!strlen(szFile)) 
	//	return (NULL);
 
	if (flags & FLAG_SOUND_3D)	// make all 3d sounds use the sw-attenuation
		flags|=FLAG_SOUND_RADIUS;
	
	CSoundBuffer *pSB;
	SSoundBufferProps name=SSoundBufferProps(szFile, flags);
	SoundBufferPropsMapItor nit = m_soundBuffers.find(name);
	if ((!(flags & FLAG_SOUND_STREAM)) && (nit!=m_soundBuffers.end()))	// we cannot share streams !
	{
		//sound is already present

		pSB= nit->second;

		if (flags & FLAG_SOUND_3D)
		{			
			if (pSB->GetProps().nFlags & FLAG_SOUND_2D)
			{
				m_pILog->Log("\001 [ERROR] trying to load the same sound buffer file as 2d and 3d sound (%s)",szFile);
				return (NULL);
			}
		}
		else
		if (flags & FLAG_SOUND_2D)
		{
			if (pSB->GetProps().nFlags & FLAG_SOUND_3D)
			{
				m_pILog->Log("\001 [ERROR] trying to load the same sound buffer file as 2d and 3d sound (%s)",szFile);
				return (NULL);
			}
		}

		//create a new instance	
		pSound=new CSound(this,szFile);

		pSound->m_pSound=pSB;		

		AddToSoundSystem(pSound,flags);

		return (pSound);			
	}

	// check if this is an ogg...to avoid people calling
	// loadsound and decompressing the entire ogg into memory (several megabytes)
	// but if the load sync is specified, load the sound anyway doesnt matter what
	if (!(flags & FLAG_SOUND_LOAD_SYNCHRONOUSLY))
	{