Rover Client-Side C Interface

The following C calls are available to Rover client applications:
HTRoverClientInit // HTRoverClientMainLoop

We explain the following internal procedures in the Rover client library in order to help the application programmer understand the behavior of the library. These calls are NOT meant to be called directly by client applications.
RoverFinishTclInit // RoverAppInit

PUBLIC int HTRoverClientInit(TCLtype *type int argc, char **argv)

Initializes the whole Rover client application world.

Returns an integer application identifier


Rover_FinishTclInit is NOT an available call into the library. We provide this explanation so the application programmer understands what happens as a result of HTRoverClientInit

Some time after a HTRoverClientInit is called, the server will respond with the specified RDO. When the RDO is received in the application from the access manager, the following steps occur:

PUBLIC HTAppInitializer RoverAppInit

Performs application-specific initilizataion. RoverAppInit is a global variable in the Rover library. If it is assigned to a procedure of type HTAppInitializer that procedure will be called after globalTclInterp and mainWindow have been created and initialized but before the initial Tcl/tk object (argv[0] to HTRoverClientInit) has been loaded into or invoked from globalTclInterp. This is the place to add application-specific Tcl commands to the interpreter.

PUBLIC int HTRoverClientMainLoop()

Runs the whole Rover world. The main loop handles all events in the system both from Tk and nonblocking communication with the access manager.

Returns only when program ends.

Last updated by $Author: adj $ on $Date: 1997/12/01 23:41:19 $.
Copyright © 1995-1998 Anthony D. Joseph and Massachusetts Institute of Technology