Regular API function

simAddDrawingObjectItem / sim.addDrawingObjectItem

Description Adds an item (or clears all items) to a previously inserted drawing object. See also sim.addDrawingObject and sim.removeDrawingObject
C/C++
synopsis
simInt simAddDrawingObjectItem(simInt objectHandle,const simFloat* itemData)
C/C++
parameters
objectHandle: handle of a previously added drawing object
itemData: data relative to an item. If the item is a point item, 3 values are required (x;y;z). If the item is a line item, 6 values are required, etc. Additional attribute values (e.g. individual colors, quaternions, etc.) should be appended.
C/C++
return value
-1 if operation was not successful. If the point was added, then the return value is >0, if it was not added (e.g. drawing object is saturated or the item was merged with an existing item), then the return value will be 0.
Lua
synopsis
int result=sim.addDrawingObjectItem(int drawingObjectHandle,float[] itemData)
Lua
parameters
Similar to the C-function counterpart. Additionally, objectHandle can be combined with sim.handleflag_setmultiple to clear and set several drawing items at once.
Lua
return values
Similar to the C-function counterpart
Python
synopsis
int result=sim.addDrawingObjectItem(int drawingObjectHandle,list itemData)