12. LinkSync add-on


LinkSync is an add-on that is available separately from Beadrez, and bundled with the HUD.
It is a script that replaces the LinkEnhancer script inside beads.

LinkSync lets any Beadrez-rezzed bead be a master/control prim for all rezzed copies of that bead. It is used after rezzing but before linking. Example uses: Switch sculpt maps after rezzing to find the best one without extra bead prepping; Adjust length and rotation of skirt panels; Correct for position or rotation errors made during teachpad process; give your beads warmer fuzzier names.

The following bead properties can be synced separately or all at once: Type (for example, sculpt map or shape), texture (with color, glow, etc), and Size+position+rotation (SPR). SPR is aware of Beadrez's scalebeads effects, twistmenu rotations, and teachpad-based anchor points (via a button called Repose). Linksync can also be used to rename beads in groups (a group being all rezzed copies of the same bead). It works with both single- and multi-prim beads.

TO USE:
Inside beads, replace the regular LinkEnhancer with the "Xoph Enhancer with LinkSync" script, and then rezzed beads will give menus for selecting which properties get synched. Changes will be applied to other beads of the same type, but not to beads of different type (same type means they are all rezzed copies of the same bead from inside Beadrez). Menu commands are explained shortly.

LIMITATIONS and TROUBLESHOOTING:
1) You must use full-perm beads for all features to work.
2) Sliced prims and mesh prims can only be synced partially: they can NOT sync shape changes, but they can still sync texture, name, size, and position/rotation changes. Note the video demo includes a sliced-prim nano (small blue gem near the middle of the video). Prims that can only be made through scripted torture or 3rd-party viewers also may not allow shape sync. Do NOT use PRIMTYPE or ALL commands for sliced prims.
3) If you change position or rotation of the bead, you may need to click REPOSE to "fix" the anchor point and then click an SPR command to sync (unless you intended to change the anchoring).
4) If not all properties are syncing, you probably need to give an additional command. For example, PRIMTYPE syncing updates shapes but does not adjust child prim position, so it should be followed by SPR sync.
5) Only beads of the same type as the one you click are synced -- other beads are NOT affected. "Same type" means they are copies of the same bead installed in Beadrez. So, you can think of beads as grouped by type.

Video demo:


LinkSync's MENU COMMANDS (click rezzed bead for menu):

REPOSE: after you scale or rotate an off-center bead, click this to snap it into the position that restores the original attachment point (for example, for scaling skirt panels). After this, you usually would also click an SPR command.

PRIMTYPE: transfers the properties from Edit's Object tab like type, sculpt map, hollow, twist, taper, etc. For multi-prim beads, this updates all prims. WARNING: Slice is not supported. Do not click PRIMTYPE or ALL commands for sliced prims.

TEXTURE: transfers color, texture settings, glow, shiny, etc. for every face of every prim in the bead.

RENAME: transfers the current prim's object name to all other copies of the bead (use to rename groups of beads).

SPR_abs: "Size, Position, Rotation" - copies size, position, and rotation changes, including for child prims. This version makes absolute size changes, meaning all affected beads get the same size regardless of beadrez-applied scale. Changes apply in local axes, which means they act like changes from the Teachpad process.

SPR_rel: "relative" version of SPR. This one maintains relative bead scaling from Beadrez (for example, for graduated necklaces). Limitation: For some multi-prim beads, there could be ways to scale that don't transfer exactly, but you will usually not encounter them.

ALL_abs: single command combines PRIMTYPE, TEXTURE, and SPR_abs

ALL_rel: single command combines PRIMTYPE, TEXTURE, and SPR_rel