[.Shuggles.] Book Script FULL PERM Version 0.56

The Book script flips the pages of a book or card on touch - from the first to the last
page and also backwards when you click on the already open pages. It contains a rotation
drift workaround, so that your pages remain in the same place. The book is usable by
everyone by default, but can be configured to be usable only for its group, the owner's
friends or just the owner, too. The script assumes the root prim of the book is its spine
and there's one prim for each page. You can have as many pages as you want. With just two
pages, you can create a card for season greetings, invitations, congratulations etc. The
package contains three example books.

To create your own book, make the spine of the book the root prim and put the script in
there. Then add your pages and name each of them according to their page number, e.g. "1"
for the first page, "2" for the second page and so on (without the quotes). Link them all
together with the spine and you have a working book. The pages all need to be oriented
the same, so it's best to create one and duplicate the others.

You can configure the flip axis and the offset of the pages center to the book's back
(the root prim) manually or let the script try to determine them automatically. For
automatic detection, set AXIS and OFFSETS to ZERO_VECTOR; if that doesn't work, please
configure them manually: AXIS usually should be <0, 0, 1> (standing upright), unless you
rotated the book's back; OFFSETS should have 0.5 or -0.5 as one coordinate (i.e. half the
page size), depending on page orientation, and the others have to be 0.0. You can also
adjust the OPEN_ANGLE of the book (in degrees) and whether it should OPEN_BOTH_SIDES or
only the front side.

If you want to use flexiprims for the pages, they need to rotate around their back in
order to swing in the right direction, so pages need to be rotated by 90° in Y direction,
and gravity (left column in the edit dialog) needs to be set to 0 - please see provided
Book Example 3. For how to attach a book as a HUD or create thinner pages, please see
Book Example 4, after an example provided by Remitent Curameyer - thanks a lot for that!
The required configs for both are included in the script (commented out).

You can also configure a sound and sound volume that is played when flipping pages. The
sound is preloaded when the book is rezzed, but if you want to keep it rezzed for others
to use, you might want to consider adding the Sound Preloader script which I also offer,
to preload sounds for nearby avatars.

It's also possible to attach the book and configure a holding animation. It must be in
the object's inventory or an SL internal animation. If empty, the first animation in
inventory is used. Default is "hold_r_handgun" which is an internal animation.

On first touch after the book or card was rezzed, it can optionally give a folder with
its contents (without scripts and the optional page flipping sound). So you can include
a landmark or notecard or a little gift which can be useful in an invitation or card.
This only works for the owner.

The Book script is full perm, so it can be adapted to your needs and requirements. It's
licensed under the BSD license with the addition that it must not be resold or otherwise
given away standalone in parts or as whole. It can be used in your creations as long as
these license conditions are met.
Please use the original scripts, keeping script name and creator intact, and remember to
change script permissions to copy or transfer only before you put your products on sale.

To update or redeliver a product, wear the included Updater and follow the instructions.
Store policies and info about custom scripting at my MP store and the inworld terminals.

• Flips arbitrary number of pages
• First to last page and last to first
• Rotation drift workaround
• Low lag, operated on touch
• Full perm, BSD license