Second Life Wiki - User contributions [en]

Invisiprim

2025-03-10T17:06:33Z

Dan Linden:

{{Help|Glossary=*|Object=*}}

{{KBcaution|width=100%|Starting in SL 7.1.12, Invisiprim objects will now hide only water. The other features of Invisiprims as described on this page are obsolete. See [[Water_Exclusion_Surface]] for more details.}}

''Note: The new alpha mask feature of [[Viewer 2 Help|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.)

== Why invisiprims won't work with deferred rendering ==
Invisiprims work by rendering to the depth buffer (but not the color buffer) before avatars but after prims. With deferred rendering, the depth information is used for lighting, so any invisiprim would change the position of prims behind it for lighting (it just looks broken).

Also, all fullbright objects are rendered after avatars with deferred rendering, so invisiprims would also occlude fullbright objects.

== 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 32-bit textured 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 mask|alpha masks]] 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 masks 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.

<source lang="lsl2">
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());
}
}
</source>

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.

<source lang="lsl2">
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());
}
}
</source>

Invisiprim

2025-03-10T17:05:42Z

Dan Linden:

{{Help|Glossary=*|Object=*}}

{{KBcaution|width=100%|Starting in SL 7.1.12, Invisiprim objects will now hide only water. See [[Water_Exclusion_Surface]] for more details. The other features of Invisiprims as described on this page are obsolete.}}

''Note: The new alpha mask feature of [[Viewer 2 Help|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.)

== Why invisiprims won't work with deferred rendering ==
Invisiprims work by rendering to the depth buffer (but not the color buffer) before avatars but after prims. With deferred rendering, the depth information is used for lighting, so any invisiprim would change the position of prims behind it for lighting (it just looks broken).

Also, all fullbright objects are rendered after avatars with deferred rendering, so invisiprims would also occlude fullbright objects.

== 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 32-bit textured 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 mask|alpha masks]] 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 masks 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.

<source lang="lsl2">
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());
}
}
</source>

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.

<source lang="lsl2">
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());
}
}
</source>

Water Exclusion Surface

2025-03-06T17:04:47Z

Dan Linden:

With the release of the 7.1.12 Second Life Viewer, a new Water Exclusion Surface feature has been introduced. This feature enables the creation of a Water Exclusion Surface object, which renders both itself and the water surface within or behind it transparent when viewed from above. This is useful for hiding the water inside a boat when the inside hull of the boat is below the waterline.

When viewed from below, the Water Exclusion Surface object removes any water refraction effects that would typically be visible. However, it does not hide the water surface itself.

Usage notes:
* A Water Exclusion Surface object that has a PBR material applied will not hide water.
* A Water Exclusion Surface object that is worn as an attachment will not hide water.
* A Water Exclusion Surface object made from a rigged mesh will not hide water.

== Creating a water exclusion surface object ==

Below is some simple [[LSL]] code for making an water exclusion surface. 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 water exclusion surface object.

<syntaxhighlight lang="lsl2">
default
{
state_entry()
{
// Make this prim an water exclusion surface.
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());
}
}
</syntaxhighlight>

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.

<syntaxhighlight lang="lsl2">
default
{
state_entry()
{
// Here we explain the whys and wherefores of making an water exclusion surface.

// 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 water exclusion surface 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 water exclusion surface, 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 water exclusion surface. 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
// water exclusion surface's special effects to continue.
llRemoveInventory(llGetScriptName());
}
}
</syntaxhighlight>

Trivia: This is the same basic script as the old [[Invisiprim]]. Any existing invisiprims will now work as water exclusion surface objects.

Water Exclusion Surface

2025-03-06T03:42:51Z

Dan Linden:

With the release of the 7.1.12 Second Life Viewer, a new Water Exclusion Surface feature has been introduced. This feature enables the creation of a Water Exclusion Surface object, which renders both itself and the water surface within or behind it transparent when viewed from above. This is useful for hiding the water inside a boat when the inside hull of the boat is below the waterline.

When viewed from below, the Water Exclusion Surface object removes any water refraction effects that would typically be visible. However, it does not hide the water surface itself.

== Creating a water exclusion surface object ==

Below is some simple [[LSL]] code for making an water exclusion surface. 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 water exclusion surface object.

Notes: A Water Exclusion Surface object that has a PBR material applied will not hide water.
A Water Exclusion Surface object that is worn as an attachment will not hide water.
A Water Exclusion Surface object made from a rigged mesh will not hide water.

<syntaxhighlight lang="lsl2">
default
{
state_entry()
{
// Make this prim an water exclusion surface.
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());
}
}
</syntaxhighlight>

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.

<syntaxhighlight lang="lsl2">
default
{
state_entry()
{
// Here we explain the whys and wherefores of making an water exclusion surface.

// 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 water exclusion surface 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 water exclusion surface, 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 water exclusion surface. 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
// water exclusion surface's special effects to continue.
llRemoveInventory(llGetScriptName());
}
}
</syntaxhighlight>

Trivia: This is the same basic script as the old [[Invisiprim]]. Any existing invisiprims will now work as water exclusion surface objects.

Water Exclusion Surface

2025-03-06T03:31:11Z

Dan Linden:

With the release of the 7.1.12 Second Life Viewer, a new Water Exclusion Surface feature has been introduced. This feature enables the creation of a Water Exclusion Surface object, which renders both itself and the water surface within or behind it transparent when viewed from above. This is useful for hiding the water inside a boat when the inside hull of the boat is below the waterline.

When viewed from below, the Water Exclusion Surface object removes any water refraction effects that would typically be visible. However, it does not hide the water surface itself.

== Creating a water exclusion surface object ==

Below is some simple [[LSL]] code for making an water exclusion surface. 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 water exclusion surface object.

Note: A Water Exclusion Surface object that has a PBR material applied will not hide water.

<syntaxhighlight lang="lsl2">
default
{
state_entry()
{
// Make this prim an water exclusion surface.
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());
}
}
</syntaxhighlight>

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.

<syntaxhighlight lang="lsl2">
default
{
state_entry()
{
// Here we explain the whys and wherefores of making an water exclusion surface.

// 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 water exclusion surface 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 water exclusion surface, 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 water exclusion surface. 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
// water exclusion surface's special effects to continue.
llRemoveInventory(llGetScriptName());
}
}
</syntaxhighlight>

Trivia: This is the same basic script as the old [[Invisiprim]]. Any existing invisiprims will now work as water exclusion surface objects.

Water Exclusion Surface

2025-03-06T03:18:32Z

Dan Linden: Created page with " With the release of the 7.1.12 Second Life Viewer, a new Water Exclusion Surface feature has been introduced. This feature enables the creation of a Water Exclusion Surface..."

With the release of the 7.1.12 Second Life Viewer, a new Water Exclusion Surface feature has been introduced. This feature enables the creation of a Water Exclusion Surface object, which renders both itself and the water surface within or behind it transparent when viewed from above. This is useful for hiding the water inside a boat when the inside hull of the boat is below the waterline.

When viewed from below, the Water Exclusion Surface object removes any water refraction effects that would typically be visible. However, it does not hide the water surface itself.

== Creating a water exclusion surface object ==

Below is some simple [[LSL]] code for making an water exclusion surface. 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 water exclusion surface object.

Note: A Water Exclusion Surface object that has a PBR material applied will not hide water.

<source lang="lsl2">
default
{
state_entry()
{
// Make this prim an water exclusion surface.
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());
}
}
</source>

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.

<source lang="lsl2">
default
{
state_entry()
{
// Here we explain the whys and wherefores of making an water exclusion surface.

// 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 water exclusion surface 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 water exclusion surface, 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 water exclusion surface. 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
// water exclusion surface's special effects to continue.
llRemoveInventory(llGetScriptName());
}
}
</source>

Trivia: This is the same basic script as the old [[Invisiprim]]. Any existing invisiprims will now work as water exclusion surface objects.

Bug Island Test

2024-10-15T21:44:56Z

Dan Linden:

[[Category:Test Scripts]]
-In progress-

=== Bump maps ===
====Bump maps look correct====
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/83/22/27 and sit on the red pyramid
* Set Preferences > Graphics Quality to Mid
* Verify the bump map looks the same as this picture.
[[File:Bump_map_spheres.jpg]]

====Custom bump maps load for objects at a distance====
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/75/110/31 and face south.
* Set Preferences > Graphics to Mid.
* Clear the cache (Preferences > Advanced> Clear Cache) and relog.
* Wait for the textures to load on the bumpmapped spheres.
* Fly to the spheres
* Verify the bump map looks the same as the picture above.

====Brightness vs. Darkness bump maps====
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/103/24/27
* Set Set Preferences > Graphics Quality to High
* Verify the wood grain appears indented of the left cube and embossed on the right cube.

=== Texture animation ===

1. http://maps.secondlife.com/secondlife/Bug%20Island/49/15/27
A video should play on the screen in front of you shortly after you arrive. Verify the animations are cycling between the same numbers as the video. You will need to alt-zoom on the boxes to load the textures clearly.

2. http://maps.secondlife.com/secondlife/Bug%20Island/46/16/27
Verify the texture animations matches the video.

3. http://maps.secondlife.com/secondlife/Bug%20Island/42/16/27
Verify the texture animations matches the video.

4. http://maps.secondlife.com/secondlife/Bug%20Island/38/16/27
Verify the texture animations matches the video.

5. http://maps.secondlife.com/secondlife/Bug%20Island/34/15/27
Verify the texture animations matches the video.

6. http://maps.secondlife.com/secondlife/Bug%20Island/27/16/27
Verify the textures are rotating and your viewer does not experience a drop in framerate here.

=== Target Omega ===
1. http://maps.secondlife.com/secondlife/Bug%20Island/29/23/28
Verify the motion matches https://s3-us-west-2.amazonaws.com/lecs-bugislandtests/targetomega1.mov

2. http://maps.secondlife.com/secondlife/Bug%20Island/20/18/28
Verify the motion matches https://s3-us-west-2.amazonaws.com/lecs-bugislandtests/targetomega2.mov

3. http://maps.secondlife.com/secondlife/Bug%20Island/15/18/28
Verify the motion matches https://s3-us-west-2.amazonaws.com/lecs-bugislandtests/targetomega3.mov

4. http://maps.secondlife.com/secondlife/Bug%20Island/23/28/27
Verify the motion matches https://s3-us-west-2.amazonaws.com/lecs-bugislandtests/targetomega4.mov

=== Dynamic texture scaling ===
http://maps.secondlife.com/secondlife/Bug%20Island/45/30/27

Look at the objects with the 1, 2, 3, 4, and 5 textures. Verify the textures scale with the objects as the objects grow taller and shorter.

Look at the objects with the 6 texture. These objects are using Planar texture mapping. Verify the texture changes with the scale of the object, then a moment later rescales to match the object which is not scaling.

=== Prim LOD and bins ===
http://maps.secondlife.com/secondlife/Bug%20Island/32/36/27

* Go to some region other than Bug Island for at least 10 seconds.
* Teleport to http://maps.secondlife.com/secondlife/Bug%20Island/80/36/27 and look West.
* Walk to http://maps.secondlife.com/secondlife/Bug%20Island/32/36/27
* Verify the objects from the 4 left rows appear.
* Verify the farthest 4 small objects in the right row do not appear.

[[File:PrimLOD2.jpg|200px|thumb|none|click for full image]]

=== Texture and color matching ===
http://maps.secondlife.com/secondlife/Bug%20Island/32/50/27

* The wall of objects is made of an object with a white texture and some color next to an object with a texture of the same color and set to a white color. These should match.
* Verify the wall looks the same as the screenshot below.

[[File:Color_and_texture_matching.jpg|200px|thumb|none|click for full image]]

=== Transparency interaction ===
http://maps.secondlife.com/secondlife/Bug%20Island/32/65/27

* Right-click the semitransparent objects.
* Verify objects with semitransparent textures, even 100% transparent, will become selected.
* Verify objects with face transparency (set in the texture tab) of 99% or less will become selected.
* Verify objects with face transparency (set in the texture tab) of 100% will allow the right-click to pass through to the object behind it.

=== HUD (Heads Up Display) effects ===
http://maps.secondlife.com/secondlife/Bug%20Island/31/72/27

Take a copy of the small rotating object on the ground. Wear it to attach it to the top left of your screen.

Verify the following:
* The object does Not emit particles while attached to your HUD.
* The entire object is spinning from left to right.
* The yellow is slightly transparent.
* The yellow cube has one red face and 3 faces with red line.
* The yellow cube has 2 faces with a red "1" texture.
* The "1" texture on the face nearest to the red cube is animating - sliding from left to right.
* The red cube is shiny
* The red cube is spinning on an axis different than the yellow cube
* The red cube has bump maps
* The red cube has an "8" texture on one face and the other faces are the default wood texture.
* The black hover text is visible and is above the blue cube
* The blue cube is twisted
* The blue cube is flexible (this may be hard to see)
* The blue cube is shiny.
* The blue cube is spinning on an axis different than the yellow cube or red cube.

=== Flexible objects ===
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/31/79/27
* Verify the flexy objects look similar to the following screenshot. Note that the top left object may point in a different direction depending on the wind.

[[File:Flexy1.jpg]]

Known issue: Flexible objects which are twisted do not appear twisted when you are zoomed in close. (MAINT-960)

=== Sculpty objects ===

* Go to http://maps.secondlife.com/secondlife/Bug%20Island/100/200/27 and face West.
* Make sure you Draw Distance (in Preferences > Graphics) is set to at least 100m so you can see the sculpty * objects at http://maps.secondlife.com/secondlife/Bug%20Island/17/100/37.
* Clear your SL cache (Preferences > Advanced > Clear Cache) and relog.
* When the sculpties have loaded, fly to http://maps.secondlife.com/secondlife/Bug%20Island/32/99/27 and verify the sculpties look correct like the following screenshot; the shapes should be correct and not just elongated spheres, the surface textures should be loaded.

[[File:Sculpties2.jpg|200px|thumb|none|click for full image]]

* Go to http://maps.secondlife.com/secondlife/Bug%20Island/31/105/27
* Verify the Scultpy objects look like this screenshot.

[[File:Sculpty1.jpg]]

=== Lights ===
http://maps.secondlife.com/secondlife/Bug%20Island/32/131/27
* Set World > Environment > Midnight
* Set Preferences > Graphics > Quality & speed to Low (which sets Advanced Graphics Preferences > Max. nearby lights to 8)
* Detach any attachments that are lights.
* There are 8 green lights shining on 8 spheres in front of you, and none of the only lights should show.
* Move back and forth and verify that only 8 lights in the scene appear at any one time.

=== Small texture loading ===
http://maps.secondlife.com/secondlife/Bug%20Island/32/151/27

* Verify these small textures load quickly.
* Verify these texture appear the same as in the picture below.
[[File:small_textures.png|200px|thumb|none|click for full image]]

=== Parcel based media ===
Some of these tests require QuickTime be installed on your computer.

Type Movie, video/mp4
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/246/214/27
* Verify a mp4 movie starts playing after a few seconds on the boxes with the "8" texture.
* Verify the movie is scaled to fill the face of the box.
* Go out of the parcel so the movie stops.
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/246/208/27
* Verify a mp4 movie starts playing after a few seconds on the boxes with the "8" texture.
* Verify the movie covers only part of the face of the box, and the rest of the face is white.

Type Web Content, text/html
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/242/214/27
* Verify a webpage with a Flash clock appears on the boxes with the "4" texture.
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/242/208/27
* Verify a webpage with a Flash clock appears on the boxes with the "4" texture.
* This will look exactly the same as the previous test.

Default Private Region RAW Files

2023-01-05T18:23:01Z

Dan Linden:

This article features download locations for the four basic types of Private Region terrain, saved as .raw files. We're also including a .raw file for flat terrain.

The first four .raw files listed are the basic shapes from which you can choose when you first order your Private Region. Once the region is in your possession it's terraformable, but you can upload these .raw files to reset your land to its original state. The last .raw file is for perfectly flat land.

{{KBnote| Uploading a .raw file will not change or remove objects on your land.}}

{| style="border: 1px dashed #7f7c75" width="600" cellpadding="3"
| style="border: 1px dotted #7f7c75" |
[[Image:kbsd_Islandtype1.png]]
| style="border: 1px dotted #7f7c75" |
[https://torley.s3.amazonaws.com/kb/Islandtype1.raw Island terrain .raw file type 1 (Ruth's Retreat)]
|-
| style="border: 1px dotted #7f7c75" |
[[Image:kbsd_Islandtype2.png]]
| style="border: 1px dotted #7f7c75" |
[https://torley.s3.amazonaws.com/kb/Islandtype2.raw Island terrain .raw file type 2 (Hill and Dale)]
|-
| style="border: 1px dotted #7f7c75" |
[[Image:kbsd_Islandtype3.png]]
| style="border: 1px dotted #7f7c75" |
[https://torley.s3.amazonaws.com/kb/Islandtype3.raw Island terrain .raw file type 3 (Loch Lake)]
|-
| style="border: 1px dotted #7f7c75" |
[[Image:kbsd_Islandtype4.png]]
| style="border: 1px dotted #7f7c75" |
[https://torley.s3.amazonaws.com/kb/Islandtype4.raw Island terrain .raw file type 4 (Prima Point)]
|-
| style="border: 1px dotted #7f7c75" |
[[Image:kbsd_flatgreen.png]]
| style="border: 1px dotted #7f7c75" |
[https://torley.s3.amazonaws.com/kb/flatgreen.raw Flat green RAW file (Plain Plains)]
|}

If you open one of these in Photoshop, it may ask you to describe the file. Tell Photoshop the following:

* 256 x 256 pixels
* 13 channels
* Interleaved
* 8 bit depth
* No header
[[Category:Land]]
[[Category:Content creation]]
[[Category:Land]]

PRIM OMEGA

2022-11-10T18:36:30Z

Dan Linden:

<onlyinclude>{{#if:

{{#vardefine:omega_const|{{LSL Const|PRIM_OMEGA|integer|18|c=Used to {{GetSet|{{{1|}}}|get the object's llTargetOmega settings|rotate the object at on the given axis at the given rate|/}} }}}}

{{#vardefine:caveats|{{#var:caveats}}
*[[PRIM_OMEGA]] on nonphysical objects, and child prims of physical objects, is only a client side effect; the object or prim will collide as non-moving geometry.
*[[PRIM_OMEGA]] cannot be used on avatars sitting on the object. It will emit the error message "PRIM_OMEGA disallowed on agent".
*If [[PRIM_OMEGA]] does not appear to be working, make sure that that Develop > Network > Velocity Interpolate Objects is enabled on the viewer.}}

{{#vardefine:p_axis_desc|arbitrary axis to rotate the object around}}
{{#vardefine:p_spinrate_desc|rate of rotation in radians per second}}
{{#vardefine:p_gain_desc|also modulates the final spinrate and disables the rotation behavior if zero}}

}}</onlyinclude>{{#if:

}}{{LSL Constant
|inject-2={{LSL PrimitiveParam Categorize|Prim}}
|name=PRIM_OMEGA
|type=integer
|value=32
|desc=Used to make the object spin at the specified axis and rate, or retrieve spin settings. See [[llTargetOmega]] for specification.
|examples=<source lang="lsl2">
// Set this prim rotating
llTargetOmega(<1.0,3.0,0.5>, TWO_PI, 1.0);

// Read back this prim's current target omega
list current_omega = llGetPrimitiveParams([PRIM_OMEGA]); // should be [PRIM_OMEGA, axis, spinrate, gain]
vector axis = llList2Vector(current_omega, 1); // Should be <1.0,3.0,0.5>
float spinrate = llList2Float(current_omega, 2); // Should be TWO_PI
float gain = llList2Float(current_omega, 3); // Should be 1.0

// Set all child prims rotating
llSetLinkPrimitiveParamsFast(LINK_ALL_CHILDREN, [PRIM_OMEGA, <1.0,3.0,0.5>, TWO_PI, 1.0]);
</source>
Also, can use llSetPrimitiveParams for the root prim.
<source lang="lsl2">// will need two prims linked together for this script.
default
{
state_entry()
{
// make some sort of rotation angle for the omega...
vector rotationAngle = <2.3, 5.5, 9.7> * llTan(85);

// rotate the main prim slowly using the same rotataion angle, rate, and gain...
llSetPrimitiveParams([ PRIM_OMEGA, rotationAngle * 0.3, 1.0, 1.0 ]);

// rotate the link satellite prim separately around its own axis
// it will rotate also around the main prim because the main prim is rotating.
llSetLinkPrimitiveParams(2, [ PRIM_OMEGA, rotationAngle, 1.0, 1.0 ]);
}
}
</source>
|constants
|pa={{LSL Constant/List|i_front=[ {{#var:omega_const}}, |i_end= ]
|text=When used with [[llSetPrimitiveParams]] & [[llSetLinkPrimitiveParams]]
|i1_type=vector|i1_name=axis
|i2_type=float|i2_name=spinrate
|i3_type=float|i3_name=gain
|toc=llSetPrimitiveParams
}}
|pb={{LSL Constant/List|i_front=[[llGetPrimitiveParams]]([ {{#var:omega_const}} ]);|
|r_front=Returns the [[list]] [ |r_end= ]
|text
|toc=llGetPrimitiveParams
|r1_type=vector|r1_name=axis
|r2_type=float|r2_name=spinrate
|r3_type=float|r3_name=gain
}}
|functions=
{{LSL DefineRow||[[llSetPrimitiveParams]]|}}
{{LSL DefineRow||[[llSetLinkPrimitiveParams]]|}}
{{LSL DefineRow||[[llGetPrimitiveParams]]|}}
{{LSL DefineRow||[[llTargetOmega]]|}}
|events
|location
|history=*Introduced in [[Release Notes/Second Life RC BlueSteel/11#11.06.20.233291|Second Life RC BlueSteel 11.06.20.233291]], June 22, 2011
*Rolled to main server channel the week of 7/11/2011
|cat1
|cat2=Effects
|cat3=Physics
|cat4=Rotation
}}

Puppetry Development

2022-08-30T18:21:44Z

Dan Linden:

Puppetry Development

<h2>Summary</h2>

This article will explain how developers can experiment and code with the new Puppetry feature in Second Life. It is intended for programmers who have a familiarity with Python or C++ and a desire to make their avatar come alive.

<h2>Second Life Open Source Viewer</h2>

Puppetry requires an experimental Second Life Viewer. A pre-built version is available for download from the [https://releasenotes.secondlife.com/viewer.html alternative downloads page]. If you're only developing Puppetry plug-ins there is no need to build the Viewer from scratch. However, if you want to make changes to messaging, avatar animation system, or the [https://en.wikipedia.org/wiki/Inverse_kinematics Inverse Kinematics] (IK) algorithm, then you will need to download and build the [https://bitbucket.org/lindenlab/viewer/src/master/ open-source Viewer code].

<h2>Puppetry feature detection</h2>

To avoid compatibility problems when deploying experimental features Second Life uses a system called "capabilities". Whenever a Second Life Viewer first connects to a Region it submits a list of features it knows how to use and the Region will respond with an URL (capability) for each of those features it supports. Viewers can GET data and status information from the server, or POST to these capabilities to configure and update the server. [https://wiki.secondlife.com/wiki/Puppetry_Network_Control This page] has more information about how the Puppetry capability works. Capabilities are also often referred to as "caps" in some documentation.

<h2>LEAP Plug-ins</h2>

Puppetry expects data from a LEAP plug-in that has been launched by the Viewer as a side process. LEAP stands for LLSD Event API Plug-in and is a technology that has been embedded in the Second Life Viewer for a while but has, until now, only been used for internal testing and automated updates. A LEAP plug-in can be an executable or Python script: the only other requirement is that it read and write properly formatted LEAP data to its stdin and stdout pipes, however only Python utils have been written so far, and all of the existing Puppetry plug-ins are Python scripts.

Clone the [https://bitbucket.org/lindenlab/leap leap repository]to your computer. The Puppetry plug-ins can be found in leap/python/puppetry/examples/ and leap/python/puppetry/webcam/.

You will need Python version 3.6 or later installed on your computer. You will also need to install any Python modules a plug-in depends on. Follow the instructions in the [https://bitbucket.org/lindenlab/leap/src/main/python/puppetry/README.md ReadMe file]. Please read it carefully and ensure you have the requirements met, otherwise Puppetry may not work.

CAUTION: Only run plugins from a source that you trust. Currently there is no safety mechanism to protect against malicious plugins due to this project being in open development.

<h2>Try it out</h2>

When Puppetry is available the following menu item should be enabled:

Advanced → Puppetry → Launch LEAP plug-in...

Select that menu item and it will open a file picker. Navigate to where you downloaded the leap repository and find a plug-in to try. A simple plug-in to try is: leap/python/puppetry/examples/arm_wave.py which will make your avatar slowly wave one arm.

A more complex plug-in is the leap/python/puppetry/webcam/webcam_puppetry.py module. This will start your webcam, and try to recognize your movements and animate your avatar. It's a work in progress - at first release, head motion is reasonably good, but we're not satisfied with arm and hand movement, and have not explored fingers, facial or lips motion.

<h2>Developing Puppetry Plug-ins</h2>

All of the working examples are written in Python and use the [https://bitbucket.org/lindenlab/leap/src/main/python/puppetry/puppetry.py puppetry.py] module API to submit data to the Second Life Viewer. Data is exchanged between plug-in and Viewer via the plug-in's stdin and stdout streams. This means the plug-in must not write any spurious debug text to stdout, else risk corrupting the LEAP data and confusing the Viewer. To log debug messages during runtime under the Viewer use puppetry.log() and look in the Second Life log file for those messages, alternatively anything written to stderr will be written to the log file.

puppetry.py depends on the leap.py util module, which uses [https://pypi.org/project/eventlet/ eventlet] to run multiple co-routines on a single thread. A consequence of this is:: any Python Puppetry plug-in must be eventlet friendly by calling eventlet.sleep(0) in its main loop. For best results: follow the pattern used by a working example.

If a plug-in throws an exception and stops running: its callstack information will be written to stderr which always gets echoed to the Second Life log file, so look there for details about what went wrong. If a Python script is crashing immediately it is sometimes possible to run it from the command line interface (CLI) to see the callstack, however depending on where it is crashing it may be the case that your plug-in will first block in the leap.py module waiting for the initial LEAP data it expects to receive from the Viewer. To unblock the leap.py module is possible to manually paste valid LEAP data to its stdin. Look in existing example code to find instructions about how to do that.

<h2>Puppetry data</h2>

The Puppetry data stream is a series of events. Each event is effectively a key:value pair where the key is the joint's name (as listed in the avatar_skeleton.xml configuration file) and the value is its intended transform. The transform can specify position and/or orientation.

The position is always in the root-frame of the avatar skeleton, where the root is the avatar's pelvis and the distance units are "normalized" such that the furthest end of the hand of the avatar's longest arm has a reach of 1.0 units when the avatar is in the T-pose: standing upright with arms extended straight out from the sides: a symmetric avatar standing in T-pose has an arm span of 2.0 units in the normalized root-frame. When the position is received by the Viewer it will be uniformly scaled according to the size of the avatar instance.

The position coordinate frame is "right handed" (e.g. Z equals X cross Y) and the axes are: X=forward, Y=left, Z=up.

The orientation can be specified in the root-frame, or in the joint's parent-frame, and is always represented as a normalized quaternion (XYZW), although only the imaginary part (XYZ) is packed in the event and the real-part (W) is inferred mathematically when necessary.

An example Puppetry event might look something like this:

'mWristLeft':{'pos':[0.05,0.1665,0.5359]},'rot':[-0.07608,0.06912,-0.05754]}

In the example above the orientation is specified in the root-frame. For parent-frame the key would be 'local_rot'.

Each Puppetry data event is applied locally as soon as it is received. It is also given a timestamp and streamed to the Second Life server which relays the data to other nearby Puppetry empowered Viewers. The remote Viewers receive the Puppetry events, and instead of applying them immediately, put them into a jitter buffer from which the Viewer computes interpolated data and applies those at a different frame rate, but typically faster, than the events were received. Consequently, if the local animation looks a little choppy the remote view is typically smoother, albeit slightly delayed. You can view what your own interpolated data looks like enabling the menu option:

Advanced → Puppetry → Use my server data

With this on, you will watch your animations as others in-world see it: sent from the region server.

<h2>Viewer Code Changes</h2>

If you want to experiment with viewer source code, you'll be working in C++ and will need to download the Viewer source code which is [https://bitbucket.org/lindenlab/viewer available on Bitbucket]. Follow the instructions there to download and build the code.

You will need to switch your source code to the DRTVWR-558 branch.

git checkout DRTVWR-558

Search the codebase for "puppetry" and you'll get an idea of where the code is, or for "llik" to find the inverse kinematics implementation. Remember there are multiple components working together here - the interface to the LEAP Puppetry plug-in, which will send data into the viewer while the viewer can send messages into the plug-in to select options such as which webcam to use..

If you modify this code, you'll need to re-build the viewer, launch it and then start your Puppetry module to test your changes.

If you plan on modifying code and submit your work back to the project, create your own local branch from this one for your changes. The normal procedures for [https://wiki.secondlife.com/wiki/Open_Source_Portal Open Source contributions to Second Life] apply.

<h2>The Inverse Kinematics algorithm</h2>

The "Inverse Kinematics problem" is often encountered in the fields of video games, computer animation, and robotics. It is the situation where the final position and/or orientation of one or more bones within a hierarchical skeleton are specified or "known" while those of the rest of the system are "unknown". The bones with known transforms are called "end-effectors" and their target transforms are called "goals". The challenge is to compute transforms for ALL of the bones in the system such that the end-effectors achieve their goals, or approach them as close as possible.

There are several IK algorithms to choose from. They are all iterative in nature: each time the algorithm is applied the new result gets closer to an acceptable solution. The iterations are stopped when the end-effectors are "close enough" to their goals, or when the time/compute resource budget is exhausted. However, achieving the goals is often insufficient criteria for the IK problem. There are typically an infinite number of solutions but they are not equally valid because some will require joints to bend in unnatural directions. Therefore not only must the end-effectors reach their goals but the joints of the skeleton must be "constrained" to only orient within their limits: the elbow pivots about a fixed local axis within a limited angle range and the forearm is limited in how much it can twist.

Example IK algorithms include: Continuous Cyclic Descent (CCD), Jacobian pseudo-inverse, and [http://www.andreasaristidou.com/publications/papers/FABRIK.pdf Forward And Backward Reaching Inverse Kinematics](P) (FABRIK). The Second Life Puppetry system uses an implementation of FABRIK with joint constraints. At the moment the constraint parameters are hard coded in the C++ and are specified only for: spine, arms, and head. The legs and other bones are currently unconstrained. The pelvis is immovable: it represents the origin of the root-frame.

<h2>Working Together</h2>

We would love to hear from you about any ideas and creations you have with this technology. There are a lot of possibilities and different ways we can open up Second Life for more fun. Please join in our conversation with user groups, forum postings and show us what you like.

Puppetry Development

2022-08-30T18:18:17Z

Dan Linden:

Puppetry Development

<h2>Summary</h2>

This article will explain how developers can experiment and code with the new Puppetry feature in Second Life. It is intended for programmers who have a familiarity with Python or C++ and a desire to make their avatar come alive.

<h2>Second Life Open Source Viewer</h2>

Puppetry requires an experimental Second Life Viewer. A pre-built version is available for download from the [https://releasenotes.secondlife.com/viewer.html alternative downloads page]. If you're only developing Puppetry plug-ins there is no need to build the Viewer from scratch. However, if you want to make changes to messaging, avatar animation system, or the [https://en.wikipedia.org/wiki/Inverse_kinematics Inverse Kinematics] (IK) algorithm, then you will need to download and build the [https://bitbucket.org/lindenlab/viewer/src/master/ open-source Viewer code].

<h2>Puppetry feature detection</h2>

To avoid compatibility problems when deploying experimental features Second Life uses a system called "capabilities". Whenever a Second Life Viewer first connects to a Region it submits a list of features it knows how to use and the Region will respond with an URL (capability) for each of those features it supports. Viewers can GET data and status information from the server, or POST to these capabilities to configure and update the server. [https://wiki.secondlife.com/wiki/Puppetry_Network_Control This page] has more information about how the Puppetry capability works. Capabilities are also often referred to as "caps" in some documentation.

<h2>LEAP Plug-ins</h2>

Puppetry expects data from a LEAP plug-in that has been launched by the Viewer as a side process. LEAP stands for LLSD Event API Plug-in and is a technology that has been embedded in the Second Life Viewer for a while but has, until now, only been used for internal testing and automated updates. A LEAP plug-in can be an executable or Python script: the only other requirement is that it read and write properly formatted LEAP data to its stdin and stdout pipes, however only Python utils have been written so far, and all of the existing Puppetry plug-ins are Python scripts.

Clone the [https://bitbucket.org/lindenlab/leap leap repository]to your computer. The Puppetry plug-ins can be found in leap/python/puppetry/examples/ and leap/python/puppetry/webcam/.

You will need Python version 3.6 or later installed on your computer. You will also need to install any Python modules a plug-in depends on. Follow the instructions in the [https://bitbucket.org/lindenlab/leap/src/main/python/puppetry/README.md ReadMe file]. Please read it carefully and ensure you have the requirements met, otherwise Puppetry may not work.

CAUTION: Only run plugins from a source that you trust. Currently there is no safety mechanism to protect against malicious plugins due to this project being in open development.

<h2>Try it out</h2>

When Puppetry is available the following menu item should be enabled:

Advanced → Puppetry → Launch LEAP plug-in...

Select that menu item and it will open a file picker. Navigate to where you downloaded the leap repository and find a plug-in to try. A simple plug-in to try is: leap/python/puppetry/examples/arm_wave.py which will make your avatar slowly wave one arm.

A more complex plug-in is the leap/python/puppetry/webcam/webcam_puppetry.py module. This will start your webcam, and try to recognize your movements and animate your avatar. It's a work in progress - at first release, head motion is reasonably good, but we're not satisfied with arm and hand movement, and have not explored fingers, facial or lips motion.

<h2>Developing Puppetry Plug-ins</h2>

All of the working examples are written in Python and use the [https://www.google.com/url?q=https://bitbucket.org/lindenlab/leap/src/main/python/puppetry/puppetry.py&sa=D&source=editors&ust=1661829588240027&usg=AOvVaw3BoDaCFTw1OKgjZyHFnmDq puppetry.py] module API to submit data to the Second Life Viewer. Data is exchanged between plug-in and Viewer via the plug-in's stdin and stdout streams. This means the plug-in must not write any spurious debug text to stdout, else risk corrupting the LEAP data and confusing the Viewer. To log debug messages during runtime under the Viewer use puppetry.log() and look in the Second Life log file for those messages, alternatively anything written to stderr will be written to the log file.

puppetry.py depends on the leap.py util module, which uses [https://www.google.com/url?q=https://pypi.org/project/eventlet/&sa=D&source=editors&ust=1661829588241012&usg=AOvVaw0Yun5Ay00PRywAYBXYSBox eventlet] to run multiple co-routines on a single thread. A consequence of this is:: any Python Puppetry plug-in must be eventlet friendly by calling eventlet.sleep(0) in its main loop. For best results: follow the pattern used by a working example.

If a plug-in throws an exception and stops running: its callstack information will be written to stderr which always gets echoed to the Second Life log file, so look there for details about what went wrong. If a Python script is crashing immediately it is sometimes possible to run it from the command line interface (CLI) to see the callstack, however depending on where it is crashing it may be the case that your plug-in will first block in the leap.py module waiting for the initial LEAP data it expects to receive from the Viewer. To unblock the leap.py module is possible to manually paste valid LEAP data to its stdin. Look in existing example code to find instructions about how to do that.

<h2>Puppetry data</h2>

The Puppetry data stream is a series of events. Each event is effectively a key:value pair where the key is the joint's name (as listed in the avatar_skeleton.xml configuration file) and the value is its intended transform. The transform can specify position and/or orientation.

The position is always in the root-frame of the avatar skeleton, where the root is the avatar's pelvis and the distance units are "normalized" such that the furthest end of the hand of the avatar's longest arm has a reach of 1.0 units when the avatar is in the T-pose: standing upright with arms extended straight out from the sides: a symmetric avatar standing in T-pose has an arm span of 2.0 units in the normalized root-frame. When the position is received by the Viewer it will be uniformly scaled according to the size of the avatar instance.

The position coordinate frame is "right handed" (e.g. Z equals X cross Y) and the axes are: X=forward, Y=left, Z=up.

The orientation can be specified in the root-frame, or in the joint's parent-frame, and is always represented as a normalized quaternion (XYZW), although only the imaginary part (XYZ) is packed in the event and the real-part (W) is inferred mathematically when necessary.

An example Puppetry event might look something like this:

'mWristLeft':{'pos':[0.05,0.1665,0.5359]},'rot':[-0.07608,0.06912,-0.05754]}

In the example above the orientation is specified in the root-frame. For parent-frame the key would be 'local_rot'.

Each Puppetry data event is applied locally as soon as it is received. It is also given a timestamp and streamed to the Second Life server which relays the data to other nearby Puppetry empowered Viewers. The remote Viewers receive the Puppetry events, and instead of applying them immediately, put them into a jitter buffer from which the Viewer computes interpolated data and applies those at a different frame rate, but typically faster, than the events were received. Consequently, if the local animation looks a little choppy the remote view is typically smoother, albeit slightly delayed. You can view what your own interpolated data looks like enabling the menu option:

Advanced → Puppetry → Use my server data

With this on, you will watch your animations as others in-world see it: sent from the region server.

<h2>Viewer Code Changes</h2>

If you want to experiment with viewer source code, you'll be working in C++ and will need to download the Viewer source code which is [https://www.google.com/url?q=https://bitbucket.org/lindenlab/viewer&sa=D&source=editors&ust=1661829588244562&usg=AOvVaw2dzTEr89Ra3--R4I1CmPjd available on Bitbucket]. Follow the instructions there to download and build the code.

You will need to switch your source code to the DRTVWR-558 branch.

git checkout DRTVWR-558

Search the codebase for "puppetry" and you'll get an idea of where the code is, or for "llik" to find the inverse kinematics implementation. Remember there are multiple components working together here - the interface to the LEAP Puppetry plug-in, which will send data into the viewer while the viewer can send messages into the plug-in to select options such as which webcam to use..

If you modify this code, you'll need to re-build the viewer, launch it and then start your Puppetry module to test your changes.

If you plan on modifying code and submit your work back to the project, create your own local branch from this one for your changes. The normal procedures for [https://www.google.com/url?q=https://wiki.secondlife.com/wiki/Open_Source_Portal&sa=D&source=editors&ust=1661829588245875&usg=AOvVaw3rf7OykcDFdf5dV_kebCfHOpen Source contributions to Second Life] apply.

<h2>The Inverse Kinematics algorithm</h2>

The "Inverse Kinematics problem" is often encountered in the fields of video games, computer animation, and robotics. It is the situation where the final position and/or orientation of one or more bones within a hierarchical skeleton are specified or "known" while those of the rest of the system are "unknown". The bones with known transforms are called "end-effectors" and their target transforms are called "goals". The challenge is to compute transforms for ALL of the bones in the system such that the end-effectors achieve their goals, or approach them as close as possible.

There are several IK algorithms to choose from. They are all iterative in nature: each time the algorithm is applied the new result gets closer to an acceptable solution. The iterations are stopped when the end-effectors are "close enough" to their goals, or when the time/compute resource budget is exhausted. However, achieving the goals is often insufficient criteria for the IK problem. There are typically an infinite number of solutions but they are not equally valid because some will require joints to bend in unnatural directions. Therefore not only must the end-effectors reach their goals but the joints of the skeleton must be "constrained" to only orient within their limits: the elbow pivots about a fixed local axis within a limited angle range and the forearm is limited in how much it can twist.

Example IK algorithms include: Continuous Cyclic Descent (CCD), Jacobian pseudo-inverse, and [https://www.google.com/url?q=http://www.andreasaristidou.com/publications/papers/FABRIK.pdf&sa=D&source=editors&ust=1661829588247012&usg=AOvVaw141bkKuXxzxH9gSzHRMzd Forward And Backward Reaching Inverse Kinematics](P) (FABRIK). The Second Life Puppetry system uses an implementation of FABRIK with joint constraints. At the moment the constraint parameters are hard coded in the C++ and are specified only for: spine, arms, and head. The legs and other bones are currently unconstrained. The pelvis is immovable: it represents the origin of the root-frame.

<h2>Working Together</h2>

We would love to hear from you about any ideas and creations you have with this technology. There are a lot of possibilities and different ways we can open up Second Life for more fun. Please join in our conversation with user groups, forum postings and show us what you like.

Puppetry Mocap

2022-08-30T18:10:56Z

Dan Linden:

<h2>Puppetry Mocap</h2>

This is a high level look at how the [https://bitbucket.org/lindenlab/leap/src/main/python/puppetry/webcam/webcam_puppetry.py webcam_puppetry] module works in the Second Life Puppetry viewer.

This is a high level look at the program logic, showing how the module starts and then enters a main loop where it fetches an image from the camera, tries to find a face and apply position and pose detection, then attempts to locate hand and fingers as well. After enough time has elapsed, it sends the information to the Second Life viewer.

The source code has some comments and more information on how this works, and some of the calculations needed to correct the data and make it work better. The position of the camera can be sensitive here, affecting the quality of the data and how your avatar will look. It's good to experiment with camera placement and see how it interacts with the positions.

As we initially release the Puppetry feature, the data from webcam motion capture is restricted in the Z direction, out of the screen. This means it works best for moving hands around up and to the side, not reaching towards the camera. The pipeline between the raw data and landmarks from the camera to your Second Life avatar in-world is fractured, and the motion isn't right.

There are a lot of complexities to solve to get this right, factoring in the camera setup, person's size and position, speed, capture rate, landmark detection, translation and mapping to Second Life skeleton and dimensions, swapping coordinate systems, broadcast speed, server transmission, inverse kinematics, animation priority and perhaps lag.

PRIM PHYSICS SHAPE NONE

2022-08-09T13:20:51Z

Dan Linden:

{{LSL Constant
|type=integer
|name=PRIM_PHYSICS_SHAPE_NONE
|value=1
|desc=Used with [[PRIM_PHYSICS_SHAPE_TYPE]]. Prims of this type are ignored by the physics engine. Read more details on [[PRIM_PHYSICS_SHAPE_TYPE]]
|notes=[[File:Physics_shape_none.png|thumb|700px|center|'''The physics shape type attribute can be found in the Features tab of the Edit window.''']]
<div style="clear:both;"></div>
|examples
|constants
|functions
|events
|location
|history=
*Introduced in [[Release Notes/Second Life RC LeTigre/11#11.09.09.240509|Second Life RC LeTigre 11.09.09.240509]], September 9, 2011
*[http://www.sluniverse.com/php/vb/scripting/61203-future-physics-functions-tease.html#post1305775 SLUniverse:Future physics functions tease]
|cat1=Prim
|cat2=Physics
|cat3
|cat4
}}

LSL Tutorial

2022-05-16T16:10:51Z

Dan Linden:

{{LSL Header|ml=*}}

== Beginner Tutorials ==
'''[[Getting Ready to Learn LSL]]:''' Before learning LSL, it is helpful to learn the basics of Second Life. Here are some pointers to getting started.

'''[[Help:Getting started with LSL|Getting Started with LSL]]:''' Tutorial for absolute beginners. Basic SL inventory and navigation required.

'''[[Hello Avatar]]:''' A place to try next after Getting Started in LSL.

'''[[A Basic LSL Tutorial]]:''' A tutorial for people who are new to LSL scripting, with basic tasks and LSL scripting terms explained in quick short answers.

'''[[LSL 101: The Wikibook]]:''' A collaborative project to create a "complete" narrative guide to LSL scripting, starting with no assumptions of previous programming experience, and going to ... who knows where?

'''[[Chatbot]]:''' A short tutorial list of concise LSL statements that make a default wood box translucent and bouncy and then kick and spin it along, also a script to run such commands for you.

'''[[DialogMenus|Building a dialog menu step by step]]:''' A tutorial for beginning scripters on implementing a simple menu dialog system. Designed to illustrate the basic principles in layman's language.

'''[[Video Tutorial/Script editor featurettes|Video Tutorial: Script editor featurettes]]:''' Features of the inworld Script editor. Look at [[LSL Alternate Editors]] for external 3rd party editors.

== In-World Tutorials ==

'''[http://slurl.com/secondlife/Star%20Beach%20Island/150/212/22/?x=300&y=300&img=http%3A//cd.bromley.ac.uk/bteccourses/sl/images/shimmer_island.jpg&title=Learning%20in%20Virtual%20Reality&msg=Here%20at%20Shimmer%20island%2C%20I%20shall%20be%20exploring%20the%20potential%20of%20Second%20Life%20in%20support%20of%20my%20current%20trials%20with%20the%20Moodle%20vle%20for%20Virtual%20Learning.%20So%20please%20feel%20free%20to%20drop%20in%20for%20a%20chat%20with%20us%20to%20see%20how%20things%20are%20going.%20Regards%20Skipper%20Abel Bromley College in-world Virtual Learning trials]:''' Please feel free to come over and look around

'''[http://slurl.com/secondlife/Horsa/43/236/84 Many free scripting tutorials that are easy to read at our College of Scripting, Music and Science]:''' Come by to learn scripting and building.

'''Swiss Projects Tutorial, the Swiss Tutorial for Second Life®; interactive, inworld and in the Web, in German:''' das schweizer Tutorial zu Second Life®; interaktiv, inworld und im Web, in deutscher Sprache. SLURL: '''[http://slurl.com/secondlife/swiss%20projects]'''

== External Tutorials ==
'''[http://www.ddj.com/dept/ai/197008520?pgno=1 Using LSL introductory tutorial]''' Dr. Dobb's tutorial

'''[http://xahlee.org/sl/sl/ls.html Linden Scripting Language (LSL) Tutorial]''' Xah Lee's tutorial on LSL

'''[http://people.cc.ku.edu/~grobe/intro-to-LSL/ Using the Linden Script Language]:''' A very comprehensive tutorial on basic scripting from Kan-ed.

== Scripting Tools ==
These tools are designed to '''ease the process of scripting''', whether it's autogenerating scripts or helping you to edit them. Some of them were featured in [http://blog.secondlife.com/2008/07/19/get-started-scripting-with-autoscript-video-tip-of-the-week-42/ Torley's Autoscript post]:

<videoflash>xW619vHfYeg</videoflash>

----

* '''[http://conwylie.co.uk/ScriptGenerator Con Wylie's Script Generator]''' - '''Con Wylie's up-to-date tool''' lets you create a script in a few seconds. A easy to use interface helps you to create your script. this tool is updated weekly, so remember to visit to see what new scripts you can make! The tool can be downloaded for offline use. For when you are on the move a downloadable iOS webapp is just a click away with offline use as well
'''[http://yes.torley.com/post/6321621554/new-super-fast-and-easy-online-scripting-tool-second Torley Linden's Post about Con Wylie's Tool]''' - Con Wylie has an improved LSL Script Generator, so if you’re new at scripting or just want the convenience of making object interactivity easy, check it out!

* '''[http://www.3greeneggs.com/autoscript/ Autoscript]''' - Ann Enigma's versatile tool lets you make a script with a few clicks, then examine and edit it further. Easily add interactivity to your objects and get started scripting! Available in Français and Deutsch too.

* '''[http://web.mit.edu/~eric_r/Public/S4SL/ Scratch for Second Life]''' - Eric Rosenbaums’s app for Mac and Windows which lets you arrange scripts visually as if they were Legos. I haven’t had a chance to even scratch (ha!) its surface yet, but watch Eric’s video to better understand:

* '''[http://particles-lsl-generator.bashora.com/ Particle script generator]''' - This formatted webpage may be easier to use than SL’s own script editor. Change your parameters and try it out inworld.

* '''[http://www.miceonabeam.com MiceOnABeam Visual Scripting Tool]''' - MiceOnABeam is a visual programming tool that generates LSL scripts for SL. You choose among graphical modeling components to specify the program flow of your script in terms of states and the events that transition between the states. You can then use the built-in LSL Action Wizard or insert your own LSL code to specify what happens when an event occurs. The program then generates the LSL code for the model to form a complete script for the SL environment. Check out the demo video '''[http://bit.ly/ihCqyf here]''' or on '''[http://www.youtube.com/watch?v=LBA8wvoA9EI YouTube]'''. A Free version can be downloaded from '''[http://www.miceonabeam.com here]'''.

== Books on LSL ==
These are real-world books with significant content on LSL and the process of scripting.
----

* '''[http://www.wiley.com/WileyCDA/WileyTitle/productCd-0470171146.html Creating Your World: The Official Guide to Advanced Content Creation for Second Life]''' - '''Creating Your World''' is a Linden Lab approved text book on content creation, including a chapter on beginning scripting and LSL. There is a free sample chapter (on building) available at the publisher's site. The book is available from [http://www.amazon.com/Creating-Your-World-Official-Advanced/dp/0470171146/ bookstores] everywhere.

* '''[http://syw.fabulo.us Scripting Your World: The Official Guide to Second Life Scripting]''' - '''Scripting Your World''' is a Linden Lab approved reference on LSL and an example-based textbook on LSL scripting. The first chapter (a language reference) is available for free from the publisher and the support site. The authors have published additional [http://syw.fabulo.us/wiki/Bonus_Material free chapters] on a variety of topics. Scripting Your World is available from [http://www.amazon.com/Scripting-Your-World-Official-Second/dp/0470339837/ Amazon] and other online and physical bookstores, in paperback and several electronic forms.

* '''[http://www.heatonresearch.com/category/programming-language/linden-scripting-language Jeff Heaton's books on LSL]''' '''Introduction to Linden Scripting Language for Second Life''' and '''Scripting Recipes for Second Life''' are independent books on scripting. Much of the content is available at the Heaton Research website as free articles. The books are available from bookstores as well as electronically.

[[Category:Tutorials]]
[[Category:LSL Tutorials]]

Viewer parameters

2022-05-02T21:42:55Z

Dan Linden: /* Command line */

{{Help|Viewer=*}}

For versions of Second Life prior 1.20 see: [[Pre 1.20 Client parameters]]

== Using Viewer parameters ==
There are many ways of passing command line parameters to the Viewer.

=== Command line ===

When running the Viewer from a command shell you may specify parameters directly on the command line. For example, on Windows:

SecondLife.exe --channel "Test 123" --settings settings_workspace.xml --set InstallLanguage en

Add --args on Mac:

open ./Second\ Life\ Viewer.app --args --channel "Test 123" --settings settings_workspace.xml --set InstallLanguage en

=== Settings Files ===

On all platforms, you can also construct a settings file and specify that with the <tt>--sessionsettings</tt> command line switch. Please see the table below to understand the settings variables engaged by each command-line switch.

If you edit the user_settings/settings.xml file, that affects future Second Life sessions initiated from your OS account.

Alternatively, you can edit the first_last/settings.xml file, which affects only Second Life sessions for that login user. For example, if your Second Life name is "FooBar Baz", you should find that file in foobar_baz/settings.xml. (Caution: this file uses a different XML format than the other settings files.)

=== Mac OS X AppleScripts ===
An alternative (and often easier) way to launch Second Life with command line parameters is to use an AppleScript.

Follow these steps:

<ol>
<li> In <code>/Applications/AppleScript</code> open Script Editor.
<li> Open a new document and paste the following text into it:
<pre>do shell script "\"/Applications/Second Life.app/Contents/MacOS/Second Life\" -grid Aditi"</pre>
The script includes an example parameter that will cause the Viewer to log in to the beta grid; change the parameters as desired.
<li> Once you're happy with the parameters, click "Compile"
<li> Choose File > Save As
<li> Save the script as an Application, and select "Run Only" (may be "Execute" on OS X.4 Tiger). If you want to tweak the script then you can save it as not run-only, and/or save a copy as "Script".
</ol>

Double-click the application you've compiled to launch the Viewer with the specified parameters.

NOTE: If the Viewer launches then immediately quits, open it normally since there is likely an update available:
download it and your script will work again. There is a [http://jira.secondlife.com/browse/VWR-5835 JIRA issue] for this.

=== Visual Studio ===
In Visual Studio, the command line paramaters are in the Debug Options pane of the newview project preferences. Ensure newview is your startup project, and launch the compiled viewer from within the debugger for these options to take effect.

=== XCode ===
In XCode, first select "newview" under the "Executables" group in XCode. Then open the "Get Info" dialog and click the "Arguments" tab. Add any of the following options to the "Arguments to be passed on launch" pane.

== Parameter reference ==

NOTE: A ''parameter'' refers to a directive provided on the command-line following a double-dash (--).
An ''argument'' is a value provided for a parameter. For example in <code>--port 13001</code>, "port" is the parameter
and "13001" is the argument.

{| {{Prettytable}}

|-{{Hl2}}
! Parameter
! Argument (if any)
! Description
! Overridden Setting

|-
| --analyzeperformance
| None
| Compare gathered metrics with baseline. Must be used with --logmetrics or --logperformance.
| AnalyzePerformance

|-
| --autologin
| None
| Login in as last saved user.
| AutoLogin

|-
| --channel <name>
| Channel name
| Specify version channel name. (For Testing)
| CmdLineChannel

|-
| --console <show>
| TRUE ''or'' '''FALSE'''
| Show a debugging console (Windows only)
| ShowConsoleWindow

|-
| --cooperative <ms to yield>
| Milliseconds to yield per frame
| Yield specified time to host on each frame.
| YieldTime

|-
| --crashonstartup
| None
| Crashes on startup. For debugging.
| CrashOnStartup

|-
| --debugsession
| None
| Run as if RenderDebugGL is TRUE, but log errors until end of session.
| DebugSession

|-
| --debugviews
| None
| Enable UI view debugging information.
| DebugViews

|-
| --disablecrashlogger
| None
| Disables the crash logger and lets the OS handle crashes.
| DisableCrashLogger

|-
| --drop <percentage>
| Percentage to drop (0 - 100)
| Specify a percentage of packets to drop.
| PacketDropPercentage

|-
| --god
| None
| Login in [[God Mode|god mode]] if you are authorized.
| ConnectAsGod

|-
| --graphicslevel
| integer level
| override the level that would be selected based on your gpu
| RenderQualityPerformance

|-
| --grid <grid name>
| Grid name
| Specify the grid to connect to. Must specify either a hard-coded grid (agni or aditi), or one defined in grids.xml
| CmdLineGridChoice

|-
| --help
| None
| Show a message box with available options listed.
| N/A

|-
| --helperuri <URI>
|
| '''Obsolete'''- no longer supported. May only be set in the grid definition (grids.xml)
|

|-
| --ignorepixeldepth
| None
| Ignore pixel depth settings.
| IgnorePixelDepth

|-
| --inbw <bits>
| Bits per second
| Specify input bandwidth limit.
| InBandwidth

|-
| --loginpage <URL>
|
| '''Obsolete'''- no longer supported. May only be set in the grid definition (grids.xml)
|

|-
| --loginuri <URI>
|
| '''Obsolete'''- no longer supported. May only be set in the grid definition (grids.xml)
|

|-
| --logfile <filename>
| File name
| Specify a file name for log output.
| UserLogFile

|-
| --login <firstname> <lastname> <password>
| Account first name, last name, and password with which to log in.
| Specify login values.
| UserLoginInfo

|-
| --logmetrics
| MetricName
| Log metrics data in MetricName.slp. See [[Performance Testers]] for details.
| LogMetrics

|-
| --logperformance
| None
| Log performance data in performance.slp. See [[Performance Testers]] for details.
| LogPerformance

|-
| --multiple
| None
| Allow multiple viewers running concurrently.
| AllowMultipleViewers

|-
| --no-verify-ssl-cert
| None
| Disable SSL certificate verification.
| NoVerifySSLCert

|-
| --noaudio
| None
| Disable sound from the client.
| NoAudio

|-
| --noinvlib
| None
| Do not request inventory library.
| NoInventoryLibrary

|-
| --nopreload
| None
| Disable precaching of sound and bitmaps used by the client.
| NoPreload

|-
| --noprobe
| None
| Disable hardware checking at startup.
| NoHardwareProbe

|-
| --noquicktime
| None
| Disable use of quicktime by the client.
| NoQuickTime

|-
| --nosound
| None
| Disable sound from the client.
| NoAudio

|-
| --novoice
| None
| Disable voice chat.
| CmdLineDisableVoice

|-
| --outbw <bits>
| Bits per second
| Specify output bandwidth limit.
| OutBandwidth

|-
| --port <n>
| Port number
| Set the TCP port for the client; useful to run multiple instances of SL on the same local home network. Values that may work: 13000 and 13001 (Valid numbers are 13000 to 13050)
| UserConnectionPort

|-
| --purge
| None
| Force the client to clear cached downloads during startup.
| PurgeCacheOnNextStartup

|-
| --qa
| None
| Enable UI features for used for testing.
| QAMode

|-
| --quitafter <secs>
| Number of seconds to wait before quitting
| Have the client quit after the specified duration.
| QuitAfterSeconds

|-
| --replaysession
| None
| Use a saved autoplay file to perform viewer actions automatically. Must be used with --autologin.
| ReplaySession

|-
| --rotate
| None
| Force the avatar to rotate to the right. (For Testing)
| RotateRight

|-
| --safe
| None
| Reset preferences and run in safe mode.
| SafeMode

|-
| --sessionsettings <filename>
| name of a file in app_settings
| Use '''settings_minimal.xml''' to force Basic mode on login, an invalid name like '''none''' to force Advanced mode. Note that currently (2.6) the login screen mode menu will show "Basic" if this setting appears at all, but the command line setting will still override on actual login.
|

|-
| --set <parameter> <value>
| First argument is the name of setting; second is the value to assign to it.
| Specify the value of the named setting (view a full list [[Debug_Settings|here]]).
| Maps to <setting> arg.

|-
| --setdefault <parameter> <value>
| First argument is the name of setting; second is the value to assign to it.
| Specify the value of a particular configuration variable which can be overridden by settings.xml.
| Maps to <setting> arg.

|-
| --settings <filename>
| Local file name
| Specify the name of the user settings file.
|

|-
| --skin <folder>
| Folder name
| Specify the skin folder to use. (eg. korean, spanish)
| SkinCurrent

|-
| --slurl <SLurl>
| SLurl
| Specify the starting region and position (for example, secondlife://Ahern/128/128).
This must be the last parameter on the command line.
| CmdLineLoginLocation

|-
| --update-service <url>
| base url for the viewer version manager update query
| Specify the viewer version manager service to use (primarily for upgrade testing)
| CmdLineUpdateService

|-
| --url <SLurl>
| SLurl
| Specify the starting region and position (for example, secondlife://Ahern/128/128).
This must be the last parameter on the command line.
| CmdLineLoginLocation

|-
| --usersessionsettings <filename>
| name of a file in app_settings
| Specify the filename of a configuration file that contains temporary per-session configuration user overrides.
|

|}

== Specifying new command line parameters ==

To add a new command line parameter, use the configuration file ''app_settings/cmd_line.xml'' to map a command line paramter to a user setting.
A parameter can have the following options:
* desc - A description of the paramter.
* short - a single character to map to the paramter.
* count - the number of tokens to follow a option.
* compose - true if the option can be specified multiple times.
* positional - true if the option can be specified without --name.
* last_option - true if the option should be the last option.
* map-to - specify a user setting to map the option to.
The file uses [[LLSD]] syntax. Use the existing options as reference.

== Examples ==
=== Setting a Custom Cache Location ===
To set a custom cache location when launching Second Life, you should use the <code>set</code> parameter with a value of <code>NewCacheLocation</code> followed by the desired cache folder to use. This will tell Second Life to startup using this location as a new cache location.<br>

'''Example:''' <code>--set CacheLocation j:\SL_Cache --set NewCacheLocation j:\SL_Cache</code>

'''NOTE''':
Per '''STORM-334 ''' The double command above <span style="text-decoration: line-through;">will</span> should retain the previous cache and switch to the new cache.

Using just NewChacheLocation will clear any existing cache folder that it has been using. So, to prevent this you can also the <code>CacheLocation</code> setting to the same value and ahead of NewCacheLocation, which will preserve any cache folder saved in your viewer settings.

This allows you to, use two different shortcuts in order to launch two different Second Life accounts, each with their own separate cache folder, allowing each to have a fully cached home location, for example. Or, a more complex case, a shortcut could create a temporary RAM disk for use as a cache folder, and set this value for Second Life to use, taking advantage of a RAM disk's speed, before saving the contents to disk afterwards.

{{KBnote|This command is not working with the Project Bento Viewer 5.0.0.315657 or the current default viewer 4.0.5.315117. These viewers do, however, automatically create separate inventory caches for each grid. As an alternative, you can use [[#Command_line|separate settings files]] as above, then use the normal preferences route to set a custom cache location.}}

Render Correctness Test

2022-03-03T19:39:33Z

Dan Linden: /* Water rendering */

{{OSWikiFeatureNav|parent=Render Correctness}}
[[Category:Test Scripts]]

== Purpose ==
Test expected render behavior for 3.0 and newer viewers.

=== Terrain rendering ===

* Verify terrain mesh detail defaults to High when Graphics Quality is set to Mid or higher.
* Verify terrain mesh detail defaults to Low when Graphics Quality is set to Low.
* Verify terrain detail textures change according to elevation. (screenshot from http://maps.secondlife.com/secondlife/Bug%20Island%202/88/98/23)
[[File:Terrain_rendering.jpg]]

=== Windlight rendering ===
* Set Graphics quality to High.
* If Atmospheric shaders is still disabled, skip to the next section.
* Verify you can see clouds in the sky like this picture from http://maps.secondlife.com/secondlife/Bug%20Island%202/88/98/23
[[File:Windlight_clouds.jpg]]

=== Water rendering ===

* Verify that the Transparent Water shader is disabled when Graphics Quality is set to Low.
* Verify that the Transparent Water shader is enabled when Graphics Quality is set to Low-Mid or higher.
* Uncheck Transparent Water and verify the water surface appears opaque from above and below water.
* Check Transparent Water and verify the water surface appears transparent from above and below water.
* Put camera under water, verify that fog changes. There is generally more fog below water than above water.
* Turn on Preferences > Graphics > Advances Settings > Basic Shaders and Transparent Water. ''(Basic shaders cannot be enabled if OpenGL < 2.0. The OpenGL version can be found in Help menu -> About Second Life. If OpenGL < 2.0, skip to the next section.)''
* Verify that sun/moon reflections appear on surface of water.
* Verify that water appears to have animated waves.
* Put camera under water and verify that objects above water appear distorted by the waves.
* Move the sun to Midday ({{KeyCombo|ctrl=*|shift=*|Y}}) and verify that water looks appropriate.
[[File:Water1.jpg]]

=== Water Reflections ===

* Confirm Basic Shaders and either Transparent Water or Bump mapping is enabled in Preferences > Graphics > Advanced Settings.
* Find Water Reflections in Preferences > Graphics > Advanced Settings
* Select "Terrain and Trees" water reflections and verify you see the land and trees reflected in the water.
* Select "All Static Objects" and verify that now in addition to the trees and terrain, you see unmoving objects reflected.
* Select "All Avatars and Objects" and verify that you and other avatars are now being reflected as well.
* Select "Everything" and verify that all terrain, trees, objects, avatars, and particles are now reflected in the water.

=== Avatar rendering ===

* Verify that the avatar is lit by the sun/moon
* Right click on your avatar and Edit My Shape.
* Verify that avatar renders properly in the preview panels.
* Repeat with Hardware Skinning enabled/disabled in preferences.

=== UI Rendering===

* Turn on property lines and land owners from World > Show menu.
* Verify all appear correctly.
* Turn on stats bar with ctrl-shift-1
* Verify that text appears correctly in statistics bar.
* Enable World menu > Show > Beacons, and check the Scripted check box.
* Enable Beacons and Highlights
* Verify Beacons and Highlights appear on scripted objects [need a picture here]
* Open the Develop menu with Ctrl-Alt-Q, turn on Develop > Show Info > Show Updates to Objects.
* Find a scripted object and verify that update hints are being rendered (should look like red or blue spots rising from the center of the object. Blue spots will rise from your avatar if you walk).
* Hold mouse cursor over an avatar and verify the tooltip renders properly.
[[File:Tooltip1.jpg]]
* Select an object. (eg. the Kart from the Library)
* Verify silhouette outline renders correctly.
[[File:Object select.jpg]]
* Edit an object.
* Verify that the root prim (the seat) has a yellow outline while the other prims have a blue outline.
[[File:Object_edit_2.jpg]]
* Verify a particle beam projects from your hand to the object you are editing.

=== Object Rendering ===
''[make objects for these tests to speed testing]''
* Make a cube.
* Change its color.
* Move the cube. '''Verify''' color remains the same.
* Make cube transparent.
* Move the cube. '''Verify''' color remains the same.
* Turn on the Bump mapping and shiny shader in preferences.
* Give cube a texture with an alpha mask that is 100 transparent in some area. (eg. Inventory/Library/Textures/*Default Transparent Texture)
* Close the edit tools
* '''Verify''' you can click through the mask (the transparent section) with alt-zoom.
* '''Verify''' you can right-click your avatar through the mask.
* Attach the cube to your HUD.
* '''Verify''' the HUD attachment has full bright lighting and looks the same if you toggle Full Bright on and off in the Texture panel of edit tools.
* '''Verify''' the HUD attachment is not lit by the sun or moon when you look around.
* '''Verify''' the mask part of the HUD attachment does not block alt-zoom unless in edit mode.
* '''Verify''' you can select the HUD attachment when in edit mode.
* Attach a default script to the cube HUD attachment.
* '''Verify''' HUD attachment responds to left click.
* '''Verify''' you can right click your avatar through the cube attachment's mask.
* Detach the cube
* Make a sphere
* Change the sphere's color.
* Make it shiny medium and '''verify''' it appears shiny.
* Move the sphere. '''Verify''' color remains the same.
* Give the sphere a bump map.
* '''Verify''' that bump map is visible.
* Attach the sphere to your HUD.
* '''Verify''' the sphere is still shiny and bump mapped.
* '''Verify''' the sphere is not lit by the sun or moon when you look around. [https://jira.secondlife.com/browse/SH-2646 SH-2646]

=== Sculpty Rendering ===

* Rez the sculpty horse from My Inventory/Library/Objects/Sculpt Prims - Examples/Horse (Sculpt Prim Example) - by Nomasha Syaka
* Verify you see a collection of blobs that resolves into a brown and white running horse withing a few seconds.
[[File:sculpty_horse.jpg]]

=== Highlight rendering ===
* Create 2 cubes, make one 100% transparent and the other 50% transparent.
* Enable the Advanced menu with ctrl-alt-D or with Preferences > Advanced > Show Advanced Menu
* Turn on Advanced menu > Highlighting and Visibility > Highlight Transparent.
* Verify both cubes are highlighted with a red tint.
* Attach both cubes to your HUD
* Verify both cubes on your HUD are highlighted with a red tint.
* Turn off Advanced menu > Highlighting and Visibility > Highlight Transparent.

=== Render order ===
* Attach a semi-transparent cube to your HUD if you don't already have one.
* Turn on World menu > Show > Property Lines. Verify the property lines do not draw in front of hills or solid objects or your semi-transparent HUD object.
* Open the world map and click on a location nearby, and close the world map
* Verify the red column is only visible above ground, and not as it passes below ground.
* Turn off World menu > Show > Property Lines.
[[File:Render_order1.jpg‎]]

=== llSetText rendering ===

* Attach a semi-transparent cube to your HUD if you don't already have one.
* Add the following script to the cube attachment.

<pre>
default
{
state_entry()
{
while(1)
llSetText("Hello, Avatar!",<llFrand(1),llFrand(1),llFrand(1)>,llFrand(1));
}
}
</pre>

* Verify you can see the SetText message rapidly changing colors on the HUD object.

=== Appearance mode rendering ===

* Right click your Avatar and "Edit My Shape".
* Verify you can see the thumbnail images for your avatar.
* Edit your Skin.
* Change your skin color, Save All, and exit appearance mode.
* Verify your avatar textures rebake after a few seconds and that your skin color is correct.

=== Shaders ===

* Go to http://maps.secondlife.com/secondlife/Bug%20Island%202/243/247/23
* Set your shaders and sun position as indicated on the red sphere at that location.
* Verify the spheres render the same as they appear in the picture at that location.
* Continue testing at the 5 stations to the South.

=== Glow + transparent ===
* Go to http://maps.secondlife.com/secondlife/Bug%20Island%202/244/175/23
* Verify the sphere is invisible when Basic Shaders are off.
* Verify the sphere is glowing when Basic Shaders are on.

[[Category:QA Portal]]
[[Category:Quality Assurance]]

Content Creation User Group

2021-01-14T21:05:39Z

Dan Linden:

The Content Creation User Group meeting is a weekly, public meeting intended for discussion of issues around content creation, including avatars, animations, mesh, etc. Vir Linden is the moderator. Please bring questions, requests, and especially cool new things to show off!

Normal schedule is to meet every Thursday at 1:00PM SLT, except the second and fourth Thursday of the month. Exceptions will be noted here. [https://second.life/calendar SL Public Calendar]

== Upcoming meetings ==

Location: meetings are held on the main grid at http://maps.secondlife.com/secondlife/Hippotropolis/71/172/29

The meeting schedule is maintained on the [https://second.life/calendar SL Public Calendar]

== Agenda ==
* Open Q&A

Notes
* Animesh is out as the default viewer should work everywhere. [https://wiki.secondlife.com/wiki/Animesh_User_Guide user guide], [https://community.secondlife.com/forums/forum/354-animesh/ forum]
* Bakes On Mesh is out as the default viewer, should work everywhere. [https://community.secondlife.com/knowledgebase/english/bakes-on-mesh-r1512/ knowledge base], [https://community.secondlife.com/forums/forum/355-bakes-on-mesh/ forum]
* Project EEP, which gives advanced configurable windlight environments for regions and parcels, is out as as the default viewer and supported everywhere. See [https://community.secondlife.com/forums/topic/428374-environmental-enhancement-project-aka-eep-feedback-thread/ the forum thread] for details.
* ARCTan, a project to update rendering cost, land impact, and related things like mesh upload costs, is in progress.


=== User Questions & Topics ===

Newbie Test

2021-01-13T21:58:38Z

Dan Linden: /* Newbie's Experience */

{{OSWikiFeatureNav|parent=First Login}}
[[Category:Test Scripts]]

= Newbie's Experience =

== Setup ==

* Create a new user account using the usertool or via secondlife.com.
** for this test, skip the avatar selection test when signing up via secondlife.com.
** for this test, skip the part that gives you some L$.
* Uninstall all versions of Second Life to clear all settings and cache files.
* Install Second Life.

* This test requires a second user which does not need to be new.

== Log on to the new account. ==

* After logging in you should see the Terms of Service Agreement. Accept it.

* A Critical Messge containing Second Life Community Standards should appear. Click "Continue".

* You will continue to log in and be asked if you wish to play streaming media.

* You should see a dialog asking you to choose a gender. (If you have selected this at the registration page, this option is not available)

* Click one of the buttons to choose a gender.

* The "Play Music"/"Disable" modeless dialog is now visible. Click the "Play Music" button. Verify you hear something.

* Press the F1 key to open Help, Read thru several pages of online help and verify links/buttons work and are correct.

* Verify Home takes you to a help index page listing the various help topics available.

* Verify the "Back" and "Forward" buttons behave as expected for a browser

* Check that previously visited links are highlighted in a different color. (this no longer happens. should it?)

* Close the help.

* Click on Help/Message of the Day. Verify that multiple clicks will not bring up multiple copies. (this doesn't exist? -[[User:Maestro Linden|Maestro Linden]] 14:47, 9 October 2008 (PDT))

* Check the build/sim info is correct from the Help/About SecondLife... Verify that multiple clicks will not bring up multiple copies.

* Verify that you are in a Orientation Island / Help Island sim at an appropriate start location.

* Check your Edit/Preference, they should all have default values. (this should be detailed and tested in some other test)

* Verify you are the gender you chose, you are fully clothed & you look good.

* Check your profile. See that the name is correct and all data fields are empty. Your reputation should be zero.

* Verify your World/Account History with correct name, data & balance of L$0. Verify balance matches what is shown at top right of screen.

* Verify you cannot create objects at the start location.

* Verify the minimap is open. (it's not. should it be?)

* Verify you appear on the minimap as a green dot. (you should appear as a ''yellow'' dot with a white center... -Merov)

* Open you Inventory by clicking the Inventory button.

* Verify that the Inventory contains the following folder in alphabetically order. Animations, Body Parts, Calling Cards, Clothing, Gestures, Landmarks, Lost And Found, Notecards, Objects, Photo Album, Scripts, Textures, Trash. (These have changed slightly, trash is now lost&found, also now have sounds folder - Pixel 1/14/2010)

* Check that you can wear the shapes in the inventory/Body Parts ( no body parts in user inventory, so tried wearing Library inventory body parts instead. - Pixel 1/14/2010)

* Verify you have no calling cards.

* Check that you can wear all the clothing in the inventory/clothing folder and the descriptions are correct. ( no outfits in user inventory, so tried wearing Library inventory outfits instead. - Pixel 1/14/2010)

* Verify that there is a Welcome Note in the Library/Note Cards folder, and that you can read it.

* Verify that there are several snapshots in the Library/Photo Album folder, and that you can view them.

* Verify that there is a Rotation Script in the Library/Scripts folder, and that you can read it.

* Verify a few of the textures in Library/Texture subfolders have correct descriptions and can be viewed.

* Verify trash in inventory is empty. (assuming trash == lost and found - Pixel 1/14/2010)

* Teleport off Orientation Island to mainland using the Library/Landmarks/Welcome Area on Mainland landmark.

* Rez out each object from the Library/Objects inventory: examine each object is intact, looks right and has correct name & description

* Verify all inventory scripted objects work accordingly

* Delete all rezed objects

* Verify all audio sounds works in Library/Sounds inventory

* Verify a few randomly sampled gestures work in the Active Gesture window.

* Teleport Home using World/Teleport Home

== Appearance: ==

* Login in with two accounts A and B

* With B observing A and vice versa, verifying each step

* A: Right click your Avatar, click on appearance. Save the current appearance by clicking on Make Outfit/Ruth. Verify that a folder named Ruth is created in the Inventory/Clothing folder.

* A: Create 4 new outfits:2 Males: Male-tall and Male-short and 2 Females: Female-fat and Female-skinny. Verify all 4 outfits are created in inventory/Clothing folder in alphabetical order

* A: Interchange the outfits by dragging the whole folder from inventory to the avatar.

* A: Verify that items you are wearing are identified by a "(worn)" behind it

* A: Take off worn clothing items by right-clicking on the items from inventory/Clothing and click on "Take off of Avatar"

* A: Verify that you cannot take off body parts that you are wearing.

* A: Try on single items by double clicking on item from Inventory/body Parts and Inventory/Clothing

* A: try on single pieces of body parts/clothing by right-clicking on items from Inventory/body Parts and Inventory/Clothing and click on "Wear on Avatar"

* A: Delete some clothing items and verify they are moved to trash

* A: Verify you can not delete items that you are currently wearing

* A: Verify you cannot move items that you are currently wearing into trash.

* A: Verify you can not delete/move to trash, the clothing folder that you are currently wearing

* A: offer individual items in body parts and clothing to B by dragging the items to B

* B: accepts some and denies some. Open the inventory window and verify items that are accepted end up in the clothing folder

* B: Try on the newly accepted items.

* A: offer the 4 newly created outfits to B by dragging the folders one at a time to B

* B: Accept 3 outfits: 2 male, and the Female-fat and deny Female-skinny. B should have 3 new folders of clothing. in inventory

* B: Verify that the accepted folders are in inventory's top level, and they contain exactly the same items in A's inventory

* B: Try on all 3 new outfits. Make sure they come out correct

* B: Delete Female-fat folder and empty trash in inventory

* A: Logout. Re-install SecondLife. Log back in. Verify you look the same

* B: Check out A and make sure it looks the same before and after logout./in.

* A: Verify your contents in the inventory are the same

* A: Try on all the outfits again. Make sure they come out correct.

== Tracking: ==

* A: Right-click B and Add friend

* B: Accept A's friendship

* A+B: Open the Friends window, click on the other's name and enable "Can see me on the map"

* A+B: Verify that your calling card folder indicates B/A online and B/A's names are enabled in Map/Tracking drop down menu

* A: Logout

* B: Verify A in calling card folder says offline, and A in Map/Tracking drop down menu is disabled.

* A: Log back in

* A+B: Same state as #68

* A: Fly a to a different region

* B: Track A from Map/Tracking as a red circle on the map

* A: Fly across a boundary

* B: Verify the red circle moves according to A's motion/direction

* B: Follow A by flying in the direction of the red arrow on your screen. See that the green dot approaches the red circle on the map.

* B: When the green dot meets the red circle, look for a red column entrapping A

* A: Fly across two regions

* B: Follow A by click on the name A from the Map's Tracking pull down menu. Fly in the direction of the red arrow to reach A

* B: See the green dot approaching the red circle on the map. When you stop flying, look for a red column entrapping A

== Attachments: ==

With B observing A and verifying each step

* A: Rez in the party hat, attach it to your head

* A: Edit the party hat while still attached to the head. Make it bigger, change the color and wear it tilted on the side of the head

* A: Rez in the parrot. Attach it to your shoulder

* A: Rez in the popgun. Follow the instructions and learn how to attach, target and shoot it.

* B: Rez in the hand lamp, attach it to your right hand. Make it bigger change the color and rotate it.

* B: Detach it and attach it back to the right hand. Make sure it goes back to the previous state.

* A: fly to a different region. Verify that your attachments: hat, Pop gun and Parrot are still in the same state

* B: follow A and make sure A looks the same before and after crossing region

* A: Teleport to the Boardwalk from the Inventory/landmark.

* A: Verify that your attachments: hat, Pop gun and Parrot are still intact

* B: follow A by teleporting and make sure A looks the same

* A: log out and log back in, make sure all the attachments stay the same

* B: check that A looks the same before and after logout/login

* B: Fly away from the A until A is not in focus. Fly back to A, check that A looks the same with the attachments

* A: Go back home using World/Teleport Home.

* A: Verify that your attachments: hat, Pop gun and Parrot are still intact

* B: follow A by teleporting and make sure A looks the same

* B: create a box, and sit on it

* A: sit on the box next to B, verify the attachments are still good

* A: Get up. Verify the attachments are still good

* B: Verify A's attachments are still good

== Profile: ==

* A: click on pie menu/my profile and start modifying your profile. Click OK to save

* B: Check A's profile, make sure it's updated.

* A: log out and log back in. check that the profile is preserved.

* B: Verify A's profile is the same before A's login and logout.

* A: Modify the profile. Click OK, and close. Reopen to see the updates.

* B: Verify A's profile is updated appropriately.

== Clean up ==

* B: Get up and delete the box. Detach the hand lamp, delete it. Empty the trash

* A: detach the popgun, the parrot and the hat. Delete them all. Empty the trash

Third Party Viewer Directory/Kokua

2021-01-11T21:53:29Z

Dan Linden:

=={{TPVD-Icon|Kokua}} Kokua==

{{TPVD-Detail
|home=https://kokua.atlassian.net/wiki/spaces/KKA/overview?mode=global
|privacy=https://kokua.atlassian.net/wiki/spaces/KKA/pages/15237184/Privacy+Policy
|download=https://kokua.atlassian.net/wiki/spaces/KKA/pages/15237201/Downloads
|source=https://bitbucket.org/kokua
|supportemail=chorazinallen'' at ''gmail'' dot '' com
|slcontact=Chorazin Allen
|rlcontact=
|platforms={{TPVD-Platform|Windows|showtext=1}}{{TPVD-Platform|MacOS|showtext=1}}{{TPVD-Platform|Linux|showtext=1}}{{TPVD-Platform|Linux64|showtext=1}}
}}
Kokua provides releases for PC, Mac and Linux with and without Marine Kelley's RLV together with a broad selection of original features and the best from other viewers.

Kokua aims to be the viewer of choice for RLV users who want Marine Kelley's original implementation with more bells and whistles than Marine's own viewer.

{{TPVD-Footer}}

Viewer Materials Smoke Test

2020-05-28T00:27:27Z

Dan Linden: /* Rendering with Normal Maps */

= Overview =
* This test plan covers viewer-side support for the prim materials project, which provides support for normal maps and specular maps applied to object faces
* A high-level specification of this featureset can be found at [[Material_Data]]

= Build Tool Test =

== Required Materials ==
* A region which supports normal and specular maps
** As of [[Release_Notes/Second_Life_Server/13#13.02.08.270166|Second Life Server 13.02.08.270166]], materials support is in the server.
* Three test users
** UserA, who uses a viewer which supports normal and specular maps, and does the building (actually performs operations)
** UserB, who uses a viewer which supports normal and specular maps, and only observes the results of UserA's work
*** The purpose of this user is to verify that build tool edits sent by UserA's viewer produce congruent results
** UserC, who uses an 'old' (no support for normal and specular maps) viewer, and only observes the results of UserA's work
*** The purpose of this user is to verify that edited content looks reasonable on legacy viewers, and sometimes to verify that build tool settings from the new viewer have the same appearance as those set by the legacy viewer.
** UserA and UserB should have "Advanced Lighting Model" enabled under Preferences -> Graphics settings, under "Advanced". This setting is required for the viewer to render normal and specular maps properly.
* Upload the following textures to use in this test:
** [[:File:TestDiffuse001.png]]
** [[:File:TestNormal001.png]]
** [[:File:TestSpecular001.png]]

== Verify Basic Build Tool Layout ==

=== Verify that non-Texture portions of the build tool have not changed ===
# UserA, UserB, and UserC: login
# UserA and UserC: each rez a box
# UserA and UserC: select the box that you rezzed, and select Edit from the context menu
# UserA and UserC: verify that your build tools appear, and that the appearance is identical in the following tabs:
#* General
#* Object
#* Features
#* Content
# UserA and UserC: verify that the build tool UI is the same for each of the build tool modes (top row of buttons)
#* Focus (magnifying glass icon)
#* Move (hand icon)
#* Edit (mouse cursor icon)
#* Create (magic wand icon)
#* Land (bulldozer icon)
# UserA: deselect the box
# UserA, UserB, and UserC: verify that UserA's box still looks like a default box (has not changed appearance)

=== Verify layout and default values of build tool's Texture tab ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool
# UserA: Open the Texture tab of the build tool, and verify that the layout basically matches the image here (minus colorful lines): [[:File:MaterialsBuildUI1.png]]. Verify that the following defaults are set:
#* Verify that "Materials" is the default face edit mode
#* Verify that "Texture (diffuse)" is the default texture edit mode
#* Verify that the Color appears white
#* Verify that Transparency is 0%
#* Verify that Glow is 0.00
#* Verify that 'Full Bright' is disabled
#* Verify that the texture preview shows the default plywood texture
#* Verify that 'Alpha mode' is 'Alpha blending'
#* Verify that 'Mask cutoff' does *not* appear (this option is not applicable in this alpha mode)

=== Verify layout and default values for Mapping option ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool. Open the Texture tab of the build tool.
#* Verify that 'Repeats' is 'per face (default)'
#** Verify that the texture mapping settings match the 'Mapping = default' section in '2b' of this reference image: [[:File:MaterialsBuildUI1.png]].. Verify that the following defaults are set:
#** Verify that 'Horizontal scale' and 'Vertical scale' are both 1.00
#** Verify that 'Repeats per meter' is 2.0 (2.0/meter corresponds to 1.0/face on a 50cm cube face), and can be edited
#** Verify that 'Rotation' is 0.00
#** Verify that 'Horizontal offset' and 'Vertical offset' are both 0.00
#** Verify that 'Align planar faces' is *not* visible
# UserA: Deselect the box
# UserA, UserB, and UserC: verify that the box's appearance has not changed (since no edits have been made)
# UserA: Reselect the box, and 'Edit' it again
# UserA: Under the Texture tab, change the 'Mapping' setting to 'Planar'
#* Verify that the texture mapping settings match the 'Mapping = planar' section in '2b' of this reference image: [[:File:MaterialsBuildUI1.png]].. Verify that the following defaults are set:
#** Verify that 'Number of repeats' is 2.00, and *cannot* be edited (is read-only)
#** Verify that 'Rotation' is 0.00
#** Verify that 'Horizontal offset' and 'Vertical offset' are both 0.00
#** Verify that 'Align planar faces' is visible, unchecked and enabled (*can* be edited)
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that the box's appearance has not changed (since the change to 'planar' mapping by itself has no visible effect on this box)

=== Verify build tool editing of texture settings ===
#* Note: UserA: run the following tests for texture settings., for both planar and default texture mapping modes
#*Note: UserB, and UserC: throughout the test, verify that you see the expected results based on the observer Viewer in use.

====Texture Mapping: Diffuse texture, Default mode====
# UserA: Set the Texture panel's dropdowns to read:
#* Materials
#* Texture (diffuse)
#* Mapping: Default
# UserA: Create a new cube prim for use in this test.
# UserA: Verify that clicking Texture box will open the Pick: Texture floating window, allowing you to select a new texture.
# UserA: Verify that you can drag a texture from your Inventory window to the Texture box.
# UserA: Verify that if the Select Face item is NOT selected, texture changes are applied to all sides at once.
# UserA: Verify that if the Select Face item in the upper pane of the Tools window is selected, you can change one face of the object at a time.
# UserA: Verify that if you drag a texture from your Inventory window directly to the object, you can change one face of the object at a time.
# UserA: Apply the texture, [[:File:TestDiffuse001.png]], to a single face of the prim (while in Select Face mode). This should result in the prim having two textures. The "100" image should appear on only one face.
# UserA: Verify that if an object uses more than one texture, the word Multiple will appear in the Texture image box over one of the texture images.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that the box's appearance has changed to show two textures, one on a single face the other on all other faces
# UserA: Verify that clicking Color box will open the Color Picker floating window.
# UserA: Verify that color tints selected are additive to the color of the base texture.
# UserA: Verify that using Transparency you can choose transparency level of the object.
# UserA: Verify that this setting applies an overall transparency to the texture in addition to any transparency in the alpha channel. The range is 0 to 100 percent. Set to 50%.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that the box's appearance has changed to show a color tint and is semi-transparent.
# UserA: Verify that using Glow item you can create a surface glow on the object, separate from the light emitted with the Features tab. The range is 0 to 1, but any glow above 0.1 tends to wash out the surface texture.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that the box's appearance has changed to add glow.
# UserA: Enable Full Bright.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that the box renders as if fully day-lighted, regardless of the environment day cycle position of the sun.
#* (Use World > Sun > <time of day> to change sun position.)
# UserA: Change Transparency and Glow settings back to 0, and disable Full Bright.
# Rez a 0.5 (default-size) cube and add <test texture> via the texture picker.
# UserA: set Horizontal Scale to 2
# UserA: set horizontal offset to 0.5
# UserA: Verify Repeats per Meter value has automatically changed to 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, side-by-side.
# UserA: set Vertical Scale to 2
# UserA: set Vertical Offset to 0.5
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale plus the Vertical Scale: 4 repeats in a 2x2 grid
# UserA: set Horizontal Scale to 1
# UserA: set Horizontal offset to 0
# UserA: Verify Repeats per Meter value remains at 4.0 (since this value now reflects the maximum density between horizontal and vertical scales)
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, one above the other.
# UserA: Verify that Rotation controls rotation of the texture relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# UserA: Verify that Align Planar Faces is disabled/greyed out when in the Mapping Default mode

====Texture Mapping: Diffuse texture, Planar mode====
# Set the Texture panel's dropdowns to read:
#* Materials
#* Texture (diffuse)
#* '''Mapping: Planar'''
# UserA: Verify that the Repeats/Meter value is disabled/greyed out when in the Mapping Planar mode is active
# Rez a cube and resize it to 1m per side. Reposition the cube so the entire prim can be viewed. Add the texture [[:File:TestDiffuse001.png]] via the texture picker.
# UserA: Set Horizontal Scale to 4
# UserA: Set Vertical Scale to 6
# UserA: Verify that the read-only Repeats Per Meter changed to 3.0 (yes, this is screwy, but it seems to match the release viewer)
# UserA: set horizontal offset to 0.5
# UserA: set Vertical offset to 0.5
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each plane of each prim face matches 4 repeats horizontally, 6 vertically
# UserA: Verify that Rotation controls rotation of the texture relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# '''Align Planar Faces test TBD'''

== Verify functionality of 'Alpha mode' option ==
=== No Mask is forced for textures without an alpha channel ===
# UserA, UserB, and UserC: login
# UserA: Take a snapshot (ctrl+S) and 'Save to inventory'
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: Set the snapshot as the texture on the box
# UserA: Verify that the 'Alpha mode' setting is 'None', and that the UI for changing 'Alpha mode is disabled'
#* Verify that the 'Mask cutoff' setting is hidden
# UserA, UserB, and UserC: Verify that the snapshot appears on the box, and that it is fully opaque
=== Alpha Blending ===
# UserA, UserB, and UserC: login
# UserA: Upload this alpha-mapped image to your inventory: [[:File:Maestro_alpha_gradient.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool. Open the Texture tab of the build tool.
# UserA: Using the texture picker from the build tool, set the image you uploaded on all faces of the box
# UserA, UserB, and UserC: verify that you see a 'smooth' transparency transition in the texture on all faces, with the bottom of the image being opaque and the top being transparent. This is the expected result when the 'Alpha mode' is set to the default 'Alpha blending' setting

=== Alpha Masking ===
# UserA, UserB, and UserC: login
# UserA: Upload this alpha-mapped image to your inventory (if you don't already have it): [[:File:Maestro_alpha_gradient.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool. Open the Texture tab of the build tool, and set the texture to the one you just uploaded.
# UserA: Set the 'Alpha mode' to 'Alpha masking'
#* Verify that the 'Mask cutoff' setting appears, and that the default value for it is 0
# UserA, UserB: verify that the box's texture appears (almost) completely opaque
# UserC: verify that you see no change (since your viewer doesn't support alpha masking)
# UserA: set the 'Mask cutoff' setting to 76
# UserA, UserB: Verify that the top 30% of the texture is now invisible, but the bottom 70% is totally opaque
# UserC: verify that you see no change
# UserA: set the 'Mask cutoff' setting to 178
# UserA, UserB: Verify that the top 70% of the texture is now invisible, but the bottom 30% is totally opaque
# UserC: verify that you see no change
# UserA: set the 'Mask cutoff' setting to 255
# UserA, UserB: Verify that the texture is now almost completely invisible (except perhaps a strip at the bottom)
# UserC: verify that you see no change
# UserA: Try to input 'Mask cutoff' settings < 0, and verify that they get slammed to 0 by the build tool UI
# UserA: Try to input 'Mask cutoff' settings > 255, and verify that they get slammed to 255 by the build tool UI

=== Emissive Mask ===
# UserA, UserB, and UserC: login
# UserA: Upload this alpha-mapped image to your inventory (if you don't already have it): [[:File:Kart_screenshot_with_KART_alpha.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool. Open the Texture tab of the build tool, and set the texture to the one you just uploaded.
# UserA, UserB, and UserC: Verify that the image on the box appears mostly transparent, with the word "KART" in the middle as an opaque section
# UserA: Set the 'Alpha mode' to 'Emissive mask'
#* Verify that the 'Mask cutoff' setting remains hidden
# UserA and UserB: verify that the box's appearance has changed. The whole texture should be opaque, but there should be a glowing word 'KART' in the texture.
# UserC: verify that the box's appearance has not changed (and you just see the image as mostly transparent with the opaque word 'KART')

=== No Mask (on a texture with an alpha channel) ===
# UserA, UserB, and UserC: login
# UserA: Upload this alpha-mapped image to your inventory (if you don't already have it): [[:File:Kart_screenshot_with_KART_alpha.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool. Open the Texture tab of the build tool, and set the texture to the one you just uploaded.
# UserA, UserB, and UserC: Verify that the image on the box appears mostly transparent, with the word "KART" in the middle as an opaque section
# UserA: Set the 'Alpha mode' to 'None'
#* Verify that the 'Mask cutoff' setting remains hidden
# UserA and UserB: verify that the box's appearance has changed. The whole texture should be opaque, and no word 'KART' should be visible.
# UserC: verify that the box's appearance has not changed (and you just see the image as mostly transparent with the opaque word 'KART')

== Verify functionality of 'Bumpiness' settings ==
=== Layout of Bumpiness settings ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Bumpiness (normal)"
# UserA: Verify that the build tool layout looks like the 'Materials > Normal' section from this mockup [[:File:BuildTool_Bumpiness_Shininess.png]]
# UserA: Verify the following default settings:
#* Verify that the Texture preview is empty, with a black-on-grey "X" (indicating that no normal map is set)
#* Verify that the 'Bumpiness' setting is currently 'None'
#* Verify that the 'Mapping' setting is 'Default'
#* Verify that 'Horizontal scale' is 1.0
#* Verify that 'Vertical scale' is 1.0
#* Verify that 'Repeats per meter' is enabled, and is 2.0 (this corresponds to a horizontal scale of 1.0 for a 50cm object)
#* Verify that 'Rotation' is 0.0
#* Verify that 'Horizontal offset' is 0.0
#* Verify that 'Vertical offset' is 0.0
#* Verify that 'Align planar faces' is disabled and cannot be edited
# UserA: Deselect the object
# UserA, UserB, UserC: verify that the box's appearance is unchanged (was not accidentally edited)

=== Legacy Bumpiness ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Bumpiness (normal)"
# UserA: Verify that you see the following options under the Bumpiness menu:
#* None
#* Brightness
#* Darkness
#* woodgrain
#* bark
#* bricks
#* checker
#* concrete
#* crustytile
#* cutstone
#* discs
#* gravel
#* petridish
#* siding
#* stonetile
#* stucco
#* suction
#* weave
# UserC: Rez a box and edit it with the build tool
# For each of the bumpiness menu options *except* for 'None', do the following:
#* UserA and UserC: select the same bumpiness menu option for your object's texture
#* UserA, UserB, and UserC: Verify that UserA's box has the same appearance as UserC's box
#* UserA: Verify that all of the texture mapping controls (scale, offset, rotation, align planar faces, etc.) are disabled in the UI (grayed out) when in this mode

=== Normal Map Texture Selection ===
# UserA, UserB, and UserC: login
# UserA: if you don't already have them in your inventory, upload these two textures to SL
#* [[:File:TestDiffuse001.png]]
#* [[:File:TestNormal001.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: Set the uploaded diffuse texture as the diffuse texture on your object
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Bumpiness (normal)"
# UserA: Verify that the Texture preview is empty, with a black-on-grey "X" (indicating that no normal map is set)
# UserA: Click on the texture icon, then choose the uploaded normal map using the texture picker
# UserA: Verify that the Texture preview shows the normal map you selected
# UserA: Verify that 'Bumpiness' is now set to "Use Texture"
# UserA and UserB: Verify that the uploaded textures appear on the box face at full scale, and are aligned. You should see a large '001' in the middle, due to the normal map effect.
# UserC: Verify that you can see the diffuse texture, but no bump map effect
# UserA: From the 'Bumpiness' menu, choose 'None'
# UserA: Verify that the Texture preview is now empty, with a black-on-grey "X" (indicating that no normal map is set)
# UserA, UserB, and UserC: Verify that you can see the diffuse texture, but no bump map effect
# UserA: Drag the uploaded normal map from your inventory onto the Texture preview icon
# UserA: Verify that the Texture preview shows the normal map you selected
# UserA: Verify that 'Bumpiness' becomes set to "Use Texture"
# UserA and UserB: Verify that you see both the normal map and diffuse map applied on the rendered box
# UserC: Verify that you can see the diffuse texture, but no normal map effect

=== Normal Map Texture mapping ===
====Normal texture, Default mapping====
# Set the Texture panel's dropdowns to read:
#* Materials
#* '''Bumpiness (normal)'''
#* '''Mapping: Default'''
# UserA: change the prim's texture to [[:File:TestNormal001.png]]
# UserA: set Horizontal Scale to 2
# UserA: set horizontal offset to 0.5
# UserA: Verify Repeats per Meter value has automatically changed to 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, side-by-side.
# UserA: set Vertical Scale to 2
# UserA: set Vertical Offset to 0.5
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale plus the Vertical Scale: 4 repeats in a 2x2 grid
# UserA: set Horizontal Scale to 1
# UserA: set Horizontal offset to 0
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, one above the other.
# UserA: Verify that Rotation controls rotation of the texture relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# UserA: Verify that Align Planar Faces is disabled/greyed out when in the Mapping Default mode

====Normal texture, Planar mapping====
# UserA, UserB, UserC: Login
# UserA: Rez a cube and resize it to 1m per side. Reposition the cube so the entire prim can be viewed. Set [[:File:TestDiffuse001.png]] as the diffuse map, via the texture picker.
# UserA: Set the Texture panel's dropdowns to read:
#* Materials
#* Bumpiness (normal)
#* '''Mapping: Planar'''
# USerA: Set [[:File:TestNormal001.png]] as the normal map, via the texture picker.
# UserA: Verify that the Repeats/Meter value is disabled/greyed out when in the Mapping Planar mode is active
# UserA: Set Horizontal Scale to 4
# UserA: Set Vertical Scale to 6
# UserA: Verify that the read-only Repeats Per Meter changed to 3.0 (yes, this is screwy, but it seems to match the release viewer)
# UserA: set horizontal offset to 0.5
# UserA: set Vertical offset to 0.5
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify that the diffuse texture appearance remains unchanged
#* UserA, UserB, and UserC: Verify the number of normal map repeats visible on each plane of each prim face matches 4 repeats horizontally, 6 vertically
# UserA: Verify that Rotation controls rotation of the normal map relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# '''Align Planar Faces test TBD'''

== Verify functionality of 'Shininess' settings ==

=== Layout of Shininess settings ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Shininess (specular)"
# UserA: Verify that the build tool layout looks like this mockup: [[:File:BuildtoolSpecular-NoTexture.png]]
# UserA: Verify the following default settings:
#* Verify that the Texture preview is empty, with a black-on-grey "X" (indicating that no specular map is set)
#* Verify that the 'Shininess' setting is currently 'None'
#* Verify that 'Glossiness' is hidden in this mode
#* Verify that 'Environment' is hidden in this mode
#* Verify that the 'Color' is hidden in this mode
#* Verify that the 'Mapping' setting is 'Default', and cannot be edited
#* Verify that 'Horizontal scale' is 1.0, and cannot be edited
#* Verify that 'Vertical scale' is 1.0, and cannot be edited
#* Verify that 'Repeats per meter' is 2.0 (this corresponds to a horizontal scale of 1.0 for a 50cm object), and cannot be edited
#* Verify that 'Rotation' is 0.0, and cannot be edited
#* Verify that 'Horizontal offset' is 0.0, and cannot be edited
#* Verify that 'Vertical offset' is 0.0, and cannot be edited
#* Verify that 'Align planar faces' is disabled, and cannot be edited
# UserA: Deselect the object
# UserA, UserB, UserC: verify that the box's appearance is unchanged (was not accidentally edited)

=== Legacy Shiny ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Shininess (specular)"
# UserA: Verify that you see the following options under the Shininess menu:
#* None
#* Low
#* Medium
#* High
# UserC: Rez a box and edit it with the build tool
# Do the following for Shininess settings 'Low', 'Medium', and 'High':
#* UserA and UserC: select the same Shininess menu option for your object's texture
#* UserA, UserB, and UserC: Verify that UserA's box has the same appearance as UserC's box
#* UserA: Verify that all of the texture mapping controls (scale, offset, rotation, align planar faces, etc.) are disabled in the UI (grayed out) when in this mode
#* UserA: Verify that Glossiness, Environment, and Color settings are not visible when in this mode.
#* UserA: Verify that Mapping drop down may be switched from Default to Planar and back
#* UserA: Verify that any prior changes made to; scale, repeats, rotation and offset are preserved when switching between Default and Planar

=== Specular Map Texture Selection ===
# UserA, UserB, and UserC: login
# UserA: if you don't already have them in your inventory, upload these two textures to SL
#* [[:File:TestDiffuse001.png]]
#* [[:File:TestSpecular001.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: Set the uploaded diffuse texture as the diffuse texture on your object
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Shininess (specular)"
# UserA: Verify that the Texture preview is empty, with a black-on-grey "X" (indicating that no specular map is set)
# UserA: Click on the texture icon, then choose the uploaded specular map using the texture picker
# UserA: Verify that the Texture preview shows the specular map you selected
# UserA: Verify that 'Shininess' is now set to "Use texture"
#* Verify that the floater has new elements, and now looks like [[:File:BuildtoolSpecular-UseTexture.png]]
#** Verify that Glossiness has a default value of 51
#** Verify that Environment has a default value of 0
#** Verify that Color defaults to white
# UserA and UserB: Verify that the uploaded textures appear on the box face at full scale, and are aligned.
#* The stained parts and the scratches should be less shiny than other parts of the texture
# UserC: Verify that you can see the diffuse texture, but no shiny effect
# UserA: From the 'Shininess' menu, choose 'None'
# UserA: Verify that the Texture preview is now empty, with a black-on-grey "X" (indicating that no normal map is set)
# UserA: Verify that the build tool layout has reverted to the style shown here: [[:File:BuildtoolSpecular-NoTexture.png]]
# UserA, UserB, and UserC: Verify that you can see the diffuse texture, but no specular map effect
# UserA: Drag the uploaded specular map from your inventory onto the Texture preview icon
# UserA: Verify that the Texture preview shows the specular map you selected
# UserA: Verify that 'Shininess' becomes set to "Use Texture"
# UserA and UserB: Verify that the uploaded textures appear on the box face at full scale, and are aligned
# UserC: Verify that you can see the diffuse texture, but no specular map effect

=== Specular Map Glossiness and Environment ===
# UserA, UserB, and UserC: login
# UserA: if you don't already have them in your inventory, upload these two textures to SL
#* [[:File:TestDiffuse001.png]]
#* [[:File:TestSpecular001.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: Set the uploaded diffuse texture as the diffuse texture on your object
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Shininess (specular)"
# UserA: Click on the texture icon, then choose the uploaded specular map using the texture picker
# UserA and UserB: verify that you see the object with the specular map applied
# UserC: Verify that you can see the diffuse texture, but no specular map effect
# UserA: Verify these default settings:
#* Glossiness should be 51
#* Environment should be 0
# UserA: Increase the Environment setting to 204
# UserA and UserB: Verify that the reflected color of the object now includes more of the environment (blue highlights from the sky color)
# UserC: verify that you see no change
# UserA: Try to enter an Environment setting > 255, and verify that the UI slams it to 255
# UserA: Try to enter an Environment setting < 0, and verify that the UI slams it to 0
# UserA: Increase the Glossiness setting to 204
# UserA and UserB: Verify that the specular highlights are now more 'blurred'
# UserC: verify that you see no change
# UserA: Try to enter a Glossiness setting > 255, and verify that the UI slams it to 255
# UserA: Try to enter a Glossiness setting < 0, and verify that the UI slams it to 0

=== Specular Map Texture mapping ===
====Specular texture, Default mapping====
# Set the Texture panel's dropdowns to read:
#* Materials
#* '''Shininess (specular)'''
#* '''Mapping: Default'''
# UserA: change the prim's texture to [[:File:TestSpecular001.png]]
# UserA: set Horizontal Scale to 2
# UserA: set horizontal offset to 0.5
# UserA: Verify Repeats per Meter value has automatically changed to 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, side-by-side.
# UserA: set Vertical Scale to 2
# UserA: set Vertical Offset to 0.5
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale plus the Vertical Scale: 4 repeats in a 2x2 grid
# UserA: set Horizontal Scale to 1
# UserA: set Horizontal offset to 0
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, one above the other.
# UserA: Verify that Rotation controls rotation of the texture relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# UserA: Verify that Align Planar Faces is disabled/greyed out when in the Mapping Default mode

====Normal texture, Planar mapping====
# UserA, UserB, UserC: Login
# UserA: Rez a cube and resize it to 1m per side. Reposition the cube so the entire prim can be viewed. Set [[:File:TestDiffuse001.png]] as the diffuse map, via the texture picker.
# UserA: Set the Texture panel's dropdowns to read:
#* Materials
#* Shiniiness (specular)
#* '''Mapping: Planar'''
# USerA: Set [[:File:TestSpecular001.png]] as the specular map, via the texture picker.
# UserA: Verify that the Repeats/Meter value is disabled/greyed out when in the Mapping Planar mode is active
# UserA: Set Horizontal Scale to 4
# UserA: Set Vertical Scale to 6
# UserA: Verify that the read-only Repeats Per Meter changed to 3.0 (yes, this is screwy, but it seems to match the release viewer)
# UserA: set horizontal offset to 0.5
# UserA: set Vertical offset to 0.5
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify that the diffuse texture appearance remains unchanged
#* UserA, UserB, and UserC: Verify the number of specular map repeats visible on each plane of each prim face matches 4 repeats horizontally, 6 vertically
# UserA: Verify that Rotation controls rotation of the specular map relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# '''Align Planar Faces test TBD'''

== Verify functionality of 'Media' settings ==
=== Layout and Default Values of Media Settings ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool
# UserA: In the Texture tab, change the edit mode from "Materials" to "Media".
# UserA: Verify that the build tool layout looks like this mockup: File:BuildToolMediaMode.png
# UserA: Verify that the following defaults are set:
#* Verify that the Color appears white
#* Verify that Transparency is 0%
#* Verify that Glow is 0.00
#* Verify that 'Full Bright' is disabled
#* Verify that 'Mapping' is 'Default
#** Verify that 'Horizontal scale' and 'Vertical scale' are both 1.00
#** Verify that 'Repeats per meter' is 2.0 (2.0/meter corresponds to 1.0/face on a 50cm cube face), and can be edited
#** Verify that 'Rotation' is 0.00
#** Verify that 'Horizontal offset' and 'Vertical offset' are both 0.00
#* Verify that 'Align planar faces' is unchecked and cannot be edited (is 'greyed out')'
# UserA, UserB, UserC: verify that the box's appearance is unchanged (was not accidentally edited)
=== Adding, and removing, and aligning media ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool
# UserA: Change your selection mode to "Select Face" and select only the top face
# UserA: In the Texture tab, change the edit mode from "Materials" to "Media".
# UserA: Click on the "Choose.." button, and verify that the "MEDIA SETTINGS" floater appears, and looks like this: [[:File:BuildToolMediaSettings.png]]
# UserA: Type "http://secondlife.com" into the Home Page text field in "MEDIA SETTINGS", and hit "Apply"
# UserA, UserB, and UserC: Verify that you see the SL website appear on the box's top face
# UserA: Change the 'Horizontal offset' value to 0.2
# UserA, UserB, and UserC: Verify that the SL website on the box is now slightly offset
# UserA: Click on the 'Align' button to align the website with the box's edges
# UserA, UserB, and UserC: Verify that the SL website on the box is now aligned with the box edges
# UserA: Click on the 'Remove' button to remove the prim media
# UserA: Verify that you see a modal dialog, asking to confirm media removal. Click "No"
# UserA, UserB, and UserC: Verify that the SL website on the box is unchanged
# UserA: Click on the 'Remove' button to remove the prim media
# UserA: Verify that you see a modal dialog, asking to confirm media removal. Click "Yes"
# UserA, UserB, and UserC: Verify that the SL website has disappeared from the box, and that the changed face is back to the default plywood texture

===Media Texture Mapping ===
====Media, Default mapping====
# UserA, UserB, UserC: login
# UserA: Rez a box, and edit one of its faces with the Build Tool
# UserA: Set the Texture panel's dropdowns to read:
#* Media
#* '''Mapping: Default'''
# UserA: Add media to a face on the box, using "http://secondlife.com", as in [[#Layout_and_Default_Values_of_Media_Settings]]
# UserA: set Horizontal Scale to 2
# UserA: set horizontal offset to 0.5
# UserA: Verify Repeats per Meter value has automatically changed to 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, side-by-side.
# UserA: set Vertical Scale to 2
# UserA: set Vertical Offset to 0.5
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale plus the Vertical Scale: 4 repeats in a 2x2 grid
# UserA: set Horizontal Scale to 1
# UserA: set Horizontal offset to 0
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, one above the other.
# UserA: Verify that Rotation controls rotation of the texture relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# UserA: Verify that Align Planar Faces is disabled/greyed out when in the Mapping Default mode

==== Media, Planar mapping====
# UserA, UserB, UserC: Login
# Rez a cube and resize it to 1m per side. Reposition the cube so the entire prim can be viewed. Add the texture [[:File:TestDiffuse001.png]] via the texture picker.
# UserA: Set the Texture panel's dropdowns to read:
#* Media
#** '''Mapping: Planar'''
# UserA: Verify that the Repeats/Meter value is disabled/greyed out when in the Mapping Planar mode is active
# UserA: Set Horizontal Scale to 4
# UserA: Set Vertical Scale to 6
# UserA: Verify that the read-only Repeats Per Meter changed to 3.0 (yes, this is screwy, but it seems to match the release viewer)
# UserA: set horizontal offset to 0.5
# UserA: set Vertical offset to 0.5
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each plane of each prim face matches 4 repeats horizontally, 6 vertically
# UserA: Verify that Rotation controls rotation of the texture relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# '''Align Planar Faces test TBD'''

= Materials Loading Test =
This test verifies that the viewer can fetch materials data and render it properly.

== Obtaining Test Objects ==
This test requires using 2 test objects which each contain many materials.

Some prepared test objects can be found at [http://maps.secondlife.com/secondlife/Bug%20Island/148/18/27 Bug Island]. There are 2 test linksets, each containing 50 unique materials:
* MaterialsObject01-50 contains 50 boxes, numbered by 01-50 with matching diffuse, normal, and specular maps.
* MaterialsObject51-100 contains 50 boxes, numbered by 51-100 with matching diffuse, normal, and specular maps.

Both link sets have prims that spin with llTargetOmega(), in order to make the specular maps more visible. You can modify the script in the root prim to remove this effect.

== Materials load when rezzed ==
# Log in
# Find a pair of neighboring regions which both allow you to rez objects, and move near the sim border
# Rez 'MaterialsObject01-50' in the region your avatar is in
# Without much delay, rez 'MaterialsObject51-100' in the neighboring region
# Verify that all diffuse/normal/specular maps for both linksets load in a timely manner
#* This may take a short while, since the viewer needs to download 300 separate textures for these objects

== Materials load upon login ==
# Complete the [[#Materials_load_when_rezzed]] test first
# Log out
# Login to the location where the objects were rezzed
# Verify that all diffuse/normal/specular maps for both linksets load in a timely manner
#* This should be relatively fast, since the viewer should have these textures in its cache

= Materials Rendering Test =
''Note: The following sections should be completed both above and below water. There is a trench directly to the west that replicates all test cases under water''

== Rendering of Legacy Bumpmaps and Shiny ==
''Note: this was lifted from [[Render_Correctness_Test]]''
# Go to http://maps.secondlife.com/secondlife/Bug%20Island%202/243/247/23
# Set your shaders and sun position as indicated on the red sphere at that location.
# Verify the spheres render the same as they appear in the picture at that location.
# Continue testing at the 5 stations to the South.
# Repeat test with 'Advanced Lighting Model' from graphics preferences both enabled and disabled (where allowed)
#* It is expected that 'Advanced Lighting Model' can only be enabled if both 'Basic Shaders' and 'Atmospheric Shaders' settings are enabled

==100% Transparent + Glow==
# Go to http://maps.secondlife.com/secondlife/Bug%20Island%202/240/174/23
# Set your shaders as indicated by the red sphere at that location.
# Verify that the sphere glows with ALM enabled.
# Verify that the sphere does not become opaque and black:
#* Under the Advanced->Rendering Types menu uncheck 'Water'
#* In Me->Preferences->Graphics uncheck and then recheck 'Advanced Lighting Model'
#* The sphere should continue to glow bright white.

''Note: When finished be sure to turn the water rendering back on in the Rendering Types menu''

==Consistent Lighting vs Solid and Alpha Surfaces==
# Go to http://maps.secondlife.com/secondlife/Bug%20Island%202/239/170/23
# The white plane is actually made up of two planes linked together.
# The plane on the left is solid, and the plane on the right has some Transparency %.
# With Local Lights on Verify under the following conditions that the two planes appear to be one plane:
#* With Basic Shaders enabled.
#* With Atmospheric Shaders enabled.
#* With Advanced Lighting Model enabled under all Sun Settings:
#** Sunrise
#** Midday
#** Sunset
#** Midnight

==Gamma Consistency w/ Full Bright + Alpha==
# Got to http://maps.secondlife.com/secondlife/Bug%20Island%202/241/164/23
# Follow the guidelines stated in the text on the red sphere at that location.
#* The cube with the pink circle should not be bright than the solid pink cube.
#* The cube with the target on it should not darken with ALM enabled.

== Alpha Modes Rendering ==
# Enter the 'Materials rendering test room' at http://maps.secondlife.com/secondlife/Bug%20Island%202/233/251/42
# Click World -> Sun -> Midday to set the viewer lighting
# Enable "Advanced Lighting Model" in your Preferences, under Graphics->Advanced
# Verify that row of 4 boxes on the northern side roughly match the appearance shown on the inworld 'Alpha modes sample' object
#* 'Alpha blended' should have a smooth transparency transition
#* 'Alpha masked' should have an abrupt transparency transition, with each pixel either fully opaque or fully transparent
#* 'Emissive mask' should look bright in the areas which appear more opaque in the 'Alpha blended' box
#* 'No Alpha' should be fully opaque
# Disable "Advanced Lighting Model" in your Preferences, under Graphics->Advanced
# Verify that the 'Emissive masked' box now appears the same as the 'No Alpha' box
# Verify that the other boxes have not changed their basic appearance

== Rendering with Normal Maps ==
# Enter the 'Materials rendering test room' at http://maps.secondlife.com/secondlife/Bug%20Island%202/235/248/46
# Click World -> Sun -> Midday to set the viewer lighting
# Enable "Advanced Lighting Model" in your Preferences, under Graphics->Advanced
# Look at the wall of test objects to the East, and confirm the appearance of each row roughly matches the sample screenshot on the left side. Each Row includes a different alpha type (labelled by floating text)
#* The 1st row, 'no specular', has objects which contain a normal map but have specularity disabled. These objects should have a totally matte appearance.
#* The 2nd row, 'low shiny', has objects which contain a normal map and use the legacy 'Low Shiny' setting. These objects should be slightly shiny, mostly for 'environment' reflections.
#* The 3rd row, 'medium shiny', has objects which contain a normal map and use the legacy 'Medium Shiny' setting. These objects should be slightly shinier than the 'low shiny' row, mostly for 'environment' reflections.
#* The 4th row, 'high shiny', has objects which contain a normal map and use the legacy 'Medium Shiny' setting. These objects should be slightly shinier than the 'medium shiny' row, mostly for 'environment' reflections.
#* The 5th row, '0 gloss, 0 env', has objects which contain a normal map and the '001' specular map, but has both glossiness and environment set to 0. These objects should look identical to the 'no specular' row.
#* The 6th row, '51 gloss, 0 env', has objects which contain a normal map and the '001' specular map, and has both glossiness=51 and environment=0. These objects should by mostly matte, except for shiny '001' sections in the upper-left and lower-right corners.
#* The 7th row, '51 gloss, 0 env, red', has objects which contain a normal map and the '001' specular map, and has both glossiness=51, environment=0, and a red specular color. These objects should appaer similar to those in the '51 gloss, 0 env' row, except that the shiny '001' parts should have a red hue.
#* The 8th row, '51 gloss, 200 env', has objects which contain a normal map and the '001' specular map, and has both glossiness=51 and environment=200. These objects should appaer metallic all over, and have the shiny '001' lettering in the upper-left and lower-right corners.
#* The 9th row, '0 gloss, 200 env', has objects which contain a normal map and the '001' specular map, and has both glossiness=0 and environment=200. These objects should appear metallic all over, but should not have the shiny '001' lettering in the upper-left and lower-right corners.
# Disable "Advanced Lighting Model" in your Preferences, under Graphics->Advanced
# Look at the wall of test objects to the East, and confirm these changes:
#* All 'emissive mask' objects (far right column) now appear identical to the 'alpha none' objects next to them
#* All normal maps are missing
#* Rows 1, 5, 6, 7, 8, 9 (that is, all except for low/medium/high shiny rows) should all look identical to each other. None of them should appear shiny.
#* For each of rows 2-4 (low/medium/high shiny), the 'opaque', 'alpha none', and 'emissive mask' objects appear identical to each other (and look shiny)
#* For each of rows 2-4 (low/medium/high shiny), the 'alpha blend' and 'alpha mask' objects all appear non-shiny

== Materials Rendering on HUDs ==
Normal and specular maps should not render on objects which are attached as HUDs, due to the lack of lighting sources at the HUD layer (objects tend to render as full bright). However, some of the new alpha modes should effect rendering of HUD objects.
# Take a copy of 'Materials test HUD', which is rezzed at http://maps.secondlife.com/secondlife/Bug%20Island%202/229/253/23 - this object is a linkset of small boxes, with plenty of floating text.
# Enable "Advanced Lighting Model" in your Preferences, under Graphics->Advanced
# Wear the 'Materials test HUD' object from inventory. By default, it should attach to the 'Center' HUD attachment point
# If you have trouble seeing the floating text about each HUD object (the text can be crowded), set 'UI size' to 0.75 under Preferences->Advanced
# Position your camera so that you can see the attachments clearly - I used a blank-textured large prim as background
# Verify that the HUD appears like this screen shot: [[:File:Materials_test_HUD_appearance.png]]
#* Verify that no normal or specular maps appear with the '001' pattern
#** The boxes labelled with 'X gloss, Y env' should be identical to the 'no specular' boxes on the far left column
#** Each of the 'no specular' boxes on the far left column should appear identical to the non-brick 'Water particle 1' objects on the top row
#** In the top row, "No Alpha 'Water Particle 1' with legacy bricks" should look the same as "Emissive Masked 'Water Particle 1' with legacy bricks"
#* Verify that 'Opaque '001' diffuse map with legacy bricks' in the upper-left corner is the only box that has a visible 'bricks' pattern (this is legacy bumpiness)
#* Verify that the other 'with legacy bricks' objects in the top row do *not* have any bumpiness effect, and that the alpha modes render as labelled
#** These objects should have the same appearance as the non-'brick' objects on the right side of the first row
#* Verify that Alpha mode renders correctly
#** Verify that all of the 'opaque' boxes (with the 001 texture) appear fully opaque
#** Verify that all of the 'Alpha blended' objects appear alpha blended (semitransparent, with soft edges)
#** Verify that all of the 'Alpha masked' objects appear alpha masked (semitransparent, with hard edges)
#** Verify that all 'emissive mask' boxes match their corresponding 'alpha none' boxes, since all HUD objects render as fully emissive ('full bright')
#* Verify that legacy shiny objects appear darker than the others
#** Opaque-rendered objects (no alpha, emissive mask, or opaque) set to low/medium/high shiny boxes appear darker than the other boxes
#** The shading should be more severe with increasing shiny level: 'high shiny' objects should be darkest, while 'low shiny' objects should not be so dark
# Disable "Advanced Lighting Model" in your Preferences, under Graphics->Advanced
# Verify that the HUD appears like this screen shot: [[:File:Materials_test_HUD_appearance.png]]
#* Appearance should match what you saw when "Advanced Lighting Model" was enabled

== Materials Rendering on Rigged Meshes ==
TODO

== Rendering of Environment and Exponent Masks ==
TODO

[[Category:QA Portal]]
[[Category:Test Scripts]]

Viewer Materials Smoke Test

2019-10-15T22:27:15Z

Dan Linden: /* Media, Planar mapping */

= Overview =
* This test plan covers viewer-side support for the prim materials project, which provides support for normal maps and specular maps applied to object faces
* A high-level specification of this featureset can be found at [[Material_Data]]

= Build Tool Test =

== Required Materials ==
* A region which supports normal and specular maps
** As of [[Release_Notes/Second_Life_Server/13#13.02.08.270166|Second Life Server 13.02.08.270166]], materials support is in the server.
* Three test users
** UserA, who uses a viewer which supports normal and specular maps, and does the building (actually performs operations)
** UserB, who uses a viewer which supports normal and specular maps, and only observes the results of UserA's work
*** The purpose of this user is to verify that build tool edits sent by UserA's viewer produce congruent results
** UserC, who uses an 'old' (no support for normal and specular maps) viewer, and only observes the results of UserA's work
*** The purpose of this user is to verify that edited content looks reasonable on legacy viewers, and sometimes to verify that build tool settings from the new viewer have the same appearance as those set by the legacy viewer.
** UserA and UserB should have "Advanced Lighting Model" enabled under Preferences -> Graphics settings, under "Advanced". This setting is required for the viewer to render normal and specular maps properly.
* Upload the following textures to use in this test:
** [[:File:TestDiffuse001.png]]
** [[:File:TestNormal001.png]]
** [[:File:TestSpecular001.png]]

== Verify Basic Build Tool Layout ==

=== Verify that non-Texture portions of the build tool have not changed ===
# UserA, UserB, and UserC: login
# UserA and UserC: each rez a box
# UserA and UserC: select the box that you rezzed, and select Edit from the context menu
# UserA and UserC: verify that your build tools appear, and that the appearance is identical in the following tabs:
#* General
#* Object
#* Features
#* Content
# UserA and UserC: verify that the build tool UI is the same for each of the build tool modes (top row of buttons)
#* Focus (magnifying glass icon)
#* Move (hand icon)
#* Edit (mouse cursor icon)
#* Create (magic wand icon)
#* Land (bulldozer icon)
# UserA: deselect the box
# UserA, UserB, and UserC: verify that UserA's box still looks like a default box (has not changed appearance)

=== Verify layout and default values of build tool's Texture tab ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool
# UserA: Open the Texture tab of the build tool, and verify that the layout basically matches the image here (minus colorful lines): [[:File:MaterialsBuildUI1.png]]. Verify that the following defaults are set:
#* Verify that "Materials" is the default face edit mode
#* Verify that "Texture (diffuse)" is the default texture edit mode
#* Verify that the Color appears white
#* Verify that Transparency is 0%
#* Verify that Glow is 0.00
#* Verify that 'Full Bright' is disabled
#* Verify that the texture preview shows the default plywood texture
#* Verify that 'Alpha mode' is 'Alpha blending'
#* Verify that 'Mask cutoff' does *not* appear (this option is not applicable in this alpha mode)

=== Verify layout and default values for Mapping option ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool. Open the Texture tab of the build tool.
#* Verify that 'Repeats' is 'per face (default)'
#** Verify that the texture mapping settings match the 'Mapping = default' section in '2b' of this reference image: [[:File:MaterialsBuildUI1.png]].. Verify that the following defaults are set:
#** Verify that 'Horizontal scale' and 'Vertical scale' are both 1.00
#** Verify that 'Repeats per meter' is 2.0 (2.0/meter corresponds to 1.0/face on a 50cm cube face), and can be edited
#** Verify that 'Rotation' is 0.00
#** Verify that 'Horizontal offset' and 'Vertical offset' are both 0.00
#** Verify that 'Align planar faces' is *not* visible
# UserA: Deselect the box
# UserA, UserB, and UserC: verify that the box's appearance has not changed (since no edits have been made)
# UserA: Reselect the box, and 'Edit' it again
# UserA: Under the Texture tab, change the 'Mapping' setting to 'Planar'
#* Verify that the texture mapping settings match the 'Mapping = planar' section in '2b' of this reference image: [[:File:MaterialsBuildUI1.png]].. Verify that the following defaults are set:
#** Verify that 'Number of repeats' is 2.00, and *cannot* be edited (is read-only)
#** Verify that 'Rotation' is 0.00
#** Verify that 'Horizontal offset' and 'Vertical offset' are both 0.00
#** Verify that 'Align planar faces' is visible, unchecked and enabled (*can* be edited)
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that the box's appearance has not changed (since the change to 'planar' mapping by itself has no visible effect on this box)

=== Verify build tool editing of texture settings ===
#* Note: UserA: run the following tests for texture settings., for both planar and default texture mapping modes
#*Note: UserB, and UserC: throughout the test, verify that you see the expected results based on the observer Viewer in use.

====Texture Mapping: Diffuse texture, Default mode====
# UserA: Set the Texture panel's dropdowns to read:
#* Materials
#* Texture (diffuse)
#* Mapping: Default
# UserA: Create a new cube prim for use in this test.
# UserA: Verify that clicking Texture box will open the Pick: Texture floating window, allowing you to select a new texture.
# UserA: Verify that you can drag a texture from your Inventory window to the Texture box.
# UserA: Verify that if the Select Face item is NOT selected, texture changes are applied to all sides at once.
# UserA: Verify that if the Select Face item in the upper pane of the Tools window is selected, you can change one face of the object at a time.
# UserA: Verify that if you drag a texture from your Inventory window directly to the object, you can change one face of the object at a time.
# UserA: Apply the texture, [[:File:TestDiffuse001.png]], to a single face of the prim (while in Select Face mode). This should result in the prim having two textures. The "100" image should appear on only one face.
# UserA: Verify that if an object uses more than one texture, the word Multiple will appear in the Texture image box over one of the texture images.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that the box's appearance has changed to show two textures, one on a single face the other on all other faces
# UserA: Verify that clicking Color box will open the Color Picker floating window.
# UserA: Verify that color tints selected are additive to the color of the base texture.
# UserA: Verify that using Transparency you can choose transparency level of the object.
# UserA: Verify that this setting applies an overall transparency to the texture in addition to any transparency in the alpha channel. The range is 0 to 100 percent. Set to 50%.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that the box's appearance has changed to show a color tint and is semi-transparent.
# UserA: Verify that using Glow item you can create a surface glow on the object, separate from the light emitted with the Features tab. The range is 0 to 1, but any glow above 0.1 tends to wash out the surface texture.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that the box's appearance has changed to add glow.
# UserA: Enable Full Bright.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that the box renders as if fully day-lighted, regardless of the environment day cycle position of the sun.
#* (Use World > Sun > <time of day> to change sun position.)
# UserA: Change Transparency and Glow settings back to 0, and disable Full Bright.
# Rez a 0.5 (default-size) cube and add <test texture> via the texture picker.
# UserA: set Horizontal Scale to 2
# UserA: set horizontal offset to 0.5
# UserA: Verify Repeats per Meter value has automatically changed to 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, side-by-side.
# UserA: set Vertical Scale to 2
# UserA: set Vertical Offset to 0.5
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale plus the Vertical Scale: 4 repeats in a 2x2 grid
# UserA: set Horizontal Scale to 1
# UserA: set Horizontal offset to 0
# UserA: Verify Repeats per Meter value remains at 4.0 (since this value now reflects the maximum density between horizontal and vertical scales)
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, one above the other.
# UserA: Verify that Rotation controls rotation of the texture relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# UserA: Verify that Align Planar Faces is disabled/greyed out when in the Mapping Default mode

====Texture Mapping: Diffuse texture, Planar mode====
# Set the Texture panel's dropdowns to read:
#* Materials
#* Texture (diffuse)
#* '''Mapping: Planar'''
# UserA: Verify that the Repeats/Meter value is disabled/greyed out when in the Mapping Planar mode is active
# Rez a cube and resize it to 1m per side. Reposition the cube so the entire prim can be viewed. Add the texture [[:File:TestDiffuse001.png]] via the texture picker.
# UserA: Set Horizontal Scale to 4
# UserA: Set Vertical Scale to 6
# UserA: Verify that the read-only Repeats Per Meter changed to 3.0 (yes, this is screwy, but it seems to match the release viewer)
# UserA: set horizontal offset to 0.5
# UserA: set Vertical offset to 0.5
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each plane of each prim face matches 4 repeats horizontally, 6 vertically
# UserA: Verify that Rotation controls rotation of the texture relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# '''Align Planar Faces test TBD'''

== Verify functionality of 'Alpha mode' option ==
=== No Mask is forced for textures without an alpha channel ===
# UserA, UserB, and UserC: login
# UserA: Take a snapshot (ctrl+S) and 'Save to inventory'
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: Set the snapshot as the texture on the box
# UserA: Verify that the 'Alpha mode' setting is 'None', and that the UI for changing 'Alpha mode is disabled'
#* Verify that the 'Mask cutoff' setting is hidden
# UserA, UserB, and UserC: Verify that the snapshot appears on the box, and that it is fully opaque
=== Alpha Blending ===
# UserA, UserB, and UserC: login
# UserA: Upload this alpha-mapped image to your inventory: [[:File:Maestro_alpha_gradient.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool. Open the Texture tab of the build tool.
# UserA: Using the texture picker from the build tool, set the image you uploaded on all faces of the box
# UserA, UserB, and UserC: verify that you see a 'smooth' transparency transition in the texture on all faces, with the bottom of the image being opaque and the top being transparent. This is the expected result when the 'Alpha mode' is set to the default 'Alpha blending' setting

=== Alpha Masking ===
# UserA, UserB, and UserC: login
# UserA: Upload this alpha-mapped image to your inventory (if you don't already have it): [[:File:Maestro_alpha_gradient.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool. Open the Texture tab of the build tool, and set the texture to the one you just uploaded.
# UserA: Set the 'Alpha mode' to 'Alpha masking'
#* Verify that the 'Mask cutoff' setting appears, and that the default value for it is 0
# UserA, UserB: verify that the box's texture appears (almost) completely opaque
# UserC: verify that you see no change (since your viewer doesn't support alpha masking)
# UserA: set the 'Mask cutoff' setting to 76
# UserA, UserB: Verify that the top 30% of the texture is now invisible, but the bottom 70% is totally opaque
# UserC: verify that you see no change
# UserA: set the 'Mask cutoff' setting to 178
# UserA, UserB: Verify that the top 70% of the texture is now invisible, but the bottom 30% is totally opaque
# UserC: verify that you see no change
# UserA: set the 'Mask cutoff' setting to 255
# UserA, UserB: Verify that the texture is now almost completely invisible (except perhaps a strip at the bottom)
# UserC: verify that you see no change
# UserA: Try to input 'Mask cutoff' settings < 0, and verify that they get slammed to 0 by the build tool UI
# UserA: Try to input 'Mask cutoff' settings > 255, and verify that they get slammed to 255 by the build tool UI

=== Emissive Mask ===
# UserA, UserB, and UserC: login
# UserA: Upload this alpha-mapped image to your inventory (if you don't already have it): [[:File:Kart_screenshot_with_KART_alpha.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool. Open the Texture tab of the build tool, and set the texture to the one you just uploaded.
# UserA, UserB, and UserC: Verify that the image on the box appears mostly transparent, with the word "KART" in the middle as an opaque section
# UserA: Set the 'Alpha mode' to 'Emissive mask'
#* Verify that the 'Mask cutoff' setting remains hidden
# UserA and UserB: verify that the box's appearance has changed. The whole texture should be opaque, but there should be a glowing word 'KART' in the texture.
# UserC: verify that the box's appearance has not changed (and you just see the image as mostly transparent with the opaque word 'KART')

=== No Mask (on a texture with an alpha channel) ===
# UserA, UserB, and UserC: login
# UserA: Upload this alpha-mapped image to your inventory (if you don't already have it): [[:File:Kart_screenshot_with_KART_alpha.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool. Open the Texture tab of the build tool, and set the texture to the one you just uploaded.
# UserA, UserB, and UserC: Verify that the image on the box appears mostly transparent, with the word "KART" in the middle as an opaque section
# UserA: Set the 'Alpha mode' to 'None'
#* Verify that the 'Mask cutoff' setting remains hidden
# UserA and UserB: verify that the box's appearance has changed. The whole texture should be opaque, and no word 'KART' should be visible.
# UserC: verify that the box's appearance has not changed (and you just see the image as mostly transparent with the opaque word 'KART')

== Verify functionality of 'Bumpiness' settings ==
=== Layout of Bumpiness settings ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Bumpiness (normal)"
# UserA: Verify that the build tool layout looks like the 'Materials > Normal' section from this mockup [[:File:BuildTool_Bumpiness_Shininess.png]]
# UserA: Verify the following default settings:
#* Verify that the Texture preview is empty, with a black-on-grey "X" (indicating that no normal map is set)
#* Verify that the 'Bumpiness' setting is currently 'None'
#* Verify that the 'Mapping' setting is 'Default'
#* Verify that 'Horizontal scale' is 1.0
#* Verify that 'Vertical scale' is 1.0
#* Verify that 'Repeats per meter' is enabled, and is 2.0 (this corresponds to a horizontal scale of 1.0 for a 50cm object)
#* Verify that 'Rotation' is 0.0
#* Verify that 'Horizontal offset' is 0.0
#* Verify that 'Vertical offset' is 0.0
#* Verify that 'Align planar faces' is disabled and cannot be edited
# UserA: Deselect the object
# UserA, UserB, UserC: verify that the box's appearance is unchanged (was not accidentally edited)

=== Legacy Bumpiness ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Bumpiness (normal)"
# UserA: Verify that you see the following options under the Bumpiness menu:
#* None
#* Brightness
#* Darkness
#* woodgrain
#* bark
#* bricks
#* checker
#* concrete
#* crustytile
#* cutstone
#* discs
#* gravel
#* petridish
#* siding
#* stonetile
#* stucco
#* suction
#* weave
# UserC: Rez a box and edit it with the build tool
# For each of the bumpiness menu options *except* for 'None', do the following:
#* UserA and UserC: select the same bumpiness menu option for your object's texture
#* UserA, UserB, and UserC: Verify that UserA's box has the same appearance as UserC's box
#* UserA: Verify that all of the texture mapping controls (scale, offset, rotation, align planar faces, etc.) are disabled in the UI (grayed out) when in this mode

=== Normal Map Texture Selection ===
# UserA, UserB, and UserC: login
# UserA: if you don't already have them in your inventory, upload these two textures to SL
#* [[:File:TestDiffuse001.png]]
#* [[:File:TestNormal001.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: Set the uploaded diffuse texture as the diffuse texture on your object
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Bumpiness (normal)"
# UserA: Verify that the Texture preview is empty, with a black-on-grey "X" (indicating that no normal map is set)
# UserA: Click on the texture icon, then choose the uploaded normal map using the texture picker
# UserA: Verify that the Texture preview shows the normal map you selected
# UserA: Verify that 'Bumpiness' is now set to "Use Texture"
# UserA and UserB: Verify that the uploaded textures appear on the box face at full scale, and are aligned. You should see a large '001' in the middle, due to the normal map effect.
# UserC: Verify that you can see the diffuse texture, but no bump map effect
# UserA: From the 'Bumpiness' menu, choose 'None'
# UserA: Verify that the Texture preview is now empty, with a black-on-grey "X" (indicating that no normal map is set)
# UserA, UserB, and UserC: Verify that you can see the diffuse texture, but no bump map effect
# UserA: Drag the uploaded normal map from your inventory onto the Texture preview icon
# UserA: Verify that the Texture preview shows the normal map you selected
# UserA: Verify that 'Bumpiness' becomes set to "Use Texture"
# UserA and UserB: Verify that you see both the normal map and diffuse map applied on the rendered box
# UserC: Verify that you can see the diffuse texture, but no normal map effect

=== Normal Map Texture mapping ===
====Normal texture, Default mapping====
# Set the Texture panel's dropdowns to read:
#* Materials
#* '''Bumpiness (normal)'''
#* '''Mapping: Default'''
# UserA: change the prim's texture to [[:File:TestNormal001.png]]
# UserA: set Horizontal Scale to 2
# UserA: set horizontal offset to 0.5
# UserA: Verify Repeats per Meter value has automatically changed to 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, side-by-side.
# UserA: set Vertical Scale to 2
# UserA: set Vertical Offset to 0.5
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale plus the Vertical Scale: 4 repeats in a 2x2 grid
# UserA: set Horizontal Scale to 1
# UserA: set Horizontal offset to 0
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, one above the other.
# UserA: Verify that Rotation controls rotation of the texture relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# UserA: Verify that Align Planar Faces is disabled/greyed out when in the Mapping Default mode

====Normal texture, Planar mapping====
# UserA, UserB, UserC: Login
# UserA: Rez a cube and resize it to 1m per side. Reposition the cube so the entire prim can be viewed. Set [[:File:TestDiffuse001.png]] as the diffuse map, via the texture picker.
# UserA: Set the Texture panel's dropdowns to read:
#* Materials
#* Bumpiness (normal)
#* '''Mapping: Planar'''
# USerA: Set [[:File:TestNormal001.png]] as the normal map, via the texture picker.
# UserA: Verify that the Repeats/Meter value is disabled/greyed out when in the Mapping Planar mode is active
# UserA: Set Horizontal Scale to 4
# UserA: Set Vertical Scale to 6
# UserA: Verify that the read-only Repeats Per Meter changed to 3.0 (yes, this is screwy, but it seems to match the release viewer)
# UserA: set horizontal offset to 0.5
# UserA: set Vertical offset to 0.5
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify that the diffuse texture appearance remains unchanged
#* UserA, UserB, and UserC: Verify the number of normal map repeats visible on each plane of each prim face matches 4 repeats horizontally, 6 vertically
# UserA: Verify that Rotation controls rotation of the normal map relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# '''Align Planar Faces test TBD'''

== Verify functionality of 'Shininess' settings ==

=== Layout of Shininess settings ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Shininess (specular)"
# UserA: Verify that the build tool layout looks like this mockup: [[:File:BuildtoolSpecular-NoTexture.png]]
# UserA: Verify the following default settings:
#* Verify that the Texture preview is empty, with a black-on-grey "X" (indicating that no specular map is set)
#* Verify that the 'Shininess' setting is currently 'None'
#* Verify that 'Glossiness' is hidden in this mode
#* Verify that 'Environment' is hidden in this mode
#* Verify that the 'Color' is hidden in this mode
#* Verify that the 'Mapping' setting is 'Default', and cannot be edited
#* Verify that 'Horizontal scale' is 1.0, and cannot be edited
#* Verify that 'Vertical scale' is 1.0, and cannot be edited
#* Verify that 'Repeats per meter' is 2.0 (this corresponds to a horizontal scale of 1.0 for a 50cm object), and cannot be edited
#* Verify that 'Rotation' is 0.0, and cannot be edited
#* Verify that 'Horizontal offset' is 0.0, and cannot be edited
#* Verify that 'Vertical offset' is 0.0, and cannot be edited
#* Verify that 'Align planar faces' is disabled, and cannot be edited
# UserA: Deselect the object
# UserA, UserB, UserC: verify that the box's appearance is unchanged (was not accidentally edited)

=== Legacy Shiny ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Shininess (specular)"
# UserA: Verify that you see the following options under the Shininess menu:
#* None
#* Low
#* Medium
#* High
# UserC: Rez a box and edit it with the build tool
# Do the following for Shininess settings 'Low', 'Medium', and 'High':
#* UserA and UserC: select the same Shininess menu option for your object's texture
#* UserA, UserB, and UserC: Verify that UserA's box has the same appearance as UserC's box
#* UserA: Verify that all of the texture mapping controls (scale, offset, rotation, align planar faces, etc.) are disabled in the UI (grayed out) when in this mode
#* UserA: Verify that Glossiness, Environment, and Color settings are not visible when in this mode.
#* UserA: Verify that Mapping drop down may be switched from Default to Planar and back
#* UserA: Verify that any prior changes made to; scale, repeats, rotation and offset are preserved when switching between Default and Planar

=== Specular Map Texture Selection ===
# UserA, UserB, and UserC: login
# UserA: if you don't already have them in your inventory, upload these two textures to SL
#* [[:File:TestDiffuse001.png]]
#* [[:File:TestSpecular001.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: Set the uploaded diffuse texture as the diffuse texture on your object
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Shininess (specular)"
# UserA: Verify that the Texture preview is empty, with a black-on-grey "X" (indicating that no specular map is set)
# UserA: Click on the texture icon, then choose the uploaded specular map using the texture picker
# UserA: Verify that the Texture preview shows the specular map you selected
# UserA: Verify that 'Shininess' is now set to "Use texture"
#* Verify that the floater has new elements, and now looks like [[:File:BuildtoolSpecular-UseTexture.png]]
#** Verify that Glossiness has a default value of 51
#** Verify that Environment has a default value of 0
#** Verify that Color defaults to white
# UserA and UserB: Verify that the uploaded textures appear on the box face at full scale, and are aligned.
#* The stained parts and the scratches should be less shiny than other parts of the texture
# UserC: Verify that you can see the diffuse texture, but no shiny effect
# UserA: From the 'Shininess' menu, choose 'None'
# UserA: Verify that the Texture preview is now empty, with a black-on-grey "X" (indicating that no normal map is set)
# UserA: Verify that the build tool layout has reverted to the style shown here: [[:File:BuildtoolSpecular-NoTexture.png]]
# UserA, UserB, and UserC: Verify that you can see the diffuse texture, but no specular map effect
# UserA: Drag the uploaded specular map from your inventory onto the Texture preview icon
# UserA: Verify that the Texture preview shows the specular map you selected
# UserA: Verify that 'Shininess' becomes set to "Use Texture"
# UserA and UserB: Verify that the uploaded textures appear on the box face at full scale, and are aligned
# UserC: Verify that you can see the diffuse texture, but no specular map effect

=== Specular Map Glossiness and Environment ===
# UserA, UserB, and UserC: login
# UserA: if you don't already have them in your inventory, upload these two textures to SL
#* [[:File:TestDiffuse001.png]]
#* [[:File:TestSpecular001.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: Set the uploaded diffuse texture as the diffuse texture on your object
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Shininess (specular)"
# UserA: Click on the texture icon, then choose the uploaded specular map using the texture picker
# UserA and UserB: verify that you see the object with the specular map applied
# UserC: Verify that you can see the diffuse texture, but no specular map effect
# UserA: Verify these default settings:
#* Glossiness should be 51
#* Environment should be 0
# UserA: Increase the Environment setting to 204
# UserA and UserB: Verify that the reflected color of the object now includes more of the environment (blue highlights from the sky color)
# UserC: verify that you see no change
# UserA: Try to enter an Environment setting > 255, and verify that the UI slams it to 255
# UserA: Try to enter an Environment setting < 0, and verify that the UI slams it to 0
# UserA: Increase the Glossiness setting to 204
# UserA and UserB: Verify that the specular highlights are now more 'blurred'
# UserC: verify that you see no change
# UserA: Try to enter a Glossiness setting > 255, and verify that the UI slams it to 255
# UserA: Try to enter a Glossiness setting < 0, and verify that the UI slams it to 0

=== Specular Map Texture mapping ===
====Specular texture, Default mapping====
# Set the Texture panel's dropdowns to read:
#* Materials
#* '''Shininess (specular)'''
#* '''Mapping: Default'''
# UserA: change the prim's texture to [[:File:TestSpecular001.png]]
# UserA: set Horizontal Scale to 2
# UserA: set horizontal offset to 0.5
# UserA: Verify Repeats per Meter value has automatically changed to 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, side-by-side.
# UserA: set Vertical Scale to 2
# UserA: set Vertical Offset to 0.5
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale plus the Vertical Scale: 4 repeats in a 2x2 grid
# UserA: set Horizontal Scale to 1
# UserA: set Horizontal offset to 0
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, one above the other.
# UserA: Verify that Rotation controls rotation of the texture relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# UserA: Verify that Align Planar Faces is disabled/greyed out when in the Mapping Default mode

====Normal texture, Planar mapping====
# UserA, UserB, UserC: Login
# UserA: Rez a cube and resize it to 1m per side. Reposition the cube so the entire prim can be viewed. Set [[:File:TestDiffuse001.png]] as the diffuse map, via the texture picker.
# UserA: Set the Texture panel's dropdowns to read:
#* Materials
#* Shiniiness (specular)
#* '''Mapping: Planar'''
# USerA: Set [[:File:TestSpecular001.png]] as the specular map, via the texture picker.
# UserA: Verify that the Repeats/Meter value is disabled/greyed out when in the Mapping Planar mode is active
# UserA: Set Horizontal Scale to 4
# UserA: Set Vertical Scale to 6
# UserA: Verify that the read-only Repeats Per Meter changed to 3.0 (yes, this is screwy, but it seems to match the release viewer)
# UserA: set horizontal offset to 0.5
# UserA: set Vertical offset to 0.5
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify that the diffuse texture appearance remains unchanged
#* UserA, UserB, and UserC: Verify the number of specular map repeats visible on each plane of each prim face matches 4 repeats horizontally, 6 vertically
# UserA: Verify that Rotation controls rotation of the specular map relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# '''Align Planar Faces test TBD'''

== Verify functionality of 'Media' settings ==
=== Layout and Default Values of Media Settings ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool
# UserA: In the Texture tab, change the edit mode from "Materials" to "Media".
# UserA: Verify that the build tool layout looks like this mockup: File:BuildToolMediaMode.png
# UserA: Verify that the following defaults are set:
#* Verify that the Color appears white
#* Verify that Transparency is 0%
#* Verify that Glow is 0.00
#* Verify that 'Full Bright' is disabled
#* Verify that 'Mapping' is 'Default
#** Verify that 'Horizontal scale' and 'Vertical scale' are both 1.00
#** Verify that 'Repeats per meter' is 2.0 (2.0/meter corresponds to 1.0/face on a 50cm cube face), and can be edited
#** Verify that 'Rotation' is 0.00
#** Verify that 'Horizontal offset' and 'Vertical offset' are both 0.00
#* Verify that 'Align planar faces' is unchecked and cannot be edited (is 'greyed out')'
# UserA, UserB, UserC: verify that the box's appearance is unchanged (was not accidentally edited)
=== Adding, and removing, and aligning media ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool
# UserA: Change your selection mode to "Select Face" and select only the top face
# UserA: In the Texture tab, change the edit mode from "Materials" to "Media".
# UserA: Click on the "Choose.." button, and verify that the "MEDIA SETTINGS" floater appears, and looks like this: [[:File:BuildToolMediaSettings.png]]
# UserA: Type "http://secondlife.com" into the Home Page text field in "MEDIA SETTINGS", and hit "Apply"
# UserA, UserB, and UserC: Verify that you see the SL website appear on the box's top face
# UserA: Change the 'Horizontal offset' value to 0.2
# UserA, UserB, and UserC: Verify that the SL website on the box is now slightly offset
# UserA: Click on the 'Align' button to align the website with the box's edges
# UserA, UserB, and UserC: Verify that the SL website on the box is now aligned with the box edges
# UserA: Click on the 'Remove' button to remove the prim media
# UserA: Verify that you see a modal dialog, asking to confirm media removal. Click "No"
# UserA, UserB, and UserC: Verify that the SL website on the box is unchanged
# UserA: Click on the 'Remove' button to remove the prim media
# UserA: Verify that you see a modal dialog, asking to confirm media removal. Click "Yes"
# UserA, UserB, and UserC: Verify that the SL website has disappeared from the box, and that the changed face is back to the default plywood texture

===Media Texture Mapping ===
====Media, Default mapping====
# UserA, UserB, UserC: login
# UserA: Rez a box, and edit one of its faces with the Build Tool
# UserA: Set the Texture panel's dropdowns to read:
#* Media
#* '''Mapping: Default'''
# UserA: Add media to a face on the box, using "http://secondlife.com", as in [[#Layout_and_Default_Values_of_Media_Settings]]
# UserA: set Horizontal Scale to 2
# UserA: set horizontal offset to 0.5
# UserA: Verify Repeats per Meter value has automatically changed to 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, side-by-side.
# UserA: set Vertical Scale to 2
# UserA: set Vertical Offset to 0.5
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale plus the Vertical Scale: 4 repeats in a 2x2 grid
# UserA: set Horizontal Scale to 1
# UserA: set Horizontal offset to 0
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, one above the other.
# UserA: Verify that Rotation controls rotation of the texture relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# UserA: Verify that Align Planar Faces is disabled/greyed out when in the Mapping Default mode

==== Media, Planar mapping====
# UserA, UserB, UserC: Login
# Rez a cube and resize it to 1m per side. Reposition the cube so the entire prim can be viewed. Add the texture [[:File:TestDiffuse001.png]] via the texture picker.
# UserA: Set the Texture panel's dropdowns to read:
#* Media
#** '''Mapping: Planar'''
# UserA: Verify that the Repeats/Meter value is disabled/greyed out when in the Mapping Planar mode is active
# UserA: Set Horizontal Scale to 4
# UserA: Set Vertical Scale to 6
# UserA: Verify that the read-only Repeats Per Meter changed to 3.0 (yes, this is screwy, but it seems to match the release viewer)
# UserA: set horizontal offset to 0.5
# UserA: set Vertical offset to 0.5
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each plane of each prim face matches 4 repeats horizontally, 6 vertically
# UserA: Verify that Rotation controls rotation of the texture relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# '''Align Planar Faces test TBD'''

= Materials Loading Test =
This test verifies that the viewer can fetch materials data and render it properly.

== Obtaining Test Objects ==
This test requires using 2 test objects which each contain many materials.

Some prepared test objects can be found at [http://maps.secondlife.com/secondlife/Bug%20Island/148/18/27 Bug Island]. There are 2 test linksets, each containing 50 unique materials:
* MaterialsObject01-50 contains 50 boxes, numbered by 01-50 with matching diffuse, normal, and specular maps.
* MaterialsObject51-100 contains 50 boxes, numbered by 51-100 with matching diffuse, normal, and specular maps.

Both link sets have prims that spin with llTargetOmega(), in order to make the specular maps more visible. You can modify the script in the root prim to remove this effect.

== Materials load when rezzed ==
# Log in
# Find a pair of neighboring regions which both allow you to rez objects, and move near the sim border
# Rez 'MaterialsObject01-50' in the region your avatar is in
# Without much delay, rez 'MaterialsObject51-100' in the neighboring region
# Verify that all diffuse/normal/specular maps for both linksets load in a timely manner
#* This may take a short while, since the viewer needs to download 300 separate textures for these objects

== Materials load upon login ==
# Complete the [[#Materials_load_when_rezzed]] test first
# Log out
# Login to the location where the objects were rezzed
# Verify that all diffuse/normal/specular maps for both linksets load in a timely manner
#* This should be relatively fast, since the viewer should have these textures in its cache

= Materials Rendering Test =
''Note: The following sections should be completed both above and below water. There is a trench directly to the west that replicates all test cases under water''

== Rendering of Legacy Bumpmaps and Shiny ==
''Note: this was lifted from [[Render_Correctness_Test]]''
# Go to http://maps.secondlife.com/secondlife/Bug%20Island%202/243/247/23
# Set your shaders and sun position as indicated on the red sphere at that location.
# Verify the spheres render the same as they appear in the picture at that location.
# Continue testing at the 5 stations to the South.
# Repeat test with 'Advanced Lighting Model' from graphics preferences both enabled and disabled (where allowed)
#* It is expected that 'Advanced Lighting Model' can only be enabled if both 'Basic Shaders' and 'Atmospheric Shaders' settings are enabled

==100% Transparent + Glow==
# Go to http://maps.secondlife.com/secondlife/Bug%20Island%202/240/174/23
# Set your shaders as indicated by the red sphere at that location.
# Verify that the sphere glows with ALM enabled.
# Verify that the sphere does not become opaque and black:
#* Under the Advanced->Rendering Types menu uncheck 'Water'
#* In Me->Preferences->Graphics uncheck and then recheck 'Advanced Lighting Model'
#* The sphere should continue to glow bright white.

''Note: When finished be sure to turn the water rendering back on in the Rendering Types menu''

==Consistent Lighting vs Solid and Alpha Surfaces==
# Go to http://maps.secondlife.com/secondlife/Bug%20Island%202/239/170/23
# The white plane is actually made up of two planes linked together.
# The plane on the left is solid, and the plane on the right has some Transparency %.
# With Local Lights on Verify under the following conditions that the two planes appear to be one plane:
#* With Basic Shaders enabled.
#* With Atmospheric Shaders enabled.
#* With Advanced Lighting Model enabled under all Sun Settings:
#** Sunrise
#** Midday
#** Sunset
#** Midnight

==Gamma Consistency w/ Full Bright + Alpha==
# Got to http://maps.secondlife.com/secondlife/Bug%20Island%202/241/164/23
# Follow the guidelines stated in the text on the red sphere at that location.
#* The cube with the pink circle should not be bright than the solid pink cube.
#* The cube with the target on it should not darken with ALM enabled.

== Alpha Modes Rendering ==
# Enter the 'Materials rendering test room' at http://maps.secondlife.com/secondlife/Bug%20Island%202/233/251/42
# Click World -> Sun -> Midday to set the viewer lighting
# Enable "Advanced Lighting Model" in your Preferences, under Graphics->Advanced
# Verify that row of 4 boxes on the northern side roughly match the appearance shown on the inworld 'Alpha modes sample' object
#* 'Alpha blended' should have a smooth transparency transition
#* 'Alpha masked' should have an abrupt transparency transition, with each pixel either fully opaque or fully transparent
#* 'Emissive mask' should look bright in the areas which appear more opaque in the 'Alpha blended' box
#* 'No Alpha' should be fully opaque
# Disable "Advanced Lighting Model" in your Preferences, under Graphics->Advanced
# Verify that the 'Emissive masked' box now appears the same as the 'No Alpha' box
# Verify that the other boxes have not changed their basic appearance

== Rendering with Normal Maps ==
# Enter the 'Materials rendering test room' at http://maps.secondlife.com/secondlife/Bug%20Island%202/235/248/46
# Click World -> Sun -> Midday to set the viewer lighting
# Enable "Advanced Lighting Model" in your Preferences, under Graphics->Advanced
# Look at the wall of test objects to the East, and confirm the appearance of each row roughly matches the sample screenshot on the left side. Each Row includes a different alpha type (labelled by floating text)
#* The 1st row, 'no specular', has objects which contain a normal map but have specularity disabled. These objects should have a totally matte appearance.
#* The 2nd row, 'low shiny', has objects which contain a normal map and use the legacy 'Low Shiny' setting. These objects should be slightly shiny, mostly for 'environment' reflections.
#* The 3rd row, 'medium shiny', has objects which contain a normal map and use the legacy 'Medium Shiny' setting. These objects should be slightly shinier than the 'low shiny' row, mostly for 'environment' reflections.
#* The 4th row, 'high shiny', has objects which contain a normal map and use the legacy 'Medium Shiny' setting. These objects should be slightly shinier than the 'medium shiny' row, mostly for 'environment' reflections.
#* The 5th row, '0 gloss, 0 env', has objects which contain a normal map and the '001' specular map, but has both glossiness and environment set to 0. These objects should look identical to the 'no specular' row.
#* The 6th row, '51 gloss, 0 env', has objects which contain a normal map and the '001' specular map, and has both glossiness=51 and environment=0. These objects should by mostly matte, except for shiny '001' sections in the upper-left and lower-right corners.
#* The 7th row, '51 gloss, 0 env, red', has objects which contain a normal map and the '001' specular map, and has both glossiness=51, environment=0, and a red specular color. These objects should appaer similar to those in the '51 gloss, 0 env' row, except that the shiny '001' parts should have a red hue.
#* The 8th row, '51 gloss, 200 env', has objects which contain a normal map and the '001' specular map, and has both glossiness=51 and environment=200. These objects should appaer metallic all over, and have the shiny '001' lettering in the upper-left and lower-right corners.
#* The 9th row, '0 gloss, 200 env', has objects which contain a normal map and the '001' specular map, and has both glossiness=0 and environment=200. These objects should appear metallic all over, but should only have the shiny '001' lettering in the upper-left and lower-right corners when there is a direct reflection from a light source (you have to move your camera around to see it).
# Disable "Advanced Lighting Model" in your Preferences, under Graphics->Advanced
# Look at the wall of test objects to the East, and confirm these changes:
#* All 'emissive mask' objects (far right column) now appear identical to the 'alpha none' objects next to them
#* All normal maps are missing
#* Rows 1, 5, 6, 7, 8, 9 (that is, all except for low/medium/high shiny rows) should all look identical to each other. None of them should appear shiny.
#* For each of rows 2-4 (low/medium/high shiny), the 'opaque', 'alpha none', and 'emissive mask' objects appear identical to each other (and look shiny)
#* For each of rows 2-4 (low/medium/high shiny), the 'alpha blend' and 'alpha mask' objects all appear non-shiny

== Materials Rendering on HUDs ==
Normal and specular maps should not render on objects which are attached as HUDs, due to the lack of lighting sources at the HUD layer (objects tend to render as full bright). However, some of the new alpha modes should effect rendering of HUD objects.
# Take a copy of 'Materials test HUD', which is rezzed at http://maps.secondlife.com/secondlife/Bug%20Island%202/229/253/23 - this object is a linkset of small boxes, with plenty of floating text.
# Enable "Advanced Lighting Model" in your Preferences, under Graphics->Advanced
# Wear the 'Materials test HUD' object from inventory. By default, it should attach to the 'Center' HUD attachment point
# If you have trouble seeing the floating text about each HUD object (the text can be crowded), set 'UI size' to 0.75 under Preferences->Advanced
# Position your camera so that you can see the attachments clearly - I used a blank-textured large prim as background
# Verify that the HUD appears like this screen shot: [[:File:Materials_test_HUD_appearance.png]]
#* Verify that no normal or specular maps appear with the '001' pattern
#** The boxes labelled with 'X gloss, Y env' should be identical to the 'no specular' boxes on the far left column
#** Each of the 'no specular' boxes on the far left column should appear identical to the non-brick 'Water particle 1' objects on the top row
#** In the top row, "No Alpha 'Water Particle 1' with legacy bricks" should look the same as "Emissive Masked 'Water Particle 1' with legacy bricks"
#* Verify that 'Opaque '001' diffuse map with legacy bricks' in the upper-left corner is the only box that has a visible 'bricks' pattern (this is legacy bumpiness)
#* Verify that the other 'with legacy bricks' objects in the top row do *not* have any bumpiness effect, and that the alpha modes render as labelled
#** These objects should have the same appearance as the non-'brick' objects on the right side of the first row
#* Verify that Alpha mode renders correctly
#** Verify that all of the 'opaque' boxes (with the 001 texture) appear fully opaque
#** Verify that all of the 'Alpha blended' objects appear alpha blended (semitransparent, with soft edges)
#** Verify that all of the 'Alpha masked' objects appear alpha masked (semitransparent, with hard edges)
#** Verify that all 'emissive mask' boxes match their corresponding 'alpha none' boxes, since all HUD objects render as fully emissive ('full bright')
#* Verify that legacy shiny objects appear darker than the others
#** Opaque-rendered objects (no alpha, emissive mask, or opaque) set to low/medium/high shiny boxes appear darker than the other boxes
#** The shading should be more severe with increasing shiny level: 'high shiny' objects should be darkest, while 'low shiny' objects should not be so dark
# Disable "Advanced Lighting Model" in your Preferences, under Graphics->Advanced
# Verify that the HUD appears like this screen shot: [[:File:Materials_test_HUD_appearance.png]]
#* Appearance should match what you saw when "Advanced Lighting Model" was enabled

== Materials Rendering on Rigged Meshes ==
TODO

== Rendering of Environment and Exponent Masks ==
TODO

[[Category:QA Portal]]
[[Category:Test Scripts]]

Viewer Materials Smoke Test

2019-07-03T22:34:04Z

Dan Linden: /* Emissive Mask */

= Overview =
* This test plan covers viewer-side support for the prim materials project, which provides support for normal maps and specular maps applied to object faces
* A high-level specification of this featureset can be found at [[Material_Data]]

= Build Tool Test =

== Required Materials ==
* A region which supports normal and specular maps
** As of [[Release_Notes/Second_Life_Server/13#13.02.08.270166|Second Life Server 13.02.08.270166]], materials support is in the server.
* Three test users
** UserA, who uses a viewer which supports normal and specular maps, and does the building (actually performs operations)
** UserB, who uses a viewer which supports normal and specular maps, and only observes the results of UserA's work
*** The purpose of this user is to verify that build tool edits sent by UserA's viewer produce congruent results
** UserC, who uses an 'old' (no support for normal and specular maps) viewer, and only observes the results of UserA's work
*** The purpose of this user is to verify that edited content looks reasonable on legacy viewers, and sometimes to verify that build tool settings from the new viewer have the same appearance as those set by the legacy viewer.
** UserA and UserB should have "Advanced Lighting Model" enabled under Preferences -> Graphics settings, under "Advanced". This setting is required for the viewer to render normal and specular maps properly.
* Upload the following textures to use in this test:
** [[:File:TestDiffuse001.png]]
** [[:File:TestNormal001.png]]
** [[:File:TestSpecular001.png]]

== Verify Basic Build Tool Layout ==

=== Verify that non-Texture portions of the build tool have not changed ===
# UserA, UserB, and UserC: login
# UserA and UserC: each rez a box
# UserA and UserC: select the box that you rezzed, and select Edit from the context menu
# UserA and UserC: verify that your build tools appear, and that the appearance is identical in the following tabs:
#* General
#* Object
#* Features
#* Content
# UserA and UserC: verify that the build tool UI is the same for each of the build tool modes (top row of buttons)
#* Focus (magnifying glass icon)
#* Move (hand icon)
#* Edit (mouse cursor icon)
#* Create (magic wand icon)
#* Land (bulldozer icon)
# UserA: deselect the box
# UserA, UserB, and UserC: verify that UserA's box still looks like a default box (has not changed appearance)

=== Verify layout and default values of build tool's Texture tab ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool
# UserA: Open the Texture tab of the build tool, and verify that the layout basically matches the image here (minus colorful lines): [[:File:MaterialsBuildUI1.png]]. Verify that the following defaults are set:
#* Verify that "Materials" is the default face edit mode
#* Verify that "Texture (diffuse)" is the default texture edit mode
#* Verify that the Color appears white
#* Verify that Transparency is 0%
#* Verify that Glow is 0.00
#* Verify that 'Full Bright' is disabled
#* Verify that the texture preview shows the default plywood texture
#* Verify that 'Alpha mode' is 'Alpha blending'
#* Verify that 'Mask cutoff' does *not* appear (this option is not applicable in this alpha mode)

=== Verify layout and default values for Mapping option ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool. Open the Texture tab of the build tool.
#* Verify that 'Repeats' is 'per face (default)'
#** Verify that the texture mapping settings match the 'Mapping = default' section in '2b' of this reference image: [[:File:MaterialsBuildUI1.png]].. Verify that the following defaults are set:
#** Verify that 'Horizontal scale' and 'Vertical scale' are both 1.00
#** Verify that 'Repeats per meter' is 2.0 (2.0/meter corresponds to 1.0/face on a 50cm cube face), and can be edited
#** Verify that 'Rotation' is 0.00
#** Verify that 'Horizontal offset' and 'Vertical offset' are both 0.00
#** Verify that 'Align planar faces' is *not* visible
# UserA: Deselect the box
# UserA, UserB, and UserC: verify that the box's appearance has not changed (since no edits have been made)
# UserA: Reselect the box, and 'Edit' it again
# UserA: Under the Texture tab, change the 'Mapping' setting to 'Planar'
#* Verify that the texture mapping settings match the 'Mapping = planar' section in '2b' of this reference image: [[:File:MaterialsBuildUI1.png]].. Verify that the following defaults are set:
#** Verify that 'Number of repeats' is 2.00, and *cannot* be edited (is read-only)
#** Verify that 'Rotation' is 0.00
#** Verify that 'Horizontal offset' and 'Vertical offset' are both 0.00
#** Verify that 'Align planar faces' is visible, unchecked and enabled (*can* be edited)
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that the box's appearance has not changed (since the change to 'planar' mapping by itself has no visible effect on this box)

=== Verify build tool editing of texture settings ===
#* Note: UserA: run the following tests for texture settings., for both planar and default texture mapping modes
#*Note: UserB, and UserC: throughout the test, verify that you see the expected results based on the observer Viewer in use.

====Texture Mapping: Diffuse texture, Default mode====
# UserA: Set the Texture panel's dropdowns to read:
#* Materials
#* Texture (diffuse)
#* Mapping: Default
# UserA: Create a new cube prim for use in this test.
# UserA: Verify that clicking Texture box will open the Pick: Texture floating window, allowing you to select a new texture.
# UserA: Verify that you can drag a texture from your Inventory window to the Texture box.
# UserA: Verify that if the Select Face item is NOT selected, texture changes are applied to all sides at once.
# UserA: Verify that if the Select Face item in the upper pane of the Tools window is selected, you can change one face of the object at a time.
# UserA: Verify that if you drag a texture from your Inventory window directly to the object, you can change one face of the object at a time.
# UserA: Apply the texture, [[:File:TestDiffuse001.png]], to a single face of the prim (while in Select Face mode). This should result in the prim having two textures. The "100" image should appear on only one face.
# UserA: Verify that if an object uses more than one texture, the word Multiple will appear in the Texture image box over one of the texture images.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that the box's appearance has changed to show two textures, one on a single face the other on all other faces
# UserA: Verify that clicking Color box will open the Color Picker floating window.
# UserA: Verify that color tints selected are additive to the color of the base texture.
# UserA: Verify that using Transparency you can choose transparency level of the object.
# UserA: Verify that this setting applies an overall transparency to the texture in addition to any transparency in the alpha channel. The range is 0 to 100 percent. Set to 50%.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that the box's appearance has changed to show a color tint and is semi-transparent.
# UserA: Verify that using Glow item you can create a surface glow on the object, separate from the light emitted with the Features tab. The range is 0 to 1, but any glow above 0.1 tends to wash out the surface texture.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that the box's appearance has changed to add glow.
# UserA: Enable Full Bright.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that the box renders as if fully day-lighted, regardless of the environment day cycle position of the sun.
#* (Use World > Sun > <time of day> to change sun position.)
# UserA: Change Transparency and Glow settings back to 0, and disable Full Bright.
# Rez a 0.5 (default-size) cube and add <test texture> via the texture picker.
# UserA: set Horizontal Scale to 2
# UserA: set horizontal offset to 0.5
# UserA: Verify Repeats per Meter value has automatically changed to 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, side-by-side.
# UserA: set Vertical Scale to 2
# UserA: set Vertical Offset to 0.5
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale plus the Vertical Scale: 4 repeats in a 2x2 grid
# UserA: set Horizontal Scale to 1
# UserA: set Horizontal offset to 0
# UserA: Verify Repeats per Meter value remains at 4.0 (since this value now reflects the maximum density between horizontal and vertical scales)
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, one above the other.
# UserA: Verify that Rotation controls rotation of the texture relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# UserA: Verify that Align Planar Faces is disabled/greyed out when in the Mapping Default mode

====Texture Mapping: Diffuse texture, Planar mode====
# Set the Texture panel's dropdowns to read:
#* Materials
#* Texture (diffuse)
#* '''Mapping: Planar'''
# UserA: Verify that the Repeats/Meter value is disabled/greyed out when in the Mapping Planar mode is active
# Rez a cube and resize it to 1m per side. Reposition the cube so the entire prim can be viewed. Add the texture [[:File:TestDiffuse001.png]] via the texture picker.
# UserA: Set Horizontal Scale to 4
# UserA: Set Vertical Scale to 6
# UserA: Verify that the read-only Repeats Per Meter changed to 3.0 (yes, this is screwy, but it seems to match the release viewer)
# UserA: set horizontal offset to 0.5
# UserA: set Vertical offset to 0.5
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each plane of each prim face matches 4 repeats horizontally, 6 vertically
# UserA: Verify that Rotation controls rotation of the texture relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# '''Align Planar Faces test TBD'''

== Verify functionality of 'Alpha mode' option ==
=== No Mask is forced for textures without an alpha channel ===
# UserA, UserB, and UserC: login
# UserA: Take a snapshot (ctrl+S) and 'Save to inventory'
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: Set the snapshot as the texture on the box
# UserA: Verify that the 'Alpha mode' setting is 'None', and that the UI for changing 'Alpha mode is disabled'
#* Verify that the 'Mask cutoff' setting is hidden
# UserA, UserB, and UserC: Verify that the snapshot appears on the box, and that it is fully opaque
=== Alpha Blending ===
# UserA, UserB, and UserC: login
# UserA: Upload this alpha-mapped image to your inventory: [[:File:Maestro_alpha_gradient.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool. Open the Texture tab of the build tool.
# UserA: Using the texture picker from the build tool, set the image you uploaded on all faces of the box
# UserA, UserB, and UserC: verify that you see a 'smooth' transparency transition in the texture on all faces, with the bottom of the image being opaque and the top being transparent. This is the expected result when the 'Alpha mode' is set to the default 'Alpha blending' setting

=== Alpha Masking ===
# UserA, UserB, and UserC: login
# UserA: Upload this alpha-mapped image to your inventory (if you don't already have it): [[:File:Maestro_alpha_gradient.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool. Open the Texture tab of the build tool, and set the texture to the one you just uploaded.
# UserA: Set the 'Alpha mode' to 'Alpha masking'
#* Verify that the 'Mask cutoff' setting appears, and that the default value for it is 0
# UserA, UserB: verify that the box's texture appears (almost) completely opaque
# UserC: verify that you see no change (since your viewer doesn't support alpha masking)
# UserA: set the 'Mask cutoff' setting to 76
# UserA, UserB: Verify that the top 30% of the texture is now invisible, but the bottom 70% is totally opaque
# UserC: verify that you see no change
# UserA: set the 'Mask cutoff' setting to 178
# UserA, UserB: Verify that the top 70% of the texture is now invisible, but the bottom 30% is totally opaque
# UserC: verify that you see no change
# UserA: set the 'Mask cutoff' setting to 255
# UserA, UserB: Verify that the texture is now almost completely invisible (except perhaps a strip at the bottom)
# UserC: verify that you see no change
# UserA: Try to input 'Mask cutoff' settings < 0, and verify that they get slammed to 0 by the build tool UI
# UserA: Try to input 'Mask cutoff' settings > 255, and verify that they get slammed to 255 by the build tool UI

=== Emissive Mask ===
# UserA, UserB, and UserC: login
# UserA: Upload this alpha-mapped image to your inventory (if you don't already have it): [[:File:Kart_screenshot_with_KART_alpha.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool. Open the Texture tab of the build tool, and set the texture to the one you just uploaded.
# UserA, UserB, and UserC: Verify that the image on the box appears mostly transparent, with the word "KART" in the middle as an opaque section
# UserA: Set the 'Alpha mode' to 'Emissive mask'
#* Verify that the 'Mask cutoff' setting remains hidden
# UserA and UserB: verify that the box's appearance has changed. The whole texture should be opaque, but there should be a glowing word 'KART' in the texture.
# UserC: verify that the box's appearance has not changed (and you just see the image as mostly transparent with the opaque word 'KART')

=== No Mask (on a texture with an alpha channel) ===
# UserA, UserB, and UserC: login
# UserA: Upload this alpha-mapped image to your inventory (if you don't already have it): [[:File:Kart_screenshot_with_KART_alpha.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool. Open the Texture tab of the build tool, and set the texture to the one you just uploaded.
# UserA, UserB, and UserC: Verify that the image on the box appears mostly transparent, with the word "KART" in the middle as an opaque section
# UserA: Set the 'Alpha mode' to 'None'
#* Verify that the 'Mask cutoff' setting remains hidden
# UserA and UserB: verify that the box's appearance has changed. The whole texture should be opaque, and no word 'KART' should be visible.
# UserC: verify that the box's appearance has not changed (and you just see the image as mostly transparent with the opaque word 'KART')

== Verify functionality of 'Bumpiness' settings ==
=== Layout of Bumpiness settings ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Bumpiness (normal)"
# UserA: Verify that the build tool layout looks like the 'Materials > Normal' section from this mockup [[:File:BuildTool_Bumpiness_Shininess.png]]
# UserA: Verify the following default settings:
#* Verify that the Texture preview is empty, with a black-on-grey "X" (indicating that no normal map is set)
#* Verify that the 'Bumpiness' setting is currently 'None'
#* Verify that the 'Mapping' setting is 'Default'
#* Verify that 'Horizontal scale' is 1.0
#* Verify that 'Vertical scale' is 1.0
#* Verify that 'Repeats per meter' is enabled, and is 2.0 (this corresponds to a horizontal scale of 1.0 for a 50cm object)
#* Verify that 'Rotation' is 0.0
#* Verify that 'Horizontal offset' is 0.0
#* Verify that 'Vertical offset' is 0.0
#* Verify that 'Align planar faces' is disabled and cannot be edited
# UserA: Deselect the object
# UserA, UserB, UserC: verify that the box's appearance is unchanged (was not accidentally edited)

=== Legacy Bumpiness ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Bumpiness (normal)"
# UserA: Verify that you see the following options under the Bumpiness menu:
#* None
#* Brightness
#* Darkness
#* woodgrain
#* bark
#* bricks
#* checker
#* concrete
#* crustytile
#* cutstone
#* discs
#* gravel
#* petridish
#* siding
#* stonetile
#* stucco
#* suction
#* weave
# UserC: Rez a box and edit it with the build tool
# For each of the bumpiness menu options *except* for 'None', do the following:
#* UserA and UserC: select the same bumpiness menu option for your object's texture
#* UserA, UserB, and UserC: Verify that UserA's box has the same appearance as UserC's box
#* UserA: Verify that all of the texture mapping controls (scale, offset, rotation, align planar faces, etc.) are disabled in the UI (grayed out) when in this mode

=== Normal Map Texture Selection ===
# UserA, UserB, and UserC: login
# UserA: if you don't already have them in your inventory, upload these two textures to SL
#* [[:File:TestDiffuse001.png]]
#* [[:File:TestNormal001.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: Set the uploaded diffuse texture as the diffuse texture on your object
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Bumpiness (normal)"
# UserA: Verify that the Texture preview is empty, with a black-on-grey "X" (indicating that no normal map is set)
# UserA: Click on the texture icon, then choose the uploaded normal map using the texture picker
# UserA: Verify that the Texture preview shows the normal map you selected
# UserA: Verify that 'Bumpiness' is now set to "Use Texture"
# UserA and UserB: Verify that the uploaded textures appear on the box face at full scale, and are aligned. You should see a large '001' in the middle, due to the normal map effect.
# UserC: Verify that you can see the diffuse texture, but no bump map effect
# UserA: From the 'Bumpiness' menu, choose 'None'
# UserA: Verify that the Texture preview is now empty, with a black-on-grey "X" (indicating that no normal map is set)
# UserA, UserB, and UserC: Verify that you can see the diffuse texture, but no bump map effect
# UserA: Drag the uploaded normal map from your inventory onto the Texture preview icon
# UserA: Verify that the Texture preview shows the normal map you selected
# UserA: Verify that 'Bumpiness' becomes set to "Use Texture"
# UserA and UserB: Verify that you see both the normal map and diffuse map applied on the rendered box
# UserC: Verify that you can see the diffuse texture, but no normal map effect

=== Normal Map Texture mapping ===
====Normal texture, Default mapping====
# Set the Texture panel's dropdowns to read:
#* Materials
#* '''Bumpiness (normal)'''
#* '''Mapping: Default'''
# UserA: change the prim's texture to [[:File:TestNormal001.png]]
# UserA: set Horizontal Scale to 2
# UserA: set horizontal offset to 0.5
# UserA: Verify Repeats per Meter value has automatically changed to 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, side-by-side.
# UserA: set Vertical Scale to 2
# UserA: set Vertical Offset to 0.5
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale plus the Vertical Scale: 4 repeats in a 2x2 grid
# UserA: set Horizontal Scale to 1
# UserA: set Horizontal offset to 0
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, one above the other.
# UserA: Verify that Rotation controls rotation of the texture relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# UserA: Verify that Align Planar Faces is disabled/greyed out when in the Mapping Default mode

====Normal texture, Planar mapping====
# UserA, UserB, UserC: Login
# UserA: Rez a cube and resize it to 1m per side. Reposition the cube so the entire prim can be viewed. Set [[:File:TestDiffuse001.png]] as the diffuse map, via the texture picker.
# UserA: Set the Texture panel's dropdowns to read:
#* Materials
#* Bumpiness (normal)
#* '''Mapping: Planar'''
# USerA: Set [[:File:TestNormal001.png]] as the normal map, via the texture picker.
# UserA: Verify that the Repeats/Meter value is disabled/greyed out when in the Mapping Planar mode is active
# UserA: Set Horizontal Scale to 4
# UserA: Set Vertical Scale to 6
# UserA: Verify that the read-only Repeats Per Meter changed to 3.0 (yes, this is screwy, but it seems to match the release viewer)
# UserA: set horizontal offset to 0.5
# UserA: set Vertical offset to 0.5
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify that the diffuse texture appearance remains unchanged
#* UserA, UserB, and UserC: Verify the number of normal map repeats visible on each plane of each prim face matches 4 repeats horizontally, 6 vertically
# UserA: Verify that Rotation controls rotation of the normal map relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# '''Align Planar Faces test TBD'''

== Verify functionality of 'Shininess' settings ==

=== Layout of Shininess settings ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Shininess (specular)"
# UserA: Verify that the build tool layout looks like this mockup: [[:File:BuildtoolSpecular-NoTexture.png]]
# UserA: Verify the following default settings:
#* Verify that the Texture preview is empty, with a black-on-grey "X" (indicating that no specular map is set)
#* Verify that the 'Shininess' setting is currently 'None'
#* Verify that 'Glossiness' is hidden in this mode
#* Verify that 'Environment' is hidden in this mode
#* Verify that the 'Color' is hidden in this mode
#* Verify that the 'Mapping' setting is 'Default', and cannot be edited
#* Verify that 'Horizontal scale' is 1.0, and cannot be edited
#* Verify that 'Vertical scale' is 1.0, and cannot be edited
#* Verify that 'Repeats per meter' is 2.0 (this corresponds to a horizontal scale of 1.0 for a 50cm object), and cannot be edited
#* Verify that 'Rotation' is 0.0, and cannot be edited
#* Verify that 'Horizontal offset' is 0.0, and cannot be edited
#* Verify that 'Vertical offset' is 0.0, and cannot be edited
#* Verify that 'Align planar faces' is disabled, and cannot be edited
# UserA: Deselect the object
# UserA, UserB, UserC: verify that the box's appearance is unchanged (was not accidentally edited)

=== Legacy Shiny ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Shininess (specular)"
# UserA: Verify that you see the following options under the Shininess menu:
#* None
#* Low
#* Medium
#* High
# UserC: Rez a box and edit it with the build tool
# Do the following for Shininess settings 'Low', 'Medium', and 'High':
#* UserA and UserC: select the same Shininess menu option for your object's texture
#* UserA, UserB, and UserC: Verify that UserA's box has the same appearance as UserC's box
#* UserA: Verify that all of the texture mapping controls (scale, offset, rotation, align planar faces, etc.) are disabled in the UI (grayed out) when in this mode
#* UserA: Verify that Glossiness, Environment, and Color settings are not visible when in this mode.
#* UserA: Verify that Mapping drop down may be switched from Default to Planar and back
#* UserA: Verify that any prior changes made to; scale, repeats, rotation and offset are preserved when switching between Default and Planar

=== Specular Map Texture Selection ===
# UserA, UserB, and UserC: login
# UserA: if you don't already have them in your inventory, upload these two textures to SL
#* [[:File:TestDiffuse001.png]]
#* [[:File:TestSpecular001.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: Set the uploaded diffuse texture as the diffuse texture on your object
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Shininess (specular)"
# UserA: Verify that the Texture preview is empty, with a black-on-grey "X" (indicating that no specular map is set)
# UserA: Click on the texture icon, then choose the uploaded specular map using the texture picker
# UserA: Verify that the Texture preview shows the specular map you selected
# UserA: Verify that 'Shininess' is now set to "Use texture"
#* Verify that the floater has new elements, and now looks like [[:File:BuildtoolSpecular-UseTexture.png]]
#** Verify that Glossiness has a default value of 51
#** Verify that Environment has a default value of 0
#** Verify that Color defaults to white
# UserA and UserB: Verify that the uploaded textures appear on the box face at full scale, and are aligned.
#* The stained parts and the scratches should be less shiny than other parts of the texture
# UserC: Verify that you can see the diffuse texture, but no shiny effect
# UserA: From the 'Shininess' menu, choose 'None'
# UserA: Verify that the Texture preview is now empty, with a black-on-grey "X" (indicating that no normal map is set)
# UserA: Verify that the build tool layout has reverted to the style shown here: [[:File:BuildtoolSpecular-NoTexture.png]]
# UserA, UserB, and UserC: Verify that you can see the diffuse texture, but no specular map effect
# UserA: Drag the uploaded specular map from your inventory onto the Texture preview icon
# UserA: Verify that the Texture preview shows the specular map you selected
# UserA: Verify that 'Shininess' becomes set to "Use Texture"
# UserA and UserB: Verify that the uploaded textures appear on the box face at full scale, and are aligned
# UserC: Verify that you can see the diffuse texture, but no specular map effect

=== Specular Map Glossiness and Environment ===
# UserA, UserB, and UserC: login
# UserA: if you don't already have them in your inventory, upload these two textures to SL
#* [[:File:TestDiffuse001.png]]
#* [[:File:TestSpecular001.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: Set the uploaded diffuse texture as the diffuse texture on your object
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Shininess (specular)"
# UserA: Click on the texture icon, then choose the uploaded specular map using the texture picker
# UserA and UserB: verify that you see the object with the specular map applied
# UserC: Verify that you can see the diffuse texture, but no specular map effect
# UserA: Verify these default settings:
#* Glossiness should be 51
#* Environment should be 0
# UserA: Increase the Environment setting to 204
# UserA and UserB: Verify that the reflected color of the object now includes more of the environment (blue highlights from the sky color)
# UserC: verify that you see no change
# UserA: Try to enter an Environment setting > 255, and verify that the UI slams it to 255
# UserA: Try to enter an Environment setting < 0, and verify that the UI slams it to 0
# UserA: Increase the Glossiness setting to 204
# UserA and UserB: Verify that the specular highlights are now more 'blurred'
# UserC: verify that you see no change
# UserA: Try to enter a Glossiness setting > 255, and verify that the UI slams it to 255
# UserA: Try to enter a Glossiness setting < 0, and verify that the UI slams it to 0

=== Specular Map Texture mapping ===
====Specular texture, Default mapping====
# Set the Texture panel's dropdowns to read:
#* Materials
#* '''Shininess (specular)'''
#* '''Mapping: Default'''
# UserA: change the prim's texture to [[:File:TestSpecular001.png]]
# UserA: set Horizontal Scale to 2
# UserA: set horizontal offset to 0.5
# UserA: Verify Repeats per Meter value has automatically changed to 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, side-by-side.
# UserA: set Vertical Scale to 2
# UserA: set Vertical Offset to 0.5
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale plus the Vertical Scale: 4 repeats in a 2x2 grid
# UserA: set Horizontal Scale to 1
# UserA: set Horizontal offset to 0
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, one above the other.
# UserA: Verify that Rotation controls rotation of the texture relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# UserA: Verify that Align Planar Faces is disabled/greyed out when in the Mapping Default mode

====Normal texture, Planar mapping====
# UserA, UserB, UserC: Login
# UserA: Rez a cube and resize it to 1m per side. Reposition the cube so the entire prim can be viewed. Set [[:File:TestDiffuse001.png]] as the diffuse map, via the texture picker.
# UserA: Set the Texture panel's dropdowns to read:
#* Materials
#* Shiniiness (specular)
#* '''Mapping: Planar'''
# USerA: Set [[:File:TestSpecular001.png]] as the specular map, via the texture picker.
# UserA: Verify that the Repeats/Meter value is disabled/greyed out when in the Mapping Planar mode is active
# UserA: Set Horizontal Scale to 4
# UserA: Set Vertical Scale to 6
# UserA: Verify that the read-only Repeats Per Meter changed to 3.0 (yes, this is screwy, but it seems to match the release viewer)
# UserA: set horizontal offset to 0.5
# UserA: set Vertical offset to 0.5
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify that the diffuse texture appearance remains unchanged
#* UserA, UserB, and UserC: Verify the number of specular map repeats visible on each plane of each prim face matches 4 repeats horizontally, 6 vertically
# UserA: Verify that Rotation controls rotation of the specular map relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# '''Align Planar Faces test TBD'''

== Verify functionality of 'Media' settings ==
=== Layout and Default Values of Media Settings ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool
# UserA: In the Texture tab, change the edit mode from "Materials" to "Media".
# UserA: Verify that the build tool layout looks like this mockup: File:BuildToolMediaMode.png
# UserA: Verify that the following defaults are set:
#* Verify that the Color appears white
#* Verify that Transparency is 0%
#* Verify that Glow is 0.00
#* Verify that 'Full Bright' is disabled
#* Verify that 'Mapping' is 'Default
#** Verify that 'Horizontal scale' and 'Vertical scale' are both 1.00
#** Verify that 'Repeats per meter' is 2.0 (2.0/meter corresponds to 1.0/face on a 50cm cube face), and can be edited
#** Verify that 'Rotation' is 0.00
#** Verify that 'Horizontal offset' and 'Vertical offset' are both 0.00
#* Verify that 'Align planar faces' is unchecked and cannot be edited (is 'greyed out')'
# UserA, UserB, UserC: verify that the box's appearance is unchanged (was not accidentally edited)
=== Adding, and removing, and aligning media ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool
# UserA: Change your selection mode to "Select Face" and select only the top face
# UserA: In the Texture tab, change the edit mode from "Materials" to "Media".
# UserA: Click on the "Choose.." button, and verify that the "MEDIA SETTINGS" floater appears, and looks like this: [[:File:BuildToolMediaSettings.png]]
# UserA: Type "http://secondlife.com" into the Home Page text field in "MEDIA SETTINGS", and hit "Apply"
# UserA, UserB, and UserC: Verify that you see the SL website appear on the box's top face
# UserA: Change the 'Horizontal offset' value to 0.2
# UserA, UserB, and UserC: Verify that the SL website on the box is now slightly offset
# UserA: Click on the 'Align' button to align the website with the box's edges
# UserA, UserB, and UserC: Verify that the SL website on the box is now aligned with the box edges
# UserA: Click on the 'Remove' button to remove the prim media
# UserA: Verify that you see a modal dialog, asking to confirm media removal. Click "No"
# UserA, UserB, and UserC: Verify that the SL website on the box is unchanged
# UserA: Click on the 'Remove' button to remove the prim media
# UserA: Verify that you see a modal dialog, asking to confirm media removal. Click "Yes"
# UserA, UserB, and UserC: Verify that the SL website has disappeared from the box, and that the changed face is back to the default plywood texture

===Media Texture Mapping ===
====Media, Default mapping====
# UserA, UserB, UserC: login
# UserA: Rez a box, and edit one of its faces with the Build Tool
# UserA: Set the Texture panel's dropdowns to read:
#* Media
#* '''Mapping: Default'''
# UserA: Add media to a face on the box, using "http://secondlife.com", as in [[#Layout_and_Default_Values_of_Media_Settings]]
# UserA: set Horizontal Scale to 2
# UserA: set horizontal offset to 0.5
# UserA: Verify Repeats per Meter value has automatically changed to 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, side-by-side.
# UserA: set Vertical Scale to 2
# UserA: set Vertical Offset to 0.5
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale plus the Vertical Scale: 4 repeats in a 2x2 grid
# UserA: set Horizontal Scale to 1
# UserA: set Horizontal offset to 0
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, one above the other.
# UserA: Verify that Rotation controls rotation of the texture relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# UserA: Verify that Align Planar Faces is disabled/greyed out when in the Mapping Default mode

==== Media, Planar mapping====
# UserA, UserB, UserC: Login
# UserA: Rez a cube and resize it to 1m per side. Reposition the cube so the entire prim can be viewed. Add <test texture> via the texture picker.
# UserA: Set the Texture panel's dropdowns to read:
#* Media
#** '''Mapping: Planar'''
# UserA: Verify that the Repeats/Meter value is disabled/greyed out when in the Mapping Planar mode is active
# Rez a cube and resize it to 1m per side. Reposition the cube so the entire prim can be viewed. Add the texture [[:File:TestDiffuse001.png]] via the texture picker.
# UserA: Set Horizontal Scale to 4
# UserA: Set Vertical Scale to 6
# UserA: Verify that the read-only Repeats Per Meter changed to 3.0 (yes, this is screwy, but it seems to match the release viewer)
# UserA: set horizontal offset to 0.5
# UserA: set Vertical offset to 0.5
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each plane of each prim face matches 4 repeats horizontally, 6 vertically
# UserA: Verify that Rotation controls rotation of the texture relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# '''Align Planar Faces test TBD'''

= Materials Loading Test =
This test verifies that the viewer can fetch materials data and render it properly.

== Obtaining Test Objects ==
This test requires using 2 test objects which each contain many materials.

Some prepared test objects can be found at [http://maps.secondlife.com/secondlife/Bug%20Island/148/18/27 Bug Island]. There are 2 test linksets, each containing 50 unique materials:
* MaterialsObject01-50 contains 50 boxes, numbered by 01-50 with matching diffuse, normal, and specular maps.
* MaterialsObject51-100 contains 50 boxes, numbered by 51-100 with matching diffuse, normal, and specular maps.

Both link sets have prims that spin with llTargetOmega(), in order to make the specular maps more visible. You can modify the script in the root prim to remove this effect.

== Materials load when rezzed ==
# Log in
# Find a pair of neighboring regions which both allow you to rez objects, and move near the sim border
# Rez 'MaterialsObject01-50' in the region your avatar is in
# Without much delay, rez 'MaterialsObject51-100' in the neighboring region
# Verify that all diffuse/normal/specular maps for both linksets load in a timely manner
#* This may take a short while, since the viewer needs to download 300 separate textures for these objects

== Materials load upon login ==
# Complete the [[#Materials_load_when_rezzed]] test first
# Log out
# Login to the location where the objects were rezzed
# Verify that all diffuse/normal/specular maps for both linksets load in a timely manner
#* This should be relatively fast, since the viewer should have these textures in its cache

= Materials Rendering Test =
''Note: The following sections should be completed both above and below water. There is a trench directly to the west that replicates all test cases under water''

== Rendering of Legacy Bumpmaps and Shiny ==
''Note: this was lifted from [[Render_Correctness_Test]]''
# Go to http://maps.secondlife.com/secondlife/Bug%20Island%202/243/247/23
# Set your shaders and sun position as indicated on the red sphere at that location.
# Verify the spheres render the same as they appear in the picture at that location.
# Continue testing at the 5 stations to the South.
# Repeat test with 'Advanced Lighting Model' from graphics preferences both enabled and disabled (where allowed)
#* It is expected that 'Advanced Lighting Model' can only be enabled if both 'Basic Shaders' and 'Atmospheric Shaders' settings are enabled

==100% Transparent + Glow==
# Go to http://maps.secondlife.com/secondlife/Bug%20Island%202/240/174/23
# Set your shaders as indicated by the red sphere at that location.
# Verify that the sphere glows with ALM enabled.
# Verify that the sphere does not become opaque and black:
#* Under the Advanced->Rendering Types menu uncheck 'Water'
#* In Me->Preferences->Graphics uncheck and then recheck 'Advanced Lighting Model'
#* The sphere should continue to glow bright white.

''Note: When finished be sure to turn the water rendering back on in the Rendering Types menu''

==Consistent Lighting vs Solid and Alpha Surfaces==
# Go to http://maps.secondlife.com/secondlife/Bug%20Island%202/239/170/23
# The white plane is actually made up of two planes linked together.
# The plane on the left is solid, and the plane on the right has some Transparency %.
# With Local Lights on Verify under the following conditions that the two planes appear to be one plane:
#* With Basic Shaders enabled.
#* With Atmospheric Shaders enabled.
#* With Advanced Lighting Model enabled under all Sun Settings:
#** Sunrise
#** Midday
#** Sunset
#** Midnight

==Gamma Consistency w/ Full Bright + Alpha==
# Got to http://maps.secondlife.com/secondlife/Bug%20Island%202/241/164/23
# Follow the guidelines stated in the text on the red sphere at that location.
#* The cube with the pink circle should not be bright than the solid pink cube.
#* The cube with the target on it should not darken with ALM enabled.

== Alpha Modes Rendering ==
# Enter the 'Materials rendering test room' at http://maps.secondlife.com/secondlife/Bug%20Island%202/233/251/42
# Click World -> Sun -> Midday to set the viewer lighting
# Enable "Advanced Lighting Model" in your Preferences, under Graphics->Advanced
# Verify that row of 4 boxes on the northern side roughly match the appearance shown on the inworld 'Alpha modes sample' object
#* 'Alpha blended' should have a smooth transparency transition
#* 'Alpha masked' should have an abrupt transparency transition, with each pixel either fully opaque or fully transparent
#* 'Emissive mask' should look bright in the areas which appear more opaque in the 'Alpha blended' box
#* 'No Alpha' should be fully opaque
# Disable "Advanced Lighting Model" in your Preferences, under Graphics->Advanced
# Verify that the 'Emissive masked' box now appears the same as the 'No Alpha' box
# Verify that the other boxes have not changed their basic appearance

== Rendering with Normal Maps ==
# Enter the 'Materials rendering test room' at http://maps.secondlife.com/secondlife/Bug%20Island%202/235/248/46
# Click World -> Sun -> Midday to set the viewer lighting
# Enable "Advanced Lighting Model" in your Preferences, under Graphics->Advanced
# Look at the wall of test objects to the East, and confirm the appearance of each row roughly matches the sample screenshot on the left side. Each Row includes a different alpha type (labelled by floating text)
#* The 1st row, 'no specular', has objects which contain a normal map but have specularity disabled. These objects should have a totally matte appearance.
#* The 2nd row, 'low shiny', has objects which contain a normal map and use the legacy 'Low Shiny' setting. These objects should be slightly shiny, mostly for 'environment' reflections.
#* The 3rd row, 'medium shiny', has objects which contain a normal map and use the legacy 'Medium Shiny' setting. These objects should be slightly shinier than the 'low shiny' row, mostly for 'environment' reflections.
#* The 4th row, 'high shiny', has objects which contain a normal map and use the legacy 'Medium Shiny' setting. These objects should be slightly shinier than the 'medium shiny' row, mostly for 'environment' reflections.
#* The 5th row, '0 gloss, 0 env', has objects which contain a normal map and the '001' specular map, but has both glossiness and environment set to 0. These objects should look identical to the 'no specular' row.
#* The 6th row, '51 gloss, 0 env', has objects which contain a normal map and the '001' specular map, and has both glossiness=51 and environment=0. These objects should by mostly matte, except for shiny '001' sections in the upper-left and lower-right corners.
#* The 7th row, '51 gloss, 0 env, red', has objects which contain a normal map and the '001' specular map, and has both glossiness=51, environment=0, and a red specular color. These objects should appaer similar to those in the '51 gloss, 0 env' row, except that the shiny '001' parts should have a red hue.
#* The 8th row, '51 gloss, 200 env', has objects which contain a normal map and the '001' specular map, and has both glossiness=51 and environment=200. These objects should appaer metallic all over, and have the shiny '001' lettering in the upper-left and lower-right corners.
#* The 9th row, '0 gloss, 200 env', has objects which contain a normal map and the '001' specular map, and has both glossiness=0 and environment=200. These objects should appear metallic all over, but should only have the shiny '001' lettering in the upper-left and lower-right corners when there is a direct reflection from a light source (you have to move your camera around to see it).
# Disable "Advanced Lighting Model" in your Preferences, under Graphics->Advanced
# Look at the wall of test objects to the East, and confirm these changes:
#* All 'emissive mask' objects (far right column) now appear identical to the 'alpha none' objects next to them
#* All normal maps are missing
#* Rows 1, 5, 6, 7, 8, 9 (that is, all except for low/medium/high shiny rows) should all look identical to each other. None of them should appear shiny.
#* For each of rows 2-4 (low/medium/high shiny), the 'opaque', 'alpha none', and 'emissive mask' objects appear identical to each other (and look shiny)
#* For each of rows 2-4 (low/medium/high shiny), the 'alpha blend' and 'alpha mask' objects all appear non-shiny

== Materials Rendering on HUDs ==
Normal and specular maps should not render on objects which are attached as HUDs, due to the lack of lighting sources at the HUD layer (objects tend to render as full bright). However, some of the new alpha modes should effect rendering of HUD objects.
# Take a copy of 'Materials test HUD', which is rezzed at http://maps.secondlife.com/secondlife/Bug%20Island%202/229/253/23 - this object is a linkset of small boxes, with plenty of floating text.
# Enable "Advanced Lighting Model" in your Preferences, under Graphics->Advanced
# Wear the 'Materials test HUD' object from inventory. By default, it should attach to the 'Center' HUD attachment point
# If you have trouble seeing the floating text about each HUD object (the text can be crowded), set 'UI size' to 0.75 under Preferences->Advanced
# Position your camera so that you can see the attachments clearly - I used a blank-textured large prim as background
# Verify that the HUD appears like this screen shot: [[:File:Materials_test_HUD_appearance.png]]
#* Verify that no normal or specular maps appear with the '001' pattern
#** The boxes labelled with 'X gloss, Y env' should be identical to the 'no specular' boxes on the far left column
#** Each of the 'no specular' boxes on the far left column should appear identical to the non-brick 'Water particle 1' objects on the top row
#** In the top row, "No Alpha 'Water Particle 1' with legacy bricks" should look the same as "Emissive Masked 'Water Particle 1' with legacy bricks"
#* Verify that 'Opaque '001' diffuse map with legacy bricks' in the upper-left corner is the only box that has a visible 'bricks' pattern (this is legacy bumpiness)
#* Verify that the other 'with legacy bricks' objects in the top row do *not* have any bumpiness effect, and that the alpha modes render as labelled
#** These objects should have the same appearance as the non-'brick' objects on the right side of the first row
#* Verify that Alpha mode renders correctly
#** Verify that all of the 'opaque' boxes (with the 001 texture) appear fully opaque
#** Verify that all of the 'Alpha blended' objects appear alpha blended (semitransparent, with soft edges)
#** Verify that all of the 'Alpha masked' objects appear alpha masked (semitransparent, with hard edges)
#** Verify that all 'emissive mask' boxes match their corresponding 'alpha none' boxes, since all HUD objects render as fully emissive ('full bright')
#* Verify that legacy shiny objects appear darker than the others
#** Opaque-rendered objects (no alpha, emissive mask, or opaque) set to low/medium/high shiny boxes appear darker than the other boxes
#** The shading should be more severe with increasing shiny level: 'high shiny' objects should be darkest, while 'low shiny' objects should not be so dark
# Disable "Advanced Lighting Model" in your Preferences, under Graphics->Advanced
# Verify that the HUD appears like this screen shot: [[:File:Materials_test_HUD_appearance.png]]
#* Appearance should match what you saw when "Advanced Lighting Model" was enabled

== Materials Rendering on Rigged Meshes ==
TODO

== Rendering of Environment and Exponent Masks ==
TODO

[[Category:QA Portal]]
[[Category:Test Scripts]]

Viewer Materials Smoke Test

2019-07-03T22:33:42Z

Dan Linden: /* No Mask (on a texture with an alpha channel) */

= Overview =
* This test plan covers viewer-side support for the prim materials project, which provides support for normal maps and specular maps applied to object faces
* A high-level specification of this featureset can be found at [[Material_Data]]

= Build Tool Test =

== Required Materials ==
* A region which supports normal and specular maps
** As of [[Release_Notes/Second_Life_Server/13#13.02.08.270166|Second Life Server 13.02.08.270166]], materials support is in the server.
* Three test users
** UserA, who uses a viewer which supports normal and specular maps, and does the building (actually performs operations)
** UserB, who uses a viewer which supports normal and specular maps, and only observes the results of UserA's work
*** The purpose of this user is to verify that build tool edits sent by UserA's viewer produce congruent results
** UserC, who uses an 'old' (no support for normal and specular maps) viewer, and only observes the results of UserA's work
*** The purpose of this user is to verify that edited content looks reasonable on legacy viewers, and sometimes to verify that build tool settings from the new viewer have the same appearance as those set by the legacy viewer.
** UserA and UserB should have "Advanced Lighting Model" enabled under Preferences -> Graphics settings, under "Advanced". This setting is required for the viewer to render normal and specular maps properly.
* Upload the following textures to use in this test:
** [[:File:TestDiffuse001.png]]
** [[:File:TestNormal001.png]]
** [[:File:TestSpecular001.png]]

== Verify Basic Build Tool Layout ==

=== Verify that non-Texture portions of the build tool have not changed ===
# UserA, UserB, and UserC: login
# UserA and UserC: each rez a box
# UserA and UserC: select the box that you rezzed, and select Edit from the context menu
# UserA and UserC: verify that your build tools appear, and that the appearance is identical in the following tabs:
#* General
#* Object
#* Features
#* Content
# UserA and UserC: verify that the build tool UI is the same for each of the build tool modes (top row of buttons)
#* Focus (magnifying glass icon)
#* Move (hand icon)
#* Edit (mouse cursor icon)
#* Create (magic wand icon)
#* Land (bulldozer icon)
# UserA: deselect the box
# UserA, UserB, and UserC: verify that UserA's box still looks like a default box (has not changed appearance)

=== Verify layout and default values of build tool's Texture tab ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool
# UserA: Open the Texture tab of the build tool, and verify that the layout basically matches the image here (minus colorful lines): [[:File:MaterialsBuildUI1.png]]. Verify that the following defaults are set:
#* Verify that "Materials" is the default face edit mode
#* Verify that "Texture (diffuse)" is the default texture edit mode
#* Verify that the Color appears white
#* Verify that Transparency is 0%
#* Verify that Glow is 0.00
#* Verify that 'Full Bright' is disabled
#* Verify that the texture preview shows the default plywood texture
#* Verify that 'Alpha mode' is 'Alpha blending'
#* Verify that 'Mask cutoff' does *not* appear (this option is not applicable in this alpha mode)

=== Verify layout and default values for Mapping option ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool. Open the Texture tab of the build tool.
#* Verify that 'Repeats' is 'per face (default)'
#** Verify that the texture mapping settings match the 'Mapping = default' section in '2b' of this reference image: [[:File:MaterialsBuildUI1.png]].. Verify that the following defaults are set:
#** Verify that 'Horizontal scale' and 'Vertical scale' are both 1.00
#** Verify that 'Repeats per meter' is 2.0 (2.0/meter corresponds to 1.0/face on a 50cm cube face), and can be edited
#** Verify that 'Rotation' is 0.00
#** Verify that 'Horizontal offset' and 'Vertical offset' are both 0.00
#** Verify that 'Align planar faces' is *not* visible
# UserA: Deselect the box
# UserA, UserB, and UserC: verify that the box's appearance has not changed (since no edits have been made)
# UserA: Reselect the box, and 'Edit' it again
# UserA: Under the Texture tab, change the 'Mapping' setting to 'Planar'
#* Verify that the texture mapping settings match the 'Mapping = planar' section in '2b' of this reference image: [[:File:MaterialsBuildUI1.png]].. Verify that the following defaults are set:
#** Verify that 'Number of repeats' is 2.00, and *cannot* be edited (is read-only)
#** Verify that 'Rotation' is 0.00
#** Verify that 'Horizontal offset' and 'Vertical offset' are both 0.00
#** Verify that 'Align planar faces' is visible, unchecked and enabled (*can* be edited)
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that the box's appearance has not changed (since the change to 'planar' mapping by itself has no visible effect on this box)

=== Verify build tool editing of texture settings ===
#* Note: UserA: run the following tests for texture settings., for both planar and default texture mapping modes
#*Note: UserB, and UserC: throughout the test, verify that you see the expected results based on the observer Viewer in use.

====Texture Mapping: Diffuse texture, Default mode====
# UserA: Set the Texture panel's dropdowns to read:
#* Materials
#* Texture (diffuse)
#* Mapping: Default
# UserA: Create a new cube prim for use in this test.
# UserA: Verify that clicking Texture box will open the Pick: Texture floating window, allowing you to select a new texture.
# UserA: Verify that you can drag a texture from your Inventory window to the Texture box.
# UserA: Verify that if the Select Face item is NOT selected, texture changes are applied to all sides at once.
# UserA: Verify that if the Select Face item in the upper pane of the Tools window is selected, you can change one face of the object at a time.
# UserA: Verify that if you drag a texture from your Inventory window directly to the object, you can change one face of the object at a time.
# UserA: Apply the texture, [[:File:TestDiffuse001.png]], to a single face of the prim (while in Select Face mode). This should result in the prim having two textures. The "100" image should appear on only one face.
# UserA: Verify that if an object uses more than one texture, the word Multiple will appear in the Texture image box over one of the texture images.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that the box's appearance has changed to show two textures, one on a single face the other on all other faces
# UserA: Verify that clicking Color box will open the Color Picker floating window.
# UserA: Verify that color tints selected are additive to the color of the base texture.
# UserA: Verify that using Transparency you can choose transparency level of the object.
# UserA: Verify that this setting applies an overall transparency to the texture in addition to any transparency in the alpha channel. The range is 0 to 100 percent. Set to 50%.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that the box's appearance has changed to show a color tint and is semi-transparent.
# UserA: Verify that using Glow item you can create a surface glow on the object, separate from the light emitted with the Features tab. The range is 0 to 1, but any glow above 0.1 tends to wash out the surface texture.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that the box's appearance has changed to add glow.
# UserA: Enable Full Bright.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that the box renders as if fully day-lighted, regardless of the environment day cycle position of the sun.
#* (Use World > Sun > <time of day> to change sun position.)
# UserA: Change Transparency and Glow settings back to 0, and disable Full Bright.
# Rez a 0.5 (default-size) cube and add <test texture> via the texture picker.
# UserA: set Horizontal Scale to 2
# UserA: set horizontal offset to 0.5
# UserA: Verify Repeats per Meter value has automatically changed to 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, side-by-side.
# UserA: set Vertical Scale to 2
# UserA: set Vertical Offset to 0.5
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale plus the Vertical Scale: 4 repeats in a 2x2 grid
# UserA: set Horizontal Scale to 1
# UserA: set Horizontal offset to 0
# UserA: Verify Repeats per Meter value remains at 4.0 (since this value now reflects the maximum density between horizontal and vertical scales)
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, one above the other.
# UserA: Verify that Rotation controls rotation of the texture relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# UserA: Verify that Align Planar Faces is disabled/greyed out when in the Mapping Default mode

====Texture Mapping: Diffuse texture, Planar mode====
# Set the Texture panel's dropdowns to read:
#* Materials
#* Texture (diffuse)
#* '''Mapping: Planar'''
# UserA: Verify that the Repeats/Meter value is disabled/greyed out when in the Mapping Planar mode is active
# Rez a cube and resize it to 1m per side. Reposition the cube so the entire prim can be viewed. Add the texture [[:File:TestDiffuse001.png]] via the texture picker.
# UserA: Set Horizontal Scale to 4
# UserA: Set Vertical Scale to 6
# UserA: Verify that the read-only Repeats Per Meter changed to 3.0 (yes, this is screwy, but it seems to match the release viewer)
# UserA: set horizontal offset to 0.5
# UserA: set Vertical offset to 0.5
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each plane of each prim face matches 4 repeats horizontally, 6 vertically
# UserA: Verify that Rotation controls rotation of the texture relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# '''Align Planar Faces test TBD'''

== Verify functionality of 'Alpha mode' option ==
=== No Mask is forced for textures without an alpha channel ===
# UserA, UserB, and UserC: login
# UserA: Take a snapshot (ctrl+S) and 'Save to inventory'
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: Set the snapshot as the texture on the box
# UserA: Verify that the 'Alpha mode' setting is 'None', and that the UI for changing 'Alpha mode is disabled'
#* Verify that the 'Mask cutoff' setting is hidden
# UserA, UserB, and UserC: Verify that the snapshot appears on the box, and that it is fully opaque
=== Alpha Blending ===
# UserA, UserB, and UserC: login
# UserA: Upload this alpha-mapped image to your inventory: [[:File:Maestro_alpha_gradient.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool. Open the Texture tab of the build tool.
# UserA: Using the texture picker from the build tool, set the image you uploaded on all faces of the box
# UserA, UserB, and UserC: verify that you see a 'smooth' transparency transition in the texture on all faces, with the bottom of the image being opaque and the top being transparent. This is the expected result when the 'Alpha mode' is set to the default 'Alpha blending' setting

=== Alpha Masking ===
# UserA, UserB, and UserC: login
# UserA: Upload this alpha-mapped image to your inventory (if you don't already have it): [[:File:Maestro_alpha_gradient.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool. Open the Texture tab of the build tool, and set the texture to the one you just uploaded.
# UserA: Set the 'Alpha mode' to 'Alpha masking'
#* Verify that the 'Mask cutoff' setting appears, and that the default value for it is 0
# UserA, UserB: verify that the box's texture appears (almost) completely opaque
# UserC: verify that you see no change (since your viewer doesn't support alpha masking)
# UserA: set the 'Mask cutoff' setting to 76
# UserA, UserB: Verify that the top 30% of the texture is now invisible, but the bottom 70% is totally opaque
# UserC: verify that you see no change
# UserA: set the 'Mask cutoff' setting to 178
# UserA, UserB: Verify that the top 70% of the texture is now invisible, but the bottom 30% is totally opaque
# UserC: verify that you see no change
# UserA: set the 'Mask cutoff' setting to 255
# UserA, UserB: Verify that the texture is now almost completely invisible (except perhaps a strip at the bottom)
# UserC: verify that you see no change
# UserA: Try to input 'Mask cutoff' settings < 0, and verify that they get slammed to 0 by the build tool UI
# UserA: Try to input 'Mask cutoff' settings > 255, and verify that they get slammed to 255 by the build tool UI

=== Emissive Mask ===
# UserA, UserB, and UserC: login
# UserA: Upload this alpha-mapped image to your inventory (if you don't already have it): [[:File:Kart_screenshot_with_KART_alpha.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool. Open the Texture tab of the build tool, and set the texture to the one you just uploaded.
# UserA, UserB, and UserC: Verify that the image on the box appears mostly transparent, with "KART" in the middle as an opaque section
# UserA: Set the 'Alpha mode' to 'Emissive mask'
#* Verify that the 'Mask cutoff' setting remains hidden
# UserA and UserB: verify that the box's appearance has changed. The whole texture should be opaque, but there should be a glowing 'KART' in the texture.
# UserC: verify that the box's appearance has not changed (and you just see the image as mostly transparent with the opaque 'KART')

=== No Mask (on a texture with an alpha channel) ===
# UserA, UserB, and UserC: login
# UserA: Upload this alpha-mapped image to your inventory (if you don't already have it): [[:File:Kart_screenshot_with_KART_alpha.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool. Open the Texture tab of the build tool, and set the texture to the one you just uploaded.
# UserA, UserB, and UserC: Verify that the image on the box appears mostly transparent, with the word "KART" in the middle as an opaque section
# UserA: Set the 'Alpha mode' to 'None'
#* Verify that the 'Mask cutoff' setting remains hidden
# UserA and UserB: verify that the box's appearance has changed. The whole texture should be opaque, and no word 'KART' should be visible.
# UserC: verify that the box's appearance has not changed (and you just see the image as mostly transparent with the opaque word 'KART')

== Verify functionality of 'Bumpiness' settings ==
=== Layout of Bumpiness settings ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Bumpiness (normal)"
# UserA: Verify that the build tool layout looks like the 'Materials > Normal' section from this mockup [[:File:BuildTool_Bumpiness_Shininess.png]]
# UserA: Verify the following default settings:
#* Verify that the Texture preview is empty, with a black-on-grey "X" (indicating that no normal map is set)
#* Verify that the 'Bumpiness' setting is currently 'None'
#* Verify that the 'Mapping' setting is 'Default'
#* Verify that 'Horizontal scale' is 1.0
#* Verify that 'Vertical scale' is 1.0
#* Verify that 'Repeats per meter' is enabled, and is 2.0 (this corresponds to a horizontal scale of 1.0 for a 50cm object)
#* Verify that 'Rotation' is 0.0
#* Verify that 'Horizontal offset' is 0.0
#* Verify that 'Vertical offset' is 0.0
#* Verify that 'Align planar faces' is disabled and cannot be edited
# UserA: Deselect the object
# UserA, UserB, UserC: verify that the box's appearance is unchanged (was not accidentally edited)

=== Legacy Bumpiness ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Bumpiness (normal)"
# UserA: Verify that you see the following options under the Bumpiness menu:
#* None
#* Brightness
#* Darkness
#* woodgrain
#* bark
#* bricks
#* checker
#* concrete
#* crustytile
#* cutstone
#* discs
#* gravel
#* petridish
#* siding
#* stonetile
#* stucco
#* suction
#* weave
# UserC: Rez a box and edit it with the build tool
# For each of the bumpiness menu options *except* for 'None', do the following:
#* UserA and UserC: select the same bumpiness menu option for your object's texture
#* UserA, UserB, and UserC: Verify that UserA's box has the same appearance as UserC's box
#* UserA: Verify that all of the texture mapping controls (scale, offset, rotation, align planar faces, etc.) are disabled in the UI (grayed out) when in this mode

=== Normal Map Texture Selection ===
# UserA, UserB, and UserC: login
# UserA: if you don't already have them in your inventory, upload these two textures to SL
#* [[:File:TestDiffuse001.png]]
#* [[:File:TestNormal001.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: Set the uploaded diffuse texture as the diffuse texture on your object
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Bumpiness (normal)"
# UserA: Verify that the Texture preview is empty, with a black-on-grey "X" (indicating that no normal map is set)
# UserA: Click on the texture icon, then choose the uploaded normal map using the texture picker
# UserA: Verify that the Texture preview shows the normal map you selected
# UserA: Verify that 'Bumpiness' is now set to "Use Texture"
# UserA and UserB: Verify that the uploaded textures appear on the box face at full scale, and are aligned. You should see a large '001' in the middle, due to the normal map effect.
# UserC: Verify that you can see the diffuse texture, but no bump map effect
# UserA: From the 'Bumpiness' menu, choose 'None'
# UserA: Verify that the Texture preview is now empty, with a black-on-grey "X" (indicating that no normal map is set)
# UserA, UserB, and UserC: Verify that you can see the diffuse texture, but no bump map effect
# UserA: Drag the uploaded normal map from your inventory onto the Texture preview icon
# UserA: Verify that the Texture preview shows the normal map you selected
# UserA: Verify that 'Bumpiness' becomes set to "Use Texture"
# UserA and UserB: Verify that you see both the normal map and diffuse map applied on the rendered box
# UserC: Verify that you can see the diffuse texture, but no normal map effect

=== Normal Map Texture mapping ===
====Normal texture, Default mapping====
# Set the Texture panel's dropdowns to read:
#* Materials
#* '''Bumpiness (normal)'''
#* '''Mapping: Default'''
# UserA: change the prim's texture to [[:File:TestNormal001.png]]
# UserA: set Horizontal Scale to 2
# UserA: set horizontal offset to 0.5
# UserA: Verify Repeats per Meter value has automatically changed to 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, side-by-side.
# UserA: set Vertical Scale to 2
# UserA: set Vertical Offset to 0.5
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale plus the Vertical Scale: 4 repeats in a 2x2 grid
# UserA: set Horizontal Scale to 1
# UserA: set Horizontal offset to 0
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, one above the other.
# UserA: Verify that Rotation controls rotation of the texture relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# UserA: Verify that Align Planar Faces is disabled/greyed out when in the Mapping Default mode

====Normal texture, Planar mapping====
# UserA, UserB, UserC: Login
# UserA: Rez a cube and resize it to 1m per side. Reposition the cube so the entire prim can be viewed. Set [[:File:TestDiffuse001.png]] as the diffuse map, via the texture picker.
# UserA: Set the Texture panel's dropdowns to read:
#* Materials
#* Bumpiness (normal)
#* '''Mapping: Planar'''
# USerA: Set [[:File:TestNormal001.png]] as the normal map, via the texture picker.
# UserA: Verify that the Repeats/Meter value is disabled/greyed out when in the Mapping Planar mode is active
# UserA: Set Horizontal Scale to 4
# UserA: Set Vertical Scale to 6
# UserA: Verify that the read-only Repeats Per Meter changed to 3.0 (yes, this is screwy, but it seems to match the release viewer)
# UserA: set horizontal offset to 0.5
# UserA: set Vertical offset to 0.5
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify that the diffuse texture appearance remains unchanged
#* UserA, UserB, and UserC: Verify the number of normal map repeats visible on each plane of each prim face matches 4 repeats horizontally, 6 vertically
# UserA: Verify that Rotation controls rotation of the normal map relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# '''Align Planar Faces test TBD'''

== Verify functionality of 'Shininess' settings ==

=== Layout of Shininess settings ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Shininess (specular)"
# UserA: Verify that the build tool layout looks like this mockup: [[:File:BuildtoolSpecular-NoTexture.png]]
# UserA: Verify the following default settings:
#* Verify that the Texture preview is empty, with a black-on-grey "X" (indicating that no specular map is set)
#* Verify that the 'Shininess' setting is currently 'None'
#* Verify that 'Glossiness' is hidden in this mode
#* Verify that 'Environment' is hidden in this mode
#* Verify that the 'Color' is hidden in this mode
#* Verify that the 'Mapping' setting is 'Default', and cannot be edited
#* Verify that 'Horizontal scale' is 1.0, and cannot be edited
#* Verify that 'Vertical scale' is 1.0, and cannot be edited
#* Verify that 'Repeats per meter' is 2.0 (this corresponds to a horizontal scale of 1.0 for a 50cm object), and cannot be edited
#* Verify that 'Rotation' is 0.0, and cannot be edited
#* Verify that 'Horizontal offset' is 0.0, and cannot be edited
#* Verify that 'Vertical offset' is 0.0, and cannot be edited
#* Verify that 'Align planar faces' is disabled, and cannot be edited
# UserA: Deselect the object
# UserA, UserB, UserC: verify that the box's appearance is unchanged (was not accidentally edited)

=== Legacy Shiny ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Shininess (specular)"
# UserA: Verify that you see the following options under the Shininess menu:
#* None
#* Low
#* Medium
#* High
# UserC: Rez a box and edit it with the build tool
# Do the following for Shininess settings 'Low', 'Medium', and 'High':
#* UserA and UserC: select the same Shininess menu option for your object's texture
#* UserA, UserB, and UserC: Verify that UserA's box has the same appearance as UserC's box
#* UserA: Verify that all of the texture mapping controls (scale, offset, rotation, align planar faces, etc.) are disabled in the UI (grayed out) when in this mode
#* UserA: Verify that Glossiness, Environment, and Color settings are not visible when in this mode.
#* UserA: Verify that Mapping drop down may be switched from Default to Planar and back
#* UserA: Verify that any prior changes made to; scale, repeats, rotation and offset are preserved when switching between Default and Planar

=== Specular Map Texture Selection ===
# UserA, UserB, and UserC: login
# UserA: if you don't already have them in your inventory, upload these two textures to SL
#* [[:File:TestDiffuse001.png]]
#* [[:File:TestSpecular001.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: Set the uploaded diffuse texture as the diffuse texture on your object
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Shininess (specular)"
# UserA: Verify that the Texture preview is empty, with a black-on-grey "X" (indicating that no specular map is set)
# UserA: Click on the texture icon, then choose the uploaded specular map using the texture picker
# UserA: Verify that the Texture preview shows the specular map you selected
# UserA: Verify that 'Shininess' is now set to "Use texture"
#* Verify that the floater has new elements, and now looks like [[:File:BuildtoolSpecular-UseTexture.png]]
#** Verify that Glossiness has a default value of 51
#** Verify that Environment has a default value of 0
#** Verify that Color defaults to white
# UserA and UserB: Verify that the uploaded textures appear on the box face at full scale, and are aligned.
#* The stained parts and the scratches should be less shiny than other parts of the texture
# UserC: Verify that you can see the diffuse texture, but no shiny effect
# UserA: From the 'Shininess' menu, choose 'None'
# UserA: Verify that the Texture preview is now empty, with a black-on-grey "X" (indicating that no normal map is set)
# UserA: Verify that the build tool layout has reverted to the style shown here: [[:File:BuildtoolSpecular-NoTexture.png]]
# UserA, UserB, and UserC: Verify that you can see the diffuse texture, but no specular map effect
# UserA: Drag the uploaded specular map from your inventory onto the Texture preview icon
# UserA: Verify that the Texture preview shows the specular map you selected
# UserA: Verify that 'Shininess' becomes set to "Use Texture"
# UserA and UserB: Verify that the uploaded textures appear on the box face at full scale, and are aligned
# UserC: Verify that you can see the diffuse texture, but no specular map effect

=== Specular Map Glossiness and Environment ===
# UserA, UserB, and UserC: login
# UserA: if you don't already have them in your inventory, upload these two textures to SL
#* [[:File:TestDiffuse001.png]]
#* [[:File:TestSpecular001.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: Set the uploaded diffuse texture as the diffuse texture on your object
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Shininess (specular)"
# UserA: Click on the texture icon, then choose the uploaded specular map using the texture picker
# UserA and UserB: verify that you see the object with the specular map applied
# UserC: Verify that you can see the diffuse texture, but no specular map effect
# UserA: Verify these default settings:
#* Glossiness should be 51
#* Environment should be 0
# UserA: Increase the Environment setting to 204
# UserA and UserB: Verify that the reflected color of the object now includes more of the environment (blue highlights from the sky color)
# UserC: verify that you see no change
# UserA: Try to enter an Environment setting > 255, and verify that the UI slams it to 255
# UserA: Try to enter an Environment setting < 0, and verify that the UI slams it to 0
# UserA: Increase the Glossiness setting to 204
# UserA and UserB: Verify that the specular highlights are now more 'blurred'
# UserC: verify that you see no change
# UserA: Try to enter a Glossiness setting > 255, and verify that the UI slams it to 255
# UserA: Try to enter a Glossiness setting < 0, and verify that the UI slams it to 0

=== Specular Map Texture mapping ===
====Specular texture, Default mapping====
# Set the Texture panel's dropdowns to read:
#* Materials
#* '''Shininess (specular)'''
#* '''Mapping: Default'''
# UserA: change the prim's texture to [[:File:TestSpecular001.png]]
# UserA: set Horizontal Scale to 2
# UserA: set horizontal offset to 0.5
# UserA: Verify Repeats per Meter value has automatically changed to 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, side-by-side.
# UserA: set Vertical Scale to 2
# UserA: set Vertical Offset to 0.5
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale plus the Vertical Scale: 4 repeats in a 2x2 grid
# UserA: set Horizontal Scale to 1
# UserA: set Horizontal offset to 0
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, one above the other.
# UserA: Verify that Rotation controls rotation of the texture relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# UserA: Verify that Align Planar Faces is disabled/greyed out when in the Mapping Default mode

====Normal texture, Planar mapping====
# UserA, UserB, UserC: Login
# UserA: Rez a cube and resize it to 1m per side. Reposition the cube so the entire prim can be viewed. Set [[:File:TestDiffuse001.png]] as the diffuse map, via the texture picker.
# UserA: Set the Texture panel's dropdowns to read:
#* Materials
#* Shiniiness (specular)
#* '''Mapping: Planar'''
# USerA: Set [[:File:TestSpecular001.png]] as the specular map, via the texture picker.
# UserA: Verify that the Repeats/Meter value is disabled/greyed out when in the Mapping Planar mode is active
# UserA: Set Horizontal Scale to 4
# UserA: Set Vertical Scale to 6
# UserA: Verify that the read-only Repeats Per Meter changed to 3.0 (yes, this is screwy, but it seems to match the release viewer)
# UserA: set horizontal offset to 0.5
# UserA: set Vertical offset to 0.5
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify that the diffuse texture appearance remains unchanged
#* UserA, UserB, and UserC: Verify the number of specular map repeats visible on each plane of each prim face matches 4 repeats horizontally, 6 vertically
# UserA: Verify that Rotation controls rotation of the specular map relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# '''Align Planar Faces test TBD'''

== Verify functionality of 'Media' settings ==
=== Layout and Default Values of Media Settings ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool
# UserA: In the Texture tab, change the edit mode from "Materials" to "Media".
# UserA: Verify that the build tool layout looks like this mockup: File:BuildToolMediaMode.png
# UserA: Verify that the following defaults are set:
#* Verify that the Color appears white
#* Verify that Transparency is 0%
#* Verify that Glow is 0.00
#* Verify that 'Full Bright' is disabled
#* Verify that 'Mapping' is 'Default
#** Verify that 'Horizontal scale' and 'Vertical scale' are both 1.00
#** Verify that 'Repeats per meter' is 2.0 (2.0/meter corresponds to 1.0/face on a 50cm cube face), and can be edited
#** Verify that 'Rotation' is 0.00
#** Verify that 'Horizontal offset' and 'Vertical offset' are both 0.00
#* Verify that 'Align planar faces' is unchecked and cannot be edited (is 'greyed out')'
# UserA, UserB, UserC: verify that the box's appearance is unchanged (was not accidentally edited)
=== Adding, and removing, and aligning media ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool
# UserA: Change your selection mode to "Select Face" and select only the top face
# UserA: In the Texture tab, change the edit mode from "Materials" to "Media".
# UserA: Click on the "Choose.." button, and verify that the "MEDIA SETTINGS" floater appears, and looks like this: [[:File:BuildToolMediaSettings.png]]
# UserA: Type "http://secondlife.com" into the Home Page text field in "MEDIA SETTINGS", and hit "Apply"
# UserA, UserB, and UserC: Verify that you see the SL website appear on the box's top face
# UserA: Change the 'Horizontal offset' value to 0.2
# UserA, UserB, and UserC: Verify that the SL website on the box is now slightly offset
# UserA: Click on the 'Align' button to align the website with the box's edges
# UserA, UserB, and UserC: Verify that the SL website on the box is now aligned with the box edges
# UserA: Click on the 'Remove' button to remove the prim media
# UserA: Verify that you see a modal dialog, asking to confirm media removal. Click "No"
# UserA, UserB, and UserC: Verify that the SL website on the box is unchanged
# UserA: Click on the 'Remove' button to remove the prim media
# UserA: Verify that you see a modal dialog, asking to confirm media removal. Click "Yes"
# UserA, UserB, and UserC: Verify that the SL website has disappeared from the box, and that the changed face is back to the default plywood texture

===Media Texture Mapping ===
====Media, Default mapping====
# UserA, UserB, UserC: login
# UserA: Rez a box, and edit one of its faces with the Build Tool
# UserA: Set the Texture panel's dropdowns to read:
#* Media
#* '''Mapping: Default'''
# UserA: Add media to a face on the box, using "http://secondlife.com", as in [[#Layout_and_Default_Values_of_Media_Settings]]
# UserA: set Horizontal Scale to 2
# UserA: set horizontal offset to 0.5
# UserA: Verify Repeats per Meter value has automatically changed to 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, side-by-side.
# UserA: set Vertical Scale to 2
# UserA: set Vertical Offset to 0.5
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale plus the Vertical Scale: 4 repeats in a 2x2 grid
# UserA: set Horizontal Scale to 1
# UserA: set Horizontal offset to 0
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, one above the other.
# UserA: Verify that Rotation controls rotation of the texture relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# UserA: Verify that Align Planar Faces is disabled/greyed out when in the Mapping Default mode

==== Media, Planar mapping====
# UserA, UserB, UserC: Login
# UserA: Rez a cube and resize it to 1m per side. Reposition the cube so the entire prim can be viewed. Add <test texture> via the texture picker.
# UserA: Set the Texture panel's dropdowns to read:
#* Media
#** '''Mapping: Planar'''
# UserA: Verify that the Repeats/Meter value is disabled/greyed out when in the Mapping Planar mode is active
# Rez a cube and resize it to 1m per side. Reposition the cube so the entire prim can be viewed. Add the texture [[:File:TestDiffuse001.png]] via the texture picker.
# UserA: Set Horizontal Scale to 4
# UserA: Set Vertical Scale to 6
# UserA: Verify that the read-only Repeats Per Meter changed to 3.0 (yes, this is screwy, but it seems to match the release viewer)
# UserA: set horizontal offset to 0.5
# UserA: set Vertical offset to 0.5
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each plane of each prim face matches 4 repeats horizontally, 6 vertically
# UserA: Verify that Rotation controls rotation of the texture relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# '''Align Planar Faces test TBD'''

= Materials Loading Test =
This test verifies that the viewer can fetch materials data and render it properly.

== Obtaining Test Objects ==
This test requires using 2 test objects which each contain many materials.

Some prepared test objects can be found at [http://maps.secondlife.com/secondlife/Bug%20Island/148/18/27 Bug Island]. There are 2 test linksets, each containing 50 unique materials:
* MaterialsObject01-50 contains 50 boxes, numbered by 01-50 with matching diffuse, normal, and specular maps.
* MaterialsObject51-100 contains 50 boxes, numbered by 51-100 with matching diffuse, normal, and specular maps.

Both link sets have prims that spin with llTargetOmega(), in order to make the specular maps more visible. You can modify the script in the root prim to remove this effect.

== Materials load when rezzed ==
# Log in
# Find a pair of neighboring regions which both allow you to rez objects, and move near the sim border
# Rez 'MaterialsObject01-50' in the region your avatar is in
# Without much delay, rez 'MaterialsObject51-100' in the neighboring region
# Verify that all diffuse/normal/specular maps for both linksets load in a timely manner
#* This may take a short while, since the viewer needs to download 300 separate textures for these objects

== Materials load upon login ==
# Complete the [[#Materials_load_when_rezzed]] test first
# Log out
# Login to the location where the objects were rezzed
# Verify that all diffuse/normal/specular maps for both linksets load in a timely manner
#* This should be relatively fast, since the viewer should have these textures in its cache

= Materials Rendering Test =
''Note: The following sections should be completed both above and below water. There is a trench directly to the west that replicates all test cases under water''

== Rendering of Legacy Bumpmaps and Shiny ==
''Note: this was lifted from [[Render_Correctness_Test]]''
# Go to http://maps.secondlife.com/secondlife/Bug%20Island%202/243/247/23
# Set your shaders and sun position as indicated on the red sphere at that location.
# Verify the spheres render the same as they appear in the picture at that location.
# Continue testing at the 5 stations to the South.
# Repeat test with 'Advanced Lighting Model' from graphics preferences both enabled and disabled (where allowed)
#* It is expected that 'Advanced Lighting Model' can only be enabled if both 'Basic Shaders' and 'Atmospheric Shaders' settings are enabled

==100% Transparent + Glow==
# Go to http://maps.secondlife.com/secondlife/Bug%20Island%202/240/174/23
# Set your shaders as indicated by the red sphere at that location.
# Verify that the sphere glows with ALM enabled.
# Verify that the sphere does not become opaque and black:
#* Under the Advanced->Rendering Types menu uncheck 'Water'
#* In Me->Preferences->Graphics uncheck and then recheck 'Advanced Lighting Model'
#* The sphere should continue to glow bright white.

''Note: When finished be sure to turn the water rendering back on in the Rendering Types menu''

==Consistent Lighting vs Solid and Alpha Surfaces==
# Go to http://maps.secondlife.com/secondlife/Bug%20Island%202/239/170/23
# The white plane is actually made up of two planes linked together.
# The plane on the left is solid, and the plane on the right has some Transparency %.
# With Local Lights on Verify under the following conditions that the two planes appear to be one plane:
#* With Basic Shaders enabled.
#* With Atmospheric Shaders enabled.
#* With Advanced Lighting Model enabled under all Sun Settings:
#** Sunrise
#** Midday
#** Sunset
#** Midnight

==Gamma Consistency w/ Full Bright + Alpha==
# Got to http://maps.secondlife.com/secondlife/Bug%20Island%202/241/164/23
# Follow the guidelines stated in the text on the red sphere at that location.
#* The cube with the pink circle should not be bright than the solid pink cube.
#* The cube with the target on it should not darken with ALM enabled.

== Alpha Modes Rendering ==
# Enter the 'Materials rendering test room' at http://maps.secondlife.com/secondlife/Bug%20Island%202/233/251/42
# Click World -> Sun -> Midday to set the viewer lighting
# Enable "Advanced Lighting Model" in your Preferences, under Graphics->Advanced
# Verify that row of 4 boxes on the northern side roughly match the appearance shown on the inworld 'Alpha modes sample' object
#* 'Alpha blended' should have a smooth transparency transition
#* 'Alpha masked' should have an abrupt transparency transition, with each pixel either fully opaque or fully transparent
#* 'Emissive mask' should look bright in the areas which appear more opaque in the 'Alpha blended' box
#* 'No Alpha' should be fully opaque
# Disable "Advanced Lighting Model" in your Preferences, under Graphics->Advanced
# Verify that the 'Emissive masked' box now appears the same as the 'No Alpha' box
# Verify that the other boxes have not changed their basic appearance

== Rendering with Normal Maps ==
# Enter the 'Materials rendering test room' at http://maps.secondlife.com/secondlife/Bug%20Island%202/235/248/46
# Click World -> Sun -> Midday to set the viewer lighting
# Enable "Advanced Lighting Model" in your Preferences, under Graphics->Advanced
# Look at the wall of test objects to the East, and confirm the appearance of each row roughly matches the sample screenshot on the left side. Each Row includes a different alpha type (labelled by floating text)
#* The 1st row, 'no specular', has objects which contain a normal map but have specularity disabled. These objects should have a totally matte appearance.
#* The 2nd row, 'low shiny', has objects which contain a normal map and use the legacy 'Low Shiny' setting. These objects should be slightly shiny, mostly for 'environment' reflections.
#* The 3rd row, 'medium shiny', has objects which contain a normal map and use the legacy 'Medium Shiny' setting. These objects should be slightly shinier than the 'low shiny' row, mostly for 'environment' reflections.
#* The 4th row, 'high shiny', has objects which contain a normal map and use the legacy 'Medium Shiny' setting. These objects should be slightly shinier than the 'medium shiny' row, mostly for 'environment' reflections.
#* The 5th row, '0 gloss, 0 env', has objects which contain a normal map and the '001' specular map, but has both glossiness and environment set to 0. These objects should look identical to the 'no specular' row.
#* The 6th row, '51 gloss, 0 env', has objects which contain a normal map and the '001' specular map, and has both glossiness=51 and environment=0. These objects should by mostly matte, except for shiny '001' sections in the upper-left and lower-right corners.
#* The 7th row, '51 gloss, 0 env, red', has objects which contain a normal map and the '001' specular map, and has both glossiness=51, environment=0, and a red specular color. These objects should appaer similar to those in the '51 gloss, 0 env' row, except that the shiny '001' parts should have a red hue.
#* The 8th row, '51 gloss, 200 env', has objects which contain a normal map and the '001' specular map, and has both glossiness=51 and environment=200. These objects should appaer metallic all over, and have the shiny '001' lettering in the upper-left and lower-right corners.
#* The 9th row, '0 gloss, 200 env', has objects which contain a normal map and the '001' specular map, and has both glossiness=0 and environment=200. These objects should appear metallic all over, but should only have the shiny '001' lettering in the upper-left and lower-right corners when there is a direct reflection from a light source (you have to move your camera around to see it).
# Disable "Advanced Lighting Model" in your Preferences, under Graphics->Advanced
# Look at the wall of test objects to the East, and confirm these changes:
#* All 'emissive mask' objects (far right column) now appear identical to the 'alpha none' objects next to them
#* All normal maps are missing
#* Rows 1, 5, 6, 7, 8, 9 (that is, all except for low/medium/high shiny rows) should all look identical to each other. None of them should appear shiny.
#* For each of rows 2-4 (low/medium/high shiny), the 'opaque', 'alpha none', and 'emissive mask' objects appear identical to each other (and look shiny)
#* For each of rows 2-4 (low/medium/high shiny), the 'alpha blend' and 'alpha mask' objects all appear non-shiny

== Materials Rendering on HUDs ==
Normal and specular maps should not render on objects which are attached as HUDs, due to the lack of lighting sources at the HUD layer (objects tend to render as full bright). However, some of the new alpha modes should effect rendering of HUD objects.
# Take a copy of 'Materials test HUD', which is rezzed at http://maps.secondlife.com/secondlife/Bug%20Island%202/229/253/23 - this object is a linkset of small boxes, with plenty of floating text.
# Enable "Advanced Lighting Model" in your Preferences, under Graphics->Advanced
# Wear the 'Materials test HUD' object from inventory. By default, it should attach to the 'Center' HUD attachment point
# If you have trouble seeing the floating text about each HUD object (the text can be crowded), set 'UI size' to 0.75 under Preferences->Advanced
# Position your camera so that you can see the attachments clearly - I used a blank-textured large prim as background
# Verify that the HUD appears like this screen shot: [[:File:Materials_test_HUD_appearance.png]]
#* Verify that no normal or specular maps appear with the '001' pattern
#** The boxes labelled with 'X gloss, Y env' should be identical to the 'no specular' boxes on the far left column
#** Each of the 'no specular' boxes on the far left column should appear identical to the non-brick 'Water particle 1' objects on the top row
#** In the top row, "No Alpha 'Water Particle 1' with legacy bricks" should look the same as "Emissive Masked 'Water Particle 1' with legacy bricks"
#* Verify that 'Opaque '001' diffuse map with legacy bricks' in the upper-left corner is the only box that has a visible 'bricks' pattern (this is legacy bumpiness)
#* Verify that the other 'with legacy bricks' objects in the top row do *not* have any bumpiness effect, and that the alpha modes render as labelled
#** These objects should have the same appearance as the non-'brick' objects on the right side of the first row
#* Verify that Alpha mode renders correctly
#** Verify that all of the 'opaque' boxes (with the 001 texture) appear fully opaque
#** Verify that all of the 'Alpha blended' objects appear alpha blended (semitransparent, with soft edges)
#** Verify that all of the 'Alpha masked' objects appear alpha masked (semitransparent, with hard edges)
#** Verify that all 'emissive mask' boxes match their corresponding 'alpha none' boxes, since all HUD objects render as fully emissive ('full bright')
#* Verify that legacy shiny objects appear darker than the others
#** Opaque-rendered objects (no alpha, emissive mask, or opaque) set to low/medium/high shiny boxes appear darker than the other boxes
#** The shading should be more severe with increasing shiny level: 'high shiny' objects should be darkest, while 'low shiny' objects should not be so dark
# Disable "Advanced Lighting Model" in your Preferences, under Graphics->Advanced
# Verify that the HUD appears like this screen shot: [[:File:Materials_test_HUD_appearance.png]]
#* Appearance should match what you saw when "Advanced Lighting Model" was enabled

== Materials Rendering on Rigged Meshes ==
TODO

== Rendering of Environment and Exponent Masks ==
TODO

[[Category:QA Portal]]
[[Category:Test Scripts]]

Viewer Materials Smoke Test

2019-07-03T22:31:56Z

Dan Linden: /* Emissive Mask */

= Overview =
* This test plan covers viewer-side support for the prim materials project, which provides support for normal maps and specular maps applied to object faces
* A high-level specification of this featureset can be found at [[Material_Data]]

= Build Tool Test =

== Required Materials ==
* A region which supports normal and specular maps
** As of [[Release_Notes/Second_Life_Server/13#13.02.08.270166|Second Life Server 13.02.08.270166]], materials support is in the server.
* Three test users
** UserA, who uses a viewer which supports normal and specular maps, and does the building (actually performs operations)
** UserB, who uses a viewer which supports normal and specular maps, and only observes the results of UserA's work
*** The purpose of this user is to verify that build tool edits sent by UserA's viewer produce congruent results
** UserC, who uses an 'old' (no support for normal and specular maps) viewer, and only observes the results of UserA's work
*** The purpose of this user is to verify that edited content looks reasonable on legacy viewers, and sometimes to verify that build tool settings from the new viewer have the same appearance as those set by the legacy viewer.
** UserA and UserB should have "Advanced Lighting Model" enabled under Preferences -> Graphics settings, under "Advanced". This setting is required for the viewer to render normal and specular maps properly.
* Upload the following textures to use in this test:
** [[:File:TestDiffuse001.png]]
** [[:File:TestNormal001.png]]
** [[:File:TestSpecular001.png]]

== Verify Basic Build Tool Layout ==

=== Verify that non-Texture portions of the build tool have not changed ===
# UserA, UserB, and UserC: login
# UserA and UserC: each rez a box
# UserA and UserC: select the box that you rezzed, and select Edit from the context menu
# UserA and UserC: verify that your build tools appear, and that the appearance is identical in the following tabs:
#* General
#* Object
#* Features
#* Content
# UserA and UserC: verify that the build tool UI is the same for each of the build tool modes (top row of buttons)
#* Focus (magnifying glass icon)
#* Move (hand icon)
#* Edit (mouse cursor icon)
#* Create (magic wand icon)
#* Land (bulldozer icon)
# UserA: deselect the box
# UserA, UserB, and UserC: verify that UserA's box still looks like a default box (has not changed appearance)

=== Verify layout and default values of build tool's Texture tab ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool
# UserA: Open the Texture tab of the build tool, and verify that the layout basically matches the image here (minus colorful lines): [[:File:MaterialsBuildUI1.png]]. Verify that the following defaults are set:
#* Verify that "Materials" is the default face edit mode
#* Verify that "Texture (diffuse)" is the default texture edit mode
#* Verify that the Color appears white
#* Verify that Transparency is 0%
#* Verify that Glow is 0.00
#* Verify that 'Full Bright' is disabled
#* Verify that the texture preview shows the default plywood texture
#* Verify that 'Alpha mode' is 'Alpha blending'
#* Verify that 'Mask cutoff' does *not* appear (this option is not applicable in this alpha mode)

=== Verify layout and default values for Mapping option ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool. Open the Texture tab of the build tool.
#* Verify that 'Repeats' is 'per face (default)'
#** Verify that the texture mapping settings match the 'Mapping = default' section in '2b' of this reference image: [[:File:MaterialsBuildUI1.png]].. Verify that the following defaults are set:
#** Verify that 'Horizontal scale' and 'Vertical scale' are both 1.00
#** Verify that 'Repeats per meter' is 2.0 (2.0/meter corresponds to 1.0/face on a 50cm cube face), and can be edited
#** Verify that 'Rotation' is 0.00
#** Verify that 'Horizontal offset' and 'Vertical offset' are both 0.00
#** Verify that 'Align planar faces' is *not* visible
# UserA: Deselect the box
# UserA, UserB, and UserC: verify that the box's appearance has not changed (since no edits have been made)
# UserA: Reselect the box, and 'Edit' it again
# UserA: Under the Texture tab, change the 'Mapping' setting to 'Planar'
#* Verify that the texture mapping settings match the 'Mapping = planar' section in '2b' of this reference image: [[:File:MaterialsBuildUI1.png]].. Verify that the following defaults are set:
#** Verify that 'Number of repeats' is 2.00, and *cannot* be edited (is read-only)
#** Verify that 'Rotation' is 0.00
#** Verify that 'Horizontal offset' and 'Vertical offset' are both 0.00
#** Verify that 'Align planar faces' is visible, unchecked and enabled (*can* be edited)
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that the box's appearance has not changed (since the change to 'planar' mapping by itself has no visible effect on this box)

=== Verify build tool editing of texture settings ===
#* Note: UserA: run the following tests for texture settings., for both planar and default texture mapping modes
#*Note: UserB, and UserC: throughout the test, verify that you see the expected results based on the observer Viewer in use.

====Texture Mapping: Diffuse texture, Default mode====
# UserA: Set the Texture panel's dropdowns to read:
#* Materials
#* Texture (diffuse)
#* Mapping: Default
# UserA: Create a new cube prim for use in this test.
# UserA: Verify that clicking Texture box will open the Pick: Texture floating window, allowing you to select a new texture.
# UserA: Verify that you can drag a texture from your Inventory window to the Texture box.
# UserA: Verify that if the Select Face item is NOT selected, texture changes are applied to all sides at once.
# UserA: Verify that if the Select Face item in the upper pane of the Tools window is selected, you can change one face of the object at a time.
# UserA: Verify that if you drag a texture from your Inventory window directly to the object, you can change one face of the object at a time.
# UserA: Apply the texture, [[:File:TestDiffuse001.png]], to a single face of the prim (while in Select Face mode). This should result in the prim having two textures. The "100" image should appear on only one face.
# UserA: Verify that if an object uses more than one texture, the word Multiple will appear in the Texture image box over one of the texture images.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that the box's appearance has changed to show two textures, one on a single face the other on all other faces
# UserA: Verify that clicking Color box will open the Color Picker floating window.
# UserA: Verify that color tints selected are additive to the color of the base texture.
# UserA: Verify that using Transparency you can choose transparency level of the object.
# UserA: Verify that this setting applies an overall transparency to the texture in addition to any transparency in the alpha channel. The range is 0 to 100 percent. Set to 50%.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that the box's appearance has changed to show a color tint and is semi-transparent.
# UserA: Verify that using Glow item you can create a surface glow on the object, separate from the light emitted with the Features tab. The range is 0 to 1, but any glow above 0.1 tends to wash out the surface texture.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that the box's appearance has changed to add glow.
# UserA: Enable Full Bright.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that the box renders as if fully day-lighted, regardless of the environment day cycle position of the sun.
#* (Use World > Sun > <time of day> to change sun position.)
# UserA: Change Transparency and Glow settings back to 0, and disable Full Bright.
# Rez a 0.5 (default-size) cube and add <test texture> via the texture picker.
# UserA: set Horizontal Scale to 2
# UserA: set horizontal offset to 0.5
# UserA: Verify Repeats per Meter value has automatically changed to 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, side-by-side.
# UserA: set Vertical Scale to 2
# UserA: set Vertical Offset to 0.5
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale plus the Vertical Scale: 4 repeats in a 2x2 grid
# UserA: set Horizontal Scale to 1
# UserA: set Horizontal offset to 0
# UserA: Verify Repeats per Meter value remains at 4.0 (since this value now reflects the maximum density between horizontal and vertical scales)
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, one above the other.
# UserA: Verify that Rotation controls rotation of the texture relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# UserA: Verify that Align Planar Faces is disabled/greyed out when in the Mapping Default mode

====Texture Mapping: Diffuse texture, Planar mode====
# Set the Texture panel's dropdowns to read:
#* Materials
#* Texture (diffuse)
#* '''Mapping: Planar'''
# UserA: Verify that the Repeats/Meter value is disabled/greyed out when in the Mapping Planar mode is active
# Rez a cube and resize it to 1m per side. Reposition the cube so the entire prim can be viewed. Add the texture [[:File:TestDiffuse001.png]] via the texture picker.
# UserA: Set Horizontal Scale to 4
# UserA: Set Vertical Scale to 6
# UserA: Verify that the read-only Repeats Per Meter changed to 3.0 (yes, this is screwy, but it seems to match the release viewer)
# UserA: set horizontal offset to 0.5
# UserA: set Vertical offset to 0.5
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each plane of each prim face matches 4 repeats horizontally, 6 vertically
# UserA: Verify that Rotation controls rotation of the texture relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# '''Align Planar Faces test TBD'''

== Verify functionality of 'Alpha mode' option ==
=== No Mask is forced for textures without an alpha channel ===
# UserA, UserB, and UserC: login
# UserA: Take a snapshot (ctrl+S) and 'Save to inventory'
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: Set the snapshot as the texture on the box
# UserA: Verify that the 'Alpha mode' setting is 'None', and that the UI for changing 'Alpha mode is disabled'
#* Verify that the 'Mask cutoff' setting is hidden
# UserA, UserB, and UserC: Verify that the snapshot appears on the box, and that it is fully opaque
=== Alpha Blending ===
# UserA, UserB, and UserC: login
# UserA: Upload this alpha-mapped image to your inventory: [[:File:Maestro_alpha_gradient.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool. Open the Texture tab of the build tool.
# UserA: Using the texture picker from the build tool, set the image you uploaded on all faces of the box
# UserA, UserB, and UserC: verify that you see a 'smooth' transparency transition in the texture on all faces, with the bottom of the image being opaque and the top being transparent. This is the expected result when the 'Alpha mode' is set to the default 'Alpha blending' setting

=== Alpha Masking ===
# UserA, UserB, and UserC: login
# UserA: Upload this alpha-mapped image to your inventory (if you don't already have it): [[:File:Maestro_alpha_gradient.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool. Open the Texture tab of the build tool, and set the texture to the one you just uploaded.
# UserA: Set the 'Alpha mode' to 'Alpha masking'
#* Verify that the 'Mask cutoff' setting appears, and that the default value for it is 0
# UserA, UserB: verify that the box's texture appears (almost) completely opaque
# UserC: verify that you see no change (since your viewer doesn't support alpha masking)
# UserA: set the 'Mask cutoff' setting to 76
# UserA, UserB: Verify that the top 30% of the texture is now invisible, but the bottom 70% is totally opaque
# UserC: verify that you see no change
# UserA: set the 'Mask cutoff' setting to 178
# UserA, UserB: Verify that the top 70% of the texture is now invisible, but the bottom 30% is totally opaque
# UserC: verify that you see no change
# UserA: set the 'Mask cutoff' setting to 255
# UserA, UserB: Verify that the texture is now almost completely invisible (except perhaps a strip at the bottom)
# UserC: verify that you see no change
# UserA: Try to input 'Mask cutoff' settings < 0, and verify that they get slammed to 0 by the build tool UI
# UserA: Try to input 'Mask cutoff' settings > 255, and verify that they get slammed to 255 by the build tool UI

=== Emissive Mask ===
# UserA, UserB, and UserC: login
# UserA: Upload this alpha-mapped image to your inventory (if you don't already have it): [[:File:Kart_screenshot_with_KART_alpha.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool. Open the Texture tab of the build tool, and set the texture to the one you just uploaded.
# UserA, UserB, and UserC: Verify that the image on the box appears mostly transparent, with "KART" in the middle as an opaque section
# UserA: Set the 'Alpha mode' to 'Emissive mask'
#* Verify that the 'Mask cutoff' setting remains hidden
# UserA and UserB: verify that the box's appearance has changed. The whole texture should be opaque, but there should be a glowing 'KART' in the texture.
# UserC: verify that the box's appearance has not changed (and you just see the image as mostly transparent with the opaque 'KART')

=== No Mask (on a texture with an alpha channel) ===
# UserA, UserB, and UserC: login
# UserA: Upload this alpha-mapped image to your inventory (if you don't already have it): [[:File:Kart_screenshot_with_G_alpha.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool. Open the Texture tab of the build tool, and set the texture to the one you just uploaded.
# UserA, UserB, and UserC: Verify that the image on the box appears mostly transparent, with a "G" in the middle as an opaque section
# UserA: Set the 'Alpha mode' to 'None'
#* Verify that the 'Mask cutoff' setting remains hidden
# UserA and UserB: verify that the box's appearance has changed. The whole texture should be opaque, and no 'G' should be visible.
# UserC: verify that the box's appearance has not changed (and you just see the image as mostly transparent with the opaque 'G')

== Verify functionality of 'Bumpiness' settings ==
=== Layout of Bumpiness settings ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Bumpiness (normal)"
# UserA: Verify that the build tool layout looks like the 'Materials > Normal' section from this mockup [[:File:BuildTool_Bumpiness_Shininess.png]]
# UserA: Verify the following default settings:
#* Verify that the Texture preview is empty, with a black-on-grey "X" (indicating that no normal map is set)
#* Verify that the 'Bumpiness' setting is currently 'None'
#* Verify that the 'Mapping' setting is 'Default'
#* Verify that 'Horizontal scale' is 1.0
#* Verify that 'Vertical scale' is 1.0
#* Verify that 'Repeats per meter' is enabled, and is 2.0 (this corresponds to a horizontal scale of 1.0 for a 50cm object)
#* Verify that 'Rotation' is 0.0
#* Verify that 'Horizontal offset' is 0.0
#* Verify that 'Vertical offset' is 0.0
#* Verify that 'Align planar faces' is disabled and cannot be edited
# UserA: Deselect the object
# UserA, UserB, UserC: verify that the box's appearance is unchanged (was not accidentally edited)

=== Legacy Bumpiness ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Bumpiness (normal)"
# UserA: Verify that you see the following options under the Bumpiness menu:
#* None
#* Brightness
#* Darkness
#* woodgrain
#* bark
#* bricks
#* checker
#* concrete
#* crustytile
#* cutstone
#* discs
#* gravel
#* petridish
#* siding
#* stonetile
#* stucco
#* suction
#* weave
# UserC: Rez a box and edit it with the build tool
# For each of the bumpiness menu options *except* for 'None', do the following:
#* UserA and UserC: select the same bumpiness menu option for your object's texture
#* UserA, UserB, and UserC: Verify that UserA's box has the same appearance as UserC's box
#* UserA: Verify that all of the texture mapping controls (scale, offset, rotation, align planar faces, etc.) are disabled in the UI (grayed out) when in this mode

=== Normal Map Texture Selection ===
# UserA, UserB, and UserC: login
# UserA: if you don't already have them in your inventory, upload these two textures to SL
#* [[:File:TestDiffuse001.png]]
#* [[:File:TestNormal001.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: Set the uploaded diffuse texture as the diffuse texture on your object
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Bumpiness (normal)"
# UserA: Verify that the Texture preview is empty, with a black-on-grey "X" (indicating that no normal map is set)
# UserA: Click on the texture icon, then choose the uploaded normal map using the texture picker
# UserA: Verify that the Texture preview shows the normal map you selected
# UserA: Verify that 'Bumpiness' is now set to "Use Texture"
# UserA and UserB: Verify that the uploaded textures appear on the box face at full scale, and are aligned. You should see a large '001' in the middle, due to the normal map effect.
# UserC: Verify that you can see the diffuse texture, but no bump map effect
# UserA: From the 'Bumpiness' menu, choose 'None'
# UserA: Verify that the Texture preview is now empty, with a black-on-grey "X" (indicating that no normal map is set)
# UserA, UserB, and UserC: Verify that you can see the diffuse texture, but no bump map effect
# UserA: Drag the uploaded normal map from your inventory onto the Texture preview icon
# UserA: Verify that the Texture preview shows the normal map you selected
# UserA: Verify that 'Bumpiness' becomes set to "Use Texture"
# UserA and UserB: Verify that you see both the normal map and diffuse map applied on the rendered box
# UserC: Verify that you can see the diffuse texture, but no normal map effect

=== Normal Map Texture mapping ===
====Normal texture, Default mapping====
# Set the Texture panel's dropdowns to read:
#* Materials
#* '''Bumpiness (normal)'''
#* '''Mapping: Default'''
# UserA: change the prim's texture to [[:File:TestNormal001.png]]
# UserA: set Horizontal Scale to 2
# UserA: set horizontal offset to 0.5
# UserA: Verify Repeats per Meter value has automatically changed to 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, side-by-side.
# UserA: set Vertical Scale to 2
# UserA: set Vertical Offset to 0.5
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale plus the Vertical Scale: 4 repeats in a 2x2 grid
# UserA: set Horizontal Scale to 1
# UserA: set Horizontal offset to 0
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, one above the other.
# UserA: Verify that Rotation controls rotation of the texture relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# UserA: Verify that Align Planar Faces is disabled/greyed out when in the Mapping Default mode

====Normal texture, Planar mapping====
# UserA, UserB, UserC: Login
# UserA: Rez a cube and resize it to 1m per side. Reposition the cube so the entire prim can be viewed. Set [[:File:TestDiffuse001.png]] as the diffuse map, via the texture picker.
# UserA: Set the Texture panel's dropdowns to read:
#* Materials
#* Bumpiness (normal)
#* '''Mapping: Planar'''
# USerA: Set [[:File:TestNormal001.png]] as the normal map, via the texture picker.
# UserA: Verify that the Repeats/Meter value is disabled/greyed out when in the Mapping Planar mode is active
# UserA: Set Horizontal Scale to 4
# UserA: Set Vertical Scale to 6
# UserA: Verify that the read-only Repeats Per Meter changed to 3.0 (yes, this is screwy, but it seems to match the release viewer)
# UserA: set horizontal offset to 0.5
# UserA: set Vertical offset to 0.5
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify that the diffuse texture appearance remains unchanged
#* UserA, UserB, and UserC: Verify the number of normal map repeats visible on each plane of each prim face matches 4 repeats horizontally, 6 vertically
# UserA: Verify that Rotation controls rotation of the normal map relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# '''Align Planar Faces test TBD'''

== Verify functionality of 'Shininess' settings ==

=== Layout of Shininess settings ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Shininess (specular)"
# UserA: Verify that the build tool layout looks like this mockup: [[:File:BuildtoolSpecular-NoTexture.png]]
# UserA: Verify the following default settings:
#* Verify that the Texture preview is empty, with a black-on-grey "X" (indicating that no specular map is set)
#* Verify that the 'Shininess' setting is currently 'None'
#* Verify that 'Glossiness' is hidden in this mode
#* Verify that 'Environment' is hidden in this mode
#* Verify that the 'Color' is hidden in this mode
#* Verify that the 'Mapping' setting is 'Default', and cannot be edited
#* Verify that 'Horizontal scale' is 1.0, and cannot be edited
#* Verify that 'Vertical scale' is 1.0, and cannot be edited
#* Verify that 'Repeats per meter' is 2.0 (this corresponds to a horizontal scale of 1.0 for a 50cm object), and cannot be edited
#* Verify that 'Rotation' is 0.0, and cannot be edited
#* Verify that 'Horizontal offset' is 0.0, and cannot be edited
#* Verify that 'Vertical offset' is 0.0, and cannot be edited
#* Verify that 'Align planar faces' is disabled, and cannot be edited
# UserA: Deselect the object
# UserA, UserB, UserC: verify that the box's appearance is unchanged (was not accidentally edited)

=== Legacy Shiny ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Shininess (specular)"
# UserA: Verify that you see the following options under the Shininess menu:
#* None
#* Low
#* Medium
#* High
# UserC: Rez a box and edit it with the build tool
# Do the following for Shininess settings 'Low', 'Medium', and 'High':
#* UserA and UserC: select the same Shininess menu option for your object's texture
#* UserA, UserB, and UserC: Verify that UserA's box has the same appearance as UserC's box
#* UserA: Verify that all of the texture mapping controls (scale, offset, rotation, align planar faces, etc.) are disabled in the UI (grayed out) when in this mode
#* UserA: Verify that Glossiness, Environment, and Color settings are not visible when in this mode.
#* UserA: Verify that Mapping drop down may be switched from Default to Planar and back
#* UserA: Verify that any prior changes made to; scale, repeats, rotation and offset are preserved when switching between Default and Planar

=== Specular Map Texture Selection ===
# UserA, UserB, and UserC: login
# UserA: if you don't already have them in your inventory, upload these two textures to SL
#* [[:File:TestDiffuse001.png]]
#* [[:File:TestSpecular001.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: Set the uploaded diffuse texture as the diffuse texture on your object
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Shininess (specular)"
# UserA: Verify that the Texture preview is empty, with a black-on-grey "X" (indicating that no specular map is set)
# UserA: Click on the texture icon, then choose the uploaded specular map using the texture picker
# UserA: Verify that the Texture preview shows the specular map you selected
# UserA: Verify that 'Shininess' is now set to "Use texture"
#* Verify that the floater has new elements, and now looks like [[:File:BuildtoolSpecular-UseTexture.png]]
#** Verify that Glossiness has a default value of 51
#** Verify that Environment has a default value of 0
#** Verify that Color defaults to white
# UserA and UserB: Verify that the uploaded textures appear on the box face at full scale, and are aligned.
#* The stained parts and the scratches should be less shiny than other parts of the texture
# UserC: Verify that you can see the diffuse texture, but no shiny effect
# UserA: From the 'Shininess' menu, choose 'None'
# UserA: Verify that the Texture preview is now empty, with a black-on-grey "X" (indicating that no normal map is set)
# UserA: Verify that the build tool layout has reverted to the style shown here: [[:File:BuildtoolSpecular-NoTexture.png]]
# UserA, UserB, and UserC: Verify that you can see the diffuse texture, but no specular map effect
# UserA: Drag the uploaded specular map from your inventory onto the Texture preview icon
# UserA: Verify that the Texture preview shows the specular map you selected
# UserA: Verify that 'Shininess' becomes set to "Use Texture"
# UserA and UserB: Verify that the uploaded textures appear on the box face at full scale, and are aligned
# UserC: Verify that you can see the diffuse texture, but no specular map effect

=== Specular Map Glossiness and Environment ===
# UserA, UserB, and UserC: login
# UserA: if you don't already have them in your inventory, upload these two textures to SL
#* [[:File:TestDiffuse001.png]]
#* [[:File:TestSpecular001.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: Set the uploaded diffuse texture as the diffuse texture on your object
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Shininess (specular)"
# UserA: Click on the texture icon, then choose the uploaded specular map using the texture picker
# UserA and UserB: verify that you see the object with the specular map applied
# UserC: Verify that you can see the diffuse texture, but no specular map effect
# UserA: Verify these default settings:
#* Glossiness should be 51
#* Environment should be 0
# UserA: Increase the Environment setting to 204
# UserA and UserB: Verify that the reflected color of the object now includes more of the environment (blue highlights from the sky color)
# UserC: verify that you see no change
# UserA: Try to enter an Environment setting > 255, and verify that the UI slams it to 255
# UserA: Try to enter an Environment setting < 0, and verify that the UI slams it to 0
# UserA: Increase the Glossiness setting to 204
# UserA and UserB: Verify that the specular highlights are now more 'blurred'
# UserC: verify that you see no change
# UserA: Try to enter a Glossiness setting > 255, and verify that the UI slams it to 255
# UserA: Try to enter a Glossiness setting < 0, and verify that the UI slams it to 0

=== Specular Map Texture mapping ===
====Specular texture, Default mapping====
# Set the Texture panel's dropdowns to read:
#* Materials
#* '''Shininess (specular)'''
#* '''Mapping: Default'''
# UserA: change the prim's texture to [[:File:TestSpecular001.png]]
# UserA: set Horizontal Scale to 2
# UserA: set horizontal offset to 0.5
# UserA: Verify Repeats per Meter value has automatically changed to 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, side-by-side.
# UserA: set Vertical Scale to 2
# UserA: set Vertical Offset to 0.5
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale plus the Vertical Scale: 4 repeats in a 2x2 grid
# UserA: set Horizontal Scale to 1
# UserA: set Horizontal offset to 0
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, one above the other.
# UserA: Verify that Rotation controls rotation of the texture relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# UserA: Verify that Align Planar Faces is disabled/greyed out when in the Mapping Default mode

====Normal texture, Planar mapping====
# UserA, UserB, UserC: Login
# UserA: Rez a cube and resize it to 1m per side. Reposition the cube so the entire prim can be viewed. Set [[:File:TestDiffuse001.png]] as the diffuse map, via the texture picker.
# UserA: Set the Texture panel's dropdowns to read:
#* Materials
#* Shiniiness (specular)
#* '''Mapping: Planar'''
# USerA: Set [[:File:TestSpecular001.png]] as the specular map, via the texture picker.
# UserA: Verify that the Repeats/Meter value is disabled/greyed out when in the Mapping Planar mode is active
# UserA: Set Horizontal Scale to 4
# UserA: Set Vertical Scale to 6
# UserA: Verify that the read-only Repeats Per Meter changed to 3.0 (yes, this is screwy, but it seems to match the release viewer)
# UserA: set horizontal offset to 0.5
# UserA: set Vertical offset to 0.5
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify that the diffuse texture appearance remains unchanged
#* UserA, UserB, and UserC: Verify the number of specular map repeats visible on each plane of each prim face matches 4 repeats horizontally, 6 vertically
# UserA: Verify that Rotation controls rotation of the specular map relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# '''Align Planar Faces test TBD'''

== Verify functionality of 'Media' settings ==
=== Layout and Default Values of Media Settings ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool
# UserA: In the Texture tab, change the edit mode from "Materials" to "Media".
# UserA: Verify that the build tool layout looks like this mockup: File:BuildToolMediaMode.png
# UserA: Verify that the following defaults are set:
#* Verify that the Color appears white
#* Verify that Transparency is 0%
#* Verify that Glow is 0.00
#* Verify that 'Full Bright' is disabled
#* Verify that 'Mapping' is 'Default
#** Verify that 'Horizontal scale' and 'Vertical scale' are both 1.00
#** Verify that 'Repeats per meter' is 2.0 (2.0/meter corresponds to 1.0/face on a 50cm cube face), and can be edited
#** Verify that 'Rotation' is 0.00
#** Verify that 'Horizontal offset' and 'Vertical offset' are both 0.00
#* Verify that 'Align planar faces' is unchecked and cannot be edited (is 'greyed out')'
# UserA, UserB, UserC: verify that the box's appearance is unchanged (was not accidentally edited)
=== Adding, and removing, and aligning media ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool
# UserA: Change your selection mode to "Select Face" and select only the top face
# UserA: In the Texture tab, change the edit mode from "Materials" to "Media".
# UserA: Click on the "Choose.." button, and verify that the "MEDIA SETTINGS" floater appears, and looks like this: [[:File:BuildToolMediaSettings.png]]
# UserA: Type "http://secondlife.com" into the Home Page text field in "MEDIA SETTINGS", and hit "Apply"
# UserA, UserB, and UserC: Verify that you see the SL website appear on the box's top face
# UserA: Change the 'Horizontal offset' value to 0.2
# UserA, UserB, and UserC: Verify that the SL website on the box is now slightly offset
# UserA: Click on the 'Align' button to align the website with the box's edges
# UserA, UserB, and UserC: Verify that the SL website on the box is now aligned with the box edges
# UserA: Click on the 'Remove' button to remove the prim media
# UserA: Verify that you see a modal dialog, asking to confirm media removal. Click "No"
# UserA, UserB, and UserC: Verify that the SL website on the box is unchanged
# UserA: Click on the 'Remove' button to remove the prim media
# UserA: Verify that you see a modal dialog, asking to confirm media removal. Click "Yes"
# UserA, UserB, and UserC: Verify that the SL website has disappeared from the box, and that the changed face is back to the default plywood texture

===Media Texture Mapping ===
====Media, Default mapping====
# UserA, UserB, UserC: login
# UserA: Rez a box, and edit one of its faces with the Build Tool
# UserA: Set the Texture panel's dropdowns to read:
#* Media
#* '''Mapping: Default'''
# UserA: Add media to a face on the box, using "http://secondlife.com", as in [[#Layout_and_Default_Values_of_Media_Settings]]
# UserA: set Horizontal Scale to 2
# UserA: set horizontal offset to 0.5
# UserA: Verify Repeats per Meter value has automatically changed to 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, side-by-side.
# UserA: set Vertical Scale to 2
# UserA: set Vertical Offset to 0.5
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale plus the Vertical Scale: 4 repeats in a 2x2 grid
# UserA: set Horizontal Scale to 1
# UserA: set Horizontal offset to 0
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, one above the other.
# UserA: Verify that Rotation controls rotation of the texture relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# UserA: Verify that Align Planar Faces is disabled/greyed out when in the Mapping Default mode

==== Media, Planar mapping====
# UserA, UserB, UserC: Login
# UserA: Rez a cube and resize it to 1m per side. Reposition the cube so the entire prim can be viewed. Add <test texture> via the texture picker.
# UserA: Set the Texture panel's dropdowns to read:
#* Media
#** '''Mapping: Planar'''
# UserA: Verify that the Repeats/Meter value is disabled/greyed out when in the Mapping Planar mode is active
# Rez a cube and resize it to 1m per side. Reposition the cube so the entire prim can be viewed. Add the texture [[:File:TestDiffuse001.png]] via the texture picker.
# UserA: Set Horizontal Scale to 4
# UserA: Set Vertical Scale to 6
# UserA: Verify that the read-only Repeats Per Meter changed to 3.0 (yes, this is screwy, but it seems to match the release viewer)
# UserA: set horizontal offset to 0.5
# UserA: set Vertical offset to 0.5
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each plane of each prim face matches 4 repeats horizontally, 6 vertically
# UserA: Verify that Rotation controls rotation of the texture relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# '''Align Planar Faces test TBD'''

= Materials Loading Test =
This test verifies that the viewer can fetch materials data and render it properly.

== Obtaining Test Objects ==
This test requires using 2 test objects which each contain many materials.

Some prepared test objects can be found at [http://maps.secondlife.com/secondlife/Bug%20Island/148/18/27 Bug Island]. There are 2 test linksets, each containing 50 unique materials:
* MaterialsObject01-50 contains 50 boxes, numbered by 01-50 with matching diffuse, normal, and specular maps.
* MaterialsObject51-100 contains 50 boxes, numbered by 51-100 with matching diffuse, normal, and specular maps.

Both link sets have prims that spin with llTargetOmega(), in order to make the specular maps more visible. You can modify the script in the root prim to remove this effect.

== Materials load when rezzed ==
# Log in
# Find a pair of neighboring regions which both allow you to rez objects, and move near the sim border
# Rez 'MaterialsObject01-50' in the region your avatar is in
# Without much delay, rez 'MaterialsObject51-100' in the neighboring region
# Verify that all diffuse/normal/specular maps for both linksets load in a timely manner
#* This may take a short while, since the viewer needs to download 300 separate textures for these objects

== Materials load upon login ==
# Complete the [[#Materials_load_when_rezzed]] test first
# Log out
# Login to the location where the objects were rezzed
# Verify that all diffuse/normal/specular maps for both linksets load in a timely manner
#* This should be relatively fast, since the viewer should have these textures in its cache

= Materials Rendering Test =
''Note: The following sections should be completed both above and below water. There is a trench directly to the west that replicates all test cases under water''

== Rendering of Legacy Bumpmaps and Shiny ==
''Note: this was lifted from [[Render_Correctness_Test]]''
# Go to http://maps.secondlife.com/secondlife/Bug%20Island%202/243/247/23
# Set your shaders and sun position as indicated on the red sphere at that location.
# Verify the spheres render the same as they appear in the picture at that location.
# Continue testing at the 5 stations to the South.
# Repeat test with 'Advanced Lighting Model' from graphics preferences both enabled and disabled (where allowed)
#* It is expected that 'Advanced Lighting Model' can only be enabled if both 'Basic Shaders' and 'Atmospheric Shaders' settings are enabled

==100% Transparent + Glow==
# Go to http://maps.secondlife.com/secondlife/Bug%20Island%202/240/174/23
# Set your shaders as indicated by the red sphere at that location.
# Verify that the sphere glows with ALM enabled.
# Verify that the sphere does not become opaque and black:
#* Under the Advanced->Rendering Types menu uncheck 'Water'
#* In Me->Preferences->Graphics uncheck and then recheck 'Advanced Lighting Model'
#* The sphere should continue to glow bright white.

''Note: When finished be sure to turn the water rendering back on in the Rendering Types menu''

==Consistent Lighting vs Solid and Alpha Surfaces==
# Go to http://maps.secondlife.com/secondlife/Bug%20Island%202/239/170/23
# The white plane is actually made up of two planes linked together.
# The plane on the left is solid, and the plane on the right has some Transparency %.
# With Local Lights on Verify under the following conditions that the two planes appear to be one plane:
#* With Basic Shaders enabled.
#* With Atmospheric Shaders enabled.
#* With Advanced Lighting Model enabled under all Sun Settings:
#** Sunrise
#** Midday
#** Sunset
#** Midnight

==Gamma Consistency w/ Full Bright + Alpha==
# Got to http://maps.secondlife.com/secondlife/Bug%20Island%202/241/164/23
# Follow the guidelines stated in the text on the red sphere at that location.
#* The cube with the pink circle should not be bright than the solid pink cube.
#* The cube with the target on it should not darken with ALM enabled.

== Alpha Modes Rendering ==
# Enter the 'Materials rendering test room' at http://maps.secondlife.com/secondlife/Bug%20Island%202/233/251/42
# Click World -> Sun -> Midday to set the viewer lighting
# Enable "Advanced Lighting Model" in your Preferences, under Graphics->Advanced
# Verify that row of 4 boxes on the northern side roughly match the appearance shown on the inworld 'Alpha modes sample' object
#* 'Alpha blended' should have a smooth transparency transition
#* 'Alpha masked' should have an abrupt transparency transition, with each pixel either fully opaque or fully transparent
#* 'Emissive mask' should look bright in the areas which appear more opaque in the 'Alpha blended' box
#* 'No Alpha' should be fully opaque
# Disable "Advanced Lighting Model" in your Preferences, under Graphics->Advanced
# Verify that the 'Emissive masked' box now appears the same as the 'No Alpha' box
# Verify that the other boxes have not changed their basic appearance

== Rendering with Normal Maps ==
# Enter the 'Materials rendering test room' at http://maps.secondlife.com/secondlife/Bug%20Island%202/235/248/46
# Click World -> Sun -> Midday to set the viewer lighting
# Enable "Advanced Lighting Model" in your Preferences, under Graphics->Advanced
# Look at the wall of test objects to the East, and confirm the appearance of each row roughly matches the sample screenshot on the left side. Each Row includes a different alpha type (labelled by floating text)
#* The 1st row, 'no specular', has objects which contain a normal map but have specularity disabled. These objects should have a totally matte appearance.
#* The 2nd row, 'low shiny', has objects which contain a normal map and use the legacy 'Low Shiny' setting. These objects should be slightly shiny, mostly for 'environment' reflections.
#* The 3rd row, 'medium shiny', has objects which contain a normal map and use the legacy 'Medium Shiny' setting. These objects should be slightly shinier than the 'low shiny' row, mostly for 'environment' reflections.
#* The 4th row, 'high shiny', has objects which contain a normal map and use the legacy 'Medium Shiny' setting. These objects should be slightly shinier than the 'medium shiny' row, mostly for 'environment' reflections.
#* The 5th row, '0 gloss, 0 env', has objects which contain a normal map and the '001' specular map, but has both glossiness and environment set to 0. These objects should look identical to the 'no specular' row.
#* The 6th row, '51 gloss, 0 env', has objects which contain a normal map and the '001' specular map, and has both glossiness=51 and environment=0. These objects should by mostly matte, except for shiny '001' sections in the upper-left and lower-right corners.
#* The 7th row, '51 gloss, 0 env, red', has objects which contain a normal map and the '001' specular map, and has both glossiness=51, environment=0, and a red specular color. These objects should appaer similar to those in the '51 gloss, 0 env' row, except that the shiny '001' parts should have a red hue.
#* The 8th row, '51 gloss, 200 env', has objects which contain a normal map and the '001' specular map, and has both glossiness=51 and environment=200. These objects should appaer metallic all over, and have the shiny '001' lettering in the upper-left and lower-right corners.
#* The 9th row, '0 gloss, 200 env', has objects which contain a normal map and the '001' specular map, and has both glossiness=0 and environment=200. These objects should appear metallic all over, but should only have the shiny '001' lettering in the upper-left and lower-right corners when there is a direct reflection from a light source (you have to move your camera around to see it).
# Disable "Advanced Lighting Model" in your Preferences, under Graphics->Advanced
# Look at the wall of test objects to the East, and confirm these changes:
#* All 'emissive mask' objects (far right column) now appear identical to the 'alpha none' objects next to them
#* All normal maps are missing
#* Rows 1, 5, 6, 7, 8, 9 (that is, all except for low/medium/high shiny rows) should all look identical to each other. None of them should appear shiny.
#* For each of rows 2-4 (low/medium/high shiny), the 'opaque', 'alpha none', and 'emissive mask' objects appear identical to each other (and look shiny)
#* For each of rows 2-4 (low/medium/high shiny), the 'alpha blend' and 'alpha mask' objects all appear non-shiny

== Materials Rendering on HUDs ==
Normal and specular maps should not render on objects which are attached as HUDs, due to the lack of lighting sources at the HUD layer (objects tend to render as full bright). However, some of the new alpha modes should effect rendering of HUD objects.
# Take a copy of 'Materials test HUD', which is rezzed at http://maps.secondlife.com/secondlife/Bug%20Island%202/229/253/23 - this object is a linkset of small boxes, with plenty of floating text.
# Enable "Advanced Lighting Model" in your Preferences, under Graphics->Advanced
# Wear the 'Materials test HUD' object from inventory. By default, it should attach to the 'Center' HUD attachment point
# If you have trouble seeing the floating text about each HUD object (the text can be crowded), set 'UI size' to 0.75 under Preferences->Advanced
# Position your camera so that you can see the attachments clearly - I used a blank-textured large prim as background
# Verify that the HUD appears like this screen shot: [[:File:Materials_test_HUD_appearance.png]]
#* Verify that no normal or specular maps appear with the '001' pattern
#** The boxes labelled with 'X gloss, Y env' should be identical to the 'no specular' boxes on the far left column
#** Each of the 'no specular' boxes on the far left column should appear identical to the non-brick 'Water particle 1' objects on the top row
#** In the top row, "No Alpha 'Water Particle 1' with legacy bricks" should look the same as "Emissive Masked 'Water Particle 1' with legacy bricks"
#* Verify that 'Opaque '001' diffuse map with legacy bricks' in the upper-left corner is the only box that has a visible 'bricks' pattern (this is legacy bumpiness)
#* Verify that the other 'with legacy bricks' objects in the top row do *not* have any bumpiness effect, and that the alpha modes render as labelled
#** These objects should have the same appearance as the non-'brick' objects on the right side of the first row
#* Verify that Alpha mode renders correctly
#** Verify that all of the 'opaque' boxes (with the 001 texture) appear fully opaque
#** Verify that all of the 'Alpha blended' objects appear alpha blended (semitransparent, with soft edges)
#** Verify that all of the 'Alpha masked' objects appear alpha masked (semitransparent, with hard edges)
#** Verify that all 'emissive mask' boxes match their corresponding 'alpha none' boxes, since all HUD objects render as fully emissive ('full bright')
#* Verify that legacy shiny objects appear darker than the others
#** Opaque-rendered objects (no alpha, emissive mask, or opaque) set to low/medium/high shiny boxes appear darker than the other boxes
#** The shading should be more severe with increasing shiny level: 'high shiny' objects should be darkest, while 'low shiny' objects should not be so dark
# Disable "Advanced Lighting Model" in your Preferences, under Graphics->Advanced
# Verify that the HUD appears like this screen shot: [[:File:Materials_test_HUD_appearance.png]]
#* Appearance should match what you saw when "Advanced Lighting Model" was enabled

== Materials Rendering on Rigged Meshes ==
TODO

== Rendering of Environment and Exponent Masks ==
TODO

[[Category:QA Portal]]
[[Category:Test Scripts]]

File:Kart screenshot with KART alpha.png

2019-07-03T22:28:46Z

Dan Linden:

Viewer Materials Smoke Test

2019-07-03T00:00:49Z

Dan Linden: /* Texture Mapping: Diffuse texture, Default mode */

= Overview =
* This test plan covers viewer-side support for the prim materials project, which provides support for normal maps and specular maps applied to object faces
* A high-level specification of this featureset can be found at [[Material_Data]]

= Build Tool Test =

== Required Materials ==
* A region which supports normal and specular maps
** As of [[Release_Notes/Second_Life_Server/13#13.02.08.270166|Second Life Server 13.02.08.270166]], materials support is in the server.
* Three test users
** UserA, who uses a viewer which supports normal and specular maps, and does the building (actually performs operations)
** UserB, who uses a viewer which supports normal and specular maps, and only observes the results of UserA's work
*** The purpose of this user is to verify that build tool edits sent by UserA's viewer produce congruent results
** UserC, who uses an 'old' (no support for normal and specular maps) viewer, and only observes the results of UserA's work
*** The purpose of this user is to verify that edited content looks reasonable on legacy viewers, and sometimes to verify that build tool settings from the new viewer have the same appearance as those set by the legacy viewer.
** UserA and UserB should have "Advanced Lighting Model" enabled under Preferences -> Graphics settings, under "Advanced". This setting is required for the viewer to render normal and specular maps properly.
* Upload the following textures to use in this test:
** [[:File:TestDiffuse001.png]]
** [[:File:TestNormal001.png]]
** [[:File:TestSpecular001.png]]

== Verify Basic Build Tool Layout ==

=== Verify that non-Texture portions of the build tool have not changed ===
# UserA, UserB, and UserC: login
# UserA and UserC: each rez a box
# UserA and UserC: select the box that you rezzed, and select Edit from the context menu
# UserA and UserC: verify that your build tools appear, and that the appearance is identical in the following tabs:
#* General
#* Object
#* Features
#* Content
# UserA and UserC: verify that the build tool UI is the same for each of the build tool modes (top row of buttons)
#* Focus (magnifying glass icon)
#* Move (hand icon)
#* Edit (mouse cursor icon)
#* Create (magic wand icon)
#* Land (bulldozer icon)
# UserA: deselect the box
# UserA, UserB, and UserC: verify that UserA's box still looks like a default box (has not changed appearance)

=== Verify layout and default values of build tool's Texture tab ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool
# UserA: Open the Texture tab of the build tool, and verify that the layout basically matches the image here (minus colorful lines): [[:File:MaterialsBuildUI1.png]]. Verify that the following defaults are set:
#* Verify that "Materials" is the default face edit mode
#* Verify that "Texture (diffuse)" is the default texture edit mode
#* Verify that the Color appears white
#* Verify that Transparency is 0%
#* Verify that Glow is 0.00
#* Verify that 'Full Bright' is disabled
#* Verify that the texture preview shows the default plywood texture
#* Verify that 'Alpha mode' is 'Alpha blending'
#* Verify that 'Mask cutoff' does *not* appear (this option is not applicable in this alpha mode)

=== Verify layout and default values for Mapping option ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool. Open the Texture tab of the build tool.
#* Verify that 'Repeats' is 'per face (default)'
#** Verify that the texture mapping settings match the 'Mapping = default' section in '2b' of this reference image: [[:File:MaterialsBuildUI1.png]].. Verify that the following defaults are set:
#** Verify that 'Horizontal scale' and 'Vertical scale' are both 1.00
#** Verify that 'Repeats per meter' is 2.0 (2.0/meter corresponds to 1.0/face on a 50cm cube face), and can be edited
#** Verify that 'Rotation' is 0.00
#** Verify that 'Horizontal offset' and 'Vertical offset' are both 0.00
#** Verify that 'Align planar faces' is *not* visible
# UserA: Deselect the box
# UserA, UserB, and UserC: verify that the box's appearance has not changed (since no edits have been made)
# UserA: Reselect the box, and 'Edit' it again
# UserA: Under the Texture tab, change the 'Mapping' setting to 'Planar'
#* Verify that the texture mapping settings match the 'Mapping = planar' section in '2b' of this reference image: [[:File:MaterialsBuildUI1.png]].. Verify that the following defaults are set:
#** Verify that 'Number of repeats' is 2.00, and *cannot* be edited (is read-only)
#** Verify that 'Rotation' is 0.00
#** Verify that 'Horizontal offset' and 'Vertical offset' are both 0.00
#** Verify that 'Align planar faces' is visible, unchecked and enabled (*can* be edited)
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that the box's appearance has not changed (since the change to 'planar' mapping by itself has no visible effect on this box)

=== Verify build tool editing of texture settings ===
#* Note: UserA: run the following tests for texture settings., for both planar and default texture mapping modes
#*Note: UserB, and UserC: throughout the test, verify that you see the expected results based on the observer Viewer in use.

====Texture Mapping: Diffuse texture, Default mode====
# UserA: Set the Texture panel's dropdowns to read:
#* Materials
#* Texture (diffuse)
#* Mapping: Default
# UserA: Create a new cube prim for use in this test.
# UserA: Verify that clicking Texture box will open the Pick: Texture floating window, allowing you to select a new texture.
# UserA: Verify that you can drag a texture from your Inventory window to the Texture box.
# UserA: Verify that if the Select Face item is NOT selected, texture changes are applied to all sides at once.
# UserA: Verify that if the Select Face item in the upper pane of the Tools window is selected, you can change one face of the object at a time.
# UserA: Verify that if you drag a texture from your Inventory window directly to the object, you can change one face of the object at a time.
# UserA: Apply the texture, [[:File:TestDiffuse001.png]], to a single face of the prim (while in Select Face mode). This should result in the prim having two textures. The "100" image should appear on only one face.
# UserA: Verify that if an object uses more than one texture, the word Multiple will appear in the Texture image box over one of the texture images.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that the box's appearance has changed to show two textures, one on a single face the other on all other faces
# UserA: Verify that clicking Color box will open the Color Picker floating window.
# UserA: Verify that color tints selected are additive to the color of the base texture.
# UserA: Verify that using Transparency you can choose transparency level of the object.
# UserA: Verify that this setting applies an overall transparency to the texture in addition to any transparency in the alpha channel. The range is 0 to 100 percent. Set to 50%.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that the box's appearance has changed to show a color tint and is semi-transparent.
# UserA: Verify that using Glow item you can create a surface glow on the object, separate from the light emitted with the Features tab. The range is 0 to 1, but any glow above 0.1 tends to wash out the surface texture.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that the box's appearance has changed to add glow.
# UserA: Enable Full Bright.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that the box renders as if fully day-lighted, regardless of the environment day cycle position of the sun.
#* (Use World > Sun > <time of day> to change sun position.)
# UserA: Change Transparency and Glow settings back to 0, and disable Full Bright.
# Rez a 0.5 (default-size) cube and add <test texture> via the texture picker.
# UserA: set Horizontal Scale to 2
# UserA: set horizontal offset to 0.5
# UserA: Verify Repeats per Meter value has automatically changed to 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, side-by-side.
# UserA: set Vertical Scale to 2
# UserA: set Vertical Offset to 0.5
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale plus the Vertical Scale: 4 repeats in a 2x2 grid
# UserA: set Horizontal Scale to 1
# UserA: set Horizontal offset to 0
# UserA: Verify Repeats per Meter value remains at 4.0 (since this value now reflects the maximum density between horizontal and vertical scales)
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, one above the other.
# UserA: Verify that Rotation controls rotation of the texture relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# UserA: Verify that Align Planar Faces is disabled/greyed out when in the Mapping Default mode

====Texture Mapping: Diffuse texture, Planar mode====
# Set the Texture panel's dropdowns to read:
#* Materials
#* Texture (diffuse)
#* '''Mapping: Planar'''
# UserA: Verify that the Repeats/Meter value is disabled/greyed out when in the Mapping Planar mode is active
# Rez a cube and resize it to 1m per side. Reposition the cube so the entire prim can be viewed. Add the texture [[:File:TestDiffuse001.png]] via the texture picker.
# UserA: Set Horizontal Scale to 4
# UserA: Set Vertical Scale to 6
# UserA: Verify that the read-only Repeats Per Meter changed to 3.0 (yes, this is screwy, but it seems to match the release viewer)
# UserA: set horizontal offset to 0.5
# UserA: set Vertical offset to 0.5
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each plane of each prim face matches 4 repeats horizontally, 6 vertically
# UserA: Verify that Rotation controls rotation of the texture relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# '''Align Planar Faces test TBD'''

== Verify functionality of 'Alpha mode' option ==
=== No Mask is forced for textures without an alpha channel ===
# UserA, UserB, and UserC: login
# UserA: Take a snapshot (ctrl+S) and 'Save to inventory'
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: Set the snapshot as the texture on the box
# UserA: Verify that the 'Alpha mode' setting is 'None', and that the UI for changing 'Alpha mode is disabled'
#* Verify that the 'Mask cutoff' setting is hidden
# UserA, UserB, and UserC: Verify that the snapshot appears on the box, and that it is fully opaque
=== Alpha Blending ===
# UserA, UserB, and UserC: login
# UserA: Upload this alpha-mapped image to your inventory: [[:File:Maestro_alpha_gradient.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool. Open the Texture tab of the build tool.
# UserA: Using the texture picker from the build tool, set the image you uploaded on all faces of the box
# UserA, UserB, and UserC: verify that you see a 'smooth' transparency transition in the texture on all faces, with the bottom of the image being opaque and the top being transparent. This is the expected result when the 'Alpha mode' is set to the default 'Alpha blending' setting

=== Alpha Masking ===
# UserA, UserB, and UserC: login
# UserA: Upload this alpha-mapped image to your inventory (if you don't already have it): [[:File:Maestro_alpha_gradient.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool. Open the Texture tab of the build tool, and set the texture to the one you just uploaded.
# UserA: Set the 'Alpha mode' to 'Alpha masking'
#* Verify that the 'Mask cutoff' setting appears, and that the default value for it is 0
# UserA, UserB: verify that the box's texture appears (almost) completely opaque
# UserC: verify that you see no change (since your viewer doesn't support alpha masking)
# UserA: set the 'Mask cutoff' setting to 76
# UserA, UserB: Verify that the top 30% of the texture is now invisible, but the bottom 70% is totally opaque
# UserC: verify that you see no change
# UserA: set the 'Mask cutoff' setting to 178
# UserA, UserB: Verify that the top 70% of the texture is now invisible, but the bottom 30% is totally opaque
# UserC: verify that you see no change
# UserA: set the 'Mask cutoff' setting to 255
# UserA, UserB: Verify that the texture is now almost completely invisible (except perhaps a strip at the bottom)
# UserC: verify that you see no change
# UserA: Try to input 'Mask cutoff' settings < 0, and verify that they get slammed to 0 by the build tool UI
# UserA: Try to input 'Mask cutoff' settings > 255, and verify that they get slammed to 255 by the build tool UI

=== Emissive Mask ===
# UserA, UserB, and UserC: login
# UserA: Upload this alpha-mapped image to your inventory (if you don't already have it): [[:File:Kart_screenshot_with_G_alpha.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool. Open the Texture tab of the build tool, and set the texture to the one you just uploaded.
# UserA, UserB, and UserC: Verify that the image on the box appears mostly transparent, with a "G" in the middle as an opaque section
# UserA: Set the 'Alpha mode' to 'Emissive mask'
#* Verify that the 'Mask cutoff' setting remains hidden
# UserA and UserB: verify that the box's appearance has changed. The whole texture should be opaque, but there should be a glowing 'G' in the texture.
# UserC: verify that the box's appearance has not changed (and you just see the image as mostly transparent with the opaque 'G')

=== No Mask (on a texture with an alpha channel) ===
# UserA, UserB, and UserC: login
# UserA: Upload this alpha-mapped image to your inventory (if you don't already have it): [[:File:Kart_screenshot_with_G_alpha.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool. Open the Texture tab of the build tool, and set the texture to the one you just uploaded.
# UserA, UserB, and UserC: Verify that the image on the box appears mostly transparent, with a "G" in the middle as an opaque section
# UserA: Set the 'Alpha mode' to 'None'
#* Verify that the 'Mask cutoff' setting remains hidden
# UserA and UserB: verify that the box's appearance has changed. The whole texture should be opaque, and no 'G' should be visible.
# UserC: verify that the box's appearance has not changed (and you just see the image as mostly transparent with the opaque 'G')

== Verify functionality of 'Bumpiness' settings ==
=== Layout of Bumpiness settings ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Bumpiness (normal)"
# UserA: Verify that the build tool layout looks like the 'Materials > Normal' section from this mockup [[:File:BuildTool_Bumpiness_Shininess.png]]
# UserA: Verify the following default settings:
#* Verify that the Texture preview is empty, with a black-on-grey "X" (indicating that no normal map is set)
#* Verify that the 'Bumpiness' setting is currently 'None'
#* Verify that the 'Mapping' setting is 'Default'
#* Verify that 'Horizontal scale' is 1.0
#* Verify that 'Vertical scale' is 1.0
#* Verify that 'Repeats per meter' is enabled, and is 2.0 (this corresponds to a horizontal scale of 1.0 for a 50cm object)
#* Verify that 'Rotation' is 0.0
#* Verify that 'Horizontal offset' is 0.0
#* Verify that 'Vertical offset' is 0.0
#* Verify that 'Align planar faces' is disabled and cannot be edited
# UserA: Deselect the object
# UserA, UserB, UserC: verify that the box's appearance is unchanged (was not accidentally edited)

=== Legacy Bumpiness ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Bumpiness (normal)"
# UserA: Verify that you see the following options under the Bumpiness menu:
#* None
#* Brightness
#* Darkness
#* woodgrain
#* bark
#* bricks
#* checker
#* concrete
#* crustytile
#* cutstone
#* discs
#* gravel
#* petridish
#* siding
#* stonetile
#* stucco
#* suction
#* weave
# UserC: Rez a box and edit it with the build tool
# For each of the bumpiness menu options *except* for 'None', do the following:
#* UserA and UserC: select the same bumpiness menu option for your object's texture
#* UserA, UserB, and UserC: Verify that UserA's box has the same appearance as UserC's box
#* UserA: Verify that all of the texture mapping controls (scale, offset, rotation, align planar faces, etc.) are disabled in the UI (grayed out) when in this mode

=== Normal Map Texture Selection ===
# UserA, UserB, and UserC: login
# UserA: if you don't already have them in your inventory, upload these two textures to SL
#* [[:File:TestDiffuse001.png]]
#* [[:File:TestNormal001.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: Set the uploaded diffuse texture as the diffuse texture on your object
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Bumpiness (normal)"
# UserA: Verify that the Texture preview is empty, with a black-on-grey "X" (indicating that no normal map is set)
# UserA: Click on the texture icon, then choose the uploaded normal map using the texture picker
# UserA: Verify that the Texture preview shows the normal map you selected
# UserA: Verify that 'Bumpiness' is now set to "Use Texture"
# UserA and UserB: Verify that the uploaded textures appear on the box face at full scale, and are aligned. You should see a large '001' in the middle, due to the normal map effect.
# UserC: Verify that you can see the diffuse texture, but no bump map effect
# UserA: From the 'Bumpiness' menu, choose 'None'
# UserA: Verify that the Texture preview is now empty, with a black-on-grey "X" (indicating that no normal map is set)
# UserA, UserB, and UserC: Verify that you can see the diffuse texture, but no bump map effect
# UserA: Drag the uploaded normal map from your inventory onto the Texture preview icon
# UserA: Verify that the Texture preview shows the normal map you selected
# UserA: Verify that 'Bumpiness' becomes set to "Use Texture"
# UserA and UserB: Verify that you see both the normal map and diffuse map applied on the rendered box
# UserC: Verify that you can see the diffuse texture, but no normal map effect

=== Normal Map Texture mapping ===
====Normal texture, Default mapping====
# Set the Texture panel's dropdowns to read:
#* Materials
#* '''Bumpiness (normal)'''
#* '''Mapping: Default'''
# UserA: change the prim's texture to [[:File:TestNormal001.png]]
# UserA: set Horizontal Scale to 2
# UserA: set horizontal offset to 0.5
# UserA: Verify Repeats per Meter value has automatically changed to 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, side-by-side.
# UserA: set Vertical Scale to 2
# UserA: set Vertical Offset to 0.5
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale plus the Vertical Scale: 4 repeats in a 2x2 grid
# UserA: set Horizontal Scale to 1
# UserA: set Horizontal offset to 0
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, one above the other.
# UserA: Verify that Rotation controls rotation of the texture relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# UserA: Verify that Align Planar Faces is disabled/greyed out when in the Mapping Default mode

====Normal texture, Planar mapping====
# UserA, UserB, UserC: Login
# UserA: Rez a cube and resize it to 1m per side. Reposition the cube so the entire prim can be viewed. Set [[:File:TestDiffuse001.png]] as the diffuse map, via the texture picker.
# UserA: Set the Texture panel's dropdowns to read:
#* Materials
#* Bumpiness (normal)
#* '''Mapping: Planar'''
# USerA: Set [[:File:TestNormal001.png]] as the normal map, via the texture picker.
# UserA: Verify that the Repeats/Meter value is disabled/greyed out when in the Mapping Planar mode is active
# UserA: Set Horizontal Scale to 4
# UserA: Set Vertical Scale to 6
# UserA: Verify that the read-only Repeats Per Meter changed to 3.0 (yes, this is screwy, but it seems to match the release viewer)
# UserA: set horizontal offset to 0.5
# UserA: set Vertical offset to 0.5
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify that the diffuse texture appearance remains unchanged
#* UserA, UserB, and UserC: Verify the number of normal map repeats visible on each plane of each prim face matches 4 repeats horizontally, 6 vertically
# UserA: Verify that Rotation controls rotation of the normal map relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# '''Align Planar Faces test TBD'''

== Verify functionality of 'Shininess' settings ==

=== Layout of Shininess settings ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Shininess (specular)"
# UserA: Verify that the build tool layout looks like this mockup: [[:File:BuildtoolSpecular-NoTexture.png]]
# UserA: Verify the following default settings:
#* Verify that the Texture preview is empty, with a black-on-grey "X" (indicating that no specular map is set)
#* Verify that the 'Shininess' setting is currently 'None'
#* Verify that 'Glossiness' is hidden in this mode
#* Verify that 'Environment' is hidden in this mode
#* Verify that the 'Color' is hidden in this mode
#* Verify that the 'Mapping' setting is 'Default', and cannot be edited
#* Verify that 'Horizontal scale' is 1.0, and cannot be edited
#* Verify that 'Vertical scale' is 1.0, and cannot be edited
#* Verify that 'Repeats per meter' is 2.0 (this corresponds to a horizontal scale of 1.0 for a 50cm object), and cannot be edited
#* Verify that 'Rotation' is 0.0, and cannot be edited
#* Verify that 'Horizontal offset' is 0.0, and cannot be edited
#* Verify that 'Vertical offset' is 0.0, and cannot be edited
#* Verify that 'Align planar faces' is disabled, and cannot be edited
# UserA: Deselect the object
# UserA, UserB, UserC: verify that the box's appearance is unchanged (was not accidentally edited)

=== Legacy Shiny ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Shininess (specular)"
# UserA: Verify that you see the following options under the Shininess menu:
#* None
#* Low
#* Medium
#* High
# UserC: Rez a box and edit it with the build tool
# Do the following for Shininess settings 'Low', 'Medium', and 'High':
#* UserA and UserC: select the same Shininess menu option for your object's texture
#* UserA, UserB, and UserC: Verify that UserA's box has the same appearance as UserC's box
#* UserA: Verify that all of the texture mapping controls (scale, offset, rotation, align planar faces, etc.) are disabled in the UI (grayed out) when in this mode
#* UserA: Verify that Glossiness, Environment, and Color settings are not visible when in this mode.
#* UserA: Verify that Mapping drop down may be switched from Default to Planar and back
#* UserA: Verify that any prior changes made to; scale, repeats, rotation and offset are preserved when switching between Default and Planar

=== Specular Map Texture Selection ===
# UserA, UserB, and UserC: login
# UserA: if you don't already have them in your inventory, upload these two textures to SL
#* [[:File:TestDiffuse001.png]]
#* [[:File:TestSpecular001.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: Set the uploaded diffuse texture as the diffuse texture on your object
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Shininess (specular)"
# UserA: Verify that the Texture preview is empty, with a black-on-grey "X" (indicating that no specular map is set)
# UserA: Click on the texture icon, then choose the uploaded specular map using the texture picker
# UserA: Verify that the Texture preview shows the specular map you selected
# UserA: Verify that 'Shininess' is now set to "Use texture"
#* Verify that the floater has new elements, and now looks like [[:File:BuildtoolSpecular-UseTexture.png]]
#** Verify that Glossiness has a default value of 51
#** Verify that Environment has a default value of 0
#** Verify that Color defaults to white
# UserA and UserB: Verify that the uploaded textures appear on the box face at full scale, and are aligned.
#* The stained parts and the scratches should be less shiny than other parts of the texture
# UserC: Verify that you can see the diffuse texture, but no shiny effect
# UserA: From the 'Shininess' menu, choose 'None'
# UserA: Verify that the Texture preview is now empty, with a black-on-grey "X" (indicating that no normal map is set)
# UserA: Verify that the build tool layout has reverted to the style shown here: [[:File:BuildtoolSpecular-NoTexture.png]]
# UserA, UserB, and UserC: Verify that you can see the diffuse texture, but no specular map effect
# UserA: Drag the uploaded specular map from your inventory onto the Texture preview icon
# UserA: Verify that the Texture preview shows the specular map you selected
# UserA: Verify that 'Shininess' becomes set to "Use Texture"
# UserA and UserB: Verify that the uploaded textures appear on the box face at full scale, and are aligned
# UserC: Verify that you can see the diffuse texture, but no specular map effect

=== Specular Map Glossiness and Environment ===
# UserA, UserB, and UserC: login
# UserA: if you don't already have them in your inventory, upload these two textures to SL
#* [[:File:TestDiffuse001.png]]
#* [[:File:TestSpecular001.png]]
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool.
# UserA: Set the uploaded diffuse texture as the diffuse texture on your object
# UserA: In the Texture tab, change the edit mode from "Texture (diffuse)" to "Shininess (specular)"
# UserA: Click on the texture icon, then choose the uploaded specular map using the texture picker
# UserA and UserB: verify that you see the object with the specular map applied
# UserC: Verify that you can see the diffuse texture, but no specular map effect
# UserA: Verify these default settings:
#* Glossiness should be 51
#* Environment should be 0
# UserA: Increase the Environment setting to 204
# UserA and UserB: Verify that the reflected color of the object now includes more of the environment (blue highlights from the sky color)
# UserC: verify that you see no change
# UserA: Try to enter an Environment setting > 255, and verify that the UI slams it to 255
# UserA: Try to enter an Environment setting < 0, and verify that the UI slams it to 0
# UserA: Increase the Glossiness setting to 204
# UserA and UserB: Verify that the specular highlights are now more 'blurred'
# UserC: verify that you see no change
# UserA: Try to enter a Glossiness setting > 255, and verify that the UI slams it to 255
# UserA: Try to enter a Glossiness setting < 0, and verify that the UI slams it to 0

=== Specular Map Texture mapping ===
====Specular texture, Default mapping====
# Set the Texture panel's dropdowns to read:
#* Materials
#* '''Shininess (specular)'''
#* '''Mapping: Default'''
# UserA: change the prim's texture to [[:File:TestSpecular001.png]]
# UserA: set Horizontal Scale to 2
# UserA: set horizontal offset to 0.5
# UserA: Verify Repeats per Meter value has automatically changed to 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, side-by-side.
# UserA: set Vertical Scale to 2
# UserA: set Vertical Offset to 0.5
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale plus the Vertical Scale: 4 repeats in a 2x2 grid
# UserA: set Horizontal Scale to 1
# UserA: set Horizontal offset to 0
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, one above the other.
# UserA: Verify that Rotation controls rotation of the texture relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# UserA: Verify that Align Planar Faces is disabled/greyed out when in the Mapping Default mode

====Normal texture, Planar mapping====
# UserA, UserB, UserC: Login
# UserA: Rez a cube and resize it to 1m per side. Reposition the cube so the entire prim can be viewed. Set [[:File:TestDiffuse001.png]] as the diffuse map, via the texture picker.
# UserA: Set the Texture panel's dropdowns to read:
#* Materials
#* Shiniiness (specular)
#* '''Mapping: Planar'''
# USerA: Set [[:File:TestSpecular001.png]] as the specular map, via the texture picker.
# UserA: Verify that the Repeats/Meter value is disabled/greyed out when in the Mapping Planar mode is active
# UserA: Set Horizontal Scale to 4
# UserA: Set Vertical Scale to 6
# UserA: Verify that the read-only Repeats Per Meter changed to 3.0 (yes, this is screwy, but it seems to match the release viewer)
# UserA: set horizontal offset to 0.5
# UserA: set Vertical offset to 0.5
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify that the diffuse texture appearance remains unchanged
#* UserA, UserB, and UserC: Verify the number of specular map repeats visible on each plane of each prim face matches 4 repeats horizontally, 6 vertically
# UserA: Verify that Rotation controls rotation of the specular map relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# '''Align Planar Faces test TBD'''

== Verify functionality of 'Media' settings ==
=== Layout and Default Values of Media Settings ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool
# UserA: In the Texture tab, change the edit mode from "Materials" to "Media".
# UserA: Verify that the build tool layout looks like this mockup: File:BuildToolMediaMode.png
# UserA: Verify that the following defaults are set:
#* Verify that the Color appears white
#* Verify that Transparency is 0%
#* Verify that Glow is 0.00
#* Verify that 'Full Bright' is disabled
#* Verify that 'Mapping' is 'Default
#** Verify that 'Horizontal scale' and 'Vertical scale' are both 1.00
#** Verify that 'Repeats per meter' is 2.0 (2.0/meter corresponds to 1.0/face on a 50cm cube face), and can be edited
#** Verify that 'Rotation' is 0.00
#** Verify that 'Horizontal offset' and 'Vertical offset' are both 0.00
#* Verify that 'Align planar faces' is unchecked and cannot be edited (is 'greyed out')'
# UserA, UserB, UserC: verify that the box's appearance is unchanged (was not accidentally edited)
=== Adding, and removing, and aligning media ===
# UserA, UserB, and UserC: login
# UserA: Rez a box, select it, and hit 'Edit' to open the build tool
# UserA: Change your selection mode to "Select Face" and select only the top face
# UserA: In the Texture tab, change the edit mode from "Materials" to "Media".
# UserA: Click on the "Choose.." button, and verify that the "MEDIA SETTINGS" floater appears, and looks like this: [[:File:BuildToolMediaSettings.png]]
# UserA: Type "http://secondlife.com" into the Home Page text field in "MEDIA SETTINGS", and hit "Apply"
# UserA, UserB, and UserC: Verify that you see the SL website appear on the box's top face
# UserA: Change the 'Horizontal offset' value to 0.2
# UserA, UserB, and UserC: Verify that the SL website on the box is now slightly offset
# UserA: Click on the 'Align' button to align the website with the box's edges
# UserA, UserB, and UserC: Verify that the SL website on the box is now aligned with the box edges
# UserA: Click on the 'Remove' button to remove the prim media
# UserA: Verify that you see a modal dialog, asking to confirm media removal. Click "No"
# UserA, UserB, and UserC: Verify that the SL website on the box is unchanged
# UserA: Click on the 'Remove' button to remove the prim media
# UserA: Verify that you see a modal dialog, asking to confirm media removal. Click "Yes"
# UserA, UserB, and UserC: Verify that the SL website has disappeared from the box, and that the changed face is back to the default plywood texture

===Media Texture Mapping ===
====Media, Default mapping====
# UserA, UserB, UserC: login
# UserA: Rez a box, and edit one of its faces with the Build Tool
# UserA: Set the Texture panel's dropdowns to read:
#* Media
#* '''Mapping: Default'''
# UserA: Add media to a face on the box, using "http://secondlife.com", as in [[#Layout_and_Default_Values_of_Media_Settings]]
# UserA: set Horizontal Scale to 2
# UserA: set horizontal offset to 0.5
# UserA: Verify Repeats per Meter value has automatically changed to 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, side-by-side.
# UserA: set Vertical Scale to 2
# UserA: set Vertical Offset to 0.5
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale plus the Vertical Scale: 4 repeats in a 2x2 grid
# UserA: set Horizontal Scale to 1
# UserA: set Horizontal offset to 0
# UserA: Verify Repeats per Meter value remains at 4.0
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each prim face matches the Horizontal Scale setting: 2 repeats, one above the other.
# UserA: Verify that Rotation controls rotation of the texture relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# UserA: Verify that Align Planar Faces is disabled/greyed out when in the Mapping Default mode

==== Media, Planar mapping====
# UserA, UserB, UserC: Login
# UserA: Rez a cube and resize it to 1m per side. Reposition the cube so the entire prim can be viewed. Add <test texture> via the texture picker.
# UserA: Set the Texture panel's dropdowns to read:
#* Media
#** '''Mapping: Planar'''
# UserA: Verify that the Repeats/Meter value is disabled/greyed out when in the Mapping Planar mode is active
# Rez a cube and resize it to 1m per side. Reposition the cube so the entire prim can be viewed. Add the texture [[:File:TestDiffuse001.png]] via the texture picker.
# UserA: Set Horizontal Scale to 4
# UserA: Set Vertical Scale to 6
# UserA: Verify that the read-only Repeats Per Meter changed to 3.0 (yes, this is screwy, but it seems to match the release viewer)
# UserA: set horizontal offset to 0.5
# UserA: set Vertical offset to 0.5
# UserA: Deselect the box
#* UserA, UserB, and UserC: Verify the number of repeats visible on each plane of each prim face matches 4 repeats horizontally, 6 vertically
# UserA: Verify that Rotation controls rotation of the texture relative to vertical. Range is -360° to 360°.
# UserA: Deselect the box
#* UserA, UserB, and UserC: verify that for Rotation Degrees edits, the shift is along the texture, not the object face.
# '''Align Planar Faces test TBD'''

= Materials Loading Test =
This test verifies that the viewer can fetch materials data and render it properly.

== Obtaining Test Objects ==
This test requires using 2 test objects which each contain many materials.

Some prepared test objects can be found at [http://maps.secondlife.com/secondlife/Bug%20Island/148/18/27 Bug Island]. There are 2 test linksets, each containing 50 unique materials:
* MaterialsObject01-50 contains 50 boxes, numbered by 01-50 with matching diffuse, normal, and specular maps.
* MaterialsObject51-100 contains 50 boxes, numbered by 51-100 with matching diffuse, normal, and specular maps.

Both link sets have prims that spin with llTargetOmega(), in order to make the specular maps more visible. You can modify the script in the root prim to remove this effect.

== Materials load when rezzed ==
# Log in
# Find a pair of neighboring regions which both allow you to rez objects, and move near the sim border
# Rez 'MaterialsObject01-50' in the region your avatar is in
# Without much delay, rez 'MaterialsObject51-100' in the neighboring region
# Verify that all diffuse/normal/specular maps for both linksets load in a timely manner
#* This may take a short while, since the viewer needs to download 300 separate textures for these objects

== Materials load upon login ==
# Complete the [[#Materials_load_when_rezzed]] test first
# Log out
# Login to the location where the objects were rezzed
# Verify that all diffuse/normal/specular maps for both linksets load in a timely manner
#* This should be relatively fast, since the viewer should have these textures in its cache

= Materials Rendering Test =
''Note: The following sections should be completed both above and below water. There is a trench directly to the west that replicates all test cases under water''

== Rendering of Legacy Bumpmaps and Shiny ==
''Note: this was lifted from [[Render_Correctness_Test]]''
# Go to http://maps.secondlife.com/secondlife/Bug%20Island%202/243/247/23
# Set your shaders and sun position as indicated on the red sphere at that location.
# Verify the spheres render the same as they appear in the picture at that location.
# Continue testing at the 5 stations to the South.
# Repeat test with 'Advanced Lighting Model' from graphics preferences both enabled and disabled (where allowed)
#* It is expected that 'Advanced Lighting Model' can only be enabled if both 'Basic Shaders' and 'Atmospheric Shaders' settings are enabled

==100% Transparent + Glow==
# Go to http://maps.secondlife.com/secondlife/Bug%20Island%202/240/174/23
# Set your shaders as indicated by the red sphere at that location.
# Verify that the sphere glows with ALM enabled.
# Verify that the sphere does not become opaque and black:
#* Under the Advanced->Rendering Types menu uncheck 'Water'
#* In Me->Preferences->Graphics uncheck and then recheck 'Advanced Lighting Model'
#* The sphere should continue to glow bright white.

''Note: When finished be sure to turn the water rendering back on in the Rendering Types menu''

==Consistent Lighting vs Solid and Alpha Surfaces==
# Go to http://maps.secondlife.com/secondlife/Bug%20Island%202/239/170/23
# The white plane is actually made up of two planes linked together.
# The plane on the left is solid, and the plane on the right has some Transparency %.
# With Local Lights on Verify under the following conditions that the two planes appear to be one plane:
#* With Basic Shaders enabled.
#* With Atmospheric Shaders enabled.
#* With Advanced Lighting Model enabled under all Sun Settings:
#** Sunrise
#** Midday
#** Sunset
#** Midnight

==Gamma Consistency w/ Full Bright + Alpha==
# Got to http://maps.secondlife.com/secondlife/Bug%20Island%202/241/164/23
# Follow the guidelines stated in the text on the red sphere at that location.
#* The cube with the pink circle should not be bright than the solid pink cube.
#* The cube with the target on it should not darken with ALM enabled.

== Alpha Modes Rendering ==
# Enter the 'Materials rendering test room' at http://maps.secondlife.com/secondlife/Bug%20Island%202/233/251/42
# Click World -> Sun -> Midday to set the viewer lighting
# Enable "Advanced Lighting Model" in your Preferences, under Graphics->Advanced
# Verify that row of 4 boxes on the northern side roughly match the appearance shown on the inworld 'Alpha modes sample' object
#* 'Alpha blended' should have a smooth transparency transition
#* 'Alpha masked' should have an abrupt transparency transition, with each pixel either fully opaque or fully transparent
#* 'Emissive mask' should look bright in the areas which appear more opaque in the 'Alpha blended' box
#* 'No Alpha' should be fully opaque
# Disable "Advanced Lighting Model" in your Preferences, under Graphics->Advanced
# Verify that the 'Emissive masked' box now appears the same as the 'No Alpha' box
# Verify that the other boxes have not changed their basic appearance

== Rendering with Normal Maps ==
# Enter the 'Materials rendering test room' at http://maps.secondlife.com/secondlife/Bug%20Island%202/235/248/46
# Click World -> Sun -> Midday to set the viewer lighting
# Enable "Advanced Lighting Model" in your Preferences, under Graphics->Advanced
# Look at the wall of test objects to the East, and confirm the appearance of each row roughly matches the sample screenshot on the left side. Each Row includes a different alpha type (labelled by floating text)
#* The 1st row, 'no specular', has objects which contain a normal map but have specularity disabled. These objects should have a totally matte appearance.
#* The 2nd row, 'low shiny', has objects which contain a normal map and use the legacy 'Low Shiny' setting. These objects should be slightly shiny, mostly for 'environment' reflections.
#* The 3rd row, 'medium shiny', has objects which contain a normal map and use the legacy 'Medium Shiny' setting. These objects should be slightly shinier than the 'low shiny' row, mostly for 'environment' reflections.
#* The 4th row, 'high shiny', has objects which contain a normal map and use the legacy 'Medium Shiny' setting. These objects should be slightly shinier than the 'medium shiny' row, mostly for 'environment' reflections.
#* The 5th row, '0 gloss, 0 env', has objects which contain a normal map and the '001' specular map, but has both glossiness and environment set to 0. These objects should look identical to the 'no specular' row.
#* The 6th row, '51 gloss, 0 env', has objects which contain a normal map and the '001' specular map, and has both glossiness=51 and environment=0. These objects should by mostly matte, except for shiny '001' sections in the upper-left and lower-right corners.
#* The 7th row, '51 gloss, 0 env, red', has objects which contain a normal map and the '001' specular map, and has both glossiness=51, environment=0, and a red specular color. These objects should appaer similar to those in the '51 gloss, 0 env' row, except that the shiny '001' parts should have a red hue.
#* The 8th row, '51 gloss, 200 env', has objects which contain a normal map and the '001' specular map, and has both glossiness=51 and environment=200. These objects should appaer metallic all over, and have the shiny '001' lettering in the upper-left and lower-right corners.
#* The 9th row, '0 gloss, 200 env', has objects which contain a normal map and the '001' specular map, and has both glossiness=0 and environment=200. These objects should appear metallic all over, but should only have the shiny '001' lettering in the upper-left and lower-right corners when there is a direct reflection from a light source (you have to move your camera around to see it).
# Disable "Advanced Lighting Model" in your Preferences, under Graphics->Advanced
# Look at the wall of test objects to the East, and confirm these changes:
#* All 'emissive mask' objects (far right column) now appear identical to the 'alpha none' objects next to them
#* All normal maps are missing
#* Rows 1, 5, 6, 7, 8, 9 (that is, all except for low/medium/high shiny rows) should all look identical to each other. None of them should appear shiny.
#* For each of rows 2-4 (low/medium/high shiny), the 'opaque', 'alpha none', and 'emissive mask' objects appear identical to each other (and look shiny)
#* For each of rows 2-4 (low/medium/high shiny), the 'alpha blend' and 'alpha mask' objects all appear non-shiny

== Materials Rendering on HUDs ==
Normal and specular maps should not render on objects which are attached as HUDs, due to the lack of lighting sources at the HUD layer (objects tend to render as full bright). However, some of the new alpha modes should effect rendering of HUD objects.
# Take a copy of 'Materials test HUD', which is rezzed at http://maps.secondlife.com/secondlife/Bug%20Island%202/229/253/23 - this object is a linkset of small boxes, with plenty of floating text.
# Enable "Advanced Lighting Model" in your Preferences, under Graphics->Advanced
# Wear the 'Materials test HUD' object from inventory. By default, it should attach to the 'Center' HUD attachment point
# If you have trouble seeing the floating text about each HUD object (the text can be crowded), set 'UI size' to 0.75 under Preferences->Advanced
# Position your camera so that you can see the attachments clearly - I used a blank-textured large prim as background
# Verify that the HUD appears like this screen shot: [[:File:Materials_test_HUD_appearance.png]]
#* Verify that no normal or specular maps appear with the '001' pattern
#** The boxes labelled with 'X gloss, Y env' should be identical to the 'no specular' boxes on the far left column
#** Each of the 'no specular' boxes on the far left column should appear identical to the non-brick 'Water particle 1' objects on the top row
#** In the top row, "No Alpha 'Water Particle 1' with legacy bricks" should look the same as "Emissive Masked 'Water Particle 1' with legacy bricks"
#* Verify that 'Opaque '001' diffuse map with legacy bricks' in the upper-left corner is the only box that has a visible 'bricks' pattern (this is legacy bumpiness)
#* Verify that the other 'with legacy bricks' objects in the top row do *not* have any bumpiness effect, and that the alpha modes render as labelled
#** These objects should have the same appearance as the non-'brick' objects on the right side of the first row
#* Verify that Alpha mode renders correctly
#** Verify that all of the 'opaque' boxes (with the 001 texture) appear fully opaque
#** Verify that all of the 'Alpha blended' objects appear alpha blended (semitransparent, with soft edges)
#** Verify that all of the 'Alpha masked' objects appear alpha masked (semitransparent, with hard edges)
#** Verify that all 'emissive mask' boxes match their corresponding 'alpha none' boxes, since all HUD objects render as fully emissive ('full bright')
#* Verify that legacy shiny objects appear darker than the others
#** Opaque-rendered objects (no alpha, emissive mask, or opaque) set to low/medium/high shiny boxes appear darker than the other boxes
#** The shading should be more severe with increasing shiny level: 'high shiny' objects should be darkest, while 'low shiny' objects should not be so dark
# Disable "Advanced Lighting Model" in your Preferences, under Graphics->Advanced
# Verify that the HUD appears like this screen shot: [[:File:Materials_test_HUD_appearance.png]]
#* Appearance should match what you saw when "Advanced Lighting Model" was enabled

== Materials Rendering on Rigged Meshes ==
TODO

== Rendering of Environment and Exponent Masks ==
TODO

[[Category:QA Portal]]
[[Category:Test Scripts]]

Bug Island Test

2019-04-12T05:59:19Z

Dan Linden: /* Transparency interaction */

[[Category:Test Scripts]]
-In progress-

=== Bump maps ===
====Bump maps look correct====
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/83/22/27 and sit on the red pyramid
* Set Preferences > Graphics Quality to Mid
* Verify the bump map looks the same as this picture.
[[File:Bump_map_spheres.jpg]]

====Custom bump maps load for objects at a distance====
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/75/110/31 and face south.
* Set Preferences > Graphics to Mid.
* Clear the cache (Preferences > Advanced> Clear Cache) and relog.
* Wait for the textures to load on the bumpmapped spheres.
* Fly to the spheres
* Verify the bump map looks the same as the picture above.

====Brightness vs. Darkness bump maps====
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/103/24/27
* Set Set Preferences > Graphics Quality to High
* Verify the wood grain appears indented of the left cube and embossed on the right cube.

=== Texture animation ===

1. http://maps.secondlife.com/secondlife/Bug%20Island/49/15/27
A video should play on the screen in front of you shortly after you arrive. Verify the animations are cycling between the same numbers as the video. You will need to alt-zoom on the boxes to load the textures clearly.

2. http://maps.secondlife.com/secondlife/Bug%20Island/46/16/27
Verify the texture animations matches the video.

3. http://maps.secondlife.com/secondlife/Bug%20Island/42/16/27
Verify the texture animations matches the video.

4. http://maps.secondlife.com/secondlife/Bug%20Island/38/16/27
Verify the texture animations matches the video.

5. http://maps.secondlife.com/secondlife/Bug%20Island/34/15/27
Verify the texture animations matches the video.

6. http://maps.secondlife.com/secondlife/Bug%20Island/27/16/27
Verify the textures are rotating and your viewer does not experience a drop in framerate here.

=== Target Omega ===
1. http://maps.secondlife.com/secondlife/Bug%20Island/29/23/28
Verify the motion matches https://s3-us-west-2.amazonaws.com/lecs-bugislandtests/targetomega1.mov

2. http://maps.secondlife.com/secondlife/Bug%20Island/20/18/28
Verify the motion matches https://s3-us-west-2.amazonaws.com/lecs-bugislandtests/targetomega2.mov

3. http://maps.secondlife.com/secondlife/Bug%20Island/15/18/28
Verify the motion matches https://s3-us-west-2.amazonaws.com/lecs-bugislandtests/targetomega3.mov

4. http://maps.secondlife.com/secondlife/Bug%20Island/23/28/27
Verify the motion matches https://s3-us-west-2.amazonaws.com/lecs-bugislandtests/targetomega4.mov

=== Dynamic texture scaling ===
http://maps.secondlife.com/secondlife/Bug%20Island/45/30/27

Look at the objects with the 1, 2, 3, 4, and 5 textures. Verify the textures scale with the objects as the objects grow taller and shorter.

Look at the objects with the 6 texture. These objects are using Planar texture mapping. Verify the texture changes with the scale of the object, then a moment later rescales to match the object which is not scaling.

=== Prim LOD and bins ===
http://maps.secondlife.com/secondlife/Bug%20Island/32/36/27

* Go to some region other than Bug Island for at least 10 seconds.
* Teleport to http://maps.secondlife.com/secondlife/Bug%20Island/80/36/27 and look West.
* Walk to http://maps.secondlife.com/secondlife/Bug%20Island/32/36/27
* Verify the objects from the 4 left rows appear.
* Verify the farthest 4 small objects in the right row do not appear.

[[File:PrimLOD2.jpg|200px|thumb|none|click for full image]]

=== Texture and color matching ===
http://maps.secondlife.com/secondlife/Bug%20Island/32/50/27

* The wall of objects is made of an object with a white texture and some color next to an object with a texture of the same color and set to a white color. These should match.
* Verify the wall looks the same as the screenshot below.

[[File:Color_and_texture_matching.jpg|200px|thumb|none|click for full image]]

=== Transparency interaction ===
http://maps.secondlife.com/secondlife/Bug%20Island/32/65/27

* Right-click the semitransparent objects.
* Verify objects with semitransparent textures, even 100% transparent, will become selected.
* Verify objects with face transparency (set in the texture tab) of 99% or less will become selected.
* Verify objects with face transparency (set in the texture tab) of 100% will allow the right-click to pass through to the object behind it.

=== HUD (Heads Up Display) effects ===
http://maps.secondlife.com/secondlife/Bug%20Island/31/72/27

Take a copy of the small rotating object on the ground. Wear it to attach it to the top left of your screen.

Verify the following:
* The object does Not emit particles while attached to your HUD.
* The entire object is spinning from left to right.
* The yellow is slightly transparent.
* The yellow cube has one red face and 3 faces with red line.
* The yellow cube has 2 faces with a red "1" texture.
* The "1" texture on the face nearest to the red cube is animating - sliding from left to right.
* The red cube is shiny
* The red cube is spinning on an axis different than the yellow cube
* The red cube has bump maps
* The red cube has an "8" texture on one face and the other faces are the default wood texture.
* The black hover text is visible and is above the blue cube
* The blue cube is twisted
* The blue cube is flexible (this may be hard to see)
* The blue cube is shiny.
* The blue cube is spinning on an axis different than the yellow cube or red cube.

=== Flexible objects ===
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/31/79/27
* Verify the flexy objects look similar to the following screenshot. Note that the top left object may point in a different direction depending on the wind.

[[File:Flexy1.jpg]]

Known issue: Flexible objects which are twisted do not appear twisted when you are zoomed in close. (MAINT-960)

=== Sculpty objects ===

* Go to http://maps.secondlife.com/secondlife/Bug%20Island/100/200/27 and face West.
* Make sure you Draw Distance (in Preferences > Graphics) is set to at least 100m so you can see the sculpty * objects at http://maps.secondlife.com/secondlife/Bug%20Island/17/100/37.
* Clear your SL cache (Preferences > Advanced > Clear Cache) and relog.
* When the sculpties have loaded, fly to http://maps.secondlife.com/secondlife/Bug%20Island/32/99/27 and verify the sculpties look correct like the following screenshot; the shapes should be correct and not just elongated spheres, the surface textures should be loaded.

[[File:Sculpties2.jpg|200px|thumb|none|click for full image]]

* Go to http://maps.secondlife.com/secondlife/Bug%20Island/31/105/27
* Verify the Scultpy objects look like this screenshot.

[[File:Sculpty1.jpg]]

=== Lights ===
http://maps.secondlife.com/secondlife/Bug%20Island/32/131/27
* Set World > Sun > Midnight
* Set Graphics to Mid
* Detach any attachments that are lights.
* There are 8 green lights shining on 8 spheres in front of you, but only 6 lights will show at a time.
* Move back and forth and verify that only 6 of the 8 lights appear at any one time.

=== Small texture loading ===
http://maps.secondlife.com/secondlife/Bug%20Island/32/151/27

* Verify these small textures load quickly.
* Verify these texture appear the same as in the picture below.
[[File:small_textures.png|200px|thumb|none|click for full image]]

=== Parcel based media ===
Some of these tests require QuickTime be installed on your computer.

Type Movie, video/mp4
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/246/214/27
* Verify a mp4 movie starts playing after a few seconds on the boxes with the "8" texture.
* Verify the movie is scaled to fill the face of the box.
* Go out of the parcel so the movie stops.
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/246/208/27
* Verify a mp4 movie starts playing after a few seconds on the boxes with the "8" texture.
* Verify the movie covers only part of the face of the box, and the rest of the face is white.

Type Web Content, text/html
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/242/214/27
* Verify a webpage with a Flash clock appears on the boxes with the "4" texture.
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/242/208/27
* Verify a webpage with a Flash clock appears on the boxes with the "4" texture.
* This will look exactly the same as the previous test.

Bug Island Test

2018-08-30T05:46:10Z

Dan Linden: /* Prim LOD and bins */

[[Category:Test Scripts]]
-In progress-

=== Bump maps ===
====Bump maps look correct====
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/83/22/27 and sit on the red pyramid
* Set Preferences > Graphics Quality to Mid
* Verify the bump map looks the same as this picture.
[[File:Bump_map_spheres.jpg]]

====Custom bump maps load for objects at a distance====
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/75/110/31 and face south.
* Set Preferences > Graphics to Mid.
* Clear the cache (Preferences > Advanced> Clear Cache) and relog.
* Wait for the textures to load on the bumpmapped spheres.
* Fly to the spheres
* Verify the bump map looks the same as the picture above.

====Brightness vs. Darkness bump maps====
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/103/24/27
* Set Set Preferences > Graphics Quality to High
* Verify the wood grain appears indented of the left cube and embossed on the right cube.

=== Texture animation ===

1. http://maps.secondlife.com/secondlife/Bug%20Island/49/15/27
A video should play on the screen in front of you shortly after you arrive. Verify the animations are cycling between the same numbers as the video. You will need to alt-zoom on the boxes to load the textures clearly.

2. http://maps.secondlife.com/secondlife/Bug%20Island/46/16/27
Verify the texture animations matches the video.

3. http://maps.secondlife.com/secondlife/Bug%20Island/42/16/27
Verify the texture animations matches the video.

4. http://maps.secondlife.com/secondlife/Bug%20Island/38/16/27
Verify the texture animations matches the video.

5. http://maps.secondlife.com/secondlife/Bug%20Island/34/15/27
Verify the texture animations matches the video.

6. http://maps.secondlife.com/secondlife/Bug%20Island/27/16/27
Verify the textures are rotating and your viewer does not experience a drop in framerate here.

=== Target Omega ===
1. http://maps.secondlife.com/secondlife/Bug%20Island/29/23/28
Verify the motion matches https://s3-us-west-2.amazonaws.com/lecs-bugislandtests/targetomega1.mov

2. http://maps.secondlife.com/secondlife/Bug%20Island/20/18/28
Verify the motion matches https://s3-us-west-2.amazonaws.com/lecs-bugislandtests/targetomega2.mov

3. http://maps.secondlife.com/secondlife/Bug%20Island/15/18/28
Verify the motion matches https://s3-us-west-2.amazonaws.com/lecs-bugislandtests/targetomega3.mov

4. http://maps.secondlife.com/secondlife/Bug%20Island/23/28/27
Verify the motion matches https://s3-us-west-2.amazonaws.com/lecs-bugislandtests/targetomega4.mov

=== Dynamic texture scaling ===
http://maps.secondlife.com/secondlife/Bug%20Island/45/30/27

Look at the objects with the 1, 2, 3, 4, and 5 textures. Verify the textures scale with the objects as the objects grow taller and shorter.

Look at the objects with the 6 texture. These objects are using Planar texture mapping. Verify the texture changes with the scale of the object, then a moment later rescales to match the object which is not scaling.

=== Prim LOD and bins ===
http://maps.secondlife.com/secondlife/Bug%20Island/32/36/27

* Go to some region other than Bug Island for at least 10 seconds.
* Teleport to http://maps.secondlife.com/secondlife/Bug%20Island/80/36/27 and look West.
* Walk to http://maps.secondlife.com/secondlife/Bug%20Island/32/36/27
* Verify the objects from the 4 left rows appear.
* Verify the farthest 4 small objects in the right row do not appear.

[[File:PrimLOD2.jpg|200px|thumb|none|click for full image]]

=== Texture and color matching ===
http://maps.secondlife.com/secondlife/Bug%20Island/32/50/27

* The wall of objects is made of an object with a white texture and some color next to an object with a texture of the same color and set to a white color. These should match.
* Verify the wall looks the same as the screenshot below.

[[File:Color_and_texture_matching.jpg|200px|thumb|none|click for full image]]

=== Transparency interaction ===
http://maps.secondlife.com/secondlife/Bug%20Island/32/65/27

* Right-click the semitransparent objects.
* Verify objects with textures 87% or less transparent will become selected.
* Verify objects with textures 88% or more transparent will allow the right-click to pass through to the object behind it.

=== HUD (Heads Up Display) effects ===
http://maps.secondlife.com/secondlife/Bug%20Island/31/72/27

Take a copy of the small rotating object on the ground. Wear it to attach it to the top left of your screen.

Verify the following:
* The object does Not emit particles while attached to your HUD.
* The entire object is spinning from left to right.
* The yellow is slightly transparent.
* The yellow cube has one red face and 3 faces with red line.
* The yellow cube has 2 faces with a red "1" texture.
* The "1" texture on the face nearest to the red cube is animating - sliding from left to right.
* The red cube is shiny
* The red cube is spinning on an axis different than the yellow cube
* The red cube has bump maps
* The red cube has an "8" texture on one face and the other faces are the default wood texture.
* The black hover text is visible and is above the blue cube
* The blue cube is twisted
* The blue cube is flexible (this may be hard to see)
* The blue cube is shiny.
* The blue cube is spinning on an axis different than the yellow cube or red cube.

=== Flexible objects ===
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/31/79/27
* Verify the flexy objects look similar to the following screenshot. Note that the top left object may point in a different direction depending on the wind.

[[File:Flexy1.jpg]]

Known issue: Flexible objects which are twisted do not appear twisted when you are zoomed in close. (MAINT-960)

=== Sculpty objects ===

* Go to http://maps.secondlife.com/secondlife/Bug%20Island/100/200/27 and face West.
* Make sure you Draw Distance (in Preferences > Graphics) is set to at least 100m so you can see the sculpty * objects at http://maps.secondlife.com/secondlife/Bug%20Island/17/100/37.
* Clear your SL cache (Preferences > Advanced > Clear Cache) and relog.
* When the sculpties have loaded, fly to http://maps.secondlife.com/secondlife/Bug%20Island/32/99/27 and verify the sculpties look correct like the following screenshot; the shapes should be correct and not just elongated spheres, the surface textures should be loaded.

[[File:Sculpties2.jpg|200px|thumb|none|click for full image]]

* Go to http://maps.secondlife.com/secondlife/Bug%20Island/31/105/27
* Verify the Scultpy objects look like this screenshot.

[[File:Sculpty1.jpg]]

=== Lights ===
http://maps.secondlife.com/secondlife/Bug%20Island/32/131/27
* Set World > Sun > Midnight
* Set Graphics to Mid
* Detach any attachments that are lights.
* There are 8 green lights shining on 8 spheres in front of you, but only 6 lights will show at a time.
* Move back and forth and verify that only 6 of the 8 lights appear at any one time.

=== Small texture loading ===
http://maps.secondlife.com/secondlife/Bug%20Island/32/151/27

* Verify these small textures load quickly.
* Verify these texture appear the same as in the picture below.
[[File:small_textures.png|200px|thumb|none|click for full image]]

=== Parcel based media ===
Some of these tests require QuickTime be installed on your computer.

Type Movie, video/mp4
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/246/214/27
* Verify a mp4 movie starts playing after a few seconds on the boxes with the "8" texture.
* Verify the movie is scaled to fill the face of the box.
* Go out of the parcel so the movie stops.
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/246/208/27
* Verify a mp4 movie starts playing after a few seconds on the boxes with the "8" texture.
* Verify the movie covers only part of the face of the box, and the rest of the face is white.

Type Web Content, text/html
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/242/214/27
* Verify a webpage with a Flash clock appears on the boxes with the "4" texture.
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/242/208/27
* Verify a webpage with a Flash clock appears on the boxes with the "4" texture.
* This will look exactly the same as the previous test.

Bug Island Test

2018-08-29T06:56:53Z

Dan Linden: /* Parcel based media */

[[Category:Test Scripts]]
-In progress-

=== Bump maps ===
====Bump maps look correct====
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/83/22/27 and sit on the red pyramid
* Set Preferences > Graphics Quality to Mid
* Verify the bump map looks the same as this picture.
[[File:Bump_map_spheres.jpg]]

====Custom bump maps load for objects at a distance====
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/75/110/31 and face south.
* Set Preferences > Graphics to Mid.
* Clear the cache (Preferences > Advanced> Clear Cache) and relog.
* Wait for the textures to load on the bumpmapped spheres.
* Fly to the spheres
* Verify the bump map looks the same as the picture above.

====Brightness vs. Darkness bump maps====
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/103/24/27
* Set Set Preferences > Graphics Quality to High
* Verify the wood grain appears indented of the left cube and embossed on the right cube.

=== Texture animation ===

1. http://maps.secondlife.com/secondlife/Bug%20Island/49/15/27
A video should play on the screen in front of you shortly after you arrive. Verify the animations are cycling between the same numbers as the video. You will need to alt-zoom on the boxes to load the textures clearly.

2. http://maps.secondlife.com/secondlife/Bug%20Island/46/16/27
Verify the texture animations matches the video.

3. http://maps.secondlife.com/secondlife/Bug%20Island/42/16/27
Verify the texture animations matches the video.

4. http://maps.secondlife.com/secondlife/Bug%20Island/38/16/27
Verify the texture animations matches the video.

5. http://maps.secondlife.com/secondlife/Bug%20Island/34/15/27
Verify the texture animations matches the video.

6. http://maps.secondlife.com/secondlife/Bug%20Island/27/16/27
Verify the textures are rotating and your viewer does not experience a drop in framerate here.

=== Target Omega ===
1. http://maps.secondlife.com/secondlife/Bug%20Island/29/23/28
Verify the motion matches https://s3-us-west-2.amazonaws.com/lecs-bugislandtests/targetomega1.mov

2. http://maps.secondlife.com/secondlife/Bug%20Island/20/18/28
Verify the motion matches https://s3-us-west-2.amazonaws.com/lecs-bugislandtests/targetomega2.mov

3. http://maps.secondlife.com/secondlife/Bug%20Island/15/18/28
Verify the motion matches https://s3-us-west-2.amazonaws.com/lecs-bugislandtests/targetomega3.mov

4. http://maps.secondlife.com/secondlife/Bug%20Island/23/28/27
Verify the motion matches https://s3-us-west-2.amazonaws.com/lecs-bugislandtests/targetomega4.mov

=== Dynamic texture scaling ===
http://maps.secondlife.com/secondlife/Bug%20Island/45/30/27

Look at the objects with the 1, 2, 3, 4, and 5 textures. Verify the textures scale with the objects as the objects grow taller and shorter.

Look at the objects with the 6 texture. These objects are using Planar texture mapping. Verify the texture changes with the scale of the object, then a moment later rescales to match the object which is not scaling.

=== Prim LOD and bins ===
http://maps.secondlife.com/secondlife/Bug%20Island/32/36/27

* Go to http://maps.secondlife.com/secondlife/Bug%20Island/80/36/27 and look West.
* Walk to http://maps.secondlife.com/secondlife/Bug%20Island/32/36/27
* Verify the objects from the 4 left rows appear.
* Verify the farthest 4 small objects in the right row do not appear.

[[File:PrimLOD2.jpg|200px|thumb|none|click for full image]]

=== Texture and color matching ===
http://maps.secondlife.com/secondlife/Bug%20Island/32/50/27

* The wall of objects is made of an object with a white texture and some color next to an object with a texture of the same color and set to a white color. These should match.
* Verify the wall looks the same as the screenshot below.

[[File:Color_and_texture_matching.jpg|200px|thumb|none|click for full image]]

=== Transparency interaction ===
http://maps.secondlife.com/secondlife/Bug%20Island/32/65/27

* Right-click the semitransparent objects.
* Verify objects with textures 87% or less transparent will become selected.
* Verify objects with textures 88% or more transparent will allow the right-click to pass through to the object behind it.

=== HUD (Heads Up Display) effects ===
http://maps.secondlife.com/secondlife/Bug%20Island/31/72/27

Take a copy of the small rotating object on the ground. Wear it to attach it to the top left of your screen.

Verify the following:
* The object does Not emit particles while attached to your HUD.
* The entire object is spinning from left to right.
* The yellow is slightly transparent.
* The yellow cube has one red face and 3 faces with red line.
* The yellow cube has 2 faces with a red "1" texture.
* The "1" texture on the face nearest to the red cube is animating - sliding from left to right.
* The red cube is shiny
* The red cube is spinning on an axis different than the yellow cube
* The red cube has bump maps
* The red cube has an "8" texture on one face and the other faces are the default wood texture.
* The black hover text is visible and is above the blue cube
* The blue cube is twisted
* The blue cube is flexible (this may be hard to see)
* The blue cube is shiny.
* The blue cube is spinning on an axis different than the yellow cube or red cube.

=== Flexible objects ===
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/31/79/27
* Verify the flexy objects look similar to the following screenshot. Note that the top left object may point in a different direction depending on the wind.

[[File:Flexy1.jpg]]

Known issue: Flexible objects which are twisted do not appear twisted when you are zoomed in close. (MAINT-960)

=== Sculpty objects ===

* Go to http://maps.secondlife.com/secondlife/Bug%20Island/100/200/27 and face West.
* Make sure you Draw Distance (in Preferences > Graphics) is set to at least 100m so you can see the sculpty * objects at http://maps.secondlife.com/secondlife/Bug%20Island/17/100/37.
* Clear your SL cache (Preferences > Advanced > Clear Cache) and relog.
* When the sculpties have loaded, fly to http://maps.secondlife.com/secondlife/Bug%20Island/32/99/27 and verify the sculpties look correct like the following screenshot; the shapes should be correct and not just elongated spheres, the surface textures should be loaded.

[[File:Sculpties2.jpg|200px|thumb|none|click for full image]]

* Go to http://maps.secondlife.com/secondlife/Bug%20Island/31/105/27
* Verify the Scultpy objects look like this screenshot.

[[File:Sculpty1.jpg]]

=== Lights ===
http://maps.secondlife.com/secondlife/Bug%20Island/32/131/27
* Set World > Sun > Midnight
* Set Graphics to Mid
* Detach any attachments that are lights.
* There are 8 green lights shining on 8 spheres in front of you, but only 6 lights will show at a time.
* Move back and forth and verify that only 6 of the 8 lights appear at any one time.

=== Small texture loading ===
http://maps.secondlife.com/secondlife/Bug%20Island/32/151/27

* Verify these small textures load quickly.
* Verify these texture appear the same as in the picture below.
[[File:small_textures.png|200px|thumb|none|click for full image]]

=== Parcel based media ===
Some of these tests require QuickTime be installed on your computer.

Type Movie, video/mp4
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/246/214/27
* Verify a mp4 movie starts playing after a few seconds on the boxes with the "8" texture.
* Verify the movie is scaled to fill the face of the box.
* Go out of the parcel so the movie stops.
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/246/208/27
* Verify a mp4 movie starts playing after a few seconds on the boxes with the "8" texture.
* Verify the movie covers only part of the face of the box, and the rest of the face is white.

Type Web Content, text/html
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/242/214/27
* Verify a webpage with a Flash clock appears on the boxes with the "4" texture.
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/242/208/27
* Verify a webpage with a Flash clock appears on the boxes with the "4" texture.
* This will look exactly the same as the previous test.

Bug Island Test

2018-08-15T22:35:54Z

Dan Linden: /* Lights */

[[Category:Test Scripts]]
-In progress-

=== Bump maps ===
====Bump maps look correct====
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/83/22/27 and sit on the red pyramid
* Set Preferences > Graphics Quality to Mid
* Verify the bump map looks the same as this picture.
[[File:Bump_map_spheres.jpg]]

====Custom bump maps load for objects at a distance====
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/75/110/31 and face south.
* Set Preferences > Graphics to Mid.
* Clear the cache (Preferences > Advanced> Clear Cache) and relog.
* Wait for the textures to load on the bumpmapped spheres.
* Fly to the spheres
* Verify the bump map looks the same as the picture above.

====Brightness vs. Darkness bump maps====
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/103/24/27
* Set Set Preferences > Graphics Quality to High
* Verify the wood grain appears indented of the left cube and embossed on the right cube.

=== Texture animation ===

1. http://maps.secondlife.com/secondlife/Bug%20Island/49/15/27
A video should play on the screen in front of you shortly after you arrive. Verify the animations are cycling between the same numbers as the video. You will need to alt-zoom on the boxes to load the textures clearly.

2. http://maps.secondlife.com/secondlife/Bug%20Island/46/16/27
Verify the texture animations matches the video.

3. http://maps.secondlife.com/secondlife/Bug%20Island/42/16/27
Verify the texture animations matches the video.

4. http://maps.secondlife.com/secondlife/Bug%20Island/38/16/27
Verify the texture animations matches the video.

5. http://maps.secondlife.com/secondlife/Bug%20Island/34/15/27
Verify the texture animations matches the video.

6. http://maps.secondlife.com/secondlife/Bug%20Island/27/16/27
Verify the textures are rotating and your viewer does not experience a drop in framerate here.

=== Target Omega ===
1. http://maps.secondlife.com/secondlife/Bug%20Island/29/23/28
Verify the motion matches https://s3-us-west-2.amazonaws.com/lecs-bugislandtests/targetomega1.mov

2. http://maps.secondlife.com/secondlife/Bug%20Island/20/18/28
Verify the motion matches https://s3-us-west-2.amazonaws.com/lecs-bugislandtests/targetomega2.mov

3. http://maps.secondlife.com/secondlife/Bug%20Island/15/18/28
Verify the motion matches https://s3-us-west-2.amazonaws.com/lecs-bugislandtests/targetomega3.mov

4. http://maps.secondlife.com/secondlife/Bug%20Island/23/28/27
Verify the motion matches https://s3-us-west-2.amazonaws.com/lecs-bugislandtests/targetomega4.mov

=== Dynamic texture scaling ===
http://maps.secondlife.com/secondlife/Bug%20Island/45/30/27

Look at the objects with the 1, 2, 3, 4, and 5 textures. Verify the textures scale with the objects as the objects grow taller and shorter.

Look at the objects with the 6 texture. These objects are using Planar texture mapping. Verify the texture changes with the scale of the object, then a moment later rescales to match the object which is not scaling.

=== Prim LOD and bins ===
http://maps.secondlife.com/secondlife/Bug%20Island/32/36/27

* Go to http://maps.secondlife.com/secondlife/Bug%20Island/80/36/27 and look West.
* Walk to http://maps.secondlife.com/secondlife/Bug%20Island/32/36/27
* Verify the objects from the 4 left rows appear.
* Verify the farthest 4 small objects in the right row do not appear.

[[File:PrimLOD2.jpg|200px|thumb|none|click for full image]]

=== Texture and color matching ===
http://maps.secondlife.com/secondlife/Bug%20Island/32/50/27

* The wall of objects is made of an object with a white texture and some color next to an object with a texture of the same color and set to a white color. These should match.
* Verify the wall looks the same as the screenshot below.

[[File:Color_and_texture_matching.jpg|200px|thumb|none|click for full image]]

=== Transparency interaction ===
http://maps.secondlife.com/secondlife/Bug%20Island/32/65/27

* Right-click the semitransparent objects.
* Verify objects with textures 87% or less transparent will become selected.
* Verify objects with textures 88% or more transparent will allow the right-click to pass through to the object behind it.

=== HUD (Heads Up Display) effects ===
http://maps.secondlife.com/secondlife/Bug%20Island/31/72/27

Take a copy of the small rotating object on the ground. Wear it to attach it to the top left of your screen.

Verify the following:
* The object does Not emit particles while attached to your HUD.
* The entire object is spinning from left to right.
* The yellow is slightly transparent.
* The yellow cube has one red face and 3 faces with red line.
* The yellow cube has 2 faces with a red "1" texture.
* The "1" texture on the face nearest to the red cube is animating - sliding from left to right.
* The red cube is shiny
* The red cube is spinning on an axis different than the yellow cube
* The red cube has bump maps
* The red cube has an "8" texture on one face and the other faces are the default wood texture.
* The black hover text is visible and is above the blue cube
* The blue cube is twisted
* The blue cube is flexible (this may be hard to see)
* The blue cube is shiny.
* The blue cube is spinning on an axis different than the yellow cube or red cube.

=== Flexible objects ===
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/31/79/27
* Verify the flexy objects look similar to the following screenshot. Note that the top left object may point in a different direction depending on the wind.

[[File:Flexy1.jpg]]

Known issue: Flexible objects which are twisted do not appear twisted when you are zoomed in close. (MAINT-960)

=== Sculpty objects ===

* Go to http://maps.secondlife.com/secondlife/Bug%20Island/100/200/27 and face West.
* Make sure you Draw Distance (in Preferences > Graphics) is set to at least 100m so you can see the sculpty * objects at http://maps.secondlife.com/secondlife/Bug%20Island/17/100/37.
* Clear your SL cache (Preferences > Advanced > Clear Cache) and relog.
* When the sculpties have loaded, fly to http://maps.secondlife.com/secondlife/Bug%20Island/32/99/27 and verify the sculpties look correct like the following screenshot; the shapes should be correct and not just elongated spheres, the surface textures should be loaded.

[[File:Sculpties2.jpg|200px|thumb|none|click for full image]]

* Go to http://maps.secondlife.com/secondlife/Bug%20Island/31/105/27
* Verify the Scultpy objects look like this screenshot.

[[File:Sculpty1.jpg]]

=== Lights ===
http://maps.secondlife.com/secondlife/Bug%20Island/32/131/27
* Set World > Sun > Midnight
* Set Graphics to Mid
* Detach any attachments that are lights.
* There are 8 green lights shining on 8 spheres in front of you, but only 6 lights will show at a time.
* Move back and forth and verify that only 6 of the 8 lights appear at any one time.

=== Small texture loading ===
http://maps.secondlife.com/secondlife/Bug%20Island/32/151/27

* Verify these small textures load quickly.
* Verify these texture appear the same as in the picture below.
[[File:small_textures.png|200px|thumb|none|click for full image]]

=== Parcel based media ===
Some of these tests require QuickTime be installed on your computer.

Type Movie, video/mp4
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/246/214/27
* Verify a mp4 movie starts playing after a few seconds on the boxes with the "4" texture.
* Verify the movie is scaled to fill the face of the box.
* Go out of the parcel so the movie stops.
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/246/208/27
* Verify a mp4 movie starts playing after a few seconds on the boxes with the "4" texture.
* Verify the movie covers only part of the face of the box, and the rest of the face is white.

Type Web Content, text/html
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/242/214/27
* Verify a webpage with a Flash clock appears on the boxes with the "4" texture.
* Go to http://maps.secondlife.com/secondlife/Bug%20Island/242/208/27
* Verify a webpage with a Flash clock appears on the boxes with the "4" texture.
* This will look exactly the same as the previous test.

Animesh Test

2018-06-18T18:51:02Z

Dan Linden: /* Wear an animesh */

[[Category:Test Plans]]
[[Category:Content Tools]]

=NOTE: This test supports the new features of the Animesh viewer currently (March 2018) available for testing at [[Linden_Lab_Official:Alternate_Viewers]].=

==Purpose==
Test all functionality of the Animesh viewer.

==Test Plan==

===Stop / Start animation with LSL===
Test is at secondlife://Aditi/secondlife/Animesh2/7/247/23
* Click the black monolith and choose to start animations from the menu.
* Verify the Animesh model animates.
* Click the black monolith and choose to stop animations
* Verify the Animesh model stops animating.
* Click the black monolith and choose to start animations.
* Relog.
* Verify the Animesh model is animating.
* Move to an adjacent region
* Verify the Animesh model is still animating.
* Relog.
* Verify the Animesh model is animating when viewed from an adjacent region.
* Click the black monolith and choose to stop animations
* Verify Animesh model stops animating.
* Click the black monolith and choose to start animations.
* Verify Animesh model animates.

===Non-root prims in an animated object should be able to start and stop animations===
Test is at secondlife://Aditi/secondlife/Animesh2/23/249/23
* Click the black monolith and choose to start animations.
* Verify the Animesh model animates.
* Click the black monolith and choose to stop animations
* Verify the Animesh model stops animating.

===Any animation triggered by any prim can drive any bone in the skeleton===
Test is at secondlife://Aditi/secondlife/Animesh2/37/249/23
* Click the black monolith and choose to start animations.
* Verify the man animates typing and turning at the same time. (Two scripts in the 2 boxes are playing animations on the skeleton.)
* Click the black monolith and choose to stop animations
* Verify the man stops animating.

===Animated objects should play only requested animations===
Test is at secondlife://Aditi/secondlife/Animesh2/37/249/23
* Enable Develop menu -> Avatar -> Animation info
* Click the black monolith and choose to start animations.
* Verify only 2 animations appear above the Animesh, then disappear, then repeat.

===An avatar may wear 1 Animesh object===
* Test is at secondlife://Aditi/secondlife/Animesh2/65/247/23
* Take 3 copies of the Teddy bear to your inventory.
* Attempt to add the 3 Teddy bears to different attachment points of your avatar.
* Verify this fails with an error that explains you cannot attach more animated objects. (Current limit is 1 - 2017/11/9)

===Teleport while wearing an animesh===
* Wear an animesh that animates. (e.g. the Teddy bear)
* Teleport to a far region, one that is not adjacent or kitty corner.
* Verify the animesh attachment continues to animate as expected. (e.g. the Teddy bear hold your hand and nods its head)
* Log an observer in and verify the attached animesh looks the same to them.
* Wait 1 minute before teleporting back.
* Teleport back to the original location.
* Verify the animesh attachment continues to animate as expected. (e.g. the Teddy bear hold your hand and nods its head)

===Log in while wearing an animesh===
* While wearing an animesh that animates (e.g. the Teddy bear), log out.
* Log an observer in.
* Log in the avatar wearing the animesh
* Verify the animesh attachment continues to animate as expected. (e.g. the Teddy bear hold your hand and nods its head)
* Verify the observe sees the same thing.
* Sit on an animesh
* Go to secondlife://Aditi/secondlife/Animesh2/78/247/23
* Take a copy of the animesh raptor.
* Rez the raptor.
* Right-click it and select Ride.
* Verify your avatar sits on the raptor.

===Sit on an animesh while wearing an animesh===
* While sitting on an animating animesh, attach an animating animesh.
* Verify the two animesh are animating.
* Log in an observer on an adjacent region
* Verify the observer sees the same thing.
* Log in an observer with a viewer that does not support Animesh (eg. http://wiki.secondlife.com/wiki/Release_Notes/Second_Life_Release/5.1.2.512803 ).
* Verify the observer sees the two animesh are but they are not animating.
* Verify the avatar is bent to to the shape of the animesh they are wearing. This is expected.

===Get list of currently playing animations===
Go to secondlife://Aditi/secondlife/Animesh2/7/247/23
* Take a copy of an Animesh object that is playing animations
* Rez the Animesh object.
* Add the following script to the Animesh object.
<pre>
default
{
state_entry()
{
llSay(0, "Hello, Avatar!");
llSetTimerEvent(1);
}
timer()
{
list curr_anims = llGetObjectAnimationNames();
llOwnerSay("curr_anims are " + (string) curr_anims);
}
}
</pre>
* Verify all playing animations are listed while it is animating and none are listed while animations not playing
* Cleanup: delete the animesh object.

===Enabling and Disabling Animated Mesh===
* Rez a copy of the bear from secondlife://Aditi/secondlife/Animesh2/90/247/23
* If the bear is not already dancing, click it to make it dance.
* Edit your bear, and uncheck the Animated Mesh checkbox
* Verify the bear stops dancing and is now in a T-pose.
* Verify observers see the same thing you do.
* Wear the default male avatar from Library / Clothing / Older Outfits / Boy Next Door
* Wear the bear on your right hand and walk around.
* Verify your avatar looks like a bear.
[[Image:Bear1.png]]
* Verify observers see the same thing you do.
* Edit the bear you are wearing and check the Animated Mesh checkbox.
* Verify the bear now appears attached to your hand and starts dancing
* Verify observers see the same thing you do.
* Edit the bear you are wearing and uncheck the Animated Mesh checkbox. Deselect the mesh.
* Verify your avatar looks like a bear again.
* Verify observers see the same thing you do.
* Detach the bear to Inventory
* Rez the bear on the ground.
* Verify the bear is in a T-pose, arms stretched to the sides.
* Edit your bear, and check the Animated Mesh checkbox
* If the bear is not already dancing, click it to make it dance.
* Verify observers see the same thing you do.
* Take a copy of box1 at secondlife://Aditi/secondlife/Animesh2/92/247/23 and rez it.
* Verify the Animated Mesh checkbox cannot be modified because you do not have modify permissions for the object.
* Take a copy of boxes2 at secondlife://Aditi/secondlife/Animesh2/95/248/23
* Verify the Animated Mesh checkbox can only be modified if you are modifying the whole linkset. If you are editing component prims ("Edit linked"), the Animated Mesh box should be disabled.
* Right-click edit the bear at secondlife://Aditi/secondlife/Animesh2/90/247/23
* Verify you can see the Animated Mesh checkbox is checked and grayed out.
* Take a copy of the Animesh man at secondlife://Aditi/secondlife/Animesh2/7/247/23
* Rez the Animesh man
* Enable Develop > Render Metadata > Joints (requires Preferences > Advanced > Show Develop Menu)
* Verify joints are visible for the man and in addition joints for wings, tail, and rear legs.
* Disable Animated Mesh.
* Verify the joints are no longer visible on the Animesh man.
* Create a cube and enable Animated Mesh
* Verify no joints are visible for the cube.
* Disable Develop > Render Metadata > Joints

===Animated mesh can be rezzed from object inventory.===
* Go to secondlife://Aditi/secondlife/Animesh2/101/248/23
* Take a copy of the popgun.
* Attach the popgun, press M to enter mouselook mode, and left-click to fire.
* Verify you see Raptors drop out of the gun and walk around.

===Selection and Editing===
* Verify you can select an animating Animesh by dragging a selection box around it while the Edit Tools (ctrl+3) are open.
* Verify all selected animated objects pause all of their animations for the person selecting them.
* Verify observers see the selected Animesh continue to animate.
* Unselecting any animated object should resume its animations.
* Verify you can select an animating Animesh with left-click while the Edit Tools (ctrl+3) are open. (known issue MAINT-7709)
* Verify you can select an animating Animesh with right-click. The standard object right-click menu will appear and the object will be shown with a wireframe.
* Verify selecting an animated object via the Build menu -> Region Objects floater behaves similarly - the animation is stopped. (This is only testable if you are estate owner or manager or parcel owner)
* Editing the translation and rotation of an animated object should work.
* Editing the scale of an animated object will not work.
* Moving an Animesh object across region boundaries while editing should work.

===Agent related text and controls should be hidden for Animesh===
* Hover the mouse cursor over the Animesh man at secondlife://Aditi/secondlife/Animesh2/7/247/23
* Verify that no hovertext appears about the object (This differs from regular objects.)
* Right-click the Animesh man and inspect the right-click menu.
* Verify there are no Agent related menu items, such as View Profile, Add friend, IM, Call, etc.
* Verify the right-click menu is a typical Object context menu.
[[Image:Animesh right-click1.png]]

===New Diagnostic Displays===
* Verify the following diagnostics display.
* A new debug setting DebugAnimatedObjects defaults to false but can be set to true. This will display additional information in the debug text by each animated object.
* Develop->Render Metadata->Triangle count gives triangle information for objects in the scene. Shows a triangle count for the current LOD. Not restricted to animated objects.
* Develop->Render Metadata->Collision Skeleton will show the collision volumes for animated objects in red (avatars are blue)
* Develop->Avatar->Animation info will display any animations currently playing for an animated object, as it always has for avatars.

===Animated objects should be able to cross region boundaries as directed by a script===
* Go to secondlife://Aditi/secondlife/Animesh2/75/247/23
* Take a copy of the raptor and rez it.
* The Raptor has the Kart script in it. The Kart script is from the Library/Objects/Kart 1.0 object.
* Right-click the raptor and Ride
* Use the arrows to drive and the Page Down or C key to reset if it tips over.
* Verify you can drive the raptor around the region
* Verify you can drive the raptor to an adjacent region.

===Animated objects should continue to play animations after crossing a region boundary===
* Same as "Animated objects should be able to cross region boundaries as directed by a script" test.
* Verify that the Raptor continues to animate after crossing the region boundary.

Animesh Test

2018-06-18T07:17:16Z

Dan Linden: /* Enabling and Disabling Animated Mesh */

[[Category:Test Plans]]
[[Category:Content Tools]]

=NOTE: This test supports the new features of the Animesh viewer currently (March 2018) available for testing at [[Linden_Lab_Official:Alternate_Viewers]].=

==Purpose==
Test all functionality of the Animesh viewer.

==Test Plan==

===Stop / Start animation with LSL===
Test is at secondlife://Aditi/secondlife/Animesh2/7/247/23
* Click the black monolith and choose to start animations from the menu.
* Verify the Animesh model animates.
* Click the black monolith and choose to stop animations
* Verify the Animesh model stops animating.
* Click the black monolith and choose to start animations.
* Relog.
* Verify the Animesh model is animating.
* Move to an adjacent region
* Verify the Animesh model is still animating.
* Relog.
* Verify the Animesh model is animating when viewed from an adjacent region.
* Click the black monolith and choose to stop animations
* Verify Animesh model stops animating.
* Click the black monolith and choose to start animations.
* Verify Animesh model animates.

===Non-root prims in an animated object should be able to start and stop animations===
Test is at secondlife://Aditi/secondlife/Animesh2/23/249/23
* Click the black monolith and choose to start animations.
* Verify the Animesh model animates.
* Click the black monolith and choose to stop animations
* Verify the Animesh model stops animating.

===Any animation triggered by any prim can drive any bone in the skeleton===
Test is at secondlife://Aditi/secondlife/Animesh2/37/249/23
* Click the black monolith and choose to start animations.
* Verify the man animates typing and turning at the same time. (Two scripts in the 2 boxes are playing animations on the skeleton.)
* Click the black monolith and choose to stop animations
* Verify the man stops animating.

===Animated objects should play only requested animations===
Test is at secondlife://Aditi/secondlife/Animesh2/37/249/23
* Enable Develop menu -> Avatar -> Animation info
* Click the black monolith and choose to start animations.
* Verify only 2 animations appear above the Animesh, then disappear, then repeat.

===Wear an animesh===
* Test is at secondlife://Aditi/secondlife/Animesh2/65/247/23
* Take 3 copies of the Teddy bear to your inventory.
* Attempt to add the 3 Teddy bears to different attachment points of your avatar.
* Verify this fails with an error that explains you cannot attach more animated objects. (Current limit is 1 - 2017/11/9)

===Teleport while wearing an animesh===
* Wear an animesh that animates. (e.g. the Teddy bear)
* Teleport to a far region, one that is not adjacent or kitty corner.
* Verify the animesh attachment continues to animate as expected. (e.g. the Teddy bear hold your hand and nods its head)
* Log an observer in and verify the attached animesh looks the same to them.
* Wait 1 minute before teleporting back.
* Teleport back to the original location.
* Verify the animesh attachment continues to animate as expected. (e.g. the Teddy bear hold your hand and nods its head)

===Log in while wearing an animesh===
* While wearing an animesh that animates (e.g. the Teddy bear), log out.
* Log an observer in.
* Log in the avatar wearing the animesh
* Verify the animesh attachment continues to animate as expected. (e.g. the Teddy bear hold your hand and nods its head)
* Verify the observe sees the same thing.
* Sit on an animesh
* Go to secondlife://Aditi/secondlife/Animesh2/78/247/23
* Take a copy of the animesh raptor.
* Rez the raptor.
* Right-click it and select Ride.
* Verify your avatar sits on the raptor.

===Sit on an animesh while wearing an animesh===
* While sitting on an animating animesh, attach an animating animesh.
* Verify the two animesh are animating.
* Log in an observer on an adjacent region
* Verify the observer sees the same thing.
* Log in an observer with a viewer that does not support Animesh (eg. http://wiki.secondlife.com/wiki/Release_Notes/Second_Life_Release/5.1.2.512803 ).
* Verify the observer sees the two animesh are but they are not animating.
* Verify the avatar is bent to to the shape of the animesh they are wearing. This is expected.

===Get list of currently playing animations===
Go to secondlife://Aditi/secondlife/Animesh2/7/247/23
* Take a copy of an Animesh object that is playing animations
* Rez the Animesh object.
* Add the following script to the Animesh object.
<pre>
default
{
state_entry()
{
llSay(0, "Hello, Avatar!");
llSetTimerEvent(1);
}
timer()
{
list curr_anims = llGetObjectAnimationNames();
llOwnerSay("curr_anims are " + (string) curr_anims);
}
}
</pre>
* Verify all playing animations are listed while it is animating and none are listed while animations not playing
* Cleanup: delete the animesh object.

===Enabling and Disabling Animated Mesh===
* Rez a copy of the bear from secondlife://Aditi/secondlife/Animesh2/90/247/23
* If the bear is not already dancing, click it to make it dance.
* Edit your bear, and uncheck the Animated Mesh checkbox
* Verify the bear stops dancing and is now in a T-pose.
* Verify observers see the same thing you do.
* Wear the default male avatar from Library / Clothing / Older Outfits / Boy Next Door
* Wear the bear on your right hand and walk around.
* Verify your avatar looks like a bear.
[[Image:Bear1.png]]
* Verify observers see the same thing you do.
* Edit the bear you are wearing and check the Animated Mesh checkbox.
* Verify the bear now appears attached to your hand and starts dancing
* Verify observers see the same thing you do.
* Edit the bear you are wearing and uncheck the Animated Mesh checkbox. Deselect the mesh.
* Verify your avatar looks like a bear again.
* Verify observers see the same thing you do.
* Detach the bear to Inventory
* Rez the bear on the ground.
* Verify the bear is in a T-pose, arms stretched to the sides.
* Edit your bear, and check the Animated Mesh checkbox
* If the bear is not already dancing, click it to make it dance.
* Verify observers see the same thing you do.
* Take a copy of box1 at secondlife://Aditi/secondlife/Animesh2/92/247/23 and rez it.
* Verify the Animated Mesh checkbox cannot be modified because you do not have modify permissions for the object.
* Take a copy of boxes2 at secondlife://Aditi/secondlife/Animesh2/95/248/23
* Verify the Animated Mesh checkbox can only be modified if you are modifying the whole linkset. If you are editing component prims ("Edit linked"), the Animated Mesh box should be disabled.
* Right-click edit the bear at secondlife://Aditi/secondlife/Animesh2/90/247/23
* Verify you can see the Animated Mesh checkbox is checked and grayed out.
* Take a copy of the Animesh man at secondlife://Aditi/secondlife/Animesh2/7/247/23
* Rez the Animesh man
* Enable Develop > Render Metadata > Joints (requires Preferences > Advanced > Show Develop Menu)
* Verify joints are visible for the man and in addition joints for wings, tail, and rear legs.
* Disable Animated Mesh.
* Verify the joints are no longer visible on the Animesh man.
* Create a cube and enable Animated Mesh
* Verify no joints are visible for the cube.
* Disable Develop > Render Metadata > Joints

===Animated mesh can be rezzed from object inventory.===
* Go to secondlife://Aditi/secondlife/Animesh2/101/248/23
* Take a copy of the popgun.
* Attach the popgun, press M to enter mouselook mode, and left-click to fire.
* Verify you see Raptors drop out of the gun and walk around.

===Selection and Editing===
* Verify you can select an animating Animesh by dragging a selection box around it while the Edit Tools (ctrl+3) are open.
* Verify all selected animated objects pause all of their animations for the person selecting them.
* Verify observers see the selected Animesh continue to animate.
* Unselecting any animated object should resume its animations.
* Verify you can select an animating Animesh with left-click while the Edit Tools (ctrl+3) are open. (known issue MAINT-7709)
* Verify you can select an animating Animesh with right-click. The standard object right-click menu will appear and the object will be shown with a wireframe.
* Verify selecting an animated object via the Build menu -> Region Objects floater behaves similarly - the animation is stopped. (This is only testable if you are estate owner or manager or parcel owner)
* Editing the translation and rotation of an animated object should work.
* Editing the scale of an animated object will not work.
* Moving an Animesh object across region boundaries while editing should work.

===Agent related text and controls should be hidden for Animesh===
* Hover the mouse cursor over the Animesh man at secondlife://Aditi/secondlife/Animesh2/7/247/23
* Verify that no hovertext appears about the object (This differs from regular objects.)
* Right-click the Animesh man and inspect the right-click menu.
* Verify there are no Agent related menu items, such as View Profile, Add friend, IM, Call, etc.
* Verify the right-click menu is a typical Object context menu.
[[Image:Animesh right-click1.png]]

===New Diagnostic Displays===
* Verify the following diagnostics display.
* A new debug setting DebugAnimatedObjects defaults to false but can be set to true. This will display additional information in the debug text by each animated object.
* Develop->Render Metadata->Triangle count gives triangle information for objects in the scene. Shows a triangle count for the current LOD. Not restricted to animated objects.
* Develop->Render Metadata->Collision Skeleton will show the collision volumes for animated objects in red (avatars are blue)
* Develop->Avatar->Animation info will display any animations currently playing for an animated object, as it always has for avatars.

===Animated objects should be able to cross region boundaries as directed by a script===
* Go to secondlife://Aditi/secondlife/Animesh2/75/247/23
* Take a copy of the raptor and rez it.
* The Raptor has the Kart script in it. The Kart script is from the Library/Objects/Kart 1.0 object.
* Right-click the raptor and Ride
* Use the arrows to drive and the Page Down or C key to reset if it tips over.
* Verify you can drive the raptor around the region
* Verify you can drive the raptor to an adjacent region.

===Animated objects should continue to play animations after crossing a region boundary===
* Same as "Animated objects should be able to cross region boundaries as directed by a script" test.
* Verify that the Raptor continues to animate after crossing the region boundary.

Animesh Test

2018-06-18T04:09:38Z

Dan Linden: /* Enabling and Disabling Animated Mesh */

[[Category:Test Plans]]
[[Category:Content Tools]]

=NOTE: This test supports the new features of the Animesh viewer currently (March 2018) available for testing at [[Linden_Lab_Official:Alternate_Viewers]].=

==Purpose==
Test all functionality of the Animesh viewer.

==Test Plan==

===Stop / Start animation with LSL===
Test is at secondlife://Aditi/secondlife/Animesh2/7/247/23
* Click the black monolith and choose to start animations from the menu.
* Verify the Animesh model animates.
* Click the black monolith and choose to stop animations
* Verify the Animesh model stops animating.
* Click the black monolith and choose to start animations.
* Relog.
* Verify the Animesh model is animating.
* Move to an adjacent region
* Verify the Animesh model is still animating.
* Relog.
* Verify the Animesh model is animating when viewed from an adjacent region.
* Click the black monolith and choose to stop animations
* Verify Animesh model stops animating.
* Click the black monolith and choose to start animations.
* Verify Animesh model animates.

===Non-root prims in an animated object should be able to start and stop animations===
Test is at secondlife://Aditi/secondlife/Animesh2/23/249/23
* Click the black monolith and choose to start animations.
* Verify the Animesh model animates.
* Click the black monolith and choose to stop animations
* Verify the Animesh model stops animating.

===Any animation triggered by any prim can drive any bone in the skeleton===
Test is at secondlife://Aditi/secondlife/Animesh2/37/249/23
* Click the black monolith and choose to start animations.
* Verify the man animates typing and turning at the same time. (Two scripts in the 2 boxes are playing animations on the skeleton.)
* Click the black monolith and choose to stop animations
* Verify the man stops animating.

===Animated objects should play only requested animations===
Test is at secondlife://Aditi/secondlife/Animesh2/37/249/23
* Enable Develop menu -> Avatar -> Animation info
* Click the black monolith and choose to start animations.
* Verify only 2 animations appear above the Animesh, then disappear, then repeat.

===Wear an animesh===
* Test is at secondlife://Aditi/secondlife/Animesh2/65/247/23
* Take 3 copies of the Teddy bear to your inventory.
* Attempt to add the 3 Teddy bears to different attachment points of your avatar.
* Verify this fails with an error that explains you cannot attach more animated objects. (Current limit is 1 - 2017/11/9)

===Teleport while wearing an animesh===
* Wear an animesh that animates. (e.g. the Teddy bear)
* Teleport to a far region, one that is not adjacent or kitty corner.
* Verify the animesh attachment continues to animate as expected. (e.g. the Teddy bear hold your hand and nods its head)
* Log an observer in and verify the attached animesh looks the same to them.
* Wait 1 minute before teleporting back.
* Teleport back to the original location.
* Verify the animesh attachment continues to animate as expected. (e.g. the Teddy bear hold your hand and nods its head)

===Log in while wearing an animesh===
* While wearing an animesh that animates (e.g. the Teddy bear), log out.
* Log an observer in.
* Log in the avatar wearing the animesh
* Verify the animesh attachment continues to animate as expected. (e.g. the Teddy bear hold your hand and nods its head)
* Verify the observe sees the same thing.
* Sit on an animesh
* Go to secondlife://Aditi/secondlife/Animesh2/78/247/23
* Take a copy of the animesh raptor.
* Rez the raptor.
* Right-click it and select Ride.
* Verify your avatar sits on the raptor.

===Sit on an animesh while wearing an animesh===
* While sitting on an animating animesh, attach an animating animesh.
* Verify the two animesh are animating.
* Log in an observer on an adjacent region
* Verify the observer sees the same thing.
* Log in an observer with a viewer that does not support Animesh (eg. http://wiki.secondlife.com/wiki/Release_Notes/Second_Life_Release/5.1.2.512803 ).
* Verify the observer sees the two animesh are but they are not animating.
* Verify the avatar is bent to to the shape of the animesh they are wearing. This is expected.

===Get list of currently playing animations===
Go to secondlife://Aditi/secondlife/Animesh2/7/247/23
* Take a copy of an Animesh object that is playing animations
* Rez the Animesh object.
* Add the following script to the Animesh object.
<pre>
default
{
state_entry()
{
llSay(0, "Hello, Avatar!");
llSetTimerEvent(1);
}
timer()
{
list curr_anims = llGetObjectAnimationNames();
llOwnerSay("curr_anims are " + (string) curr_anims);
}
}
</pre>
* Verify all playing animations are listed while it is animating and none are listed while animations not playing
* Cleanup: delete the animesh object.

===Enabling and Disabling Animated Mesh===
* Rez a copy of the bear from secondlife://Aditi/secondlife/Animesh2/90/247/23
* If the bear is not already dancing, click it to make it dance.
* Edit your bear, and uncheck the Animated Mesh checkbox
* Verify the bear stops dancing and is now in a T-pose.
* Verify observers see the same thing you do.
* Wear the default male avatar from Library / Clothing / Older Outfits / Boy Next Door
* Wear the bear on your right hand and walk around.
* Verify your avatar looks like a bear.
[[Image:Bear1.png]]
* Verify observers see the same thing you do.
* Edit the bear you are wearing and check the Animated Mesh checkbox.
* Verify the bear now appears attached to your hand and starts dancing
* Verify observers see the same thing you do.
* Edit the bear you are wearing and uncheck the Animated Mesh checkbox. Deselect the mesh.
* Verify your avatar looks like a bear again.
* Verify observers see the same thing you do.
* Detach the bear to Inventory
* Rez the bear on the ground.
* Verify the bear is in a T-pose, arms stretched to the sides.
* Edit your bear, and check the Animated Mesh checkbox
* If the bear is not already dancing, click it to make it dance.
* Verify observers see the same thing you do.
* Take a copy of box1 at secondlife://Aditi/secondlife/Animesh2/92/247/23 and rez it.
* Verify the Animated Mesh checkbox cannot be modified because you do not have modify permissions for the object.
* Take a copy of boxes2 at secondlife://Aditi/secondlife/Animesh2/95/248/23
* Verify the Animated Mesh checkbox can only be modified if you are modifying the whole linkset. If you are editing component prims ("Edit linked"), the Animated Mesh box should be disabled.
* Right-click edit the bear at secondlife://Aditi/secondlife/Animesh2/90/247/23
* Verify you can see the Animated Mesh checkbox is checked and grayed out.
* Take a copy of the Animesh man at secondlife://Aditi/secondlife/Animesh2/7/247/23
* Rez the Animesh man
* Enable Develop > Render Metadata > Joints (requires Preferences > Advanced > Show Develop Menu)
* Verify joints are visible for the man in addition to joints for wings, tail, and rear legs.
* Disable Animated Mesh.
* Verify the joints are no longer visible on the Animesh man.
* Disable Develop > Render Metadata > Joints

===Animated mesh can be rezzed from object inventory.===
* Go to secondlife://Aditi/secondlife/Animesh2/101/248/23
* Take a copy of the popgun.
* Attach the popgun, press M to enter mouselook mode, and left-click to fire.
* Verify you see Raptors drop out of the gun and walk around.

===Selection and Editing===
* Verify you can select an animating Animesh by dragging a selection box around it while the Edit Tools (ctrl+3) are open.
* Verify all selected animated objects pause all of their animations for the person selecting them.
* Verify observers see the selected Animesh continue to animate.
* Unselecting any animated object should resume its animations.
* Verify you can select an animating Animesh with left-click while the Edit Tools (ctrl+3) are open. (known issue MAINT-7709)
* Verify you can select an animating Animesh with right-click. The standard object right-click menu will appear and the object will be shown with a wireframe.
* Verify selecting an animated object via the Build menu -> Region Objects floater behaves similarly - the animation is stopped. (This is only testable if you are estate owner or manager or parcel owner)
* Editing the translation and rotation of an animated object should work.
* Editing the scale of an animated object will not work.
* Moving an Animesh object across region boundaries while editing should work.

===Agent related text and controls should be hidden for Animesh===
* Hover the mouse cursor over the Animesh man at secondlife://Aditi/secondlife/Animesh2/7/247/23
* Verify that no hovertext appears about the object (This differs from regular objects.)
* Right-click the Animesh man and inspect the right-click menu.
* Verify there are no Agent related menu items, such as View Profile, Add friend, IM, Call, etc.
* Verify the right-click menu is a typical Object context menu.
[[Image:Animesh right-click1.png]]

===New Diagnostic Displays===
* Verify the following diagnostics display.
* A new debug setting DebugAnimatedObjects defaults to false but can be set to true. This will display additional information in the debug text by each animated object.
* Develop->Render Metadata->Triangle count gives triangle information for objects in the scene. Shows a triangle count for the current LOD. Not restricted to animated objects.
* Develop->Render Metadata->Collision Skeleton will show the collision volumes for animated objects in red (avatars are blue)
* Develop->Avatar->Animation info will display any animations currently playing for an animated object, as it always has for avatars.

===Animated objects should be able to cross region boundaries as directed by a script===
* Go to secondlife://Aditi/secondlife/Animesh2/75/247/23
* Take a copy of the raptor and rez it.
* The Raptor has the Kart script in it. The Kart script is from the Library/Objects/Kart 1.0 object.
* Right-click the raptor and Ride
* Use the arrows to drive and the Page Down or C key to reset if it tips over.
* Verify you can drive the raptor around the region
* Verify you can drive the raptor to an adjacent region.

===Animated objects should continue to play animations after crossing a region boundary===
* Same as "Animated objects should be able to cross region boundaries as directed by a script" test.
* Verify that the Raptor continues to animate after crossing the region boundary.

Animesh Test

2018-06-18T00:24:29Z

Dan Linden: /* Animated objects should continue to play animations after crossing a region boundary */

[[Category:Test Plans]]
[[Category:Content Tools]]

=NOTE: This test supports the new features of the Animesh viewer currently (March 2018) available for testing at [[Linden_Lab_Official:Alternate_Viewers]].=

==Purpose==
Test all functionality of the Animesh viewer.

==Test Plan==

===Stop / Start animation with LSL===
Test is at secondlife://Aditi/secondlife/Animesh2/7/247/23
* Click the black monolith and choose to start animations from the menu.
* Verify the Animesh model animates.
* Click the black monolith and choose to stop animations
* Verify the Animesh model stops animating.
* Click the black monolith and choose to start animations.
* Relog.
* Verify the Animesh model is animating.
* Move to an adjacent region
* Verify the Animesh model is still animating.
* Relog.
* Verify the Animesh model is animating when viewed from an adjacent region.
* Click the black monolith and choose to stop animations
* Verify Animesh model stops animating.
* Click the black monolith and choose to start animations.
* Verify Animesh model animates.

===Non-root prims in an animated object should be able to start and stop animations===
Test is at secondlife://Aditi/secondlife/Animesh2/23/249/23
* Click the black monolith and choose to start animations.
* Verify the Animesh model animates.
* Click the black monolith and choose to stop animations
* Verify the Animesh model stops animating.

===Any animation triggered by any prim can drive any bone in the skeleton===
Test is at secondlife://Aditi/secondlife/Animesh2/37/249/23
* Click the black monolith and choose to start animations.
* Verify the man animates typing and turning at the same time. (Two scripts in the 2 boxes are playing animations on the skeleton.)
* Click the black monolith and choose to stop animations
* Verify the man stops animating.

===Animated objects should play only requested animations===
Test is at secondlife://Aditi/secondlife/Animesh2/37/249/23
* Enable Develop menu -> Avatar -> Animation info
* Click the black monolith and choose to start animations.
* Verify only 2 animations appear above the Animesh, then disappear, then repeat.

===Wear an animesh===
* Test is at secondlife://Aditi/secondlife/Animesh2/65/247/23
* Take 3 copies of the Teddy bear to your inventory.
* Attempt to add the 3 Teddy bears to different attachment points of your avatar.
* Verify this fails with an error that explains you cannot attach more animated objects. (Current limit is 1 - 2017/11/9)

===Teleport while wearing an animesh===
* Wear an animesh that animates. (e.g. the Teddy bear)
* Teleport to a far region, one that is not adjacent or kitty corner.
* Verify the animesh attachment continues to animate as expected. (e.g. the Teddy bear hold your hand and nods its head)
* Log an observer in and verify the attached animesh looks the same to them.
* Wait 1 minute before teleporting back.
* Teleport back to the original location.
* Verify the animesh attachment continues to animate as expected. (e.g. the Teddy bear hold your hand and nods its head)

===Log in while wearing an animesh===
* While wearing an animesh that animates (e.g. the Teddy bear), log out.
* Log an observer in.
* Log in the avatar wearing the animesh
* Verify the animesh attachment continues to animate as expected. (e.g. the Teddy bear hold your hand and nods its head)
* Verify the observe sees the same thing.
* Sit on an animesh
* Go to secondlife://Aditi/secondlife/Animesh2/78/247/23
* Take a copy of the animesh raptor.
* Rez the raptor.
* Right-click it and select Ride.
* Verify your avatar sits on the raptor.

===Sit on an animesh while wearing an animesh===
* While sitting on an animating animesh, attach an animating animesh.
* Verify the two animesh are animating.
* Log in an observer on an adjacent region
* Verify the observer sees the same thing.
* Log in an observer with a viewer that does not support Animesh (eg. http://wiki.secondlife.com/wiki/Release_Notes/Second_Life_Release/5.1.2.512803 ).
* Verify the observer sees the two animesh are but they are not animating.
* Verify the avatar is bent to to the shape of the animesh they are wearing. This is expected.

===Get list of currently playing animations===
Go to secondlife://Aditi/secondlife/Animesh2/7/247/23
* Take a copy of an Animesh object that is playing animations
* Rez the Animesh object.
* Add the following script to the Animesh object.
<pre>
default
{
state_entry()
{
llSay(0, "Hello, Avatar!");
llSetTimerEvent(1);
}
timer()
{
list curr_anims = llGetObjectAnimationNames();
llOwnerSay("curr_anims are " + (string) curr_anims);
}
}
</pre>
* Verify all playing animations are listed while it is animating and none are listed while animations not playing
* Cleanup: delete the animesh object.

===Enabling and Disabling Animated Mesh===
* Rez a copy of the bear from secondlife://Aditi/secondlife/Animesh2/90/247/23
* If the bear is not already dancing, click it to make it dance.
* Edit your bear, and uncheck the Animated Mesh checkbox
* Verify the bear stops dancing and is now in a T-pose.
* Verify observers see the same thing you do.
* Wear the default male avatar from Library / Clothing / Older Outfits / Boy Next Door
* Wear the bear on your right hand and walk around.
* Verify your avatar looks like a bear.
[[Image:Bear1.png]]
* Verify observers see the same thing you do.
* Edit the bear you are wearing and check the Animated Mesh checkbox.
* Verify the bear now appears attached to your hand and starts dancing
* Verify observers see the same thing you do.
* Edit the bear you are wearing and uncheck the Animated Mesh checkbox. Deselect the mesh.
* Verify your avatar looks like a bear again.
* Verify observers see the same thing you do.
* Detach the bear to Inventory
* Rez the bear on the ground.
* Verify the bear is in a T-pose, arms stretched to the sides.
* Edit your bear, and check the Animated Mesh checkbox
* If the bear is not already dancing, click it to make it dance.
* Verify observers see the same thing you do.
* Take a copy of box1 at secondlife://Aditi/secondlife/Animesh2/92/247/23 and rez it.
* Verify the Animated Mesh checkbox cannot be modified because you do not have modify permissions for the object.
* Take a copy of boxes2 at secondlife://Aditi/secondlife/Animesh2/95/248/23
* Verify the Animated Mesh checkbox can only be modified if you are modifying the whole linkset. If you are editing component prims ("Edit linked"), the Animated Mesh box should be disabled.
* Right-click edit the bear at secondlife://Aditi/secondlife/Animesh2/90/247/23
* Verify you can see the Animated Mesh checkbox is checked and grayed out.

===Animated mesh can be rezzed from object inventory.===
* Go to secondlife://Aditi/secondlife/Animesh2/101/248/23
* Take a copy of the popgun.
* Attach the popgun, press M to enter mouselook mode, and left-click to fire.
* Verify you see Raptors drop out of the gun and walk around.

===Selection and Editing===
* Verify you can select an animating Animesh by dragging a selection box around it while the Edit Tools (ctrl+3) are open.
* Verify all selected animated objects pause all of their animations for the person selecting them.
* Verify observers see the selected Animesh continue to animate.
* Unselecting any animated object should resume its animations.
* Verify you can select an animating Animesh with left-click while the Edit Tools (ctrl+3) are open. (known issue MAINT-7709)
* Verify you can select an animating Animesh with right-click. The standard object right-click menu will appear and the object will be shown with a wireframe.
* Verify selecting an animated object via the Build menu -> Region Objects floater behaves similarly - the animation is stopped. (This is only testable if you are estate owner or manager or parcel owner)
* Editing the translation and rotation of an animated object should work.
* Editing the scale of an animated object will not work.
* Moving an Animesh object across region boundaries while editing should work.

===Agent related text and controls should be hidden for Animesh===
* Hover the mouse cursor over the Animesh man at secondlife://Aditi/secondlife/Animesh2/7/247/23
* Verify that no hovertext appears about the object (This differs from regular objects.)
* Right-click the Animesh man and inspect the right-click menu.
* Verify there are no Agent related menu items, such as View Profile, Add friend, IM, Call, etc.
* Verify the right-click menu is a typical Object context menu.
[[Image:Animesh right-click1.png]]

===New Diagnostic Displays===
* Verify the following diagnostics display.
* A new debug setting DebugAnimatedObjects defaults to false but can be set to true. This will display additional information in the debug text by each animated object.
* Develop->Render Metadata->Triangle count gives triangle information for objects in the scene. Shows a triangle count for the current LOD. Not restricted to animated objects.
* Develop->Render Metadata->Collision Skeleton will show the collision volumes for animated objects in red (avatars are blue)
* Develop->Avatar->Animation info will display any animations currently playing for an animated object, as it always has for avatars.

===Animated objects should be able to cross region boundaries as directed by a script===
* Go to secondlife://Aditi/secondlife/Animesh2/75/247/23
* Take a copy of the raptor and rez it.
* The Raptor has the Kart script in it. The Kart script is from the Library/Objects/Kart 1.0 object.
* Right-click the raptor and Ride
* Use the arrows to drive and the Page Down or C key to reset if it tips over.
* Verify you can drive the raptor around the region
* Verify you can drive the raptor to an adjacent region.

===Animated objects should continue to play animations after crossing a region boundary===
* Same as "Animated objects should be able to cross region boundaries as directed by a script" test.
* Verify that the Raptor continues to animate after crossing the region boundary.

Animesh Test

2018-06-18T00:24:07Z

Dan Linden: /* Animated objects should be able to cross region boundaries as directed by a script */

[[Category:Test Plans]]
[[Category:Content Tools]]

=NOTE: This test supports the new features of the Animesh viewer currently (March 2018) available for testing at [[Linden_Lab_Official:Alternate_Viewers]].=

==Purpose==
Test all functionality of the Animesh viewer.

==Test Plan==

===Stop / Start animation with LSL===
Test is at secondlife://Aditi/secondlife/Animesh2/7/247/23
* Click the black monolith and choose to start animations from the menu.
* Verify the Animesh model animates.
* Click the black monolith and choose to stop animations
* Verify the Animesh model stops animating.
* Click the black monolith and choose to start animations.
* Relog.
* Verify the Animesh model is animating.
* Move to an adjacent region
* Verify the Animesh model is still animating.
* Relog.
* Verify the Animesh model is animating when viewed from an adjacent region.
* Click the black monolith and choose to stop animations
* Verify Animesh model stops animating.
* Click the black monolith and choose to start animations.
* Verify Animesh model animates.

===Non-root prims in an animated object should be able to start and stop animations===
Test is at secondlife://Aditi/secondlife/Animesh2/23/249/23
* Click the black monolith and choose to start animations.
* Verify the Animesh model animates.
* Click the black monolith and choose to stop animations
* Verify the Animesh model stops animating.

===Any animation triggered by any prim can drive any bone in the skeleton===
Test is at secondlife://Aditi/secondlife/Animesh2/37/249/23
* Click the black monolith and choose to start animations.
* Verify the man animates typing and turning at the same time. (Two scripts in the 2 boxes are playing animations on the skeleton.)
* Click the black monolith and choose to stop animations
* Verify the man stops animating.

===Animated objects should play only requested animations===
Test is at secondlife://Aditi/secondlife/Animesh2/37/249/23
* Enable Develop menu -> Avatar -> Animation info
* Click the black monolith and choose to start animations.
* Verify only 2 animations appear above the Animesh, then disappear, then repeat.

===Wear an animesh===
* Test is at secondlife://Aditi/secondlife/Animesh2/65/247/23
* Take 3 copies of the Teddy bear to your inventory.
* Attempt to add the 3 Teddy bears to different attachment points of your avatar.
* Verify this fails with an error that explains you cannot attach more animated objects. (Current limit is 1 - 2017/11/9)

===Teleport while wearing an animesh===
* Wear an animesh that animates. (e.g. the Teddy bear)
* Teleport to a far region, one that is not adjacent or kitty corner.
* Verify the animesh attachment continues to animate as expected. (e.g. the Teddy bear hold your hand and nods its head)
* Log an observer in and verify the attached animesh looks the same to them.
* Wait 1 minute before teleporting back.
* Teleport back to the original location.
* Verify the animesh attachment continues to animate as expected. (e.g. the Teddy bear hold your hand and nods its head)

===Log in while wearing an animesh===
* While wearing an animesh that animates (e.g. the Teddy bear), log out.
* Log an observer in.
* Log in the avatar wearing the animesh
* Verify the animesh attachment continues to animate as expected. (e.g. the Teddy bear hold your hand and nods its head)
* Verify the observe sees the same thing.
* Sit on an animesh
* Go to secondlife://Aditi/secondlife/Animesh2/78/247/23
* Take a copy of the animesh raptor.
* Rez the raptor.
* Right-click it and select Ride.
* Verify your avatar sits on the raptor.

===Sit on an animesh while wearing an animesh===
* While sitting on an animating animesh, attach an animating animesh.
* Verify the two animesh are animating.
* Log in an observer on an adjacent region
* Verify the observer sees the same thing.
* Log in an observer with a viewer that does not support Animesh (eg. http://wiki.secondlife.com/wiki/Release_Notes/Second_Life_Release/5.1.2.512803 ).
* Verify the observer sees the two animesh are but they are not animating.
* Verify the avatar is bent to to the shape of the animesh they are wearing. This is expected.

===Get list of currently playing animations===
Go to secondlife://Aditi/secondlife/Animesh2/7/247/23
* Take a copy of an Animesh object that is playing animations
* Rez the Animesh object.
* Add the following script to the Animesh object.
<pre>
default
{
state_entry()
{
llSay(0, "Hello, Avatar!");
llSetTimerEvent(1);
}
timer()
{
list curr_anims = llGetObjectAnimationNames();
llOwnerSay("curr_anims are " + (string) curr_anims);
}
}
</pre>
* Verify all playing animations are listed while it is animating and none are listed while animations not playing
* Cleanup: delete the animesh object.

===Enabling and Disabling Animated Mesh===
* Rez a copy of the bear from secondlife://Aditi/secondlife/Animesh2/90/247/23
* If the bear is not already dancing, click it to make it dance.
* Edit your bear, and uncheck the Animated Mesh checkbox
* Verify the bear stops dancing and is now in a T-pose.
* Verify observers see the same thing you do.
* Wear the default male avatar from Library / Clothing / Older Outfits / Boy Next Door
* Wear the bear on your right hand and walk around.
* Verify your avatar looks like a bear.
[[Image:Bear1.png]]
* Verify observers see the same thing you do.
* Edit the bear you are wearing and check the Animated Mesh checkbox.
* Verify the bear now appears attached to your hand and starts dancing
* Verify observers see the same thing you do.
* Edit the bear you are wearing and uncheck the Animated Mesh checkbox. Deselect the mesh.
* Verify your avatar looks like a bear again.
* Verify observers see the same thing you do.
* Detach the bear to Inventory
* Rez the bear on the ground.
* Verify the bear is in a T-pose, arms stretched to the sides.
* Edit your bear, and check the Animated Mesh checkbox
* If the bear is not already dancing, click it to make it dance.
* Verify observers see the same thing you do.
* Take a copy of box1 at secondlife://Aditi/secondlife/Animesh2/92/247/23 and rez it.
* Verify the Animated Mesh checkbox cannot be modified because you do not have modify permissions for the object.
* Take a copy of boxes2 at secondlife://Aditi/secondlife/Animesh2/95/248/23
* Verify the Animated Mesh checkbox can only be modified if you are modifying the whole linkset. If you are editing component prims ("Edit linked"), the Animated Mesh box should be disabled.
* Right-click edit the bear at secondlife://Aditi/secondlife/Animesh2/90/247/23
* Verify you can see the Animated Mesh checkbox is checked and grayed out.

===Animated mesh can be rezzed from object inventory.===
* Go to secondlife://Aditi/secondlife/Animesh2/101/248/23
* Take a copy of the popgun.
* Attach the popgun, press M to enter mouselook mode, and left-click to fire.
* Verify you see Raptors drop out of the gun and walk around.

===Selection and Editing===
* Verify you can select an animating Animesh by dragging a selection box around it while the Edit Tools (ctrl+3) are open.
* Verify all selected animated objects pause all of their animations for the person selecting them.
* Verify observers see the selected Animesh continue to animate.
* Unselecting any animated object should resume its animations.
* Verify you can select an animating Animesh with left-click while the Edit Tools (ctrl+3) are open. (known issue MAINT-7709)
* Verify you can select an animating Animesh with right-click. The standard object right-click menu will appear and the object will be shown with a wireframe.
* Verify selecting an animated object via the Build menu -> Region Objects floater behaves similarly - the animation is stopped. (This is only testable if you are estate owner or manager or parcel owner)
* Editing the translation and rotation of an animated object should work.
* Editing the scale of an animated object will not work.
* Moving an Animesh object across region boundaries while editing should work.

===Agent related text and controls should be hidden for Animesh===
* Hover the mouse cursor over the Animesh man at secondlife://Aditi/secondlife/Animesh2/7/247/23
* Verify that no hovertext appears about the object (This differs from regular objects.)
* Right-click the Animesh man and inspect the right-click menu.
* Verify there are no Agent related menu items, such as View Profile, Add friend, IM, Call, etc.
* Verify the right-click menu is a typical Object context menu.
[[Image:Animesh right-click1.png]]

===New Diagnostic Displays===
* Verify the following diagnostics display.
* A new debug setting DebugAnimatedObjects defaults to false but can be set to true. This will display additional information in the debug text by each animated object.
* Develop->Render Metadata->Triangle count gives triangle information for objects in the scene. Shows a triangle count for the current LOD. Not restricted to animated objects.
* Develop->Render Metadata->Collision Skeleton will show the collision volumes for animated objects in red (avatars are blue)
* Develop->Avatar->Animation info will display any animations currently playing for an animated object, as it always has for avatars.

===Animated objects should be able to cross region boundaries as directed by a script===
* Go to secondlife://Aditi/secondlife/Animesh2/75/247/23
* Take a copy of the raptor and rez it.
* The Raptor has the Kart script in it. The Kart script is from the Library/Objects/Kart 1.0 object.
* Right-click the raptor and Ride
* Use the arrows to drive and the Page Down or C key to reset if it tips over.
* Verify you can drive the raptor around the region
* Verify you can drive the raptor to an adjacent region.

===Animated objects should continue to play animations after crossing a region boundary===
Same as "Animated objects should be able to cross region boundaries as directed by a script" test.
Verify that the Raptor continues to animate after crossing the region boundary.

Animesh Test

2018-06-12T05:23:41Z

Dan Linden: /* New Diagnostic Displays */

[[Category:Test Plans]]
[[Category:Content Tools]]

=NOTE: This test supports the new features of the Animesh viewer currently (March 2018) available for testing at [[Linden_Lab_Official:Alternate_Viewers]].=

==Purpose==
Test all functionality of the Animesh viewer.

==Test Plan==

===Stop / Start animation with LSL===
Test is at secondlife://Aditi/secondlife/Animesh2/7/247/23
* Click the black monolith and choose to start animations from the menu.
* Verify the Animesh model animates.
* Click the black monolith and choose to stop animations
* Verify the Animesh model stops animating.
* Click the black monolith and choose to start animations.
* Relog.
* Verify the Animesh model is animating.
* Move to an adjacent region
* Verify the Animesh model is still animating.
* Relog.
* Verify the Animesh model is animating when viewed from an adjacent region.
* Click the black monolith and choose to stop animations
* Verify Animesh model stops animating.
* Click the black monolith and choose to start animations.
* Verify Animesh model animates.

===Non-root prims in an animated object should be able to start and stop animations===
Test is at secondlife://Aditi/secondlife/Animesh2/23/249/23
* Click the black monolith and choose to start animations.
* Verify the Animesh model animates.
* Click the black monolith and choose to stop animations
* Verify the Animesh model stops animating.

===Any animation triggered by any prim can drive any bone in the skeleton===
Test is at secondlife://Aditi/secondlife/Animesh2/37/249/23
* Click the black monolith and choose to start animations.
* Verify the man animates typing and turning at the same time. (Two scripts in the 2 boxes are playing animations on the skeleton.)
* Click the black monolith and choose to stop animations
* Verify the man stops animating.

===Animated objects should play only requested animations===
Test is at secondlife://Aditi/secondlife/Animesh2/37/249/23
* Enable Develop menu -> Avatar -> Animation info
* Click the black monolith and choose to start animations.
* Verify only 2 animations appear above the Animesh, then disappear, then repeat.

===Wear an animesh===
* Test is at secondlife://Aditi/secondlife/Animesh2/65/247/23
* Take 3 copies of the Teddy bear to your inventory.
* Attempt to add the 3 Teddy bears to different attachment points of your avatar.
* Verify this fails with an error that explains you cannot attach more animated objects. (Current limit is 1 - 2017/11/9)

===Teleport while wearing an animesh===
* Wear an animesh that animates. (e.g. the Teddy bear)
* Teleport to a far region, one that is not adjacent or kitty corner.
* Verify the animesh attachment continues to animate as expected. (e.g. the Teddy bear hold your hand and nods its head)
* Log an observer in and verify the attached animesh looks the same to them.
* Wait 1 minute before teleporting back.
* Teleport back to the original location.
* Verify the animesh attachment continues to animate as expected. (e.g. the Teddy bear hold your hand and nods its head)

===Log in while wearing an animesh===
* While wearing an animesh that animates (e.g. the Teddy bear), log out.
* Log an observer in.
* Log in the avatar wearing the animesh
* Verify the animesh attachment continues to animate as expected. (e.g. the Teddy bear hold your hand and nods its head)
* Verify the observe sees the same thing.
* Sit on an animesh
* Go to secondlife://Aditi/secondlife/Animesh2/78/247/23
* Take a copy of the animesh raptor.
* Rez the raptor.
* Right-click it and select Ride.
* Verify your avatar sits on the raptor.

===Sit on an animesh while wearing an animesh===
* While sitting on an animating animesh, attach an animating animesh.
* Verify the two animesh are animating.
* Log in an observer on an adjacent region
* Verify the observer sees the same thing.
* Log in an observer with a viewer that does not support Animesh (eg. http://wiki.secondlife.com/wiki/Release_Notes/Second_Life_Release/5.1.2.512803 ).
* Verify the observer sees the two animesh are but they are not animating.
* Verify the avatar is bent to to the shape of the animesh they are wearing. This is expected.

===Get list of currently playing animations===
Go to secondlife://Aditi/secondlife/Animesh2/7/247/23
* Take a copy of an Animesh object that is playing animations
* Rez the Animesh object.
* Add the following script to the Animesh object.
<pre>
default
{
state_entry()
{
llSay(0, "Hello, Avatar!");
llSetTimerEvent(1);
}
timer()
{
list curr_anims = llGetObjectAnimationNames();
llOwnerSay("curr_anims are " + (string) curr_anims);
}
}
</pre>
* Verify all playing animations are listed while it is animating and none are listed while animations not playing
* Cleanup: delete the animesh object.

===Enabling and Disabling Animated Mesh===
* Rez a copy of the bear from secondlife://Aditi/secondlife/Animesh2/90/247/23
* If the bear is not already dancing, click it to make it dance.
* Edit your bear, and uncheck the Animated Mesh checkbox
* Verify the bear stops dancing and is now in a T-pose.
* Verify observers see the same thing you do.
* Wear the default male avatar from Library / Clothing / Older Outfits / Boy Next Door
* Wear the bear on your right hand and walk around.
* Verify your avatar looks like a bear.
[[Image:Bear1.png]]
* Verify observers see the same thing you do.
* Edit the bear you are wearing and check the Animated Mesh checkbox.
* Verify the bear now appears attached to your hand and starts dancing
* Verify observers see the same thing you do.
* Edit the bear you are wearing and uncheck the Animated Mesh checkbox. Deselect the mesh.
* Verify your avatar looks like a bear again.
* Verify observers see the same thing you do.
* Detach the bear to Inventory
* Rez the bear on the ground.
* Verify the bear is in a T-pose, arms stretched to the sides.
* Edit your bear, and check the Animated Mesh checkbox
* If the bear is not already dancing, click it to make it dance.
* Verify observers see the same thing you do.
* Take a copy of box1 at secondlife://Aditi/secondlife/Animesh2/92/247/23 and rez it.
* Verify the Animated Mesh checkbox cannot be modified because you do not have modify permissions for the object.
* Take a copy of boxes2 at secondlife://Aditi/secondlife/Animesh2/95/248/23
* Verify the Animated Mesh checkbox can only be modified if you are modifying the whole linkset. If you are editing component prims ("Edit linked"), the Animated Mesh box should be disabled.
* Right-click edit the bear at secondlife://Aditi/secondlife/Animesh2/90/247/23
* Verify you can see the Animated Mesh checkbox is checked and grayed out.

===Animated mesh can be rezzed from object inventory.===
* Go to secondlife://Aditi/secondlife/Animesh2/101/248/23
* Take a copy of the popgun.
* Attach the popgun, press M to enter mouselook mode, and left-click to fire.
* Verify you see Raptors drop out of the gun and walk around.

===Selection and Editing===
* Verify you can select an animating Animesh by dragging a selection box around it while the Edit Tools (ctrl+3) are open.
* Verify all selected animated objects pause all of their animations for the person selecting them.
* Verify observers see the selected Animesh continue to animate.
* Unselecting any animated object should resume its animations.
* Verify you can select an animating Animesh with left-click while the Edit Tools (ctrl+3) are open. (known issue MAINT-7709)
* Verify you can select an animating Animesh with right-click. The standard object right-click menu will appear and the object will be shown with a wireframe.
* Verify selecting an animated object via the Build menu -> Region Objects floater behaves similarly - the animation is stopped. (This is only testable if you are estate owner or manager or parcel owner)
* Editing the translation and rotation of an animated object should work.
* Editing the scale of an animated object will not work.
* Moving an Animesh object across region boundaries while editing should work.

===Agent related text and controls should be hidden for Animesh===
* Hover the mouse cursor over the Animesh man at secondlife://Aditi/secondlife/Animesh2/7/247/23
* Verify that no hovertext appears about the object (This differs from regular objects.)
* Right-click the Animesh man and inspect the right-click menu.
* Verify there are no Agent related menu items, such as View Profile, Add friend, IM, Call, etc.
* Verify the right-click menu is a typical Object context menu.
[[Image:Animesh right-click1.png]]

===New Diagnostic Displays===
* Verify the following diagnostics display.
* A new debug setting DebugAnimatedObjects defaults to false but can be set to true. This will display additional information in the debug text by each animated object.
* Develop->Render Metadata->Triangle count gives triangle information for objects in the scene. Shows a triangle count for the current LOD. Not restricted to animated objects.
* Develop->Render Metadata->Collision Skeleton will show the collision volumes for animated objects in red (avatars are blue)
* Develop->Avatar->Animation info will display any animations currently playing for an animated object, as it always has for avatars.

===Animated objects should be able to cross region boundaries as directed by a script===
* Go to secondlife://Aditi/secondlife/Animesh2/75/247/23
* Take a copy of the raptor and rez it.
* The Raptor has the Kart script in it. The Kart script is from the Library/Objects/Kart 1.0 object.
* Right-click the raptor and Ride
* Use the arrows to drive and the Page Down or C key to reset if it tips over.
* Verify you can drive the raptor around the region
* Verify you can drive the raptor to an adjacent region.

Animesh Test

2018-06-12T04:24:28Z

Dan Linden: /* Agent related text and controls should be hidden for Animesh */

[[Category:Test Plans]]
[[Category:Content Tools]]

=NOTE: This test supports the new features of the Animesh viewer currently (March 2018) available for testing at [[Linden_Lab_Official:Alternate_Viewers]].=

==Purpose==
Test all functionality of the Animesh viewer.

==Test Plan==

===Stop / Start animation with LSL===
Test is at secondlife://Aditi/secondlife/Animesh2/7/247/23
* Click the black monolith and choose to start animations from the menu.
* Verify the Animesh model animates.
* Click the black monolith and choose to stop animations
* Verify the Animesh model stops animating.
* Click the black monolith and choose to start animations.
* Relog.
* Verify the Animesh model is animating.
* Move to an adjacent region
* Verify the Animesh model is still animating.
* Relog.
* Verify the Animesh model is animating when viewed from an adjacent region.
* Click the black monolith and choose to stop animations
* Verify Animesh model stops animating.
* Click the black monolith and choose to start animations.
* Verify Animesh model animates.

===Non-root prims in an animated object should be able to start and stop animations===
Test is at secondlife://Aditi/secondlife/Animesh2/23/249/23
* Click the black monolith and choose to start animations.
* Verify the Animesh model animates.
* Click the black monolith and choose to stop animations
* Verify the Animesh model stops animating.

===Any animation triggered by any prim can drive any bone in the skeleton===
Test is at secondlife://Aditi/secondlife/Animesh2/37/249/23
* Click the black monolith and choose to start animations.
* Verify the man animates typing and turning at the same time. (Two scripts in the 2 boxes are playing animations on the skeleton.)
* Click the black monolith and choose to stop animations
* Verify the man stops animating.

===Animated objects should play only requested animations===
Test is at secondlife://Aditi/secondlife/Animesh2/37/249/23
* Enable Develop menu -> Avatar -> Animation info
* Click the black monolith and choose to start animations.
* Verify only 2 animations appear above the Animesh, then disappear, then repeat.

===Wear an animesh===
* Test is at secondlife://Aditi/secondlife/Animesh2/65/247/23
* Take 3 copies of the Teddy bear to your inventory.
* Attempt to add the 3 Teddy bears to different attachment points of your avatar.
* Verify this fails with an error that explains you cannot attach more animated objects. (Current limit is 1 - 2017/11/9)

===Teleport while wearing an animesh===
* Wear an animesh that animates. (e.g. the Teddy bear)
* Teleport to a far region, one that is not adjacent or kitty corner.
* Verify the animesh attachment continues to animate as expected. (e.g. the Teddy bear hold your hand and nods its head)
* Log an observer in and verify the attached animesh looks the same to them.
* Wait 1 minute before teleporting back.
* Teleport back to the original location.
* Verify the animesh attachment continues to animate as expected. (e.g. the Teddy bear hold your hand and nods its head)

===Log in while wearing an animesh===
* While wearing an animesh that animates (e.g. the Teddy bear), log out.
* Log an observer in.
* Log in the avatar wearing the animesh
* Verify the animesh attachment continues to animate as expected. (e.g. the Teddy bear hold your hand and nods its head)
* Verify the observe sees the same thing.
* Sit on an animesh
* Go to secondlife://Aditi/secondlife/Animesh2/78/247/23
* Take a copy of the animesh raptor.
* Rez the raptor.
* Right-click it and select Ride.
* Verify your avatar sits on the raptor.

===Sit on an animesh while wearing an animesh===
* While sitting on an animating animesh, attach an animating animesh.
* Verify the two animesh are animating.
* Log in an observer on an adjacent region
* Verify the observer sees the same thing.
* Log in an observer with a viewer that does not support Animesh (eg. http://wiki.secondlife.com/wiki/Release_Notes/Second_Life_Release/5.1.2.512803 ).
* Verify the observer sees the two animesh are but they are not animating.
* Verify the avatar is bent to to the shape of the animesh they are wearing. This is expected.

===Get list of currently playing animations===
Go to secondlife://Aditi/secondlife/Animesh2/7/247/23
* Take a copy of an Animesh object that is playing animations
* Rez the Animesh object.
* Add the following script to the Animesh object.
<pre>
default
{
state_entry()
{
llSay(0, "Hello, Avatar!");
llSetTimerEvent(1);
}
timer()
{
list curr_anims = llGetObjectAnimationNames();
llOwnerSay("curr_anims are " + (string) curr_anims);
}
}
</pre>
* Verify all playing animations are listed while it is animating and none are listed while animations not playing
* Cleanup: delete the animesh object.

===Enabling and Disabling Animated Mesh===
* Rez a copy of the bear from secondlife://Aditi/secondlife/Animesh2/90/247/23
* If the bear is not already dancing, click it to make it dance.
* Edit your bear, and uncheck the Animated Mesh checkbox
* Verify the bear stops dancing and is now in a T-pose.
* Verify observers see the same thing you do.
* Wear the default male avatar from Library / Clothing / Older Outfits / Boy Next Door
* Wear the bear on your right hand and walk around.
* Verify your avatar looks like a bear.
[[Image:Bear1.png]]
* Verify observers see the same thing you do.
* Edit the bear you are wearing and check the Animated Mesh checkbox.
* Verify the bear now appears attached to your hand and starts dancing
* Verify observers see the same thing you do.
* Edit the bear you are wearing and uncheck the Animated Mesh checkbox. Deselect the mesh.
* Verify your avatar looks like a bear again.
* Verify observers see the same thing you do.
* Detach the bear to Inventory
* Rez the bear on the ground.
* Verify the bear is in a T-pose, arms stretched to the sides.
* Edit your bear, and check the Animated Mesh checkbox
* If the bear is not already dancing, click it to make it dance.
* Verify observers see the same thing you do.
* Take a copy of box1 at secondlife://Aditi/secondlife/Animesh2/92/247/23 and rez it.
* Verify the Animated Mesh checkbox cannot be modified because you do not have modify permissions for the object.
* Take a copy of boxes2 at secondlife://Aditi/secondlife/Animesh2/95/248/23
* Verify the Animated Mesh checkbox can only be modified if you are modifying the whole linkset. If you are editing component prims ("Edit linked"), the Animated Mesh box should be disabled.
* Right-click edit the bear at secondlife://Aditi/secondlife/Animesh2/90/247/23
* Verify you can see the Animated Mesh checkbox is checked and grayed out.

===Animated mesh can be rezzed from object inventory.===
* Go to secondlife://Aditi/secondlife/Animesh2/101/248/23
* Take a copy of the popgun.
* Attach the popgun, press M to enter mouselook mode, and left-click to fire.
* Verify you see Raptors drop out of the gun and walk around.

===Selection and Editing===
* Verify you can select an animating Animesh by dragging a selection box around it while the Edit Tools (ctrl+3) are open.
* Verify all selected animated objects pause all of their animations for the person selecting them.
* Verify observers see the selected Animesh continue to animate.
* Unselecting any animated object should resume its animations.
* Verify you can select an animating Animesh with left-click while the Edit Tools (ctrl+3) are open. (known issue MAINT-7709)
* Verify you can select an animating Animesh with right-click. The standard object right-click menu will appear and the object will be shown with a wireframe.
* Verify selecting an animated object via the Build menu -> Region Objects floater behaves similarly - the animation is stopped. (This is only testable if you are estate owner or manager or parcel owner)
* Editing the translation and rotation of an animated object should work.
* Editing the scale of an animated object will not work.
* Moving an Animesh object across region boundaries while editing should work.

===Agent related text and controls should be hidden for Animesh===
* Hover the mouse cursor over the Animesh man at secondlife://Aditi/secondlife/Animesh2/7/247/23
* Verify that no hovertext appears about the object (This differs from regular objects.)
* Right-click the Animesh man and inspect the right-click menu.
* Verify there are no Agent related menu items, such as View Profile, Add friend, IM, Call, etc.
* Verify the right-click menu is a typical Object context menu.
[[Image:Animesh right-click1.png]]

===New Diagnostic Displays===
* Verify the following diagnostics display.
* A new debug setting DebugAnimatedObjects defaults to false but can be set to true. This will display additional information in the debug text by each animated object.
* Develop->Render Metadata->Triangle count gives triangle information for objects in the scene. Shows a triangle count for the current LOD. Not restricted to animated objects.
* Develop->Render Metadata->Collision Skeleton will show the collision volumes for animated objects in red (avatars are blue)
* Develop->Avatar->Animation info will display any animations currently playing for an animated object, as it always has for avatars.

Animesh Test

2018-06-11T22:25:27Z

Dan Linden: /* Selection and Editing */

[[Category:Test Plans]]
[[Category:Content Tools]]

=NOTE: This test supports the new features of the Animesh viewer currently (March 2018) available for testing at [[Linden_Lab_Official:Alternate_Viewers]].=

==Purpose==
Test all functionality of the Animesh viewer.

==Test Plan==

===Stop / Start animation with LSL===
Test is at secondlife://Aditi/secondlife/Animesh2/7/247/23
* Click the black monolith and choose to start animations from the menu.
* Verify the Animesh model animates.
* Click the black monolith and choose to stop animations
* Verify the Animesh model stops animating.
* Click the black monolith and choose to start animations.
* Relog.
* Verify the Animesh model is animating.
* Move to an adjacent region
* Verify the Animesh model is still animating.
* Relog.
* Verify the Animesh model is animating when viewed from an adjacent region.
* Click the black monolith and choose to stop animations
* Verify Animesh model stops animating.
* Click the black monolith and choose to start animations.
* Verify Animesh model animates.

===Non-root prims in an animated object should be able to start and stop animations===
Test is at secondlife://Aditi/secondlife/Animesh2/23/249/23
* Click the black monolith and choose to start animations.
* Verify the Animesh model animates.
* Click the black monolith and choose to stop animations
* Verify the Animesh model stops animating.

===Any animation triggered by any prim can drive any bone in the skeleton===
Test is at secondlife://Aditi/secondlife/Animesh2/37/249/23
* Click the black monolith and choose to start animations.
* Verify the man animates typing and turning at the same time. (Two scripts in the 2 boxes are playing animations on the skeleton.)
* Click the black monolith and choose to stop animations
* Verify the man stops animating.

===Animated objects should play only requested animations===
Test is at secondlife://Aditi/secondlife/Animesh2/37/249/23
* Enable Develop menu -> Avatar -> Animation info
* Click the black monolith and choose to start animations.
* Verify only 2 animations appear above the Animesh, then disappear, then repeat.

===Wear an animesh===
* Test is at secondlife://Aditi/secondlife/Animesh2/65/247/23
* Take 3 copies of the Teddy bear to your inventory.
* Attempt to add the 3 Teddy bears to different attachment points of your avatar.
* Verify this fails with an error that explains you cannot attach more animated objects. (Current limit is 1 - 2017/11/9)

===Teleport while wearing an animesh===
* Wear an animesh that animates. (e.g. the Teddy bear)
* Teleport to a far region, one that is not adjacent or kitty corner.
* Verify the animesh attachment continues to animate as expected. (e.g. the Teddy bear hold your hand and nods its head)
* Log an observer in and verify the attached animesh looks the same to them.
* Wait 1 minute before teleporting back.
* Teleport back to the original location.
* Verify the animesh attachment continues to animate as expected. (e.g. the Teddy bear hold your hand and nods its head)

===Log in while wearing an animesh===
* While wearing an animesh that animates (e.g. the Teddy bear), log out.
* Log an observer in.
* Log in the avatar wearing the animesh
* Verify the animesh attachment continues to animate as expected. (e.g. the Teddy bear hold your hand and nods its head)
* Verify the observe sees the same thing.
* Sit on an animesh
* Go to secondlife://Aditi/secondlife/Animesh2/78/247/23
* Take a copy of the animesh raptor.
* Rez the raptor.
* Right-click it and select Ride.
* Verify your avatar sits on the raptor.

===Sit on an animesh while wearing an animesh===
* While sitting on an animating animesh, attach an animating animesh.
* Verify the two animesh are animating.
* Log in an observer on an adjacent region
* Verify the observer sees the same thing.
* Log in an observer with a viewer that does not support Animesh (eg. http://wiki.secondlife.com/wiki/Release_Notes/Second_Life_Release/5.1.2.512803 ).
* Verify the observer sees the two animesh are but they are not animating.
* Verify the avatar is bent to to the shape of the animesh they are wearing. This is expected.

===Get list of currently playing animations===
Go to secondlife://Aditi/secondlife/Animesh2/7/247/23
* Take a copy of an Animesh object that is playing animations
* Rez the Animesh object.
* Add the following script to the Animesh object.
<pre>
default
{
state_entry()
{
llSay(0, "Hello, Avatar!");
llSetTimerEvent(1);
}
timer()
{
list curr_anims = llGetObjectAnimationNames();
llOwnerSay("curr_anims are " + (string) curr_anims);
}
}
</pre>
* Verify all playing animations are listed while it is animating and none are listed while animations not playing
* Cleanup: delete the animesh object.

===Enabling and Disabling Animated Mesh===
* Rez a copy of the bear from secondlife://Aditi/secondlife/Animesh2/90/247/23
* If the bear is not already dancing, click it to make it dance.
* Edit your bear, and uncheck the Animated Mesh checkbox
* Verify the bear stops dancing and is now in a T-pose.
* Verify observers see the same thing you do.
* Wear the default male avatar from Library / Clothing / Older Outfits / Boy Next Door
* Wear the bear on your right hand and walk around.
* Verify your avatar looks like a bear.
[[Image:Bear1.png]]
* Verify observers see the same thing you do.
* Edit the bear you are wearing and check the Animated Mesh checkbox.
* Verify the bear now appears attached to your hand and starts dancing
* Verify observers see the same thing you do.
* Edit the bear you are wearing and uncheck the Animated Mesh checkbox. Deselect the mesh.
* Verify your avatar looks like a bear again.
* Verify observers see the same thing you do.
* Detach the bear to Inventory
* Rez the bear on the ground.
* Verify the bear is in a T-pose, arms stretched to the sides.
* Edit your bear, and check the Animated Mesh checkbox
* If the bear is not already dancing, click it to make it dance.
* Verify observers see the same thing you do.
* Take a copy of box1 at secondlife://Aditi/secondlife/Animesh2/92/247/23 and rez it.
* Verify the Animated Mesh checkbox cannot be modified because you do not have modify permissions for the object.
* Take a copy of boxes2 at secondlife://Aditi/secondlife/Animesh2/95/248/23
* Verify the Animated Mesh checkbox can only be modified if you are modifying the whole linkset. If you are editing component prims ("Edit linked"), the Animated Mesh box should be disabled.
* Right-click edit the bear at secondlife://Aditi/secondlife/Animesh2/90/247/23
* Verify you can see the Animated Mesh checkbox is checked and grayed out.

===Animated mesh can be rezzed from object inventory.===
* Go to secondlife://Aditi/secondlife/Animesh2/101/248/23
* Take a copy of the popgun.
* Attach the popgun, press M to enter mouselook mode, and left-click to fire.
* Verify you see Raptors drop out of the gun and walk around.

===Selection and Editing===
* Verify you can select an animating Animesh by dragging a selection box around it while the Edit Tools (ctrl+3) are open.
* Verify all selected animated objects pause all of their animations for the person selecting them.
* Verify observers see the selected Animesh continue to animate.
* Unselecting any animated object should resume its animations.
* Verify you can select an animating Animesh with left-click while the Edit Tools (ctrl+3) are open. (known issue MAINT-7709)
* Verify you can select an animating Animesh with right-click. The standard object right-click menu will appear and the object will be shown with a wireframe.
* Verify selecting an animated object via the Build menu -> Region Objects floater behaves similarly - the animation is stopped. (This is only testable if you are estate owner or manager or parcel owner)
* Editing the translation and rotation of an animated object should work.
* Editing the scale of an animated object will not work.
* Moving an Animesh object across region boundaries while editing should work.

===Agent related text and controls should be hidden for Animesh===
* Hover the mouse cursor over the Animesh man at secondlife://Aditi/secondlife/Animesh2/7/247/23
* Verify that no hovertext appears about the object (This differs from regular objects.)
* Right-click the Animesh man and inspect the right-click menu.
* Verify there are no Agent related menu items, such as View Profile, Add friend, IM, Call, etc.
* Verify the right-click menu is a typical Object context menu.
[[Image:Animesh right-click1.png]]

File:Animesh right-click1.png

2018-06-11T22:22:28Z

Dan Linden:

Animesh Test

2018-06-11T22:06:58Z

Dan Linden: /* Enabling and Disabling Animated Mesh */

[[Category:Test Plans]]
[[Category:Content Tools]]

=NOTE: This test supports the new features of the Animesh viewer currently (March 2018) available for testing at [[Linden_Lab_Official:Alternate_Viewers]].=

==Purpose==
Test all functionality of the Animesh viewer.

==Test Plan==

===Stop / Start animation with LSL===
Test is at secondlife://Aditi/secondlife/Animesh2/7/247/23
* Click the black monolith and choose to start animations from the menu.
* Verify the Animesh model animates.
* Click the black monolith and choose to stop animations
* Verify the Animesh model stops animating.
* Click the black monolith and choose to start animations.
* Relog.
* Verify the Animesh model is animating.
* Move to an adjacent region
* Verify the Animesh model is still animating.
* Relog.
* Verify the Animesh model is animating when viewed from an adjacent region.
* Click the black monolith and choose to stop animations
* Verify Animesh model stops animating.
* Click the black monolith and choose to start animations.
* Verify Animesh model animates.

===Non-root prims in an animated object should be able to start and stop animations===
Test is at secondlife://Aditi/secondlife/Animesh2/23/249/23
* Click the black monolith and choose to start animations.
* Verify the Animesh model animates.
* Click the black monolith and choose to stop animations
* Verify the Animesh model stops animating.

===Any animation triggered by any prim can drive any bone in the skeleton===
Test is at secondlife://Aditi/secondlife/Animesh2/37/249/23
* Click the black monolith and choose to start animations.
* Verify the man animates typing and turning at the same time. (Two scripts in the 2 boxes are playing animations on the skeleton.)
* Click the black monolith and choose to stop animations
* Verify the man stops animating.

===Animated objects should play only requested animations===
Test is at secondlife://Aditi/secondlife/Animesh2/37/249/23
* Enable Develop menu -> Avatar -> Animation info
* Click the black monolith and choose to start animations.
* Verify only 2 animations appear above the Animesh, then disappear, then repeat.

===Wear an animesh===
* Test is at secondlife://Aditi/secondlife/Animesh2/65/247/23
* Take 3 copies of the Teddy bear to your inventory.
* Attempt to add the 3 Teddy bears to different attachment points of your avatar.
* Verify this fails with an error that explains you cannot attach more animated objects. (Current limit is 1 - 2017/11/9)

===Teleport while wearing an animesh===
* Wear an animesh that animates. (e.g. the Teddy bear)
* Teleport to a far region, one that is not adjacent or kitty corner.
* Verify the animesh attachment continues to animate as expected. (e.g. the Teddy bear hold your hand and nods its head)
* Log an observer in and verify the attached animesh looks the same to them.
* Wait 1 minute before teleporting back.
* Teleport back to the original location.
* Verify the animesh attachment continues to animate as expected. (e.g. the Teddy bear hold your hand and nods its head)

===Log in while wearing an animesh===
* While wearing an animesh that animates (e.g. the Teddy bear), log out.
* Log an observer in.
* Log in the avatar wearing the animesh
* Verify the animesh attachment continues to animate as expected. (e.g. the Teddy bear hold your hand and nods its head)
* Verify the observe sees the same thing.
* Sit on an animesh
* Go to secondlife://Aditi/secondlife/Animesh2/78/247/23
* Take a copy of the animesh raptor.
* Rez the raptor.
* Right-click it and select Ride.
* Verify your avatar sits on the raptor.

===Sit on an animesh while wearing an animesh===
* While sitting on an animating animesh, attach an animating animesh.
* Verify the two animesh are animating.
* Log in an observer on an adjacent region
* Verify the observer sees the same thing.
* Log in an observer with a viewer that does not support Animesh (eg. http://wiki.secondlife.com/wiki/Release_Notes/Second_Life_Release/5.1.2.512803 ).
* Verify the observer sees the two animesh are but they are not animating.
* Verify the avatar is bent to to the shape of the animesh they are wearing. This is expected.

===Get list of currently playing animations===
Go to secondlife://Aditi/secondlife/Animesh2/7/247/23
* Take a copy of an Animesh object that is playing animations
* Rez the Animesh object.
* Add the following script to the Animesh object.
<pre>
default
{
state_entry()
{
llSay(0, "Hello, Avatar!");
llSetTimerEvent(1);
}
timer()
{
list curr_anims = llGetObjectAnimationNames();
llOwnerSay("curr_anims are " + (string) curr_anims);
}
}
</pre>
* Verify all playing animations are listed while it is animating and none are listed while animations not playing
* Cleanup: delete the animesh object.

===Enabling and Disabling Animated Mesh===
* Rez a copy of the bear from secondlife://Aditi/secondlife/Animesh2/90/247/23
* If the bear is not already dancing, click it to make it dance.
* Edit your bear, and uncheck the Animated Mesh checkbox
* Verify the bear stops dancing and is now in a T-pose.
* Verify observers see the same thing you do.
* Wear the default male avatar from Library / Clothing / Older Outfits / Boy Next Door
* Wear the bear on your right hand and walk around.
* Verify your avatar looks like a bear.
[[Image:Bear1.png]]
* Verify observers see the same thing you do.
* Edit the bear you are wearing and check the Animated Mesh checkbox.
* Verify the bear now appears attached to your hand and starts dancing
* Verify observers see the same thing you do.
* Edit the bear you are wearing and uncheck the Animated Mesh checkbox. Deselect the mesh.
* Verify your avatar looks like a bear again.
* Verify observers see the same thing you do.
* Detach the bear to Inventory
* Rez the bear on the ground.
* Verify the bear is in a T-pose, arms stretched to the sides.
* Edit your bear, and check the Animated Mesh checkbox
* If the bear is not already dancing, click it to make it dance.
* Verify observers see the same thing you do.
* Take a copy of box1 at secondlife://Aditi/secondlife/Animesh2/92/247/23 and rez it.
* Verify the Animated Mesh checkbox cannot be modified because you do not have modify permissions for the object.
* Take a copy of boxes2 at secondlife://Aditi/secondlife/Animesh2/95/248/23
* Verify the Animated Mesh checkbox can only be modified if you are modifying the whole linkset. If you are editing component prims ("Edit linked"), the Animated Mesh box should be disabled.
* Right-click edit the bear at secondlife://Aditi/secondlife/Animesh2/90/247/23
* Verify you can see the Animated Mesh checkbox is checked and grayed out.

===Animated mesh can be rezzed from object inventory.===
* Go to secondlife://Aditi/secondlife/Animesh2/101/248/23
* Take a copy of the popgun.
* Attach the popgun, press M to enter mouselook mode, and left-click to fire.
* Verify you see Raptors drop out of the gun and walk around.

===Selection and Editing===
* Verify you can select an animating Animesh by dragging a selection box around it while the Edit Tools (ctrl+3) are open.
* Verify all selected animated objects pause all of their animations for the person selecting them.
* Verify observers see the selected Animesh continue to animate.
* Unselecting any animated object should resume its animations.
* Verify you can select an animating Animesh with left-click while the Edit Tools (ctrl+3) are open. (known issue MAINT-7709)
* Verify you can select an animating Animesh with right-click. The standard object right-click menu will appear and the object will be shown with a wireframe.
* Verify selecting an animated object via the Build menu -> Region Objects floater behaves similarly - the animation is stopped. (This is only testable if you are estate owner or manager or parcel owner)
* Editing the translation and rotation of an animated object should work.
* Editing the scale of an animated object will not work.
* Moving an Animesh object across region boundaries while editing should work.

Animesh Test

2018-06-11T21:49:58Z

Dan Linden: /* Selection and Editing */

[[Category:Test Plans]]
[[Category:Content Tools]]

=NOTE: This test supports the new features of the Animesh viewer currently (March 2018) available for testing at [[Linden_Lab_Official:Alternate_Viewers]].=

==Purpose==
Test all functionality of the Animesh viewer.

==Test Plan==

===Stop / Start animation with LSL===
Test is at secondlife://Aditi/secondlife/Animesh2/7/247/23
* Click the black monolith and choose to start animations from the menu.
* Verify the Animesh model animates.
* Click the black monolith and choose to stop animations
* Verify the Animesh model stops animating.
* Click the black monolith and choose to start animations.
* Relog.
* Verify the Animesh model is animating.
* Move to an adjacent region
* Verify the Animesh model is still animating.
* Relog.
* Verify the Animesh model is animating when viewed from an adjacent region.
* Click the black monolith and choose to stop animations
* Verify Animesh model stops animating.
* Click the black monolith and choose to start animations.
* Verify Animesh model animates.

===Non-root prims in an animated object should be able to start and stop animations===
Test is at secondlife://Aditi/secondlife/Animesh2/23/249/23
* Click the black monolith and choose to start animations.
* Verify the Animesh model animates.
* Click the black monolith and choose to stop animations
* Verify the Animesh model stops animating.

===Any animation triggered by any prim can drive any bone in the skeleton===
Test is at secondlife://Aditi/secondlife/Animesh2/37/249/23
* Click the black monolith and choose to start animations.
* Verify the man animates typing and turning at the same time. (Two scripts in the 2 boxes are playing animations on the skeleton.)
* Click the black monolith and choose to stop animations
* Verify the man stops animating.

===Animated objects should play only requested animations===
Test is at secondlife://Aditi/secondlife/Animesh2/37/249/23
* Enable Develop menu -> Avatar -> Animation info
* Click the black monolith and choose to start animations.
* Verify only 2 animations appear above the Animesh, then disappear, then repeat.

===Wear an animesh===
* Test is at secondlife://Aditi/secondlife/Animesh2/65/247/23
* Take 3 copies of the Teddy bear to your inventory.
* Attempt to add the 3 Teddy bears to different attachment points of your avatar.
* Verify this fails with an error that explains you cannot attach more animated objects. (Current limit is 1 - 2017/11/9)

===Teleport while wearing an animesh===
* Wear an animesh that animates. (e.g. the Teddy bear)
* Teleport to a far region, one that is not adjacent or kitty corner.
* Verify the animesh attachment continues to animate as expected. (e.g. the Teddy bear hold your hand and nods its head)
* Log an observer in and verify the attached animesh looks the same to them.
* Wait 1 minute before teleporting back.
* Teleport back to the original location.
* Verify the animesh attachment continues to animate as expected. (e.g. the Teddy bear hold your hand and nods its head)

===Log in while wearing an animesh===
* While wearing an animesh that animates (e.g. the Teddy bear), log out.
* Log an observer in.
* Log in the avatar wearing the animesh
* Verify the animesh attachment continues to animate as expected. (e.g. the Teddy bear hold your hand and nods its head)
* Verify the observe sees the same thing.
* Sit on an animesh
* Go to secondlife://Aditi/secondlife/Animesh2/78/247/23
* Take a copy of the animesh raptor.
* Rez the raptor.
* Right-click it and select Ride.
* Verify your avatar sits on the raptor.

===Sit on an animesh while wearing an animesh===
* While sitting on an animating animesh, attach an animating animesh.
* Verify the two animesh are animating.
* Log in an observer on an adjacent region
* Verify the observer sees the same thing.
* Log in an observer with a viewer that does not support Animesh (eg. http://wiki.secondlife.com/wiki/Release_Notes/Second_Life_Release/5.1.2.512803 ).
* Verify the observer sees the two animesh are but they are not animating.
* Verify the avatar is bent to to the shape of the animesh they are wearing. This is expected.

===Get list of currently playing animations===
Go to secondlife://Aditi/secondlife/Animesh2/7/247/23
* Take a copy of an Animesh object that is playing animations
* Rez the Animesh object.
* Add the following script to the Animesh object.
<pre>
default
{
state_entry()
{
llSay(0, "Hello, Avatar!");
llSetTimerEvent(1);
}
timer()
{
list curr_anims = llGetObjectAnimationNames();
llOwnerSay("curr_anims are " + (string) curr_anims);
}
}
</pre>
* Verify all playing animations are listed while it is animating and none are listed while animations not playing
* Cleanup: delete the animesh object.

===Enabling and Disabling Animated Mesh===
* Rez a copy of the bear from secondlife://Aditi/secondlife/Animesh2/90/247/23
* If the bear is not already dancing, click it to make it dance.
* Edit your bear, and uncheck the Animated Mesh checkbox
* Verify the bear stops dancing and is now in a T-pose.
* Verify observers see the same thing you do.
* Wear the default male avatar from Library / Clothing / Older Outfits / Boy Next Door
* Wear the bear on your right hand and walk around.
* Verify your avatar looks like a bear.
[[Image:Bear1.png]]
* Verify observers see the same thing you do.
* Edit the bear you are wearing and check the Animated Mesh checkbox.
* Verify the bear now appears attached to your hand and starts dancing
* Verify observers see the same thing you do.
* Edit the bear you are wearing and uncheck the Animated Mesh checkbox. Deselect the mesh.
* Verify your avatar looks like a bear again.
* Verify observers see the same thing you do.
* Detach the bear to Inventory
* Rez the bear on the ground.
* Verify the bear is in a T-pose, arms stretched to the sides.
* Edit your bear, and check the Animated Mesh checkbox
* If the bear is not already dancing, click it to make it dance.
* Verify observers see the same thing you do.
* Verify the Animated Mesh checkbox can only be modified if you have modify permissions for the object.
** Test this with a copy of box1 at secondlife://Aditi/secondlife/Animesh2/92/247/23
* Verify the Animated Mesh checkbox can only be modified if you are modifying the whole linkset. If you are editing component prims ("Edit linked"), the box should be disabled.
** Test this with a copy of boxes2 at secondlife://Aditi/secondlife/Animesh2/95/248/23

===Animated mesh can be rezzed from object inventory.===
* Go to secondlife://Aditi/secondlife/Animesh2/101/248/23
* Take a copy of the popgun.
* Attach the popgun, press M to enter mouselook mode, and left-click to fire.
* Verify you see Raptors drop out of the gun and walk around.

===Selection and Editing===
* Verify you can select an animating Animesh by dragging a selection box around it while the Edit Tools (ctrl+3) are open.
* Verify all selected animated objects pause all of their animations for the person selecting them.
* Verify observers see the selected Animesh continue to animate.
* Unselecting any animated object should resume its animations.
* Verify you can select an animating Animesh with left-click while the Edit Tools (ctrl+3) are open. (known issue MAINT-7709)
* Verify you can select an animating Animesh with right-click. The standard object right-click menu will appear and the object will be shown with a wireframe.
* Verify selecting an animated object via the Build menu -> Region Objects floater behaves similarly - the animation is stopped. (This is only testable if you are estate owner or manager or parcel owner)
* Editing the translation and rotation of an animated object should work.
* Editing the scale of an animated object will not work.
* Moving an Animesh object across region boundaries while editing should work.

Animesh Test

2018-06-11T21:38:03Z

Dan Linden: /* Enabling and Disabling Animated Mesh */

[[Category:Test Plans]]
[[Category:Content Tools]]

=NOTE: This test supports the new features of the Animesh viewer currently (March 2018) available for testing at [[Linden_Lab_Official:Alternate_Viewers]].=

==Purpose==
Test all functionality of the Animesh viewer.

==Test Plan==

===Stop / Start animation with LSL===
Test is at secondlife://Aditi/secondlife/Animesh2/7/247/23
* Click the black monolith and choose to start animations from the menu.
* Verify the Animesh model animates.
* Click the black monolith and choose to stop animations
* Verify the Animesh model stops animating.
* Click the black monolith and choose to start animations.
* Relog.
* Verify the Animesh model is animating.
* Move to an adjacent region
* Verify the Animesh model is still animating.
* Relog.
* Verify the Animesh model is animating when viewed from an adjacent region.
* Click the black monolith and choose to stop animations
* Verify Animesh model stops animating.
* Click the black monolith and choose to start animations.
* Verify Animesh model animates.

===Non-root prims in an animated object should be able to start and stop animations===
Test is at secondlife://Aditi/secondlife/Animesh2/23/249/23
* Click the black monolith and choose to start animations.
* Verify the Animesh model animates.
* Click the black monolith and choose to stop animations
* Verify the Animesh model stops animating.

===Any animation triggered by any prim can drive any bone in the skeleton===
Test is at secondlife://Aditi/secondlife/Animesh2/37/249/23
* Click the black monolith and choose to start animations.
* Verify the man animates typing and turning at the same time. (Two scripts in the 2 boxes are playing animations on the skeleton.)
* Click the black monolith and choose to stop animations
* Verify the man stops animating.

===Animated objects should play only requested animations===
Test is at secondlife://Aditi/secondlife/Animesh2/37/249/23
* Enable Develop menu -> Avatar -> Animation info
* Click the black monolith and choose to start animations.
* Verify only 2 animations appear above the Animesh, then disappear, then repeat.

===Wear an animesh===
* Test is at secondlife://Aditi/secondlife/Animesh2/65/247/23
* Take 3 copies of the Teddy bear to your inventory.
* Attempt to add the 3 Teddy bears to different attachment points of your avatar.
* Verify this fails with an error that explains you cannot attach more animated objects. (Current limit is 1 - 2017/11/9)

===Teleport while wearing an animesh===
* Wear an animesh that animates. (e.g. the Teddy bear)
* Teleport to a far region, one that is not adjacent or kitty corner.
* Verify the animesh attachment continues to animate as expected. (e.g. the Teddy bear hold your hand and nods its head)
* Log an observer in and verify the attached animesh looks the same to them.
* Wait 1 minute before teleporting back.
* Teleport back to the original location.
* Verify the animesh attachment continues to animate as expected. (e.g. the Teddy bear hold your hand and nods its head)

===Log in while wearing an animesh===
* While wearing an animesh that animates (e.g. the Teddy bear), log out.
* Log an observer in.
* Log in the avatar wearing the animesh
* Verify the animesh attachment continues to animate as expected. (e.g. the Teddy bear hold your hand and nods its head)
* Verify the observe sees the same thing.
* Sit on an animesh
* Go to secondlife://Aditi/secondlife/Animesh2/78/247/23
* Take a copy of the animesh raptor.
* Rez the raptor.
* Right-click it and select Ride.
* Verify your avatar sits on the raptor.

===Sit on an animesh while wearing an animesh===
* While sitting on an animating animesh, attach an animating animesh.
* Verify the two animesh are animating.
* Log in an observer on an adjacent region
* Verify the observer sees the same thing.
* Log in an observer with a viewer that does not support Animesh (eg. http://wiki.secondlife.com/wiki/Release_Notes/Second_Life_Release/5.1.2.512803 ).
* Verify the observer sees the two animesh are but they are not animating.
* Verify the avatar is bent to to the shape of the animesh they are wearing. This is expected.

===Get list of currently playing animations===
Go to secondlife://Aditi/secondlife/Animesh2/7/247/23
* Take a copy of an Animesh object that is playing animations
* Rez the Animesh object.
* Add the following script to the Animesh object.
<pre>
default
{
state_entry()
{
llSay(0, "Hello, Avatar!");
llSetTimerEvent(1);
}
timer()
{
list curr_anims = llGetObjectAnimationNames();
llOwnerSay("curr_anims are " + (string) curr_anims);
}
}
</pre>
* Verify all playing animations are listed while it is animating and none are listed while animations not playing
* Cleanup: delete the animesh object.

===Enabling and Disabling Animated Mesh===
* Rez a copy of the bear from secondlife://Aditi/secondlife/Animesh2/90/247/23
* If the bear is not already dancing, click it to make it dance.
* Edit your bear, and uncheck the Animated Mesh checkbox
* Verify the bear stops dancing and is now in a T-pose.
* Verify observers see the same thing you do.
* Wear the default male avatar from Library / Clothing / Older Outfits / Boy Next Door
* Wear the bear on your right hand and walk around.
* Verify your avatar looks like a bear.
[[Image:Bear1.png]]
* Verify observers see the same thing you do.
* Edit the bear you are wearing and check the Animated Mesh checkbox.
* Verify the bear now appears attached to your hand and starts dancing
* Verify observers see the same thing you do.
* Edit the bear you are wearing and uncheck the Animated Mesh checkbox. Deselect the mesh.
* Verify your avatar looks like a bear again.
* Verify observers see the same thing you do.
* Detach the bear to Inventory
* Rez the bear on the ground.
* Verify the bear is in a T-pose, arms stretched to the sides.
* Edit your bear, and check the Animated Mesh checkbox
* If the bear is not already dancing, click it to make it dance.
* Verify observers see the same thing you do.
* Verify the Animated Mesh checkbox can only be modified if you have modify permissions for the object.
** Test this with a copy of box1 at secondlife://Aditi/secondlife/Animesh2/92/247/23
* Verify the Animated Mesh checkbox can only be modified if you are modifying the whole linkset. If you are editing component prims ("Edit linked"), the box should be disabled.
** Test this with a copy of boxes2 at secondlife://Aditi/secondlife/Animesh2/95/248/23

===Selection and Editing===
* Verify you can select an animating Animesh by dragging a selection box around it while the Edit Tools (ctrl+3) are open.
* Verify all selected animated objects pause all of their animations for the person selecting them.
* Verify observers see the selected Animesh continue to animate.
* Unselecting any animated object should resume its animations.
* Verify you can select an animating Animesh with left-click while the Edit Tools (ctrl+3) are open. (known issue MAINT-7709)
* Verify you can select an animating Animesh with right-click. The standard object right-click menu will appear and the object will be shown with a wireframe.
* Verify selecting an animated object via the Build menu -> Region Objects floater behaves similarly - the animation is stopped. (This is only testable if you are estate owner or manager or parcel owner)
* Editing the translation and rotation of an animated object should work.
* Editing the scale of an animated object will not work.
* Moving an Animesh object across region boundaries while editing should work.

Animesh Test

2018-06-11T21:21:18Z

Dan Linden: /* Enabling and Disabling Object Animation */

Animesh Test

2018-06-11T21:18:09Z

Dan Linden:

File:Bear1.png

2018-06-11T20:27:28Z

Dan Linden:

Animesh Test

2018-06-11T20:26:49Z

Dan Linden:

Content Creation User Group

2018-05-21T21:25:38Z

Dan Linden:

The Content Creation User Group meeting is a weekly, public meeting intended for discussion of issues around content creation, including avatars, animations, mesh, etc. Vir Linden is the moderator. Please bring questions, requests, and especially cool new things to show off!

Normal schedule is to meet every Thursday at 1:00PM SLT, except the first Thursday of the month. Exceptions will be noted here.

'''Upcoming meetings'''. Location: While animesh is in testing, we will be having our meetings in Aditi: secondlife://Aditi/secondlife/Animesh4/132/138/23

* Thursday, May 24, 1:00PM SLT
* Thursday, May 31, 1:00PM SLT

== Agenda ==
* Open Q&A

Notes
* Animesh is out as a project viewer with test regions on Aditi. Links: [https://community.secondlife.com/blogs/entry/2258-join-the-project-animesh-beta-new-support-for-animating-mesh-objects/ blog post], [https://wiki.secondlife.com/wiki/Animesh_User_Guide user guide], [https://community.secondlife.com/forums/forum/354-animesh/ forum]
* Bakes On Mesh is out as a project viewer that should work anywhere - see the [https://community.secondlife.com/forums/topic/420617-bakes-on-mesh-feedback-thread/ forum post]
* ARCTan, a project to update rendering cost, land impact, and related things like mesh upload costs, is in progress.
* Project EEP, which will give advanced configurable windlight environments for regions and parcels, is in progress.


=== User Questions & Topics ===

Animesh Test

2018-05-10T23:14:25Z

Dan Linden: /* Wear / sit on animesh */

Animesh Test

2018-05-04T18:40:34Z

Dan Linden: /* Any animation triggered by any prim can drive any bone in the skeleton */

Animesh Test

2018-05-04T18:36:34Z

Dan Linden: /* Any animation triggered by any prim can drive any bone in the skeleton */