[:AT:] Truck Turn Table Version 1.0

AT Truck Turn Table, for turning around large vehicles easily without needing to manuver with them around!
Inspired by real life truck turn tables that exist

******Setup guide*****
**********************
Open the build menu with CTRL B, select the editing tab in the build window, Rez the coalesced object called AT Truck Turn Table from the contents.
Do so this way, so both of the objects get selected as it gets rezzed. Position the turn table where it's needed to be used.
*IMPORTANT* Always keep the turn table flat, on flat ground, use it only when flat, you may rotate it on the Z axis to face it wherever its needed!

Once positioned, you can rotate the turn table itself to an initial home rotation, this will be kept by the script until the scripts are reset in it, on reset it goes to zero rotation.

You may resize the turn table however you like, keep in mind there are vehicle pusher prims set invisible inside at the center of the turn table!

You can retexture the road surface around the turn table however, keep in mind it has materials (normal and specular map) that you will have to change as well!

Use the notecard name in the contents of the turn table to set up the behavior of the turn table

The script will ignore the contents of this notecard.
The script reads the NAME of this notecard by the following format:
config,angle,speed,clockwise,apichannel

angle defines the interval of angles to stop by, it has to be a decimal value between 0 and 360
speed defines how quickly the platform is rotating, defined in rotations per minute, it is a decimal value, and it must not be zero or negative number!
clockwise defines to spin clockwise (1) or counter clockwise (0)
apichannel defines what chat listener number it will accept (advanced users)

Example default: config,180.1,0,1,2100

The moment you change the notecard name it will update to the new values

An example for the angle setting, If you want four stops on your turn table, set the angle to 90 degrees, it will rotate the vehicle at right angles,
two stops would be 180 degrees, which will rotate the vehicle facing opposite of initial rotation.

An example for speed is if its set to 1 rotation per minute, it will take 60 seconds for the platform to make a full rotation, so if angle is 180 degrees, it will take 30 seconds to rotate 180 degrees. Smaller number mean slower speed, 0.5RPM would be how fast the real life version would be rotating, the default is twice that in SL.

*****Using the turn table*****
***************************

Park your vehicle on the turn table, turn off the engine, leave it physical! The turn table will only rotate physical objects! Non-physical will just stay where it was!

For example with GEMC vehicles and Lusch trucks/vehicles, and HD Fire trucks, you can achieve the desired effect by turning off the engine, but not applying in the handbrake, so the vehicle is turned off, but still physical due to the handbrake not being applied.

The vehicle can now be safely rotated, by clicking the turn table!

*****API****
************

There is a script API for making your own tools and gadgets that would interact with the turn table!
Heres the following commands it takes on the command channel which is configurable by the notecard name in the contents (see above)

rotateplatform ------ this will be equivalent of a valid click on the turn table, except it will also rotate if there is no one occupying the turn table!
softreset ------------ this will reset the turn table to the initial state, cancelling all ongoing movement, and sets the home rotation
!reset ---------------- this will reset the script entirely, cancelling all ongoing movement, and force it back to zero rotation
rotateoverride ------ See details bellow

rotateoverride,<angle>,<speed>,<clockwise> ---- Rotates the platform with override values specified, similar to the setup notecard (see above)
example command: llSay(apichannel,"rotateoverride, 90, 0.5, 0"); //rotates the platform 90 degrees, at 0.5RPM counter clockwise