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.

Initializes connections to access manager

Initializes "tcl/tk" session

Imports init.tcl on the "tcl/tk" session with RoverFinishTclInit as callback.
Imports the client application.specified by argv[0] with standard QRPC callback. This callback will block until RoverFinishTclInit has been completed. The name of the Tcl procedure/command that will be used as the callback is the same as the URL of the imported RDO.

type is value from the TCLtype enumeration.
argc is the integer size of the argv array
argv is a null-terminated array of string arguments. argv[0] is a URL which names the application RDO to be imported. This is also the name of the Tcl procedure/command to called to start the application running.

Returns an integer application identifier

HTRoverFinishTclInit

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:

Initializes globalTclInterp with a newly created a Tcl interpreter, as long as globalTclInterp is null (done in FinishTclInit).
Initializes mainWindow with a newly created tk main window, as long as a tk application was specified and mainWindow is null (done in FinishTkInit).
Initializes Rover global Tcl variables (done in FinishTclInit).
Adds client Tcl interface to the Tcl interpreter (done in FinishTclInit).
Initializes the Tcl interpreter with the Rover init.tcl (done in FinishTclInit).
Increments ClientInit final time.
Calls RoverAppInit,as long as it's not null (done in FinishTclInit if no Tk application is specified, otherwise done in FinishTkInit).

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

Rover Client-Side C Interface

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

HTRoverFinishTclInit

PUBLIC HTAppInitializer RoverAppInit

PUBLIC int HTRoverClientMainLoop()

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