Primp! - Prim Configuration Script (boxed)

Primp! - Restless Studio Prim Configuration Script.
Dialog menus to configure a prim's textures, size, transparency,
position, glow, brightness, type, opacity, and phantom.

Introduction
============

I originally developed this script to cycle thru several textures for use
in land screens. It quickly evolved into a general purpose prim configuration
tool and can be used for a wide variety of prim deployments.

The script presents over two dozen menus allowing you to interactively
configure the prim in which it resides. Dialog menus are available for
the configuration of prim properties including size, brightness, phantom,
position, type, glow, opacity, shininess, bump map, color, flexible, wind,
tension, force, softness, gravity, friction, material, hole type, hollow
percent, and detection of prim face numbers.

The prim can be configured to present a slide show of all the textures
with a specified delay between slides. Freely usable and redistributable
textures from the Wikimedia Commons are provided and can be used to texture
the prim faces. In addition, prim faces can be selectively textured as
transparent or the opacity of faces can be adjusted to make them
semi-transparent.

If the user has appropriate permissions the prim can be textured with the
parcel media texture thereby allowing the prim to be used as a media viewer
on the parcel property. See below for further instructions on how to configure
a prim as a media viewer on group owned land.

Only texture UUID's are used so no textures need to be loaded into the prim's
contents. You can configure your own textures by replacing those included
in the Configuration notecard with names and UUID's of any textures you wish.
See the section on the Configuration notecard below for specific instructions.

Setup
=====

In order to use the Primp! configuration script it must be placed in the
contents of a prim. To do so, right click the prim, choose edit, and click
the Contents tab. Drag the Primp! configuration script into the prim contents
tab and optionally the Configuration notecard. Note, you should not need
the Configuration notecard unless you with to modify the textures used or
run several prim configurations on the same channel. After dropping the
Primp! configuration script into the prim contents and while the edit window
is still open recompile the script in Mono as follows:

Second Life & Emerald Viewers
-----------------------------
Click the Tools menu entry at the top of the Second Life window.
From the drop-down menu select "Recompile Scripts in Selection" and
click on "Mono".

Second Life Viewer 2
--------------------
Click the Build menu entry at the top of the Second Life Viewer 2 window.
From the drop-down menu select "Scripts" and "Recompile Scripts (Mono)".

Once the script has been recompiled, close the recompile and edit windows.
Wait a few seconds while the script initializes. After the script indicates
initialization is complete, click on the prim.

You should be presented with the main Primp! configuration menu.

Configuration as a Media Screen
===============================

Clicking "Media" on the main Primp! configuration menu will texture the
active face(s) of the prim with the parcel media texture if you have
appropriate permissions on that parcel. Typically this is the parcel
owner. On group owned land the object must be deeded to the group in
order to use the parcel media texture. To do so, the object must first
be in the same group that owns the land and you must be a member of
that group with deed permission. To deed the object to the land group:

- Right click on the parcel of land and choose About Land to find
the name of the group that owns the land. You must be a member of
this group, and you must also be in a role that has permissions to
deed items to that group.

- Once you have determined the land group, make sure you are Active
(wearing the group tag) in that group. Edit the object and make sure
that the group is set to the correct group. If not, change the group
by clicking the Set button in the General tab.

- After you have the group set correctly, check the "Share with group"
box then click the deed button.

- Once the object has been deeded to the group and with that group
as your active group, right click the Configuration notecard in
the Contents tab of the edit window of the prim. Choose properties
and check the Share with group checkbox then close the properties
window. Do the same for the Primp! configuration script.

View the PDF manual for full doc.