Grab/DeGrab a Primitive (Long Touch)

31 July 2019

  • C10 - added the selection optional parameter.

28 July 2018

  • C10 - added.
click (Commands)
TypeCorrade progressive command
Commandclick
DescriptionCorrade 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.
Permissionsinteract
Parametersgroup, password, item, texture, surface, normal, binormal, position, face
Last ChangesC10 - 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