Class IMergeManager

3DS Max Plug-In SDK

Class IMergeManager

See Also: Class InterfaceServer, List of Reference Messages , Class ExclList

class IMergeManager : public InterfaceServer

Description:

This class is available in release 4.0 and later only.

This class facilitates taking care of node handles when merging and xref’ing scenes.

 

When nodes are merged, their handles will be reassigned so that their handles will not conflict with existing nodes in the scene. After the merge process has completed, all merged objects will receive a reference notification; REFMSG_NODE_HANDLE_CHANGED. The PartID will be a pointer to a merge manager interface that you can use to see if a specific handle was converted and convert between the old and the new handle. IMergeManager* pMergeManager = (IMergeManager*)partID; If a plug-in uses node handles in a persistent manner it has to intercept this reference message and convert the previous handles to the newly generated handles.

Methods:

public:

Prototype:

virtual ULONG GetNewHandle(ULONG oldHandle) = 0;

Remarks:

This method allows you to obtain a new handle.

Parameters:

ULONG oldHandle

The old handle you wish to obtain a new one for.

Return Value:

The new handle.

Prototype:

virtual bool HandleExist(ULONG handle) = 0;

Remarks:

This method allows you to check if a handle already exists.

Parameters:

ULONG handle

The handle you wish to check for.

Return Value:

TRUE if the handle exists; otherwise FALSE.