Assigns or removes a sprite from a particular category. There are 16 categories that a sprite can belong to, and a sprite can belong to any number at once. This command is similar to SetSpriteCategoryBits except this command sets one category at a time whilst that command sets them all at once using a bit mask.

By default this sets all shapes to the same value, you can set this value on a per shape basis by specifying a shapeID value greater than 0. Shape IDs start at 1 for the first shape, with shapeID 0 meaning apply it to all shapes.


SetSpriteCategoryBit( iSpriteIndex, category, flag )

SetSpriteCategoryBit( iSpriteIndex, category, flag, shapeID )