Talk:Random AV Profile Projector

Random Profile Projector ~ Help Page

What does it do?

The Random Profile Projector randomly selects an AV from a crowd & then displays their profile picture as texture on a prim and/or a 'holographic' image projected above the prim

How does it do it?

A profile picture is a publically available piece of data which can be searched for. See http://forums.secondlife.com/showthread.php?t=225460 for a full technical discussion.

To set-up the Random Profile Projector

If you are only intending to project the ‘holographic’ image, and not texture the prim, then it is not particularly important how the prim is built. However, a 0.25 x 0.25 x 0.25 sphere, textured blank, coloured dark-gray and shininess set to 'High' will work well. You can also put it in some object you wear.

If you are intending to texture the prim with the profile picture then keep the prim shape as a cube. Set shininess to ‘None’.

Put the Random Profile Projector script into the ‘Contents’ of the prim.

To configure and customise the Random Profile Projector

There are a number of parameters in the script that you can change to determine how the Random Profile Projector will operate.

General Settings

OwnerChannel: by default this parameter is set to “54321”. It is the listen channel which the Owner will use to communicate ‘Exclude List’ information on. You can set it to any whole number, but avoid “0”, “1” and other commonly used channels. See section 'Understanding OwnerChannel, 'OpenListen' and 'CloseListen below for further details.

DialogTimeOut: by default this parameter is set to “20.00” seconds. It is the amount of time that the user has to make a selection from the blue dialog menu before the listen shuts down.

RepeatTime: by default this parameter is set to “35.00” seconds. It is the amount of time between each sweep to find a new AV

Range: by default this parameter is set to “25.00” meters. It is the distance from the prim that the sweep will be made.

TotalNoScansAllowed: by default this parameter is set to “20”. It controls the number of times that a sweep is made without finding anyone within ‘Range’. For example, if ‘RepeatTime’ is set to “35.00” seconds and TotalNoScansAllowed is set to “20”, then the Random Profile Projector will automatically switch itself off after 700 seconds (35.00 x 20) if it does not find anyone. However, if you set this parameter to zero “0” this functionality is disabled and the Random Profile Projector will continue to operate until turned off by the Owner.

DefaultTexturePalette: this is a “palette”of texture UUID’s. One of the UUID’s from this list will be randomly displayed if an AV is selected who does not have a profile picture. It is also the selection list used if ‘EmployDefaultTexture’ is set to ‘TRUE’.

EmployDefaultTexture: by default this parameter is set to “TRUE”. It controls whether one of texture UUID’s listed in ‘DefaultTexturePalette’ will be displayed when the Random Profile Projector is switched OFF. “TRUE” employs a default texture when switched OFF; “FALSE” will prevent a default texture from being employed.

Particle Settings

DisplayBanner: by default this parameter is set to “TRUE”. It controls whether the ‘holographic’ image of the profile picture will be projected. Set to “FALSE” to prevent this projection.

Size: This parameter only has an effect if “DisplayBanner = TRUE”. By default it is set to “2.50”. It controls the width in meters of the projected image. The maximum size of the projected image is 4.0m x 4.0m

Height: This parameter only has an effect if “DisplayBanner = TRUE”. By default it is set to “2.50”. It controls the distance above the prim in meters that the centre of the projected image will appear.

Prim Settings

TexturePrim: by default this parameter is set to “TRUE”. It controls whether the prim will be textured with the profile picture. “TRUE” will texture the prim with the profile picture; “FALSE” will prevent the prim from being textured.

PrimUUIDTexture: This parameter only has an effect if “TexturePrim = FALSE” and “EmployDefaultTexture = FALSE”. It is the UUID of the texture to be applied to the prim when the Random Profile Projector is switched OFF.

PrimFullBright: This parameter only has an effect if “TexturePrim = FALSE” and “EmployDefaultTexture = FALSE”. It controls whether the prim will be Full Bright when the Random Profile Projector is switched OFF. “TRUE” applies Full Bright; “FALSE” switches Full Bright off.

PrimColour: This parameter only has an effect if “TexturePrim = FALSE” and “EmployDefaultTexture = FALSE”. It is the colour vector to apply to the prim when the Random Profile Projector is switched OFF.

PrimAlpha: This parameter only has an effect if “TexturePrim = FALSE” and “EmployDefaultTexture = FALSE”. It controls the degree of alpha to be applied to the prim the Random Profile Projector is switched OFF.

ShoutOut Parameters

ShoutOut: by default this parameter is set to “TRUE”. It controls whether a ‘ShoutOut’ will be given to the AV whose profile picture has been randomly selected. “TRUE” to give a ‘ShoutOut’; “FALSE” to prevent a ‘ShoutOut’

ShoutOutText: This parameter only has an effect if “ShoutOut = TRUE”. By default it is set to “’s face is up in lights!”. The text that will be shouted out to the AV whose profile picture has been randomly selected. The ShoutOutText’ will be preceded by their name, for example “Joe Smith’s name is up in lights!”

To operate the Random Profile Projector

Owner Only

General Usage

• To switch ON: ‘Touch’ the Random Profile Projector prim and select ‘On’ from the blue dialog menu.
• To switch OFF: ‘Touch’ the Random Profile Projector prim and select ‘Off’ from the blue dialog menu.

Understanding OwnerChannel, 'OpenListen' and 'CloseListen'

The Owner communicates with the Random Profile Projector using a combination of a blue dialog menu and typing in room chat. Communications from room chat to the Random Profile Projector are performed on the channel defined in parameter 'OwnerChannel'. By default this is "54321". However, unlike most similar devices that have room chat communications with their Owner, the Random Profile Projector requires that you first activate the listen channel. This is done by selecting 'OpenListen' from the blue dialog menu. Once the listen channel is open, the Random Profile Projector will listen for the Owner on the channel defined in parameter 'OwnerChannel'. This listen channel will remain open until the Owner selects 'CloseListen' from the blue dialog box, or switches the toy off. This ensures that the listen channel is only open as and when it is needed, and thus, in this small way, contributes to a healthier environment for us all.

The Random Profile Projector listens for the Owner to make the following commands (assuming the default of "54321"):

1. /54321Exclude <AV_NAME> // add a named AV to the 'Exclude List'
2. /54321Include <AV_NAME> // removes a named AV from the 'Exclude List'
3. /54321List // lists all entries on the 'Exclude List'
4. /54321ClearAll // clears the 'Exclude List' of all entries.

See section 'Specific Tasks' below for further details.

Specific Tasks

To add someone to the ‘Exclude List’:

1. ‘Touch’ the Random Profile Projector prim and select ‘OpenListen’ from the blue dialog menu. This will open a Owner Only listen on the channel number set in parameter “OwnerChannel”.
2. In room chat, type: “/<OwnerChannel>Exclude <AV_NAME>”. For example, “/54321Exclude Joe Smith” (without the quotes)
3. You will receive a confirmation message that the AV name has been added to the ‘Exclude List’
4. ‘Touch’ the Random Profile Projector prim and select ‘CloseListen’ from the blue dialog menu. This will close the Owner Only listen on the channel number set in parameter “OwnerChannel”.

To remove someone from the ‘Exclude List’:

1. ‘Touch’ the Random Profile Projector prim and select ‘OpenListen’ from the blue dialog menu. This will open a Owner Only listen on the channel number set in parameter “OwnerChannel”.
2. In room chat, type: “/<OwnerChannel>Include <AV_NAME>”. For example, “/54321Include Joe Smith” (without the quotes)
3. You will receive a confirmation message that the AV name has been removed from the ‘Exclude List’
4. ‘Touch’ the Random Profile Projector prim and select ‘CloseListen’ from the blue dialog menu. This will close the Owner Only listen on the channel number set in parameter “OwnerChannel”.

To see who is listed in the ‘Exclude List’:

1. ‘Touch’ the Random Profile Projector prim and select ‘OpenListen’ from the blue dialog menu. This will open a Owner Only listen on the channel number set in parameter “OwnerChannel”.
2. In room chat, type: “/<OwnerChannel>List". For example, “/54321List” (without the quotes)
3. You will be presented with the names currently on the ‘Exclude List’
4. ‘Touch’ the Random Profile Projector prim and select ‘CloseListen’ from the blue dialog menu. This will close the Owner Only listen on the channel number set in parameter “OwnerChannel”.

To clear the ‘Exclude List’ of all entries:

1. ‘Touch’ the Random Profile Projector prim and select ‘OpenListen’ from the blue dialog menu. This will open a Owner Only listen on the channel number set in parameter “OwnerChannel”.
2. In room chat, type: “/<OwnerChannel>ClearAll". For example, “/54321ClearAll” (without the quotes)
3. You will receive confirmation that the receive list has been cleared
4. ‘Touch’ the Random Profile Projector prim and select ‘CloseListen’ from the blue dialog menu. This will close the Owner Only listen on the channel number set in parameter “OwnerChannel”.

Other Users

• A user can choose to be added to the ‘Exclude List’ by touching the Random Profile Projector prim and selecting ‘ExcludeMe’ from the blue dialog menu.
• A user can remove their name from the ‘Exclude List’ by touching the Random Profile Projector prim and selecting ‘IncludeMe’ from the blue dialog menu.

All Users

• Selecting ‘LearnMore’ from the blue dialog menu will present a link to the SL forum thread about the Random Profile Projector.
• Selecting ‘GetScript’ from the blue dialog menu will present a link to the latest version of the Random Profile Projector’s script.
• For Help: ‘Touch’ the Random Profile Projector prim and select ‘Help’ from the blue dialog menu. This will link you to the Random Profile Projector Help page.

Frequently Asked Questions

Q: "I'm not sure how to set up the Random Profile Projector. Where can I ask some questions and get some help?" A: Post your question/comment on this SL forum thread: http://forums.secondlife.com/showthread.php?t=225692 There are people there more than able and willing to help :)

Q: "Can I sell it in my store?" A: See section 'Usage Caveats' below. This script is free to use and modify as you wish on condition that the title and introduction remain in place within the script, and that due credit continues to be given to Moriash Moreau, Jana Kamachi and Solar Alter, and Debbie Trilling.

Q: "It isn't showing a picture of me. Why?" A: Ensure that you have a picture loaded into your profile, and the 'Show in search' option on the '2nd Life' tab of your profile is unchecked.

Q: "Why is it displaying my old profile picture?" A: There appears to be a delay before the database is updated. Please try later, this may be a few days.

Q: "It doesn't display my profile picture at all, and I have not changed it recently" A:

1. Ensure that the 'Show in search' option on the '2nd Life' tab of your profile is unchecked.
2. On rare occasions, even though a picture is loaded into the profile, and hasn't recently been changed, no UUID is returned from the database. Please try later, this may be a few days.

Q: "Is it possible to have more than one default texture?" A: Yes, multiple textures can be listed in parameter 'DefaultTexturePalette'.

Q: "Is it possible to apply the profile picture as a texture onto a prim?" A: Yes. Ensure that parameter 'TexturePrim' is set to "TRUE".

Q:"I am not comfortable with my profile picture being displayed publically. Can it be stopped?" A: Yes.

1. 'Touch' the Random Profile Projector prim and select 'ExcludeMe' from the blue dialog menu to be added to the 'Exclude List'.
2. The Owner of the Random Profile Projector can add you to the 'Exclude List'

Q: "Actually, it really is not that bad at all, and is kinda fun. Can I remove my name from the 'Exclude List'?" A: Yes

1. 'Touch' the Random Profile Projector prim and select 'IncludeMe' from the blue dialog menu to be removed from the 'Exclude List'.
2. The Owner of the Random Profile Projector can remove you from the 'Exclude List'

Q: "Where can I get a copy of the script?" A:

1. 'Touch' the Random Profile Projector prim and select 'GetScript' from the blue dialog menu.
2. http://wiki.secondlife.com/wiki/Random_AV_Profile_Projector

Q: "Where can I learn more about the Random Profile Projector?" A:

1. 'Touch' the Random Profile Projector prim and select 'LearnMore' from the blue dialog menu.
2. http://forums.secondlife.com/showthread.php?t=225692
3. http://forums.secondlife.com/showthread.php?t=225460

Revision History

• 5.3 dated 12/01/2008:
  1. Dialog control for Owner
  2. Add dedicated 'OwnerChannel' for Owner communications
  3. Owner can 'OpenChannel' on a defined listen channel
  4. Owner can add to 'Exclude List'
  5. Owner can remove from 'Exclude List'
  6. Owner can view a list of all entries on the 'Exclude List'
  7. Owner can clear the 'Exclude List' entirely
  8. Owner can 'CloseChannel'
  9. Owner can 'LearnMore'
  10. Owner can 'GetScript'
  11. Link to 'Help' page added for all users
  12. Floating text added
  13. Rationalise comments and some parameter names
  14. Rationalise ListenRemoves
  15. Rationalise Startup() procedure

• 5.2 dated 11/01/2008: Code optimisation suggested by Void Singer. "change KillJoyListing = KillJoyListing + llKey2Name(DetectedUser); to KillJoyListing = (list)llKey2Name(DetectedUser) + llList2List( KillJoyListing, 0, 48 );"

• 5.1 dated 11/01/2008: Dialog box presented to user gives options to:
  1. 'LearnMore' ~ provides link to SL forum thread http://forums.secondlife.com/showthread.php?t=225692
  2. 'GetScript' ~ provides link to http://wiki.secondlife.com/wiki/User:Debbie_Trilling
  3. 'ExcludeMe' ~ adds the user to the 'Exclude List'
  4. 'IncludeMe' ~ removes the user from the 'Exclude List'

• 5.0 dated 05/01/2008:
  1. Ability to project the profile picture and/or apply the profile picture as a texture to the prim
  2. Ability for the user to set texture, colour, full bright and alpha preferences to the prim when it is turned OFF or if not texturing the prim with the profile picture

• 4.0 dated 05/01/2008:
  1. Accomodates a random choice of different default textures
  2. Code optimisation

• 3.3 dated 05/01/2008: If an AV is selected two times in a row, rather than displaying their profile picture again, display the default texture

• 3.2 dated 03/01/2008: When no one is detected within range, and the toy is not set to shutdown, project the default texture rather than continuing to display the last randomly selected profile picture

• 3.1 dated 20/12/2007: Correction to how the 8:5 format is handled

• 3.0 dated 14/12/2007:
  1. Displays image in 8:5 format which seems to suit most profile pictures better
  2. Automatically names the prim that the script is in, to avoid 'ShoutOuts' being prefixed with 'Object:'
  3. More effcient communications with Owner
  4. Product information for Owner
  5. Delivers URL to SL forum thread http://forums.secondlife.com/showthread.php?t=225692

• 2.0 dated 26/11/2007:
  1. Handling for when selected AV does not have a profile picture
  2. Function GiveShoutOut() added in such a way as to allow future easy development for gift-giving etc from 'Contents'
  3. Ability to set own default texture for display
  4. Ability to give a 'shout out' in the name of the person
  5. Ability to set what the 'shout out' text will be
  6. Ability to set how long the toy will operate before it switches itself off if no AV's are detected. Also ability to disable auto-off function
  7. Ability to project the default texture when the toy is switched off

• 1.0 dated 25/11/2007: Initial release

Innovative Variations

A modification of v5 is available as a large-size 'Welcome Board'.

As well as allowing multiple default textures for promotion purposes, when an AV is selected, it will display their profile picture on the Big Board and 'ShoutOut' a welcome. Not only that, it will then target that AV with a lil cute particle stream of their profile picture. Great fun; very effective.

A 'Free to Copy', full perms 'Welcome Board' modification of version 5 can be obtained from "SploLand - the Museum of Science, Art and Human Imperfection" at:

[url]http://slurl.com/secondlife/SploLand/181/76/24/[/url]

While there, you could also pick up a 'Free to Copy' version of the Flag & Pole

Usage Caveats

Free to use and modify as you wish but only under the condition that the title and introduction remain in place, and that due credit continues to be given to Moriash Moreau, Jana Kamachi and Solar Alter, and Debbie Trilling.