{"id":3774,"date":"2021-08-14T05:11:57","date_gmt":"2021-08-14T11:11:57","guid":{"rendered":"http:\/\/artistedancediva.co.uk\/wp\/?p=3774"},"modified":"2021-08-14T05:11:57","modified_gmt":"2021-08-14T11:11:57","slug":"adorning-attach-detach-replace","status":"publish","type":"post","link":"https:\/\/artistedancediva.co.uk\/wp\/?p=3774","title":{"rendered":"ADORNING (Attach, Detach, Replace)"},"content":{"rendered":"

This topic is so important and so pervasive across all the key Artiste Suite of tools that it deserves its own post.\u00a0 BK08 – The Artiste – Book – Adorning v1.0\u00a0<\/strong> has outdated<\/strong> and incomplete<\/strong> information as well as some errors<\/strong> in command syntax.\u00a0This post will solve a whole host of issues.<\/p>\n

Adorn<\/strong> <\/span>is a term we chose to encapsulate adding, removing<\/strong>, and replacing<\/strong> items to an avatar. It was created as a way to strip items of clothing from an avatar while performing in a strip show. It has since evolved into so much more.<\/p>\n

NOTE<\/span><\/strong>: ADORN<\/span> <\/strong>is often a term referring to items in inventory to be added, removed, or replaced, or auto-swapped while ATTACH,DETACH<\/span><\/strong> is often restricted to defining objects IN-WORLD that will be attached\/detached to an avatar.<\/p>\n

When we wear clothes in SL we are provide with a host of many places to connect the clothes to our avatar.\u00a0 These are called attach-points<\/strong><\/span>.\u00a0 Each one is represented by a unique number.\u00a0 We can have more than 1 item of clothing attached to the same attach-point.<\/p>\n

We have the choice to WEAR<\/span><\/strong> or ADD<\/span> <\/strong>a given item of clothing.\u00a0 There are default attach points assigned by the creator of the clothing.\u00a0 We can override these attach-points at the time we wear or add the item.<\/p>\n

WEARING<\/span> <\/span><\/strong>an item replaces (removes all existing) items on that given attach-point and adds our new item of clothing.<\/p>\n

ADDING <\/strong><\/span>an item adds the new item of clothing to all existing items attached to that given attach-point WITHOUT<\/strong> disturbing any existing worn items for that attach-point.<\/p>\n

Clicking on a worn item and selecting DETACH<\/span> <\/strong>will remove that item without disturbing other items on that given attach-point.<\/p>\n

\n

So what the suite of Artiste Tools does is replicate these main functions so you can recreate them at show time at given points along a timeline by issuing commands that either Add, Replace, or Detach one or more items to or from a supplied or assumed attach-point.<\/p>\n

We ATTACH and DETACH items to an AVATAR.
\nWe LINK and DELINK items to an ANIMESH<\/p>\n

We will focus our attention on avatars<\/strong> for now.<\/p>\n

\n

Items that can be attached to an avatar can live in 2 places prior to being attached.<\/p>\n

1 – They can reside in an avatars INVENTORY<\/span><\/strong>.<\/p>\n

2 – They can reside INWORLD<\/strong> <\/span>either suspended in mid air or on the ground. They can even be in motion.\u00a0 One stipulation is that in-world objects meant to attach must reside in the same region\/sim as the target-avatar.<\/p>\n

RLV<\/span><\/strong> stands for Restrained Love Viewer.<\/span><\/strong>\u00a0 It is a protocol used restrict or force certain behaviors on an avatar that wears a special RELAY<\/strong> AND gives explicit control to other selected avatars and\/or devices.<\/p>\n

You must enable RLV<\/span> <\/strong>in the Firestorm<\/strong> viewer. If it is NOT enabled, when you DO enable it (check the box), then you must RESTART<\/span><\/strong> your viewer.<\/p>\n

\"\"<\/a><\/p>\n

We have a book on RLV<\/span> <\/strong>called BK03 – The Artiste – Book – Guide<\/span> to RLV v1.0.\u00a0 <\/strong>Most if not all of it still applies.\u00a0 It shows how to set up RLV folders which is a prerequisite to being able to attach, detach, and replace items from ones INVENTORY<\/span>.<\/strong><\/p>\n

You do NOT NEED RLV<\/strong><\/span> enabled nor set up RLV<\/span> <\/strong>folders IF<\/strong>….the objects you wish to attach\/detach are INWORLD<\/strong><\/span>.<\/p>\n

Wearing an RLV<\/span> <\/strong>aware HUD is required when using inventory<\/strong><\/span>. We have 2 ways to do this.<\/p>\n

1 – Wearing the Artiste Performance HUD. <\/strong>This is reserved for the dance leader.<\/p>\n

2 – Wearing the Follower-RELAY HUD.\u00a0 <\/strong>This is for the other dancers but can also be worn by the dance leader.<\/p>\n

You can also wear both at the same time.<\/p>\n

Commands from *autofx ONLY\u00a0<\/strong> <\/span>talk to the RELAY HUD<\/strong><\/span> when you use the RELAY<\/strong><\/span> format,<\/p>\n

(i.e. RELAY=F%AdornSwapX%JointPOOFER<\/span><\/strong>).<\/p>\n

There are\u00a0 commands that talk directly\u00a0 to the HUD itself in order to attach\/detach.<\/p>\n

But first lets briefly introduce all the major tools and what they are best known for.<\/p>\n

1 – The Performance HUD\u00a0<\/span><\/strong> – this was the 1st tool created.\u00a0 It did everything. It is now best used when you need precision timing <\/strong><\/span>of external events like emitting particles since, out of the 4 tools listed here, it is the most time-tested and accurate tool when it comes to precise timing of activities.\u00a0 It could be seen as the “mother ship<\/span><\/strong>” that triggers the other 3 tools to activate.<\/p>\n

2 – The Artiste Palette<\/strong> <\/span>– the palette was created to extend the reach of the Performance HUD<\/strong> in terms of capabilities.\u00a0 \u00a0People kept asking for\u00a0 special scripts to do this and special scripts to do that so I decided to create ONE repository that could hold most of the special needs that people WERE<\/strong> asking for as well as trying to predict needs that people WOULD<\/strong> ask for.<\/p>\n

This tool is BEST<\/span> <\/strong>used when you need to move and\/or rotate an avatar more than 1 move<\/span><\/strong> but it does a LOT of other things. It is also\u00a0 best used when you need to combine features.\u00a0 See the State of Shock Video==>\u00a0 State of Shock<\/a><\/strong> We combined a mover, light, and animated-texture to work at the same time.\u00a0 As of this date, it has 9 scripts, and 4 to 5 notecards.<\/p>\n

3 – The Artiste SmartDancer<\/span><\/strong> – this tool emanated from the Performance HUD. It is now the preferred way to animate multiple dancers in sync.\u00a0 It can also mix animesh<\/span> <\/strong>with avatars<\/span><\/strong> and dance<\/strong> them in sync as well as move them in fixed and custom formations<\/strong>.\u00a0 So its main use is dancing<\/span><\/strong> and formations in 2d or 3D<\/span><\/span><\/strong>.\u00a0 But it can also to fancy moves like Junes<\/strong> and Canons<\/strong>.\u00a0 And it can also group animations into up to 4 groups.\u00a0 It can also group formations into 1 or 2 groups. And it can do effects to like glow and color change.\u00a0 A nice example of its abilities can better be expressed by a video. ==>SmartDancer Demo<\/a><\/strong><\/p>\n

4 – The Artiste Async\u00a0<\/span> – <\/strong>this is 1 script<\/strong><\/span> with an optional notecard that can be inserted into any modifiable object.\u00a0 \u00a0It has many functions.\u00a0 See this linke for a current list of its functions with syntax. ==> ASYNC\u00a0 Reference Post<\/a><\/strong><\/p>\n

Think of it as “palette light<\/span><\/strong>“.\u00a0 It has many of the same functions, some enhanced.\u00a0 It was initially created to control Animesh from the “thrower” function of the Artiste Palette, and have features\/functions go off and do their own thing on their own time line.<\/p>\n

But it can also be used to do simple but common tasks like hiding<\/strong> and showing<\/strong> an object or specific link of an object. It can also fade-in<\/strong> or fade-out<\/strong> an object or link.\u00a0 It can also move and\/or animate an animesh.\u00a0 It can move, rotate, spin an object.\u00a0 It can do fancy stuff like a poor-mans ‘thrower’.<\/p>\n

It is called Async<\/span><\/strong> because the script has its own internal time-line<\/strong> that operates on its own, asynchronously , irrespective of any timeline that started it off.<\/p>\n

I suggest always considering this tool 1st as a solution. Then if it cannot do the task, then consider stepping up to the Artiste Palette.<\/strong><\/span><\/p>\n

\n

Under the new 2021 direction, each of the 4 major tools can not talk to all of the others. Talk, meaning control or start in motion or action.<\/p>\n

————————————–<\/p>\n

So I will attempt to give working examples of the Adorns for each tool.\u00a0 This can be one place where you can quickly come to discover the command and syntax for attach\/detach.\u00a0 I will provide quick-and-dirty snapshots of what the inventory folder structure looks like.\u00a0 We will use a simple top hat and experiment attaching and detaching it as well as swapping it from hand to head and back again from head to hand. It will be up to you to find and play an accompanying animation at the right time.\u00a0 This is just about the basic commands and syntax for the basic adorning.<\/p>\n

#RLV\\!Adorn\\aHat\u00a0<\/strong> <\/span>contains our hat. You can use any hat.<\/p>\n

********************************************
\n<\/strong>Performance HUD
\n<\/span><\/strong>
\n*autofx<\/span><\/strong>
\n1,WARN=Event1-AttachHat$Outfit2Adorn=aHat$ADORN=$<\/span><\/strong>
\nEND<\/span><\/strong><\/p>\n

1,WARN=Event1-DetachHat$Outfit2Adorn=-Hat$ADORN=$<\/span><\/strong>
\nEND<\/span><\/strong><\/p>\n

1,WARN=Event1-ReplaceHat$Outfit2Adorn=rHat$ADORN=$<\/span><\/strong>
\nEND<\/span><\/strong><\/p>\n

NOTICE that\u00a0 in the above examples, you do NOT NEED the Follower-Relay because the Performance HUD acts as the RLV relay.<\/span><\/strong><\/p>\n

Notice that mesh<\/span><\/strong> can take much longer to attach than non-mesh.\u00a0 Also note that Replace replaces everything previously attached to a given attach point so if you had a HAIR and attached to SKULL and added a WHITE HAT also attached to that SKULL then you try and Replace it with a RED HAT to that SKULL, it will replace the previous WHITE HAT AND HAIR and you will be unexpectedly bald with a RED HAT.<\/p>\n

AdornSwapX, AdornSwapY, AdornRemoveS, and AdornRemoveT<\/span> are NOT enabled for the\u00a0 Performance HUD but CAN be sent via *autofx to a worn Follower-Relay.<\/span><\/strong><\/p>\n

IMPORTANT:\u00a0 The Relay MUST WORN AND\u00a0 ENABLED
\n<\/strong><\/span>#RLV\\!Adorn\\sHat<\/span><\/strong>
\n#RLV\\!Adorn\\tHat<\/span><\/strong>
\n<\/span>It is assumed the hats will be attached to different attach-points.\u00a0 That’s the whole point of the swap<\/b><\/span><\/span><\/p>\n

AdornSwap is just a tighter auto-implementation of a detach followed quickly by an attach.\u00a0<\/span><\/strong><\/p>\n

*autofx<\/span><\/strong>
\n1,WARN=SwapInPoof$RELAY=F%AdornSwapX%Hat$
\n<\/span>END<\/span><\/strong><\/p>\n

1,WARN=SwapOutPoof$RELAY=F%AdornSwapY%Hat$
\nEND<\/span><\/strong><\/p>\n

1,WARN=DetachS$RELAY=F%AdornRemoveS%Hat$<\/strong><\/span>
\nEND<\/strong><\/span><\/p>\n

1,WARN=DetachT$RELAY=F%AdornRemoveT%Hat$<\/strong><\/span>
\nEND<\/strong><\/span><\/p>\n

************************************<\/strong>
\nArtistePalette<\/span><\/strong><\/p>\n

Copy the palette scripts into the object you want to attach. In this case we put it into a palette called TopHat<\/strong><\/span>.\u00a0 The hat is simply laying on the ground at about 20 meters. In this example I laid the hat on the ground, then I went up to my lab, 3,022 meters high.\u00a0 I executed the instruction from the Performance HUD.\u00a0 Remember, no RELAY was needed. Even though the HUD is also a relay, we can and will execute this same statement later from other tools without any HUD<\/strong>.\u00a0 The had must be previously attached manually so the Attach process will know the position and rotation it will use for placement.<\/p>\n

*autofx
\n<\/span><\/strong>1,WARN=AttachFromInworld$r=p%TopHat%Attach%2$
\nEND<\/span><\/strong><\/p>\n

Notice\u00a0 that, below, using 0 as an attach-point is how we simply use the PREVIOUS attach-point, which in this case is 2 for SKULL<\/span><\/strong><\/p>\n

1,WARN=AttachFromInworld$r=p%TopHat%Attach%0$
\nEND<\/span><\/strong><\/p>\n

Also, notice, below, that Detaching an object will move the obj3ect back in your inventory since that is where it had to originate from at some point.<\/span><\/strong><\/p>\n

1,WARN=AttachFromInworld$r=p%TopHat%Detach$<\/strong><\/span>
\nEND<\/strong><\/span><\/p>\n

\n

Now, a little hidden gem of the Palette stems from the Action feature.\u00a0 We can execute an Attach\/Detach matched to a given move step.\u00a0 You can have 1 action for each move. The example below executes an action at the beginning of move #3.\u00a0<\/span><\/strong>\u00a0<\/span> The 0<\/span><\/strong> is an optional DELAY<\/span><\/strong> time prior to the action happening<\/span>.\u00a0 The <\/span>me<\/strong> <\/span>says apply the action to THIS<\/strong> palette. The other option is to specify a different palette name to apply the action to.\u00a0<\/span> <\/span>THIS <\/b>palette will be faster since the action really applies to the inventory as this action will be sent to a <\/span><\/span>required<\/b><\/span>\u00a0attached FOLLOWER-RELAY<\/b><\/span><\/span>. <\/span><\/span>The name of the action is <\/span><\/span>adorn. <\/span><\/span><\/strong>The folder name includes the adorn type<\/strong><\/span>. In this case it is a or –<\/span><\/strong> for attach\/detach (aTopHat)<\/strong><\/span>.\u00a0 The zero (0)<\/span> <\/strong>says to use the previously assigned attach-point<\/span><\/span><\/span><\/p>\n

Action<\/span><\/strong>,3<\/span><\/strong>%0<\/span><\/strong>%me<\/span><\/strong>%adorn<\/span><\/strong>%a<\/span>TopHat<\/span><\/strong>@0
\nAction<\/span>,3%0<\/span>%me<\/span><\/span><\/strong>%<\/span><\/span>adorn<\/span><\/span><\/strong>%<\/span><\/span>–<\/span>TopHat<\/span>@0<\/span><\/strong><\/p>\n

*******************************************
\n<\/strong>SmartDancer (SD)<\/span><\/strong><\/p>\n

Be sure you are wearing the Follower-Relay, that it is ENABLED and that you are in the right GROUP and all the other matching requirements like ID and defaultauthorizedsender<\/strong><\/span><\/p>\n

The format for Adorning\u00a0 in the SmartDancer is tricky to understand.<\/p>\n

1 – Only 3 commas<\/span><\/strong> are used. Any more or less and the command will FAIL.
\n<\/span><\/strong>2 – a single percent sign<\/strong><\/span> MUST<\/span><\/strong> (%<\/span><\/strong>) follow the ID<\/span> <\/strong>o the command will FAIL<\/strong><\/span>.
\n3 – All succeeding parameters MUST delimited by the carat (^)<\/span><\/strong> a<\/span><\/span><\/p>\n

*sequence1<\/strong><\/span><\/p>\n

ElapsedOrDuration,elapsed<\/span><\/strong>
\n1,Chat,-1231,F%Adorn^aHat<\/span><\/strong>
\nEND<\/span><\/strong><\/p>\n

1<\/span><\/strong> is the line descriptor
\nChat<\/span><\/strong> is the command to send the following command to a device ready to receive on channel -1231. In this case it is the Follower-Relay which must be worn and enabled.
\n-1231<\/span><\/strong> is the channel identified in the:
\nFollowerRelay<\/span><\/strong>, inside the notecard called
\n*avatarrelaychannels <\/span><\/strong>in an entry named<\/span><\/span>
\nDefaultAvatarRelayChannel,-1231
\nF<\/span><\/span><\/strong> is the ID<\/span><\/strong>of Relays that are to execute the command and must match the ID in the FollowerRelay<\/span><\/strong>
\nAdorn<\/strong><\/span>is the command.
\naHat<\/span><\/strong> is the subfolder in the\u00a0 path that the object you wish to attach or detach or replace is in under #RLV\\!Adorn\\<\/span><\/strong><\/span><\/span><\/p>\n

It would be <\/strong>-Hat <\/strong><\/span>if <\/span>you wanted to detach the item in a folder called Hat. Note that there IS NO FOLDER<\/span> labeled -Hat<\/span>. It is JUST the format that says to detach instead of attach.<\/strong>
\n<\/span><\/strong><\/span><\/span><\/p>\n

It would be rHat<\/span> <\/strong>if you wanted to replace<\/p>\n

AdornSwap<\/span><\/strong> DOES work on the SmartDancer, just not for Action in the Palette.<\/p>\n

ElapsedOrDuration,elapsed<\/span><\/strong>
\n1,Chat,-1231,F%AdornSwapX^Hat | 1<\/span><\/strong>
\nEND<\/span><\/strong><\/p>\n

Notice that the same formatting rules apply as for Adorn\u00a0 except that for AdornSwap<\/span> <\/strong>folder there is no prefix.\u00a0 It is the sub-folder name without the ‘s’ or ‘t’.<\/p>\n

ElapsedOrDuration,elapsed<\/span><\/strong>
\n1,Chat,-1231,F%AdornSwapY^Hat | 1<\/span><\/strong>
\nEND<\/span><\/strong><\/p>\n

ElapsedOrDuration,elapsed<\/span><\/strong>
\n1,Chat,-1231,F%AdornRemoveS^Hat | 1<\/span><\/strong>
\nEND<\/span><\/strong><\/p>\n

ElapsedOrDuration,elapsed<\/span><\/strong>
\n1,Chat,-1231,F%AdornRemoveT^Hat | 1<\/span><\/strong>
\nEND<\/span><\/strong><\/p>\n

********************************************
\n<\/strong>Async (StoryTeller)
\n<\/span><\/strong><\/p>\n

Be sure you are wearing the Follower-Relay, that it is ENABLED and that you are in the right GROUP and all the other matching requirements like ID and defaultauthorizedsender<\/strong><\/span><\/p>\n

The format for Adorning\u00a0<\/strong> in the Async<\/span> <\/strong>is tricky to understand.<\/p>\n

1 – Only 3 commas<\/span><\/strong> are used. Any more or less and the command will FAIL.
\n<\/span><\/strong>2 – a single percent sign<\/strong><\/span> MUST<\/strong> (%<\/span><\/strong>) follow the ID<\/span> <\/strong>o the command will FAIL<\/strong>.
\n3 – All succeeding parameters MUST be delimited by the carat<\/span> (^<\/span>)<\/strong> a|<\/span><\/span><\/p>\n

Ok so the format is different here due to how Async works.<\/p>\n

The whole command with IT’s parameters goes in the Command field which is the 2nd field:\u00a0 \u00a0 Type, Command, Parms<\/p>\n

The type is<\/strong> “C<\/span><\/strong>” for Chat<\/span><\/strong>
\nThe Command<\/span> passed the Relay is: <\/span>F%Adorn^aHat
\n<\/strong><\/span>The Parameter for Chat is the channel<\/span><\/strong> to the Relay which is -1231.<\/span><\/strong><\/p>\n

-369,Async\/A\/Target\/AT2\/C\/F%Adorn^aHat\/-1231<\/strong><\/span><\/p>\n

-369,Async\/A\/Target\/AT2\/C\/F%Adorn^-aHat\/-1231<\/strong><\/span><\/p>\n

-369,Async\/A\/Target\/AT2\/C\/F%AdornSwapX^Hhat\/-1231<\/span><\/strong><\/p>\n

-369,Async\/A\/Target\/AT2\/C\/F%AdornSwapY^Hat\/-1231<\/span><\/strong><\/p>\n

-369,Async\/A\/Target\/AT2\/C\/F%AdornRemoveS^Hat\/-1231<\/span><\/strong><\/p>\n

-369,Async\/A\/Target\/AT2\/C\/F%AdornRemoveT^Hat\/-1231<\/strong><\/span><\/p>\n

 <\/p>\n

 <\/p>\n

\u00a0<\/b><\/span><\/p>\n

 <\/p>\n","protected":false},"excerpt":{"rendered":"

This topic is so important and so pervasive across all the key Artiste Suite of tools that it deserves its own post.\u00a0 BK08 – The Artiste – Book – Adorning v1.0\u00a0 has outdated and incomplete information as well as some errors in command syntax.\u00a0This post will solve a whole host of issues. Adorn is a … Continue reading ADORNING (Attach, Detach, Replace)<\/span> →<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[28,21,12],"tags":[],"_links":{"self":[{"href":"https:\/\/artistedancediva.co.uk\/wp\/index.php?rest_route=\/wp\/v2\/posts\/3774"}],"collection":[{"href":"https:\/\/artistedancediva.co.uk\/wp\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/artistedancediva.co.uk\/wp\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/artistedancediva.co.uk\/wp\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/artistedancediva.co.uk\/wp\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=3774"}],"version-history":[{"count":88,"href":"https:\/\/artistedancediva.co.uk\/wp\/index.php?rest_route=\/wp\/v2\/posts\/3774\/revisions"}],"predecessor-version":[{"id":3864,"href":"https:\/\/artistedancediva.co.uk\/wp\/index.php?rest_route=\/wp\/v2\/posts\/3774\/revisions\/3864"}],"wp:attachment":[{"href":"https:\/\/artistedancediva.co.uk\/wp\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=3774"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/artistedancediva.co.uk\/wp\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=3774"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/artistedancediva.co.uk\/wp\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=3774"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}