You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
119 lines
4.6 KiB
119 lines
4.6 KiB
/*==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/>. |
|
|
|
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
|
|
|