M-File Help: VREP | View code for VREP |
V-REP simulator communications object
A VREP object holds all information related to the state of a connection. References are passed to other objects which mirror the V-REP environment in MATLAB.
This class handles the interface to the simulator and low-level object handle operations.
Methods throw exception if an error occurs.
gethandle | get handle to named object |
getchildren | get children belonging to handle |
object | return a VREP_obj object for named object |
arm | return a VREP_arm object for named robot |
camera | return a VREP_camera object for named vosion sensor |
hokuyo | return a VREP_hokuyo object for named Hokuyo scanner |
getpos | return position of object given handle |
setpos | set position of object given handle |
getorient | return orientation of object given handle |
setorient | set orientation of object given handle |
getpose | return pose of object given handle |
setpose | set pose of object given handle |
setobjparam_bool | set object boolean parameter |
setobjparam_int | set object integer parameter |
setobjparam_float | set object float parameter |
getobjparam_bool | get object boolean parameter |
getobjparam_int | get object integer parameter |
getobjparam_float | get object float parameter |
signal_int | send named integer signal |
signal_float | send named float signal |
signal_str | send named string signal |
setparam_bool | set object boolean parameter |
setparam_int | set object integer parameter |
setparam_float | set object float parameter |
delete | shutdown the connection and cleanup |
startsim | start the simulator running |
stopsim | stop the simulator running |
pausesim | pause the simulator |
getversion | get V-REP version number |
checkcomms | return status of connection |
pausecomms | pause the comms |
display | print the link parameters in human readable form |
char | convert to string |
VREP_obj, VREP_arm, VREP_camera, VREP_hokuyo
VREP object constructor
v = VREP(options) create a connection to the V-REP simulator.
v = VREP(path, options) as above but specify the root directory of V-REP.
'version', V | Version of V-REP, V=304, 311 etc |
'timeout', T | Timeout T in ms (default 2000) |
'cycle', C | Cycle time C in ms (default 5) |
'port', P | Override communications port |
'reconnect' | Reconnect on error (default noreconnect) |
Return VREP_arm object
V.arm(name) is a factory method that returns a VREP_arm object for the V-REP robot object named NAME.
Return VREP_camera object
V.camera(name) is a factory method that returns a VREP_camera object for the V-REP vision sensor object named NAME.
Check communications to V-REP simulator
V.checkcomms() is true if a valid connection to the V-REP simulator exists.
VREP object destructor
delete(v) closes the connection to the V-REP simulator
Return children of object
C = V.getchildren(H) is a vector of integer handles for the V-REP object denoted by the integer handle H.
Return handle to VREP object
H = V.gethandle(name) is an integer handle for named V-REP object.
H = V.gethandle(fmt, arglist) as above but the name is formed from sprintf(fmt, arglist).
Get value of V-REP joint object
V.getjoint(H, q) is the position of joint object with integer handle H.
get boolean parameter of a V-REP object
V.getobjparam_bool(H, param) gets the boolean parameter with identifier param of object with integer handle H.
get float parameter of a V-REP object
V.getobjparam_bool(H, param) gets the float parameter with identifier param of object with integer handle H.
get Integer parameter of a V-REP object
V.getobjparam_int(H, param) gets the integer parameter with identifier param of object with integer handle H.
Get orientation of V-REP object
V.getorient(H) is the orientation as a rotation matrix (3x3) of the V-REP object with integer handle H.
V.getorient(H, 'euler', OPTIONS) as above but returns ZYZ Euler angles.
V.getorient(H, hrr) as above but orientation is relative to the position of object with integer handle HR.
V.getorient(H, hrr, 'euler', OPTIONS) as above but returns ZYZ Euler angles.
See tr2eul.
Get position of V-REP object
V.getpos(H) is the position (1x3) of the V-REP object with integer handle H.
V.getpos(H, hr) as above but position is relative to the position of object with integer handle hr.
Get pose of V-REP object
V.getpose(H) is the pose (4x4) of the V-REP object with integer handle H.
V.getpose(H, hr) as above but pose is relative to the pose of object with integer handle R.
Get version of the V-REP simulator
V.getversion() is the version of the V-REP simulator server as an integer MNNNN where M is the major version number and NNNN is the minor version number.
Return VREP_hokuyo object
V.hokuyo(name) is a factory method that returns a VREP_hokuyo object for the V-REP Hokuyo laser scanner object named NAME.
Return VREP_mobile object
V.mobile(name) is a factory method that returns a VREP_mobile object for the V-REP mobile base object named NAME.
Return VREP_obj object
V.objet(name) is a factory method that returns a VREP_obj object for the V-REP object named NAME.
Pause communcations to the V-REP simulator
V.pausecomms(p) pauses communications to the V-REP simulation engine if p is true else resumes it. Useful to ensure an atomic update of simulator state.
Set value of V-REP joint object
V.setjoint(H, q) sets the position of joint object with integer handle H to the value q.
Set target value of V-REP joint object
V.setjointtarget(H, q) sets the target position of joint object with integer handle H to the value q.
Set velocity of V-REP joint object
V.setjointvel(H, qd) sets the target velocity of joint object with integer handle H to the value qd.
Set boolean parameter of a V-REP object
V.setobjparam_bool(H, param, val) sets the boolean parameter with identifier param of object H to value val.
Set float parameter of a V-REP object
V.setobjparam_bool(H, param, val) sets the float parameter with identifier param of object H to value val.
Set Integer parameter of a V-REP object
V.setobjparam_int(H, param, val) sets the integer parameter with identifier param of object H to value val.
Set orientation of V-REP object
V.setorient(H, R) sets the orientation of V-REP object with integer handle H to that given by rotation matrix R (3x3).
V.setorient(H, T) sets the orientation of V-REP object with integer handle H to rotational component of homogeneous transformation matrix T (4x4).
V.setorient(H, E) sets the orientation of V-REP object with integer handle H to ZYZ Euler angles (1x3).
V.setorient(H, x, hr) as above but orientation is set relative to the orientation of object with integer handle hr.
Set boolean parameter of the V-REP simulator
V.setparam_bool(name, val) sets the boolean parameter with name name to value val within the V-REP simulation engine.
Set float parameter of the V-REP simulator
V.setparam_float(name, val) sets the float parameter with name name to value val within the V-REP simulation engine.
Set intger parameter of the V-REP simulator
V.setparam_int(name, val) sets the integer parameter with name name to value val within the V-REP simulation engine.
Set position of V-REP object
V.setpos(H, T) sets the position of V-REP object with integer handle H to T (1x3).
V.setpos(H, T, hr) as above but position is set relative to the position of object with integer handle hr.
Set pose of V-REP object
V.setpos(H, T) sets the pose of V-REP object with integer handle H according to homogeneous transform T (4x4).
V.setpos(H, T, hr) as above but pose is set relative to the pose of object with integer handle hr.
Send a float signal to the V-REP simulator
V.signal_float(name, val) send a float signal with name name and value val to the V-REP simulation engine.
Send an integer signal to the V-REP simulator
V.signal_int(name, val) send an integer signal with name name and value val to the V-REP simulation engine.
Send a string signal to the V-REP simulator
V.signal_str(name, val) send a string signal with name name and value val to the V-REP simulation engine.
Pause V-REP simulation
V.simpause() pauses the V-REP simulation engine. Use V.simstart() to resume the simulation.
Start V-REP simulation
V.simstart() starts the V-REP simulation engine.
Stop V-REP simulation
V.simstop() stops the V-REP simulation engine.
Return VREP_youbot object
V.youbot(name) is a factory method that returns a VREP_youbot object for the V-REP YouBot object named NAME.
© 1990-2014 Peter Corke.