Description
|
Groups (or merges) several shapes into a compound shape (or simple shape). See also sim.ungroupShape.
|
C/C++ synopsis
|
simInt simGroupShapes(const simInt* shapeHandles,simInt shapeCount)
|
C/C++ parameters |
shapeHandles: the handles of the shapes to be grouped or merged. The last handle represents the shape that will accept the other shapes.
shapeCount: the size of the shapeHandles array. A negative number indicates that we want to merge the shapes instead of grouping them.
|
C/C++ return value
|
-1 if operation was not successful. Otherwise the handle of the resulting compound shape, which is the last shape in shapeHandles.
|
Lua synopsis
|
int shapeHandle=sim.groupShapes(int[] shapeHandles, bool merge=false)
|
Lua parameters |
shapeHandles: the handles of the shapes to be grouped or merged. The last handle represents the shape that will accept the other shapes.
merge: whether the shapes should be merged or grouped
|
Lua return values
|
Similar to the C-function counterpart |
Python synopsis |
int shapeHandle=sim.groupShapes(list shapeHandles,bool merge=False) |