Link and Unlink Primitives

11 September 2016

  • Release 9.122 - added the optional restructure parameter that can make Corrade unlink already linked primitives in order to reconstruct a new object out of the supplied primitives; a complete revamp of the command in order to prevent the command from timing out in various situations.

6 August 2015

  • Release 8.30 - added.
changeprimitivelink (Commands)
TypeCorrade progressive command
Commandchangeprimitivelink
DescriptionThe changeprimitivelink command can make Corrade link and unlink primitives, respectively objects.
Permissionsinteract
Parametersgroup, password, item
Last ChangesRelease 9.122 - added the optional restructure parameter that can make Corrade unlink already linked primitives in order to reconstruct a new object out of the supplied primitives; a complete revamp of the command in order to prevent the command from timing out in various situations.

The changeprimitivelink command can make Corrade link and unlink primitives, respectively objects.

Command Required Parameters Required Corrade Permissions Example
changeprimitivelink group, password, item interact 
llInstantMessage(CORRADE, wasKeyValueEncode(
    [
        "command", "changeprimitivelink",
        "group", wasURLEscape(GROUP),
        "password", wasURLEscape(PASSWORD),
        "range", 4,
        "action", "link",
        "item", wasURLEscape(
            wasListToCSV(
                [
                    "eabeef26-60f2-9eca-b7a4-0bea996aaa04", // root
                    "7b1947d5-4d10-9e3f-f5a6-6df60db0d9dd"
                ]
            )
        ),
        "callback", wasURLEscape(URL)
    ])
);
Optional Parameter Possible Value Description
range A range in meters. The spherical distance from Corrade in which to locate the item.
restructure True or False (default) When set to True, Corrade will unlink all the primitives supplied to the item parameter and then form a new object consisting only of the supplied primitives.
Parameter Possible Value Second Parameter Possible Value Description
action link item A list containing two or more primitive names or UUIDs. Link two or more primitives together.
delink item A list of one or more primitive names or UUIDs. Unlink one or more primitives.

The item parameter takes as value a list of primitives where the first item in the list is the root primitive in case of linking primitives together. It is possible to link a primitive to an object by supplying the name or key of the root and then the name or key of the primitive to link.

Notes