// Copyright (c) 2010 Nokia Corporation and/or its subsidiary(-ies).

// All rights reserved.

// This component and the accompanying materials are made available

// under the terms of "Eclipse Public License v1.0"

// which accompanies this distribution, and is available

// at the URL "http://www.eclipse.org/legal/epl-v10.html".

//

// Initial Contributors:

// Nokia Corporation - initial contribution.

//

// Contributors:

//

// Description: The main purpose of RTFXEffect implementation is to forward 

// RWsSession/RWindowBase calls to RegisterEffect and OverrideEffect to server side. 

// Please see documantion of RTFXEffect::RegisterTFXEffect() for more details.

//

#include "rtfxeffect.h"

#include "w32comm.h"

#include "client.h"

/**

Constructor which takes handle and buffer paratemter and initilaizes 

its member variables.

@param aHandle Client side handle of the class derived from MWsClientClass

@param aBuffer Pointer to the wserv client side buffer of the above class

*/

RTFXEffect::RTFXEffect(TInt aHandle, RWsBuffer* aBuffer) 

	: MWsClientClass(aBuffer), iDirPathSizePaded(0), iFileName1SizePaded(0),

	  iFileName2SizePaded(0), iCombSizePaded(0) 

	{

	iWsHandle = aHandle;

	}

/**

Function checks the sent parmaters and pancis client if any of its length 

is greater than KMaxFileName. Calculates the padded lengths of sent parameters

and stores them in member variables

@param aResourceDir directory name of animation description file

@param aFilenameOutgoing File name of Outgoing phase of TFX

@param aFilenameIncoming File name of Incoming phase of TFX

*/

void RTFXEffect::CheckFileNameAndSetSizes(const TFileName& aResourceDir, 

		const TFileName& aFilenameOutgoing, const TFileName& aFilenameIncoming)

	{

	__ASSERT_ALWAYS(aResourceDir.Length() <= KMaxFileName, Panic(EW32PanicStringTooLong));

	__ASSERT_ALWAYS(aFilenameOutgoing.Length() <= KMaxFileName, Panic(EW32PanicStringTooLong));

	__ASSERT_ALWAYS(aFilenameIncoming.Length() <= KMaxFileName, Panic(EW32PanicStringTooLong));

	iDirPathSizePaded = PaddedValue(aResourceDir.Size());

	iFileName1SizePaded = PaddedValue(aFilenameOutgoing.Size());

	iFileName2SizePaded = PaddedValue(aFilenameIncoming.Size());

	iCombSizePaded = iDirPathSizePaded + iFileName1SizePaded + iFileName2SizePaded;

	}

/**

Appends folder and file names to wserv client's buffer using AppendData() of MWsClientClass.

AppendData adds data directly to buffer. So before calling AppendData we must make sure that

current command is added to buffer. Please see description of MWsClientClass::AppendData()

for more details.

@param aResourceDir directory name of animation description file

@param aFilenameOutgoing File name of Outgoing phase of TFX

@param aFilenameIncoming File name of Incoming phase of TFX

*/

void RTFXEffect::AppendFileNameData(const TFileName& aResourceDir, const TFileName& aFilenameOutgoing, const TFileName& aFilenameIncoming)

	{

	AppendData(aResourceDir.Ptr(), aResourceDir.Size(), EFalse);

    AppendData(aFilenameOutgoing.Ptr(), aFilenameOutgoing.Size(), EFalse);

    AppendData(aFilenameIncoming.Ptr(), aFilenameIncoming.Size(), ETrue);

	}

/**

Writes file names using IPC args along with data related to TWsClCmdRegisterEffect

Out going phase animation file name is sent in second slot of IPC to server

In coming phase animation file name is sent in third slot of IPC to server

Data related to TWsClCmdRegisterEffect and folder name are sent in the normal wserv buffer

@param aForRegister an object of TWsClCmdRegisterEffect filled with data related to RegisterTFXEffect

					If non Empty then this function is called for Register effect

@param aForOverride an object of TWsClCmdOverrideEffect filled with data related to OverrideTFXEffect

					If non Empty then this function is called for Overide effect					 

@param aResourceDir directory name of animation description file

@param aFilenameOutgoing File name of Outgoing phase of TFX

@param aFilenameIncoming File name of Incoming phase of TFX

@param aCalledFrom value from TFXEffect enum reprseting whether called from RWsSession or RWindowbase 	

*/

void RTFXEffect::WriteDataUsingIPC(TWsClCmdRegisterEffect* aForRegister, TWsClCmdOverrideEffect* aForOverride, 

		const TFileName& aResourceDir, const TFileName& aFilenameOutgoing, const TFileName& aFilenameIncoming, TFXEffect aCalledFrom)

	{

	TIpcArgs ipcArgsDesc;

	ipcArgsDesc.Set(1, &aFilenameOutgoing);

	ipcArgsDesc.Set(2, &aFilenameIncoming);

	// If called for RegisterTFXEffect

	if (aForRegister)

		{

		Write(aForRegister, sizeof(*aForRegister), aResourceDir.Ptr(), aResourceDir.Size(), 

				EWsClOpRegisterTFXEffectIPC, &ipcArgsDesc);

		}

	else	// Else called for OverrideTFXEffect

		{

		Write(aForOverride, sizeof(*aForOverride), aResourceDir.Ptr(), aResourceDir.Size(), 

				(aCalledFrom == ETFXSession ? EWsClOpOverrideEffectIPC : EWsWinOpOverrideEffectIPC), &ipcArgsDesc);

		}

	}

/**

Checks if the sum of iCombSizePaded, size of TWsCmdHeader and sent size is less than

the current buffer size.

@param aSize size to be compared with current buffer size

@return ETrue if the combined size if less then or equal to current buffer size

		EFalse if the combined size is greater then current buffer size

 */

TBool RTFXEffect::CheckCombinedSizeWithCurrentBuffer(TInt aSize) const

	{

	return (iCombSizePaded + aSize + sizeof(TWsCmdHeader) <= iBuffer->BufferSize());

	}

/**

Checks the length of sent variables and does as explained below   

Main logic involved in both RegisterTFXEffect() and OverrideTFXEffect() is as follows

First check the sum of all strings 

If it is less then max wserv buffer

 Send unpadded sizes in TWsClCmdRegisterEffect/TWsClCmdOverrideEffect but when we append 

 the data we make sure that we pad it

 Then at server side get the buffer for total length(inlcuding pading)and unpad it and 

 send it to renderstage's RegisterEffect/OverrideEffect function

If it is greater then max wserv buffer 

 Send one string in the wserv buffer as done before ie. pading and unpading

 Other two strings are sent using IPC args in 2 and 3 slot of IPC and do explicit flush

 And at server side get one string from buffer and other 2 from IPC

@param aAction Particular transition to register the animation for.

@param aPurpose The purpose of the window.

@param aResourceDir The name of the directory that contains the animation description files.

@param aFilenameOutgoing The file containing the description of the animation for the outgoing phase of the transition. 

						 Specify KNullDesC for no outgoing phase effect.

@param aFilenameIncoming The file containing the description of the animation for the incoming phase of the transition. 

						 Specify KNullDesC for no incoming phase effect.

@param aAppUid The Application UID this effect applies to. Set to zero to specify that all apps will use default effect.

@param aFlags Flag for the effect. Please see TTfxFlags for values this flag parameter can use.

*/

void RTFXEffect::RegisterTFXEffect(TInt aAction, TInt aPurpose, const TFileName& aResourceDir, 

		const TFileName& aFilenameOutgoing, const TFileName& aFilenameIncoming, TUint aAppUid, TBitFlags aFlags)

	{

	CheckFileNameAndSetSizes(aResourceDir, aFilenameOutgoing, aFilenameIncoming);

	if (CheckCombinedSizeWithCurrentBuffer(sizeof(TWsClCmdRegisterEffect)))

		{

		TWsClCmdRegisterEffect params(aAction, aPurpose, aResourceDir.Size(), aFilenameOutgoing.Size(), aFilenameIncoming.Size(), aAppUid, aFlags);

		// Here we just pass the length of combined strings so that it checks and does flush if needed.

		// Then AppendData actually adds the data to buffer at the end

		Write(&params, sizeof(params), iCombSizePaded, EWsClOpRegisterTFXEffectBuf);

		if (iCombSizePaded > 0)

			AppendFileNameData(aResourceDir, aFilenameOutgoing, aFilenameIncoming);

		}

	else

		{

		TWsClCmdRegisterEffect params(aAction, aPurpose, aResourceDir.Size(), 0, 0, aAppUid, aFlags);

		WriteDataUsingIPC(&params, NULL, aResourceDir, aFilenameOutgoing, aFilenameIncoming, ETFXSession);

		}

	}

/**

Checks the length of sent variables and does as explained in

RTFXEffect::RegisterTFXEffect() API description

@param aAction The particular transition to set the animation for.

@param aPurpose This override only effects the window/layers owned by the application that have the specified purpose.

@param aResourceDir The name of the directory that contains the animation description files.

@param aFilenameOutgoing The file containing the description of the animation for the outgoing phase of the transition. 

						 Specify KNullDesC for no outgoing phase effect.

@param aFilenameIncoming The file containing the description of the animation for the incoming phase of the transition. 

						 Specify KNullDesC for no incoming phase effect.

@param aFlags Flag for the effect. Please see TTfxFlags for values this flag parameter can use.

*/

void RTFXEffect::OverrideTFXEffect(TFXEffect aCalledFrom, TInt aAction, TInt aPurpose, const TFileName& aResourceDir, 

		const TFileName& aFilenameOutgoing, const TFileName& aFilenameIncoming, TBitFlags aFlags)

	{

	CheckFileNameAndSetSizes(aResourceDir, aFilenameOutgoing, aFilenameIncoming);

	if (CheckCombinedSizeWithCurrentBuffer(sizeof(TWsClCmdOverrideEffect)))

		{

		TWsClCmdOverrideEffect params(aAction, aPurpose, aResourceDir.Size(), aFilenameOutgoing.Size(), aFilenameIncoming.Size(), aFlags);

		Write(&params, sizeof(params), iCombSizePaded, (aCalledFrom == ETFXSession ? EWsClOpOverrideEffectBuf : EWsWinOpOverrideEffectBuf));

		if (iCombSizePaded > 0)

			AppendFileNameData(aResourceDir, aFilenameOutgoing, aFilenameIncoming);

		}

	else

		{

		TWsClCmdOverrideEffect params(aAction, aPurpose, aResourceDir.Size(), 0, 0, aFlags);

		WriteDataUsingIPC(NULL, &params, aResourceDir, aFilenameOutgoing, aFilenameIncoming, aCalledFrom);

		}

	}