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)
Type	Corrade progressive command
Command	`changeprimitivelink`
Description	The `changeprimitivelink` command can make Corrade link and unlink primitives, respectively objects.
Permissions	`interact`
Parameters	`group`, `password`, `item`
Last Changes	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.

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.
`action`	`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

This command is radar-bound.