THE BEHAVIOR OF THIS METHOD WILL CHANGE IN A FUTURE RELEASE. See below for further information.
- po:A pointer to an ITrigplayerEx object.
- newPlayerName:The name of the new TrigPlayer in /players (see below). This must not be NULL, must not be the string "default", and must be unique among all TrigPlayers that are Split() from the same original player.
- ppNewTrigplayer:The address of a pointer that will be filled in with the address of the new TrigPlayer widget.
int ITRIGPLAYEREX_Split(ITrigplayerEx* po, const AECHAR* newPlayerName, ITrigplayerEx** ppNewTrigplayer);
A BREW error code (either SUCCESS or ENOMEMORY).
Split TrigPlayers can communicate with each other by sending events to /players/
The lifetimes of the split TrigPlayers are completely independent. Neither owns the other, and each can be Split() again if desired.
THE IMPLEMENTATION OF THIS METHOD IN UIONE SDK 2.0 IS A STUB. Its behaviour will change in a future release. In uiOne SDK 2.0, calling this method is almost equivalent to calling ISHELL_CreateInstance(AEECLSID_TRIGPLAYER). The new TrigPlayer widget shares no state with the original. Because /trig is not shared, the new TrigPlayer's Trig model must therefore be initialized as per usual prior to loading content. /players is not shared either, which means that although the newPlayerName parameter to this method is honoured, it is not useful, because the split players cannot communicate with each other.
In a future release, the behaviour of this method will change so that the new TrigPlayer widget shares the bulk of its state with the original. All state that is independent of the content tree (such as /trig, /var, /actor, /players and the Lua virtual machine state) will be shared between the split TrigPlayers. Only the TrigML document and other data directly associated with the content tree will not be shared.