Modulestructure

Class modifications

Options

In order to make it possible to run the gserver more than once the port number has to be added to the options of both the gserver and the gclient. The new property has the name ´portNum´ and is of type integer. If no port is specified the number '33334' is used as the default port number.

GeometryClient

The private property sceneRoot of type SoSeperator has to be introduced to distinguish the represented secondary world from the primary world. The method getSceneRoot with the parameter WorldID of type NetID returns the according sceneRoot of the property 'csam' (current seam actormanager). The list 'csam' contains all seams of the AOI (Area Of Interest). If getSceneRoot is called with WorldID=0 then the sceneRoot of the GeometryClient is returned. The method 'setSceneRoot' sets the private property 'sceneRoot'. ProcTransmitActor has to be modified, so that the worldID of the packet will be sent along accordingly. Actors are identified by their actorId as well as their worldId. The method getActor helps to find an actor with its actorId and worldId.

The method doRoam checks if the client is moving through a seam and should therefore be roamed into the secondary world.

The methods serviceNewIncDownload, serviceIncNotify and serviceDownloadCompleted which access the packet directly and do not use the defined structure of the packet have to be changed to use the structure with the worldId properly.

The methods setPos and setHeading are amplified with a boolean parameter. If it is set to FALSE the methods behave as before. But if the method is set to TRUE, Win3D-functions are called to set the position and the heading of the camera.

GeometryServer

The method procRequestGeometry has to be enhanced to be able to deal with the seam object.
The method actorMoved has to be changed for seam objects that enter or leave the area of interest.
The method loadDB which parses the .rrd file with the world information has to be adjusted to deal with the new actortypes.

Actor

The property 'WorldID' of type NetID contains the ID of the SeamActor Object if it is an object from a secondary world, otherwise 0 if it is an object from the primary world.

VisualActor

All the VisualActor classes, id est VisualActor, GeometryActor and SlodActor have to be modified in respect of the worldID. (Initialising and calling of the Win3D functions)

ServerActor

ServerSeamDestActor, ServerClientActor, ServerSeamActor are derived from ServerActor.

ServerDestActor is the object which describes the seam destination position and heading.

ServerClientActor is the ServerActor for a client. It is enhanced with destActor of type *ServerSeamDestActor. If destActor is NULL then it is a client, otherwise it is a seam and destActor points to the ServerSeamDestActor of the seam.

ServerSeamActor is the special ServerActor for seams with methods for network communication with the gserver of the secodary world.

netID

In order to compare types of netID with int, it is necessary to add an constructor.

Function modifications

gsmain

The main function has to take the port-parameter from the option class into consideration.
 

gcmain

The seamkit classes need to be initialized in gcmain.

gcruntime

In the function startCB the geometryclient method checkRoaming has to be used to check for roaming.

win3D

The functions geoAddGeometryActor, geoAddSlodActor and geoRemoveActor have to use the sceneRoot parameter.
A new function calcMinMax calculates a 2D bounding box, in which roaming will be considered possible.
The function geoAddSeamActorLod inserts a seamkit object with the specified parameter into the scene.
The new function AddSeamSceneRoot is used to set secondary world of the seam. This is done in an own function because the objects and geometries of the secondary world are received after the seam geometry.
AddSeamDirection sets the direction and position of the seam in the secondary world. This function is used when the seam is moving.
The function setCamDirection is used to set the client heading position after roaming took place.

Network packets modifications

UpdateClientPos

The float headingV describes the vertical viewing direction. This packet is additionally used to transmit the position of a seam.

KillActor, ActorPos, TransmitActor,TransmitActor, TransmitActor,RequestSlod, RequestGeometry, UpdateClientPos

In all these packets the worldId of type NetID has to be added because an actor needs to be identified by its actorId as well as its worldId.

RequestGeometry,RequestSlod,TransmitGeometry,TransmitSlod

In all these packets the field origin of type NetID has to be added because the seam-object needs to know to which client it should forward the packets to.