Second Life Wiki - User contributions [en]

Advanced menu/1.23/1.23

2010-08-13T14:55:17Z

Terris Bezner: /* Object Submenu > */ The "Force Owner to Me" description was just hilariously incorrect.

{{KBwarning|The '''Advanced''' menu and the unique features within it are NOT supported by Linden Lab, because they're intended for technical debugging. You may find the Advanced menu beneficial and we appreciate Residents documenting its use, but '''we do NOT guarantee it to function correctly. USE AT YOUR OWN RISK.'''}}

{{Help|Viewer=*|Glossary=*}}
{{GettingStartedNav}}

This page is part of the ''Resident-contributed, unofficial'' Second Life User's Manual, describing how the Viewer software works. Please see the main [[User's Manual]] page as a starting point.

==What is this menu for?==

The '''Advanced''' menu contains more technical settings than the rest of the Second Life Viewer, which is why they're usually hidden. Some of them are useful, but none of them are essential in order to use any of Second Life's features. If you'd like to enable the '''Advanced''' menu, use the following procedure:

* '''PC''' - {{KeyCombo|ctrl=*|alt=*|D}}
* '''Mac''' - {{KeyCombo|ctrl=*|opt=*|D}}
* '''Linux''' - {{KeyCombo|ctrl=*|alt=*|shift=*|D}}

{{KBnote| In some cases, there may be a shortcut conflict with another application. In which case, hold down {{KeyCombo|ctrl=*|alt=*|shift=*|D}}.}}

Video of how to do it in Viewer 2:

{{KBvideo|LL4g5Iersq4|640|505|type=youtube}}

== More details ==
=== Useful Items for General Users ===

* '''High Res Snapshot''' - doubles pixel size of snapshots saved to disk

* '''Character > Character Tests > Go Away/AFK When Idle''' - disables inactivity timers for showing (Away) (5 minutes), and auto-logout (30 minutes)

* '''Character > [[Rebaking textures|Rebake Textures]]''' - Forces your computer to redo and send your avatar skin + clothing again. Sometimes this does not happen correctly the first time, and other users will see your avatar as a persistent cloud (avatar did not load at all), grey (shape loaded but not textures), or parts look wrong (some textures did not load properly).

* '''Debug Settings''' - Enter "RenderFarClip" to set draw distance to non-standard values. Values below normal 64m minimum are useful to reduce lag. '''Caution:''' randomly changing debug settings can totally mess up your viewer program.

=== All Advanced Menu Items ===

[[File:V1.23 Advanced Menu.jpg|thumb|300px|left]]

==== '''Consoles Submenu >''' ====

Displays fixed windows with technical information about the viewer program:

> '''''Frame Console''''' -

> '''''[[Texture Console]]''''' - Shows progress and status information about textures while they are being fetched or decoded

> '''''Debug Console''''' - Shows a console window that displays technical information about the client's actions as it does them

> '''''[[Fast Timers]]''''' - Shows how much time different tasks that are executed for each frame take

> '''''Notifications Console''''' -

> '''''Region Info to Debug Console''''' -

> '''''Group Info to Debug Console''''' -

> '''''Capabilities Info to Debug Console''''' -

* '''Reload personal setting overrides'''

==== '''HUD Info Submenu >''' ====

Displays fixed overlay on the 3D view with the following choices:

> '''''Velocity''''' - Shows a scale with current avatar velocity in m/s

> '''''Camera''''' - Shows avatar and camera positions in grid coordinates

> '''''Wind''''' - Shows wind speed and direction

> '''''FOV''''' - Shows camera field of view

* '''High-res Snapshot''' - When set, makes a snapshot double the screen size instead of equal to the screen size.
* '''[[Quiet Snapshots to Disk]]''' - When set snapshot sound and animation are not played.
* '''Show Mouselook Crosshairs'''
* '''[[Debug Permissions]]''' - Shows detailed information about object permissions in the edit menu.
* '''Clear Group Cache''' - Clears the cached groupmembers lists.

==== '''Rendering Submenu >''' ====

Controls many aspects of how the graphics card or chip displays the 3D view

> '''''Types''''' > - The items below are displayed when checked

::> > '''''Simple''''' -
::> > '''''Alpha''''' - [[Transparency]]/opacity
::> > '''''Tree''''' - Toggles rendering of [[terrain]] plants.
::> > '''''Character''''' - Toggles rendering of the avatar mesh.
::> > '''''SurfacePatch''''' - [[Ground]]
::> > '''''Sky''''' - Toggles rendering of the sky box.
::> > '''''Water''''' - Toggles rendering of water.
::> > '''''Ground''''' - ''not sure what it renders but disabling it has not effect other than speeding up the client. -spitfire clary''
::> > '''''Volume''''' - [[Prim]]s
::> > '''''Grass''''' - [[Grass]] and other terrain vegetation
::> > '''''Clouds''''' - [[Cloud]]s
::> > '''''Particles''''' - Toggles rendering of [[particles]].
::> > '''''Bump''''' - [[Bumpmapping]]

> '''''Features''''' > -

::> > '''''UI''''' - Toggle rendering of the [[user interface]]. Make sure to remember the key shortcut, as once you disable this the menus will disappear.
::> > '''''Selected''''' -
::> > '''''Highlighted''''' -
::> > '''''Dynamic Textures''''' -
::> > '''''Foot Shadows''''' - Toggles rendering of the small [[shadow]]s that appear at any [[avatar]]'s feet.
::> > '''''Fog''''' - [[Fog]]
::> > '''''Test FRInfo''''' -
::> > '''''Flexible Object''''' - [[Flexible]] objects

> '''''Info Displays''''' > -

::> > '''''Verify ''''' -
::> > '''''BBoxes ''''' - Bounding boxes
::> > '''''Points ''''' - Vertices
::> > '''''Octree ''''' - Occlusion tree
::> > '''''Shadow Frusta ''''' -
::> > '''''Occlusion ''''' - Occlusion planes
::> > '''''Render Batches ''''' -
::> > '''''Animated Textures ''''' -
::> > '''''Texture Priority ''''' -
::> > '''''Avatar Rendering Cost ''''' - Shows a score above each avatar, indicating, how ''expensive'' it is to render. A higher score will lag the viewer more than a low score. Read [[Avatar Rendering Cost]] for more details.
::> > '''''Texture Area (sqrt(A)) ''''' -
::> > '''''Face Area (sqrt(A)) ''''' -
::> > '''''Lights ''''' - [[Light]]s
::> > '''''Particles ''''' - [[Particles]]
::> > '''''Composition ''''' -
::> > '''''Glow ''''' - [[Glow]]
::> > '''''Raycasting ''''' -
::> > '''''Sculpt ''''' - [[Sculpted prim]]s
::> > '''''Vectorize Perf Test''''' -

> '''''Render Tests''''' > -

::> > '''''Camera Offset''''' -
::> > '''''Randomize Framerate''''' -
::> > '''''Periodic Slow Frame''''' -
::> > '''''Frame Test''''' -

> '''''Axes''''' - Render coordinate frame at your position

> '''''Hide Selected''''' - Stops rendering of any selected object.

> '''''Tangent Basis''''' - Render normal and binormal (debugging bump mapping)

> '''''Selected Texture Info''''' - When modify rights are granted, this outputs the texture UUIDs placed on a selected object.

> '''''Wireframe''''' - Shows the world in [[wireframe]] mode.

> '''''Object-Object Occlusion''''' - Skips rendering of objects that are out of view.

> '''''Debug GL''''' - Enable strict GL debugging.

> '''''Debug Pipeline''''' - Enable strict pipeline debugging.

> '''''Fast Alpha''''' - Use lossy alpha rendering optimization (opaque/nonexistent small alpha faces).

> '''''Animate Textures''''' - Enable texture animation (debug)

> '''''Disable Textures''''' -

> '''''Run Multiple Threads''''' > - Improves performance by allowing threads to run in the background while rendering. You should enable this option!

> '''''Cheesy Beacon''''' - Changes the default tracking beacon to an animated "pulsing" beacon.

> '''''Attached Lights''''' - Disables [[attach]]ed lightsources when unticked.

> '''''Attached Particles''''' - Disables attached particle sources when unticked.

==== '''World Submenu >''' ====

* '''''> Sim Sun Override''''' -

* '''''> Dump Scripted Camera''''' -

* '''''> Fixed Weather''''' -

* '''''> Dump Region Object Cache''''' -

==== '''UI Submenu >''' ====

* '''''> Rotate Mini-Map''''' - If is checked ("X") the Mini-Map rotates with the movement of your avatar. If uncheck, the north (N) is always up, the compass don't rotate.

* '''''> Use default system color picker''''' -

* '''''> Show search panel in overlay bar''''' -

* '''''> Web Browser Test''''' -

* '''''> Editable UI''''' -

* '''''> Dump SelectMgr''''' -

* '''''> Dump Inventory''''' -

* '''''> Dump Focus Holder''''' -

* '''''> Print Selected Object Info''''' -

* '''''> Print Agent Info''''' -

* '''''> Memory Stats''''' -

* '''''> Double-Click Auto-Pilot''''' - Torley Linden wrote [[User:Torley Linden/Debug Settings|here]]: ''"Some of you may find it useful for navigation. Set it to TRUE, then anywhere you double-click (with the left mouse button) inworld, you'll automatically walk, run, or fly towards. Our autopilot is kind of flakey, so don't be surprised if this doesn't always work and you get an "Autopilot canceled" message. Nevertheless, a fun novelty."''

* '''''> Debug SelectMgr''''' -

* '''''> Debug Clicks''''' -

* '''''> Debug Views''''' -

* '''''> Show Name Tooltips''''' -

* '''''> Debug Mouse Events''''' -

* '''''> Debug Keys''''' -

* '''''> Debug WindowProc''''' -

* '''''> Debug Text Editor Tips''''' -

* '''''> Show Time''''' -

* '''''> Show Render Info''''' -

* '''''> Matrices''''' -

* '''''> Show Color Under Cursor''''' - Show the RGB color values of the object the cursor is on.

==== '''XUI Submenu >''' ====

* '''''> Floater Test...''''' -

* '''''> Font Test...''''' -

* '''''> Export Menus to XML...''''' -

* '''''> Edit UI...''''' -

* '''''> Load from XML...''''' -

* '''''> Save to XML...''''' -

* '''''> Show XUI Names''''' -

==== '''Character Submenu >''' ====

* '''''> Grab Baked Texture >''''' -

:> > ''''' Iris''''' -

:> > ''''' Head''''' -

:> > ''''' Upper Body''''' -

:> > ''''' Lower Body''''' -

:> > ''''' Skirt''''' -

:> > ''''' Hair''''' -

* '''''> Character Tests >''''' -

:> > ''''' Go Away/AFK When Idle''''' - When checked, this item uses an idle timer to set (away) and auto-logout. It is enabled by default. If you do nothing with keyboard or mouse for 5 minutes, your avatar will show (Away) status, and after 30 minutes will be logged out automatically.

:> > ''''' Appearance to XML''''' -

:> > ''''' Toggle Character Geometry''''' -

:> > ''''' Test Male''''' - Changes the avatar's appearance to a default male avatar.

:> > ''''' Test Female''''' - Changes the avatar's appearance to a default female avatar.

:> > ''''' Toggle PG''''' -

:> > ''''' Allow Select Avatar''''' -

* '''''> Enable Lip Sync (Beta)''''' - Makes your avatar's mouth move in sync with voice chat(?).

* '''''> [[Tap-Tap-Hold To Run]]''''' - When toggled on, pressing the up-arrow key {{Keypress|↑}} twice shortly after another results in running.

* '''''> Force Params to Default''''' -

* '''''> Reload Vertex Shader''''' -

* '''''> Animation Info''''' - Displays currently active animation [[UUID]]s above avatar's heads.

* '''''> Slow Motion Animations''''' -

* '''''> Show Look At''''' - Indicates via crosshairs where agents are focusing their camera(s). It's not distinguishable which crosshair belongs to which agent. See the document about [[Show Look At]].

* '''''> Show Point At''''' - See video tutorial about [[Video Tutorial/See where you're pointing with Show Point At|Show Point At]].

* '''''> Debug Joint Updates''''' -

* '''''> Disable LOD''''' -

* '''''> Debug Character Vis''''' -

* '''''> Show Collision Skeleton''''' -

* '''''> Display Agent Target''''' -

* '''''> Debug Rotation''''' -

* '''''> Dump Attachments''''' -

* '''''> [[Rebaking textures|Rebake Textures]]''''' - Forces your computer to redo and send your avatar skin + clothing again. Sometimes this does not happen correctly the first time, and other users will see your avatar as a persistent cloud (avatar did not load at all), grey (shape loaded but not textures), or parts look wrong (some textures did not load properly).

==== '''Network Submenu >''' ====

* '''''> Enable Message Log''''' -

* '''''> Disable Message Log''''' -

* '''''> Velocity Interpolate Objects''''' -

* '''''> Ping Interpolate Object Positions''''' -

* '''''> Drop a Packet''''' -

==== '''Recorder Submenu >''' ====

* '''''> Full Session Logging''''' -

* '''''> Start Logging''''' -

* '''''> Stop Logging''''' -

* '''''> Log 10 Seconds''''' -

* '''''> Log 30 Seconds''''' -

* '''''> Log 60 Seconds''''' -

* '''''> Start Playback''''' -

* '''''> Stop Playback''''' -

* '''''> Loop Playback''''' -

* '''''> Start Record''''' -

* '''''> Stop Record''''' -

==== '''Remainder of Advanced Menu''' ====

* '''Show Updates''' - Indicates visually which objects were updated recently. See [[I see blue, green, or red triangles coming from objects inworld that I think shouldn't be there.]]

* '''Compress Images'''

* '''Limit Select Distance''' - Limits the distance in which you're allowed to select and edit objects.

* '''Disable Camera Constraints''' - Your camera movement is constrained in a maximum distance to your avatar. Ticking this option will allow you to move the camera further away.

* '''Mouse Smoothing'''

* '''Console Window'''

* '''Output Debug Minidump'''

* '''[[Debug Settings]]''' - Opens the "Debug Settings" floating window. Allows manually setting essentially every Viewer setting. '''Warning:''' randomly playing with these settings can make the viewer program unusable.

* '''View Admin Options''' - Makes the client act as if it has owner permissions on all objects and land. Any action the user does not have permission for will generate an error message. Also toggles visibility of the "Admin" dropdown menu on the top menu bar.

* '''Request Admin Status''' - Also known as "[[God Mode]]". Enables administrative functions. This only works for Linden Staff.

* '''Leave Admin Status''' - Ends Admin Status or "[[God Mode]]".

<br clear="all"/>

=== Admin Menu ===

[[File:V1.23 Admin Menu.jpg|thumb|300px|left]]

{{KBwarning| This menu is off by default. Nobody who is not a [[Linden]] can use the options in the '''Admin''' menu. The options in the '''Admin''' menu are for viewing purposes only!}}

==== '''Object Submenu >''' ====

* '''''> Take Copy''''' - Allows a Linden to take a copy of an object, regardless of ownership.

* '''''> Force Owner to Me''''' - Allows a Linden to make themselves the owner of any object. However, copy/mod/trans permissions are unaffected.

* '''''> Force Owner Permissive''''' - Allows a Linden to make themselves the owner of any object and also gives them full permissions to copy, modify and transfer that object.

* '''''> Delete''''' - Allows a Linden to delete an object, regardless of ownership.

* '''''> Lock''''' - Unknown at this time (Probably allows a Linden to lock an object so that nobody, even its creator and/or owner, can edit it).

* '''''> Get Asset IDs''''' - Unknown at this time (Probably allows a Linden to get the [[UUID]]s of an object and its associated assets).

==== '''Parcel Submenu >''' ====

* '''''> Owner to Me''''' -

* '''''> Set to Linden Content''''' -

* '''''> Claim Public Land''''' -

==== '''Region Submenu >''' ====

* '''''> Dump Temp Asset Data'''''

* '''God Tools...''' - Opens "God Tools" floating window

* '''Save Region State'''
<br clear="all"/>

[[Category:Advanced menu]]

Furry

2010-04-05T18:19:46Z

Terris Bezner: Added related link to Wikifur article on furries

{{Help |Glossary=*}}[[Resident]] using [http://en.wikipedia.org/wiki/Anthropomorphism anthropomorphic] animal [[avatar]]s.

== Related Links ==

* [http://en.wikifur.com/wiki/Furry Wikifur: Furry]

* [http://secondlife.wikia.com/wiki/Furry SL Wikia: Furries]

* [http://en.wikipedia.org/wiki/Furry_fandom Furry Fandom]

Invisiprim

2010-04-05T18:15:00Z

Terris Bezner: Corrected an error in the LSL code, added anchor link to example and tidied up slightly

{{Help|Glossary=*|Object=*}}
''Note: The new alpha layer feature of Viewer 2.0 has replaced the use of invisiprims to hide parts of the avatar. See [[Invisiprim#Criticism|Criticism]] below.''

[[Image:Avatar_behind_invisiprim.jpg|thumb|right|150px|Avatar behind an invisiprim]]
An '''Invisiprim''' is a [[prim]] with a special [[texture]]. The texture appears transparent and has the effect to hide all items with an alpha layer which are being seen through the object with the invisitexture. This includes water, clouds, particles and any part of the default avatar (including clothes, but not attachments unless they have alpha textures). Prims with an invisitexture are ''not'' highlighted through the ''Highlight Transparent'' feature of the viewer (located in the ''View'' menu).

Invisiprims are often used by creators of [[furry]] or other non-human avatars, to hide parts of the human default avatar.

There are two invisi-textures, which can only be set using a script (see [[llSetTexture]] or the [[Invisiprim#Example Script|example script]] below). Their [[key|keys]] are "38b86f85-2575-52a9-a531-23108d8da837" and "e97cf410-8e61-7005-ec06-629eba4cd1fb". Either texture can be used; they function identically.

== How invisiprims work ==
When a viewer sees that the texture key of a prim's face is set to one of the two texture keys above, instead of drawing the actual texture it renders that face of the prim as though it had a completely transparent texture. Additionally, and most importantly, any part of any [[alpha]] texture that is being seen through the invisiprim will not be rendered. However, alpha textures in front of the invisiprim will still be drawn.

Since the texture on avatar skins are rendered as alpha textures, invisiprims can be used to make any body parts they cover invisible. Water is also an alpha texture, so invisiprims can be used to "punch holes" in the water, which could be used for example to create depressions in terrain that descend below sea level but do not appear to contain water.

Other objects with alpha textures are all particles, including clouds (but not [[Windlight]] clouds, which are shaders not particles), and any normally opaque texture with a non-opaque transparency set either in the editor or by the [[llSetAlpha]] call. All of these will disappear behind an invisiprim.

Invisiprims are affected by the shiny, bumpmapping and transparency settings. Setting an invisiprim to be shiny will make it appear as a semi-transparent, shiny prim. The invisiprim becomes more opaque as shininess is increased, however it still hides alpha textures seen through it. Setting bumpmapping will also reveal the prim as the bumpmap is overlayed on the transparent surface. Again, it appears semi-transparent and continues to hide alpha textures.

Setting the textures of an invisiprim to anything other than opaque will cause the invisitexture to lose its special properties. Instead, the actual texture is revealed. (This is either a grey-to-transparent gradient, or a sort of cloudy white shape on a transparent background, depending which key is used. These textures also appear in the texture preview window.)

== Criticism ==
As noted above, invisiprims are primarily used on avatars to hide parts of the avatar [[mesh]]. However, due to the nature of its effects the texture not only hides the human bodyparts, but also any parts of the surrounding environment that happen to be seen through it, creating an unwanted |x-ray effect". Mostly due to this effect, the ability to add [[alpha layer|alpha layers]] to the default avatar was requested in {{Jira|VWR-812}}, to replace invisiprims on avatars. A design proposal for this feature can be viewed [[User:Brent Linden/VWR-812 Design Proposal|here]]. As a result, alpha layers have been implemented and are available in Viewer 2.0.

== Example Script ==
Below is some simple [[LSL]] code for making an invisiprim. To use, create a new script in your inventory and paste the code below into it. Then drag the script onto a prim to turn it into an invisiprim.

<lsl>
default {
state_entry() {
// Make this prim an invisiprim.
llSetPrimitiveParams([PRIM_BUMP_SHINY, ALL_SIDES, PRIM_SHINY_NONE, PRIM_BUMP_NONE,
PRIM_COLOR, ALL_SIDES, <1.0, 1.0, 1.0>, 1.0, PRIM_TEXGEN, ALL_SIDES, PRIM_TEXGEN_DEFAULT,
PRIM_TEXTURE, ALL_SIDES, "e97cf410-8e61-7005-ec06-629eba4cd1fb", ZERO_VECTOR, ZERO_VECTOR, 0.0]);

// Delete ourselves from the prim; we are no longer needed.
llRemoveInventory(llGetScriptName());
}
</lsl>

For coders who wish to understand how this works, the same code as above is reproduced below, thoroughly commented to show what the code is doing.

<lsl>
default {
state_entry() {
// Here we explain the whys and wherefores of making an invisiprim.

// We use an llSetPrimitiveParams call to set a lot of options at once.
llSetPrimitiveParams(

// Turn off bump mapping and shiny. If either of these options are on,
// they will have their usual effects, causing the invisiprim to be seen
// even though the special effects of hiding alpha textures continues.
[PRIM_BUMP_SHINY, ALL_SIDES, PRIM_SHINY_NONE, PRIM_BUMP_NONE,

// Set the color and alpha to white and full opacity, respectively.
// Color has no effect on the invisiprim, but the prim must be FULLY opaque,
// or the special effect is lost.
PRIM_COLOR, ALL_SIDES, <1.0, 1.0, 1.0>, 1.0,

// For completeness we set mapping to default, even though it has no effect.
PRIM_TEXGEN, ALL_SIDES, PRIM_TEXGEN_DEFAULT,

// Now we set the actual texture, which makes this an invisiprim. We set it on
// all sides, but there is nothing stopping you setting it only on certain faces.
// We also set repeat, offset and rotation to zero.
PRIM_TEXTURE, ALL_SIDES, "e97cf410-8e61-7005-ec06-629eba4cd1fb", ZERO_VECTOR, ZERO_VECTOR, 0.0

]);

// Now remove this script from the prim to save on server resources. The script is only
// required in order to set the texture; it does not need to stay in the prim for the
// invisiprim's special effects to continue.
llRemoveInventory(llGetScriptName());
}
}
</lsl>

Invisiprim

2010-04-05T17:57:05Z

Terris Bezner: Edited for clarity

{{Help|Glossary=*|Object=*}}
''Note: The new alpha layer feature of Viewer 2.0 has replaced the use of invisiprims to hide parts of the avatar. See [[Invisiprim#Criticism|Criticism]] below.''

[[Image:Avatar_behind_invisiprim.jpg|thumb|right|150px|Avatar behind an invisiprim]]
An '''Invisiprim''' is a [[prim]] with a special [[texture]]. The texture appears transparent and has the effect to hide all items with an alpha layer which are being seen through the object with the invisitexture. This includes water, clouds, particles and any part of the default avatar (including clothes, but not attachments unless they have alpha textures). Prims with an invisitexture are ''not'' highlighted through the ''Highlight Transparent'' feature of the viewer (located in the ''View'' menu).

Invisiprims are often used by creators of [[furry]] or other non-human avatars, to hide parts of the human default avatar.

There are two invisi-textures, which can only be set using a script (see [[llSetTexture]] or the example script below). Their [[key|keys]] are "38b86f85-2575-52a9-a531-23108d8da837" and "e97cf410-8e61-7005-ec06-629eba4cd1fb". Either texture can be used; they function identically.

== How invisiprims work ==
When a viewer sees that the texture key of a prim's face is set to one of the two texture keys above, instead of drawing the actual texture it renders that face of the prim as though it had a completely transparent texture. Additionally, and most importantly, any part of any [[alpha]] texture that is being seen through the invisiprim will not be rendered. However, alpha textures in front of the invisiprim will still be drawn.

Since the texture on avatar skins are rendered as alpha textures, invisiprims can be used to make any body parts they cover invisible. Water is also an alpha texture, so invisiprims can be used to "punch holes" in the water, which could be used for example to create depressions in terrain that descend below sea level but do not appear to contain water.

Other objects with alpha textures are all particles, including clouds (but not [[Windlight]] clouds, which are shaders not particles), and any normally opaque texture with a non-opaque transparency set either in the editor or by the [[llSetAlpha]] call. All of these will disappear behind an invisiprim.

Invisiprims are affected by the shiny, bumpmapping and transparency settings. Setting an invisiprim to be shiny will make it appear as a semi-transparent, shiny prim. The invisiprim becomes more opaque as shininess is increased, however it still hides alpha textures seen through it. Setting bumpmapping will also reveal the prim as the bumpmap is overlayed on the transparent surface. Again, it appears semi-transparent and continues to hide alpha textures.

Setting the textures of an invisiprim to anything other than opaque will cause the invisitexture to lose its special properties. Instead, the actual texture is revealed. (This is either a grey-to-transparent gradient, or a sort of cloudy white shape on a transparent background, depending which key is used. These textures also appear in the texture preview window.)

== Criticism ==
As noted above, invisiprims are primarily used on avatars to hide parts of the avatar [[mesh]]. However, due to the nature of its effects the texture not only hides the human bodyparts, but also any parts of the surrounding environment that happen to be seen through it, creating an unwanted |x-ray effect". Mostly due to this effect, the ability to add [[alpha layer|alpha layers]] to the default avatar was requested in {{Jira|VWR-812}}, to replace invisiprims on avatars. A design proposal for this feature can be viewed [[User:Brent Linden/VWR-812 Design Proposal|here]]. As a result, alpha layers have been implemented and are available in Viewer 2.0.

== Example Script ==
Below is some simple [[LSL]] code for making an invisiprim. To use, create a new script in your inventory and paste the code below into it. Then drag the script onto a prim to turn it into an invisiprim.

<lsl>
default {
state_entry() {
// Make this prim an invisiprim.
llSetPrimitiveParams([PRIM_BUMP_SHINY, ALL_SIDES, PRIM_SHINY_NONE, PRIM_BUMP_NONE,
PRIM_COLOR, ALL_SIDES, <1.0, 1.0, 1.0>, 1.0, PRIM_TEXGEN, ALL_SIDES, PRIM_TEXGEN_DEFAULT,
PRIM_TEXTURE, ALL_SIDES, "e97cf410-8e61-7005-ec06-629eba4cd1fb", ZERO_VECTOR, ZERO_VECTOR, 0.0]);

// Delete ourselves from the prim; we are no longer needed.
llRemoveInventory(llGetScriptName());
}
</lsl>

For coders who wish to understand how this works, the same code as above is reproduced below, thoroughly commented to show what the code is doing. Note that the code below is not a complete script.

<lsl>
invisiprim() {
// Here we explain the whys and wherefores of making an invisiprim.

// We use an llSetPrimitiveParams call to set a lot of options at once.
llSetPrimitiveParams(

// Turn off bump mapping and shiny. If either of these options are on,
// they will have their usual effects, causing the invisiprim to be seen
// even though the special effects of hiding alpha textures continues.
[PRIM_BUMP_SHINY, ALL_SIDES, PRIM_SHINY_NONE, PRIM_BUMP_NONE,

// Set the color and alpha to white and full opacity, respectively.
// Color has no effect on the invisiprim, but the prim must be FULLY opaque,
// or the special effect is lost.
PRIM_COLOR, ALL_SIDES, <1.0, 1.0, 1.0>, 1.0,

// For completeness we set mapping to default, even though it has no effect.
PRIM_TEXGEN, ALL_SIDES, PRIM_TEXGEN_DEFAULT,

// Now we set the actual texture, which makes this an invisiprim. We set it on
// all sides, but there is nothing stopping you setting it only on certain faces.
// We also set repeat and offset to zero.
PRIM_TEXTURE, ALL_SIDES, "e97cf410-8e61-7005-ec06-629eba4cd1fb", ZERO_VECTOR, ZERO_VECTOR

]);

// Now remove this script from the prim to save on server resources. The script is only
// required in order to set the texture; it does not need to stay in the prim for the
// invisiprim's special effects to continue.
llRemoveInventory(llGetScriptName());
}
</lsl>

Invisiprim

2010-04-05T17:50:20Z

Terris Bezner: Performed major revision work and updated some out-of-date information. Also added an example script for making

{{Help|Glossary=*|Object=*}}
''Note: The new alpha layer feature of Viewer 2.0 has replaced the use of invisiprims to hide parts of the avatar. See [[Invisiprim#Criticism|Criticism]] below.''

[[Image:Avatar_behind_invisiprim.jpg|thumb|right|150px|Avatar behind an invisiprim]]
An '''Invisiprim''' is a [[prim]] with a special [[texture]]. The texture appears transparent and has the effect to hide all items with an alpha layer which are being seen through the object with the invisi-texture. This includes water, clouds, particles and any part of the default avatar (including clothes, but not attachments unless they have alpha textures). Prims with an invisitexture are ''not'' highlighted through the ''Highlight Transparent'' feature of the viewer (located in the ''View'' menu).

Invisiprims are often used by creators of [[furry]] or other non-human avatars, to hide parts of the human default avatar.

There are two invisi-textures, which can only be set using a script (see [[llSetTexture]] or the example script below). Their [[key|keys]] are "38b86f85-2575-52a9-a531-23108d8da837" and "e97cf410-8e61-7005-ec06-629eba4cd1fb". Either texture can be used; they function identically.

== How invisiprims work ==
When a viewer sees that the texture key of a prim's face is set to one of the two texture keys above, instead of drawing the actual texture it renders that face of the prim as though it had a completely transparent texture. Additionally, and most importantly, any part of any [[alpha]] texture that is being seen through the invisiprim will not be rendered. However, alpha textures in front of the invisiprim will still be drawn.

Since the texture on avatar skins are rendered as alpha textures, invisiprims can be used to make any body parts they cover invisible. Water is also an alpha texture, so invisiprims can be used to "punch holes" in the water, which could be used for example to create depressions in terrain that descend below sea level but do not appear to contain water.

Other objects with alpha textures are the particle clouds (but not [[Windlight]] clouds), all other particles, and any normally opaque texture with transparency set either in the editor or by the [[llSetAlpha]] call. All of these will disappear behind an invisiprim.

Invisiprims are affected by the shiny, bumpmapping and transparency settings. Setting an invisiprim to be shiny will make it appear as a semi-transparent, shiny prim. The invisiprim becomes more opaque as shininess is increased, however it still hides alpha textures seen through it. Setting bumpmapping will also reveal the prim as the bumpmap is overlayed on the transparent surface. Again, it appears semi-transparent and continues to hide alpha textures.

Setting the textures of an invisiprim to anything other than opaque will cause the invisi-texture to lose its special properties. Instead, the actual texture is revealed. (This is either a grey-to-transparent gradient, or a sort of cloudy white shape on a transparent background, depending which key is used. These textures also appear in the texture preview window.)

== Criticism ==
As noted above, invisiprims are primarily used on avatars to hide parts of the avatar [[mesh]]. However, due to the nature of its effects the texture not only hides the human bodyparts, but also any parts of the surrounding environment that happen to be seen through it, creating an unwanted |x-ray effect". Mostly due to this effect, the ability to add [[alpha layer|alpha layers]] to the default avatar was requested in {{Jira|VWR-812}}, to replace invisiprims on avatars. A design proposal for this feature can be viewed [[User:Brent Linden/VWR-812 Design Proposal|here]]. As a result, alpha layers have been implemented and are available in Viewer 2.0.

== Example Script ==
Below is a simple script for making an invisiprim. Create a new script in your inventory and paste the code below into it. Then drag the script onto a prim to turn it into an invisiprim.

<lsl>
default {
state_entry() {
// Make this prim an invisiprim.
llSetPrimitiveParams([PRIM_BUMP_SHINY, ALL_SIDES, PRIM_SHINY_NONE, PRIM_BUMP_NONE,
PRIM_COLOR, ALL_SIDES, <1.0, 1.0, 1.0>, 1.0, PRIM_TEXGEN, ALL_SIDES, PRIM_TEXGEN_DEFAULT,
PRIM_TEXTURE, ALL_SIDES, "e97cf410-8e61-7005-ec06-629eba4cd1fb", ZERO_VECTOR, ZERO_VECTOR, 0.0]);

// Delete ourselves from the prim; we are no longer needed.
llRemoveInventory(llGetScriptName());
}
</lsl>

For coders who wish to understand how this works, the same code as above is reproduced below, thoroughly commented to show what the code is doing. Note that the code below is not a complete script.

<lsl>
invisiprim() {
// Here we explain the whys and wherefores of making an invisiprim.

// We use an llSetPrimitiveParams call to set a lot of options at once.
llSetPrimitiveParams(

// Turn off bump mapping and shiny. If either of these options are on,
// they will have their usual effects, causing the invisiprim to be seen
// even though the special effects of hiding alpha textures continues.
[PRIM_BUMP_SHINY, ALL_SIDES, PRIM_SHINY_NONE, PRIM_BUMP_NONE,

// Set the color and alpha to white and full opacity, respectively.
// Color has no effect on the invisiprim, but the prim must be FULLY opaque,
// or the special effect is lost.
PRIM_COLOR, ALL_SIDES, <1.0, 1.0, 1.0>, 1.0,

// For completeness we set mapping to default, even though it has no effect.
PRIM_TEXGEN, ALL_SIDES, PRIM_TEXGEN_DEFAULT,

// Now we set the actual texture, which makes this an invisiprim. We set it on
// all sides, but there is nothing stopping you setting it only on certain faces.
// We also set repeat and offset to zero.
PRIM_TEXTURE, ALL_SIDES, "e97cf410-8e61-7005-ec06-629eba4cd1fb", ZERO_VECTOR, ZERO_VECTOR

// The same code that appears here is reproduces below, but without the comments.
]);
}
</lsl>

Orbiter

2010-03-13T17:34:02Z

Terris Bezner: Expanded glossary entry on orbiters, adding modern details

{{Help |Glossary=*}}Orbiters are devices designed to send their victims so far into the sky that it would take hours for them to fall back down in the normal way and/or their coordinates no longer fit within SL’s world model (hence the name "orbiter", because it sends you into orbit). In practice Second Life today has limitations that reduce the effectiveness of orbiters. If you are being orbited, [[Teleport|teleporting]] away or – in extreme cases – [[Relog|relogging]] will fix being orbited.

There exists a [[Limits#Building|4096m hard limit]] on the height an object can move (or be moved) to, which prevents orbiting from continuing above this height (as the orbiter object that surrounds and pushes the avatar will be unable to travel higher than this, meaning gravity takes over until the avatar drops back down below 4096m where the orbiter can again reach them). Although an avatar (and its attachments) can travel up to one million meters without ill effects, few if any of today's orbiters are powerful enough to throw somebody over five thousand meters in height.

Relog

2010-03-13T17:13:54Z

Terris Bezner: Created page with '{{Help |Glossary=*}}Relog is a term used by residents, meaning to close the viewer and then log back into Second Life again. This is often done to fix viewer glitches or if an av...'

{{Help |Glossary=*}}Relog is a term used by residents, meaning to close the viewer and then log back into Second Life again. This is often done to fix viewer glitches or if an avatar becomes stuck.