Method LoadAnimation

CryAnimation/ControllerManager.cpp:132–192

///////////////////////////////////////////////////////////////////// Loads the animation controllers into the existing animation record. May be used to load the animation the first time, or reload it upon request. Does nothing if there are already controls in the existing animation record.

// May be used to load the animation the first time, or reload it upon request.
// Does nothing if there are already controls in the existing animation record.
bool CControllerManager::LoadAnimation(int nAnimId)
{
	FUNCTION_PROFILER( g_GetISystem(),PROFILE_ANIMATION );

	Animation& Anim = m_arrAnims[nAnimId];
	if (Anim.IsLoaded())
		return true;

	if (Anim.nFlags & Animation::FLAGS_LOAD_PENDING)
	{
		// we already have this animation being loaded
		return true;
	}

	unsigned nFileSize = g_GetStreamEngine()->GetFileSize(Anim.strFileName.c_str());

	if (!nFileSize) // no such file
	{
		if (!(Anim.nFlags & GlobalAnimation::FLAGS_DISABLE_LOAD_ERROR_LOG))
			g_GetLog()->LogError ("\003CControllerManager::LoadAnimation: file loading %s file not found", Anim.strFileName.c_str());
		return false;
	}

	if (Anim.IsInfoLoaded())
	{	// we can start loading asynchronously
		// this structure will keep the info until the completion routine is called
		PendingAnimLoad_AutoPtr pAnimLoad = new PendingAnimLoad;
		pAnimLoad->nAnimId = nAnimId;
		pAnimLoad->pFile = new CFileMapping;
		pAnimLoad->pFile->attach (malloc (nFileSize), nFileSize);
		pAnimLoad->nFrameId = g_nFrameID;
		
		// these parameters tell that the file must be read directly into the file mapping object
		// the file mapping object will be passed to the chunk reader that will parse the data
		StreamReadParams params;
		params.dwUserData = (DWORD_PTR)(PendingAnimLoad*)pAnimLoad;
		params.nSize = nFileSize;
		params.pBuffer = pAnimLoad->pFile->getData();

		// now we're prepared to read, register the pending operation and start reading
		m_setPendingAnimLoads.insert (pAnimLoad);
		// mark the animation as being loaded
		Anim.nFlags |= Animation::FLAGS_LOAD_PENDING;
		// we're not interested in the pointer to the read stream - we only need to know when it's finished
		pAnimLoad->pStream = g_GetStreamEngine()->StartRead("Animation", Anim.strFileName.c_str(), this, &params);
		return true;
	}
	else
	{
		// if the info hasn't still been loaded, we need to load synchronously
		// try to read the file
		CChunkFileReader Reader;
		if (!Reader.open (Anim.strFileName))
		{
			if (!(Anim.nFlags & GlobalAnimation::FLAGS_DISABLE_LOAD_ERROR_LOG))
				g_GetLog()->LogError ("\003CControllerManager::LoadAnimation: file loading %s, last error is: %s", Anim.strFileName.c_str(), Reader.getLastError());
			return false;
		}