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

  • 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.

secondlife/scripted_agents/corrade/api/commands/click.txt ยท Last modified: 2021/05/13 10:02 (external edit)

Access website using Tor Access website using i2p Wizardry and Steamworks PGP Key


For the copyright, license, warranty and privacy terms for the usage of this website please see the license, privacy, copyright and the plagiarism pages.