Grid status
| grid status: | on line |
| AV on line: | 1 |
| last week: | 4 |
| avatars: | 42 |
| HG visitors: | 2.847 |
| regions: | 9 |
Boat tour 2.00 os
tl-boat-tour-200os [tlBT from now] move a water vehicle along a configured route. You can set route's steps manually (editing a notecard) or automatically (using the route recorder).
The tour will end in same position where it began.
tlBT make use of osFunctions to read and save parameters to notecard, you can use it
only in regions where those functions are anabled; to know how to enable osFunction in your simulator, please refer to opensimulator manual.
tlBT it's freebie, full perm and u can find it inworld at:
hg uri: endivatomic.eu:8002:zamunda
coords: 234, 42, 25
SETUP & FIRST TEST
When your boat it is ready, rez it in an open sea area with at least 10 mt of space around it. Be careful, tlBT use physics and can't cross region's border; even worse: if your boat will cross border, unpredictable results could happen, like to find your ship at 1000 mt in the sky or to the other side of the region.
As you can see on left picture, tlBT it's a little prim with an arrow showing direction. We suggest you to link tlBT at bottom of your boat, more or less in the center (see picture below). You must link it as root prim (link number 1).
First time you rez tlBT, it will create a notecard called "param.config" with all default parameters set and with a route following a square of 5 mt around the point where you rez it.
That's all: to test if the script it's working properly, click on your boat and on menu select "activare" then "start". You will see your boat traveling around making a square and then back to original position. If something goes wrong, click again on boat then "stop".
PRAMETERS (param.config notecard)
Most of the parameters are automatically set and saved using owner's menu.
| param | type [default] | description |
|---|---|---|
| startPos | vector [rez position] | position where the boat reside when it's not travelling |
| startRot | rotation [rez rotation] | rotation of the boat when it's not travelling |
| hoverWater | float [0.0] | heigh of the tlBT prim to water level |
| speedH | float [3.0] | horizzontal speed |
| speedV | float [0.5] | vertical speed (usually set to 0.5 to avoid the boat will fall in water on long distances between targets points) |
| pushTime | float [0.3] | time between engine push (do not change it) |
| targetRange | float [1.0] | radius around target coords to consider boat at target, do not make it too small nor too large) |
| debug | integer [1] | if set to 1 enable debug messages (visible only by boat's owner) |
| users | integer [1] | if set to 1, all users can start the boat tour just clicking on boat. |
| goto | vector [-] | target position (Z will be ignored, set it to 0). you can/must set several "goto=<xx,xx,xx>" to build the route for the boat. |
NOTE:
- Do not set sequential goto=<x,x,x> too close, at least 3 times the value of targetRange.
- Do not set points too close to region border, at least 2/3 mt far away.
- Do not set first goto point too close to startPos and in opposite direction from startRot or your boat will go underwater trying to get the right direction.
- Check well the tour the boat will do, special the ground level underwater and obstacle it will encounter. Remember that tlBT it's based on phisics and crashing against an obstacle can make it change it's route to umpredicable direction. Even underwater obstacle that could touch your boat can have same effects.
HOW TO WRITE ROUTE (goto=<x,x,x>)
Packaged with tlBT you will find the tl-HUD-tour-recorder, wearing it you can set the route for your boat in an easy way and transmit it to your boat without have to copy/paste any data.
To know how to use it read the related article at HUD-tour-recorder.
If you prefer to set it manually, just edit the notecard param.config in your boat and add several goto=<x,x,x> params as you want. Example:
startPos=<100,100,0>
goto=<105,105,0>
goto=<95,105,0>
goto=<95,95,0>
goto=<105,95,0>
will force your boat to make a square of 5 mt around the point <100,100,0>.
OWNER MENU
When owner click the boat the menu on left picture will appear.
Same of the buttons will change their contents dependig on boat status.
See the table below for detailed list of functions.
| Start/Stop | Start / Stop the tour. When tour it is stopped the boat came back to original position. |
| Activate/Deactivate | Enable/disable boat tour, when boat is disable no one can start a tour. |
| User ON/OFF | When boat has User OFF, it will not respond to user touch (users can't start tour). To have UserOFF could be useful to avoid user touches on boat and to set an additional prim on boat to start/stop the tour. |
| Debug ON/OFF | When ON the owner will receive several deboug messages about boat and tour status. |
| Set Position | Automatically set actual position and rotation as starting point. |
| GetHUDdata | Download route from HUD tour recorder |
| GetChannel | Show on console the active channel number (useful to make interactive scripts) |
| Load Param | Reload parameters from notecard (param.config) |
| Show Param | Print parameters to owner's console |
| Store Param | Save actual parameters to notecard (param.config) |
NOTE:
We experienced some delay when pushing "Store Param": parameters are saved fast and they work correctly, but if you open the notecard it is possible you will see it empty or compiled with old parameters. When you use "store param" please wait a bit before to edit param.config manually.