Wednesday, May 20, 2015

Script: Washbasin AVsitter Plugin - Full Edition

[Black Tulip] Washbasin - FULL - AVsitter Plugin (Script for Designers)

(c) 2015 Auryn Beorn

Washbasin AVsitter Plugin full edition script in Marketplace.

Thank you for having considered this script to enhance the quality of your products. Please read the following instructions carefully, especially the ones explaining which permissions to apply to the scripts for the next owner. Failure to complete this task INVALIDATES the license governing your use of this set of scripts. Should you have problems, please fill the scripts assistance form, explaining what you did and what happened, and I'll get back to you.

IMPORTANT!
The script contains a check to prevent accidental give-aways. If you haven't set permissions correctly in your inventory, then the script will self delete when you try to use it. The best way to ensure you set permissions correctly is by doing it NOW in your inventory.

TABLE OF CONTENTS



FEATURES


  • Water functions start/stop when an avatar sits/stands up from the object
  • You may have several prims with animated textures, each one having its own animation settings: There are two groups, for the script. Still water, and flowing water. The relevance is explained in the setup section.
  • You may also have several prims with one particles effect: it will be the same effect in all particles prims
  • Menu shows as an option under the AVsitter menu
  • Turn on/off the animated water texture, and particle effects when the user is sitting on the object - You can turn them on/off independently
  • Define up to nine sounds that the final user can select via menu
  • Change the sound volume via menu
  • Go back to AVsitter's menu from the script's menu
  • Add up to THREE buttons to call other scripts
  • Menu timeout to reduce lag - no open listeners after timeout (0.001 ms script time when idle)
  • Final user can change access to owner only/everybody/group
  • Menu can be integrated into AVsitter & AVsitter 2 (It work under other systems, but please check notes)


STEP-BY-STEP SET UP: WHAT SCRIPT TO USE?


There is one copy/no modify/transfer script contained in your folder, that will work together with any AVsitter system that you may have installed:

[Black Tulip] Washbasin - FULL - AVsitter Plugin

(The other script is just a sample to try out a feature - nothing that you would eventually use in a finished product.)


SETUP: CHANGE PERMISSIONS FOR NEXT OWNER


Check the following section on this page, knowing that each [Black Tulip] ASSET refers to the following script:

[Black Tulip] Washbasin - FULL - AVsitter Plugin


STEP-BY-STEP SETUP: CHANGE THE PRIMS' DESCRIPTION


There are a few sample objects ready to help understand the stages to setup our object. Let's begin by rezzing the [Black Tulip] Washbasin - UNSCRIPTED SAMPLE object, and inspect it. It's made of three prims, their names being:

[Black Tulip] Washbasin - UNSCRIPTED SAMPLE
Cylinder for flowing water
box for particles splash

The first prim listed is the root (a mesh washbasin), the second listed prim is a regular SL-Cylinder, with some taper, and the third prim is just a box, for the particles effect.


There are three prims because the animated water effect will consist in static water on the sink, plus the water falling from the faucet, and then we have the particles prim. We cannot have two different animated water effects in the same prim, so we need the secondary prim, the cylinder, for this. We could use the slice end property of the cylinders to get a cylinder that serves us both as particles source and prim for animated texture: think about how as a building exercise. To keep things simple, we're using a separate prim for particles.

For now, we'll just change the descriptions of the prims to something we'll say here. Once you've completed setting up the sample, please check the ANIMATED TEXTURE OPTIONS, IN DETAIL section, for details on the descriptions format.

Change the description of the root prim to:

wStill;3;4;4;10;2;0.6


the description of the cylinder prim to:

wFlow;19;0;0;0.25;1;0.4


and the description of the particles prim to:

particles


Got them?

Perfect. Now you can add AVsitter and some animations, and the following line in the AVpos notecard:

BUTTON [WASHBASIN]|-28640987

Or you can rez the next sample object, [Black Tulip] Washbasin FULL - UNSCRIPTED SAMPLE/AVsitter in, which already has AVsitter installed, with a couple of sample poses and the AVpos notecard. We will continue by using this object.


STEP-BY-STEP SETUP: EDIT THE CONFIGURATION NOTECARD


Apart than turning water and particles on/off, the script also allows to select one sound to play among several. The first one defined in the configuration notecard will be the sound to be played when the script resets. After that, final users can change this from the menu.

All this means that you have to define somewhere which sound options exist. We do this in the [Black Tulip] Washbasin - FULL - AVsitter Plugin ~CFG~ notecard. Open the notecard included with your package, which should look like this as you open it:


(There's more text when you scroll down, but the one showing is relevant.)

Pay attention to these lines:

sound = Water 1 | [Black Tulip] Water Sounds - Sink #04
sound = Water 2 | [Black Tulip] Water Sounds - Sink #03
sound = Water 3 | [Black Tulip] Water Sounds - Flow #01
sound = Water 4 | [Black Tulip] Water Sounds - Flow #03
sound = Water 5 | [Black Tulip] Water Sounds - Flow #05
sound = Water 6 | [Black Tulip] Water Sounds - Flow #06

These lines define the buttons showing under the Sounds menu of the script. First, the name to show on the menu button, then, the name of the soundclip contained in the same prim where the script is. The exact format, together with all the options that can be set up in the notecard (like the extra buttons), is explained in the THE CONFIGURATION NOTECARD FORMAT, IN DETAIL section.

Below that, you will find all the particles configuration. Ignore it for now: it is also explained in the THE CONFIGURATION NOTECARD FORMAT, IN DETAIL section.

Once we have the [Black Tulip] Washbasin - FULL - AVsitter Plugin ~CFG~ configuration notecard ready, we would drop it in the same prim where AVsitter is, then the soundclips (with permissions correctly adjusted) if we haven't done yet, and finally, the [Black Tulip] Washbasin - FULL - AVsitter Plugin script.

There's a finished [Black Tulip] Washbasin FULL - SCRIPTED sample object included, with all the configuration completed. You may want to check out this one if something along this process came out differently to you.

In the next sections, we discuss more details and advanced options, but with this step-by-step guide, you should have the basics to start setting up your own objects, now.


SETUP: ANIMATED TEXTURE OPTIONS, IN DETAIL






SETUP: THE CONFIGURATION NOTECARD FORMAT, IN DETAIL






SETUP: THE MAIN SCRIPT, AS A MODULE YOU CAN USE FROM ANOTHER SCRIPT


Although this script is designed with AVsitter in mind, because the [*To AVSit*] button will open up the AVsitter menu, the truth is that you can incorporate this script in any system that allows for linked messages. The [*To AVSit*] button is very specific, but you can open this menu from other scripts, like MLP.

Check the following section on this page, knowing that:

[Black Tulip] ***Script Name*** [MODULE] refers to [Black Tulip] Washbasin - FULL - AVsitter Plugin
CODE_NUMBER is -28640987
NAME_ON_MENU is Washbasin

AVSitter line looks like: BUTTON Washbasin|-28640987
AVSitter 2 line looks like: ADJUST Washbasin|-28640987
MLP line looks like: LINKMSG Washbasin | 1,-4,-28640987,fromMLP

You have example AVpos and .MENUITEMS notecards with your purchase.


TROUBLESHOOTING


Q: I click the particle/animated texture options on the menu, but no visible outcome shows. What's going wrong?

A: Most likely, there's not a particles source/animated textures source defined in the object. Double-check the DESCRIPTION of the prim you expect to be a SL light point/particles source/animated texture.

Q: Particles are still not showing. What happens?

A: Check that you haven't deactivated particles visibility in your viewer.

Q: I hear no sound when I change the volume from the menu. What could be going wrong?

A: Make sure that there's a sound clip on the Content tab of the prim with the script.


For any other problem not described here, please give a complete description of your issue in the following online form.

I'll get back to you after I have read your report and replicated your issue inworld, according to your description of it. Please, be detailed.

-- Auryn Beorn