Add xEntryCam.py

Scripts/Python/xEntryCam.py

@@ -0,0 +1,124 @@
+# -*- coding: utf-8 -*-
+""" *==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==* """
+
+from Plasma import *
+from PlasmaTypes import *
+from PlasmaConstants import *
+
+actRegionSensor = ptAttribActivator(1, "act: Camera Region Sensor")
+camera = ptAttribSceneobject(2, "Entry Camera")
+undoFirstPerson = ptAttribBoolean(3, "Override the player's first person camera setting?", default=True)
+
+class xEntryCam(ptModifier):
+ def __init__(self):
+ ptModifier.__init__(self)
+ self.id = 900378302
+ self.version = 1
+
+ self._entryCamActive = False
+ self._linkedIn = False
+
+ PtDebugPrint(f"xEntryCam.__init__() {self.version=}", level=kWarningLevel)
+
+ def _DisableEnterRgn(self, reason="unknown"):
+ PtDebugPrint(f"xEntryCam._DisableEnterRgn(): [{self.sceneobject.getName()}] Disabling entry region... [Reason: {reason}]", level=kWarningLevel)
+
+ # We're tracking the enable/disable state of the entry camera region in
+ # a variable because disabling the activator seems to propagate out to
+ # the host scene object, disabling both regions. We need the exit region
+ # to be active, though, to ensure the entry camera is popped off on exit,
+ # not when we link-in... that defeats the purpose!
+ self._linkedIn = True
+ PtGetLocalAvatar().avatar.unRegisterForBehaviorNotify(self.key)
+
+ def OnServerInitComplete(self):
+ # When we finish linking in, all entry regions will be disabled.
+ PtGetLocalAvatar().avatar.registerForBehaviorNotify(self.key)
+
+ # No need for server arbitration on these because it's all local.
+ actRegionSensor.volumeSensorNoArbitration()
+
+ def OnBehaviorNotify(self, type, id, state):
+ PtDebugPrint(f"xEntryCam.OnBehaviorNotify(): {type=} {id=} {state=}", level=kDebugDumpLevel)
+ if type == PtBehaviorTypes.kBehaviorTypeLinkIn:
+ self._DisableEnterRgn("done linking in")
+
+ def OnNotify(self, state, id, events):
+ if PtFindAvatar(events) != PtGetLocalAvatar():
+ return
+ if id != actRegionSensor.id:
+ return
+
+ # Search for a collision event in the notification's event records. The second item in
+ # the record is the entered state. Note that the engine is currently passing integers
+ # instead of proper booleans, and a value of `None` indicates that no collision
+ # event was found at all. Be careful!
+ rgnEntered = next((event[1] for event in events if event[0] == kCollisionEvent), None)
+
+ if rgnEntered is None:
+ PtDebugPrint(f"xEntryCam.OnNotify(): [{self.sceneobject.getName()}] Ignoring spurious notification", level=kDebugDumpLevel)
+ elif rgnEntered:
+ if self._linkedIn:
+ PtDebugPrint(f"xEntryCam.OnNotify(): [{self.sceneobject.getName()}] Ignoring entry cam enter trigger.", level=kDebugDumpLevel)
+ return
+
+ self._DisableEnterRgn("entry cam triggered")
+ PtDebugPrint(f"xEntryCam.OnNotify(): [{self.sceneobject.getName()}] Pushing entry camera {camera.value.getName()}", level=kWarningLevel)
+ if not self._entryCamActive:
+ virtCam = ptCamera()
+ virtCam.save(camera.value.getKey())
+ # This will only force the player out of first person if the age creator says that we should do so *and* the player
+ # has *not* enabled the "stay in first person" flag. If the player has "stay in first person" enabled, then they
+ # will not be forced into third person for this entry camera.
+ if undoFirstPerson.value:
+ virtCam.undoFirstPerson()
+ self._entryCamActive = True
+ else:
+ if not self._entryCamActive:
+ PtDebugPrint(f"xEntryCam.OnNotify(): [{self.sceneobject.getName()}] Ignoring entry cam region exit trigger.", level=kDebugDumpLevel)
+ return
+
+ PtDebugPrint(f"xEntryCam.OnNotify(): [{self.sceneobject.getName()}] Popping entry camera {camera.value.getName()}", level=kWarningLevel)
+ virtCam = ptCamera()
+ virtCam.restore(camera.value.getKey())
+ self._entryCamActive = False