Grab/DeGrab a Primitive (Long Touch)

31 July 2019

C10 - added the selection optional parameter.

28 July 2018

C10 - added.

click (Commands)
Type	Corrade progressive command
Command	`click`
Description	Corrade can be made to grab a primitive in a given range touching the object using precise parameters. The command will perform a quick grab / degrab typical of a short click on a primitive in Second Life.
Permissions	`interact`
Parameters	`group`, `password`, `item`, `texture`, `surface`, `normal`, `binormal`, `position`, `face`
Last Changes	C10 - added.

Corrade can be made to grab a primitive in a given range touching the object using precise parameter. Note that Corrade does not mind whether the primitive is in a link-set or an attachment. It will touch any primitive regardless of where it is.

Command Required Parameters Required Corrade Permissions Example

click

group, password, item

interact

llInstantMessage(CORRADE,
    wasKeyValueEncode(
        [
            "command", "click",
            "group", wasURLEscape(GROUP),
            "password", wasURLEscape(PASSWORD),
            // a primitive name or uuid
            "item", "helmet",
            // 5 meters
            "range", "5",
            "texture", wasURLEscape("<0.5, 0.2, 0.6>"),
            "surface", wasURLEscape("<0.1, 0.2, 0.5>"),
            "normal", wasURLEscape("<0.7, 0.3, 0.1>"),
            "binormal", wasURLEscape("<0.2, 0.1, 0.1>"),
            "position", wasURLEscape("<53, 154, 2689>"),
            // touch the second face
            "face", "2"
        ]
    )
);

item can be the name of an object or the UUID of an object.

Optional Parameter	Possible Value	Description
`range`	A range in meters.	The spherical distance from Corrade in which to locate the item.
`texture`	An LSL Vector3	The texture coordinates to touch.
`surface`	An LSL Vector3	The surface coordinates to touch.
`face`	An integer	The index of the face to touch.
`position`	An LSL Vector3	The region coordinates of the position to touch.
`normal`	An LSL Vector3	The surface normal of the position to touch.
`binormal`	An LSL Vector3	The surface binomial of the position to touch.
`selection`	`attached`, `rezzed` or `all` (default: `all`)	Either `attached`, `rezzed` or `all` for selecting only primitives or objects attached to avatars, primitives or objects rezzed in-world or all primitives or objects respectively.

Notes

Contrary to the grab command, the click command will perform a quick grab followed by a degrab action typical of an Second Life touch on a primitive.
If you would like to click a child primitive in a linkset, then simply supply the name or UUID (UUID preferred for speed) to the item parameter. The getobjectlink command can provide a list of primitive names by UUIDs.
If you would like to grab and drag a primitive then please refer to the grab command.
If you would like to just touch a primitive then please refer to the touch command.