Creates new robot object.

Always call this function before using other functions. The returned number is a handle to a newly created robot object. Always pass it to all other functions in the first (id) argument. When you are finished using the robot object, call the function robot_done(). This function does not open port yet, it only creates the robot object. You can control multiple robots: each robot should have its own object. Multiple users can be connected to the same remote robot at the same time. Unless one of them enters exclusive mode, they can all send commands to the robot (this can, however, in this version result in unpredictable results if they send conflicting commands). Use robot_exclusive to acquire exclusive access to remote robot (other users will only be able to obtain status information and query sensors and battery voltage).

Source:

robotdll/robotdll.h:86

Author:

Version:

latest version

Param:

msg_on

you can set this parameter to 1, if you do not mind error messageboxes popping up when needed (applies to windows version only), otherwise set the parameter to 0

Returns:

retuns an identifier (handle) of a newly created robot object

See Also:

robot_connect, robot_done, robot_exclusive

Code:

public ROBOTDLL_API short robot_init (

short msg_on )