Regular API function

simRemoveObjectFromSelection / sim.removeObjectFromSelection

Description Removes an object from the selection. See also sim.addObjectToSelection, sim.isObjectInSelection and sim.getObjectSelection.
C synopsis simInt simRemoveObjectFromSelection(simInt what,simInt objectHandle)
C parameters
What: indicates what we wish to remove from the selection. Valid values are sim_handle_single (removes one object from the selection), sim_handle_all (removes all objects from the selection), sim_handle_tree (removes the tree with base objectHandle (inclusive) from the selection, sim_handle_chain (removes the chain with tip objectHandle (inclusive) from the selection.
objectHandle: handle of the object to remove from the selection. If sim_handle_all is specifies in "what", then objectHandle is ignored
C return value
-1 if operation was not successful
Lua synopsis
(1) sim.removeObjectFromSelection(int what,int objectHandle)
(2) sim.removeObjectFromSelection(table[] objectHandles)
Lua parameters
(1) Similar to the C-function counterpart. The second argument can be omitted if "what" is sim.handle_all
(2) objectHandles: table containing the handles of objects to remove. Can be nil, in which case nothing happens
Lua return values
Remote API equiv.
B0-based remote API: simxSetObjectSelection
Legacy remote API: simxSetObjectSelection