com.threerings.tudey.server
Class TudeySceneManager

java.lang.Object
  com.threerings.crowd.server.PlaceManager
      com.threerings.whirled.server.SceneManager
          com.threerings.tudey.server.TudeySceneManager

All Implemented Interfaces:

RunQueue, com.threerings.crowd.chat.server.SpeakHandler.SpeakerValidator, com.threerings.presents.data.InvocationCodes, com.threerings.presents.dobj.ChangeListener, com.threerings.presents.dobj.MessageListener, com.threerings.presents.server.InvocationProvider, TudeyCodes, TudeySceneModel.Observer, TudeySceneProvider, ActorAdvancer.Environment

Direct Known Subclasses:

ToolSceneManager

public class TudeySceneManager
extends com.threerings.whirled.server.SceneManager
implements TudeySceneProvider, TudeySceneModel.Observer, ActorAdvancer.Environment, RunQueue, TudeyCodes

Manager for Tudey scenes.

Nested Class Summary

static interface	TudeySceneManager.ActorObserver An interface for objects to notify when actors are added or removed.
static interface	TudeySceneManager.IntersectionSensor An interface for objects that should be notified when actors intersect them.
static interface	TudeySceneManager.Sensor Base interface for sensors.
static interface	TudeySceneManager.ShutdownObserver An interface for objects to notify when we shutdown.
static interface	TudeySceneManager.TickParticipant An interface for objects that take part in the server tick.

Nested classes/interfaces inherited from class com.threerings.crowd.server.PlaceManager

com.threerings.crowd.server.PlaceManager.DelegateOp, com.threerings.crowd.server.PlaceManager.MessageHandler

Nested classes/interfaces inherited from interface com.samskivert.util.RunQueue

RunQueue.AsExecutor

Field Summary

Fields inherited from interface com.samskivert.util.RunQueue

AWT

Fields inherited from interface com.threerings.tudey.data.TudeyCodes

DEFAULT_BUFFER_DELAY, DEFAULT_TICK_INTERVAL

Fields inherited from interface com.threerings.presents.data.InvocationCodes

ACCESS_DENIED, E_ACCESS_DENIED, E_INTERNAL_ERROR, GLOBAL_GROUP, INTERNAL_ERROR

Constructor Summary

TudeySceneManager()

Method Summary

void	addActorObserver(TudeySceneManager.ActorObserver observer) Adds an observer for actor events.
void	addMappings(Logic logic) Registers the specified logic object unders its mappings.
void	addShutdownObserver(TudeySceneManager.ShutdownObserver observer) Adds a shutdown observer.
void	addTickParticipant(TudeySceneManager.TickParticipant participant) Adds a participant to notify at each tick.
void	bodyWillEnter(com.threerings.crowd.data.BodyObject body)
void	bodyWillLeave(com.threerings.crowd.data.BodyObject body)
void	clearEnteringBody(com.threerings.crowd.data.BodyObject body) Clears out the mapping for an entering body.
static void	clearTickProfiles() Clears the current set of tick profiles.
boolean	collides(ActorLogic logic) Determines whether the specified actor collides with anything in the environment.
boolean	collides(ActorLogic logic, Shape shape) Determines whether the specified actor collides with anything in the environment.
boolean	collides(ActorLogic logic, Shape shape, int timestamp) Determines whether the specified actor collides with anything in the environment.
boolean	collides(Actor actor, Shape shape) Checks whether the actor is colliding with anything.
boolean	collides(Actor actor, Shape shape, int timestamp) Determines whether the specified actor collides with anything in the environment.
boolean	collides(int mask, Shape shape) Determines whether the specified shape collides with anything in the environment.
boolean	collides(int mask, Shape shape, int timestamp) Determines whether the specified shape collides with anything in the environment.
Logic	createLogic(String cname) Creates an instance of the logic object with the specified class name using the injector, logging a warning and returning null on error.
static void	dumpTickProfiles() Dumps the current set of tick profiles to the log.
void	enqueueInputReliable(com.threerings.presents.data.ClientObject caller, int acknowledge, int smoothedTime, InputFrame[] frames) Handles a TudeySceneService.enqueueInputReliable(int, int, com.threerings.tudey.data.InputFrame[]) request.
void	enqueueInputUnreliable(com.threerings.presents.data.ClientObject caller, int acknowledge, int smoothedTime, InputFrame[] frames) Handles a TudeySceneService.enqueueInputUnreliable(int, int, com.threerings.tudey.data.InputFrame[]) request.
void	enteredPlace(com.threerings.presents.data.ClientObject caller) Handles a TudeySceneService.enteredPlace() request.
void	entryAdded(TudeySceneModel.Entry entry) Notes that an entry has been added to the scene.
void	entryRemoved(TudeySceneModel.Entry oentry) Notes that an entry has been removed from the scene.
void	entryUpdated(TudeySceneModel.Entry oentry, TudeySceneModel.Entry nentry) Notes that an entry has been updated within the scene.
EffectLogic	fireEffect(int timestamp, Logic target, Vector2f translation, float rotation, ConfigReference<EffectConfig> ref) Fires off an effect with the referenced configuration.
EffectLogic	fireEffect(int timestamp, Logic target, Vector2f translation, float rotation, String name) Fires off an effect at the with the named configuration.
EffectLogic	fireEffect(int timestamp, Logic target, Vector2f translation, float rotation, String name, String firstKey, Object firstValue, Object... otherArgs) Fires off an effect with the supplied name and arguments.
ActorLogic	getActorLogic(int id) Returns the logic object for the actor with the provided id, if any.
HashSpace	getActorSpace() Returns a reference to the actor space.
int	getBufferDelay() Returns the delay with which the clients display information received from the server in order to compensate for network jitter and dropped packets.
ConfigManager	getConfigManager() Returns a reference to the configuration manager for the scene.
boolean	getDebugRegions() Checks whether we should show region debug effects.
Rect	getDefaultLocalInterest() Returns the default untransformed area of interest region for clients.
Effect[]	getEffectsFired(PawnLogic target, Rect bounds) Returns an array containing all effects fired on the current tick whose influence regions intersect the provided bounds.
EntryLogic	getEntryLogic(Object key) Returns the logic object for the entry with the provided key, if any.
ArrayList<Logic>	getInstances(Class<? extends Logic> clazz) Returns the list of logic objects that are instances of the supplied class, or null for none.
Logic	getLogic(EntityKey key) Returns the logic object for the entity with the provided key, if any.
int	getNextTimestamp() Returns the approximate timestamp of the next tick.
Pathfinder	getPathfinder() Returns a reference to the pathfinder object.
boolean	getPenetration(Actor actor, Shape shape, Vector2f result) Checks whether the actor is colliding with anything and, if it is, populates the provided object with the penetration vector (the minimum translation required to cancel the penetration).
int	getPreviousTimestamp() Returns the timestamp of the last tick.
TudeySceneModel	getSceneModel() Returns a reference to the scene model.
HashSpace	getSensorSpace() Returns a reference to the sensor space.
Set<ActorLogic>	getStaticActors() Returns a reference to the set of static actors.
Set<ActorLogic>	getStaticActorsAdded() Returns a reference to the set of static actors added on the current tick.
Set<ActorLogic>	getStaticActorsRemoved() Returns a reference to the set of static actors removed on the current tick.
Set<ActorLogic>	getStaticActorsUpdated() Returns a reference to the set of static actors updated on the current tick.
ArrayList<Logic>	getTagged(String tag) Returns the list of logic objects with the supplied tag, or null for none.
PawnLogic	getTarget(com.threerings.presents.data.ClientObject clobj) Returns a reference to the target of the specified client, if any.
long	getTickDuration() Returns the amount of time spent processing the last tick.
int	getTickInterval() Returns the interval at which we call the tick() method.
static int	getTickProfInterval() Returns the tick profile interval.
int	getTicksPerSecond() Returns the number of ticks per second.
int	getTimestamp() Returns the timestamp of the current tick.
int	getTransmitInterval() Returns the interval at which clients transmit their input frames.
void	getVisibleActors(PawnLogic target, Rect bounds, Collection<ActorLogic> results) Populates the supplied collection with references to all non-static actors visible to the specified target whose influence regions intersect the provided bounds.
boolean	isDispatchThread()
boolean	isRunning()
static boolean	isTickProfEnabled() Checks whether tick profiling is enabled.
void	mapEnteringBody(com.threerings.crowd.data.BodyObject body, Object portalKey) Notes that a body will be entering via the identified portal.
void	postRunnable(Runnable runnable)
void	removeActorLogic(int id) Removes the logic mapping for the actor with the given id.
void	removeActorObserver(TudeySceneManager.ActorObserver observer) Removes an actor observer.
void	removeMappings(Logic logic) Remove the specified logic object from the mappings.
void	removeShutdownObserver(TudeySceneManager.ShutdownObserver observer) Removes a shutdown observer.
void	removeTickParticipant(TudeySceneManager.TickParticipant participant) Removes a participant from the tick list.
void	setCameraParams(com.threerings.presents.data.ClientObject caller, CameraConfig config, float aspect) Handles a TudeySceneService.setCameraParams(com.threerings.tudey.config.CameraConfig, float) request.
void	setDefaultLocalInterest(Rect interest) Sets the default untransformed area of interest region for clients.
void	setTarget(com.threerings.presents.data.ClientObject caller, int pawnId) Handles a TudeySceneService.setTarget(int) request.
static void	setTickProfEnabled(boolean enabled) Enables or disables tick participant profiling.
static void	setTickProfInterval(int interval) Sets the frequency at which we sample tick participants.
ActorLogic	spawnActor(int timestamp, Vector2f translation, float rotation, ConfigReference<ActorConfig> ref) Spawns an actor with the referenced configuration.
ActorLogic	spawnActor(int timestamp, Vector2f translation, float rotation, ConfigReference<ActorConfig> ref, Actor actor) Spawns an actor with the referenced configuration.
ActorLogic	spawnActor(int timestamp, Vector2f translation, float rotation, String name) Spawns an actor with the named configuration.
ActorLogic	spawnActor(int timestamp, Vector2f translation, float rotation, String name, String firstKey, Object firstValue, Object... otherArgs) Spawns an actor with the supplied name and arguments.
void	staticActorUpdated(ActorLogic logic) Notes that a static actor's state has changed.
void	submitActorRequest(com.threerings.presents.data.ClientObject caller, int actorId, String name) Handles a TudeySceneService.submitActorRequest(int, java.lang.String) request.
void	submitEntryRequest(com.threerings.presents.data.ClientObject caller, Object key, String name) Handles a TudeySceneService.submitEntryRequest(java.lang.Object, java.lang.String) request.
void	tick() Updates the scene.
int	triggerIntersectionSensors(int timestamp, ActorLogic actor) Triggers any intersection sensors intersecting the specified shape.
int	triggerSensors(Class<? extends TudeySceneManager.Sensor> type, int timestamp, Collection<Shape> shapes, int flags, ActorLogic actor) Triggers any sensors of the specified type intersecting the specified shape.
int	triggerSensors(Class<? extends TudeySceneManager.Sensor> type, int timestamp, Shape shape, int flags, ActorLogic actor) Triggers any sensors of the specified type intersecting the specified shape.

Methods inherited from class com.threerings.whirled.server.SceneManager

getLocation, getScene, getUpdates, isPersistent, where

Methods inherited from class com.threerings.crowd.server.PlaceManager

addDelegate, applyToDelegates, applyToOccupants, checkPermissions, getConfig, getPlaceObject, init, isValidSpeaker, messageReceived, ratifyBodyEntry, registerMessageHandler, shutdown, startup, toString, updateOccupantInfo

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

TudeySceneManager

public TudeySceneManager()

Method Detail

setTickProfEnabled

public static void setTickProfEnabled(boolean enabled)

Enables or disables tick participant profiling.

isTickProfEnabled

public static boolean isTickProfEnabled()

Checks whether tick profiling is enabled.

setTickProfInterval

public static void setTickProfInterval(int interval)

Sets the frequency at which we sample tick participants.

getTickProfInterval

public static int getTickProfInterval()

Returns the tick profile interval.

dumpTickProfiles

public static void dumpTickProfiles()

Dumps the current set of tick profiles to the log.

clearTickProfiles

public static void clearTickProfiles()

Clears the current set of tick profiles.

getBufferDelay

public int getBufferDelay()

Returns the delay with which the clients display information received from the server in order to compensate for network jitter and dropped packets.

getTicksPerSecond

public int getTicksPerSecond()

Returns the number of ticks per second.

getTickInterval

public int getTickInterval()

Returns the interval at which we call the tick() method.

getTransmitInterval

public int getTransmitInterval()

Returns the interval at which clients transmit their input frames.

getConfigManager

public ConfigManager getConfigManager()

Returns a reference to the configuration manager for the scene.

addTickParticipant

public void addTickParticipant(TudeySceneManager.TickParticipant participant)

Adds a participant to notify at each tick.

removeTickParticipant

public void removeTickParticipant(TudeySceneManager.TickParticipant participant)

Removes a participant from the tick list.

addActorObserver

public void addActorObserver(TudeySceneManager.ActorObserver observer)

Adds an observer for actor events.

removeActorObserver

public void removeActorObserver(TudeySceneManager.ActorObserver observer)

Removes an actor observer.

addShutdownObserver

public void addShutdownObserver(TudeySceneManager.ShutdownObserver observer)

Adds a shutdown observer.

removeShutdownObserver

public void removeShutdownObserver(TudeySceneManager.ShutdownObserver observer)

Removes a shutdown observer.

getTimestamp

public int getTimestamp()

Returns the timestamp of the current tick.

getPreviousTimestamp

public int getPreviousTimestamp()

Returns the timestamp of the last tick.

getNextTimestamp

public int getNextTimestamp()

Returns the approximate timestamp of the next tick.

getTickDuration

public long getTickDuration()

Returns the amount of time spent processing the last tick.

getTagged

public ArrayList<Logic> getTagged(String tag)

Returns the list of logic objects with the supplied tag, or null for none.

getInstances

public ArrayList<Logic> getInstances(Class<? extends Logic> clazz)

Returns the list of logic objects that are instances of the supplied class, or null for none.

getActorSpace

public HashSpace getActorSpace()

Returns a reference to the actor space.

getSensorSpace

public HashSpace getSensorSpace()

Returns a reference to the sensor space.

getPathfinder

public Pathfinder getPathfinder()

Returns a reference to the pathfinder object.

setDefaultLocalInterest

public void setDefaultLocalInterest(Rect interest)

Sets the default untransformed area of interest region for clients.

getDefaultLocalInterest

public Rect getDefaultLocalInterest()

Returns the default untransformed area of interest region for clients.

getDebugRegions

public boolean getDebugRegions()

Checks whether we should show region debug effects.

spawnActor

public ActorLogic spawnActor(int timestamp,
                             Vector2f translation,
                             float rotation,
                             String name)

Spawns an actor with the named configuration.

spawnActor

public ActorLogic spawnActor(int timestamp,
                             Vector2f translation,
                             float rotation,
                             String name,
                             String firstKey,
                             Object firstValue,
                             Object... otherArgs)

Spawns an actor with the supplied name and arguments.

spawnActor

public ActorLogic spawnActor(int timestamp,
                             Vector2f translation,
                             float rotation,
                             ConfigReference<ActorConfig> ref)

Spawns an actor with the referenced configuration.

spawnActor

public ActorLogic spawnActor(int timestamp,
                             Vector2f translation,
                             float rotation,
                             ConfigReference<ActorConfig> ref,
                             Actor actor)

Spawns an actor with the referenced configuration.

Parameters:

actor - if non-null, the already-created actor object.

fireEffect

public EffectLogic fireEffect(int timestamp,
                              Logic target,
                              Vector2f translation,
                              float rotation,
                              String name)

Fires off an effect at the with the named configuration.

fireEffect

public EffectLogic fireEffect(int timestamp,
                              Logic target,
                              Vector2f translation,
                              float rotation,
                              String name,
                              String firstKey,
                              Object firstValue,
                              Object... otherArgs)

Fires off an effect with the supplied name and arguments.

fireEffect

public EffectLogic fireEffect(int timestamp,
                              Logic target,
                              Vector2f translation,
                              float rotation,
                              ConfigReference<EffectConfig> ref)

Fires off an effect with the referenced configuration.

createLogic

public Logic createLogic(String cname)

Creates an instance of the logic object with the specified class name using the injector, logging a warning and returning null on error.

getLogic

public Logic getLogic(EntityKey key)

Returns the logic object for the entity with the provided key, if any.

getEntryLogic

public EntryLogic getEntryLogic(Object key)

Returns the logic object for the entry with the provided key, if any.

getActorLogic

public ActorLogic getActorLogic(int id)

Returns the logic object for the actor with the provided id, if any.

getVisibleActors

public void getVisibleActors(PawnLogic target,
                             Rect bounds,
                             Collection<ActorLogic> results)

Populates the supplied collection with references to all non-static actors visible to the specified target whose influence regions intersect the provided bounds.

getStaticActors

public Set<ActorLogic> getStaticActors()

Returns a reference to the set of static actors.

getStaticActorsAdded

public Set<ActorLogic> getStaticActorsAdded()

Returns a reference to the set of static actors added on the current tick.

getStaticActorsUpdated

public Set<ActorLogic> getStaticActorsUpdated()

Returns a reference to the set of static actors updated on the current tick.

getStaticActorsRemoved

public Set<ActorLogic> getStaticActorsRemoved()

Returns a reference to the set of static actors removed on the current tick.

getEffectsFired

public Effect[] getEffectsFired(PawnLogic target,
                                Rect bounds)

Returns an array containing all effects fired on the current tick whose influence regions intersect the provided bounds.

getTarget

public PawnLogic getTarget(com.threerings.presents.data.ClientObject clobj)

Returns a reference to the target of the specified client, if any.

removeActorLogic

public void removeActorLogic(int id)

Removes the logic mapping for the actor with the given id.

triggerIntersectionSensors

public int triggerIntersectionSensors(int timestamp,
                                      ActorLogic actor)

Triggers any intersection sensors intersecting the specified shape.

triggerSensors

public int triggerSensors(Class<? extends TudeySceneManager.Sensor> type,
                          int timestamp,
                          Shape shape,
                          int flags,
                          ActorLogic actor)

Triggers any sensors of the specified type intersecting the specified shape.

triggerSensors

public int triggerSensors(Class<? extends TudeySceneManager.Sensor> type,
                          int timestamp,
                          Collection<Shape> shapes,
                          int flags,
                          ActorLogic actor)

Triggers any sensors of the specified type intersecting the specified shape.

collides

public boolean collides(ActorLogic logic)

Determines whether the specified actor collides with anything in the environment.

collides

public boolean collides(ActorLogic logic,
                        Shape shape)

Determines whether the specified actor collides with anything in the environment.

collides

public boolean collides(ActorLogic logic,
                        Shape shape,
                        int timestamp)

Determines whether the specified actor collides with anything in the environment.

collides

public boolean collides(Actor actor,
                        Shape shape,
                        int timestamp)

Determines whether the specified actor collides with anything in the environment.

collides

public boolean collides(int mask,
                        Shape shape)

Determines whether the specified shape collides with anything in the environment.

collides

public boolean collides(int mask,
                        Shape shape,
                        int timestamp)

Determines whether the specified shape collides with anything in the environment.

staticActorUpdated

public void staticActorUpdated(ActorLogic logic)

Notes that a static actor's state has changed.

mapEnteringBody

public void mapEnteringBody(com.threerings.crowd.data.BodyObject body,
                            Object portalKey)

Notes that a body will be entering via the identified portal.

clearEnteringBody

public void clearEnteringBody(com.threerings.crowd.data.BodyObject body)

Clears out the mapping for an entering body.

bodyWillEnter

public void bodyWillEnter(com.threerings.crowd.data.BodyObject body)

Overrides:

bodyWillEnter in class com.threerings.crowd.server.PlaceManager

bodyWillLeave

public void bodyWillLeave(com.threerings.crowd.data.BodyObject body)

Overrides:

bodyWillLeave in class com.threerings.crowd.server.PlaceManager

enteredPlace

public void enteredPlace(com.threerings.presents.data.ClientObject caller)

Description copied from interface: TudeySceneProvider

Handles a TudeySceneService.enteredPlace() request.

Specified by:

enteredPlace in interface TudeySceneProvider

enqueueInputReliable

public void enqueueInputReliable(com.threerings.presents.data.ClientObject caller,
                                 int acknowledge,
                                 int smoothedTime,
                                 InputFrame[] frames)

Description copied from interface: TudeySceneProvider

Handles a TudeySceneService.enqueueInputReliable(int, int, com.threerings.tudey.data.InputFrame[]) request.

Specified by:

enqueueInputReliable in interface TudeySceneProvider

enqueueInputUnreliable

public void enqueueInputUnreliable(com.threerings.presents.data.ClientObject caller,
                                   int acknowledge,
                                   int smoothedTime,
                                   InputFrame[] frames)

Description copied from interface: TudeySceneProvider

Handles a TudeySceneService.enqueueInputUnreliable(int, int, com.threerings.tudey.data.InputFrame[]) request.

Specified by:

enqueueInputUnreliable in interface TudeySceneProvider

setTarget

public void setTarget(com.threerings.presents.data.ClientObject caller,
                      int pawnId)

Description copied from interface: TudeySceneProvider

Handles a TudeySceneService.setTarget(int) request.

Specified by:

setTarget in interface TudeySceneProvider

setCameraParams

public void setCameraParams(com.threerings.presents.data.ClientObject caller,
                            CameraConfig config,
                            float aspect)

Description copied from interface: TudeySceneProvider

Handles a TudeySceneService.setCameraParams(com.threerings.tudey.config.CameraConfig, float) request.

Specified by:

setCameraParams in interface TudeySceneProvider

submitActorRequest

public void submitActorRequest(com.threerings.presents.data.ClientObject caller,
                               int actorId,
                               String name)

Description copied from interface: TudeySceneProvider

Handles a TudeySceneService.submitActorRequest(int, java.lang.String) request.

Specified by:

submitActorRequest in interface TudeySceneProvider

submitEntryRequest

public void submitEntryRequest(com.threerings.presents.data.ClientObject caller,
                               Object key,
                               String name)

Description copied from interface: TudeySceneProvider

Handles a TudeySceneService.submitEntryRequest(java.lang.Object, java.lang.String) request.

Specified by:

submitEntryRequest in interface TudeySceneProvider

entryAdded

public void entryAdded(TudeySceneModel.Entry entry)

Description copied from interface: TudeySceneModel.Observer

Notes that an entry has been added to the scene.

Specified by:

entryAdded in interface TudeySceneModel.Observer

entryUpdated

public void entryUpdated(TudeySceneModel.Entry oentry,
                         TudeySceneModel.Entry nentry)

Description copied from interface: TudeySceneModel.Observer

Notes that an entry has been updated within the scene.

Specified by:

entryUpdated in interface TudeySceneModel.Observer

entryRemoved

public void entryRemoved(TudeySceneModel.Entry oentry)

Description copied from interface: TudeySceneModel.Observer

Notes that an entry has been removed from the scene.

Specified by:

entryRemoved in interface TudeySceneModel.Observer

getSceneModel

public TudeySceneModel getSceneModel()

Description copied from interface: ActorAdvancer.Environment

Returns a reference to the scene model.

Specified by:

getSceneModel in interface ActorAdvancer.Environment

getPenetration

public boolean getPenetration(Actor actor,
                              Shape shape,
                              Vector2f result)

Description copied from interface: ActorAdvancer.Environment

Checks whether the actor is colliding with anything and, if it is, populates the provided object with the penetration vector (the minimum translation required to cancel the penetration).

Specified by:

getPenetration in interface ActorAdvancer.Environment

Returns:

true if a collision was detected (in which case the result vector will be populated), false otherwise.

collides

public boolean collides(Actor actor,
                        Shape shape)

Description copied from interface: ActorAdvancer.Environment

Checks whether the actor is colliding with anything.

Specified by:

collides in interface ActorAdvancer.Environment

postRunnable

public void postRunnable(Runnable runnable)

Specified by:

postRunnable in interface RunQueue

isDispatchThread

public boolean isDispatchThread()

Specified by:

isDispatchThread in interface RunQueue

isRunning

public boolean isRunning()

Specified by:

isRunning in interface RunQueue

addMappings

public void addMappings(Logic logic)

Registers the specified logic object unders its mappings.

removeMappings

public void removeMappings(Logic logic)

Remove the specified logic object from the mappings.

tick

public void tick()

Updates the scene.