Regular API function

simCheckVisionSensorEx / sim.checkVisionSensorEx

Description Checks whether the vision sensor detects the indicated entity. This is the extended functionality version of sim.checkVisionSensor. Detection is silent (no visual feedback) compared to sim.handleVisionSensor. The vision callback functions will be called on the acquired image. Also, the visibility state of the entity is overridden if the entity is an object. See also sim.readVisionSensor.
C/C++
synopsis
simFloat* simCheckVisionSensorEx(simInt sensorHandle,simInt entityHandle,simBool returnImage)
C/C++
parameters
sensorHandle: handle of the vision sensor object
entityHandle: handle of entity to detect (object or collection), or sim.handle_all to detect all detectable objects
returnImage: specifies what should be returned. If true, the sensor's image buffer is returned, otherwise its depth buffer is returned
C/C++
return value
image or depth buffer, or nullptr in case of an error. The user is in charge of releasing the returned buffer with simReleaseBuffer
Lua
synopsis
float[] buff=sim.checkVisionSensorEx(int sensorHandle,int entityHandle,bool returnImage)
buffer buff=sim.checkVisionSensorEx(int sensorHandle,int entityHandle,bool returnImage)
Lua
parameters
sensorHandle: handle of the vision sensor object. Can be combined with sim.handleflag_codedstring if you wish to retrieve the image or depth map coded in a string (much faster).
entityHandle: Similar to the C-function counterpart
returnImage: Similar to the C-function counterpart
Lua
return values
Similar to the C-function counterpart: a table containing the image or depth buffer is returned
Python
synopsis
list buff=sim.checkVisionSensorEx(int sensorHandle,int entityHandle,bool returnImage)
bytes buff=sim.checkVisionSensorEx(int sensorHandle,int entityHandle,bool returnImage)