CWE-ou-minkata/Sources/Plasma/PubUtilLib/plMessage/plLoadCloneMsg.h

/*==LICENSE==*

CyanWorlds.com Engine - MMOG client, server and tools
Copyright (C) 2011 Cyan Worlds, Inc.

This program 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, either version 3 of the License, or
(at your option) any later version.

This program 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 this program. If not, see <http://www.gnu.org/licenses/>.

Additional permissions under GNU GPL version 3 section 7

If you modify this Program, or any covered work, by linking or
combining it with any of RAD Game Tools Bink SDK, Autodesk 3ds Max SDK,
NVIDIA PhysX SDK, Microsoft DirectX SDK, OpenSSL library, Independent
JPEG Group JPEG library, Microsoft Windows Media SDK, or Apple QuickTime SDK
(or a modified version of those libraries),
containing parts covered by the terms of the Bink SDK EULA, 3ds Max EULA,
PhysX SDK EULA, DirectX SDK EULA, OpenSSL and SSLeay licenses, IJG
JPEG Library README, Windows Media SDK EULA, or QuickTime SDK EULA, the
licensors of this Program grant you additional
permission to convey the resulting work. Corresponding Source for a
non-source form of such a combination shall include the source code for
the parts of OpenSSL and IJG JPEG Library used as well as that of the covered
work.

You can contact Cyan Worlds, Inc. by email legal@cyan.com
 or by snail mail at:
      Cyan Worlds, Inc.
      14617 N Newport Hwy
      Mead, WA   99021

*==LICENSE==*/
#ifndef NO_AV_MSGS
#ifndef SERVER

#ifndef plLoadCloneMsgMsg_INC
#define plLoadCloneMsgMsg_INC


#include "../pnMessage/plMessage.h"
// #include "hsUtils.h"
#include "../pnKeyedObject/plUoid.h"

/** \class plLoadCloneMsg
	Tell the net client manager to allocate a new object based on copying an
	existing, statically keyed object.
	On the initiating machine, this will synthesize a new key and load the object.
	On the remote machines, it will use the (enclosed) new key and load the object.
	On both machines, the requestor will be notified after the object is loaded.
	*/
class plLoadCloneMsg : public plMessage
{
public:
	/** Default constructor. only useful for sending over the network, prior
		to reading and writing. The clone message needs to synthesize its key
		to do anything, and this constructor doesn't do that, because it doesn't
		have enough information. */
	plLoadCloneMsg();

	/** Canonical constructor. If you're trying to initiate a clone, this is
		the one you want to use.
		These messages are *always* sent to the net client manager. You can't
		address them.
		After they are received on the remote machines, they are forwarded
		the remote versions of the requestor.

		\param uoidToClone - Specifies the template that will be cloned.
		\param requestorKey - The key of the object that is requesting the clone. It's
			strongly recommended that this be a local object, so that we don't get the same
			requestor creating multiple clones by starting the process on several machines.
		\param userData - Whatever you want. Will be propagated to the requestor after cloning.
						
	*/
	plLoadCloneMsg(const plUoid &uoidToClone, const plKey &requestorKey, UInt32 userData);

	/** This constructor form is for when you want to send a clone message based on
		an existing cloned object. The two primary uses of this are:
		- unload an existing clone
		- replicate a locally existing clone to other machines. You'll need
		to set up the network propagation parameters yourself.
		\param existing - The key to the clone you want to work on
		\param requestor - Will be notified when the (un)clone is processed)
		\param userData - Whatever you want. Will be propagated to the requestor.
		\param isLoading - Are we loading or unloading?
		*/
	plLoadCloneMsg(const plKey &existing, const plKey &requestor, UInt32 userData, hsBool isLoading);

	virtual ~plLoadCloneMsg();

	CLASSNAME_REGISTER(plLoadCloneMsg);
	GETINTERFACE_ANY(plLoadCloneMsg, plMessage);

	// IO 
	void Read(hsStream* stream, hsResMgr* mgr);
	void Write(hsStream* stream, hsResMgr* mgr);

	void ReadVersion(hsStream* stream, hsResMgr* mgr);
	void WriteVersion(hsStream* stream, hsResMgr* mgr);
	
	plKey	GetCloneKey();
	plKey	GetRequestorKey();
	hsBool	IsValidMessage();
	UInt32	GetUserData();
	UInt32	GetOriginatingPlayerID();
	void	SetOriginatingPlayerID(UInt32 playerId);
	hsBool	GetIsLoading();
	void	SetTriggerMsg(plMessage *msg);
	plMessage *GetTriggerMsg();


protected:
	plKey	fCloneKey;				// the key that will be loaded
	plKey	fRequestorKey;			// forward the message to this guy after the clone is created
	hsBool	fValidMsg;				// only gets set if the message built successfully
	UInt32	fUserData;				// let requestors send some data to their remote versions
	UInt32	fOriginatingPlayerID;	// network / player id of the client initiating the request
	hsBool	fIsLoading;				// true if we're loading; false if we're unloading
	plMessage *fTriggerMsg;			// Handy place to store a message that caused you to request a clone,
									// so you can see it and continue processing once your clone is loaded.
};

#endif


#endif // ndef SERVER
#endif // ndef NO_AV_MSGS