OpenSimWorld^✔ @opensimworld

Offline

Visit OpenSimWorld to get the latest versions of the OpenSimWorld beacon, the SatyrFarm, SFposer and SFsail

SFPoser Animation Controller

<img src="https://opensimworld.com/data/p/87/87/62087.jpg" style="width: 325px; height: 325px; display: block; margin-left: auto; margin-right: auto;"> 
 
WHAT IS SF POSER 

SF Poser is a General-Purpose Animation Controller for up to 99 avatars. It can be used to create furniture from scratch and quickly without editing notecards at all. It allows on-the-fly adjustments of poses and change of animations, automatic timers, prop rezzing, NPC rezzing, RLV, expressions, and other built-in powerful utilities. 
It uses the same notecard format of the wonderful PMAC system, which means that it works right away with existing PMAC furniture. 
QUICKSTART WITH SF POSER 

You can get the SFposer package from the opensimworld region: <a href="https://opensimworld.com/hop/74730">https://opensimworld.com/hop/74730</a> 
The package contains an empty SFposer Template. 

- Rez the template and add your animations in its contents 
- Click on it and select OPTIONS->New Menu to create a new poses menu. A new empty pose (Pose1) will automatically be added to the new menu 
- Click OPTIONS -> EDIT POSE to adjust the pose. The positioning handles will appear. - Touch each handle to select an animation from inventory 
- Move the handles to position the avatars 
- When done, click Save Pose, and then Save Menu Congratulations, you just created your first menu card and pose! 
SF POSER FEATURE SET <ul><li>Fully Automated editing. SF Poser allows you to create new notecards and poses on the fly, and save them without ever creating or editing notecards and without the need to stand up/reset the script</li><li>Animation switching: Clicking the positioning handle allows to experiment with different sets of animations</li><li>Adjust menu: Users can make temporary finetuning to their position on-the-fly in order to perfectly match the pose</li><li>Expressions: emote using a facial expression at any time</li><li>Built in support for LockGuard chains</li><li>Built-in support for RLV</li><li>Built-in support for Rezzing NPCs
</li><li>Built-in Object Giver</li><li>Built-in Props rezzer with ability to rez/derez/move objects</li><li>Built-in utilities such as sending chat channel messages, OSSL messages, attachment messages and more </li><li>Configurable via the '.SFconfig' notecard</li><li>Create custom Button commands with a single line in the .SFconfig notecard using powerful Shortcodes (see below) </li><li>OSSL-native script, meaning that you can control up to 99 avatars with a single script. It requires that the owner has enabled OSSL permissions.</li><li>Small footprint: A single script for everything. The script uses as little resources as possible, and resets when unused, minimizing memory usage. Loading time is instantaneous</li><li>Link-message and dataserver-API for fully remote operation. SFposer can become the animation-controlling part of another object such as a vehicle or a game</li><li>Permission system for limiting access to menus.</li><li>Snappy operation and uncluttered menu dialogs</li></ul>TO CONVERT AN EXISTING PMAC OBJECT 
- Remove all the existing scripts from the object 
- Drop the ~positioner, the ~baseAnim and the ..SFposer script in the contents of the PMAC object. You will find those inside the SFposer Template object 
- That's all! If you need to convert existing PMAC plugin options to SFposer, <a href="https://opensimworld.com/tools/pmac">use this converter</a> 
TO CONVERT FROM OTHER SYSTEMS (AvSitter/MLP) There is an online converter system that you can use to convert MLP and AVsitter cards to the SFposer/PMAC format: <a href="https://opensimworld.com/tools">https://opensimworld.com/tools</a> <p&gt... AND POSESA POSE is a set of avatars playing animations in specific positions. SFposer organizes the poses in MENUS (groups of poses), and each of the menus is saved in a separate notecard inside the object. Each menu notecard line describes one POSE, and all the poses in the menu support the same maximum number of avatars. The notecards are automatically created and saved by SFposer, but you will need to edit the notecards to add Shortcodes, which provide additional functionality. 
USING SHORTCODES{} Shortcodes are strings of the form SHORTCODE{argument1; argument2} which are added to notecards to instruct SFposer to do something while playing an animation. They can also be invoked through add-on buttons in the OPTIONS menu, from other scripts via llMessageLinked() and remotely from other objects using the SFposer dataserver-API. To add a shortcode to a pose, insert it in the specially reserved second column of the .menu notecards, right after the pose name. The column is usually occupied with "NO COM" or "NOCODE". Replace those with your shortcode(s):<code>Dance Together2|NO COM|danceLeft2|... Dance Together|EXPR{smile;3;smile;4} SAY{Hello!} SAY{Hello again}|danceLeft|... Dance Together3|SHORTCODE_GOES_HERE|danceLeft3|...</code> You can add multiple shortcodes{} simply separating them with spacesThere is additionally a configuration notecard for SFposer named '.SFconfig' where you can also add shortcodes, one per line (more on this later)A shortcode{} can be executed via a button in the OPTIONS menu. To create a button, add a Button line in the .SFconfig notecard as follows:Button=ButtonLabel=SHORTCODE{arg1;arg2;arg3}After editing notecards, you need to stand up and sit again, to force the script to reset and reload them. 
 
ADDING EXPRESSIONS For each avatar participating in the pose, you can specify an expression animation to play and the time it takes to repeat the expression (in seconds -- if you dont want repeats , enter 0). The Expressions Shortcode is: 
<code>EXPR{expression1;repeatTime1;expression2;repeatTime2;expression3;repeatTime3 ... and so on for every avatar of the pose}</code> 

The expressions and repeatTimes can be left empty, but be sure to include the required ';' separators for all avatars in the pose. 
For example, the following notecard line defines expressions for the pose "WatchMovie" which is for 3 avatars: 
<code>WatchMovie|EXPR{laugh_emote;4;open_mouth;3;frown;0}|chair_sit|<0.2112.... [the rest of the pose line]</code> 
In this case, avatar1 will play the animation express_laugh_emote every 4 seconds; avatar2 will play express_open_mouth every 3 seconds and avatar3 will play express_frown only once. 
For brevity, the "express_" part of the animation name is omitted (so you only enter "frown" for animation "express_frown") . The full list of available expressions is: 
open_mouth, surprise_emote, tongue_out,smile, toothsmile, wink_emote, cry_emote,kiss, laugh_emote,disdain, repulsed_emote, anger_emote, bored_emote,sad_emote, embarrassed_emote, frown,shrug_emote, afraid_emote, worry_emote If you wish to use a custom expression animation (e.g. a bento animation called bentoanim), you need to add the animation inside the SFposer object and rename it to "express_bentoanim". You can then use it as: EXPR{bento_anim;3} 
 
REZZING PROPS 

"Props" are objects to be rezzed with specific poses or via a button. All props objects must contain the SFposer Prop script so that they can be deleted after use. <a href="https://opensimworld.com/library?viewcode=104&raw=1&am...">Click here to get the script</a> After adding the script to the prop, drop it in the contens of the object and rename it to "MyProp".
Add the following Shortcode to a pose to rez the prop: 
<code>PROP{MyProp;<1,1,1>;<0,0,0,1>}</code> This will rez MyProp at position <1,1,1> and rotation <0,0,0,1> relative to the object. You do not need to edit the position and rotation manually instead you can position the props correctly by editing the pose (read below).If you need to rez multiple props, add multiple PROP{} shortcodes, separating them by space: PROP{Prop1... } PROP{Prop2...} PROP{Prop3...} ....Sit and re-sit on the SFposer to reload the notecards, and then select the pose again. The prop should rez in the position <1,1,1>, as instructed. Now, edit the prop to position it to its final position, and then select Options -> Edit Pose -> Save Pose. The system will save the new PROP{} positions and also print them out in local chat. Additional shortcodes for props are supported. You can use them to create Buttons that rez/derez props:<code>TOGGLEPROP{MyProp;<1,1,1>;<0,0,0,1>}</code> When the button is pressed, it rezzes the prop, when pressed again, it deletes it. 
<code>DELPROP{MyProp}</code> Deletes the prop
For example, you can define a rez/unrez button in the .SFconfig notecard as follows:<code>Button=Rez/Unrez=TOGGLEPROP{MyProp;<1,1,1>;<0,0,0,1>}</code>(remember to re-sit in order to reload the card) Attachment Props: You can use the "SFposer attachment prop script" (<a href="https://opensimworld.com/library?viewcode=106&raw=1&am...">get it here</a>) to create props that auto-attach to a user (for example, a gym bench could use them to attach dumbbells to the sitter's hands). Use the following procedure to create attachment prop shortcodes:- Wear the attachment, adjust it to its final position and add the "SFposer Attachment Prop script" inside it. - RESET THE SCRIPTS in the attachment to record its position
 - Detach the attachment, add it in the contents of the SFposer object, make it full permissions, and give it a name (e.g. MyPropName)Add the following shortcode to a pose to rez the prop and requests to attach to avatar sitting at position 0 (first avatar)<code>PROPATT{MyProp;0}</code> When you select that pose, the attachment prop will rez and request to attach to the first sitting avatar.If instead you wish to attach the prop to the avatar that is currently using the menu, use a simple PROP{} code: <code>PROP{MyProp;<0,0,0>;<0,0,0,1>}</code> Attachment props are not detached when switching positions, they will detach when you stand up. Note that Attachment props are temporary and cannot be detached by right clicking, instead the user will have to click on them to detach. 

RLV SUPPORT SFPoser has built-in support for RLV and uses shortcodes to implement it. Add the following lines to your .SFconfig notecard to create an "RLV Capture" and an "RLV Release" button:<code> Button=RLV Capture=RLVCAPTURE{20} Button=RLV Release=RLVRELEASE{}</code> RLVCAPTURE{20} indicates that 20 is the maximum distance (in meters) within which to search for avatars to capture. RLVRELEASE{} does not have any arguments You can send RLV commands in specific poses with the RLV{} shortcode: <code>RLV{avatarNumber; @rlvCommand1 ; @rlvCommand2; @rlvCommand3 ... }</code> avatarNumber is the position of the avatar (0 is the first avatar). You can send multiple RLV commands with a single RLV{} shortcode, but remember to separate them with ';'RLV support works with osCollar 7. You can <a href="http://wiki.secondlife.com/wiki/LSL_Protocol/RestrainedLov...">read more about the RLV protocol here</a>. 
BUILT-IN GIVER 

To give an object (e.g. Popcorn) to the user who is currently using the system, create a Button in the .SFconfig notecard with the GIVE{} shortcode as shown below: 
 
<code>Button=Get Popcorn=GIVE{Popcorn}</code> 
The button "Get Popcorn" will be added to the Main menu's OPTIONS screen. Make sure the Popcorn object is inside the contents of the SFposer object and that it is copyable or else the command will fail silently 
NPC REZZING SUPPORT 
You can add NPCs to SFposer by adding appearance notecards inside the object. Each NPC appearance notecard must use the naming convention of PMAC: ".NPC00A Firstname Lastname". Appearance Notecards created for PMAC should work right away. Add the NPC notecards and reset the object by re-sitting. The NPCs submenu is in the OPTIONS menu You can use the shortcode ADDNPC{firstname lastname} in .SFconfig to rez NPCs during startup or after region restart. You can also use the shortcodes ADDNPC{..} and DELNPC{..} in poses. 
LOCKGUARD CHAINS SUPPORT 
SFposer supports LockGuard V2 cuffs for chains and ropes. In order to add lockguard settings to a pose, use the LG{} Shortcode: 
<code>LG{0;rightwrist;rightHook}</code> 
 
This sends a lockguard command to the cuffs worn by the avatar sitting at position 0 (the first position) to link to the child prim named "rightHook". It uses the lockguard command "rightwrist" which is understood by the wrist cuff. You can add more lockguard options to the "rightwrist" command , such as "rightwrist gravity 4 life 1.5 color 1 0 0", but DO NOT INCLUDE the "link" and "unlink" commands. These are added automatically by the system. You can <a href="http://wiki.secondlife.com/wiki/LSL_Protocol/LockGuard#Loc...">read more about the LockGuard protocol options here</a>. You can add multiple LG{} Shortcodes for multiple cuffs. An example notecard line is: 
<code>UseCableMachine| LG{0;rightwrist life 1;righthook} LG{0;leftwrist life 1;lefthook} |cables|<1.3282,1.8789,0.8556>|<0.0001,-0.0002,0,1.></code> 
Chains are unlinked automatically when someone stands. 
 RUNNING EXTRA ANIMATIONS 
You can create a Button that runs a set of animations ON TOP OF the currently playing animations. For example you can create a Button that makes everybody laugh at any time by adding the following line to .SFconfig notecard: 

<code>Button=All Laugh=ANIM{express_laugh;express_laugh;express_laugh}</code> 

to create a button to stop those animations, use the STOPANIM Shortcode instead of ANIM: 

<code>Button=Stop Laugh=STOPANIM{express_laugh;express_laugh;express_laugh}</code> 
Note that, unlike EXPR{} , you have to specify the full animation name here, and there is no repeat-time since the animations here are not repeatable 
 ANIMATION SWITCHING WITH A TIMER 
SFposer supports an auto-timer that switches to the next pose every X seconds. The menu TIMER is under OPTIONS. 
You can specify the default auto timer duration (in seconds) for all menus in the .SFconfig notecard: <code>autoTimer=60 </code> You can set the auto-timer for individual poses by adding the shortcode TIMER{50}, which will set the animation timer every 50 seconds.TIMER{0} will stop the auto-timer. 
ADVANCED SHORTCODES 
Shortcodes like GIVE{... }, can be used either via Buttons (shown in the the OPTIONS menu) or by adding them to the pose line in a notecard. Note: Shortcodes must appear before any other custom configuration strings you useThe Shortcode-section of a notecard can contain multiple Shortcodes separated by space. For example, if you want a pose to rez a PROP{} and also run some animation, add the following Shortcodes: 
<code>PROP{MyProp;<1,0,0>;<0,0,0,1>} ANIM{clap;clap;clap;clap}</code> 

The same Shortcodes can be used via a Button. The button is defined in the .SFconfig notecard with a single line as follows: 

<code>Button=MyButtonLabel=PROP{MyProp;<1,0,0>;<0,0,0,1>} ANIM{clap;clap;clap;clap}</code> 

In addition to the Shortcodes described so far, the following Shortcodes are supported: 

<code></code><code>MSGPROP{MyProp;Hello, prop}</code> Sends the dataserver message "Hello, prop" to the already-rezzed prop MyProp using osMessageObject() 
<code>MSGATT{0;Hello, avatar1 attachment;19,4}</code> Sends the dataserver message "Hello, avatar1 attachment" to the attachments attached on attach points 19 or 4 of the avatar sitting on position 0 of the pose (first position) using osMessageAttachments(). You can read more on <a href="http://opensimulator.org/wiki/OsMessageAttachments">the documentation of osMessageAttachment online </a>. You can also <a href="http://wiki.secondlife.com/wiki/ATTACH_HEAD">view the full list of attachment point numbers</a>. <code>MSGOBJ{<object-uuid>;Hello object}</code> Sends the dataserver message "Hello object" to the object with <object-uuid> using osMessageObject(). This can be used to send shortcodes to another SFposer, however you will have to replace '{' and '}' with '[' and ']' in the shortcodes for this to work. This example changes the pose in another sfposer object:MSGOBJ{<object-uuid>; SAY[Changing pose] SWITCHTOPOSE[MyPose]} 

<code>MSGLINK{4;Hello link number 4}</code> Uses osMessageObject to send the dataserver message "Hello link number 4" to the linked prim at link number 4 

<code>SAYCH{21;Hello, channel 21}</code> Uses llSay() to say the string "Hello, channel 21" to the local chat channel 21. The string can contain the special codes %USER00, %USER01, %USER02 etc which are replaced witht the Name of the user sitting at position 1, position 2 etc. For example: SAYCH{0; The user %USER00 is sitting with %USER01} 
 <code>SAY{Hello public channel}</code> Like SAYCH, but for the local chat<code>REGIONSAY{21; Hello channel 21 in the whole region}</code> Like SAYCH, but region-wide<code>USAY{Hello dialog user}</code> Say something to the user currently using the dialog 
<code>LINKMSG{-1;99;Hello, all prims}</code> Uses llMessageLinked(-1,99, "Hello, all prims" , <list-of-avatarIds> ) to send a link message. Note that LINK_SET = -1, LINK_THIS=-4 <code>TRIGGERSND{My sound}</code> Play the sound "My sound" using llTriggerSound<code>PLAYSND{My sound}</code> Play the sound "My sound" with llPlaySound (e.g. to accompany an animation)<code>LOOPSND{My sound}</code> Start playing a sound loop with sound "my sound"<code>STOPSND{}</code> Stop sounds<code>SLEEP{0.5}</code> Add a delay (sleep) for 0.5 seconds Changing linked prim properties on the fly <code>SHOW{MyChildPrim; <1 or 0>}</code> Show or hide the child prim named MyChildPrim (1 = show) <code>SETPRIM{MyPrimName; <specially-encoded-list> }</code> This shortcode can be used to change the properties of the linked prim(s) named "MyPrimName" using the list of prim properties as in llSetPrimitiveParams(). It is essentially a way to call llSetLinkPrimitiveParams() without adding another script in the object. To use this shortcode, you must encode the list of parameters to llSetLinkPrimitiveParams() in a special format that can be pasted into the notecard. Use the script "SFposer encoder for SETPRIM" (<a href="https://opensimworld.com/library?viewcode=107&raw=1&am...">link at the end of this page</a>) to generate the shortcode. Example: Changing the color of a child prim named MyPrim and making it transparent The LSL list for llSetPrimitiveParams() would be [PRIM_COLOR, ALL_SIDES, <1,1,1>, 0.0]. Using the shortcode encoder script, it prints out in local chat the SETPRIM shortcode containing the encoded version of this list:SETPRIM{MyPrim; I;18;I;-1;V;<1,1,1>;F;0.0} Creating particle effectsSimilar to SETPRIM, SETPARTICLES{} is used to set the particle system in any named prim in the link set. <code>SETPARTICLES{MyPrimName; <specially-encoded-list> }</code>The parameters list to be passed to llLinkParticleSystem() must be a specially-encoded encoded with the <a href="https://opensimworld.com/library?viewcode=107&raw=1&am...">same script as above</a>, but remember to replace SETPRIM with SETPARTICLES in the output of the script.
 Presets of shortcodesPresets are shortcuts (macros) to a multiple shortcodes. Presets are defined in .SFconfig. The syntax for defining a Preset is: <code>Preset = MyCommand = SHOW{myPriml;1} TRIGGERSND{bang}</code> This defines the preset "MyCommand" as the series of shortcodes SHOW and TRIGGERSNDTo use a Preset, use the PRESET{} shortcode in a pose line or anywhere:<code>PRESET{MyCommand}</code> Presets can be used to group together shortcodes that are shared by multiple poses. For example, a Shower object may contain poses that with water running and and others that don't. The two preset states (WaterOn and WaterOff) could be defined in .SFconfig as follows:Preset = WaterOn = LOOPSND{watersound} SETPARTICLES{ShowerHead; <encoded list>}Preset = WaterOff = STOPSND{} SETPARTICLES{ShowerHead;;}Individual poses could be configured to use the presets as follows:Pre Shower| PRESET{WaterOff} |<1,2,3>.... Shower| PRESET{WaterOn} |<1,2,3>.... AfterShower| PRESET{WaterOff} |<1,2,3>.... When switching between poses that use the same preset, the preset will not be restarted, instead it will continue running. If you explicitly want a preset to be restarted, add another, empty PRESET{} code before:PRESET{} PRESET{WaterOn} Creating SequencesUsing shortcodes, it is possible to turn an animation menu notecard to a sequence of poses. Use the TIMER{} code to set the duration of each pose, and use Shortcodes or Presets to add effects such as props, sounds etc. to each pose. To prevent looping the whole sequence, use TIMER{0} at the last pose. An example notecard for a boxing match would be: Warmup| TIMER{30} SAY{%USER00 is preparing to fight %USER01} | prepare1| <0.012.... Fight | TIMER{30} PRESET{Fighting} SAY{Fight!} | fight1 | <0.012.... Victory| TIMER{0} TRIGGERSND{victory} SAY{%USER00 won! } | victory1 | <0.012.... Creating OPTIONS Buttons with shortcodes Any shortcode can be added to an add-on button in the OPTIONS menu with the Button option in .SFconfig: <code>Button=My Button=SAYCH{0; Hello,world}</code> Running shortcodes in .SFconfigYou can execute shortcodes in .SFconfig which will be executed every time SFposer is reset (whenever everyone stands up). Just add the shortcode on a single line by itself . This can be used for example to change the properties of prims when the system is reset using SETPRIM{}, to rez NPCs etc. 
API COMMANDS & REMOTE OPERATION 
The API allows you to trigger most of the Shortcodes described above in the SFposer object through link messages and through dataserver messages. To send commands from another script through link_messages use : llMessageLinked(LINK_THIS, -1, "SHORTCODE{...}", NULL_KEY); To send through dataserver messages, use: osMessageObject("<SFposer object UUID>", "SHORTCODE{...}"); In order to enable dataserver messages, the allowRemote option needs to be set in the .SFconfig notecard. This option determines how the SFposer can be accessed by avatars and dataserver messages, and takes the following values: allowRemote=0 Only sitting avatars can use the menus, the object does not accept dataserver commandsallowRemote=1 All avatars, sitting or not, can touch the object to use the menus, the object does not accept dataserver commandsallowRemote=2 Only sitting avatars can use the menus, and the object accepts dataserver commandsallowRemote=3 All avatars, sitting or not, can use the menus, and the object accepts dataserver commandsallowRemote=4 Disable all menu dialogs, and the object accepts dataserver commands. Use this in case you want to control SFposer remotely-only, in which case SFposer will not generate any dialog when touched. This is useful if you want to host SFposer and another menu-driven script in the same root prim. In order to allow changing poses and animation menus remotely, the following shortcodes are available for remote operation:SWITCHTOMENU{My Menu} Switches to the animation menu "My Menu"SWITCHTOPOSE{My Posename} Switches to the pose "My Posename" which must be in the currently selected animation menu.UNSIT{<avatarNumber>} Unsits the avatar in position <avatarNumber> (first position is 0)ADDNPC{firstname lastname} Adds an NPC from the inventoryDELNPC{firstname lastname} Deletes the NPCSWAP{pos1; pos2} Swaps the users in pos1 and pos2 (first position is 0) It is possible to use the API to add Buttons to the OPTIONS menu. In this case, instead of a shortcode, the message sent to SFposer has the same format as the .SFconfig configuration line for creating a button:osMessageObject("<object-uuid>", "Button=Say Hi=SAY{Hello, world}" ); For deleting a button from the OPTIONS menu, there is the shortcode DELBUTTON{}:DELBUTTON{Help me}e.g. osMessageObject("<object-uuid>", "DELBUTTON{Say Hi}" ); Buttons with arbitrary-string codes can also be created. This is meant to be used for sending messages to other scripts. The syntax is: Button = Send code = MyCodeIsHere When pressed, the button will send a link_message as follows:llMessageLinked(LINK_THIS, 0, "MyCodeIsHere|<current-user-uuid>", "<uuid1>|<uuid2>|..."); The API command GETSTATUS can be used to retrieve the current state of the SFposer object. Send the string GETSTATUS through dataserver or link_message to retrieve the status (Note this is not a shortcode so {} are not added): llMessageLinked(LINK_ROOT, -1, "GETSTATUS", ""); or osMessageObject("<sfposer-uuid>" , "GETSTATUS");SFposer will respond a link_message or dataserver message respectively, with a string containing the current state of sfposer:osMessageObject("<sender-uuid>", "SFSTATUS|<current-menu-user-uuid>|<current-menu-name>|<current-pose-name>|<auto-timer>|<internal status>|<current-pose-shortcodes>|<user1-uuid>,<user2-uuid>,<user3-uuid>..."); EVENTSSFposer sends link_message notifications to the root prim for any significant event. You can listen to those events by creating addon scripts. The names of the link_message events are the same as the ones used by PMAC. This is the list of events that are sent: GLOBAL_ANIMATION_SYNCH_CALLED GLOBAL_NEXT_AN GLOBAL_NEW_USER_ASSUMED_CONTROL GLOBAL_SYSTEM_RESET GLOBAL_START_USING GLOBAL_USER_SAT GLOBAL_USER_STOOD GLOBAL_SYSTEM_GOING_DORMANT GLOBAL_NOTICE_ENTERING_EDIT_MODE GLOBAL_NOTICE_LEAVING_EDIT_MODE GLOBAL_STORE_ADDON_NOTICE GLOBAL_EDIT_STORE_TO_CARDLook into the source code to see the arguments sent with each event. The events are sent via llMessageLinked() to LINK_THIS (the root object), with numeric Value=0. The 'key' argument is replaced with a concatenated list of the currently sitting avatar uuids (Just like PMAC). An example of the event messages sent out is: llMessageLinked( LINK_THIS, 0, "GLOBAL_USER_SAT|0|1111-111-111", "111-111-111|000-000-000|000-000-000" ); Triggering Shortcodes with Event FiltersYou can define Shortcodes that will be triggered automatically when an event matches a pattern using OnEvent configuration lines. The Event filters are defined in the .SFconfig notecard as follows:OnEvent = <Event filter> = SHORTCODE{} SHORTCODE2{} ...<Event filter> is replaced with the part of the of the event string that is to be matched. Example: When the first user sits on the object , SFposer emits the event "GLOBAL_USER_SAT|0|<user-uuid>" The following OnEvent filter matches the substring "GLOBAL_USER_SAT|0", and triggers the shortcode SAYCH:OnEvent = GLOBAL_USER_SAT|0 = SAYCH{0; Hello, first user} The different events contain different kinds of information in their event strings. It is possible for example, to use the the event string to trigger a shortcode when a specific avatar position is being filled or emptied. It is also possible to trigger a shortcode when a specific user-id sits on the object. Examples:OnEvent = GLOBAL_USER_STOOD|3 = SAYCH{0; Goodbye, user 3}OnEvent = GLOBAL_USER_SAT|0|2ae39a9c-13 = SAY{Hello, %USER00, i recognized you sitting in first position}OnEvent = GLOBAL_SYSTEM_GOING_DORMANT = SAY{Thanks for using me} LIST OF .SFconfig NOTECARD OPTIONSThe following configuration options are supported in the .SFconfig notecard:allowRemote= 0 or 1, 2,3,4 . Controls who can access the menus. See above for detailsautoTimer=90 Set the auto-timer (seconds)defaultGroup=Sit Name of the default menu when a user first sits in the objectadjusterStep=0.03 Set the adjustment step (in meters) for the ADJUST menu (X-, X+ etc)mainMenuTitle=Hello users Set a custom message to show in the MENUS dialog instead of the defaultautoSwitchGroup=1 Automagically switch to a bigger or smaller size animation menu when more people sit on the object or when they stand up. The system will switch to the first available animation menu that can accomodate the number of sittersshowDialogOnSit=1 Automatically show the menu dialog as soon as the first user sitsshowMenusOnStart=1 When first showing the dialog, show the list of Menus first, rather than the list of posesshowOptionsAgain=1 Show the Options dialog again after selecting an option from the Options menu instead of dismissing it. The user will have to click ignore to dismissallowSoloNpc=0 This forces the system to remove the rezzed NPCs when all humans have stood up (default is 1)offsetPos = <x,y,z> Move all poses by the vector <x,y,z> , i.e. add a global position offset to all positionsoffsetRot = <x,y,z> Rotate all the poses by the euler vector <x,y,z> (in *degrees*), i.e. add a global rotation to all positions lockMenus=A Unlocked menus to all users (the default). Other options:lockMenus=O Lock all menus to owner onlylockMenus=G Lock all menus to users who have activated the same group as the objectlockMenus=S Lock all menus until the owner has seated lockSit=A Everyone can sit (the default). Other options:lockSit=O Only the owner can sitlockSit=G Only members of the same group can sitlockSit=S The owner must sit first before other users can sit Preset=Dumbbell=PROP{dumbbell;<0,0,0>;<0,0,0,1>} Creates a preset (shortcut to a series of shortcodes) that can be used in poses (See above)Button=Hello=SAY{Hello} SAY{Hello again} Creates a button in the OPTIONS menu that executes shortcodes (See above)OnEvent=GLOBAL_SYSTEM_GOING_DORMANT=SAY{Bye} Creates an event filter (See above)In addition any number of shortcodes can be added to the .SFconfig notecard , one at a line. They will be executed every time the script is reset 
OSSL PERMISSIONS 

If you already have PMAC in your region, then you have already enabled all the functions that SFposer requires to operate 
In case you need to update your .ini files here are some recommended settings. Depending on the opensim version, these need to be added either in config-include/osslEnable.ini or config-include/osslDefaultEnable.ini . <code>Allow_osGetNotecard = true 
Allow_osMessageObject = true 
Allow_osMessageAttachments = ESTATE_OWNER,ESTATE_MANAGER,PARCEL_OWNER 
Allow_osAvatarPlayAnimation = ESTATE_OWNER,ESTATE_MANAGER,PARCEL_OWNER 
Allow_osAvatarStopAnimation = ESTATE_OWNER,ESTATE_MANAGER,PARCEL_OWNER 
Allow_osMakeNotecard = ESTATE_OWNER,ESTATE_MANAGER,PARCEL_OWNER 
Allow_osNpcCreate = ESTATE_OWNER,ESTATE_MANAGER,PARCEL_OWNER 
Allow_osNpcRemove = ESTATE_OWNER,ESTATE_MANAGER,PARCEL_OWNER 
Allow_osNpcSit = ESTATE_OWNER,ESTATE_MANAGER,PARCEL_OWNER 
Allow_osSetPrimitiveParams = ESTATE_OWNER,ESTATE_MANAGER,PARCEL_OWNER 
</code> 
SF POSER SYSTEM PARTS: 
- The .SFposer script 
- The ~positioner handle object 
- The ~baseAnim hip-fix animation 
- The .SFconfig configuration notecard (optional) 
 
MENU NOTECARDS FORMAT 

SFposer uses the same notecard format as PMAC. Each set of animations (menu) goes in its own notecard which is named with the following convention: .menu0005A Dance Togetherwhere<code>.menu : All pose notecards must begin with .menu 
00: Used for ordering of menus. Can be between 00-99 05: Means this menu notecard contains poses for 5 avatars 
A: Menu is for use by (A)ll. Can also be (G)roup or (O)owner, or (S) in which case the owner must sit first before the menu can be accessed by other users 
Dance Together: The label shown in the button is "Dance Together"</code> 
 You do not need to create your own notecards , as they are created for you automatically via the menus. 
NOTES - Despite the name, SF poser is a generic animation controller and is not specific to SatyrFarm, i.e. it can be used for anything.- Thanks to Aaack Aardvark @ osgrid for beta testing 
LICENSE 
(c) 2020 Satyr Aeon Licensed under GPL-3.0-or-later <a href="https://www.gnu.org/licenses/gpl-3.0-standalone.html"></a><a href="https://www.gnu.org/licenses/gpl-3.0-standalone.html">https://www.gnu.org/licenses/gpl-3.0-standalone.html</a... href="https://www.gnu.org/licenses/gpl-3.0-standalone.html"></a>

👍 8 like

Milestones

Demy457^✦ ▸ OpenSimulator 7 hours ago

parked avatars

How can exclude bot avatar from the avatar count?

KrisTina: exclude_list "If you are running Non-NPC bots in your region, paste the names of the bots in the "exclude_list" notecard, one bot per line. Regions which use bots to artificially inflate visitor numbe... 10 minutes ago

2 comments 👍 like

The Best Hosting for your Sim: Contabo: Powerful Cheap VPS with SSD for just $4.99/mo!

KrisTina^✦ ▸ Harmony Isle 19 minutes ago

OpenSimWorld✔ @opensimworld

SFPoser Animation Controller

Milestones

How can exclude bot avatar from the avatar count?

The Best Hosting for your Sim: Contabo: Powerful Cheap VPS with SSD for just $4.99/mo!

Harmony Isle Events:Dj KrisTina Starting Now Till 8pm Grid-Time Classic Rock Night Taxi: hop://hg.osgrid.org:80/Harmony%20Isle/256/257/23

Wedding chapel..

New reception area..

Zoree Jupiter Live 2-3:00pm Club Fire Gentle Fire Grid Semi Casual attire hop://gentlefire.opensim.fun:8002/gentlefire.opensim.fun%3...

OOOOLALA coming soon SURFS UP! Credit goes to Lilly Sparks...

📝 Blue Sand ... Who Knew? Terrain Testers and palettes for your sim as well.

Blue Sand ... Who Knew? telegra.ph

Coming up : Players club will present NEW from SL , DJ TOM at so this week please stop by, LIMO : hop://grid.wolfterritories.org:8002/Infinity%2021/363/166/...

Victorian Gazebo hop://astralia.eu:8002/TierraDeVolcanes/31/458/3226

JOLI set hop://astralia.eu:8002/TierraDeVolcanes/35/356/3225

Embrace nature's elegance with this exquisite sunflower ring. This is just one of the many jewelry pieces you will find at Monentes Jewelry. three.hills.grid.outworldz.net:8002:Monentes Jewelry

These are three of my avatars just dancing' the night away on my Magical Fairies Pass 2 Fantasy region! ;) So much fun adding to these OAR builds ;)

Comments

OpenSimWorld^✔ @opensimworld

Harmony Isle Events:Dj KrisTina
Starting Now Till 8pm Grid-Time
Classic Rock Night
Taxi: hop://hg.osgrid.org:80/Harmony%20Isle/256/257/23

Zoree Jupiter Live
2-3:00pm
Club Fire
Gentle Fire Grid
Semi Casual attire
hop://gentlefire.opensim.fun:8002/gentlefire.opensim.fun%3...

These are three of my avatars just dancing' the night away on my Magical Fairies Pass 2 Fantasy region! ;)
So much fun adding to these OAR builds ;)