A TravelConnector is an object that can be attached to the directional exit property of a room to facilitate (or optionally block) travel in the associated direction and carry out any side-effects of that travel. A TravelConnector may be used as an abstract object to implement travel, or a subclass of TravelConnector such as Door, Passage, StairwayUp or StairwayDown may be used to represent a physical object via which travel occurs. The Room class also inherits from TravelConnector.
Whether the base TravelConnector class or one of its subclasses is used, travel is carried out via a TravelConnector by calling its travelVia() method.
class
TravelConnector : object
Superclass Tree (in declaration order)
TravelConnector
object
Subclass Tree
TravelConnector
Door
SecretDoor
Passage
PathPassage
Room
StairwayDown
StairwayUp
UnlistedProxyConnector
Global Objects
(none)
Summary of Properties
destination
isConnectorApparent
isConnectorListed
isOpen
transmitsLight
travelBarriers
Summary of Methods
afterTravelNotifications
beforeTravelNotifications
canTravelerPass
checkTravelBarriers
execTravel
explainTravelBarrier
getDepartingDirection
getDestination
getTraveler
isConnectorVisible
isDestinationKnown
noteTraversal
sayActorFollowing
sayDeparting
sayNoDestination
travelDesc
travelVia
traversalMsg
Properties
The room to which this TravelConnector leads when it is traversed
Is this connector apparent? That is, would it be apparent to an observer under normal lighting conditions, as opposed to being concealed? By default we'll suppose a TravelConnector is apparent unless it's explicitly hidden.
Should this exit be shown in the exit lister? By default we'll assumed it should be it it's visible.
A travel connector is usually open.
Does light pass through this TravelConnector from its destination (so that it's visible in the dark even its location is dark.).
an additional TravelBarrier or a list of TravelBarriers to check on this TravelConnector to see if travel is allowed.
Methods
Carry out the after travel notifications for this actor
Carry out the before travel notifications for this actor.
Method that should return true is actor is allowed to pass through this TravelConnector and nil otherwise. We allow travel by default but this could be overridden to block travel under certain conditions.
Check all the travel barriers associated with this connector to determine whether the traveler is allowed to pass through this travel connector.
Execute the travel for this actor via this connector
If canTravelerPass returns nil explainTravelBarrier should display a message explaining why travel has been prohibited.
Get the direction traveler needs to go in to traverse this connector from traveler's current location.
The room to which this TravelConnector leads when it is traversed from origin.
Get the traveler associated with this actor. Normally the traveler will be the same as the actor, but if the actor is in a vehicle, then the traveler will be the vehicle.
A TravelConnector (or at least, the exit it represents) is visible if it's apparent (i.e. not concealed in some way) and if the lighting conditions are adequate, or if it's visible in the dark.
Does the player char know where this travel connector leads? By default s/he doesn't until s/he's visited its destination, but this could be overridden for an area the PC is supposed to know well when the game starts, such as their own house.
If the actor doing the traveling is the player character, display the travelDesc. Note that although this might normally be a simple description of the travel, the travelDesc method could also be used to carry out any other side-effects of the travel via this connector.
Display a message to say that follower is following leader in the direction of this connector.
Display a message to say that an actor is departing via this connector. On the base class the default behaviour is to describe the departure via a compass direction. The actor in question would normally be an NPC visible to the player character.
Display a message saying that this travel connector doesn't actually lead anywhere; this may be needed if our destination is nil and our noteTraversal() method doesn't display anything.
Carry out any side effects of travel if the traveler is the player character. Typically we might just display some text describing the travel here, but this method could be used for any side-effects of the travel. If the TravelConnector is mixed in with an EventList class then the default behaviour is to call the doScript() method here to drive the EventList.
Carrier out travel via this connector, first checking that travel through this connector is permitted for this actor.
Create a phrase describing the direction of travel through this connector (e.g. 'to the north')
Adv3Lite Library Reference Manual
Generated on 28/03/2016 from adv3Lite version 1.5