Source code for direct.showbase.DistancePhasedNode

from direct.showbase.DirectObject import DirectObject
from direct.directnotify.DirectNotifyGlobal import directNotify
from panda3d.core import *
from .PhasedObject import PhasedObject


[docs]class DistancePhasedNode(PhasedObject, DirectObject, NodePath): """ This class defines a PhasedObject,NodePath object that will handle the phasing of an object in the scene graph according to its distance from some other collider object(such as an avatar). Since it's a NodePath, you can parent it to another object in the scene graph, or even inherit from this class to get its functionality. What you will need to define to use this class: - The distances at which you want the phases to load/unload - Whether you want the object to clean itself up or not when exitting the largest distance sphere - What the load/unload functions are - What sort of events to listen for when a collision occurs - (Optional) A collision bitmask for the phase collision spheres - (Optional) A 'from' collision node to collide into our 'into' spheres You specify the distances and function names by the phaseParamMap parameter to `__init__()`. For example:: phaseParamMap = {'Alias': distance, ...} ... def loadPhaseAlias(self): pass def unloadPhaseAlias(self): pass If the 'fromCollideNode' is supplied, we will set up our own traverser and only traverse below this node. It will send out events of the form '<enterPrefix>%in' and '<exitPrefix>%in' in order to match the main collision traverser's patterns. Note that this will only be used after a reset or phase change in order to fully transition to the correct phase in a single pass. Most of the time, it will be reacting to events from the main collision traverser. IMPORTANT: The following only applies when ``autoCleanup is True``: If you unload the last phase, by either calling `cleanup()` or by exiting the last phase's distance, you will need to explicitly call `reset()` to get the distance phasing to work again. This was done so if either this node or the collider is removed from the scene graph (e.g. avatar teleport), the phased object will clean itself up automatically. """ notify = directNotify.newCategory("DistancePhasedObject") __InstanceSequence = 0 __InstanceDeque = [] @staticmethod def __allocateId(): """ Give each phase node a unique id in order to filter out collision events from other phase nodes. We do it in this manner so the client doesn't need to worry about giving each phase node a unique name. """ if DistancePhasedNode.__InstanceDeque: return DistancePhasedNode.__InstanceDeque.pop(0) else: id = DistancePhasedNode.__InstanceSequence DistancePhasedNode.__InstanceSequence += 1 DistancePhasedNode.__InstanceSequence &= 65535 return id @staticmethod def __deallocateId(id): """ Reuse abandoned ids. """ DistancePhasedNode.__InstanceDeque.append(id)
[docs] def __init__(self, name, phaseParamMap = {}, autoCleanup = True, enterPrefix = 'enter', exitPrefix = 'exit', phaseCollideMask = BitMask32.allOn(), fromCollideNode = None): NodePath.__init__(self, name) self.phaseParamMap = phaseParamMap self.phaseParamList = sorted(list(phaseParamMap.items()), key = lambda x: x[1], reverse = True) PhasedObject.__init__(self, dict([(alias,phase) for (phase,alias) in enumerate([item[0] for item in self.phaseParamList])])) self.__id = self.__allocateId() self.autoCleanup = autoCleanup self.enterPrefix = enterPrefix self.exitPrefix = exitPrefix self.phaseCollideMask = phaseCollideMask self.cTrav = base.cTrav self.fromCollideNode = fromCollideNode self._colSpheres = [] self.reset()
def __del__(self): self.__deallocateId(self.__id) def __repr__(self): outStr = 'DistancePhasedObject(' outStr += repr(self.getName()) for param, value in zip(('phaseParamMap', 'autoCleanup', 'enterPrefix', 'exitPrefix', 'phaseCollideMask', 'fromCollideNode'), ({}, True, 'enter', 'exit', BitMask32.allOn(), None)): pv = getattr(self, param) if pv != value: outStr += ', %s = %r' % (param, pv) outStr += ')' return outStr def __str__(self): return '%s in phase \'%s\'' % (NodePath.__str__(self), self.getPhase())
[docs] def cleanup(self): """ Disables all collisions. Ignores all owned event listeners. Unloads all unloaded phases. """ self.__disableCollisions(cleanup = True) for sphere in self._colSpheres: sphere.remove() self._colSpheres = [] PhasedObject.cleanup(self)
[docs] def setPhaseCollideMask(self, mask): """ Sets the intoCollideMasks for our collision spheres. """ self.phaseCollideMask = mask for sphere in self._colSpheres: self.colSphere.node().setIntoCollideMask(self.phaseCollideMask)
[docs] def reset(self): """ Unloads all loaded phases and puts the phase node in the startup state is if it had just been initialized. """ self.cleanup() self.__oneTimeCollide() for name, dist in self.phaseParamList: cSphere = CollisionSphere(0.0, 0.0, 0.0, dist) cSphere.setTangible(0) cName = 'PhaseNode%s-%d' % (name, self.__id) cSphereNode = CollisionNode(cName) cSphereNode.setIntoCollideMask(self.phaseCollideMask) cSphereNode.setFromCollideMask(BitMask32.allOff()) cSphereNode.addSolid(cSphere) cSphereNodePath = self.attachNewNode(cSphereNode) cSphereNodePath.stash() # cSphereNodePath.show() # For debugging self._colSpheres.append(cSphereNodePath) if self.fromCollideNode: self.cTrav = CollisionTraverser() cHandler = CollisionHandlerEvent() cHandler.addInPattern(self.enterPrefix + '%in') cHandler.addOutPattern(self.exitPrefix + '%in') self.cTrav.addCollider(self.fromCollideNode,cHandler) self.__enableCollisions(-1)
[docs] def setPhase(self, aPhase): """ See PhasedObject.setPhase() """ phase = self.getAliasPhase(aPhase) PhasedObject.setPhase(self, aPhase) self.__disableCollisions() self.__enableCollisions(phase) if phase == -1 and self.autoCleanup: self.cleanup() else: self.__oneTimeCollide()
def __getEnterEvent(self, phaseName): return '%sPhaseNode%s-%d' % (self.enterPrefix, phaseName, self.__id) def __getExitEvent(self, phaseName): return '%sPhaseNode%s-%d' % (self.exitPrefix, phaseName, self.__id) def __enableCollisions(self, phase): """ Turns on collisions for the spheres bounding this phase zone by unstashing their geometry. Enables the exit event for the larger and the enter event for the smaller. Handles the extreme(end) phases gracefully. """ if 0 <= phase: phaseName = self.getPhaseAlias(phase) self.accept(self.__getExitEvent(phaseName), self.__handleExitEvent, extraArgs = [phaseName]) self._colSpheres[phase].unstash() if 0 <= phase+1 < len(self._colSpheres): phaseName = self.getPhaseAlias(phase+1) self.accept(self.__getEnterEvent(phaseName), self.__handleEnterEvent, extraArgs = [phaseName]) self._colSpheres[phase+1].unstash() def __disableCollisions(self, cleanup = False): """ Disables all collision geometry by stashing the geometry. If autoCleanup == True and we're not currently cleaning up, leave the exit event and collision sphere active for the largest(thus lowest) phase. This is so that we can still cleanup if the phase node exits the largest sphere. """ for x,sphere in enumerate(self._colSpheres): phaseName = self.getPhaseAlias(x) self.ignore(self.__getEnterEvent(phaseName)) if x > 0 or not self.autoCleanup or cleanup: sphere.stash() self.ignore(self.__getExitEvent(phaseName)) def __handleEnterEvent(self, phaseName, cEntry): self.setPhase(phaseName) def __handleExitEvent(self, phaseName, cEntry): phase = self.getAliasPhase(phaseName) - 1 self.setPhase(phase) def __oneTimeCollide(self): """ Fire off a one-time collision traversal of the scene graph. This allows us to process our entire phasing process in one frame in the cases where we cross more than one phase border. """ if self.cTrav: if self.cTrav is base.cTrav: # we use 'render'here since if we only try to # traverse ourself, we end up calling exit # events for the rest of the eventHandlers. # Consider supplying the fromCollideNode parameter. self.cTrav.traverse(render) else: # Only traverse ourself self.cTrav.traverse(self) base.eventMgr.doEvents()
[docs]class BufferedDistancePhasedNode(DistancePhasedNode): """ This class is similar to DistancePhasedNode except you can also specify a buffer distance for each phase. Upon entering that phase, its distance will be increased by the buffer amount. Conversely, the distance will be decremented by that amount, back to its original size, upon leaving. In this manner, you can avoid the problem of 'phase flicker' as someone repeatedly steps across a static phase border. You specify the buffer amount in the bufferParamMap parameter to :meth:`__init__()`. It has this format:: bufferParamMap = {'alias':(distance, bufferAmount), ...} """ notify = directNotify.newCategory("BufferedDistancePhasedObject")
[docs] def __init__(self, name, bufferParamMap = {}, autoCleanup = True, enterPrefix = 'enter', exitPrefix = 'exit', phaseCollideMask = BitMask32.allOn(), fromCollideNode = None): self.bufferParamMap = bufferParamMap self.bufferParamList = sorted(list(bufferParamMap.items()), key = lambda x: x[1], reverse = True) sParams = dict(bufferParamMap) for key in sParams: sParams[key] = sParams[key][0] DistancePhasedNode.__init__(self, name = name, phaseParamMap = sParams, autoCleanup = autoCleanup, enterPrefix = enterPrefix, exitPrefix = exitPrefix, phaseCollideMask = phaseCollideMask, fromCollideNode = fromCollideNode)
def __repr__(self): outStr = 'BufferedDistancePhasedNode(' outStr += repr(self.getName()) for param, value in zip(('bufferParamMap', 'autoCleanup', 'enterPrefix', 'exitPrefix', 'phaseCollideMask', 'fromCollideNode'), ({}, True, 'enter', 'exit', BitMask32.allOn(), None)): pv = getattr(self, param) if pv != value: outStr += ', %s = %r' % (param, pv) outStr += ')' return outStr def __str__(self): return '%s in phase \'%s\'' % (NodePath.__str__(self), self.getPhase())
[docs] def setPhase(self, aPhase): """ see DistancePhasedNode.setPhase() """ DistancePhasedNode.setPhase(self, aPhase) phase = self.getAliasPhase(aPhase) self.__adjustCollisions(phase)
def __adjustCollisions(self, phase): for x,sphere in enumerate(self._colSpheres[:phase+1]): sphere.node().modifySolid(0).setRadius(self.bufferParamList[x][1][1]) sphere.node().markInternalBoundsStale() for x,sphere in enumerate(self._colSpheres[phase+1:]): sphere.node().modifySolid(0).setRadius(self.bufferParamList[x+phase+1][1][0]) sphere.node().markInternalBoundsStale()
if __debug__ and 0: cSphere = CollisionSphere(0,0,0,0.1) cNode = CollisionNode('camCol') cNode.addSolid(cSphere) cNodePath = NodePath(cNode) cNodePath.reparentTo(base.cam) # cNodePath.show() # cNodePath.setPos(25,0,0) base.cTrav = CollisionTraverser() eventHandler = CollisionHandlerEvent() eventHandler.addInPattern('enter%in') eventHandler.addOutPattern('exit%in') # messenger.toggleVerbose() base.cTrav.addCollider(cNodePath,eventHandler) p = BufferedDistancePhasedNode('p',{'At':(10,20),'Near':(100,200),'Far':(1000, 1020)}, autoCleanup = False, fromCollideNode = cNodePath, ) p.reparentTo(render) p._DistancePhasedNode__oneTimeCollide() base.eventMgr.doEvents()