Second Life Wiki - User contributions [en]

Pathfinding Tools in the Second Life Viewer

2012-12-12T22:10:23Z

Stinson Linden: /* Known Issues */

{{Pathfinding Nav}}
__TOC__
== Introduction ==
For pathfinding, each region has a navigation mesh, commonly referred to as a "'''navmesh'''". The '''navmesh''' is a representation of the region's geometry generated and used by the physics simulator to determine paths for the pathfinding characters. The navmesh may be in one of the following three states:

* Up-to-date
* Has pending changes
* Building ''(a.k.a. rebaking)''

The navmesh will transition through these states according to the following diagram:

[[File:Navmesh_transitions.png|alt=Second Life Pathfinding NavMesh Transitions|Second Life Pathfinding NavMesh Transitions]]

Six new elements have been added to the SL Viewer interface to communicate the navmesh state for the current region. These new elements are:

* icon representations of the pathfinding region state for the SLURL bar
* a "Rebake region" button that appears above the lower toolbar
* a right-click context menu option addition
* an additional field on the Build floater
* an additional field on the Object Profile floater
* additional simulator metrics on the Statistics floater

In addition to these new elements, three new floaters allow users to more efficiently create, visualize, test, and debug pathfinding-enabled characters. These tools are not required to create pathfinding behaviors but are particularly useful to builders and experienced creators in Second Life. These new floaters are:

* Pathfinding linksets
* Pathfinding characters
* Pathfinding view / test

== Pathfinding UI Elements ==

'''Note that other residents editing pathfinding objects on the same region may create pending changes to the navmesh.''' When this occurs, all residents on the same region and with build rights will see the appropriate SLURL bar icons and rebake region button.

=== Pathfinding Icons in SLURL Bar ===

The SLURL bar indicates the three pathfinding states of the current region.
# '''Navmesh is up-to-date''' The current region's navmesh is up-to-date. No icon is shown as this is the expected default state. [[File:Pathfinding-clean-region-1.png|alt=Second Life URL Bar with Up-to-Date NavMesh Icon|Second Life URL Bar with Up-to-Date NavMesh Icon]]
# '''Navmesh has pending changes''' The region has pending changes that have not yet been baked into the navmesh. A pathfinding icon with a construction symbol is shown. [[File:Pathfinding-dirty-region-1.png|alt=Second Life URL Bar with Pending Changes Icon|Second Life URL Bar with Pending Changes Icon]]
# '''Dynamic pathfinding is disabled''' The region has dynamic pathfinding disabled. Pathfinding characters will not work as expected. A pathfinding icon with a disabled symbol is shown. [[File:Pathfinding-disabled-region-1.png|alt=Second Life URL Bar with Pathfinding Disabled Icon|Second Life URL Bar with Pathfinding Disabled Icon]]

=== Rebake Region Button ===

When a region has pending changes, the appropriate icon will be shown in the SLURL bar, as described above. In addition, if the user has build rights for any parcel on the current region, the user will also be able to see a "Rebake region" button that displays above the lower toolbar.

[[File:Rebake-button-1.png|alt=Second Life Rebake Region button that allows permitted users to rebake pathfinding changes into the navmesh]]

When the user clicks this button, a request is sent to the region to rebake the navmesh for the current region. As rebaking a region may be a time intensive process, the button will change to indicate "Region is rebaking" during this server process. After the rebaking is complete, this button on the viewer will vanish.

[[File:Rebaking-button-1.png|alt=Second Life Region is Rebaking button that indicates that the current region is rebaking its navmesh]]

=== Right-click context menu behavior ===

When right-clicking on an object in-world, pathfinding-specific menu options may be included in the pop-up context menu.

If the user right-clicks on a '''linkset''' object in-world, a menu option "Show in linksets" will allow the user to open the Pathfinding Linksets floater with the current object selected.

[[File:Right-click-show-in-linksets-1.png|alt=Second Life Context Menu with Show in Linksets floater menu option]]

If the user right-clicks on a pathfinding '''character''' object in-world, a menu option "Show in characters" will allow the user to open the Pathfinding Characters floater with the current object selected.

[[File:Right-click-show-in-characters-1.png|alt=Second Life Context Menu with Show in Characters floater menu option]]

=== Additional field on the Build floater ===

The Build floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Build floater with a ''character'' object selected.

[[File:Build-floater-character-1.png|alt=Build floater with pathfinding attribute character|Build floater with pathfinding attribute character]]

The following image is a screenshot of the Build floater with an object that ''affects navmesh'' selected. This object could be a ''walkable'', ''static obstacle'', ''material volume'', or ''exclusion volume''.

[[File:Build-floater-affects-navmesh-1.png|alt=Build floater with pathfinding attribute affects navmesh|Build floater with pathfinding attribute affects navmesh]]

{{KBwarning|For linksets that do affect the navmesh, it will be impossible to modify the object across the region boundary. The user and the object affecting a navmesh must be in the same region to enable modification of the object. This will be indicated on the General tab of the Build floater as illustrated in the following screenshot.}}
[[File:Build-floater-region-boundary-1.png|alt=Build floater indicating that the user cannot modify object across a region boundary|Build floater indicating that the user cannot modify object across a region boundary]]

=== Additional field on the Object Profile floater ===

Similar to the afore-described Build floater, the Object Profile floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Object Profile floater with an ''affects navmesh'' object selected.

[[File:Object-profile-1.png|alt=Object Profile floater with pathfinding attribute affects navmesh|Object Profile floater with pathfinding attribute affects navmesh]]

=== Additional simulator metrics on the Statistics floater ===

For advanced users, additional simulator metrics have been added to the Statistics floater. The Statistics floater, available from the main menu Advanced > Performance Tools > Statistics Bar, has the following 3 additional fields reporting statistics from the simulator regarding pathfinding activity:

* '''AI Step Time''' - The average time spent during each frame computing character AI events.
* '''Skipped Silhouette Steps''' - The number of steps that are skipped per second in computing the influence of objects of type ''Movable Obstacles'' on the navmesh. A high value here means that objects on the region are marked as ''Movable Obstacles'' and could be contributing to improper pathfinding behavior on the region. To lower this value, set all objects that do not move to either type ''Walkable'' or ''Static Obstacle'', and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]].
* '''Characters Updated''' - The average percentage of characters updated during each frame. A low value here means that character AI computations are taking too long during each frame, and thus some character updates are skipped during subsequent frames. This could be contributing to improper pathfinding behavior on the region. To increase this value, decrease the number of characters on the region, and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]]. Note that the Pathfinding Characters floater (described below) may also be used to determine which characters on the region are contributing the most to the region's CPU time.

[[File:Pathfinding-stats-2.png|alt=Simulator Statistics floater with additional pathfinding statistics|Simulator Statistics floater with additional pathfinding statistics]]

== Pathfinding Floaters ==

These three pathfinding floaters may all be accessed through the Build->Pathfinding menu in the Project Viewer - Pathfinding.

[[File:Build-menu-pf-selected-1.png|alt=Second Life Build Menu with new Pathfinding menu items|SL Build -> Pathfinding Menu]]

 

=== Pathfinding Linksets Floater ===

==== Overview ====

The intent of the Pathfinding Linksets floater is to give advanced users and builders the ability to customize an area to achieve interesting effects with pathfinding-enabled characters. It can be initiated using the Build->Pathfinding->LinkSets options in the viewer menu.

The floater displays information for all linksets within the current region for which the user has the ability to alter. The table reports useful information including
* Linkset Name
* Description
* Owner
* Whether the object is Scripted
* Land Impact
* Distance from the resident's avatar
* Linkset Use
** Potential values
*** Walkable
*** Static Obstacle
*** Movable Obstacle
*** Material Volume
*** Exclusion Volume
*** Movable Phantom
* Walkability Coefficients
** Character Type A ''(example use: humanoid)''
** Character Type B ''(example use: creature)''
** Character Type C ''(example use: mechanical)''
** Character Type D ''(example use: other)''

Additionally, selecting any linksets within the floater will also select the object(s) within the Viewer.

[[File:Linksets-floater-3.png|alt=Pathfinding Linksets floater|Pathfinding Linksets]]

 

==== Controls ====

{{:Viewerhelp:Pathfinding linksets}}

==== Example use ====

The advanced users and builders will use the Pathfinding Linksets floater to customize areas to create interesting effects for pathfinding-enabled characters.

For instance, imagine the scenario of a builder constructing a single room in a pathfinding-enabled house. For the single room, the builder would use the following types as follows:

{|border="1"
! Linkset Use !! Description
|-
|width="200" align="center" | Walkable || align="left" | The floor linkset would be set to be Walkable to allow characters to move across the floor.
|-
|width="200" align="center" | Static Obstacle || align="left" | A desk linkset in the room would be set to be Static Obstacle to block characters from walking through or across the object.

NOTE Any object that should block character movement and that does not move should be marked as Static Obstacle to improve performance of pathfinding characters.
|-
|width="200" align="center" | Movable Obstacle || align="left" | A door linkset in the room would be set to be Movable Obstacle. This will still block characters but, in contrast to Static Obstacles, Movable Obstacles will allow the linkset itself to move. In the case of the door, this will allow the door to open and close, but will still prevent characters from walking through the door.
|-
|width="200" align="center" | Material Volume || align="left" | Material Volumes are phantom objects that can be used to affect the walkability coefficients of intersecting objects. Imagine that the builder applied a texture to the floor. Also, imagine that the floor texture includes small throw rug in the middle of the room. (The builder did not want to create a separate object for the rug, so is using a texture on the floor to give the appearance of a rug). The builder can then create a Material Volume object intersecting the floor at the location of the rug. Then, by setting a lower walkability coefficient for the Material Volume, the builder will create the affect of slowing down characters as the characters traverse across the painted rug area.
|-
|width="200" align="center" | Exclusion Volume || align="left" | Exclusion Volumes are phantom objects that can be used to create areas where characters are prevented from moving. For instance, the builder can use an Exclusion Volume to create a section of the room where avatars would be able to move, but characters would be blocked from following.
|-
|width="200" align="center" | Movable Phantom || align="left" | Movable Phantoms are phantom objects that have no affect on pathfinding-enabled characters.
|}
 
In addition to linkset use attributes, builders can achieve additional effects by modifying the walkability coefficients for linksets. The walkability coefficients are values, ranging from 0% to 100%, that affect a characters speed. A walkability coefficient of 50% will reduce a character's speed by half while the character is traversing across the linkset.
 

=== Pathfinding Characters Floater ===

==== Overview ====
The intent of Pathfinding Characters floater is primarily for users to locate characters moving throughout a region and to identify the CPU cost of characters affecting the performance of a region. It can be initiated using the Build->Pathfinding->Characters options in the viewer menu.

The floater displays information for all characters within the current region for which the user has the ability to manipulate. The table reports useful information including
* Character Name
* Description
* Owner
* CPU Time
* Altitude

[[File:Characters-floater-1.png|alt=Pathfinding Characters floater|Pathfinding Characters]]
 
==== Controls ====

{{:Viewerhelp:Pathfinding characters}}

==== Example use ====
# If a region owner has created a pathfinding-enabled character but is unable to find the character within the region, the Characters floater can be used to locate and select the character.
# Additionally, the Pathfinding Characters floater reports the CPU time cost for each character within the region. This functionality can be used by advanced users to identify which characters are impacting performance the most.

=== Pathfinding View/Test Floater ===

==== Overview ====

The intent of the Pathfinding View/Test floater is for advanced users who are building pathfinding-enabled objects and characters. It can be initiated using the Build->Pathfinding->View/Test options in the viewer menu.

This floater consists of 3 basic areas.

# Status area (illustrating both the Viewer and Simulator status of the region's navmesh)
# View tab Controls
# Test Path tab Controls

The following image is a screenshot of the Pathfinding View/Test floater with the navmesh displayed.

[[File:View-nav-mesh-1.png|alt=Pathfinding View/Test floater with the navmesh displayed|Pathfinding View/Test with navmesh displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with the pathfinding object types displayed.

[[File:View-pf-types-1.png|alt=Pathfinding View/Test floater with the pathfinding object types displayed|Pathfinding View/Test with the pathfinding object types displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with a test path displayed.

[[File:View-test-path-1.png|alt=Pathfinding View/Test floater with a test path displayed|Pathfinding View/Test with a test path displayed]]

 
==== Controls ====

{{:Viewerhelp:Pathfinding edit and test}}

==== Example Use ====

# The advanced user will use the Visualization controls to visualize how the navmesh and related permanent objects have been generated. By seeing this visualization of how the physics engine interprets the navigation information, the advanced user can understand how to better customize the pathfinding-enabled objects to obtain the desired behaviors of characters.
# The advanced user will use the Test Tab to visualize how a test character would choose the path between selected start and end points.

 

== Known Issues ==

{| style="border-style:solid;border-width:2px 0 2px 0px;"
! style="border-style:solid;border-width:0 0 1px 0" width="130" | JIRA
! style="border-style:solid;border-width:0 0 1px 0" width="300" | Summary
! style="border-style:solid;border-width:0 0 1px 0" width="550" | Hardware
! style="border-style:solid;border-width:0 0 1px 0" width="100" | Fixed in Version
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1291 MAINT-1291]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Enable Debug GL crashes the viewer to the desktop
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac Pro running 10.7.4 with AMD Radeon HD5770 iMac running Mac OS X Lion 10.7.4 (11E53) with AMD Radeon HD 6770M (512 MB) PC Clone running XP Pro with GeForce2 Ultra
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1745 MAINT-1745]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Crash in the viewer relating to LLLoginInstance and constructAuthParams
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-2071 MAINT-2071]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Underwater 'Walkables' shapes are reflected about the water plane
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-2072 MAINT-2072]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | navmesh being drawn over worn flexi prims and under avatar
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-2073 MAINT-2073]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Physics capsule rendering of character shapes is broken after zooming
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-2074 MAINT-2074]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Configuration with ATI Radeon 7500 can launch Viewer, serious GFx issues
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | AMD Athlon64 3000+ with ATI Radeon 7500 video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-2075 MAINT-2075] [https://jira.secondlife.com/browse/VWR-29500 VWR-29500]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Shadows not operational under Second Life Beta 3.4.0.262596
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac OS X 10.7.4 with ATI Radeon X1600 OpenGL Engine video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-2076 MAINT-2076]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | The navmesh starts blinking on empty regions while 'Movables only' and 'Navmesh' checkboxes are checked in View/test floater
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-2093 MAINT-2093]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Navmesh objects disappear in 'Movables only' view while user turning around
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-2094 MAINT-2094]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [BetaBreakers] - Sony VAIO PCG-71211 laptop displays black environment
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Sony VAIO PCG-71211 laptop with AMD Radeon HD5650M Mobile graphics
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|}

Pathfinding Tools in the Second Life Viewer

2012-12-10T23:59:50Z

Stinson Linden: /* Known Issues */

Pathfinding Tools in the Second Life Viewer

2012-11-14T21:42:02Z

Stinson Linden: /* Known Issues */

Pathfinding Tools in the Second Life Viewer

2012-10-11T21:54:02Z

Stinson Linden:

Pathfinding Tools in the Second Life Viewer

2012-09-25T01:04:35Z

Stinson Linden:

{{Pathfinding Nav}}
__TOC__
== Introduction ==
For pathfinding, each region has a navigation mesh, commonly referred to as a "'''navmesh'''". The '''navmesh''' is a representation of the region's geometry generated and used by the physics simulator to determine paths for the pathfinding characters. The navmesh may be in one of the following three states:

* Up-to-date
* Has pending changes
* Building ''(a.k.a. rebaking)''

The navmesh will transition through these states according to the following diagram:

[[File:Navmesh_transitions.png|alt=Second Life Pathfinding NavMesh Transitions|Second Life Pathfinding NavMesh Transitions]]

Six new elements have been added to the SL Viewer interface to communicate the navmesh state for the current region. These new elements are:

* icon representations of the pathfinding region state for the SLURL bar
* a "Rebake region" button that appears above the lower toolbar
* a right-click context menu option addition
* an additional field on the Build floater
* an additional field on the Object Profile floater
* additional simulator metrics on the Statistics floater

In addition to these new elements, three new floaters allow users to more efficiently create, visualize, test, and debug pathfinding-enabled characters. These tools are not required to create pathfinding behaviors but are particularly useful to builders and experienced creators in Second Life. These new floaters are:

* Pathfinding linksets
* Pathfinding characters
* Pathfinding view / test

== Pathfinding UI Elements ==

'''Note that other residents editing pathfinding objects on the same region may create pending changes to the navmesh.''' When this occurs, all residents on the same region and with build rights will see the appropriate SLURL bar icons and rebake region button.

=== Pathfinding Icons in SLURL Bar ===

The SLURL bar indicates the three pathfinding states of the current region.
# '''Navmesh is up-to-date''' The current region's navmesh is up-to-date. No icon is shown as this is the expected default state. [[File:Pathfinding-clean-region-1.png|alt=Second Life URL Bar with Up-to-Date NavMesh Icon|Second Life URL Bar with Up-to-Date NavMesh Icon]]
# '''Navmesh has pending changes''' The region has pending changes that have not yet been baked into the navmesh. A pathfinding icon with a construction symbol is shown. [[File:Pathfinding-dirty-region-1.png|alt=Second Life URL Bar with Pending Changes Icon|Second Life URL Bar with Pending Changes Icon]]
# '''Dynamic pathfinding is disabled''' The region has dynamic pathfinding disabled. Pathfinding characters will not work as expected. A pathfinding icon with a disabled symbol is shown. [[File:Pathfinding-disabled-region-1.png|alt=Second Life URL Bar with Pathfinding Disabled Icon|Second Life URL Bar with Pathfinding Disabled Icon]]

=== Rebake Region Button ===

When a region has pending changes, the appropriate icon will be shown in the SLURL bar, as described above. In addition, if the user has build rights for any parcel on the current region, the user will also be able to see a "Rebake region" button that displays above the lower toolbar.

[[File:Rebake-button-1.png|alt=Second Life Rebake Region button that allows permitted users to rebake pathfinding changes into the navmesh]]

When the user clicks this button, a request is sent to the region to rebake the navmesh for the current region. As rebaking a region may be a time intensive process, the button will change to indicate "Region is rebaking" during this server process. After the rebaking is complete, this button on the viewer will vanish.

[[File:Rebaking-button-1.png|alt=Second Life Region is Rebaking button that indicates that the current region is rebaking its navmesh]]

=== Right-click context menu behavior ===

When right-clicking on an object in-world, pathfinding-specific menu options may be included in the pop-up context menu.

If the user right-clicks on a '''linkset''' object in-world, a menu option "Show in linksets" will allow the user to open the Pathfinding Linksets floater with the current object selected.

[[File:Right-click-show-in-linksets-1.png|alt=Second Life Context Menu with Show in Linksets floater menu option]]

If the user right-clicks on a pathfinding '''character''' object in-world, a menu option "Show in characters" will allow the user to open the Pathfinding Characters floater with the current object selected.

[[File:Right-click-show-in-characters-1.png|alt=Second Life Context Menu with Show in Characters floater menu option]]

=== Additional field on the Build floater ===

The Build floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Build floater with a ''character'' object selected.

[[File:Build-floater-character-1.png|alt=Build floater with pathfinding attribute character|Build floater with pathfinding attribute character]]

The following image is a screenshot of the Build floater with an object that ''affects navmesh'' selected. This object could be a ''walkable'', ''static obstacle'', ''material volume'', or ''exclusion volume''.

[[File:Build-floater-affects-navmesh-1.png|alt=Build floater with pathfinding attribute affects navmesh|Build floater with pathfinding attribute affects navmesh]]

{{KBwarning|For linksets that do affect the navmesh, it will be impossible to modify the object across the region boundary. The user and the object affecting a navmesh must be in the same region to enable modification of the object. This will be indicated on the General tab of the Build floater as illustrated in the following screenshot.}}
[[File:Build-floater-region-boundary-1.png|alt=Build floater indicating that the user cannot modify object across a region boundary|Build floater indicating that the user cannot modify object across a region boundary]]

=== Additional field on the Object Profile floater ===

Similar to the afore-described Build floater, the Object Profile floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Object Profile floater with an ''affects navmesh'' object selected.

[[File:Object-profile-1.png|alt=Object Profile floater with pathfinding attribute affects navmesh|Object Profile floater with pathfinding attribute affects navmesh]]

=== Additional simulator metrics on the Statistics floater ===

For advanced users, additional simulator metrics have been added to the Statistics floater. The Statistics floater, available from the main menu Advanced > Performance Tools > Statistics Bar, has the following 3 additional fields reporting statistics from the simulator regarding pathfinding activity:

* '''AI Step Time''' - The average time spent during each frame computing character AI events.
* '''Skipped Silhouette Steps''' - The number of steps that are skipped per second in computing the influence of objects of type ''Movable Obstacles'' on the navmesh. A high value here means that objects on the region are marked as ''Movable Obstacles'' and could be contributing to improper pathfinding behavior on the region. To lower this value, set all objects that do not move to either type ''Walkable'' or ''Static Obstacle'', and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]].
* '''Characters Updated''' - The average percentage of characters updated during each frame. A low value here means that character AI computations are taking too long during each frame, and thus some character updates are skipped during subsequent frames. This could be contributing to improper pathfinding behavior on the region. To increase this value, decrease the number of characters on the region, and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]]. Note that the Pathfinding Characters floater (described below) may also be used to determine which characters on the region are contributing the most to the region's CPU time.

[[File:Pathfinding-stats-2.png|alt=Simulator Statistics floater with additional pathfinding statistics|Simulator Statistics floater with additional pathfinding statistics]]

== Pathfinding Floaters ==

These three pathfinding floaters may all be accessed through the Build->Pathfinding menu in the Project Viewer - Pathfinding.

[[File:Build-menu-pf-selected-1.png|alt=Second Life Build Menu with new Pathfinding menu items|SL Build -> Pathfinding Menu]]

 

=== Pathfinding Linksets Floater ===

==== Overview ====

The intent of the Pathfinding Linksets floater is to give advanced users and builders the ability to customize an area to achieve interesting effects with pathfinding-enabled characters.

The floater displays information for all linksets within the current region for which the user has the ability to alter. The table reports useful information including
* Linkset Name
* Description
* Owner
* Whether the object is Scripted
* Land Impact
* Distance from the resident's avatar
* Linkset Use
** Potential values
*** Walkable
*** Static Obstacle
*** Movable Obstacle
*** Material Volume
*** Exclusion Volume
*** Movable Phantom
* Walkability Coefficients
** Character Type A ''(example use: humanoid)''
** Character Type B ''(example use: creature)''
** Character Type C ''(example use: mechanical)''
** Character Type D ''(example use: other)''

Additionally, selecting any linksets within the floater will also select the object(s) within the Viewer.

[[File:Linksets-floater-3.png|alt=Pathfinding Linksets floater|Pathfinding Linksets]]

 

==== Controls ====

{{:Viewerhelp:Pathfinding linksets}}

==== Example use ====

The advanced users and builders will use the Pathfinding Linksets floater to customize areas to create interesting effects for pathfinding-enabled characters.

For instance, imagine the scenario of a builder constructing a single room in a pathfinding-enabled house. For the single room, the builder would use the following types as follows:

{|border="1"
! Linkset Use !! Description
|-
|width="200" align="center" | Walkable || align="left" | The floor linkset would be set to be Walkable to allow characters to move across the floor.
|-
|width="200" align="center" | Static Obstacle || align="left" | A desk linkset in the room would be set to be Static Obstacle to block characters from walking through or across the object.

NOTE Any object that should block character movement and that does not move should be marked as Static Obstacle to improve performance of pathfinding characters.
|-
|width="200" align="center" | Movable Obstacle || align="left" | A door linkset in the room would be set to be Movable Obstacle. This will still block characters but, in contrast to Static Obstacles, Movable Obstacles will allow the linkset itself to move. In the case of the door, this will allow the door to open and close, but will still prevent characters from walking through the door.
|-
|width="200" align="center" | Material Volume || align="left" | Material Volumes are phantom objects that can be used to affect the walkability coefficients of intersecting objects. Imagine that the builder applied a texture to the floor. Also, imagine that the floor texture includes small throw rug in the middle of the room. (The builder did not want to create a separate object for the rug, so is using a texture on the floor to give the appearance of a rug). The builder can then create a Material Volume object intersecting the floor at the location of the rug. Then, by setting a lower walkability coefficient for the Material Volume, the builder will create the affect of slowing down characters as the characters traverse across the painted rug area.
|-
|width="200" align="center" | Exclusion Volume || align="left" | Exclusion Volumes are phantom objects that can be used to create areas where characters are prevented from moving. For instance, the builder can use an Exclusion Volume to create a section of the room where avatars would be able to move, but characters would be blocked from following.
|-
|width="200" align="center" | Movable Phantom || align="left" | Movable Phantoms are phantom objects that have no affect on pathfinding-enabled characters.
|}
 
In addition to linkset use attributes, builders can achieve additional effects by modifying the walkability coefficients for linksets. The walkability coefficients are values, ranging from 0% to 100%, that affect a characters speed. A walkability coefficient of 50% will reduce a character's speed by half while the character is traversing across the linkset.
 

=== Pathfinding Characters Floater ===

==== Overview ====
The intent of Pathfinding Characters floater is primarily for users to locate characters moving throughout a region and to identify the CPU cost of characters affecting the performance of a region.

The floater displays information for all characters within the current region for which the user has the ability to manipulate. The table reports useful information including
* Character Name
* Description
* Owner
* CPU Time
* Altitude

[[File:Characters-floater-1.png|alt=Pathfinding Characters floater|Pathfinding Characters]]
 
==== Controls ====

{{:Viewerhelp:Pathfinding characters}}

==== Example use ====
# If a region owner has created a pathfinding-enabled character but is unable to find the character within the region, the Characters floater can be used to locate and select the character.
# Additionally, the Pathfinding Characters floater reports the CPU time cost for each character within the region. This functionality can be used by advanced users to identify which characters are impacting performance the most.

=== Pathfinding View/Test Floater ===

==== Overview ====

The intent of the Pathfinding View/Test floater is for advanced users who are building pathfinding-enabled objects and characters.

This floater consists of 3 basic areas.

# Status area (illustrating both the Viewer and Simulator status of the region's navmesh)
# View tab Controls
# Test Path tab Controls

The following image is a screenshot of the Pathfinding View/Test floater with the navmesh displayed.

[[File:View-nav-mesh-1.png|alt=Pathfinding View/Test floater with the navmesh displayed|Pathfinding View/Test with navmesh displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with the pathfinding object types displayed.

[[File:View-pf-types-1.png|alt=Pathfinding View/Test floater with the pathfinding object types displayed|Pathfinding View/Test with the pathfinding object types displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with a test path displayed.

[[File:View-test-path-1.png|alt=Pathfinding View/Test floater with a test path displayed|Pathfinding View/Test with a test path displayed]]

 
==== Controls ====

{{:Viewerhelp:Pathfinding edit and test}}

==== Example Use ====

# The advanced user will use the Visualization controls to visualize how the navmesh and related permanent objects have been generated. By seeing this visualization of how the physics engine interprets the navigation information, the advanced user can understand how to better customize the pathfinding-enabled objects to obtain the desired behaviors of characters.
# The advanced user will use the Test Tab to visualize how a test character would choose the path between selected start and end points.

 

== Known Issues ==

{| style="border-style:solid;border-width:2px 0 2px 0px;"
! style="border-style:solid;border-width:0 0 1px 0" width="130" | JIRA
! style="border-style:solid;border-width:0 0 1px 0" width="300" | Summary
! style="border-style:solid;border-width:0 0 1px 0" width="550" | Hardware
! style="border-style:solid;border-width:0 0 1px 0" width="100" | Fixed in Version
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1291 MAINT-1291]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Enable Debug GL crashes the viewer to the desktop
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac Pro running 10.7.4 with AMD Radeon HD5770 iMac running Mac OS X Lion 10.7.4 (11E53) with AMD Radeon HD 6770M (512 MB) PC Clone running XP Pro with GeForce2 Ultra
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-572 PATH-572]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Underwater 'Walkables' shapes are reflected about the water plane
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-659 PATH-659]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | navmesh being drawn over worn flexi prims and under avatar
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-790 PATH-790]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Physics capsule rendering of character shapes is broken after zooming
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-812 PATH-812]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Show capsules option creates black capsule instead of blue
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | ATI Radeon X300 Video card ATI Radeon X600 Video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-821 PATH-821]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop displays black environment
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop with AMD Radeon HD 4200 Mobile graphics
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-822 PATH-822]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Configuration with ATI Radeon 7500 can launch Viewer, serious GFx issues
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | AMD Athlon64 3000+ with ATI Radeon 7500 video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-851 PATH-851]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Crash in the beta viewer relating to LLLoginInstance
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-857 PATH-857] [https://jira.secondlife.com/browse/VWR-29500 VWR-29500]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Shadows not operational under Second Life Beta 3.4.0.262596
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac OS X 10.7.4 with ATI Radeon X1600 OpenGL Engine video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|}

 

== Issues Fixed during Beta ==

{| style="border-style:solid;border-width:2px 0 2px 0px;"
! style="border-style:solid;border-width:0 0 1px 0" width="130" | JIRA
! style="border-style:solid;border-width:0 0 1px 0" width="300" | Summary
! style="border-style:solid;border-width:0 0 1px 0" width="550" | Hardware
! style="border-style:solid;border-width:0 0 1px 0" width="100" | Fixed in Version
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-814 PATH-814]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 laptop displays black environment</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 with AMD Radeon HD5650M Mobile graphics</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (262596)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-826 PATH-826]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Random crash while wearing a mesh avatar and dropping objects in-world</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (262596)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1413 MAINT-1413] [https://jira.secondlife.com/browse/VWR-29491 VWR-29491]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>"Weights Of Selected" never gives any results after pathfinding tools were merged in.</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1414 MAINT-1414] [https://jira.secondlife.com/browse/VWR-29497 VWR-29497]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>User is not able to specify color of object with unchecked 'Apply now' chechbox</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1425 MAINT-1425]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>viewer spams the log with "LLViewerParcelMgr::requestParcelMediaURLFilter: can't get ParcelMediaURLFilterList cap" while editing an object</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1426 MAINT-1426]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Texture repeats/meter reset before you can click Apply button</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-643 PATH-643] [https://jira.secondlife.com/browse/PATHBUG-174 PATHBUG-174]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Changes in Preferences dialog stops work of Pathfinding View/Test functionality</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-842 PATH-842] [https://jira.secondlife.com/browse/VWR-29431 VWR-29431] [https://jira.secondlife.com/browse/MAINT-1362 MAINT-1362]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>TargetOmega object's rotation resets if it changes color in 3.4.0 (262596) Beta</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-849 PATH-849]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Crash in the beta viewer relating to pathfinding</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-852 PATH-852]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Custom cursors fail on mac and linux</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-854 PATH-854]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Add support in the viewer to display the Scripted column on the linksets floater</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-856 PATH-856]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>As a user, I want to see a notification when I am toggling the phantom flag on a linkset through the Pathfinding Linkset floater</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1480 MAINT-1480]</del> <del>[https://jira.secondlife.com/browse/VWR-29562 VWR-29562]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>llSetRot does not clear TargetOmega rotation</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (264601)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1506 MAINT-1506]</del> <del>[https://jira.secondlife.com/browse/VWR-29644 VWR-29644]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Keyframe Motion leads the Second Life Beta Viewer - version 3.4.0 (264194) to unexpected results.</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (264601)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-864 PATH-864]</del> <del>[https://jira.secondlife.com/browse/PATHBUG-184 PATHBUG-184]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Allow the Linkset floater to shrink smaller than actually</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (264601)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1561 MAINT-1561]</del> <del>[https://jira.secondlife.com/browse/BUG-86 BUG-86]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Pendulum motion is incorrect after world view is out of focus</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (264785)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-880 PATH-880]</del> <del>[https://jira.secondlife.com/browse/PATHBUG-189 PATHBUG-189]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Characters Waking Sideways and Backwards</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (264785)
|}

Pathfinding Tools in the Second Life Viewer

2012-09-17T18:12:21Z

Stinson Linden: /* Known Issues */

{{Pathfinding Nav}}
__TOC__
{{KBnote|The Viewer tools described here are available only in the '''Second Life Viewer Beta''' build. Look under the "Other Viewers" section on the [http://secondlife.com/support/downloads/ Second Life Viewer download page]}}
== Introduction ==
For pathfinding, each region has a navigation mesh, commonly referred to as a "'''navmesh'''". The '''navmesh''' is a representation of the region's geometry generated and used by the physics simulator to determine paths for the pathfinding characters. The navmesh may be in one of the following three states:

* Up-to-date
* Has pending changes
* Building ''(a.k.a. rebaking)''

The navmesh will transition through these states according to the following diagram:

[[File:Navmesh_transitions.png|alt=Second Life Pathfinding NavMesh Transitions|Second Life Pathfinding NavMesh Transitions]]

Six new elements have been added to the SL Viewer interface to communicate the navmesh state for the current region. These new elements are:

* icon representations of the pathfinding region state for the SLURL bar
* a "Rebake region" button that appears above the lower toolbar
* a right-click context menu option addition
* an additional field on the Build floater
* an additional field on the Object Profile floater
* additional simulator metrics on the Statistics floater

In addition to these new elements, three new floaters allow users to more efficiently create, visualize, test, and debug pathfinding-enabled characters. These tools are not required to create pathfinding behaviors but are particularly useful to builders and experienced creators in Second Life. These new floaters are:

* Pathfinding linksets
* Pathfinding characters
* Pathfinding view / test

== Pathfinding UI Elements ==

'''Note that other residents editing pathfinding objects on the same region may create pending changes to the navmesh.''' When this occurs, all residents on the same region and with build rights will see the appropriate SLURL bar icons and rebake region button.

=== Pathfinding Icons in SLURL Bar ===

The SLURL bar indicates the three pathfinding states of the current region.
# '''Navmesh is up-to-date''' The current region's navmesh is up-to-date. No icon is shown as this is the expected default state. [[File:Pathfinding-clean-region-1.png|alt=Second Life URL Bar with Up-to-Date NavMesh Icon|Second Life URL Bar with Up-to-Date NavMesh Icon]]
# '''Navmesh has pending changes''' The region has pending changes that have not yet been baked into the navmesh. A pathfinding icon with a construction symbol is shown. [[File:Pathfinding-dirty-region-1.png|alt=Second Life URL Bar with Pending Changes Icon|Second Life URL Bar with Pending Changes Icon]]
# '''Dynamic pathfinding is disabled''' The region has dynamic pathfinding disabled. Pathfinding characters will not work as expected. A pathfinding icon with a disabled symbol is shown. [[File:Pathfinding-disabled-region-1.png|alt=Second Life URL Bar with Pathfinding Disabled Icon|Second Life URL Bar with Pathfinding Disabled Icon]]

=== Rebake Region Button ===

When a region has pending changes, the appropriate icon will be shown in the SLURL bar, as described above. In addition, if the user has build rights for any parcel on the current region, the user will also be able to see a "Rebake region" button that displays above the lower toolbar.

[[File:Rebake-button-1.png|alt=Second Life Rebake Region button that allows permitted users to rebake pathfinding changes into the navmesh]]

When the user clicks this button, a request is sent to the region to rebake the navmesh for the current region. As rebaking a region may be a time intensive process, the button will change to indicate "Region is rebaking" during this server process. After the rebaking is complete, this button on the viewer will vanish.

[[File:Rebaking-button-1.png|alt=Second Life Region is Rebaking button that indicates that the current region is rebaking its navmesh]]

=== Right-click context menu behavior ===

When right-clicking on an object in-world, pathfinding-specific menu options may be included in the pop-up context menu.

If the user right-clicks on a '''linkset''' object in-world, a menu option "Show in linksets" will allow the user to open the Pathfinding Linksets floater with the current object selected.

[[File:Right-click-show-in-linksets-1.png|alt=Second Life Context Menu with Show in Linksets floater menu option]]

If the user right-clicks on a pathfinding '''character''' object in-world, a menu option "Show in characters" will allow the user to open the Pathfinding Characters floater with the current object selected.

[[File:Right-click-show-in-characters-1.png|alt=Second Life Context Menu with Show in Characters floater menu option]]

=== Additional field on the Build floater ===

The Build floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Build floater with a ''character'' object selected.

[[File:Build-floater-character-1.png|alt=Build floater with pathfinding attribute character|Build floater with pathfinding attribute character]]

The following image is a screenshot of the Build floater with an object that ''affects navmesh'' selected. This object could be a ''walkable'', ''static obstacle'', ''material volume'', or ''exclusion volume''.

[[File:Build-floater-affects-navmesh-1.png|alt=Build floater with pathfinding attribute affects navmesh|Build floater with pathfinding attribute affects navmesh]]

{{KBwarning|For linksets that do affect the navmesh, it will be impossible to modify the object across the region boundary. The user and the object affecting a navmesh must be in the same region to enable modification of the object. This will be indicated on the General tab of the Build floater as illustrated in the following screenshot.}}
[[File:Build-floater-region-boundary-1.png|alt=Build floater indicating that the user cannot modify object across a region boundary|Build floater indicating that the user cannot modify object across a region boundary]]

=== Additional field on the Object Profile floater ===

Similar to the afore-described Build floater, the Object Profile floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Object Profile floater with an ''affects navmesh'' object selected.

[[File:Object-profile-1.png|alt=Object Profile floater with pathfinding attribute affects navmesh|Object Profile floater with pathfinding attribute affects navmesh]]

=== Additional simulator metrics on the Statistics floater ===

For advanced users, additional simulator metrics have been added to the Statistics floater. The Statistics floater, available from the main menu Advanced > Performance Tools > Statistics Bar, has the following 3 additional fields reporting statistics from the simulator regarding pathfinding activity:

* '''AI Step Time''' - The average time spent during each frame computing character AI events.
* '''Skipped Silhouette Steps''' - The number of steps that are skipped per second in computing the influence of objects of type ''Movable Obstacles'' on the navmesh. A high value here means that objects on the region are marked as ''Movable Obstacles'' and could be contributing to improper pathfinding behavior on the region. To lower this value, set all objects that do not move to either type ''Walkable'' or ''Static Obstacle'', and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]].
* '''Characters Updated''' - The average percentage of characters updated during each frame. A low value here means that character AI computations are taking too long during each frame, and thus some character updates are skipped during subsequent frames. This could be contributing to improper pathfinding behavior on the region. To increase this value, decrease the number of characters on the region, and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]]. Note that the Pathfinding Characters floater (described below) may also be used to determine which characters on the region are contributing the most to the region's CPU time.

[[File:Pathfinding-stats-2.png|alt=Simulator Statistics floater with additional pathfinding statistics|Simulator Statistics floater with additional pathfinding statistics]]

== Pathfinding Floaters ==

These three pathfinding floaters may all be accessed through the Build->Pathfinding menu in the Project Viewer - Pathfinding.

[[File:Build-menu-pf-selected-1.png|alt=Second Life Build Menu with new Pathfinding menu items|SL Build -> Pathfinding Menu]]

 

=== Pathfinding Linksets Floater ===

==== Overview ====

The intent of the Pathfinding Linksets floater is to give advanced users and builders the ability to customize an area to achieve interesting effects with pathfinding-enabled characters.

The floater displays information for all linksets within the current region for which the user has the ability to alter. The table reports useful information including
* Linkset Name
* Description
* Owner
* Whether the object is Scripted
* Land Impact
* Distance from the resident's avatar
* Linkset Use
** Potential values
*** Walkable
*** Static Obstacle
*** Movable Obstacle
*** Material Volume
*** Exclusion Volume
*** Movable Phantom
* Walkability Coefficients
** Character Type A ''(example use: humanoid)''
** Character Type B ''(example use: creature)''
** Character Type C ''(example use: mechanical)''
** Character Type D ''(example use: other)''

Additionally, selecting any linksets within the floater will also select the object(s) within the Viewer.

[[File:Linksets-floater-3.png|alt=Pathfinding Linksets floater|Pathfinding Linksets]]

 

==== Controls ====

{{:Viewerhelp:Pathfinding linksets}}

==== Example use ====

The advanced users and builders will use the Pathfinding Linksets floater to customize areas to create interesting effects for pathfinding-enabled characters.

For instance, imagine the scenario of a builder constructing a single room in a pathfinding-enabled house. For the single room, the builder would use the following types as follows:

{|border="1"
! Linkset Use !! Description
|-
|width="200" align="center" | Walkable || align="left" | The floor linkset would be set to be Walkable to allow characters to move across the floor.
|-
|width="200" align="center" | Static Obstacle || align="left" | A desk linkset in the room would be set to be Static Obstacle to block characters from walking through or across the object.

NOTE Any object that should block character movement and that does not move should be marked as Static Obstacle to improve performance of pathfinding characters.
|-
|width="200" align="center" | Movable Obstacle || align="left" | A door linkset in the room would be set to be Movable Obstacle. This will still block characters but, in contrast to Static Obstacles, Movable Obstacles will allow the linkset itself to move. In the case of the door, this will allow the door to open and close, but will still prevent characters from walking through the door.
|-
|width="200" align="center" | Material Volume || align="left" | Material Volumes are phantom objects that can be used to affect the walkability coefficients of intersecting objects. Imagine that the builder applied a texture to the floor. Also, imagine that the floor texture includes small throw rug in the middle of the room. (The builder did not want to create a separate object for the rug, so is using a texture on the floor to give the appearance of a rug). The builder can then create a Material Volume object intersecting the floor at the location of the rug. Then, by setting a lower walkability coefficient for the Material Volume, the builder will create the affect of slowing down characters as the characters traverse across the painted rug area.
|-
|width="200" align="center" | Exclusion Volume || align="left" | Exclusion Volumes are phantom objects that can be used to create areas where characters are prevented from moving. For instance, the builder can use an Exclusion Volume to create a section of the room where avatars would be able to move, but characters would be blocked from following.
|-
|width="200" align="center" | Movable Phantom || align="left" | Movable Phantoms are phantom objects that have no affect on pathfinding-enabled characters.
|}
 
In addition to linkset use attributes, builders can achieve additional effects by modifying the walkability coefficients for linksets. The walkability coefficients are values, ranging from 0% to 100%, that affect a characters speed. A walkability coefficient of 50% will reduce a character's speed by half while the character is traversing across the linkset.
 

=== Pathfinding Characters Floater ===

==== Overview ====
The intent of Pathfinding Characters floater is primarily for users to locate characters moving throughout a region and to identify the CPU cost of characters affecting the performance of a region.

The floater displays information for all characters within the current region for which the user has the ability to manipulate. The table reports useful information including
* Character Name
* Description
* Owner
* CPU Time
* Altitude

[[File:Characters-floater-1.png|alt=Pathfinding Characters floater|Pathfinding Characters]]
 
==== Controls ====

{{:Viewerhelp:Pathfinding characters}}

==== Example use ====
# If a region owner has created a pathfinding-enabled character but is unable to find the character within the region, the Characters floater can be used to locate and select the character.
# Additionally, the Pathfinding Characters floater reports the CPU time cost for each character within the region. This functionality can be used by advanced users to identify which characters are impacting performance the most.

=== Pathfinding View/Test Floater ===

==== Overview ====

The intent of the Pathfinding View/Test floater is for advanced users who are building pathfinding-enabled objects and characters.

This floater consists of 3 basic areas.

# Status area (illustrating both the Viewer and Simulator status of the region's navmesh)
# View tab Controls
# Test Path tab Controls

The following image is a screenshot of the Pathfinding View/Test floater with the navmesh displayed.

[[File:View-nav-mesh-1.png|alt=Pathfinding View/Test floater with the navmesh displayed|Pathfinding View/Test with navmesh displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with the pathfinding object types displayed.

[[File:View-pf-types-1.png|alt=Pathfinding View/Test floater with the pathfinding object types displayed|Pathfinding View/Test with the pathfinding object types displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with a test path displayed.

[[File:View-test-path-1.png|alt=Pathfinding View/Test floater with a test path displayed|Pathfinding View/Test with a test path displayed]]

 
==== Controls ====

{{:Viewerhelp:Pathfinding edit and test}}

==== Example Use ====

# The advanced user will use the Visualization controls to visualize how the navmesh and related permanent objects have been generated. By seeing this visualization of how the physics engine interprets the navigation information, the advanced user can understand how to better customize the pathfinding-enabled objects to obtain the desired behaviors of characters.
# The advanced user will use the Test Tab to visualize how a test character would choose the path between selected start and end points.

 

== Known Issues ==

{| style="border-style:solid;border-width:2px 0 2px 0px;"
! style="border-style:solid;border-width:0 0 1px 0" width="130" | JIRA
! style="border-style:solid;border-width:0 0 1px 0" width="300" | Summary
! style="border-style:solid;border-width:0 0 1px 0" width="550" | Hardware
! style="border-style:solid;border-width:0 0 1px 0" width="100" | Fixed in Version
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1291 MAINT-1291]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Enable Debug GL crashes the viewer to the desktop
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac Pro running 10.7.4 with AMD Radeon HD5770 iMac running Mac OS X Lion 10.7.4 (11E53) with AMD Radeon HD 6770M (512 MB) PC Clone running XP Pro with GeForce2 Ultra
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-572 PATH-572]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Underwater 'Walkables' shapes are reflected about the water plane
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-659 PATH-659]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | navmesh being drawn over worn flexi prims and under avatar
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-790 PATH-790]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Physics capsule rendering of character shapes is broken after zooming
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-812 PATH-812]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Show capsules option creates black capsule instead of blue
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | ATI Radeon X300 Video card ATI Radeon X600 Video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-821 PATH-821]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop displays black environment
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop with AMD Radeon HD 4200 Mobile graphics
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-822 PATH-822]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Configuration with ATI Radeon 7500 can launch Viewer, serious GFx issues
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | AMD Athlon64 3000+ with ATI Radeon 7500 video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-851 PATH-851]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Crash in the beta viewer relating to LLLoginInstance
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-857 PATH-857] [https://jira.secondlife.com/browse/VWR-29500 VWR-29500]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Shadows not operational under Second Life Beta 3.4.0.262596
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac OS X 10.7.4 with ATI Radeon X1600 OpenGL Engine video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-814 PATH-814]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 laptop displays black environment</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 with AMD Radeon HD5650M Mobile graphics</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (262596)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-826 PATH-826]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Random crash while wearing a mesh avatar and dropping objects in-world</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (262596)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1413 MAINT-1413] [https://jira.secondlife.com/browse/VWR-29491 VWR-29491]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>"Weights Of Selected" never gives any results after pathfinding tools were merged in.</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1414 MAINT-1414] [https://jira.secondlife.com/browse/VWR-29497 VWR-29497]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>User is not able to specify color of object with unchecked 'Apply now' chechbox</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1425 MAINT-1425]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>viewer spams the log with "LLViewerParcelMgr::requestParcelMediaURLFilter: can't get ParcelMediaURLFilterList cap" while editing an object</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1426 MAINT-1426]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Texture repeats/meter reset before you can click Apply button</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-643 PATH-643] [https://jira.secondlife.com/browse/PATHBUG-174 PATHBUG-174]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Changes in Preferences dialog stops work of Pathfinding View/Test functionality</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-842 PATH-842] [https://jira.secondlife.com/browse/VWR-29431 VWR-29431] [https://jira.secondlife.com/browse/MAINT-1362 MAINT-1362]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>TargetOmega object's rotation resets if it changes color in 3.4.0 (262596) Beta</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-849 PATH-849]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Crash in the beta viewer relating to pathfinding</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-852 PATH-852]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Custom cursors fail on mac and linux</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-854 PATH-854]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Add support in the viewer to display the Scripted column on the linksets floater</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-856 PATH-856]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>As a user, I want to see a notification when I am toggling the phantom flag on a linkset through the Pathfinding Linkset floater</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1480 MAINT-1480]</del> <del>[https://jira.secondlife.com/browse/VWR-29562 VWR-29562]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>llSetRot does not clear TargetOmega rotation</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (264601)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1506 MAINT-1506]</del> <del>[https://jira.secondlife.com/browse/VWR-29644 VWR-29644]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Keyframe Motion leads the Second Life Beta Viewer - version 3.4.0 (264194) to unexpected results.</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (264601)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-864 PATH-864]</del> <del>[https://jira.secondlife.com/browse/PATHBUG-184 PATHBUG-184]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Allow the Linkset floater to shrink smaller than actually</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (264601)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1561 MAINT-1561]</del> <del>[https://jira.secondlife.com/browse/BUG-86 BUG-86]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Pendulum motion is incorrect after world view is out of focus</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (264785)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-880 PATH-880]</del> <del>[https://jira.secondlife.com/browse/PATHBUG-189 PATHBUG-189]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Characters Waking Sideways and Backwards</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (264785)
|}

Pathfinding Tools in the Second Life Viewer

2012-09-14T22:44:31Z

Stinson Linden: /* Known Issues */

{{Pathfinding Nav}}
__TOC__
{{KBnote|The Viewer tools described here are available only in the '''Second Life Viewer Beta''' build. Look under the "Other Viewers" section on the [http://secondlife.com/support/downloads/ Second Life Viewer download page]}}
== Introduction ==
For pathfinding, each region has a navigation mesh, commonly referred to as a "'''navmesh'''". The '''navmesh''' is a representation of the region's geometry generated and used by the physics simulator to determine paths for the pathfinding characters. The navmesh may be in one of the following three states:

* Up-to-date
* Has pending changes
* Building ''(a.k.a. rebaking)''

The navmesh will transition through these states according to the following diagram:

[[File:Navmesh_transitions.png|alt=Second Life Pathfinding NavMesh Transitions|Second Life Pathfinding NavMesh Transitions]]

Six new elements have been added to the SL Viewer interface to communicate the navmesh state for the current region. These new elements are:

* icon representations of the pathfinding region state for the SLURL bar
* a "Rebake region" button that appears above the lower toolbar
* a right-click context menu option addition
* an additional field on the Build floater
* an additional field on the Object Profile floater
* additional simulator metrics on the Statistics floater

In addition to these new elements, three new floaters allow users to more efficiently create, visualize, test, and debug pathfinding-enabled characters. These tools are not required to create pathfinding behaviors but are particularly useful to builders and experienced creators in Second Life. These new floaters are:

* Pathfinding linksets
* Pathfinding characters
* Pathfinding view / test

== Pathfinding UI Elements ==

'''Note that other residents editing pathfinding objects on the same region may create pending changes to the navmesh.''' When this occurs, all residents on the same region and with build rights will see the appropriate SLURL bar icons and rebake region button.

=== Pathfinding Icons in SLURL Bar ===

The SLURL bar indicates the three pathfinding states of the current region.
# '''Navmesh is up-to-date''' The current region's navmesh is up-to-date. No icon is shown as this is the expected default state. [[File:Pathfinding-clean-region-1.png|alt=Second Life URL Bar with Up-to-Date NavMesh Icon|Second Life URL Bar with Up-to-Date NavMesh Icon]]
# '''Navmesh has pending changes''' The region has pending changes that have not yet been baked into the navmesh. A pathfinding icon with a construction symbol is shown. [[File:Pathfinding-dirty-region-1.png|alt=Second Life URL Bar with Pending Changes Icon|Second Life URL Bar with Pending Changes Icon]]
# '''Dynamic pathfinding is disabled''' The region has dynamic pathfinding disabled. Pathfinding characters will not work as expected. A pathfinding icon with a disabled symbol is shown. [[File:Pathfinding-disabled-region-1.png|alt=Second Life URL Bar with Pathfinding Disabled Icon|Second Life URL Bar with Pathfinding Disabled Icon]]

=== Rebake Region Button ===

When a region has pending changes, the appropriate icon will be shown in the SLURL bar, as described above. In addition, if the user has build rights for any parcel on the current region, the user will also be able to see a "Rebake region" button that displays above the lower toolbar.

[[File:Rebake-button-1.png|alt=Second Life Rebake Region button that allows permitted users to rebake pathfinding changes into the navmesh]]

When the user clicks this button, a request is sent to the region to rebake the navmesh for the current region. As rebaking a region may be a time intensive process, the button will change to indicate "Region is rebaking" during this server process. After the rebaking is complete, this button on the viewer will vanish.

[[File:Rebaking-button-1.png|alt=Second Life Region is Rebaking button that indicates that the current region is rebaking its navmesh]]

=== Right-click context menu behavior ===

When right-clicking on an object in-world, pathfinding-specific menu options may be included in the pop-up context menu.

If the user right-clicks on a '''linkset''' object in-world, a menu option "Show in linksets" will allow the user to open the Pathfinding Linksets floater with the current object selected.

[[File:Right-click-show-in-linksets-1.png|alt=Second Life Context Menu with Show in Linksets floater menu option]]

If the user right-clicks on a pathfinding '''character''' object in-world, a menu option "Show in characters" will allow the user to open the Pathfinding Characters floater with the current object selected.

[[File:Right-click-show-in-characters-1.png|alt=Second Life Context Menu with Show in Characters floater menu option]]

=== Additional field on the Build floater ===

The Build floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Build floater with a ''character'' object selected.

[[File:Build-floater-character-1.png|alt=Build floater with pathfinding attribute character|Build floater with pathfinding attribute character]]

The following image is a screenshot of the Build floater with an object that ''affects navmesh'' selected. This object could be a ''walkable'', ''static obstacle'', ''material volume'', or ''exclusion volume''.

[[File:Build-floater-affects-navmesh-1.png|alt=Build floater with pathfinding attribute affects navmesh|Build floater with pathfinding attribute affects navmesh]]

{{KBwarning|For linksets that do affect the navmesh, it will be impossible to modify the object across the region boundary. The user and the object affecting a navmesh must be in the same region to enable modification of the object. This will be indicated on the General tab of the Build floater as illustrated in the following screenshot.}}
[[File:Build-floater-region-boundary-1.png|alt=Build floater indicating that the user cannot modify object across a region boundary|Build floater indicating that the user cannot modify object across a region boundary]]

=== Additional field on the Object Profile floater ===

Similar to the afore-described Build floater, the Object Profile floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Object Profile floater with an ''affects navmesh'' object selected.

[[File:Object-profile-1.png|alt=Object Profile floater with pathfinding attribute affects navmesh|Object Profile floater with pathfinding attribute affects navmesh]]

=== Additional simulator metrics on the Statistics floater ===

For advanced users, additional simulator metrics have been added to the Statistics floater. The Statistics floater, available from the main menu Advanced > Performance Tools > Statistics Bar, has the following 3 additional fields reporting statistics from the simulator regarding pathfinding activity:

* '''AI Step Time''' - The average time spent during each frame computing character AI events.
* '''Skipped Silhouette Steps''' - The number of steps that are skipped per second in computing the influence of objects of type ''Movable Obstacles'' on the navmesh. A high value here means that objects on the region are marked as ''Movable Obstacles'' and could be contributing to improper pathfinding behavior on the region. To lower this value, set all objects that do not move to either type ''Walkable'' or ''Static Obstacle'', and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]].
* '''Characters Updated''' - The average percentage of characters updated during each frame. A low value here means that character AI computations are taking too long during each frame, and thus some character updates are skipped during subsequent frames. This could be contributing to improper pathfinding behavior on the region. To increase this value, decrease the number of characters on the region, and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]]. Note that the Pathfinding Characters floater (described below) may also be used to determine which characters on the region are contributing the most to the region's CPU time.

[[File:Pathfinding-stats-2.png|alt=Simulator Statistics floater with additional pathfinding statistics|Simulator Statistics floater with additional pathfinding statistics]]

== Pathfinding Floaters ==

These three pathfinding floaters may all be accessed through the Build->Pathfinding menu in the Project Viewer - Pathfinding.

[[File:Build-menu-pf-selected-1.png|alt=Second Life Build Menu with new Pathfinding menu items|SL Build -> Pathfinding Menu]]

 

=== Pathfinding Linksets Floater ===

==== Overview ====

The intent of the Pathfinding Linksets floater is to give advanced users and builders the ability to customize an area to achieve interesting effects with pathfinding-enabled characters.

The floater displays information for all linksets within the current region for which the user has the ability to alter. The table reports useful information including
* Linkset Name
* Description
* Owner
* Whether the object is Scripted
* Land Impact
* Distance from the resident's avatar
* Linkset Use
** Potential values
*** Walkable
*** Static Obstacle
*** Movable Obstacle
*** Material Volume
*** Exclusion Volume
*** Movable Phantom
* Walkability Coefficients
** Character Type A ''(example use: humanoid)''
** Character Type B ''(example use: creature)''
** Character Type C ''(example use: mechanical)''
** Character Type D ''(example use: other)''

Additionally, selecting any linksets within the floater will also select the object(s) within the Viewer.

[[File:Linksets-floater-3.png|alt=Pathfinding Linksets floater|Pathfinding Linksets]]

 

==== Controls ====

{{:Viewerhelp:Pathfinding linksets}}

==== Example use ====

The advanced users and builders will use the Pathfinding Linksets floater to customize areas to create interesting effects for pathfinding-enabled characters.

For instance, imagine the scenario of a builder constructing a single room in a pathfinding-enabled house. For the single room, the builder would use the following types as follows:

{|border="1"
! Linkset Use !! Description
|-
|width="200" align="center" | Walkable || align="left" | The floor linkset would be set to be Walkable to allow characters to move across the floor.
|-
|width="200" align="center" | Static Obstacle || align="left" | A desk linkset in the room would be set to be Static Obstacle to block characters from walking through or across the object.

NOTE Any object that should block character movement and that does not move should be marked as Static Obstacle to improve performance of pathfinding characters.
|-
|width="200" align="center" | Movable Obstacle || align="left" | A door linkset in the room would be set to be Movable Obstacle. This will still block characters but, in contrast to Static Obstacles, Movable Obstacles will allow the linkset itself to move. In the case of the door, this will allow the door to open and close, but will still prevent characters from walking through the door.
|-
|width="200" align="center" | Material Volume || align="left" | Material Volumes are phantom objects that can be used to affect the walkability coefficients of intersecting objects. Imagine that the builder applied a texture to the floor. Also, imagine that the floor texture includes small throw rug in the middle of the room. (The builder did not want to create a separate object for the rug, so is using a texture on the floor to give the appearance of a rug). The builder can then create a Material Volume object intersecting the floor at the location of the rug. Then, by setting a lower walkability coefficient for the Material Volume, the builder will create the affect of slowing down characters as the characters traverse across the painted rug area.
|-
|width="200" align="center" | Exclusion Volume || align="left" | Exclusion Volumes are phantom objects that can be used to create areas where characters are prevented from moving. For instance, the builder can use an Exclusion Volume to create a section of the room where avatars would be able to move, but characters would be blocked from following.
|-
|width="200" align="center" | Movable Phantom || align="left" | Movable Phantoms are phantom objects that have no affect on pathfinding-enabled characters.
|}
 
In addition to linkset use attributes, builders can achieve additional effects by modifying the walkability coefficients for linksets. The walkability coefficients are values, ranging from 0% to 100%, that affect a characters speed. A walkability coefficient of 50% will reduce a character's speed by half while the character is traversing across the linkset.
 

=== Pathfinding Characters Floater ===

==== Overview ====
The intent of Pathfinding Characters floater is primarily for users to locate characters moving throughout a region and to identify the CPU cost of characters affecting the performance of a region.

The floater displays information for all characters within the current region for which the user has the ability to manipulate. The table reports useful information including
* Character Name
* Description
* Owner
* CPU Time
* Altitude

[[File:Characters-floater-1.png|alt=Pathfinding Characters floater|Pathfinding Characters]]
 
==== Controls ====

{{:Viewerhelp:Pathfinding characters}}

==== Example use ====
# If a region owner has created a pathfinding-enabled character but is unable to find the character within the region, the Characters floater can be used to locate and select the character.
# Additionally, the Pathfinding Characters floater reports the CPU time cost for each character within the region. This functionality can be used by advanced users to identify which characters are impacting performance the most.

=== Pathfinding View/Test Floater ===

==== Overview ====

The intent of the Pathfinding View/Test floater is for advanced users who are building pathfinding-enabled objects and characters.

This floater consists of 3 basic areas.

# Status area (illustrating both the Viewer and Simulator status of the region's navmesh)
# View tab Controls
# Test Path tab Controls

The following image is a screenshot of the Pathfinding View/Test floater with the navmesh displayed.

[[File:View-nav-mesh-1.png|alt=Pathfinding View/Test floater with the navmesh displayed|Pathfinding View/Test with navmesh displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with the pathfinding object types displayed.

[[File:View-pf-types-1.png|alt=Pathfinding View/Test floater with the pathfinding object types displayed|Pathfinding View/Test with the pathfinding object types displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with a test path displayed.

[[File:View-test-path-1.png|alt=Pathfinding View/Test floater with a test path displayed|Pathfinding View/Test with a test path displayed]]

 
==== Controls ====

{{:Viewerhelp:Pathfinding edit and test}}

==== Example Use ====

# The advanced user will use the Visualization controls to visualize how the navmesh and related permanent objects have been generated. By seeing this visualization of how the physics engine interprets the navigation information, the advanced user can understand how to better customize the pathfinding-enabled objects to obtain the desired behaviors of characters.
# The advanced user will use the Test Tab to visualize how a test character would choose the path between selected start and end points.

 

== Known Issues ==

{| style="border-style:solid;border-width:2px 0 2px 0px;"
! style="border-style:solid;border-width:0 0 1px 0" width="130" | JIRA
! style="border-style:solid;border-width:0 0 1px 0" width="300" | Summary
! style="border-style:solid;border-width:0 0 1px 0" width="550" | Hardware
! style="border-style:solid;border-width:0 0 1px 0" width="100" | Fixed in Version
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1291 MAINT-1291]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Enable Debug GL crashes the viewer to the desktop
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac Pro running 10.7.4 with AMD Radeon HD5770 iMac running Mac OS X Lion 10.7.4 (11E53) with AMD Radeon HD 6770M (512 MB) PC Clone running XP Pro with GeForce2 Ultra
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1561 MAINT-1561] [https://jira.secondlife.com/browse/BUG-86 BUG-86]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Pendulum motion is incorrect after world view is out of focus
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-572 PATH-572]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Underwater 'Walkables' shapes are reflected about the water plane
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-659 PATH-659]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | navmesh being drawn over worn flexi prims and under avatar
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-790 PATH-790]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Physics capsule rendering of character shapes is broken after zooming
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-812 PATH-812]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Show capsules option creates black capsule instead of blue
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | ATI Radeon X300 Video card ATI Radeon X600 Video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-821 PATH-821]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop displays black environment
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop with AMD Radeon HD 4200 Mobile graphics
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-822 PATH-822]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Configuration with ATI Radeon 7500 can launch Viewer, serious GFx issues
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | AMD Athlon64 3000+ with ATI Radeon 7500 video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-851 PATH-851]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Crash in the beta viewer relating to LLLoginInstance
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-857 PATH-857] [https://jira.secondlife.com/browse/VWR-29500 VWR-29500]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Shadows not operational under Second Life Beta 3.4.0.262596
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac OS X 10.7.4 with ATI Radeon X1600 OpenGL Engine video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-880 PATH-880] [https://jira.secondlife.com/browse/PATHBUG-189 PATHBUG-189]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Characters Waking Sideways and Backwards
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-814 PATH-814]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 laptop displays black environment</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 with AMD Radeon HD5650M Mobile graphics</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (262596)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-826 PATH-826]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Random crash while wearing a mesh avatar and dropping objects in-world</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (262596)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1413 MAINT-1413] [https://jira.secondlife.com/browse/VWR-29491 VWR-29491]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>"Weights Of Selected" never gives any results after pathfinding tools were merged in.</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1414 MAINT-1414] [https://jira.secondlife.com/browse/VWR-29497 VWR-29497]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>User is not able to specify color of object with unchecked 'Apply now' chechbox</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1425 MAINT-1425]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>viewer spams the log with "LLViewerParcelMgr::requestParcelMediaURLFilter: can't get ParcelMediaURLFilterList cap" while editing an object</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1426 MAINT-1426]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Texture repeats/meter reset before you can click Apply button</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-643 PATH-643] [https://jira.secondlife.com/browse/PATHBUG-174 PATHBUG-174]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Changes in Preferences dialog stops work of Pathfinding View/Test functionality</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-842 PATH-842] [https://jira.secondlife.com/browse/VWR-29431 VWR-29431] [https://jira.secondlife.com/browse/MAINT-1362 MAINT-1362]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>TargetOmega object's rotation resets if it changes color in 3.4.0 (262596) Beta</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-849 PATH-849]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Crash in the beta viewer relating to pathfinding</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-852 PATH-852]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Custom cursors fail on mac and linux</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-854 PATH-854]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Add support in the viewer to display the Scripted column on the linksets floater</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-856 PATH-856]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>As a user, I want to see a notification when I am toggling the phantom flag on a linkset through the Pathfinding Linkset floater</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1480 MAINT-1480]</del> <del>[https://jira.secondlife.com/browse/VWR-29562 VWR-29562]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>llSetRot does not clear TargetOmega rotation</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (264601)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1506 MAINT-1506]</del> <del>[https://jira.secondlife.com/browse/VWR-29644 VWR-29644]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Keyframe Motion leads the Second Life Beta Viewer - version 3.4.0 (264194) to unexpected results.</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (264601)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-864 PATH-864]</del> <del>[https://jira.secondlife.com/browse/PATHBUG-184 PATHBUG-184]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Allow the Linkset floater to shrink smaller than actually</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (264601)
|}

Pathfinding Tools in the Second Life Viewer

2012-09-13T21:20:49Z

Stinson Linden: /* Known Issues */

{{Pathfinding Nav}}
__TOC__
{{KBnote|The Viewer tools described here are available only in the '''Second Life Viewer Beta''' build. Look under the "Other Viewers" section on the [http://secondlife.com/support/downloads/ Second Life Viewer download page]}}
== Introduction ==
For pathfinding, each region has a navigation mesh, commonly referred to as a "'''navmesh'''". The '''navmesh''' is a representation of the region's geometry generated and used by the physics simulator to determine paths for the pathfinding characters. The navmesh may be in one of the following three states:

* Up-to-date
* Has pending changes
* Building ''(a.k.a. rebaking)''

The navmesh will transition through these states according to the following diagram:

[[File:Navmesh_transitions.png|alt=Second Life Pathfinding NavMesh Transitions|Second Life Pathfinding NavMesh Transitions]]

Six new elements have been added to the SL Viewer interface to communicate the navmesh state for the current region. These new elements are:

* icon representations of the pathfinding region state for the SLURL bar
* a "Rebake region" button that appears above the lower toolbar
* a right-click context menu option addition
* an additional field on the Build floater
* an additional field on the Object Profile floater
* additional simulator metrics on the Statistics floater

In addition to these new elements, three new floaters allow users to more efficiently create, visualize, test, and debug pathfinding-enabled characters. These tools are not required to create pathfinding behaviors but are particularly useful to builders and experienced creators in Second Life. These new floaters are:

* Pathfinding linksets
* Pathfinding characters
* Pathfinding view / test

== Pathfinding UI Elements ==

'''Note that other residents editing pathfinding objects on the same region may create pending changes to the navmesh.''' When this occurs, all residents on the same region and with build rights will see the appropriate SLURL bar icons and rebake region button.

=== Pathfinding Icons in SLURL Bar ===

The SLURL bar indicates the three pathfinding states of the current region.
# '''Navmesh is up-to-date''' The current region's navmesh is up-to-date. No icon is shown as this is the expected default state. [[File:Pathfinding-clean-region-1.png|alt=Second Life URL Bar with Up-to-Date NavMesh Icon|Second Life URL Bar with Up-to-Date NavMesh Icon]]
# '''Navmesh has pending changes''' The region has pending changes that have not yet been baked into the navmesh. A pathfinding icon with a construction symbol is shown. [[File:Pathfinding-dirty-region-1.png|alt=Second Life URL Bar with Pending Changes Icon|Second Life URL Bar with Pending Changes Icon]]
# '''Dynamic pathfinding is disabled''' The region has dynamic pathfinding disabled. Pathfinding characters will not work as expected. A pathfinding icon with a disabled symbol is shown. [[File:Pathfinding-disabled-region-1.png|alt=Second Life URL Bar with Pathfinding Disabled Icon|Second Life URL Bar with Pathfinding Disabled Icon]]

=== Rebake Region Button ===

When a region has pending changes, the appropriate icon will be shown in the SLURL bar, as described above. In addition, if the user has build rights for any parcel on the current region, the user will also be able to see a "Rebake region" button that displays above the lower toolbar.

[[File:Rebake-button-1.png|alt=Second Life Rebake Region button that allows permitted users to rebake pathfinding changes into the navmesh]]

When the user clicks this button, a request is sent to the region to rebake the navmesh for the current region. As rebaking a region may be a time intensive process, the button will change to indicate "Region is rebaking" during this server process. After the rebaking is complete, this button on the viewer will vanish.

[[File:Rebaking-button-1.png|alt=Second Life Region is Rebaking button that indicates that the current region is rebaking its navmesh]]

=== Right-click context menu behavior ===

When right-clicking on an object in-world, pathfinding-specific menu options may be included in the pop-up context menu.

If the user right-clicks on a '''linkset''' object in-world, a menu option "Show in linksets" will allow the user to open the Pathfinding Linksets floater with the current object selected.

[[File:Right-click-show-in-linksets-1.png|alt=Second Life Context Menu with Show in Linksets floater menu option]]

If the user right-clicks on a pathfinding '''character''' object in-world, a menu option "Show in characters" will allow the user to open the Pathfinding Characters floater with the current object selected.

[[File:Right-click-show-in-characters-1.png|alt=Second Life Context Menu with Show in Characters floater menu option]]

=== Additional field on the Build floater ===

The Build floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Build floater with a ''character'' object selected.

[[File:Build-floater-character-1.png|alt=Build floater with pathfinding attribute character|Build floater with pathfinding attribute character]]

The following image is a screenshot of the Build floater with an object that ''affects navmesh'' selected. This object could be a ''walkable'', ''static obstacle'', ''material volume'', or ''exclusion volume''.

[[File:Build-floater-affects-navmesh-1.png|alt=Build floater with pathfinding attribute affects navmesh|Build floater with pathfinding attribute affects navmesh]]

{{KBwarning|For linksets that do affect the navmesh, it will be impossible to modify the object across the region boundary. The user and the object affecting a navmesh must be in the same region to enable modification of the object. This will be indicated on the General tab of the Build floater as illustrated in the following screenshot.}}
[[File:Build-floater-region-boundary-1.png|alt=Build floater indicating that the user cannot modify object across a region boundary|Build floater indicating that the user cannot modify object across a region boundary]]

=== Additional field on the Object Profile floater ===

Similar to the afore-described Build floater, the Object Profile floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Object Profile floater with an ''affects navmesh'' object selected.

[[File:Object-profile-1.png|alt=Object Profile floater with pathfinding attribute affects navmesh|Object Profile floater with pathfinding attribute affects navmesh]]

=== Additional simulator metrics on the Statistics floater ===

For advanced users, additional simulator metrics have been added to the Statistics floater. The Statistics floater, available from the main menu Advanced > Performance Tools > Statistics Bar, has the following 3 additional fields reporting statistics from the simulator regarding pathfinding activity:

* '''AI Step Time''' - The average time spent during each frame computing character AI events.
* '''Skipped Silhouette Steps''' - The number of steps that are skipped per second in computing the influence of objects of type ''Movable Obstacles'' on the navmesh. A high value here means that objects on the region are marked as ''Movable Obstacles'' and could be contributing to improper pathfinding behavior on the region. To lower this value, set all objects that do not move to either type ''Walkable'' or ''Static Obstacle'', and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]].
* '''Characters Updated''' - The average percentage of characters updated during each frame. A low value here means that character AI computations are taking too long during each frame, and thus some character updates are skipped during subsequent frames. This could be contributing to improper pathfinding behavior on the region. To increase this value, decrease the number of characters on the region, and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]]. Note that the Pathfinding Characters floater (described below) may also be used to determine which characters on the region are contributing the most to the region's CPU time.

[[File:Pathfinding-stats-2.png|alt=Simulator Statistics floater with additional pathfinding statistics|Simulator Statistics floater with additional pathfinding statistics]]

== Pathfinding Floaters ==

These three pathfinding floaters may all be accessed through the Build->Pathfinding menu in the Project Viewer - Pathfinding.

[[File:Build-menu-pf-selected-1.png|alt=Second Life Build Menu with new Pathfinding menu items|SL Build -> Pathfinding Menu]]

 

=== Pathfinding Linksets Floater ===

==== Overview ====

The intent of the Pathfinding Linksets floater is to give advanced users and builders the ability to customize an area to achieve interesting effects with pathfinding-enabled characters.

The floater displays information for all linksets within the current region for which the user has the ability to alter. The table reports useful information including
* Linkset Name
* Description
* Owner
* Whether the object is Scripted
* Land Impact
* Distance from the resident's avatar
* Linkset Use
** Potential values
*** Walkable
*** Static Obstacle
*** Movable Obstacle
*** Material Volume
*** Exclusion Volume
*** Movable Phantom
* Walkability Coefficients
** Character Type A ''(example use: humanoid)''
** Character Type B ''(example use: creature)''
** Character Type C ''(example use: mechanical)''
** Character Type D ''(example use: other)''

Additionally, selecting any linksets within the floater will also select the object(s) within the Viewer.

[[File:Linksets-floater-3.png|alt=Pathfinding Linksets floater|Pathfinding Linksets]]

 

==== Controls ====

{{:Viewerhelp:Pathfinding linksets}}

==== Example use ====

The advanced users and builders will use the Pathfinding Linksets floater to customize areas to create interesting effects for pathfinding-enabled characters.

For instance, imagine the scenario of a builder constructing a single room in a pathfinding-enabled house. For the single room, the builder would use the following types as follows:

{|border="1"
! Linkset Use !! Description
|-
|width="200" align="center" | Walkable || align="left" | The floor linkset would be set to be Walkable to allow characters to move across the floor.
|-
|width="200" align="center" | Static Obstacle || align="left" | A desk linkset in the room would be set to be Static Obstacle to block characters from walking through or across the object.

NOTE Any object that should block character movement and that does not move should be marked as Static Obstacle to improve performance of pathfinding characters.
|-
|width="200" align="center" | Movable Obstacle || align="left" | A door linkset in the room would be set to be Movable Obstacle. This will still block characters but, in contrast to Static Obstacles, Movable Obstacles will allow the linkset itself to move. In the case of the door, this will allow the door to open and close, but will still prevent characters from walking through the door.
|-
|width="200" align="center" | Material Volume || align="left" | Material Volumes are phantom objects that can be used to affect the walkability coefficients of intersecting objects. Imagine that the builder applied a texture to the floor. Also, imagine that the floor texture includes small throw rug in the middle of the room. (The builder did not want to create a separate object for the rug, so is using a texture on the floor to give the appearance of a rug). The builder can then create a Material Volume object intersecting the floor at the location of the rug. Then, by setting a lower walkability coefficient for the Material Volume, the builder will create the affect of slowing down characters as the characters traverse across the painted rug area.
|-
|width="200" align="center" | Exclusion Volume || align="left" | Exclusion Volumes are phantom objects that can be used to create areas where characters are prevented from moving. For instance, the builder can use an Exclusion Volume to create a section of the room where avatars would be able to move, but characters would be blocked from following.
|-
|width="200" align="center" | Movable Phantom || align="left" | Movable Phantoms are phantom objects that have no affect on pathfinding-enabled characters.
|}
 
In addition to linkset use attributes, builders can achieve additional effects by modifying the walkability coefficients for linksets. The walkability coefficients are values, ranging from 0% to 100%, that affect a characters speed. A walkability coefficient of 50% will reduce a character's speed by half while the character is traversing across the linkset.
 

=== Pathfinding Characters Floater ===

==== Overview ====
The intent of Pathfinding Characters floater is primarily for users to locate characters moving throughout a region and to identify the CPU cost of characters affecting the performance of a region.

The floater displays information for all characters within the current region for which the user has the ability to manipulate. The table reports useful information including
* Character Name
* Description
* Owner
* CPU Time
* Altitude

[[File:Characters-floater-1.png|alt=Pathfinding Characters floater|Pathfinding Characters]]
 
==== Controls ====

{{:Viewerhelp:Pathfinding characters}}

==== Example use ====
# If a region owner has created a pathfinding-enabled character but is unable to find the character within the region, the Characters floater can be used to locate and select the character.
# Additionally, the Pathfinding Characters floater reports the CPU time cost for each character within the region. This functionality can be used by advanced users to identify which characters are impacting performance the most.

=== Pathfinding View/Test Floater ===

==== Overview ====

The intent of the Pathfinding View/Test floater is for advanced users who are building pathfinding-enabled objects and characters.

This floater consists of 3 basic areas.

# Status area (illustrating both the Viewer and Simulator status of the region's navmesh)
# View tab Controls
# Test Path tab Controls

The following image is a screenshot of the Pathfinding View/Test floater with the navmesh displayed.

[[File:View-nav-mesh-1.png|alt=Pathfinding View/Test floater with the navmesh displayed|Pathfinding View/Test with navmesh displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with the pathfinding object types displayed.

[[File:View-pf-types-1.png|alt=Pathfinding View/Test floater with the pathfinding object types displayed|Pathfinding View/Test with the pathfinding object types displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with a test path displayed.

[[File:View-test-path-1.png|alt=Pathfinding View/Test floater with a test path displayed|Pathfinding View/Test with a test path displayed]]

 
==== Controls ====

{{:Viewerhelp:Pathfinding edit and test}}

==== Example Use ====

# The advanced user will use the Visualization controls to visualize how the navmesh and related permanent objects have been generated. By seeing this visualization of how the physics engine interprets the navigation information, the advanced user can understand how to better customize the pathfinding-enabled objects to obtain the desired behaviors of characters.
# The advanced user will use the Test Tab to visualize how a test character would choose the path between selected start and end points.

 

== Known Issues ==

{| style="border-style:solid;border-width:2px 0 2px 0px;"
! style="border-style:solid;border-width:0 0 1px 0" width="130" | JIRA
! style="border-style:solid;border-width:0 0 1px 0" width="300" | Summary
! style="border-style:solid;border-width:0 0 1px 0" width="550" | Hardware
! style="border-style:solid;border-width:0 0 1px 0" width="100" | Fixed in Version
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1291 MAINT-1291]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Enable Debug GL crashes the viewer to the desktop
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac Pro running 10.7.4 with AMD Radeon HD5770 iMac running Mac OS X Lion 10.7.4 (11E53) with AMD Radeon HD 6770M (512 MB) PC Clone running XP Pro with GeForce2 Ultra
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1561 MAINT-1561] [https://jira.secondlife.com/browse/BUG-86 BUG-86]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Pendulum motion is incorrect after world view is out of focus
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-572 PATH-572]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Underwater 'Walkables' shapes are reflected about the water plane
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-659 PATH-659]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | navmesh being drawn over worn flexi prims and under avatar
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-790 PATH-790]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Physics capsule rendering of character shapes is broken after zooming
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-812 PATH-812]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Show capsules option creates black capsule instead of blue
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | ATI Radeon X300 Video card ATI Radeon X600 Video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-821 PATH-821]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop displays black environment
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop with AMD Radeon HD 4200 Mobile graphics
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-822 PATH-822]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Configuration with ATI Radeon 7500 can launch Viewer, serious GFx issues
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | AMD Athlon64 3000+ with ATI Radeon 7500 video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-851 PATH-851]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Crash in the beta viewer relating to LLLoginInstance
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-857 PATH-857] [https://jira.secondlife.com/browse/VWR-29500 VWR-29500]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Shadows not operational under Second Life Beta 3.4.0.262596
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac OS X 10.7.4 with ATI Radeon X1600 OpenGL Engine video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-814 PATH-814]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 laptop displays black environment</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 with AMD Radeon HD5650M Mobile graphics</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (262596)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-826 PATH-826]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Random crash while wearing a mesh avatar and dropping objects in-world</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (262596)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1413 MAINT-1413] [https://jira.secondlife.com/browse/VWR-29491 VWR-29491]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>"Weights Of Selected" never gives any results after pathfinding tools were merged in.</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1414 MAINT-1414] [https://jira.secondlife.com/browse/VWR-29497 VWR-29497]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>User is not able to specify color of object with unchecked 'Apply now' chechbox</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1425 MAINT-1425]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>viewer spams the log with "LLViewerParcelMgr::requestParcelMediaURLFilter: can't get ParcelMediaURLFilterList cap" while editing an object</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1426 MAINT-1426]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Texture repeats/meter reset before you can click Apply button</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-643 PATH-643] [https://jira.secondlife.com/browse/PATHBUG-174 PATHBUG-174]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Changes in Preferences dialog stops work of Pathfinding View/Test functionality</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-842 PATH-842] [https://jira.secondlife.com/browse/VWR-29431 VWR-29431] [https://jira.secondlife.com/browse/MAINT-1362 MAINT-1362]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>TargetOmega object's rotation resets if it changes color in 3.4.0 (262596) Beta</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-849 PATH-849]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Crash in the beta viewer relating to pathfinding</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-852 PATH-852]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Custom cursors fail on mac and linux</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-854 PATH-854]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Add support in the viewer to display the Scripted column on the linksets floater</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-856 PATH-856]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>As a user, I want to see a notification when I am toggling the phantom flag on a linkset through the Pathfinding Linkset floater</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1480 MAINT-1480]</del> <del>[https://jira.secondlife.com/browse/VWR-29562 VWR-29562]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>llSetRot does not clear TargetOmega rotation</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (264601)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1506 MAINT-1506]</del> <del>[https://jira.secondlife.com/browse/VWR-29644 VWR-29644]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Keyframe Motion leads the Second Life Beta Viewer - version 3.4.0 (264194) to unexpected results.</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (264601)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-864 PATH-864]</del> <del>[https://jira.secondlife.com/browse/PATHBUG-184 PATHBUG-184]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Allow the Linkset floater to shrink smaller than actually</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (264601)
|}

Pathfinding Tools in the Second Life Viewer

2012-09-12T19:45:04Z

Stinson Linden: /* Overview */

Pathfinding Tools in the Second Life Viewer

2012-09-12T19:44:36Z

Stinson Linden: /* Overview */

{{Pathfinding Nav}}
__TOC__
{{KBnote|The Viewer tools described here are available only in the '''Second Life Viewer Beta''' build. Look under the "Other Viewers" section on the [http://secondlife.com/support/downloads/ Second Life Viewer download page]}}
== Introduction ==
For pathfinding, each region has a navigation mesh, commonly referred to as a "'''navmesh'''". The '''navmesh''' is a representation of the region's geometry generated and used by the physics simulator to determine paths for the pathfinding characters. The navmesh may be in one of the following three states:

* Up-to-date
* Has pending changes
* Building ''(a.k.a. rebaking)''

The navmesh will transition through these states according to the following diagram:

[[File:Navmesh_transitions.png|alt=Second Life Pathfinding NavMesh Transitions|Second Life Pathfinding NavMesh Transitions]]

Six new elements have been added to the SL Viewer interface to communicate the navmesh state for the current region. These new elements are:

* icon representations of the pathfinding region state for the SLURL bar
* a "Rebake region" button that appears above the lower toolbar
* a right-click context menu option addition
* an additional field on the Build floater
* an additional field on the Object Profile floater
* additional simulator metrics on the Statistics floater

In addition to these new elements, three new floaters allow users to more efficiently create, visualize, test, and debug pathfinding-enabled characters. These tools are not required to create pathfinding behaviors but are particularly useful to builders and experienced creators in Second Life. These new floaters are:

* Pathfinding linksets
* Pathfinding characters
* Pathfinding view / test

== Pathfinding UI Elements ==

'''Note that other residents editing pathfinding objects on the same region may create pending changes to the navmesh.''' When this occurs, all residents on the same region and with build rights will see the appropriate SLURL bar icons and rebake region button.

=== Pathfinding Icons in SLURL Bar ===

The SLURL bar indicates the three pathfinding states of the current region.
# '''Navmesh is up-to-date''' The current region's navmesh is up-to-date. No icon is shown as this is the expected default state. [[File:Pathfinding-clean-region-1.png|alt=Second Life URL Bar with Up-to-Date NavMesh Icon|Second Life URL Bar with Up-to-Date NavMesh Icon]]
# '''Navmesh has pending changes''' The region has pending changes that have not yet been baked into the navmesh. A pathfinding icon with a construction symbol is shown. [[File:Pathfinding-dirty-region-1.png|alt=Second Life URL Bar with Pending Changes Icon|Second Life URL Bar with Pending Changes Icon]]
# '''Dynamic pathfinding is disabled''' The region has dynamic pathfinding disabled. Pathfinding characters will not work as expected. A pathfinding icon with a disabled symbol is shown. [[File:Pathfinding-disabled-region-1.png|alt=Second Life URL Bar with Pathfinding Disabled Icon|Second Life URL Bar with Pathfinding Disabled Icon]]

=== Rebake Region Button ===

When a region has pending changes, the appropriate icon will be shown in the SLURL bar, as described above. In addition, if the user has build rights for any parcel on the current region, the user will also be able to see a "Rebake region" button that displays above the lower toolbar.

[[File:Rebake-button-1.png|alt=Second Life Rebake Region button that allows permitted users to rebake pathfinding changes into the navmesh]]

When the user clicks this button, a request is sent to the region to rebake the navmesh for the current region. As rebaking a region may be a time intensive process, the button will change to indicate "Region is rebaking" during this server process. After the rebaking is complete, this button on the viewer will vanish.

[[File:Rebaking-button-1.png|alt=Second Life Region is Rebaking button that indicates that the current region is rebaking its navmesh]]

=== Right-click context menu behavior ===

When right-clicking on an object in-world, pathfinding-specific menu options may be included in the pop-up context menu.

If the user right-clicks on a '''linkset''' object in-world, a menu option "Show in linksets" will allow the user to open the Pathfinding Linksets floater with the current object selected.

[[File:Right-click-show-in-linksets-1.png|alt=Second Life Context Menu with Show in Linksets floater menu option]]

If the user right-clicks on a pathfinding '''character''' object in-world, a menu option "Show in characters" will allow the user to open the Pathfinding Characters floater with the current object selected.

[[File:Right-click-show-in-characters-1.png|alt=Second Life Context Menu with Show in Characters floater menu option]]

=== Additional field on the Build floater ===

The Build floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Build floater with a ''character'' object selected.

[[File:Build-floater-character-1.png|alt=Build floater with pathfinding attribute character|Build floater with pathfinding attribute character]]

The following image is a screenshot of the Build floater with an object that ''affects navmesh'' selected. This object could be a ''walkable'', ''static obstacle'', ''material volume'', or ''exclusion volume''.

[[File:Build-floater-affects-navmesh-1.png|alt=Build floater with pathfinding attribute affects navmesh|Build floater with pathfinding attribute affects navmesh]]

{{KBwarning|For linksets that do affect the navmesh, it will be impossible to modify the object across the region boundary. The user and the object affecting a navmesh must be in the same region to enable modification of the object. This will be indicated on the General tab of the Build floater as illustrated in the following screenshot.}}
[[File:Build-floater-region-boundary-1.png|alt=Build floater indicating that the user cannot modify object across a region boundary|Build floater indicating that the user cannot modify object across a region boundary]]

=== Additional field on the Object Profile floater ===

Similar to the afore-described Build floater, the Object Profile floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Object Profile floater with an ''affects navmesh'' object selected.

[[File:Object-profile-1.png|alt=Object Profile floater with pathfinding attribute affects navmesh|Object Profile floater with pathfinding attribute affects navmesh]]

=== Additional simulator metrics on the Statistics floater ===

For advanced users, additional simulator metrics have been added to the Statistics floater. The Statistics floater, available from the main menu Advanced > Performance Tools > Statistics Bar, has the following 3 additional fields reporting statistics from the simulator regarding pathfinding activity:

* '''AI Step Time''' - The average time spent during each frame computing character AI events.
* '''Skipped Silhouette Steps''' - The number of steps that are skipped per second in computing the influence of objects of type ''Movable Obstacles'' on the navmesh. A high value here means that objects on the region are marked as ''Movable Obstacles'' and could be contributing to improper pathfinding behavior on the region. To lower this value, set all objects that do not move to either type ''Walkable'' or ''Static Obstacle'', and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]].
* '''Characters Updated''' - The average percentage of characters updated during each frame. A low value here means that character AI computations are taking too long during each frame, and thus some character updates are skipped during subsequent frames. This could be contributing to improper pathfinding behavior on the region. To increase this value, decrease the number of characters on the region, and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]]. Note that the Pathfinding Characters floater (described below) may also be used to determine which characters on the region are contributing the most to the region's CPU time.

[[File:Pathfinding-stats-2.png|alt=Simulator Statistics floater with additional pathfinding statistics|Simulator Statistics floater with additional pathfinding statistics]]

== Pathfinding Floaters ==

These three pathfinding floaters may all be accessed through the Build->Pathfinding menu in the Project Viewer - Pathfinding.

[[File:Build-menu-pf-selected-1.png|alt=Second Life Build Menu with new Pathfinding menu items|SL Build -> Pathfinding Menu]]

 

=== Pathfinding Linksets Floater ===

==== Overview ====

The intent of the Pathfinding Linksets floater is to give advanced users and builders the ability to customize an area to achieve interesting effects with pathfinding-enabled characters.

The floater displays information for all linksets within the current region for which the user has the ability to alter. The table reports useful information including
* Linkset Name
* Description
* Owner
* Whether the object is scripted
* Land Impact
* Distance from the resident's avatar
* Linkset Use
** Potential values
*** Walkable
*** Static Obstacle
*** Movable Obstacle
*** Material Volume
*** Exclusion Volume
*** Movable Phantom
* Walkability Coefficients
** Character Type A ''(example use: humanoid)''
** Character Type B ''(example use: creature)''
** Character Type C ''(example use: mechanical)''
** Character Type D ''(example use: other)''

Additionally, selecting any linksets within the floater will also select the object(s) within the Viewer.

[[File:Linksets-floater-3.png|alt=Pathfinding Linksets floater|Pathfinding Linksets]]

 

==== Controls ====

{{:Viewerhelp:Pathfinding linksets}}

==== Example use ====

The advanced users and builders will use the Pathfinding Linksets floater to customize areas to create interesting effects for pathfinding-enabled characters.

For instance, imagine the scenario of a builder constructing a single room in a pathfinding-enabled house. For the single room, the builder would use the following types as follows:

{|border="1"
! Linkset Use !! Description
|-
|width="200" align="center" | Walkable || align="left" | The floor linkset would be set to be Walkable to allow characters to move across the floor.
|-
|width="200" align="center" | Static Obstacle || align="left" | A desk linkset in the room would be set to be Static Obstacle to block characters from walking through or across the object.

NOTE Any object that should block character movement and that does not move should be marked as Static Obstacle to improve performance of pathfinding characters.
|-
|width="200" align="center" | Movable Obstacle || align="left" | A door linkset in the room would be set to be Movable Obstacle. This will still block characters but, in contrast to Static Obstacles, Movable Obstacles will allow the linkset itself to move. In the case of the door, this will allow the door to open and close, but will still prevent characters from walking through the door.
|-
|width="200" align="center" | Material Volume || align="left" | Material Volumes are phantom objects that can be used to affect the walkability coefficients of intersecting objects. Imagine that the builder applied a texture to the floor. Also, imagine that the floor texture includes small throw rug in the middle of the room. (The builder did not want to create a separate object for the rug, so is using a texture on the floor to give the appearance of a rug). The builder can then create a Material Volume object intersecting the floor at the location of the rug. Then, by setting a lower walkability coefficient for the Material Volume, the builder will create the affect of slowing down characters as the characters traverse across the painted rug area.
|-
|width="200" align="center" | Exclusion Volume || align="left" | Exclusion Volumes are phantom objects that can be used to create areas where characters are prevented from moving. For instance, the builder can use an Exclusion Volume to create a section of the room where avatars would be able to move, but characters would be blocked from following.
|-
|width="200" align="center" | Movable Phantom || align="left" | Movable Phantoms are phantom objects that have no affect on pathfinding-enabled characters.
|}
 
In addition to linkset use attributes, builders can achieve additional effects by modifying the walkability coefficients for linksets. The walkability coefficients are values, ranging from 0% to 100%, that affect a characters speed. A walkability coefficient of 50% will reduce a character's speed by half while the character is traversing across the linkset.
 

=== Pathfinding Characters Floater ===

==== Overview ====
The intent of Pathfinding Characters floater is primarily for users to locate characters moving throughout a region and to identify the CPU cost of characters affecting the performance of a region.

The floater displays information for all characters within the current region for which the user has the ability to manipulate. The table reports useful information including
* Character Name
* Description
* Owner
* CPU Time
* Altitude

[[File:Characters-floater-1.png|alt=Pathfinding Characters floater|Pathfinding Characters]]
 
==== Controls ====

{{:Viewerhelp:Pathfinding characters}}

==== Example use ====
# If a region owner has created a pathfinding-enabled character but is unable to find the character within the region, the Characters floater can be used to locate and select the character.
# Additionally, the Pathfinding Characters floater reports the CPU time cost for each character within the region. This functionality can be used by advanced users to identify which characters are impacting performance the most.

=== Pathfinding View/Test Floater ===

==== Overview ====

The intent of the Pathfinding View/Test floater is for advanced users who are building pathfinding-enabled objects and characters.

This floater consists of 3 basic areas.

# Status area (illustrating both the Viewer and Simulator status of the region's navmesh)
# View tab Controls
# Test Path tab Controls

The following image is a screenshot of the Pathfinding View/Test floater with the navmesh displayed.

[[File:View-nav-mesh-1.png|alt=Pathfinding View/Test floater with the navmesh displayed|Pathfinding View/Test with navmesh displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with the pathfinding object types displayed.

[[File:View-pf-types-1.png|alt=Pathfinding View/Test floater with the pathfinding object types displayed|Pathfinding View/Test with the pathfinding object types displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with a test path displayed.

[[File:View-test-path-1.png|alt=Pathfinding View/Test floater with a test path displayed|Pathfinding View/Test with a test path displayed]]

 
==== Controls ====

{{:Viewerhelp:Pathfinding edit and test}}

==== Example Use ====

# The advanced user will use the Visualization controls to visualize how the navmesh and related permanent objects have been generated. By seeing this visualization of how the physics engine interprets the navigation information, the advanced user can understand how to better customize the pathfinding-enabled objects to obtain the desired behaviors of characters.
# The advanced user will use the Test Tab to visualize how a test character would choose the path between selected start and end points.

 

== Known Issues ==

{| style="border-style:solid;border-width:2px 0 2px 0px;"
! style="border-style:solid;border-width:0 0 1px 0" width="130" | JIRA
! style="border-style:solid;border-width:0 0 1px 0" width="300" | Summary
! style="border-style:solid;border-width:0 0 1px 0" width="550" | Hardware
! style="border-style:solid;border-width:0 0 1px 0" width="100" | Fixed in Version
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1291 MAINT-1291]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Enable Debug GL crashes the viewer to the desktop
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac Pro running 10.7.4 with AMD Radeon HD5770 iMac running Mac OS X Lion 10.7.4 (11E53) with AMD Radeon HD 6770M (512 MB) PC Clone running XP Pro with GeForce2 Ultra
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-572 PATH-572]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Underwater 'Walkables' shapes are reflected about the water plane
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-659 PATH-659]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | navmesh being drawn over worn flexi prims and under avatar
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-790 PATH-790]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Physics capsule rendering of character shapes is broken after zooming
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-812 PATH-812]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Show capsules option creates black capsule instead of blue
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | ATI Radeon X300 Video card ATI Radeon X600 Video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-821 PATH-821]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop displays black environment
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop with AMD Radeon HD 4200 Mobile graphics
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-822 PATH-822]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Configuration with ATI Radeon 7500 can launch Viewer, serious GFx issues
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | AMD Athlon64 3000+ with ATI Radeon 7500 video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-851 PATH-851]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Crash in the beta viewer relating to LLLoginInstance
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-857 PATH-857] [https://jira.secondlife.com/browse/VWR-29500 VWR-29500]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Shadows not operational under Second Life Beta 3.4.0.262596
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac OS X 10.7.4 with ATI Radeon X1600 OpenGL Engine video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-814 PATH-814]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 laptop displays black environment</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 with AMD Radeon HD5650M Mobile graphics</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (262596)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-826 PATH-826]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Random crash while wearing a mesh avatar and dropping objects in-world</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (262596)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1413 MAINT-1413] [https://jira.secondlife.com/browse/VWR-29491 VWR-29491]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>"Weights Of Selected" never gives any results after pathfinding tools were merged in.</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1414 MAINT-1414] [https://jira.secondlife.com/browse/VWR-29497 VWR-29497]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>User is not able to specify color of object with unchecked 'Apply now' chechbox</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1425 MAINT-1425]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>viewer spams the log with "LLViewerParcelMgr::requestParcelMediaURLFilter: can't get ParcelMediaURLFilterList cap" while editing an object</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1426 MAINT-1426]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Texture repeats/meter reset before you can click Apply button</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-643 PATH-643] [https://jira.secondlife.com/browse/PATHBUG-174 PATHBUG-174]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Changes in Preferences dialog stops work of Pathfinding View/Test functionality</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-842 PATH-842] [https://jira.secondlife.com/browse/VWR-29431 VWR-29431] [https://jira.secondlife.com/browse/MAINT-1362 MAINT-1362]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>TargetOmega object's rotation resets if it changes color in 3.4.0 (262596) Beta</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-849 PATH-849]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Crash in the beta viewer relating to pathfinding</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-852 PATH-852]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Custom cursors fail on mac and linux</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-854 PATH-854]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Add support in the viewer to display the Scripted column on the linksets floater</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-856 PATH-856]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>As a user, I want to see a notification when I am toggling the phantom flag on a linkset through the Pathfinding Linkset floater</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1480 MAINT-1480]</del> <del>[https://jira.secondlife.com/browse/VWR-29562 VWR-29562]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>llSetRot does not clear TargetOmega rotation</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (264601)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1506 MAINT-1506]</del> <del>[https://jira.secondlife.com/browse/VWR-29644 VWR-29644]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Keyframe Motion leads the Second Life Beta Viewer - version 3.4.0 (264194) to unexpected results.</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (264601)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-864 PATH-864]</del> <del>[https://jira.secondlife.com/browse/PATHBUG-184 PATHBUG-184]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Allow the Linkset floater to shrink smaller than actually</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (264601)
|}

Pathfinding Tools in the Second Life Viewer

2012-09-12T19:43:39Z

Stinson Linden: /* Overview */

{{Pathfinding Nav}}
__TOC__
{{KBnote|The Viewer tools described here are available only in the '''Second Life Viewer Beta''' build. Look under the "Other Viewers" section on the [http://secondlife.com/support/downloads/ Second Life Viewer download page]}}
== Introduction ==
For pathfinding, each region has a navigation mesh, commonly referred to as a "'''navmesh'''". The '''navmesh''' is a representation of the region's geometry generated and used by the physics simulator to determine paths for the pathfinding characters. The navmesh may be in one of the following three states:

* Up-to-date
* Has pending changes
* Building ''(a.k.a. rebaking)''

The navmesh will transition through these states according to the following diagram:

[[File:Navmesh_transitions.png|alt=Second Life Pathfinding NavMesh Transitions|Second Life Pathfinding NavMesh Transitions]]

Six new elements have been added to the SL Viewer interface to communicate the navmesh state for the current region. These new elements are:

* icon representations of the pathfinding region state for the SLURL bar
* a "Rebake region" button that appears above the lower toolbar
* a right-click context menu option addition
* an additional field on the Build floater
* an additional field on the Object Profile floater
* additional simulator metrics on the Statistics floater

In addition to these new elements, three new floaters allow users to more efficiently create, visualize, test, and debug pathfinding-enabled characters. These tools are not required to create pathfinding behaviors but are particularly useful to builders and experienced creators in Second Life. These new floaters are:

* Pathfinding linksets
* Pathfinding characters
* Pathfinding view / test

== Pathfinding UI Elements ==

'''Note that other residents editing pathfinding objects on the same region may create pending changes to the navmesh.''' When this occurs, all residents on the same region and with build rights will see the appropriate SLURL bar icons and rebake region button.

=== Pathfinding Icons in SLURL Bar ===

The SLURL bar indicates the three pathfinding states of the current region.
# '''Navmesh is up-to-date''' The current region's navmesh is up-to-date. No icon is shown as this is the expected default state. [[File:Pathfinding-clean-region-1.png|alt=Second Life URL Bar with Up-to-Date NavMesh Icon|Second Life URL Bar with Up-to-Date NavMesh Icon]]
# '''Navmesh has pending changes''' The region has pending changes that have not yet been baked into the navmesh. A pathfinding icon with a construction symbol is shown. [[File:Pathfinding-dirty-region-1.png|alt=Second Life URL Bar with Pending Changes Icon|Second Life URL Bar with Pending Changes Icon]]
# '''Dynamic pathfinding is disabled''' The region has dynamic pathfinding disabled. Pathfinding characters will not work as expected. A pathfinding icon with a disabled symbol is shown. [[File:Pathfinding-disabled-region-1.png|alt=Second Life URL Bar with Pathfinding Disabled Icon|Second Life URL Bar with Pathfinding Disabled Icon]]

=== Rebake Region Button ===

When a region has pending changes, the appropriate icon will be shown in the SLURL bar, as described above. In addition, if the user has build rights for any parcel on the current region, the user will also be able to see a "Rebake region" button that displays above the lower toolbar.

[[File:Rebake-button-1.png|alt=Second Life Rebake Region button that allows permitted users to rebake pathfinding changes into the navmesh]]

When the user clicks this button, a request is sent to the region to rebake the navmesh for the current region. As rebaking a region may be a time intensive process, the button will change to indicate "Region is rebaking" during this server process. After the rebaking is complete, this button on the viewer will vanish.

[[File:Rebaking-button-1.png|alt=Second Life Region is Rebaking button that indicates that the current region is rebaking its navmesh]]

=== Right-click context menu behavior ===

When right-clicking on an object in-world, pathfinding-specific menu options may be included in the pop-up context menu.

If the user right-clicks on a '''linkset''' object in-world, a menu option "Show in linksets" will allow the user to open the Pathfinding Linksets floater with the current object selected.

[[File:Right-click-show-in-linksets-1.png|alt=Second Life Context Menu with Show in Linksets floater menu option]]

If the user right-clicks on a pathfinding '''character''' object in-world, a menu option "Show in characters" will allow the user to open the Pathfinding Characters floater with the current object selected.

[[File:Right-click-show-in-characters-1.png|alt=Second Life Context Menu with Show in Characters floater menu option]]

=== Additional field on the Build floater ===

The Build floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Build floater with a ''character'' object selected.

[[File:Build-floater-character-1.png|alt=Build floater with pathfinding attribute character|Build floater with pathfinding attribute character]]

The following image is a screenshot of the Build floater with an object that ''affects navmesh'' selected. This object could be a ''walkable'', ''static obstacle'', ''material volume'', or ''exclusion volume''.

[[File:Build-floater-affects-navmesh-1.png|alt=Build floater with pathfinding attribute affects navmesh|Build floater with pathfinding attribute affects navmesh]]

{{KBwarning|For linksets that do affect the navmesh, it will be impossible to modify the object across the region boundary. The user and the object affecting a navmesh must be in the same region to enable modification of the object. This will be indicated on the General tab of the Build floater as illustrated in the following screenshot.}}
[[File:Build-floater-region-boundary-1.png|alt=Build floater indicating that the user cannot modify object across a region boundary|Build floater indicating that the user cannot modify object across a region boundary]]

=== Additional field on the Object Profile floater ===

Similar to the afore-described Build floater, the Object Profile floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Object Profile floater with an ''affects navmesh'' object selected.

[[File:Object-profile-1.png|alt=Object Profile floater with pathfinding attribute affects navmesh|Object Profile floater with pathfinding attribute affects navmesh]]

=== Additional simulator metrics on the Statistics floater ===

For advanced users, additional simulator metrics have been added to the Statistics floater. The Statistics floater, available from the main menu Advanced > Performance Tools > Statistics Bar, has the following 3 additional fields reporting statistics from the simulator regarding pathfinding activity:

* '''AI Step Time''' - The average time spent during each frame computing character AI events.
* '''Skipped Silhouette Steps''' - The number of steps that are skipped per second in computing the influence of objects of type ''Movable Obstacles'' on the navmesh. A high value here means that objects on the region are marked as ''Movable Obstacles'' and could be contributing to improper pathfinding behavior on the region. To lower this value, set all objects that do not move to either type ''Walkable'' or ''Static Obstacle'', and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]].
* '''Characters Updated''' - The average percentage of characters updated during each frame. A low value here means that character AI computations are taking too long during each frame, and thus some character updates are skipped during subsequent frames. This could be contributing to improper pathfinding behavior on the region. To increase this value, decrease the number of characters on the region, and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]]. Note that the Pathfinding Characters floater (described below) may also be used to determine which characters on the region are contributing the most to the region's CPU time.

[[File:Pathfinding-stats-2.png|alt=Simulator Statistics floater with additional pathfinding statistics|Simulator Statistics floater with additional pathfinding statistics]]

== Pathfinding Floaters ==

These three pathfinding floaters may all be accessed through the Build->Pathfinding menu in the Project Viewer - Pathfinding.

[[File:Build-menu-pf-selected-1.png|alt=Second Life Build Menu with new Pathfinding menu items|SL Build -> Pathfinding Menu]]

 

=== Pathfinding Linksets Floater ===

==== Overview ====

The intent of the Pathfinding Linksets floater is to give advanced users and builders the ability to customize an area to achieve interesting effects with pathfinding-enabled characters.

The floater displays information for all linksets within the current region for which the user has the ability to alter. The table reports useful information including
* Linkset Name
* Description
* Owner
* Land Impact
* Distance from the resident's avatar
* Linkset Use
** Potential values
*** Walkable
*** Static Obstacle
*** Movable Obstacle
*** Material Volume
*** Exclusion Volume
*** Movable Phantom
* Walkability Coefficients
** Character Type A ''(example use: humanoid)''
** Character Type B ''(example use: creature)''
** Character Type C ''(example use: mechanical)''
** Character Type D ''(example use: other)''

Additionally, selecting any linksets within the floater will also select the object(s) within the Viewer.

[[File:Linksets-floater-3.png|alt=Pathfinding Linksets floater|Pathfinding Linksets]]

 

==== Controls ====

{{:Viewerhelp:Pathfinding linksets}}

==== Example use ====

The advanced users and builders will use the Pathfinding Linksets floater to customize areas to create interesting effects for pathfinding-enabled characters.

For instance, imagine the scenario of a builder constructing a single room in a pathfinding-enabled house. For the single room, the builder would use the following types as follows:

{|border="1"
! Linkset Use !! Description
|-
|width="200" align="center" | Walkable || align="left" | The floor linkset would be set to be Walkable to allow characters to move across the floor.
|-
|width="200" align="center" | Static Obstacle || align="left" | A desk linkset in the room would be set to be Static Obstacle to block characters from walking through or across the object.

NOTE Any object that should block character movement and that does not move should be marked as Static Obstacle to improve performance of pathfinding characters.
|-
|width="200" align="center" | Movable Obstacle || align="left" | A door linkset in the room would be set to be Movable Obstacle. This will still block characters but, in contrast to Static Obstacles, Movable Obstacles will allow the linkset itself to move. In the case of the door, this will allow the door to open and close, but will still prevent characters from walking through the door.
|-
|width="200" align="center" | Material Volume || align="left" | Material Volumes are phantom objects that can be used to affect the walkability coefficients of intersecting objects. Imagine that the builder applied a texture to the floor. Also, imagine that the floor texture includes small throw rug in the middle of the room. (The builder did not want to create a separate object for the rug, so is using a texture on the floor to give the appearance of a rug). The builder can then create a Material Volume object intersecting the floor at the location of the rug. Then, by setting a lower walkability coefficient for the Material Volume, the builder will create the affect of slowing down characters as the characters traverse across the painted rug area.
|-
|width="200" align="center" | Exclusion Volume || align="left" | Exclusion Volumes are phantom objects that can be used to create areas where characters are prevented from moving. For instance, the builder can use an Exclusion Volume to create a section of the room where avatars would be able to move, but characters would be blocked from following.
|-
|width="200" align="center" | Movable Phantom || align="left" | Movable Phantoms are phantom objects that have no affect on pathfinding-enabled characters.
|}
 
In addition to linkset use attributes, builders can achieve additional effects by modifying the walkability coefficients for linksets. The walkability coefficients are values, ranging from 0% to 100%, that affect a characters speed. A walkability coefficient of 50% will reduce a character's speed by half while the character is traversing across the linkset.
 

=== Pathfinding Characters Floater ===

==== Overview ====
The intent of Pathfinding Characters floater is primarily for users to locate characters moving throughout a region and to identify the CPU cost of characters affecting the performance of a region.

The floater displays information for all characters within the current region for which the user has the ability to manipulate. The table reports useful information including
* Character Name
* Description
* Owner
* CPU Time
* Altitude

[[File:Characters-floater-1.png|alt=Pathfinding Characters floater|Pathfinding Characters]]
 
==== Controls ====

{{:Viewerhelp:Pathfinding characters}}

==== Example use ====
# If a region owner has created a pathfinding-enabled character but is unable to find the character within the region, the Characters floater can be used to locate and select the character.
# Additionally, the Pathfinding Characters floater reports the CPU time cost for each character within the region. This functionality can be used by advanced users to identify which characters are impacting performance the most.

=== Pathfinding View/Test Floater ===

==== Overview ====

The intent of the Pathfinding View/Test floater is for advanced users who are building pathfinding-enabled objects and characters.

This floater consists of 3 basic areas.

# Status area (illustrating both the Viewer and Simulator status of the region's navmesh)
# View tab Controls
# Test Path tab Controls

The following image is a screenshot of the Pathfinding View/Test floater with the navmesh displayed.

[[File:View-nav-mesh-1.png|alt=Pathfinding View/Test floater with the navmesh displayed|Pathfinding View/Test with navmesh displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with the pathfinding object types displayed.

[[File:View-pf-types-1.png|alt=Pathfinding View/Test floater with the pathfinding object types displayed|Pathfinding View/Test with the pathfinding object types displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with a test path displayed.

[[File:View-test-path-1.png|alt=Pathfinding View/Test floater with a test path displayed|Pathfinding View/Test with a test path displayed]]

 
==== Controls ====

{{:Viewerhelp:Pathfinding edit and test}}

==== Example Use ====

# The advanced user will use the Visualization controls to visualize how the navmesh and related permanent objects have been generated. By seeing this visualization of how the physics engine interprets the navigation information, the advanced user can understand how to better customize the pathfinding-enabled objects to obtain the desired behaviors of characters.
# The advanced user will use the Test Tab to visualize how a test character would choose the path between selected start and end points.

 

== Known Issues ==

{| style="border-style:solid;border-width:2px 0 2px 0px;"
! style="border-style:solid;border-width:0 0 1px 0" width="130" | JIRA
! style="border-style:solid;border-width:0 0 1px 0" width="300" | Summary
! style="border-style:solid;border-width:0 0 1px 0" width="550" | Hardware
! style="border-style:solid;border-width:0 0 1px 0" width="100" | Fixed in Version
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1291 MAINT-1291]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Enable Debug GL crashes the viewer to the desktop
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac Pro running 10.7.4 with AMD Radeon HD5770 iMac running Mac OS X Lion 10.7.4 (11E53) with AMD Radeon HD 6770M (512 MB) PC Clone running XP Pro with GeForce2 Ultra
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-572 PATH-572]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Underwater 'Walkables' shapes are reflected about the water plane
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-659 PATH-659]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | navmesh being drawn over worn flexi prims and under avatar
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-790 PATH-790]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Physics capsule rendering of character shapes is broken after zooming
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-812 PATH-812]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Show capsules option creates black capsule instead of blue
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | ATI Radeon X300 Video card ATI Radeon X600 Video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-821 PATH-821]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop displays black environment
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop with AMD Radeon HD 4200 Mobile graphics
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-822 PATH-822]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Configuration with ATI Radeon 7500 can launch Viewer, serious GFx issues
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | AMD Athlon64 3000+ with ATI Radeon 7500 video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-851 PATH-851]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Crash in the beta viewer relating to LLLoginInstance
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-857 PATH-857] [https://jira.secondlife.com/browse/VWR-29500 VWR-29500]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Shadows not operational under Second Life Beta 3.4.0.262596
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac OS X 10.7.4 with ATI Radeon X1600 OpenGL Engine video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-814 PATH-814]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 laptop displays black environment</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 with AMD Radeon HD5650M Mobile graphics</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (262596)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-826 PATH-826]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Random crash while wearing a mesh avatar and dropping objects in-world</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (262596)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1413 MAINT-1413] [https://jira.secondlife.com/browse/VWR-29491 VWR-29491]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>"Weights Of Selected" never gives any results after pathfinding tools were merged in.</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1414 MAINT-1414] [https://jira.secondlife.com/browse/VWR-29497 VWR-29497]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>User is not able to specify color of object with unchecked 'Apply now' chechbox</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1425 MAINT-1425]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>viewer spams the log with "LLViewerParcelMgr::requestParcelMediaURLFilter: can't get ParcelMediaURLFilterList cap" while editing an object</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1426 MAINT-1426]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Texture repeats/meter reset before you can click Apply button</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-643 PATH-643] [https://jira.secondlife.com/browse/PATHBUG-174 PATHBUG-174]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Changes in Preferences dialog stops work of Pathfinding View/Test functionality</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-842 PATH-842] [https://jira.secondlife.com/browse/VWR-29431 VWR-29431] [https://jira.secondlife.com/browse/MAINT-1362 MAINT-1362]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>TargetOmega object's rotation resets if it changes color in 3.4.0 (262596) Beta</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-849 PATH-849]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Crash in the beta viewer relating to pathfinding</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-852 PATH-852]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Custom cursors fail on mac and linux</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-854 PATH-854]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Add support in the viewer to display the Scripted column on the linksets floater</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-856 PATH-856]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>As a user, I want to see a notification when I am toggling the phantom flag on a linkset through the Pathfinding Linkset floater</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1480 MAINT-1480]</del> <del>[https://jira.secondlife.com/browse/VWR-29562 VWR-29562]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>llSetRot does not clear TargetOmega rotation</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (264601)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1506 MAINT-1506]</del> <del>[https://jira.secondlife.com/browse/VWR-29644 VWR-29644]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Keyframe Motion leads the Second Life Beta Viewer - version 3.4.0 (264194) to unexpected results.</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (264601)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-864 PATH-864]</del> <del>[https://jira.secondlife.com/browse/PATHBUG-184 PATHBUG-184]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Allow the Linkset floater to shrink smaller than actually</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (264601)
|}

File:Linksets-floater-3.png

2012-09-12T19:42:54Z

Stinson Linden:

Pathfinding Tools in the Second Life Viewer

2012-09-12T18:40:07Z

Stinson Linden: /* Known Issues */

{{Pathfinding Nav}}
__TOC__
{{KBnote|The Viewer tools described here are available only in the '''Second Life Viewer Beta''' build. Look under the "Other Viewers" section on the [http://secondlife.com/support/downloads/ Second Life Viewer download page]}}
== Introduction ==
For pathfinding, each region has a navigation mesh, commonly referred to as a "'''navmesh'''". The '''navmesh''' is a representation of the region's geometry generated and used by the physics simulator to determine paths for the pathfinding characters. The navmesh may be in one of the following three states:

* Up-to-date
* Has pending changes
* Building ''(a.k.a. rebaking)''

The navmesh will transition through these states according to the following diagram:

[[File:Navmesh_transitions.png|alt=Second Life Pathfinding NavMesh Transitions|Second Life Pathfinding NavMesh Transitions]]

Six new elements have been added to the SL Viewer interface to communicate the navmesh state for the current region. These new elements are:

* icon representations of the pathfinding region state for the SLURL bar
* a "Rebake region" button that appears above the lower toolbar
* a right-click context menu option addition
* an additional field on the Build floater
* an additional field on the Object Profile floater
* additional simulator metrics on the Statistics floater

In addition to these new elements, three new floaters allow users to more efficiently create, visualize, test, and debug pathfinding-enabled characters. These tools are not required to create pathfinding behaviors but are particularly useful to builders and experienced creators in Second Life. These new floaters are:

* Pathfinding linksets
* Pathfinding characters
* Pathfinding view / test

== Pathfinding UI Elements ==

'''Note that other residents editing pathfinding objects on the same region may create pending changes to the navmesh.''' When this occurs, all residents on the same region and with build rights will see the appropriate SLURL bar icons and rebake region button.

=== Pathfinding Icons in SLURL Bar ===

The SLURL bar indicates the three pathfinding states of the current region.
# '''Navmesh is up-to-date''' The current region's navmesh is up-to-date. No icon is shown as this is the expected default state. [[File:Pathfinding-clean-region-1.png|alt=Second Life URL Bar with Up-to-Date NavMesh Icon|Second Life URL Bar with Up-to-Date NavMesh Icon]]
# '''Navmesh has pending changes''' The region has pending changes that have not yet been baked into the navmesh. A pathfinding icon with a construction symbol is shown. [[File:Pathfinding-dirty-region-1.png|alt=Second Life URL Bar with Pending Changes Icon|Second Life URL Bar with Pending Changes Icon]]
# '''Dynamic pathfinding is disabled''' The region has dynamic pathfinding disabled. Pathfinding characters will not work as expected. A pathfinding icon with a disabled symbol is shown. [[File:Pathfinding-disabled-region-1.png|alt=Second Life URL Bar with Pathfinding Disabled Icon|Second Life URL Bar with Pathfinding Disabled Icon]]

=== Rebake Region Button ===

When a region has pending changes, the appropriate icon will be shown in the SLURL bar, as described above. In addition, if the user has build rights for any parcel on the current region, the user will also be able to see a "Rebake region" button that displays above the lower toolbar.

[[File:Rebake-button-1.png|alt=Second Life Rebake Region button that allows permitted users to rebake pathfinding changes into the navmesh]]

When the user clicks this button, a request is sent to the region to rebake the navmesh for the current region. As rebaking a region may be a time intensive process, the button will change to indicate "Region is rebaking" during this server process. After the rebaking is complete, this button on the viewer will vanish.

[[File:Rebaking-button-1.png|alt=Second Life Region is Rebaking button that indicates that the current region is rebaking its navmesh]]

=== Right-click context menu behavior ===

When right-clicking on an object in-world, pathfinding-specific menu options may be included in the pop-up context menu.

If the user right-clicks on a '''linkset''' object in-world, a menu option "Show in linksets" will allow the user to open the Pathfinding Linksets floater with the current object selected.

[[File:Right-click-show-in-linksets-1.png|alt=Second Life Context Menu with Show in Linksets floater menu option]]

If the user right-clicks on a pathfinding '''character''' object in-world, a menu option "Show in characters" will allow the user to open the Pathfinding Characters floater with the current object selected.

[[File:Right-click-show-in-characters-1.png|alt=Second Life Context Menu with Show in Characters floater menu option]]

=== Additional field on the Build floater ===

The Build floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Build floater with a ''character'' object selected.

[[File:Build-floater-character-1.png|alt=Build floater with pathfinding attribute character|Build floater with pathfinding attribute character]]

The following image is a screenshot of the Build floater with an object that ''affects navmesh'' selected. This object could be a ''walkable'', ''static obstacle'', ''material volume'', or ''exclusion volume''.

[[File:Build-floater-affects-navmesh-1.png|alt=Build floater with pathfinding attribute affects navmesh|Build floater with pathfinding attribute affects navmesh]]

{{KBwarning|For linksets that do affect the navmesh, it will be impossible to modify the object across the region boundary. The user and the object affecting a navmesh must be in the same region to enable modification of the object. This will be indicated on the General tab of the Build floater as illustrated in the following screenshot.}}
[[File:Build-floater-region-boundary-1.png|alt=Build floater indicating that the user cannot modify object across a region boundary|Build floater indicating that the user cannot modify object across a region boundary]]

=== Additional field on the Object Profile floater ===

Similar to the afore-described Build floater, the Object Profile floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Object Profile floater with an ''affects navmesh'' object selected.

[[File:Object-profile-1.png|alt=Object Profile floater with pathfinding attribute affects navmesh|Object Profile floater with pathfinding attribute affects navmesh]]

=== Additional simulator metrics on the Statistics floater ===

For advanced users, additional simulator metrics have been added to the Statistics floater. The Statistics floater, available from the main menu Advanced > Performance Tools > Statistics Bar, has the following 3 additional fields reporting statistics from the simulator regarding pathfinding activity:

* '''AI Step Time''' - The average time spent during each frame computing character AI events.
* '''Skipped Silhouette Steps''' - The number of steps that are skipped per second in computing the influence of objects of type ''Movable Obstacles'' on the navmesh. A high value here means that objects on the region are marked as ''Movable Obstacles'' and could be contributing to improper pathfinding behavior on the region. To lower this value, set all objects that do not move to either type ''Walkable'' or ''Static Obstacle'', and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]].
* '''Characters Updated''' - The average percentage of characters updated during each frame. A low value here means that character AI computations are taking too long during each frame, and thus some character updates are skipped during subsequent frames. This could be contributing to improper pathfinding behavior on the region. To increase this value, decrease the number of characters on the region, and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]]. Note that the Pathfinding Characters floater (described below) may also be used to determine which characters on the region are contributing the most to the region's CPU time.

[[File:Pathfinding-stats-2.png|alt=Simulator Statistics floater with additional pathfinding statistics|Simulator Statistics floater with additional pathfinding statistics]]

== Pathfinding Floaters ==

These three pathfinding floaters may all be accessed through the Build->Pathfinding menu in the Project Viewer - Pathfinding.

[[File:Build-menu-pf-selected-1.png|alt=Second Life Build Menu with new Pathfinding menu items|SL Build -> Pathfinding Menu]]

 

=== Pathfinding Linksets Floater ===

==== Overview ====

The intent of the Pathfinding Linksets floater is to give advanced users and builders the ability to customize an area to achieve interesting effects with pathfinding-enabled characters.

The floater displays information for all linksets within the current region for which the user has the ability to alter. The table reports useful information including
* Linkset Name
* Description
* Owner
* Land Impact
* Distance from the resident's avatar
* Linkset Use
** Potential values
*** Walkable
*** Static Obstacle
*** Movable Obstacle
*** Material Volume
*** Exclusion Volume
*** Movable Phantom
* Walkability Coefficients
** Character Type A ''(example use: humanoid)''
** Character Type B ''(example use: creature)''
** Character Type C ''(example use: mechanical)''
** Character Type D ''(example use: other)''

Additionally, selecting any linksets within the floater will also select the object(s) within the Viewer.

[[File:Linksets-floater-2.png|alt=Pathfinding Linksets floater|Pathfinding Linksets]]

 

==== Controls ====

{{:Viewerhelp:Pathfinding linksets}}

==== Example use ====

The advanced users and builders will use the Pathfinding Linksets floater to customize areas to create interesting effects for pathfinding-enabled characters.

For instance, imagine the scenario of a builder constructing a single room in a pathfinding-enabled house. For the single room, the builder would use the following types as follows:

{|border="1"
! Linkset Use !! Description
|-
|width="200" align="center" | Walkable || align="left" | The floor linkset would be set to be Walkable to allow characters to move across the floor.
|-
|width="200" align="center" | Static Obstacle || align="left" | A desk linkset in the room would be set to be Static Obstacle to block characters from walking through or across the object.

NOTE Any object that should block character movement and that does not move should be marked as Static Obstacle to improve performance of pathfinding characters.
|-
|width="200" align="center" | Movable Obstacle || align="left" | A door linkset in the room would be set to be Movable Obstacle. This will still block characters but, in contrast to Static Obstacles, Movable Obstacles will allow the linkset itself to move. In the case of the door, this will allow the door to open and close, but will still prevent characters from walking through the door.
|-
|width="200" align="center" | Material Volume || align="left" | Material Volumes are phantom objects that can be used to affect the walkability coefficients of intersecting objects. Imagine that the builder applied a texture to the floor. Also, imagine that the floor texture includes small throw rug in the middle of the room. (The builder did not want to create a separate object for the rug, so is using a texture on the floor to give the appearance of a rug). The builder can then create a Material Volume object intersecting the floor at the location of the rug. Then, by setting a lower walkability coefficient for the Material Volume, the builder will create the affect of slowing down characters as the characters traverse across the painted rug area.
|-
|width="200" align="center" | Exclusion Volume || align="left" | Exclusion Volumes are phantom objects that can be used to create areas where characters are prevented from moving. For instance, the builder can use an Exclusion Volume to create a section of the room where avatars would be able to move, but characters would be blocked from following.
|-
|width="200" align="center" | Movable Phantom || align="left" | Movable Phantoms are phantom objects that have no affect on pathfinding-enabled characters.
|}
 
In addition to linkset use attributes, builders can achieve additional effects by modifying the walkability coefficients for linksets. The walkability coefficients are values, ranging from 0% to 100%, that affect a characters speed. A walkability coefficient of 50% will reduce a character's speed by half while the character is traversing across the linkset.
 

=== Pathfinding Characters Floater ===

==== Overview ====
The intent of Pathfinding Characters floater is primarily for users to locate characters moving throughout a region and to identify the CPU cost of characters affecting the performance of a region.

The floater displays information for all characters within the current region for which the user has the ability to manipulate. The table reports useful information including
* Character Name
* Description
* Owner
* CPU Time
* Altitude

[[File:Characters-floater-1.png|alt=Pathfinding Characters floater|Pathfinding Characters]]
 
==== Controls ====

{{:Viewerhelp:Pathfinding characters}}

==== Example use ====
# If a region owner has created a pathfinding-enabled character but is unable to find the character within the region, the Characters floater can be used to locate and select the character.
# Additionally, the Pathfinding Characters floater reports the CPU time cost for each character within the region. This functionality can be used by advanced users to identify which characters are impacting performance the most.

=== Pathfinding View/Test Floater ===

==== Overview ====

The intent of the Pathfinding View/Test floater is for advanced users who are building pathfinding-enabled objects and characters.

This floater consists of 3 basic areas.

# Status area (illustrating both the Viewer and Simulator status of the region's navmesh)
# View tab Controls
# Test Path tab Controls

The following image is a screenshot of the Pathfinding View/Test floater with the navmesh displayed.

[[File:View-nav-mesh-1.png|alt=Pathfinding View/Test floater with the navmesh displayed|Pathfinding View/Test with navmesh displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with the pathfinding object types displayed.

[[File:View-pf-types-1.png|alt=Pathfinding View/Test floater with the pathfinding object types displayed|Pathfinding View/Test with the pathfinding object types displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with a test path displayed.

[[File:View-test-path-1.png|alt=Pathfinding View/Test floater with a test path displayed|Pathfinding View/Test with a test path displayed]]

 
==== Controls ====

{{:Viewerhelp:Pathfinding edit and test}}

==== Example Use ====

# The advanced user will use the Visualization controls to visualize how the navmesh and related permanent objects have been generated. By seeing this visualization of how the physics engine interprets the navigation information, the advanced user can understand how to better customize the pathfinding-enabled objects to obtain the desired behaviors of characters.
# The advanced user will use the Test Tab to visualize how a test character would choose the path between selected start and end points.

 

== Known Issues ==

{| style="border-style:solid;border-width:2px 0 2px 0px;"
! style="border-style:solid;border-width:0 0 1px 0" width="130" | JIRA
! style="border-style:solid;border-width:0 0 1px 0" width="300" | Summary
! style="border-style:solid;border-width:0 0 1px 0" width="550" | Hardware
! style="border-style:solid;border-width:0 0 1px 0" width="100" | Fixed in Version
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1291 MAINT-1291]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Enable Debug GL crashes the viewer to the desktop
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac Pro running 10.7.4 with AMD Radeon HD5770 iMac running Mac OS X Lion 10.7.4 (11E53) with AMD Radeon HD 6770M (512 MB) PC Clone running XP Pro with GeForce2 Ultra
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-572 PATH-572]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Underwater 'Walkables' shapes are reflected about the water plane
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-659 PATH-659]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | navmesh being drawn over worn flexi prims and under avatar
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-790 PATH-790]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Physics capsule rendering of character shapes is broken after zooming
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-812 PATH-812]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Show capsules option creates black capsule instead of blue
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | ATI Radeon X300 Video card ATI Radeon X600 Video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-821 PATH-821]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop displays black environment
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop with AMD Radeon HD 4200 Mobile graphics
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-822 PATH-822]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Configuration with ATI Radeon 7500 can launch Viewer, serious GFx issues
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | AMD Athlon64 3000+ with ATI Radeon 7500 video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-851 PATH-851]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Crash in the beta viewer relating to LLLoginInstance
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-857 PATH-857] [https://jira.secondlife.com/browse/VWR-29500 VWR-29500]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Shadows not operational under Second Life Beta 3.4.0.262596
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac OS X 10.7.4 with ATI Radeon X1600 OpenGL Engine video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-814 PATH-814]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 laptop displays black environment</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 with AMD Radeon HD5650M Mobile graphics</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (262596)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-826 PATH-826]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Random crash while wearing a mesh avatar and dropping objects in-world</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (262596)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1413 MAINT-1413] [https://jira.secondlife.com/browse/VWR-29491 VWR-29491]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>"Weights Of Selected" never gives any results after pathfinding tools were merged in.</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1414 MAINT-1414] [https://jira.secondlife.com/browse/VWR-29497 VWR-29497]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>User is not able to specify color of object with unchecked 'Apply now' chechbox</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1425 MAINT-1425]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>viewer spams the log with "LLViewerParcelMgr::requestParcelMediaURLFilter: can't get ParcelMediaURLFilterList cap" while editing an object</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1426 MAINT-1426]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Texture repeats/meter reset before you can click Apply button</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-643 PATH-643] [https://jira.secondlife.com/browse/PATHBUG-174 PATHBUG-174]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Changes in Preferences dialog stops work of Pathfinding View/Test functionality</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-842 PATH-842] [https://jira.secondlife.com/browse/VWR-29431 VWR-29431] [https://jira.secondlife.com/browse/MAINT-1362 MAINT-1362]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>TargetOmega object's rotation resets if it changes color in 3.4.0 (262596) Beta</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-849 PATH-849]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Crash in the beta viewer relating to pathfinding</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-852 PATH-852]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Custom cursors fail on mac and linux</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-854 PATH-854]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Add support in the viewer to display the Scripted column on the linksets floater</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-856 PATH-856]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>As a user, I want to see a notification when I am toggling the phantom flag on a linkset through the Pathfinding Linkset floater</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1480 MAINT-1480]</del> <del>[https://jira.secondlife.com/browse/VWR-29562 VWR-29562]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>llSetRot does not clear TargetOmega rotation</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (264601)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1506 MAINT-1506]</del> <del>[https://jira.secondlife.com/browse/VWR-29644 VWR-29644]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Keyframe Motion leads the Second Life Beta Viewer - version 3.4.0 (264194) to unexpected results.</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (264601)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-864 PATH-864]</del> <del>[https://jira.secondlife.com/browse/PATHBUG-184 PATHBUG-184]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Allow the Linkset floater to shrink smaller than actually</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (264601)
|}

Pathfinding Tools in the Second Life Viewer

2012-09-08T00:17:03Z

Stinson Linden: /* Known Issues */

{{Pathfinding Nav}}
__TOC__
{{KBnote|The Viewer tools described here are available only in the '''Second Life Viewer Beta''' build. Look under the "Other Viewers" section on the [http://secondlife.com/support/downloads/ Second Life Viewer download page]}}
== Introduction ==
For pathfinding, each region has a navigation mesh, commonly referred to as a "'''navmesh'''". The '''navmesh''' is a representation of the region's geometry generated and used by the physics simulator to determine paths for the pathfinding characters. The navmesh may be in one of the following three states:

* Up-to-date
* Has pending changes
* Building ''(a.k.a. rebaking)''

The navmesh will transition through these states according to the following diagram:

[[File:Navmesh_transitions.png|alt=Second Life Pathfinding NavMesh Transitions|Second Life Pathfinding NavMesh Transitions]]

Six new elements have been added to the SL Viewer interface to communicate the navmesh state for the current region. These new elements are:

* icon representations of the pathfinding region state for the SLURL bar
* a "Rebake region" button that appears above the lower toolbar
* a right-click context menu option addition
* an additional field on the Build floater
* an additional field on the Object Profile floater
* additional simulator metrics on the Statistics floater

In addition to these new elements, three new floaters allow users to more efficiently create, visualize, test, and debug pathfinding-enabled characters. These tools are not required to create pathfinding behaviors but are particularly useful to builders and experienced creators in Second Life. These new floaters are:

* Pathfinding linksets
* Pathfinding characters
* Pathfinding view / test

== Pathfinding UI Elements ==

'''Note that other residents editing pathfinding objects on the same region may create pending changes to the navmesh.''' When this occurs, all residents on the same region and with build rights will see the appropriate SLURL bar icons and rebake region button.

=== Pathfinding Icons in SLURL Bar ===

The SLURL bar indicates the three pathfinding states of the current region.
# '''Navmesh is up-to-date''' The current region's navmesh is up-to-date. No icon is shown as this is the expected default state. [[File:Pathfinding-clean-region-1.png|alt=Second Life URL Bar with Up-to-Date NavMesh Icon|Second Life URL Bar with Up-to-Date NavMesh Icon]]
# '''Navmesh has pending changes''' The region has pending changes that have not yet been baked into the navmesh. A pathfinding icon with a construction symbol is shown. [[File:Pathfinding-dirty-region-1.png|alt=Second Life URL Bar with Pending Changes Icon|Second Life URL Bar with Pending Changes Icon]]
# '''Dynamic pathfinding is disabled''' The region has dynamic pathfinding disabled. Pathfinding characters will not work as expected. A pathfinding icon with a disabled symbol is shown. [[File:Pathfinding-disabled-region-1.png|alt=Second Life URL Bar with Pathfinding Disabled Icon|Second Life URL Bar with Pathfinding Disabled Icon]]

=== Rebake Region Button ===

When a region has pending changes, the appropriate icon will be shown in the SLURL bar, as described above. In addition, if the user has build rights for any parcel on the current region, the user will also be able to see a "Rebake region" button that displays above the lower toolbar.

[[File:Rebake-button-1.png|alt=Second Life Rebake Region button that allows permitted users to rebake pathfinding changes into the navmesh]]

When the user clicks this button, a request is sent to the region to rebake the navmesh for the current region. As rebaking a region may be a time intensive process, the button will change to indicate "Region is rebaking" during this server process. After the rebaking is complete, this button on the viewer will vanish.

[[File:Rebaking-button-1.png|alt=Second Life Region is Rebaking button that indicates that the current region is rebaking its navmesh]]

=== Right-click context menu behavior ===

When right-clicking on an object in-world, pathfinding-specific menu options may be included in the pop-up context menu.

If the user right-clicks on a '''linkset''' object in-world, a menu option "Show in linksets" will allow the user to open the Pathfinding Linksets floater with the current object selected.

[[File:Right-click-show-in-linksets-1.png|alt=Second Life Context Menu with Show in Linksets floater menu option]]

If the user right-clicks on a pathfinding '''character''' object in-world, a menu option "Show in characters" will allow the user to open the Pathfinding Characters floater with the current object selected.

[[File:Right-click-show-in-characters-1.png|alt=Second Life Context Menu with Show in Characters floater menu option]]

=== Additional field on the Build floater ===

The Build floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Build floater with a ''character'' object selected.

[[File:Build-floater-character-1.png|alt=Build floater with pathfinding attribute character|Build floater with pathfinding attribute character]]

The following image is a screenshot of the Build floater with an object that ''affects navmesh'' selected. This object could be a ''walkable'', ''static obstacle'', ''material volume'', or ''exclusion volume''.

[[File:Build-floater-affects-navmesh-1.png|alt=Build floater with pathfinding attribute affects navmesh|Build floater with pathfinding attribute affects navmesh]]

{{KBwarning|For linksets that do affect the navmesh, it will be impossible to modify the object across the region boundary. The user and the object affecting a navmesh must be in the same region to enable modification of the object. This will be indicated on the General tab of the Build floater as illustrated in the following screenshot.}}
[[File:Build-floater-region-boundary-1.png|alt=Build floater indicating that the user cannot modify object across a region boundary|Build floater indicating that the user cannot modify object across a region boundary]]

=== Additional field on the Object Profile floater ===

Similar to the afore-described Build floater, the Object Profile floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Object Profile floater with an ''affects navmesh'' object selected.

[[File:Object-profile-1.png|alt=Object Profile floater with pathfinding attribute affects navmesh|Object Profile floater with pathfinding attribute affects navmesh]]

=== Additional simulator metrics on the Statistics floater ===

For advanced users, additional simulator metrics have been added to the Statistics floater. The Statistics floater, available from the main menu Advanced > Performance Tools > Statistics Bar, has the following 3 additional fields reporting statistics from the simulator regarding pathfinding activity:

* '''AI Step Time''' - The average time spent during each frame computing character AI events.
* '''Skipped Silhouette Steps''' - The number of steps that are skipped per second in computing the influence of objects of type ''Movable Obstacles'' on the navmesh. A high value here means that objects on the region are marked as ''Movable Obstacles'' and could be contributing to improper pathfinding behavior on the region. To lower this value, set all objects that do not move to either type ''Walkable'' or ''Static Obstacle'', and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]].
* '''Characters Updated''' - The average percentage of characters updated during each frame. A low value here means that character AI computations are taking too long during each frame, and thus some character updates are skipped during subsequent frames. This could be contributing to improper pathfinding behavior on the region. To increase this value, decrease the number of characters on the region, and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]]. Note that the Pathfinding Characters floater (described below) may also be used to determine which characters on the region are contributing the most to the region's CPU time.

[[File:Pathfinding-stats-2.png|alt=Simulator Statistics floater with additional pathfinding statistics|Simulator Statistics floater with additional pathfinding statistics]]

== Pathfinding Floaters ==

These three pathfinding floaters may all be accessed through the Build->Pathfinding menu in the Project Viewer - Pathfinding.

[[File:Build-menu-pf-selected-1.png|alt=Second Life Build Menu with new Pathfinding menu items|SL Build -> Pathfinding Menu]]

 

=== Pathfinding Linksets Floater ===

==== Overview ====

The intent of the Pathfinding Linksets floater is to give advanced users and builders the ability to customize an area to achieve interesting effects with pathfinding-enabled characters.

The floater displays information for all linksets within the current region for which the user has the ability to alter. The table reports useful information including
* Linkset Name
* Description
* Owner
* Land Impact
* Distance from the resident's avatar
* Linkset Use
** Potential values
*** Walkable
*** Static Obstacle
*** Movable Obstacle
*** Material Volume
*** Exclusion Volume
*** Movable Phantom
* Walkability Coefficients
** Character Type A ''(example use: humanoid)''
** Character Type B ''(example use: creature)''
** Character Type C ''(example use: mechanical)''
** Character Type D ''(example use: other)''

Additionally, selecting any linksets within the floater will also select the object(s) within the Viewer.

[[File:Linksets-floater-2.png|alt=Pathfinding Linksets floater|Pathfinding Linksets]]

 

==== Controls ====

{{:Viewerhelp:Pathfinding linksets}}

==== Example use ====

The advanced users and builders will use the Pathfinding Linksets floater to customize areas to create interesting effects for pathfinding-enabled characters.

For instance, imagine the scenario of a builder constructing a single room in a pathfinding-enabled house. For the single room, the builder would use the following types as follows:

{|border="1"
! Linkset Use !! Description
|-
|width="200" align="center" | Walkable || align="left" | The floor linkset would be set to be Walkable to allow characters to move across the floor.
|-
|width="200" align="center" | Static Obstacle || align="left" | A desk linkset in the room would be set to be Static Obstacle to block characters from walking through or across the object.

NOTE Any object that should block character movement and that does not move should be marked as Static Obstacle to improve performance of pathfinding characters.
|-
|width="200" align="center" | Movable Obstacle || align="left" | A door linkset in the room would be set to be Movable Obstacle. This will still block characters but, in contrast to Static Obstacles, Movable Obstacles will allow the linkset itself to move. In the case of the door, this will allow the door to open and close, but will still prevent characters from walking through the door.
|-
|width="200" align="center" | Material Volume || align="left" | Material Volumes are phantom objects that can be used to affect the walkability coefficients of intersecting objects. Imagine that the builder applied a texture to the floor. Also, imagine that the floor texture includes small throw rug in the middle of the room. (The builder did not want to create a separate object for the rug, so is using a texture on the floor to give the appearance of a rug). The builder can then create a Material Volume object intersecting the floor at the location of the rug. Then, by setting a lower walkability coefficient for the Material Volume, the builder will create the affect of slowing down characters as the characters traverse across the painted rug area.
|-
|width="200" align="center" | Exclusion Volume || align="left" | Exclusion Volumes are phantom objects that can be used to create areas where characters are prevented from moving. For instance, the builder can use an Exclusion Volume to create a section of the room where avatars would be able to move, but characters would be blocked from following.
|-
|width="200" align="center" | Movable Phantom || align="left" | Movable Phantoms are phantom objects that have no affect on pathfinding-enabled characters.
|}
 
In addition to linkset use attributes, builders can achieve additional effects by modifying the walkability coefficients for linksets. The walkability coefficients are values, ranging from 0% to 100%, that affect a characters speed. A walkability coefficient of 50% will reduce a character's speed by half while the character is traversing across the linkset.
 

=== Pathfinding Characters Floater ===

==== Overview ====
The intent of Pathfinding Characters floater is primarily for users to locate characters moving throughout a region and to identify the CPU cost of characters affecting the performance of a region.

The floater displays information for all characters within the current region for which the user has the ability to manipulate. The table reports useful information including
* Character Name
* Description
* Owner
* CPU Time
* Altitude

[[File:Characters-floater-1.png|alt=Pathfinding Characters floater|Pathfinding Characters]]
 
==== Controls ====

{{:Viewerhelp:Pathfinding characters}}

==== Example use ====
# If a region owner has created a pathfinding-enabled character but is unable to find the character within the region, the Characters floater can be used to locate and select the character.
# Additionally, the Pathfinding Characters floater reports the CPU time cost for each character within the region. This functionality can be used by advanced users to identify which characters are impacting performance the most.

=== Pathfinding View/Test Floater ===

==== Overview ====

The intent of the Pathfinding View/Test floater is for advanced users who are building pathfinding-enabled objects and characters.

This floater consists of 3 basic areas.

# Status area (illustrating both the Viewer and Simulator status of the region's navmesh)
# View tab Controls
# Test Path tab Controls

The following image is a screenshot of the Pathfinding View/Test floater with the navmesh displayed.

[[File:View-nav-mesh-1.png|alt=Pathfinding View/Test floater with the navmesh displayed|Pathfinding View/Test with navmesh displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with the pathfinding object types displayed.

[[File:View-pf-types-1.png|alt=Pathfinding View/Test floater with the pathfinding object types displayed|Pathfinding View/Test with the pathfinding object types displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with a test path displayed.

[[File:View-test-path-1.png|alt=Pathfinding View/Test floater with a test path displayed|Pathfinding View/Test with a test path displayed]]

 
==== Controls ====

{{:Viewerhelp:Pathfinding edit and test}}

==== Example Use ====

# The advanced user will use the Visualization controls to visualize how the navmesh and related permanent objects have been generated. By seeing this visualization of how the physics engine interprets the navigation information, the advanced user can understand how to better customize the pathfinding-enabled objects to obtain the desired behaviors of characters.
# The advanced user will use the Test Tab to visualize how a test character would choose the path between selected start and end points.

 

== Known Issues ==

{| style="border-style:solid;border-width:2px 0 2px 0px;"
! style="border-style:solid;border-width:0 0 1px 0" width="130" | JIRA
! style="border-style:solid;border-width:0 0 1px 0" width="300" | Summary
! style="border-style:solid;border-width:0 0 1px 0" width="550" | Hardware
! style="border-style:solid;border-width:0 0 1px 0" width="100" | Fixed in Version
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1291 MAINT-1291]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Enable Debug GL crashes the viewer to the desktop
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac Pro running 10.7.4 with AMD Radeon HD5770 iMac running Mac OS X Lion 10.7.4 (11E53) with AMD Radeon HD 6770M (512 MB) PC Clone running XP Pro with GeForce2 Ultra
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1480 MAINT-1480] [https://jira.secondlife.com/browse/VWR-29562 VWR-29562]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | llSetRot does not clear TargetOmega rotation
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1506 MAINT-1506] [https://jira.secondlife.com/browse/VWR-29644 VWR-29644]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Keyframe Motion leads the Second Life Beta Viewer - version 3.4.0 (264194) to unexpected results.
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-572 PATH-572]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Underwater 'Walkables' shapes are reflected about the water plane
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-659 PATH-659]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | navmesh being drawn over worn flexi prims and under avatar
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-790 PATH-790]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Physics capsule rendering of character shapes is broken after zooming
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-812 PATH-812]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Show capsules option creates black capsule instead of blue
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | ATI Radeon X300 Video card ATI Radeon X600 Video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-821 PATH-821]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop displays black environment
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop with AMD Radeon HD 4200 Mobile graphics
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-822 PATH-822]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Configuration with ATI Radeon 7500 can launch Viewer, serious GFx issues
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | AMD Athlon64 3000+ with ATI Radeon 7500 video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-851 PATH-851]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Crash in the beta viewer relating to LLLoginInstance
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-857 PATH-857] [https://jira.secondlife.com/browse/VWR-29500 VWR-29500]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Shadows not operational under Second Life Beta 3.4.0.262596
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac OS X 10.7.4 with ATI Radeon X1600 OpenGL Engine video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-864 PATH-864] [https://jira.secondlife.com/browse/PATHBUG-184 PATHBUG-184]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Allow the Linkset floater to shrink smaller than actually
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-814 PATH-814]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 laptop displays black environment</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 with AMD Radeon HD5650M Mobile graphics</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (262596)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-826 PATH-826]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Random crash while wearing a mesh avatar and dropping objects in-world</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (262596)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1413 MAINT-1413] [https://jira.secondlife.com/browse/VWR-29491 VWR-29491]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>"Weights Of Selected" never gives any results after pathfinding tools were merged in.</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1414 MAINT-1414] [https://jira.secondlife.com/browse/VWR-29497 VWR-29497]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>User is not able to specify color of object with unchecked 'Apply now' chechbox</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1425 MAINT-1425]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>viewer spams the log with "LLViewerParcelMgr::requestParcelMediaURLFilter: can't get ParcelMediaURLFilterList cap" while editing an object</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1426 MAINT-1426]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Texture repeats/meter reset before you can click Apply button</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-643 PATH-643] [https://jira.secondlife.com/browse/PATHBUG-174 PATHBUG-174]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Changes in Preferences dialog stops work of Pathfinding View/Test functionality</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-842 PATH-842] [https://jira.secondlife.com/browse/VWR-29431 VWR-29431] [https://jira.secondlife.com/browse/MAINT-1362 MAINT-1362]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>TargetOmega object's rotation resets if it changes color in 3.4.0 (262596) Beta</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-849 PATH-849]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Crash in the beta viewer relating to pathfinding</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-852 PATH-852]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Custom cursors fail on mac and linux</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-854 PATH-854]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Add support in the viewer to display the Scripted column on the linksets floater</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-856 PATH-856]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>As a user, I want to see a notification when I am toggling the phantom flag on a linkset through the Pathfinding Linkset floater</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|}

Pathfinding Tools in the Second Life Viewer

2012-08-23T00:14:31Z

Stinson Linden: /* Known Issues */

{{Pathfinding Nav}}
__TOC__
{{KBnote|The Viewer tools described here are available only in the '''Second Life Viewer Beta''' build. Look under the "Other Viewers" section on the [http://secondlife.com/support/downloads/ Second Life Viewer download page]}}
== Introduction ==
For pathfinding, each region has a navigation mesh, commonly referred to as a "'''navmesh'''". The '''navmesh''' is a representation of the region's geometry generated and used by the physics simulator to determine paths for the pathfinding characters. The navmesh may be in one of the following three states:

* Up-to-date
* Has pending changes
* Building ''(a.k.a. rebaking)''

The navmesh will transition through these states according to the following diagram:

[[File:Navmesh_transitions.png|alt=Second Life Pathfinding NavMesh Transitions|Second Life Pathfinding NavMesh Transitions]]

Six new elements have been added to the SL Viewer interface to communicate the navmesh state for the current region. These new elements are:

* icon representations of the pathfinding region state for the SLURL bar
* a "Rebake region" button that appears above the lower toolbar
* a right-click context menu option addition
* an additional field on the Build floater
* an additional field on the Object Profile floater
* additional simulator metrics on the Statistics floater

In addition to these new elements, three new floaters allow users to more efficiently create, visualize, test, and debug pathfinding-enabled characters. These tools are not required to create pathfinding behaviors but are particularly useful to builders and experienced creators in Second Life. These new floaters are:

* Pathfinding linksets
* Pathfinding characters
* Pathfinding view / test

== Pathfinding UI Elements ==

'''Note that other residents editing pathfinding objects on the same region may create pending changes to the navmesh.''' When this occurs, all residents on the same region and with build rights will see the appropriate SLURL bar icons and rebake region button.

=== Pathfinding Icons in SLURL Bar ===

The SLURL bar indicates the three pathfinding states of the current region.
# '''Navmesh is up-to-date''' The current region's navmesh is up-to-date. No icon is shown as this is the expected default state. [[File:Pathfinding-clean-region-1.png|alt=Second Life URL Bar with Up-to-Date NavMesh Icon|Second Life URL Bar with Up-to-Date NavMesh Icon]]
# '''Navmesh has pending changes''' The region has pending changes that have not yet been baked into the navmesh. A pathfinding icon with a construction symbol is shown. [[File:Pathfinding-dirty-region-1.png|alt=Second Life URL Bar with Pending Changes Icon|Second Life URL Bar with Pending Changes Icon]]
# '''Dynamic pathfinding is disabled''' The region has dynamic pathfinding disabled. Pathfinding characters will not work as expected. A pathfinding icon with a disabled symbol is shown. [[File:Pathfinding-disabled-region-1.png|alt=Second Life URL Bar with Pathfinding Disabled Icon|Second Life URL Bar with Pathfinding Disabled Icon]]

=== Rebake Region Button ===

When a region has pending changes, the appropriate icon will be shown in the SLURL bar, as described above. In addition, if the user has build rights for any parcel on the current region, the user will also be able to see a "Rebake region" button that displays above the lower toolbar.

[[File:Rebake-button-1.png|alt=Second Life Rebake Region button that allows permitted users to rebake pathfinding changes into the navmesh]]

When the user clicks this button, a request is sent to the region to rebake the navmesh for the current region. As rebaking a region may be a time intensive process, the button will change to indicate "Region is rebaking" during this server process. After the rebaking is complete, this button on the viewer will vanish.

[[File:Rebaking-button-1.png|alt=Second Life Region is Rebaking button that indicates that the current region is rebaking its navmesh]]

=== Right-click context menu behavior ===

When right-clicking on an object in-world, pathfinding-specific menu options may be included in the pop-up context menu.

If the user right-clicks on a '''linkset''' object in-world, a menu option "Show in linksets" will allow the user to open the Pathfinding Linksets floater with the current object selected.

[[File:Right-click-show-in-linksets-1.png|alt=Second Life Context Menu with Show in Linksets floater menu option]]

If the user right-clicks on a pathfinding '''character''' object in-world, a menu option "Show in characters" will allow the user to open the Pathfinding Characters floater with the current object selected.

[[File:Right-click-show-in-characters-1.png|alt=Second Life Context Menu with Show in Characters floater menu option]]

=== Additional field on the Build floater ===

The Build floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Build floater with a ''character'' object selected.

[[File:Build-floater-character-1.png|alt=Build floater with pathfinding attribute character|Build floater with pathfinding attribute character]]

The following image is a screenshot of the Build floater with an object that ''affects navmesh'' selected. This object could be a ''walkable'', ''static obstacle'', ''material volume'', or ''exclusion volume''.

[[File:Build-floater-affects-navmesh-1.png|alt=Build floater with pathfinding attribute affects navmesh|Build floater with pathfinding attribute affects navmesh]]

{{KBwarning|For linksets that do affect the navmesh, it will be impossible to modify the object across the region boundary. The user and the object affecting a navmesh must be in the same region to enable modification of the object. This will be indicated on the General tab of the Build floater as illustrated in the following screenshot.}}
[[File:Build-floater-region-boundary-1.png|alt=Build floater indicating that the user cannot modify object across a region boundary|Build floater indicating that the user cannot modify object across a region boundary]]

=== Additional field on the Object Profile floater ===

Similar to the afore-described Build floater, the Object Profile floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Object Profile floater with an ''affects navmesh'' object selected.

[[File:Object-profile-1.png|alt=Object Profile floater with pathfinding attribute affects navmesh|Object Profile floater with pathfinding attribute affects navmesh]]

=== Additional simulator metrics on the Statistics floater ===

For advanced users, additional simulator metrics have been added to the Statistics floater. The Statistics floater, available from the main menu Advanced > Performance Tools > Statistics Bar, has the following 3 additional fields reporting statistics from the simulator regarding pathfinding activity:

* '''AI Step Time''' - The average time spent during each frame computing character AI events.
* '''Skipped Silhouette Steps''' - The number of steps that are skipped per second in computing the influence of objects of type ''Movable Obstacles'' on the navmesh. A high value here means that objects on the region are marked as ''Movable Obstacles'' and could be contributing to improper pathfinding behavior on the region. To lower this value, set all objects that do not move to either type ''Walkable'' or ''Static Obstacle'', and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]].
* '''Characters Updated''' - The average percentage of characters updated during each frame. A low value here means that character AI computations are taking too long during each frame, and thus some character updates are skipped during subsequent frames. This could be contributing to improper pathfinding behavior on the region. To increase this value, decrease the number of characters on the region, and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]]. Note that the Pathfinding Characters floater (described below) may also be used to determine which characters on the region are contributing the most to the region's CPU time.

[[File:Pathfinding-stats-2.png|alt=Simulator Statistics floater with additional pathfinding statistics|Simulator Statistics floater with additional pathfinding statistics]]

== Pathfinding Floaters ==

These three pathfinding floaters may all be accessed through the Build->Pathfinding menu in the Project Viewer - Pathfinding.

[[File:Build-menu-pf-selected-1.png|alt=Second Life Build Menu with new Pathfinding menu items|SL Build -> Pathfinding Menu]]

 

=== Pathfinding Linksets Floater ===

==== Overview ====

The intent of the Pathfinding Linksets floater is to give advanced users and builders the ability to customize an area to achieve interesting effects with pathfinding-enabled characters.

The floater displays information for all linksets within the current region for which the user has the ability to alter. The table reports useful information including
* Linkset Name
* Description
* Owner
* Land Impact
* Distance from the resident's avatar
* Linkset Use
** Potential values
*** Walkable
*** Static Obstacle
*** Movable Obstacle
*** Material Volume
*** Exclusion Volume
*** Movable Phantom
* Walkability Coefficients
** Character Type A ''(example use: humanoid)''
** Character Type B ''(example use: creature)''
** Character Type C ''(example use: mechanical)''
** Character Type D ''(example use: other)''

Additionally, selecting any linksets within the floater will also select the object(s) within the Viewer.

[[File:Linksets-floater-2.png|alt=Pathfinding Linksets floater|Pathfinding Linksets]]

 

==== Controls ====

{{:Viewerhelp:Pathfinding linksets}}

==== Example use ====

The advanced users and builders will use the Pathfinding Linksets floater to customize areas to create interesting effects for pathfinding-enabled characters.

For instance, imagine the scenario of a builder constructing a single room in a pathfinding-enabled house. For the single room, the builder would use the following types as follows:

{|border="1"
! Linkset Use !! Description
|-
|width="200" align="center" | Walkable || align="left" | The floor linkset would be set to be Walkable to allow characters to move across the floor.
|-
|width="200" align="center" | Static Obstacle || align="left" | A desk linkset in the room would be set to be Static Obstacle to block characters from walking through or across the object.

NOTE Any object that should block character movement and that does not move should be marked as Static Obstacle to improve performance of pathfinding characters.
|-
|width="200" align="center" | Movable Obstacle || align="left" | A door linkset in the room would be set to be Movable Obstacle. This will still block characters but, in contrast to Static Obstacles, Movable Obstacles will allow the linkset itself to move. In the case of the door, this will allow the door to open and close, but will still prevent characters from walking through the door.
|-
|width="200" align="center" | Material Volume || align="left" | Material Volumes are phantom objects that can be used to affect the walkability coefficients of intersecting objects. Imagine that the builder applied a texture to the floor. Also, imagine that the floor texture includes small throw rug in the middle of the room. (The builder did not want to create a separate object for the rug, so is using a texture on the floor to give the appearance of a rug). The builder can then create a Material Volume object intersecting the floor at the location of the rug. Then, by setting a lower walkability coefficient for the Material Volume, the builder will create the affect of slowing down characters as the characters traverse across the painted rug area.
|-
|width="200" align="center" | Exclusion Volume || align="left" | Exclusion Volumes are phantom objects that can be used to create areas where characters are prevented from moving. For instance, the builder can use an Exclusion Volume to create a section of the room where avatars would be able to move, but characters would be blocked from following.
|-
|width="200" align="center" | Movable Phantom || align="left" | Movable Phantoms are phantom objects that have no affect on pathfinding-enabled characters.
|}
 
In addition to linkset use attributes, builders can achieve additional effects by modifying the walkability coefficients for linksets. The walkability coefficients are values, ranging from 0% to 100%, that affect a characters speed. A walkability coefficient of 50% will reduce a character's speed by half while the character is traversing across the linkset.
 

=== Pathfinding Characters Floater ===

==== Overview ====
The intent of Pathfinding Characters floater is primarily for users to locate characters moving throughout a region and to identify the CPU cost of characters affecting the performance of a region.

The floater displays information for all characters within the current region for which the user has the ability to manipulate. The table reports useful information including
* Character Name
* Description
* Owner
* CPU Time
* Altitude

[[File:Characters-floater-1.png|alt=Pathfinding Characters floater|Pathfinding Characters]]
 
==== Controls ====

{{:Viewerhelp:Pathfinding characters}}

==== Example use ====
# If a region owner has created a pathfinding-enabled character but is unable to find the character within the region, the Characters floater can be used to locate and select the character.
# Additionally, the Pathfinding Characters floater reports the CPU time cost for each character within the region. This functionality can be used by advanced users to identify which characters are impacting performance the most.

=== Pathfinding View/Test Floater ===

==== Overview ====

The intent of the Pathfinding View/Test floater is for advanced users who are building pathfinding-enabled objects and characters.

This floater consists of 3 basic areas.

# Status area (illustrating both the Viewer and Simulator status of the region's navmesh)
# View tab Controls
# Test Path tab Controls

The following image is a screenshot of the Pathfinding View/Test floater with the navmesh displayed.

[[File:View-nav-mesh-1.png|alt=Pathfinding View/Test floater with the navmesh displayed|Pathfinding View/Test with navmesh displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with the pathfinding object types displayed.

[[File:View-pf-types-1.png|alt=Pathfinding View/Test floater with the pathfinding object types displayed|Pathfinding View/Test with the pathfinding object types displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with a test path displayed.

[[File:View-test-path-1.png|alt=Pathfinding View/Test floater with a test path displayed|Pathfinding View/Test with a test path displayed]]

 
==== Controls ====

{{:Viewerhelp:Pathfinding edit and test}}

==== Example Use ====

# The advanced user will use the Visualization controls to visualize how the navmesh and related permanent objects have been generated. By seeing this visualization of how the physics engine interprets the navigation information, the advanced user can understand how to better customize the pathfinding-enabled objects to obtain the desired behaviors of characters.
# The advanced user will use the Test Tab to visualize how a test character would choose the path between selected start and end points.

 

== Known Issues ==

{| style="border-style:solid;border-width:2px 0 2px 0px;"
! style="border-style:solid;border-width:0 0 1px 0" width="130" | JIRA
! style="border-style:solid;border-width:0 0 1px 0" width="300" | Summary
! style="border-style:solid;border-width:0 0 1px 0" width="550" | Hardware
! style="border-style:solid;border-width:0 0 1px 0" width="100" | Fixed in Version
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1291 MAINT-1291]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Enable Debug GL crashes the viewer to the desktop
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac Pro running 10.7.4 with AMD Radeon HD5770 iMac running Mac OS X Lion 10.7.4 (11E53) with AMD Radeon HD 6770M (512 MB) PC Clone running XP Pro with GeForce2 Ultra
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-572 PATH-572]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Underwater 'Walkables' shapes are reflected about the water plane
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-659 PATH-659]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | navmesh being drawn over worn flexi prims and under avatar
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-790 PATH-790]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Physics capsule rendering of character shapes is broken after zooming
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-812 PATH-812]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Show capsules option creates black capsule instead of blue
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | ATI Radeon X300 Video card ATI Radeon X600 Video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-821 PATH-821]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop displays black environment
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop with AMD Radeon HD 4200 Mobile graphics
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-822 PATH-822]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Configuration with ATI Radeon 7500 can launch Viewer, serious GFx issues
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | AMD Athlon64 3000+ with ATI Radeon 7500 video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-851 PATH-851]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Crash in the beta viewer relating to LLLoginInstance
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-857 PATH-857] [https://jira.secondlife.com/browse/VWR-29500 VWR-29500]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Shadows not operational under Second Life Beta 3.4.0.262596
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac OS X 10.7.4 with ATI Radeon X1600 OpenGL Engine video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-864 PATH-864] [https://jira.secondlife.com/browse/PATHBUG-184 PATHBUG-184]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Allow the Linkset floater to shrink smaller than actually
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-814 PATH-814]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 laptop displays black environment</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 with AMD Radeon HD5650M Mobile graphics</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (262596)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-826 PATH-826]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Random crash while wearing a mesh avatar and dropping objects in-world</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (262596)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1413 MAINT-1413] [https://jira.secondlife.com/browse/VWR-29491 VWR-29491]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>"Weights Of Selected" never gives any results after pathfinding tools were merged in.</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1414 MAINT-1414] [https://jira.secondlife.com/browse/VWR-29497 VWR-29497]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>User is not able to specify color of object with unchecked 'Apply now' chechbox</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1425 MAINT-1425]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>viewer spams the log with "LLViewerParcelMgr::requestParcelMediaURLFilter: can't get ParcelMediaURLFilterList cap" while editing an object</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1426 MAINT-1426]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Texture repeats/meter reset before you can click Apply button</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-643 PATH-643] [https://jira.secondlife.com/browse/PATHBUG-174 PATHBUG-174]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Changes in Preferences dialog stops work of Pathfinding View/Test functionality</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-842 PATH-842] [https://jira.secondlife.com/browse/VWR-29431 VWR-29431] [https://jira.secondlife.com/browse/MAINT-1362 MAINT-1362]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>TargetOmega object's rotation resets if it changes color in 3.4.0 (262596) Beta</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-849 PATH-849]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Crash in the beta viewer relating to pathfinding</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-852 PATH-852]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Custom cursors fail on mac and linux</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-854 PATH-854]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Add support in the viewer to display the Scripted column on the linksets floater</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-856 PATH-856]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>As a user, I want to see a notification when I am toggling the phantom flag on a linkset through the Pathfinding Linkset floater</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|}

Pathfinding Tools in the Second Life Viewer

2012-08-23T00:10:02Z

Stinson Linden: /* Known Issues */

{{Pathfinding Nav}}
__TOC__
{{KBnote|The Viewer tools described here are available only in the '''Second Life Viewer Beta''' build. Look under the "Other Viewers" section on the [http://secondlife.com/support/downloads/ Second Life Viewer download page]}}
== Introduction ==
For pathfinding, each region has a navigation mesh, commonly referred to as a "'''navmesh'''". The '''navmesh''' is a representation of the region's geometry generated and used by the physics simulator to determine paths for the pathfinding characters. The navmesh may be in one of the following three states:

* Up-to-date
* Has pending changes
* Building ''(a.k.a. rebaking)''

The navmesh will transition through these states according to the following diagram:

[[File:Navmesh_transitions.png|alt=Second Life Pathfinding NavMesh Transitions|Second Life Pathfinding NavMesh Transitions]]

Six new elements have been added to the SL Viewer interface to communicate the navmesh state for the current region. These new elements are:

* icon representations of the pathfinding region state for the SLURL bar
* a "Rebake region" button that appears above the lower toolbar
* a right-click context menu option addition
* an additional field on the Build floater
* an additional field on the Object Profile floater
* additional simulator metrics on the Statistics floater

In addition to these new elements, three new floaters allow users to more efficiently create, visualize, test, and debug pathfinding-enabled characters. These tools are not required to create pathfinding behaviors but are particularly useful to builders and experienced creators in Second Life. These new floaters are:

* Pathfinding linksets
* Pathfinding characters
* Pathfinding view / test

== Pathfinding UI Elements ==

'''Note that other residents editing pathfinding objects on the same region may create pending changes to the navmesh.''' When this occurs, all residents on the same region and with build rights will see the appropriate SLURL bar icons and rebake region button.

=== Pathfinding Icons in SLURL Bar ===

The SLURL bar indicates the three pathfinding states of the current region.
# '''Navmesh is up-to-date''' The current region's navmesh is up-to-date. No icon is shown as this is the expected default state. [[File:Pathfinding-clean-region-1.png|alt=Second Life URL Bar with Up-to-Date NavMesh Icon|Second Life URL Bar with Up-to-Date NavMesh Icon]]
# '''Navmesh has pending changes''' The region has pending changes that have not yet been baked into the navmesh. A pathfinding icon with a construction symbol is shown. [[File:Pathfinding-dirty-region-1.png|alt=Second Life URL Bar with Pending Changes Icon|Second Life URL Bar with Pending Changes Icon]]
# '''Dynamic pathfinding is disabled''' The region has dynamic pathfinding disabled. Pathfinding characters will not work as expected. A pathfinding icon with a disabled symbol is shown. [[File:Pathfinding-disabled-region-1.png|alt=Second Life URL Bar with Pathfinding Disabled Icon|Second Life URL Bar with Pathfinding Disabled Icon]]

=== Rebake Region Button ===

When a region has pending changes, the appropriate icon will be shown in the SLURL bar, as described above. In addition, if the user has build rights for any parcel on the current region, the user will also be able to see a "Rebake region" button that displays above the lower toolbar.

[[File:Rebake-button-1.png|alt=Second Life Rebake Region button that allows permitted users to rebake pathfinding changes into the navmesh]]

When the user clicks this button, a request is sent to the region to rebake the navmesh for the current region. As rebaking a region may be a time intensive process, the button will change to indicate "Region is rebaking" during this server process. After the rebaking is complete, this button on the viewer will vanish.

[[File:Rebaking-button-1.png|alt=Second Life Region is Rebaking button that indicates that the current region is rebaking its navmesh]]

=== Right-click context menu behavior ===

When right-clicking on an object in-world, pathfinding-specific menu options may be included in the pop-up context menu.

If the user right-clicks on a '''linkset''' object in-world, a menu option "Show in linksets" will allow the user to open the Pathfinding Linksets floater with the current object selected.

[[File:Right-click-show-in-linksets-1.png|alt=Second Life Context Menu with Show in Linksets floater menu option]]

If the user right-clicks on a pathfinding '''character''' object in-world, a menu option "Show in characters" will allow the user to open the Pathfinding Characters floater with the current object selected.

[[File:Right-click-show-in-characters-1.png|alt=Second Life Context Menu with Show in Characters floater menu option]]

=== Additional field on the Build floater ===

The Build floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Build floater with a ''character'' object selected.

[[File:Build-floater-character-1.png|alt=Build floater with pathfinding attribute character|Build floater with pathfinding attribute character]]

The following image is a screenshot of the Build floater with an object that ''affects navmesh'' selected. This object could be a ''walkable'', ''static obstacle'', ''material volume'', or ''exclusion volume''.

[[File:Build-floater-affects-navmesh-1.png|alt=Build floater with pathfinding attribute affects navmesh|Build floater with pathfinding attribute affects navmesh]]

{{KBwarning|For linksets that do affect the navmesh, it will be impossible to modify the object across the region boundary. The user and the object affecting a navmesh must be in the same region to enable modification of the object. This will be indicated on the General tab of the Build floater as illustrated in the following screenshot.}}
[[File:Build-floater-region-boundary-1.png|alt=Build floater indicating that the user cannot modify object across a region boundary|Build floater indicating that the user cannot modify object across a region boundary]]

=== Additional field on the Object Profile floater ===

Similar to the afore-described Build floater, the Object Profile floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Object Profile floater with an ''affects navmesh'' object selected.

[[File:Object-profile-1.png|alt=Object Profile floater with pathfinding attribute affects navmesh|Object Profile floater with pathfinding attribute affects navmesh]]

=== Additional simulator metrics on the Statistics floater ===

For advanced users, additional simulator metrics have been added to the Statistics floater. The Statistics floater, available from the main menu Advanced > Performance Tools > Statistics Bar, has the following 3 additional fields reporting statistics from the simulator regarding pathfinding activity:

* '''AI Step Time''' - The average time spent during each frame computing character AI events.
* '''Skipped Silhouette Steps''' - The number of steps that are skipped per second in computing the influence of objects of type ''Movable Obstacles'' on the navmesh. A high value here means that objects on the region are marked as ''Movable Obstacles'' and could be contributing to improper pathfinding behavior on the region. To lower this value, set all objects that do not move to either type ''Walkable'' or ''Static Obstacle'', and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]].
* '''Characters Updated''' - The average percentage of characters updated during each frame. A low value here means that character AI computations are taking too long during each frame, and thus some character updates are skipped during subsequent frames. This could be contributing to improper pathfinding behavior on the region. To increase this value, decrease the number of characters on the region, and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]]. Note that the Pathfinding Characters floater (described below) may also be used to determine which characters on the region are contributing the most to the region's CPU time.

[[File:Pathfinding-stats-2.png|alt=Simulator Statistics floater with additional pathfinding statistics|Simulator Statistics floater with additional pathfinding statistics]]

== Pathfinding Floaters ==

These three pathfinding floaters may all be accessed through the Build->Pathfinding menu in the Project Viewer - Pathfinding.

[[File:Build-menu-pf-selected-1.png|alt=Second Life Build Menu with new Pathfinding menu items|SL Build -> Pathfinding Menu]]

 

=== Pathfinding Linksets Floater ===

==== Overview ====

The intent of the Pathfinding Linksets floater is to give advanced users and builders the ability to customize an area to achieve interesting effects with pathfinding-enabled characters.

The floater displays information for all linksets within the current region for which the user has the ability to alter. The table reports useful information including
* Linkset Name
* Description
* Owner
* Land Impact
* Distance from the resident's avatar
* Linkset Use
** Potential values
*** Walkable
*** Static Obstacle
*** Movable Obstacle
*** Material Volume
*** Exclusion Volume
*** Movable Phantom
* Walkability Coefficients
** Character Type A ''(example use: humanoid)''
** Character Type B ''(example use: creature)''
** Character Type C ''(example use: mechanical)''
** Character Type D ''(example use: other)''

Additionally, selecting any linksets within the floater will also select the object(s) within the Viewer.

[[File:Linksets-floater-2.png|alt=Pathfinding Linksets floater|Pathfinding Linksets]]

 

==== Controls ====

{{:Viewerhelp:Pathfinding linksets}}

==== Example use ====

The advanced users and builders will use the Pathfinding Linksets floater to customize areas to create interesting effects for pathfinding-enabled characters.

For instance, imagine the scenario of a builder constructing a single room in a pathfinding-enabled house. For the single room, the builder would use the following types as follows:

{|border="1"
! Linkset Use !! Description
|-
|width="200" align="center" | Walkable || align="left" | The floor linkset would be set to be Walkable to allow characters to move across the floor.
|-
|width="200" align="center" | Static Obstacle || align="left" | A desk linkset in the room would be set to be Static Obstacle to block characters from walking through or across the object.

NOTE Any object that should block character movement and that does not move should be marked as Static Obstacle to improve performance of pathfinding characters.
|-
|width="200" align="center" | Movable Obstacle || align="left" | A door linkset in the room would be set to be Movable Obstacle. This will still block characters but, in contrast to Static Obstacles, Movable Obstacles will allow the linkset itself to move. In the case of the door, this will allow the door to open and close, but will still prevent characters from walking through the door.
|-
|width="200" align="center" | Material Volume || align="left" | Material Volumes are phantom objects that can be used to affect the walkability coefficients of intersecting objects. Imagine that the builder applied a texture to the floor. Also, imagine that the floor texture includes small throw rug in the middle of the room. (The builder did not want to create a separate object for the rug, so is using a texture on the floor to give the appearance of a rug). The builder can then create a Material Volume object intersecting the floor at the location of the rug. Then, by setting a lower walkability coefficient for the Material Volume, the builder will create the affect of slowing down characters as the characters traverse across the painted rug area.
|-
|width="200" align="center" | Exclusion Volume || align="left" | Exclusion Volumes are phantom objects that can be used to create areas where characters are prevented from moving. For instance, the builder can use an Exclusion Volume to create a section of the room where avatars would be able to move, but characters would be blocked from following.
|-
|width="200" align="center" | Movable Phantom || align="left" | Movable Phantoms are phantom objects that have no affect on pathfinding-enabled characters.
|}
 
In addition to linkset use attributes, builders can achieve additional effects by modifying the walkability coefficients for linksets. The walkability coefficients are values, ranging from 0% to 100%, that affect a characters speed. A walkability coefficient of 50% will reduce a character's speed by half while the character is traversing across the linkset.
 

=== Pathfinding Characters Floater ===

==== Overview ====
The intent of Pathfinding Characters floater is primarily for users to locate characters moving throughout a region and to identify the CPU cost of characters affecting the performance of a region.

The floater displays information for all characters within the current region for which the user has the ability to manipulate. The table reports useful information including
* Character Name
* Description
* Owner
* CPU Time
* Altitude

[[File:Characters-floater-1.png|alt=Pathfinding Characters floater|Pathfinding Characters]]
 
==== Controls ====

{{:Viewerhelp:Pathfinding characters}}

==== Example use ====
# If a region owner has created a pathfinding-enabled character but is unable to find the character within the region, the Characters floater can be used to locate and select the character.
# Additionally, the Pathfinding Characters floater reports the CPU time cost for each character within the region. This functionality can be used by advanced users to identify which characters are impacting performance the most.

=== Pathfinding View/Test Floater ===

==== Overview ====

The intent of the Pathfinding View/Test floater is for advanced users who are building pathfinding-enabled objects and characters.

This floater consists of 3 basic areas.

# Status area (illustrating both the Viewer and Simulator status of the region's navmesh)
# View tab Controls
# Test Path tab Controls

The following image is a screenshot of the Pathfinding View/Test floater with the navmesh displayed.

[[File:View-nav-mesh-1.png|alt=Pathfinding View/Test floater with the navmesh displayed|Pathfinding View/Test with navmesh displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with the pathfinding object types displayed.

[[File:View-pf-types-1.png|alt=Pathfinding View/Test floater with the pathfinding object types displayed|Pathfinding View/Test with the pathfinding object types displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with a test path displayed.

[[File:View-test-path-1.png|alt=Pathfinding View/Test floater with a test path displayed|Pathfinding View/Test with a test path displayed]]

 
==== Controls ====

{{:Viewerhelp:Pathfinding edit and test}}

==== Example Use ====

# The advanced user will use the Visualization controls to visualize how the navmesh and related permanent objects have been generated. By seeing this visualization of how the physics engine interprets the navigation information, the advanced user can understand how to better customize the pathfinding-enabled objects to obtain the desired behaviors of characters.
# The advanced user will use the Test Tab to visualize how a test character would choose the path between selected start and end points.

 

== Known Issues ==

{| style="border-style:solid;border-width:2px 0 2px 0px;"
! style="border-style:solid;border-width:0 0 1px 0" width="130" | JIRA
! style="border-style:solid;border-width:0 0 1px 0" width="300" | Summary
! style="border-style:solid;border-width:0 0 1px 0" width="550" | Hardware
! style="border-style:solid;border-width:0 0 1px 0" width="100" | Fixed in Version
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1291 MAINT-1291]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Enable Debug GL crashes the viewer to the desktop
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac Pro running 10.7.4 with AMD Radeon HD5770 iMac running Mac OS X Lion 10.7.4 (11E53) with AMD Radeon HD 6770M (512 MB) PC Clone running XP Pro with GeForce2 Ultra
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-572 PATH-572]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Underwater 'Walkables' shapes are reflected about the water plane
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-659 PATH-659]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | navmesh being drawn over worn flexi prims and under avatar
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-790 PATH-790]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Physics capsule rendering of character shapes is broken after zooming
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-812 PATH-812]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Show capsules option creates black capsule instead of blue
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | ATI Radeon X300 Video card ATI Radeon X600 Video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-821 PATH-821]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop displays black environment
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop with AMD Radeon HD 4200 Mobile graphics
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-822 PATH-822]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Configuration with ATI Radeon 7500 can launch Viewer, serious GFx issues
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | AMD Athlon64 3000+ with ATI Radeon 7500 video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-851 PATH-851]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Crash in the beta viewer relating to LLLoginInstance
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-864 PATH-864] [https://jira.secondlife.com/browse/PATHBUG-184 PATHBUG-184]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Allow the Linkset floater to shrink smaller than actually
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-814 PATH-814]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 laptop displays black environment</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 with AMD Radeon HD5650M Mobile graphics</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (262596)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-826 PATH-826]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Random crash while wearing a mesh avatar and dropping objects in-world</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (262596)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1413 MAINT-1413] [https://jira.secondlife.com/browse/VWR-29491 VWR-29491]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>"Weights Of Selected" never gives any results after pathfinding tools were merged in.</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1414 MAINT-1414] [https://jira.secondlife.com/browse/VWR-29497 VWR-29497]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>User is not able to specify color of object with unchecked 'Apply now' chechbox</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1425 MAINT-1425]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>viewer spams the log with "LLViewerParcelMgr::requestParcelMediaURLFilter: can't get ParcelMediaURLFilterList cap" while editing an object</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1426 MAINT-1426]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Texture repeats/meter reset before you can click Apply button</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-643 PATH-643] [https://jira.secondlife.com/browse/PATHBUG-174 PATHBUG-174]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Changes in Preferences dialog stops work of Pathfinding View/Test functionality</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-842 PATH-842] [https://jira.secondlife.com/browse/VWR-29431 VWR-29431] [https://jira.secondlife.com/browse/MAINT-1362 MAINT-1362]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>TargetOmega object's rotation resets if it changes color in 3.4.0 (262596) Beta</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-849 PATH-849]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Crash in the beta viewer relating to pathfinding</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-852 PATH-852]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Custom cursors fail on mac and linux</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-854 PATH-854]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Add support in the viewer to display the Scripted column on the linksets floater</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-856 PATH-856]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>As a user, I want to see a notification when I am toggling the phantom flag on a linkset through the Pathfinding Linkset floater</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|}

Pathfinding Tools in the Second Life Viewer

2012-08-22T23:01:52Z

Stinson Linden: /* Known Issues */

{{Pathfinding Nav}}
__TOC__
{{KBnote|The Viewer tools described here are available only in the '''Second Life Viewer Beta''' build. Look under the "Other Viewers" section on the [http://secondlife.com/support/downloads/ Second Life Viewer download page]}}
== Introduction ==
For pathfinding, each region has a navigation mesh, commonly referred to as a "'''navmesh'''". The '''navmesh''' is a representation of the region's geometry generated and used by the physics simulator to determine paths for the pathfinding characters. The navmesh may be in one of the following three states:

* Up-to-date
* Has pending changes
* Building ''(a.k.a. rebaking)''

The navmesh will transition through these states according to the following diagram:

[[File:Navmesh_transitions.png|alt=Second Life Pathfinding NavMesh Transitions|Second Life Pathfinding NavMesh Transitions]]

Six new elements have been added to the SL Viewer interface to communicate the navmesh state for the current region. These new elements are:

* icon representations of the pathfinding region state for the SLURL bar
* a "Rebake region" button that appears above the lower toolbar
* a right-click context menu option addition
* an additional field on the Build floater
* an additional field on the Object Profile floater
* additional simulator metrics on the Statistics floater

In addition to these new elements, three new floaters allow users to more efficiently create, visualize, test, and debug pathfinding-enabled characters. These tools are not required to create pathfinding behaviors but are particularly useful to builders and experienced creators in Second Life. These new floaters are:

* Pathfinding linksets
* Pathfinding characters
* Pathfinding view / test

== Pathfinding UI Elements ==

'''Note that other residents editing pathfinding objects on the same region may create pending changes to the navmesh.''' When this occurs, all residents on the same region and with build rights will see the appropriate SLURL bar icons and rebake region button.

=== Pathfinding Icons in SLURL Bar ===

The SLURL bar indicates the three pathfinding states of the current region.
# '''Navmesh is up-to-date''' The current region's navmesh is up-to-date. No icon is shown as this is the expected default state. [[File:Pathfinding-clean-region-1.png|alt=Second Life URL Bar with Up-to-Date NavMesh Icon|Second Life URL Bar with Up-to-Date NavMesh Icon]]
# '''Navmesh has pending changes''' The region has pending changes that have not yet been baked into the navmesh. A pathfinding icon with a construction symbol is shown. [[File:Pathfinding-dirty-region-1.png|alt=Second Life URL Bar with Pending Changes Icon|Second Life URL Bar with Pending Changes Icon]]
# '''Dynamic pathfinding is disabled''' The region has dynamic pathfinding disabled. Pathfinding characters will not work as expected. A pathfinding icon with a disabled symbol is shown. [[File:Pathfinding-disabled-region-1.png|alt=Second Life URL Bar with Pathfinding Disabled Icon|Second Life URL Bar with Pathfinding Disabled Icon]]

=== Rebake Region Button ===

When a region has pending changes, the appropriate icon will be shown in the SLURL bar, as described above. In addition, if the user has build rights for any parcel on the current region, the user will also be able to see a "Rebake region" button that displays above the lower toolbar.

[[File:Rebake-button-1.png|alt=Second Life Rebake Region button that allows permitted users to rebake pathfinding changes into the navmesh]]

When the user clicks this button, a request is sent to the region to rebake the navmesh for the current region. As rebaking a region may be a time intensive process, the button will change to indicate "Region is rebaking" during this server process. After the rebaking is complete, this button on the viewer will vanish.

[[File:Rebaking-button-1.png|alt=Second Life Region is Rebaking button that indicates that the current region is rebaking its navmesh]]

=== Right-click context menu behavior ===

When right-clicking on an object in-world, pathfinding-specific menu options may be included in the pop-up context menu.

If the user right-clicks on a '''linkset''' object in-world, a menu option "Show in linksets" will allow the user to open the Pathfinding Linksets floater with the current object selected.

[[File:Right-click-show-in-linksets-1.png|alt=Second Life Context Menu with Show in Linksets floater menu option]]

If the user right-clicks on a pathfinding '''character''' object in-world, a menu option "Show in characters" will allow the user to open the Pathfinding Characters floater with the current object selected.

[[File:Right-click-show-in-characters-1.png|alt=Second Life Context Menu with Show in Characters floater menu option]]

=== Additional field on the Build floater ===

The Build floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Build floater with a ''character'' object selected.

[[File:Build-floater-character-1.png|alt=Build floater with pathfinding attribute character|Build floater with pathfinding attribute character]]

The following image is a screenshot of the Build floater with an object that ''affects navmesh'' selected. This object could be a ''walkable'', ''static obstacle'', ''material volume'', or ''exclusion volume''.

[[File:Build-floater-affects-navmesh-1.png|alt=Build floater with pathfinding attribute affects navmesh|Build floater with pathfinding attribute affects navmesh]]

{{KBwarning|For linksets that do affect the navmesh, it will be impossible to modify the object across the region boundary. The user and the object affecting a navmesh must be in the same region to enable modification of the object. This will be indicated on the General tab of the Build floater as illustrated in the following screenshot.}}
[[File:Build-floater-region-boundary-1.png|alt=Build floater indicating that the user cannot modify object across a region boundary|Build floater indicating that the user cannot modify object across a region boundary]]

=== Additional field on the Object Profile floater ===

Similar to the afore-described Build floater, the Object Profile floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Object Profile floater with an ''affects navmesh'' object selected.

[[File:Object-profile-1.png|alt=Object Profile floater with pathfinding attribute affects navmesh|Object Profile floater with pathfinding attribute affects navmesh]]

=== Additional simulator metrics on the Statistics floater ===

For advanced users, additional simulator metrics have been added to the Statistics floater. The Statistics floater, available from the main menu Advanced > Performance Tools > Statistics Bar, has the following 3 additional fields reporting statistics from the simulator regarding pathfinding activity:

* '''AI Step Time''' - The average time spent during each frame computing character AI events.
* '''Skipped Silhouette Steps''' - The number of steps that are skipped per second in computing the influence of objects of type ''Movable Obstacles'' on the navmesh. A high value here means that objects on the region are marked as ''Movable Obstacles'' and could be contributing to improper pathfinding behavior on the region. To lower this value, set all objects that do not move to either type ''Walkable'' or ''Static Obstacle'', and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]].
* '''Characters Updated''' - The average percentage of characters updated during each frame. A low value here means that character AI computations are taking too long during each frame, and thus some character updates are skipped during subsequent frames. This could be contributing to improper pathfinding behavior on the region. To increase this value, decrease the number of characters on the region, and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]]. Note that the Pathfinding Characters floater (described below) may also be used to determine which characters on the region are contributing the most to the region's CPU time.

[[File:Pathfinding-stats-2.png|alt=Simulator Statistics floater with additional pathfinding statistics|Simulator Statistics floater with additional pathfinding statistics]]

== Pathfinding Floaters ==

These three pathfinding floaters may all be accessed through the Build->Pathfinding menu in the Project Viewer - Pathfinding.

[[File:Build-menu-pf-selected-1.png|alt=Second Life Build Menu with new Pathfinding menu items|SL Build -> Pathfinding Menu]]

 

=== Pathfinding Linksets Floater ===

==== Overview ====

The intent of the Pathfinding Linksets floater is to give advanced users and builders the ability to customize an area to achieve interesting effects with pathfinding-enabled characters.

The floater displays information for all linksets within the current region for which the user has the ability to alter. The table reports useful information including
* Linkset Name
* Description
* Owner
* Land Impact
* Distance from the resident's avatar
* Linkset Use
** Potential values
*** Walkable
*** Static Obstacle
*** Movable Obstacle
*** Material Volume
*** Exclusion Volume
*** Movable Phantom
* Walkability Coefficients
** Character Type A ''(example use: humanoid)''
** Character Type B ''(example use: creature)''
** Character Type C ''(example use: mechanical)''
** Character Type D ''(example use: other)''

Additionally, selecting any linksets within the floater will also select the object(s) within the Viewer.

[[File:Linksets-floater-2.png|alt=Pathfinding Linksets floater|Pathfinding Linksets]]

 

==== Controls ====

{{:Viewerhelp:Pathfinding linksets}}

==== Example use ====

The advanced users and builders will use the Pathfinding Linksets floater to customize areas to create interesting effects for pathfinding-enabled characters.

For instance, imagine the scenario of a builder constructing a single room in a pathfinding-enabled house. For the single room, the builder would use the following types as follows:

{|border="1"
! Linkset Use !! Description
|-
|width="200" align="center" | Walkable || align="left" | The floor linkset would be set to be Walkable to allow characters to move across the floor.
|-
|width="200" align="center" | Static Obstacle || align="left" | A desk linkset in the room would be set to be Static Obstacle to block characters from walking through or across the object.

NOTE Any object that should block character movement and that does not move should be marked as Static Obstacle to improve performance of pathfinding characters.
|-
|width="200" align="center" | Movable Obstacle || align="left" | A door linkset in the room would be set to be Movable Obstacle. This will still block characters but, in contrast to Static Obstacles, Movable Obstacles will allow the linkset itself to move. In the case of the door, this will allow the door to open and close, but will still prevent characters from walking through the door.
|-
|width="200" align="center" | Material Volume || align="left" | Material Volumes are phantom objects that can be used to affect the walkability coefficients of intersecting objects. Imagine that the builder applied a texture to the floor. Also, imagine that the floor texture includes small throw rug in the middle of the room. (The builder did not want to create a separate object for the rug, so is using a texture on the floor to give the appearance of a rug). The builder can then create a Material Volume object intersecting the floor at the location of the rug. Then, by setting a lower walkability coefficient for the Material Volume, the builder will create the affect of slowing down characters as the characters traverse across the painted rug area.
|-
|width="200" align="center" | Exclusion Volume || align="left" | Exclusion Volumes are phantom objects that can be used to create areas where characters are prevented from moving. For instance, the builder can use an Exclusion Volume to create a section of the room where avatars would be able to move, but characters would be blocked from following.
|-
|width="200" align="center" | Movable Phantom || align="left" | Movable Phantoms are phantom objects that have no affect on pathfinding-enabled characters.
|}
 
In addition to linkset use attributes, builders can achieve additional effects by modifying the walkability coefficients for linksets. The walkability coefficients are values, ranging from 0% to 100%, that affect a characters speed. A walkability coefficient of 50% will reduce a character's speed by half while the character is traversing across the linkset.
 

=== Pathfinding Characters Floater ===

==== Overview ====
The intent of Pathfinding Characters floater is primarily for users to locate characters moving throughout a region and to identify the CPU cost of characters affecting the performance of a region.

The floater displays information for all characters within the current region for which the user has the ability to manipulate. The table reports useful information including
* Character Name
* Description
* Owner
* CPU Time
* Altitude

[[File:Characters-floater-1.png|alt=Pathfinding Characters floater|Pathfinding Characters]]
 
==== Controls ====

{{:Viewerhelp:Pathfinding characters}}

==== Example use ====
# If a region owner has created a pathfinding-enabled character but is unable to find the character within the region, the Characters floater can be used to locate and select the character.
# Additionally, the Pathfinding Characters floater reports the CPU time cost for each character within the region. This functionality can be used by advanced users to identify which characters are impacting performance the most.

=== Pathfinding View/Test Floater ===

==== Overview ====

The intent of the Pathfinding View/Test floater is for advanced users who are building pathfinding-enabled objects and characters.

This floater consists of 3 basic areas.

# Status area (illustrating both the Viewer and Simulator status of the region's navmesh)
# View tab Controls
# Test Path tab Controls

The following image is a screenshot of the Pathfinding View/Test floater with the navmesh displayed.

[[File:View-nav-mesh-1.png|alt=Pathfinding View/Test floater with the navmesh displayed|Pathfinding View/Test with navmesh displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with the pathfinding object types displayed.

[[File:View-pf-types-1.png|alt=Pathfinding View/Test floater with the pathfinding object types displayed|Pathfinding View/Test with the pathfinding object types displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with a test path displayed.

[[File:View-test-path-1.png|alt=Pathfinding View/Test floater with a test path displayed|Pathfinding View/Test with a test path displayed]]

 
==== Controls ====

{{:Viewerhelp:Pathfinding edit and test}}

==== Example Use ====

# The advanced user will use the Visualization controls to visualize how the navmesh and related permanent objects have been generated. By seeing this visualization of how the physics engine interprets the navigation information, the advanced user can understand how to better customize the pathfinding-enabled objects to obtain the desired behaviors of characters.
# The advanced user will use the Test Tab to visualize how a test character would choose the path between selected start and end points.

 

== Known Issues ==

{| style="border-style:solid;border-width:2px 0 2px 0px;"
! style="border-style:solid;border-width:0 0 1px 0" width="130" | JIRA
! style="border-style:solid;border-width:0 0 1px 0" width="300" | Summary
! style="border-style:solid;border-width:0 0 1px 0" width="550" | Hardware
! style="border-style:solid;border-width:0 0 1px 0" width="100" | Fixed in Version
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1291 MAINT-1291]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Enable Debug GL crashes the viewer to the desktop
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac Pro running 10.7.4 with AMD Radeon HD5770 iMac running Mac OS X Lion 10.7.4 (11E53) with AMD Radeon HD 6770M (512 MB) PC Clone running XP Pro with GeForce2 Ultra
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-572 PATH-572]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Underwater 'Walkables' shapes are reflected about the water plane
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-659 PATH-659]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | navmesh being drawn over worn flexi prims and under avatar
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-790 PATH-790]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Physics capsule rendering of character shapes is broken after zooming
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-812 PATH-812]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Show capsules option creates black capsule instead of blue
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | ATI Radeon X300 Video card ATI Radeon X600 Video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-821 PATH-821]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop displays black environment
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop with AMD Radeon HD 4200 Mobile graphics
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-822 PATH-822]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Configuration with ATI Radeon 7500 can launch Viewer, serious GFx issues
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | AMD Athlon64 3000+ with ATI Radeon 7500 video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-864 PATH-864] [https://jira.secondlife.com/browse/PATHBUG-184 PATHBUG-184]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Allow the Linkset floater to shrink smaller than actually
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-814 PATH-814]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 laptop displays black environment</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 with AMD Radeon HD5650M Mobile graphics</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (262596)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-826 PATH-826]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Random crash while wearing a mesh avatar and dropping objects in-world</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (262596)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1413 MAINT-1413] [https://jira.secondlife.com/browse/VWR-29491 VWR-29491]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>"Weights Of Selected" never gives any results after pathfinding tools were merged in.</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1414 MAINT-1414] [https://jira.secondlife.com/browse/VWR-29497 VWR-29497]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>User is not able to specify color of object with unchecked 'Apply now' chechbox</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1425 MAINT-1425]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>viewer spams the log with "LLViewerParcelMgr::requestParcelMediaURLFilter: can't get ParcelMediaURLFilterList cap" while editing an object</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1426 MAINT-1426]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Texture repeats/meter reset before you can click Apply button</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-643 PATH-643] [https://jira.secondlife.com/browse/PATHBUG-174 PATHBUG-174]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Changes in Preferences dialog stops work of Pathfinding View/Test functionality</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-842 PATH-842] [https://jira.secondlife.com/browse/VWR-29431 VWR-29431] [https://jira.secondlife.com/browse/MAINT-1362 MAINT-1362]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>TargetOmega object's rotation resets if it changes color in 3.4.0 (262596) Beta</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-849 PATH-849]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Crash in the beta viewer relating to pathfinding</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-852 PATH-852]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Custom cursors fail on mac and linux</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-854 PATH-854]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Add support in the viewer to display the Scripted column on the linksets floater</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-856 PATH-856]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>As a user, I want to see a notification when I am toggling the phantom flag on a linkset through the Pathfinding Linkset floater</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|}

Pathfinding Tools in the Second Life Viewer

2012-08-22T23:00:49Z

Stinson Linden: /* Known Issues */

{{Pathfinding Nav}}
__TOC__
{{KBnote|The Viewer tools described here are available only in the '''Second Life Viewer Beta''' build. Look under the "Other Viewers" section on the [http://secondlife.com/support/downloads/ Second Life Viewer download page]}}
== Introduction ==
For pathfinding, each region has a navigation mesh, commonly referred to as a "'''navmesh'''". The '''navmesh''' is a representation of the region's geometry generated and used by the physics simulator to determine paths for the pathfinding characters. The navmesh may be in one of the following three states:

* Up-to-date
* Has pending changes
* Building ''(a.k.a. rebaking)''

The navmesh will transition through these states according to the following diagram:

[[File:Navmesh_transitions.png|alt=Second Life Pathfinding NavMesh Transitions|Second Life Pathfinding NavMesh Transitions]]

Six new elements have been added to the SL Viewer interface to communicate the navmesh state for the current region. These new elements are:

* icon representations of the pathfinding region state for the SLURL bar
* a "Rebake region" button that appears above the lower toolbar
* a right-click context menu option addition
* an additional field on the Build floater
* an additional field on the Object Profile floater
* additional simulator metrics on the Statistics floater

In addition to these new elements, three new floaters allow users to more efficiently create, visualize, test, and debug pathfinding-enabled characters. These tools are not required to create pathfinding behaviors but are particularly useful to builders and experienced creators in Second Life. These new floaters are:

* Pathfinding linksets
* Pathfinding characters
* Pathfinding view / test

== Pathfinding UI Elements ==

'''Note that other residents editing pathfinding objects on the same region may create pending changes to the navmesh.''' When this occurs, all residents on the same region and with build rights will see the appropriate SLURL bar icons and rebake region button.

=== Pathfinding Icons in SLURL Bar ===

The SLURL bar indicates the three pathfinding states of the current region.
# '''Navmesh is up-to-date''' The current region's navmesh is up-to-date. No icon is shown as this is the expected default state. [[File:Pathfinding-clean-region-1.png|alt=Second Life URL Bar with Up-to-Date NavMesh Icon|Second Life URL Bar with Up-to-Date NavMesh Icon]]
# '''Navmesh has pending changes''' The region has pending changes that have not yet been baked into the navmesh. A pathfinding icon with a construction symbol is shown. [[File:Pathfinding-dirty-region-1.png|alt=Second Life URL Bar with Pending Changes Icon|Second Life URL Bar with Pending Changes Icon]]
# '''Dynamic pathfinding is disabled''' The region has dynamic pathfinding disabled. Pathfinding characters will not work as expected. A pathfinding icon with a disabled symbol is shown. [[File:Pathfinding-disabled-region-1.png|alt=Second Life URL Bar with Pathfinding Disabled Icon|Second Life URL Bar with Pathfinding Disabled Icon]]

=== Rebake Region Button ===

When a region has pending changes, the appropriate icon will be shown in the SLURL bar, as described above. In addition, if the user has build rights for any parcel on the current region, the user will also be able to see a "Rebake region" button that displays above the lower toolbar.

[[File:Rebake-button-1.png|alt=Second Life Rebake Region button that allows permitted users to rebake pathfinding changes into the navmesh]]

When the user clicks this button, a request is sent to the region to rebake the navmesh for the current region. As rebaking a region may be a time intensive process, the button will change to indicate "Region is rebaking" during this server process. After the rebaking is complete, this button on the viewer will vanish.

[[File:Rebaking-button-1.png|alt=Second Life Region is Rebaking button that indicates that the current region is rebaking its navmesh]]

=== Right-click context menu behavior ===

When right-clicking on an object in-world, pathfinding-specific menu options may be included in the pop-up context menu.

If the user right-clicks on a '''linkset''' object in-world, a menu option "Show in linksets" will allow the user to open the Pathfinding Linksets floater with the current object selected.

[[File:Right-click-show-in-linksets-1.png|alt=Second Life Context Menu with Show in Linksets floater menu option]]

If the user right-clicks on a pathfinding '''character''' object in-world, a menu option "Show in characters" will allow the user to open the Pathfinding Characters floater with the current object selected.

[[File:Right-click-show-in-characters-1.png|alt=Second Life Context Menu with Show in Characters floater menu option]]

=== Additional field on the Build floater ===

The Build floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Build floater with a ''character'' object selected.

[[File:Build-floater-character-1.png|alt=Build floater with pathfinding attribute character|Build floater with pathfinding attribute character]]

The following image is a screenshot of the Build floater with an object that ''affects navmesh'' selected. This object could be a ''walkable'', ''static obstacle'', ''material volume'', or ''exclusion volume''.

[[File:Build-floater-affects-navmesh-1.png|alt=Build floater with pathfinding attribute affects navmesh|Build floater with pathfinding attribute affects navmesh]]

{{KBwarning|For linksets that do affect the navmesh, it will be impossible to modify the object across the region boundary. The user and the object affecting a navmesh must be in the same region to enable modification of the object. This will be indicated on the General tab of the Build floater as illustrated in the following screenshot.}}
[[File:Build-floater-region-boundary-1.png|alt=Build floater indicating that the user cannot modify object across a region boundary|Build floater indicating that the user cannot modify object across a region boundary]]

=== Additional field on the Object Profile floater ===

Similar to the afore-described Build floater, the Object Profile floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Object Profile floater with an ''affects navmesh'' object selected.

[[File:Object-profile-1.png|alt=Object Profile floater with pathfinding attribute affects navmesh|Object Profile floater with pathfinding attribute affects navmesh]]

=== Additional simulator metrics on the Statistics floater ===

For advanced users, additional simulator metrics have been added to the Statistics floater. The Statistics floater, available from the main menu Advanced > Performance Tools > Statistics Bar, has the following 3 additional fields reporting statistics from the simulator regarding pathfinding activity:

* '''AI Step Time''' - The average time spent during each frame computing character AI events.
* '''Skipped Silhouette Steps''' - The number of steps that are skipped per second in computing the influence of objects of type ''Movable Obstacles'' on the navmesh. A high value here means that objects on the region are marked as ''Movable Obstacles'' and could be contributing to improper pathfinding behavior on the region. To lower this value, set all objects that do not move to either type ''Walkable'' or ''Static Obstacle'', and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]].
* '''Characters Updated''' - The average percentage of characters updated during each frame. A low value here means that character AI computations are taking too long during each frame, and thus some character updates are skipped during subsequent frames. This could be contributing to improper pathfinding behavior on the region. To increase this value, decrease the number of characters on the region, and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]]. Note that the Pathfinding Characters floater (described below) may also be used to determine which characters on the region are contributing the most to the region's CPU time.

[[File:Pathfinding-stats-2.png|alt=Simulator Statistics floater with additional pathfinding statistics|Simulator Statistics floater with additional pathfinding statistics]]

== Pathfinding Floaters ==

These three pathfinding floaters may all be accessed through the Build->Pathfinding menu in the Project Viewer - Pathfinding.

[[File:Build-menu-pf-selected-1.png|alt=Second Life Build Menu with new Pathfinding menu items|SL Build -> Pathfinding Menu]]

 

=== Pathfinding Linksets Floater ===

==== Overview ====

The intent of the Pathfinding Linksets floater is to give advanced users and builders the ability to customize an area to achieve interesting effects with pathfinding-enabled characters.

The floater displays information for all linksets within the current region for which the user has the ability to alter. The table reports useful information including
* Linkset Name
* Description
* Owner
* Land Impact
* Distance from the resident's avatar
* Linkset Use
** Potential values
*** Walkable
*** Static Obstacle
*** Movable Obstacle
*** Material Volume
*** Exclusion Volume
*** Movable Phantom
* Walkability Coefficients
** Character Type A ''(example use: humanoid)''
** Character Type B ''(example use: creature)''
** Character Type C ''(example use: mechanical)''
** Character Type D ''(example use: other)''

Additionally, selecting any linksets within the floater will also select the object(s) within the Viewer.

[[File:Linksets-floater-2.png|alt=Pathfinding Linksets floater|Pathfinding Linksets]]

 

==== Controls ====

{{:Viewerhelp:Pathfinding linksets}}

==== Example use ====

The advanced users and builders will use the Pathfinding Linksets floater to customize areas to create interesting effects for pathfinding-enabled characters.

For instance, imagine the scenario of a builder constructing a single room in a pathfinding-enabled house. For the single room, the builder would use the following types as follows:

{|border="1"
! Linkset Use !! Description
|-
|width="200" align="center" | Walkable || align="left" | The floor linkset would be set to be Walkable to allow characters to move across the floor.
|-
|width="200" align="center" | Static Obstacle || align="left" | A desk linkset in the room would be set to be Static Obstacle to block characters from walking through or across the object.

NOTE Any object that should block character movement and that does not move should be marked as Static Obstacle to improve performance of pathfinding characters.
|-
|width="200" align="center" | Movable Obstacle || align="left" | A door linkset in the room would be set to be Movable Obstacle. This will still block characters but, in contrast to Static Obstacles, Movable Obstacles will allow the linkset itself to move. In the case of the door, this will allow the door to open and close, but will still prevent characters from walking through the door.
|-
|width="200" align="center" | Material Volume || align="left" | Material Volumes are phantom objects that can be used to affect the walkability coefficients of intersecting objects. Imagine that the builder applied a texture to the floor. Also, imagine that the floor texture includes small throw rug in the middle of the room. (The builder did not want to create a separate object for the rug, so is using a texture on the floor to give the appearance of a rug). The builder can then create a Material Volume object intersecting the floor at the location of the rug. Then, by setting a lower walkability coefficient for the Material Volume, the builder will create the affect of slowing down characters as the characters traverse across the painted rug area.
|-
|width="200" align="center" | Exclusion Volume || align="left" | Exclusion Volumes are phantom objects that can be used to create areas where characters are prevented from moving. For instance, the builder can use an Exclusion Volume to create a section of the room where avatars would be able to move, but characters would be blocked from following.
|-
|width="200" align="center" | Movable Phantom || align="left" | Movable Phantoms are phantom objects that have no affect on pathfinding-enabled characters.
|}
 
In addition to linkset use attributes, builders can achieve additional effects by modifying the walkability coefficients for linksets. The walkability coefficients are values, ranging from 0% to 100%, that affect a characters speed. A walkability coefficient of 50% will reduce a character's speed by half while the character is traversing across the linkset.
 

=== Pathfinding Characters Floater ===

==== Overview ====
The intent of Pathfinding Characters floater is primarily for users to locate characters moving throughout a region and to identify the CPU cost of characters affecting the performance of a region.

The floater displays information for all characters within the current region for which the user has the ability to manipulate. The table reports useful information including
* Character Name
* Description
* Owner
* CPU Time
* Altitude

[[File:Characters-floater-1.png|alt=Pathfinding Characters floater|Pathfinding Characters]]
 
==== Controls ====

{{:Viewerhelp:Pathfinding characters}}

==== Example use ====
# If a region owner has created a pathfinding-enabled character but is unable to find the character within the region, the Characters floater can be used to locate and select the character.
# Additionally, the Pathfinding Characters floater reports the CPU time cost for each character within the region. This functionality can be used by advanced users to identify which characters are impacting performance the most.

=== Pathfinding View/Test Floater ===

==== Overview ====

The intent of the Pathfinding View/Test floater is for advanced users who are building pathfinding-enabled objects and characters.

This floater consists of 3 basic areas.

# Status area (illustrating both the Viewer and Simulator status of the region's navmesh)
# View tab Controls
# Test Path tab Controls

The following image is a screenshot of the Pathfinding View/Test floater with the navmesh displayed.

[[File:View-nav-mesh-1.png|alt=Pathfinding View/Test floater with the navmesh displayed|Pathfinding View/Test with navmesh displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with the pathfinding object types displayed.

[[File:View-pf-types-1.png|alt=Pathfinding View/Test floater with the pathfinding object types displayed|Pathfinding View/Test with the pathfinding object types displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with a test path displayed.

[[File:View-test-path-1.png|alt=Pathfinding View/Test floater with a test path displayed|Pathfinding View/Test with a test path displayed]]

 
==== Controls ====

{{:Viewerhelp:Pathfinding edit and test}}

==== Example Use ====

# The advanced user will use the Visualization controls to visualize how the navmesh and related permanent objects have been generated. By seeing this visualization of how the physics engine interprets the navigation information, the advanced user can understand how to better customize the pathfinding-enabled objects to obtain the desired behaviors of characters.
# The advanced user will use the Test Tab to visualize how a test character would choose the path between selected start and end points.

 

== Known Issues ==

{| style="border-style:solid;border-width:2px 0 2px 0px;"
! style="border-style:solid;border-width:0 0 1px 0" width="130" | JIRA
! style="border-style:solid;border-width:0 0 1px 0" width="300" | Summary
! style="border-style:solid;border-width:0 0 1px 0" width="550" | Hardware
! style="border-style:solid;border-width:0 0 1px 0" width="100" | Fixed in Version
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1291 MAINT-1291]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Enable Debug GL crashes the viewer to the desktop
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac Pro running 10.7.4 with AMD Radeon HD5770 iMac running Mac OS X Lion 10.7.4 (11E53) with AMD Radeon HD 6770M (512 MB) PC Clone running XP Pro with GeForce2 Ultra
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-572 PATH-572]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Underwater 'Walkables' shapes are reflected about the water plane
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-659 PATH-659]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | navmesh being drawn over worn flexi prims and under avatar
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-790 PATH-790]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Physics capsule rendering of character shapes is broken after zooming
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-812 PATH-812]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Show capsules option creates black capsule instead of blue
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | ATI Radeon X300 Video card ATI Radeon X600 Video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-821 PATH-821]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop displays black environment
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop with AMD Radeon HD 4200 Mobile graphics
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-822 PATH-822]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Configuration with ATI Radeon 7500 can launch Viewer, serious GFx issues
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | AMD Athlon64 3000+ with ATI Radeon 7500 video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-864 PATH-864] [https://jira.secondlife.com/browse/PATHBUG-184 PATHBUG-184]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Allow the Linkset floater to shrink smaller than actually
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1413 MAINT-1413] [https://jira.secondlife.com/browse/VWR-29491 VWR-29491]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>"Weights Of Selected" never gives any results after pathfinding tools were merged in.</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1414 MAINT-1414] [https://jira.secondlife.com/browse/VWR-29497 VWR-29497]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>User is not able to specify color of object with unchecked 'Apply now' chechbox</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1425 MAINT-1425]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>viewer spams the log with "LLViewerParcelMgr::requestParcelMediaURLFilter: can't get ParcelMediaURLFilterList cap" while editing an object</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1426 MAINT-1426]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Texture repeats/meter reset before you can click Apply button</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-643 PATH-643] [https://jira.secondlife.com/browse/PATHBUG-174 PATHBUG-174]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Changes in Preferences dialog stops work of Pathfinding View/Test functionality</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-814 PATH-814]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 laptop displays black environment</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 with AMD Radeon HD5650M Mobile graphics</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (262596)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-826 PATH-826]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Random crash while wearing a mesh avatar and dropping objects in-world</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (262596)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-842 PATH-842] [https://jira.secondlife.com/browse/VWR-29431 VWR-29431] [https://jira.secondlife.com/browse/MAINT-1362 MAINT-1362]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>TargetOmega object's rotation resets if it changes color in 3.4.0 (262596) Beta</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-849 PATH-849]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Crash in the beta viewer relating to pathfinding</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-852 PATH-852]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Custom cursors fail on mac and linux</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-854 PATH-854]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Add support in the viewer to display the Scripted column on the linksets floater</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-856 PATH-856]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>As a user, I want to see a notification when I am toggling the phantom flag on a linkset through the Pathfinding Linkset floater</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|}

Pathfinding Tools in the Second Life Viewer

2012-08-22T22:56:19Z

Stinson Linden: /* Known Issues */

{{Pathfinding Nav}}
__TOC__
{{KBnote|The Viewer tools described here are available only in the '''Second Life Viewer Beta''' build. Look under the "Other Viewers" section on the [http://secondlife.com/support/downloads/ Second Life Viewer download page]}}
== Introduction ==
For pathfinding, each region has a navigation mesh, commonly referred to as a "'''navmesh'''". The '''navmesh''' is a representation of the region's geometry generated and used by the physics simulator to determine paths for the pathfinding characters. The navmesh may be in one of the following three states:

* Up-to-date
* Has pending changes
* Building ''(a.k.a. rebaking)''

The navmesh will transition through these states according to the following diagram:

[[File:Navmesh_transitions.png|alt=Second Life Pathfinding NavMesh Transitions|Second Life Pathfinding NavMesh Transitions]]

Six new elements have been added to the SL Viewer interface to communicate the navmesh state for the current region. These new elements are:

* icon representations of the pathfinding region state for the SLURL bar
* a "Rebake region" button that appears above the lower toolbar
* a right-click context menu option addition
* an additional field on the Build floater
* an additional field on the Object Profile floater
* additional simulator metrics on the Statistics floater

In addition to these new elements, three new floaters allow users to more efficiently create, visualize, test, and debug pathfinding-enabled characters. These tools are not required to create pathfinding behaviors but are particularly useful to builders and experienced creators in Second Life. These new floaters are:

* Pathfinding linksets
* Pathfinding characters
* Pathfinding view / test

== Pathfinding UI Elements ==

'''Note that other residents editing pathfinding objects on the same region may create pending changes to the navmesh.''' When this occurs, all residents on the same region and with build rights will see the appropriate SLURL bar icons and rebake region button.

=== Pathfinding Icons in SLURL Bar ===

The SLURL bar indicates the three pathfinding states of the current region.
# '''Navmesh is up-to-date''' The current region's navmesh is up-to-date. No icon is shown as this is the expected default state. [[File:Pathfinding-clean-region-1.png|alt=Second Life URL Bar with Up-to-Date NavMesh Icon|Second Life URL Bar with Up-to-Date NavMesh Icon]]
# '''Navmesh has pending changes''' The region has pending changes that have not yet been baked into the navmesh. A pathfinding icon with a construction symbol is shown. [[File:Pathfinding-dirty-region-1.png|alt=Second Life URL Bar with Pending Changes Icon|Second Life URL Bar with Pending Changes Icon]]
# '''Dynamic pathfinding is disabled''' The region has dynamic pathfinding disabled. Pathfinding characters will not work as expected. A pathfinding icon with a disabled symbol is shown. [[File:Pathfinding-disabled-region-1.png|alt=Second Life URL Bar with Pathfinding Disabled Icon|Second Life URL Bar with Pathfinding Disabled Icon]]

=== Rebake Region Button ===

When a region has pending changes, the appropriate icon will be shown in the SLURL bar, as described above. In addition, if the user has build rights for any parcel on the current region, the user will also be able to see a "Rebake region" button that displays above the lower toolbar.

[[File:Rebake-button-1.png|alt=Second Life Rebake Region button that allows permitted users to rebake pathfinding changes into the navmesh]]

When the user clicks this button, a request is sent to the region to rebake the navmesh for the current region. As rebaking a region may be a time intensive process, the button will change to indicate "Region is rebaking" during this server process. After the rebaking is complete, this button on the viewer will vanish.

[[File:Rebaking-button-1.png|alt=Second Life Region is Rebaking button that indicates that the current region is rebaking its navmesh]]

=== Right-click context menu behavior ===

When right-clicking on an object in-world, pathfinding-specific menu options may be included in the pop-up context menu.

If the user right-clicks on a '''linkset''' object in-world, a menu option "Show in linksets" will allow the user to open the Pathfinding Linksets floater with the current object selected.

[[File:Right-click-show-in-linksets-1.png|alt=Second Life Context Menu with Show in Linksets floater menu option]]

If the user right-clicks on a pathfinding '''character''' object in-world, a menu option "Show in characters" will allow the user to open the Pathfinding Characters floater with the current object selected.

[[File:Right-click-show-in-characters-1.png|alt=Second Life Context Menu with Show in Characters floater menu option]]

=== Additional field on the Build floater ===

The Build floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Build floater with a ''character'' object selected.

[[File:Build-floater-character-1.png|alt=Build floater with pathfinding attribute character|Build floater with pathfinding attribute character]]

The following image is a screenshot of the Build floater with an object that ''affects navmesh'' selected. This object could be a ''walkable'', ''static obstacle'', ''material volume'', or ''exclusion volume''.

[[File:Build-floater-affects-navmesh-1.png|alt=Build floater with pathfinding attribute affects navmesh|Build floater with pathfinding attribute affects navmesh]]

{{KBwarning|For linksets that do affect the navmesh, it will be impossible to modify the object across the region boundary. The user and the object affecting a navmesh must be in the same region to enable modification of the object. This will be indicated on the General tab of the Build floater as illustrated in the following screenshot.}}
[[File:Build-floater-region-boundary-1.png|alt=Build floater indicating that the user cannot modify object across a region boundary|Build floater indicating that the user cannot modify object across a region boundary]]

=== Additional field on the Object Profile floater ===

Similar to the afore-described Build floater, the Object Profile floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Object Profile floater with an ''affects navmesh'' object selected.

[[File:Object-profile-1.png|alt=Object Profile floater with pathfinding attribute affects navmesh|Object Profile floater with pathfinding attribute affects navmesh]]

=== Additional simulator metrics on the Statistics floater ===

For advanced users, additional simulator metrics have been added to the Statistics floater. The Statistics floater, available from the main menu Advanced > Performance Tools > Statistics Bar, has the following 3 additional fields reporting statistics from the simulator regarding pathfinding activity:

* '''AI Step Time''' - The average time spent during each frame computing character AI events.
* '''Skipped Silhouette Steps''' - The number of steps that are skipped per second in computing the influence of objects of type ''Movable Obstacles'' on the navmesh. A high value here means that objects on the region are marked as ''Movable Obstacles'' and could be contributing to improper pathfinding behavior on the region. To lower this value, set all objects that do not move to either type ''Walkable'' or ''Static Obstacle'', and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]].
* '''Characters Updated''' - The average percentage of characters updated during each frame. A low value here means that character AI computations are taking too long during each frame, and thus some character updates are skipped during subsequent frames. This could be contributing to improper pathfinding behavior on the region. To increase this value, decrease the number of characters on the region, and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]]. Note that the Pathfinding Characters floater (described below) may also be used to determine which characters on the region are contributing the most to the region's CPU time.

[[File:Pathfinding-stats-2.png|alt=Simulator Statistics floater with additional pathfinding statistics|Simulator Statistics floater with additional pathfinding statistics]]

== Pathfinding Floaters ==

These three pathfinding floaters may all be accessed through the Build->Pathfinding menu in the Project Viewer - Pathfinding.

[[File:Build-menu-pf-selected-1.png|alt=Second Life Build Menu with new Pathfinding menu items|SL Build -> Pathfinding Menu]]

 

=== Pathfinding Linksets Floater ===

==== Overview ====

The intent of the Pathfinding Linksets floater is to give advanced users and builders the ability to customize an area to achieve interesting effects with pathfinding-enabled characters.

The floater displays information for all linksets within the current region for which the user has the ability to alter. The table reports useful information including
* Linkset Name
* Description
* Owner
* Land Impact
* Distance from the resident's avatar
* Linkset Use
** Potential values
*** Walkable
*** Static Obstacle
*** Movable Obstacle
*** Material Volume
*** Exclusion Volume
*** Movable Phantom
* Walkability Coefficients
** Character Type A ''(example use: humanoid)''
** Character Type B ''(example use: creature)''
** Character Type C ''(example use: mechanical)''
** Character Type D ''(example use: other)''

Additionally, selecting any linksets within the floater will also select the object(s) within the Viewer.

[[File:Linksets-floater-2.png|alt=Pathfinding Linksets floater|Pathfinding Linksets]]

 

==== Controls ====

{{:Viewerhelp:Pathfinding linksets}}

==== Example use ====

The advanced users and builders will use the Pathfinding Linksets floater to customize areas to create interesting effects for pathfinding-enabled characters.

For instance, imagine the scenario of a builder constructing a single room in a pathfinding-enabled house. For the single room, the builder would use the following types as follows:

{|border="1"
! Linkset Use !! Description
|-
|width="200" align="center" | Walkable || align="left" | The floor linkset would be set to be Walkable to allow characters to move across the floor.
|-
|width="200" align="center" | Static Obstacle || align="left" | A desk linkset in the room would be set to be Static Obstacle to block characters from walking through or across the object.

NOTE Any object that should block character movement and that does not move should be marked as Static Obstacle to improve performance of pathfinding characters.
|-
|width="200" align="center" | Movable Obstacle || align="left" | A door linkset in the room would be set to be Movable Obstacle. This will still block characters but, in contrast to Static Obstacles, Movable Obstacles will allow the linkset itself to move. In the case of the door, this will allow the door to open and close, but will still prevent characters from walking through the door.
|-
|width="200" align="center" | Material Volume || align="left" | Material Volumes are phantom objects that can be used to affect the walkability coefficients of intersecting objects. Imagine that the builder applied a texture to the floor. Also, imagine that the floor texture includes small throw rug in the middle of the room. (The builder did not want to create a separate object for the rug, so is using a texture on the floor to give the appearance of a rug). The builder can then create a Material Volume object intersecting the floor at the location of the rug. Then, by setting a lower walkability coefficient for the Material Volume, the builder will create the affect of slowing down characters as the characters traverse across the painted rug area.
|-
|width="200" align="center" | Exclusion Volume || align="left" | Exclusion Volumes are phantom objects that can be used to create areas where characters are prevented from moving. For instance, the builder can use an Exclusion Volume to create a section of the room where avatars would be able to move, but characters would be blocked from following.
|-
|width="200" align="center" | Movable Phantom || align="left" | Movable Phantoms are phantom objects that have no affect on pathfinding-enabled characters.
|}
 
In addition to linkset use attributes, builders can achieve additional effects by modifying the walkability coefficients for linksets. The walkability coefficients are values, ranging from 0% to 100%, that affect a characters speed. A walkability coefficient of 50% will reduce a character's speed by half while the character is traversing across the linkset.
 

=== Pathfinding Characters Floater ===

==== Overview ====
The intent of Pathfinding Characters floater is primarily for users to locate characters moving throughout a region and to identify the CPU cost of characters affecting the performance of a region.

The floater displays information for all characters within the current region for which the user has the ability to manipulate. The table reports useful information including
* Character Name
* Description
* Owner
* CPU Time
* Altitude

[[File:Characters-floater-1.png|alt=Pathfinding Characters floater|Pathfinding Characters]]
 
==== Controls ====

{{:Viewerhelp:Pathfinding characters}}

==== Example use ====
# If a region owner has created a pathfinding-enabled character but is unable to find the character within the region, the Characters floater can be used to locate and select the character.
# Additionally, the Pathfinding Characters floater reports the CPU time cost for each character within the region. This functionality can be used by advanced users to identify which characters are impacting performance the most.

=== Pathfinding View/Test Floater ===

==== Overview ====

The intent of the Pathfinding View/Test floater is for advanced users who are building pathfinding-enabled objects and characters.

This floater consists of 3 basic areas.

# Status area (illustrating both the Viewer and Simulator status of the region's navmesh)
# View tab Controls
# Test Path tab Controls

The following image is a screenshot of the Pathfinding View/Test floater with the navmesh displayed.

[[File:View-nav-mesh-1.png|alt=Pathfinding View/Test floater with the navmesh displayed|Pathfinding View/Test with navmesh displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with the pathfinding object types displayed.

[[File:View-pf-types-1.png|alt=Pathfinding View/Test floater with the pathfinding object types displayed|Pathfinding View/Test with the pathfinding object types displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with a test path displayed.

[[File:View-test-path-1.png|alt=Pathfinding View/Test floater with a test path displayed|Pathfinding View/Test with a test path displayed]]

 
==== Controls ====

{{:Viewerhelp:Pathfinding edit and test}}

==== Example Use ====

# The advanced user will use the Visualization controls to visualize how the navmesh and related permanent objects have been generated. By seeing this visualization of how the physics engine interprets the navigation information, the advanced user can understand how to better customize the pathfinding-enabled objects to obtain the desired behaviors of characters.
# The advanced user will use the Test Tab to visualize how a test character would choose the path between selected start and end points.

 

== Known Issues ==

{| style="border-style:solid;border-width:2px 0 2px 0px;"
! style="border-style:solid;border-width:0 0 1px 0" width="130" | JIRA
! style="border-style:solid;border-width:0 0 1px 0" width="300" | Summary
! style="border-style:solid;border-width:0 0 1px 0" width="550" | Hardware
! style="border-style:solid;border-width:0 0 1px 0" width="100" | Fixed in Version
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1291 MAINT-1291]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Enable Debug GL crashes the viewer to the desktop
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac Pro running 10.7.4 with AMD Radeon HD5770 iMac running Mac OS X Lion 10.7.4 (11E53) with AMD Radeon HD 6770M (512 MB) PC Clone running XP Pro with GeForce2 Ultra
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1413 MAINT-1413] [https://jira.secondlife.com/browse/VWR-29491 VWR-29491]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>"Weights Of Selected" never gives any results after pathfinding tools were merged in.</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1414 MAINT-1414] [https://jira.secondlife.com/browse/VWR-29497 VWR-29497]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>User is not able to specify color of object with unchecked 'Apply now' chechbox</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1425 MAINT-1425]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>viewer spams the log with "LLViewerParcelMgr::requestParcelMediaURLFilter: can't get ParcelMediaURLFilterList cap" while editing an object</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1426 MAINT-1426]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Texture repeats/meter reset before you can click Apply button</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-572 PATH-572]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Underwater 'Walkables' shapes are reflected about the water plane
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-643 PATH-643] [https://jira.secondlife.com/browse/PATHBUG-174 PATHBUG-174]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Changes in Preferences dialog stops work of Pathfinding View/Test functionality</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-659 PATH-659]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | navmesh being drawn over worn flexi prims and under avatar
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-790 PATH-790]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Physics capsule rendering of character shapes is broken after zooming
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-812 PATH-812]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Show capsules option creates black capsule instead of blue
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | ATI Radeon X300 Video card ATI Radeon X600 Video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-814 PATH-814]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 laptop displays black environment</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 with AMD Radeon HD5650M Mobile graphics</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (262596)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-821 PATH-821]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop displays black environment
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop with AMD Radeon HD 4200 Mobile graphics
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-822 PATH-822]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Configuration with ATI Radeon 7500 can launch Viewer, serious GFx issues
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | AMD Athlon64 3000+ with ATI Radeon 7500 video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-826 PATH-826]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Random crash while wearing a mesh avatar and dropping objects in-world</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (262596)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-842 PATH-842] [https://jira.secondlife.com/browse/VWR-29431 VWR-29431] [https://jira.secondlife.com/browse/MAINT-1362 MAINT-1362]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>TargetOmega object's rotation resets if it changes color in 3.4.0 (262596) Beta</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-849 PATH-849]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Crash in the beta viewer relating to pathfinding</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-852 PATH-852]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Custom cursors fail on mac and linux</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-854 PATH-854]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Add support in the viewer to display the Scripted column on the linksets floater</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-856 PATH-856]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>As a user, I want to see a notification when I am toggling the phantom flag on a linkset through the Pathfinding Linkset floater</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-864 PATH-864] [https://jira.secondlife.com/browse/PATHBUG-184 PATHBUG-184]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Allow the Linkset floater to shrink smaller than actually
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|}

Pathfinding Tools in the Second Life Viewer

2012-08-22T22:03:00Z

Stinson Linden: /* Known Issues */

{{Pathfinding Nav}}
__TOC__
{{KBnote|The Viewer tools described here are available only in the '''Second Life Viewer Beta''' build. Look under the "Other Viewers" section on the [http://secondlife.com/support/downloads/ Second Life Viewer download page]}}
== Introduction ==
For pathfinding, each region has a navigation mesh, commonly referred to as a "'''navmesh'''". The '''navmesh''' is a representation of the region's geometry generated and used by the physics simulator to determine paths for the pathfinding characters. The navmesh may be in one of the following three states:

* Up-to-date
* Has pending changes
* Building ''(a.k.a. rebaking)''

The navmesh will transition through these states according to the following diagram:

[[File:Navmesh_transitions.png|alt=Second Life Pathfinding NavMesh Transitions|Second Life Pathfinding NavMesh Transitions]]

Six new elements have been added to the SL Viewer interface to communicate the navmesh state for the current region. These new elements are:

* icon representations of the pathfinding region state for the SLURL bar
* a "Rebake region" button that appears above the lower toolbar
* a right-click context menu option addition
* an additional field on the Build floater
* an additional field on the Object Profile floater
* additional simulator metrics on the Statistics floater

In addition to these new elements, three new floaters allow users to more efficiently create, visualize, test, and debug pathfinding-enabled characters. These tools are not required to create pathfinding behaviors but are particularly useful to builders and experienced creators in Second Life. These new floaters are:

* Pathfinding linksets
* Pathfinding characters
* Pathfinding view / test

== Pathfinding UI Elements ==

'''Note that other residents editing pathfinding objects on the same region may create pending changes to the navmesh.''' When this occurs, all residents on the same region and with build rights will see the appropriate SLURL bar icons and rebake region button.

=== Pathfinding Icons in SLURL Bar ===

The SLURL bar indicates the three pathfinding states of the current region.
# '''Navmesh is up-to-date''' The current region's navmesh is up-to-date. No icon is shown as this is the expected default state. [[File:Pathfinding-clean-region-1.png|alt=Second Life URL Bar with Up-to-Date NavMesh Icon|Second Life URL Bar with Up-to-Date NavMesh Icon]]
# '''Navmesh has pending changes''' The region has pending changes that have not yet been baked into the navmesh. A pathfinding icon with a construction symbol is shown. [[File:Pathfinding-dirty-region-1.png|alt=Second Life URL Bar with Pending Changes Icon|Second Life URL Bar with Pending Changes Icon]]
# '''Dynamic pathfinding is disabled''' The region has dynamic pathfinding disabled. Pathfinding characters will not work as expected. A pathfinding icon with a disabled symbol is shown. [[File:Pathfinding-disabled-region-1.png|alt=Second Life URL Bar with Pathfinding Disabled Icon|Second Life URL Bar with Pathfinding Disabled Icon]]

=== Rebake Region Button ===

When a region has pending changes, the appropriate icon will be shown in the SLURL bar, as described above. In addition, if the user has build rights for any parcel on the current region, the user will also be able to see a "Rebake region" button that displays above the lower toolbar.

[[File:Rebake-button-1.png|alt=Second Life Rebake Region button that allows permitted users to rebake pathfinding changes into the navmesh]]

When the user clicks this button, a request is sent to the region to rebake the navmesh for the current region. As rebaking a region may be a time intensive process, the button will change to indicate "Region is rebaking" during this server process. After the rebaking is complete, this button on the viewer will vanish.

[[File:Rebaking-button-1.png|alt=Second Life Region is Rebaking button that indicates that the current region is rebaking its navmesh]]

=== Right-click context menu behavior ===

When right-clicking on an object in-world, pathfinding-specific menu options may be included in the pop-up context menu.

If the user right-clicks on a '''linkset''' object in-world, a menu option "Show in linksets" will allow the user to open the Pathfinding Linksets floater with the current object selected.

[[File:Right-click-show-in-linksets-1.png|alt=Second Life Context Menu with Show in Linksets floater menu option]]

If the user right-clicks on a pathfinding '''character''' object in-world, a menu option "Show in characters" will allow the user to open the Pathfinding Characters floater with the current object selected.

[[File:Right-click-show-in-characters-1.png|alt=Second Life Context Menu with Show in Characters floater menu option]]

=== Additional field on the Build floater ===

The Build floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Build floater with a ''character'' object selected.

[[File:Build-floater-character-1.png|alt=Build floater with pathfinding attribute character|Build floater with pathfinding attribute character]]

The following image is a screenshot of the Build floater with an object that ''affects navmesh'' selected. This object could be a ''walkable'', ''static obstacle'', ''material volume'', or ''exclusion volume''.

[[File:Build-floater-affects-navmesh-1.png|alt=Build floater with pathfinding attribute affects navmesh|Build floater with pathfinding attribute affects navmesh]]

{{KBwarning|For linksets that do affect the navmesh, it will be impossible to modify the object across the region boundary. The user and the object affecting a navmesh must be in the same region to enable modification of the object. This will be indicated on the General tab of the Build floater as illustrated in the following screenshot.}}
[[File:Build-floater-region-boundary-1.png|alt=Build floater indicating that the user cannot modify object across a region boundary|Build floater indicating that the user cannot modify object across a region boundary]]

=== Additional field on the Object Profile floater ===

Similar to the afore-described Build floater, the Object Profile floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Object Profile floater with an ''affects navmesh'' object selected.

[[File:Object-profile-1.png|alt=Object Profile floater with pathfinding attribute affects navmesh|Object Profile floater with pathfinding attribute affects navmesh]]

=== Additional simulator metrics on the Statistics floater ===

For advanced users, additional simulator metrics have been added to the Statistics floater. The Statistics floater, available from the main menu Advanced > Performance Tools > Statistics Bar, has the following 3 additional fields reporting statistics from the simulator regarding pathfinding activity:

* '''AI Step Time''' - The average time spent during each frame computing character AI events.
* '''Skipped Silhouette Steps''' - The number of steps that are skipped per second in computing the influence of objects of type ''Movable Obstacles'' on the navmesh. A high value here means that objects on the region are marked as ''Movable Obstacles'' and could be contributing to improper pathfinding behavior on the region. To lower this value, set all objects that do not move to either type ''Walkable'' or ''Static Obstacle'', and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]].
* '''Characters Updated''' - The average percentage of characters updated during each frame. A low value here means that character AI computations are taking too long during each frame, and thus some character updates are skipped during subsequent frames. This could be contributing to improper pathfinding behavior on the region. To increase this value, decrease the number of characters on the region, and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]]. Note that the Pathfinding Characters floater (described below) may also be used to determine which characters on the region are contributing the most to the region's CPU time.

[[File:Pathfinding-stats-2.png|alt=Simulator Statistics floater with additional pathfinding statistics|Simulator Statistics floater with additional pathfinding statistics]]

== Pathfinding Floaters ==

These three pathfinding floaters may all be accessed through the Build->Pathfinding menu in the Project Viewer - Pathfinding.

[[File:Build-menu-pf-selected-1.png|alt=Second Life Build Menu with new Pathfinding menu items|SL Build -> Pathfinding Menu]]

 

=== Pathfinding Linksets Floater ===

==== Overview ====

The intent of the Pathfinding Linksets floater is to give advanced users and builders the ability to customize an area to achieve interesting effects with pathfinding-enabled characters.

The floater displays information for all linksets within the current region for which the user has the ability to alter. The table reports useful information including
* Linkset Name
* Description
* Owner
* Land Impact
* Distance from the resident's avatar
* Linkset Use
** Potential values
*** Walkable
*** Static Obstacle
*** Movable Obstacle
*** Material Volume
*** Exclusion Volume
*** Movable Phantom
* Walkability Coefficients
** Character Type A ''(example use: humanoid)''
** Character Type B ''(example use: creature)''
** Character Type C ''(example use: mechanical)''
** Character Type D ''(example use: other)''

Additionally, selecting any linksets within the floater will also select the object(s) within the Viewer.

[[File:Linksets-floater-2.png|alt=Pathfinding Linksets floater|Pathfinding Linksets]]

 

==== Controls ====

{{:Viewerhelp:Pathfinding linksets}}

==== Example use ====

The advanced users and builders will use the Pathfinding Linksets floater to customize areas to create interesting effects for pathfinding-enabled characters.

For instance, imagine the scenario of a builder constructing a single room in a pathfinding-enabled house. For the single room, the builder would use the following types as follows:

{|border="1"
! Linkset Use !! Description
|-
|width="200" align="center" | Walkable || align="left" | The floor linkset would be set to be Walkable to allow characters to move across the floor.
|-
|width="200" align="center" | Static Obstacle || align="left" | A desk linkset in the room would be set to be Static Obstacle to block characters from walking through or across the object.

NOTE Any object that should block character movement and that does not move should be marked as Static Obstacle to improve performance of pathfinding characters.
|-
|width="200" align="center" | Movable Obstacle || align="left" | A door linkset in the room would be set to be Movable Obstacle. This will still block characters but, in contrast to Static Obstacles, Movable Obstacles will allow the linkset itself to move. In the case of the door, this will allow the door to open and close, but will still prevent characters from walking through the door.
|-
|width="200" align="center" | Material Volume || align="left" | Material Volumes are phantom objects that can be used to affect the walkability coefficients of intersecting objects. Imagine that the builder applied a texture to the floor. Also, imagine that the floor texture includes small throw rug in the middle of the room. (The builder did not want to create a separate object for the rug, so is using a texture on the floor to give the appearance of a rug). The builder can then create a Material Volume object intersecting the floor at the location of the rug. Then, by setting a lower walkability coefficient for the Material Volume, the builder will create the affect of slowing down characters as the characters traverse across the painted rug area.
|-
|width="200" align="center" | Exclusion Volume || align="left" | Exclusion Volumes are phantom objects that can be used to create areas where characters are prevented from moving. For instance, the builder can use an Exclusion Volume to create a section of the room where avatars would be able to move, but characters would be blocked from following.
|-
|width="200" align="center" | Movable Phantom || align="left" | Movable Phantoms are phantom objects that have no affect on pathfinding-enabled characters.
|}
 
In addition to linkset use attributes, builders can achieve additional effects by modifying the walkability coefficients for linksets. The walkability coefficients are values, ranging from 0% to 100%, that affect a characters speed. A walkability coefficient of 50% will reduce a character's speed by half while the character is traversing across the linkset.
 

=== Pathfinding Characters Floater ===

==== Overview ====
The intent of Pathfinding Characters floater is primarily for users to locate characters moving throughout a region and to identify the CPU cost of characters affecting the performance of a region.

The floater displays information for all characters within the current region for which the user has the ability to manipulate. The table reports useful information including
* Character Name
* Description
* Owner
* CPU Time
* Altitude

[[File:Characters-floater-1.png|alt=Pathfinding Characters floater|Pathfinding Characters]]
 
==== Controls ====

{{:Viewerhelp:Pathfinding characters}}

==== Example use ====
# If a region owner has created a pathfinding-enabled character but is unable to find the character within the region, the Characters floater can be used to locate and select the character.
# Additionally, the Pathfinding Characters floater reports the CPU time cost for each character within the region. This functionality can be used by advanced users to identify which characters are impacting performance the most.

=== Pathfinding View/Test Floater ===

==== Overview ====

The intent of the Pathfinding View/Test floater is for advanced users who are building pathfinding-enabled objects and characters.

This floater consists of 3 basic areas.

# Status area (illustrating both the Viewer and Simulator status of the region's navmesh)
# View tab Controls
# Test Path tab Controls

The following image is a screenshot of the Pathfinding View/Test floater with the navmesh displayed.

[[File:View-nav-mesh-1.png|alt=Pathfinding View/Test floater with the navmesh displayed|Pathfinding View/Test with navmesh displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with the pathfinding object types displayed.

[[File:View-pf-types-1.png|alt=Pathfinding View/Test floater with the pathfinding object types displayed|Pathfinding View/Test with the pathfinding object types displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with a test path displayed.

[[File:View-test-path-1.png|alt=Pathfinding View/Test floater with a test path displayed|Pathfinding View/Test with a test path displayed]]

 
==== Controls ====

{{:Viewerhelp:Pathfinding edit and test}}

==== Example Use ====

# The advanced user will use the Visualization controls to visualize how the navmesh and related permanent objects have been generated. By seeing this visualization of how the physics engine interprets the navigation information, the advanced user can understand how to better customize the pathfinding-enabled objects to obtain the desired behaviors of characters.
# The advanced user will use the Test Tab to visualize how a test character would choose the path between selected start and end points.

 

== Known Issues ==

{| style="border-style:solid;border-width:2px 0 2px 0px;"
! style="border-style:solid;border-width:0 0 1px 0" width="130" | JIRA
! style="border-style:solid;border-width:0 0 1px 0" width="300" | Summary
! style="border-style:solid;border-width:0 0 1px 0" width="550" | Hardware
! style="border-style:solid;border-width:0 0 1px 0" width="100" | Fixed in Version
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1291 MAINT-1291]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Enable Debug GL crashes the viewer to the desktop
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac Pro running 10.7.4 with AMD Radeon HD5770 iMac running Mac OS X Lion 10.7.4 (11E53) with AMD Radeon HD 6770M (512 MB) PC Clone running XP Pro with GeForce2 Ultra
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1413 MAINT-1413] [https://jira.secondlife.com/browse/VWR-29491 VWR-29491]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>"Weights Of Selected" never gives any results after pathfinding tools were merged in.</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1414 MAINT-1414] [https://jira.secondlife.com/browse/VWR-29497 VWR-29497]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>User is not able to specify color of object with unchecked 'Apply now' chechbox</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1425 MAINT-1425]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>viewer spams the log with "LLViewerParcelMgr::requestParcelMediaURLFilter: can't get ParcelMediaURLFilterList cap" while editing an object</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1426 MAINT-1426]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Texture repeats/meter reset before you can click Apply button</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-572 PATH-572]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Underwater 'Walkables' shapes are reflected about the water plane
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-643 PATH-643] [https://jira.secondlife.com/browse/PATHBUG-174 PATHBUG-174]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Changes in Preferences dialog stops work of Pathfinding View/Test functionality</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-659 PATH-659]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | navmesh being drawn over worn flexi prims and under avatar
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-790 PATH-790]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Physics capsule rendering of character shapes is broken after zooming
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-812 PATH-812]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Show capsules option creates black capsule instead of blue
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | ATI Radeon X300 Video card ATI Radeon X600 Video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-814 PATH-814]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 laptop displays black environment</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 with AMD Radeon HD5650M Mobile graphics</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (262596)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-821 PATH-821]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop displays black environment
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop with AMD Radeon HD 4200 Mobile graphics
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-822 PATH-822]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Configuration with ATI Radeon 7500 can launch Viewer, serious GFx issues
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | AMD Athlon64 3000+ with ATI Radeon 7500 video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-826 PATH-826]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Random crash while wearing a mesh avatar and dropping objects in-world</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (262596)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-842 PATH-842] [https://jira.secondlife.com/browse/VWR-29431 VWR-29431] [https://jira.secondlife.com/browse/MAINT-1362 MAINT-1362]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>TargetOmega object's rotation resets if it changes color in 3.4.0 (262596) Beta</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-849 PATH-849]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Crash in the beta viewer relating to pathfinding</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-852 PATH-852]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Custom cursors fail on mac and linux</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-854 PATH-854]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Add support in the viewer to display the Scripted column on the linksets floater</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-856 PATH-856]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>As a user, I want to see a notification when I am toggling the phantom flag on a linkset through the Pathfinding Linkset floater</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|}

Pathfinding Tools in the Second Life Viewer

2012-08-22T21:33:08Z

Stinson Linden: /* Known Issues */

{{Pathfinding Nav}}
__TOC__
{{KBnote|The Viewer tools described here are available only in the '''Second Life Viewer Beta''' build. Look under the "Other Viewers" section on the [http://secondlife.com/support/downloads/ Second Life Viewer download page]}}
== Introduction ==
For pathfinding, each region has a navigation mesh, commonly referred to as a "'''navmesh'''". The '''navmesh''' is a representation of the region's geometry generated and used by the physics simulator to determine paths for the pathfinding characters. The navmesh may be in one of the following three states:

* Up-to-date
* Has pending changes
* Building ''(a.k.a. rebaking)''

The navmesh will transition through these states according to the following diagram:

[[File:Navmesh_transitions.png|alt=Second Life Pathfinding NavMesh Transitions|Second Life Pathfinding NavMesh Transitions]]

Six new elements have been added to the SL Viewer interface to communicate the navmesh state for the current region. These new elements are:

* icon representations of the pathfinding region state for the SLURL bar
* a "Rebake region" button that appears above the lower toolbar
* a right-click context menu option addition
* an additional field on the Build floater
* an additional field on the Object Profile floater
* additional simulator metrics on the Statistics floater

In addition to these new elements, three new floaters allow users to more efficiently create, visualize, test, and debug pathfinding-enabled characters. These tools are not required to create pathfinding behaviors but are particularly useful to builders and experienced creators in Second Life. These new floaters are:

* Pathfinding linksets
* Pathfinding characters
* Pathfinding view / test

== Pathfinding UI Elements ==

'''Note that other residents editing pathfinding objects on the same region may create pending changes to the navmesh.''' When this occurs, all residents on the same region and with build rights will see the appropriate SLURL bar icons and rebake region button.

=== Pathfinding Icons in SLURL Bar ===

The SLURL bar indicates the three pathfinding states of the current region.
# '''Navmesh is up-to-date''' The current region's navmesh is up-to-date. No icon is shown as this is the expected default state. [[File:Pathfinding-clean-region-1.png|alt=Second Life URL Bar with Up-to-Date NavMesh Icon|Second Life URL Bar with Up-to-Date NavMesh Icon]]
# '''Navmesh has pending changes''' The region has pending changes that have not yet been baked into the navmesh. A pathfinding icon with a construction symbol is shown. [[File:Pathfinding-dirty-region-1.png|alt=Second Life URL Bar with Pending Changes Icon|Second Life URL Bar with Pending Changes Icon]]
# '''Dynamic pathfinding is disabled''' The region has dynamic pathfinding disabled. Pathfinding characters will not work as expected. A pathfinding icon with a disabled symbol is shown. [[File:Pathfinding-disabled-region-1.png|alt=Second Life URL Bar with Pathfinding Disabled Icon|Second Life URL Bar with Pathfinding Disabled Icon]]

=== Rebake Region Button ===

When a region has pending changes, the appropriate icon will be shown in the SLURL bar, as described above. In addition, if the user has build rights for any parcel on the current region, the user will also be able to see a "Rebake region" button that displays above the lower toolbar.

[[File:Rebake-button-1.png|alt=Second Life Rebake Region button that allows permitted users to rebake pathfinding changes into the navmesh]]

When the user clicks this button, a request is sent to the region to rebake the navmesh for the current region. As rebaking a region may be a time intensive process, the button will change to indicate "Region is rebaking" during this server process. After the rebaking is complete, this button on the viewer will vanish.

[[File:Rebaking-button-1.png|alt=Second Life Region is Rebaking button that indicates that the current region is rebaking its navmesh]]

=== Right-click context menu behavior ===

When right-clicking on an object in-world, pathfinding-specific menu options may be included in the pop-up context menu.

If the user right-clicks on a '''linkset''' object in-world, a menu option "Show in linksets" will allow the user to open the Pathfinding Linksets floater with the current object selected.

[[File:Right-click-show-in-linksets-1.png|alt=Second Life Context Menu with Show in Linksets floater menu option]]

If the user right-clicks on a pathfinding '''character''' object in-world, a menu option "Show in characters" will allow the user to open the Pathfinding Characters floater with the current object selected.

[[File:Right-click-show-in-characters-1.png|alt=Second Life Context Menu with Show in Characters floater menu option]]

=== Additional field on the Build floater ===

The Build floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Build floater with a ''character'' object selected.

[[File:Build-floater-character-1.png|alt=Build floater with pathfinding attribute character|Build floater with pathfinding attribute character]]

The following image is a screenshot of the Build floater with an object that ''affects navmesh'' selected. This object could be a ''walkable'', ''static obstacle'', ''material volume'', or ''exclusion volume''.

[[File:Build-floater-affects-navmesh-1.png|alt=Build floater with pathfinding attribute affects navmesh|Build floater with pathfinding attribute affects navmesh]]

{{KBwarning|For linksets that do affect the navmesh, it will be impossible to modify the object across the region boundary. The user and the object affecting a navmesh must be in the same region to enable modification of the object. This will be indicated on the General tab of the Build floater as illustrated in the following screenshot.}}
[[File:Build-floater-region-boundary-1.png|alt=Build floater indicating that the user cannot modify object across a region boundary|Build floater indicating that the user cannot modify object across a region boundary]]

=== Additional field on the Object Profile floater ===

Similar to the afore-described Build floater, the Object Profile floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Object Profile floater with an ''affects navmesh'' object selected.

[[File:Object-profile-1.png|alt=Object Profile floater with pathfinding attribute affects navmesh|Object Profile floater with pathfinding attribute affects navmesh]]

=== Additional simulator metrics on the Statistics floater ===

For advanced users, additional simulator metrics have been added to the Statistics floater. The Statistics floater, available from the main menu Advanced > Performance Tools > Statistics Bar, has the following 3 additional fields reporting statistics from the simulator regarding pathfinding activity:

* '''AI Step Time''' - The average time spent during each frame computing character AI events.
* '''Skipped Silhouette Steps''' - The number of steps that are skipped per second in computing the influence of objects of type ''Movable Obstacles'' on the navmesh. A high value here means that objects on the region are marked as ''Movable Obstacles'' and could be contributing to improper pathfinding behavior on the region. To lower this value, set all objects that do not move to either type ''Walkable'' or ''Static Obstacle'', and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]].
* '''Characters Updated''' - The average percentage of characters updated during each frame. A low value here means that character AI computations are taking too long during each frame, and thus some character updates are skipped during subsequent frames. This could be contributing to improper pathfinding behavior on the region. To increase this value, decrease the number of characters on the region, and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]]. Note that the Pathfinding Characters floater (described below) may also be used to determine which characters on the region are contributing the most to the region's CPU time.

[[File:Pathfinding-stats-2.png|alt=Simulator Statistics floater with additional pathfinding statistics|Simulator Statistics floater with additional pathfinding statistics]]

== Pathfinding Floaters ==

These three pathfinding floaters may all be accessed through the Build->Pathfinding menu in the Project Viewer - Pathfinding.

[[File:Build-menu-pf-selected-1.png|alt=Second Life Build Menu with new Pathfinding menu items|SL Build -> Pathfinding Menu]]

 

=== Pathfinding Linksets Floater ===

==== Overview ====

The intent of the Pathfinding Linksets floater is to give advanced users and builders the ability to customize an area to achieve interesting effects with pathfinding-enabled characters.

The floater displays information for all linksets within the current region for which the user has the ability to alter. The table reports useful information including
* Linkset Name
* Description
* Owner
* Land Impact
* Distance from the resident's avatar
* Linkset Use
** Potential values
*** Walkable
*** Static Obstacle
*** Movable Obstacle
*** Material Volume
*** Exclusion Volume
*** Movable Phantom
* Walkability Coefficients
** Character Type A ''(example use: humanoid)''
** Character Type B ''(example use: creature)''
** Character Type C ''(example use: mechanical)''
** Character Type D ''(example use: other)''

Additionally, selecting any linksets within the floater will also select the object(s) within the Viewer.

[[File:Linksets-floater-2.png|alt=Pathfinding Linksets floater|Pathfinding Linksets]]

 

==== Controls ====

{{:Viewerhelp:Pathfinding linksets}}

==== Example use ====

The advanced users and builders will use the Pathfinding Linksets floater to customize areas to create interesting effects for pathfinding-enabled characters.

For instance, imagine the scenario of a builder constructing a single room in a pathfinding-enabled house. For the single room, the builder would use the following types as follows:

{|border="1"
! Linkset Use !! Description
|-
|width="200" align="center" | Walkable || align="left" | The floor linkset would be set to be Walkable to allow characters to move across the floor.
|-
|width="200" align="center" | Static Obstacle || align="left" | A desk linkset in the room would be set to be Static Obstacle to block characters from walking through or across the object.

NOTE Any object that should block character movement and that does not move should be marked as Static Obstacle to improve performance of pathfinding characters.
|-
|width="200" align="center" | Movable Obstacle || align="left" | A door linkset in the room would be set to be Movable Obstacle. This will still block characters but, in contrast to Static Obstacles, Movable Obstacles will allow the linkset itself to move. In the case of the door, this will allow the door to open and close, but will still prevent characters from walking through the door.
|-
|width="200" align="center" | Material Volume || align="left" | Material Volumes are phantom objects that can be used to affect the walkability coefficients of intersecting objects. Imagine that the builder applied a texture to the floor. Also, imagine that the floor texture includes small throw rug in the middle of the room. (The builder did not want to create a separate object for the rug, so is using a texture on the floor to give the appearance of a rug). The builder can then create a Material Volume object intersecting the floor at the location of the rug. Then, by setting a lower walkability coefficient for the Material Volume, the builder will create the affect of slowing down characters as the characters traverse across the painted rug area.
|-
|width="200" align="center" | Exclusion Volume || align="left" | Exclusion Volumes are phantom objects that can be used to create areas where characters are prevented from moving. For instance, the builder can use an Exclusion Volume to create a section of the room where avatars would be able to move, but characters would be blocked from following.
|-
|width="200" align="center" | Movable Phantom || align="left" | Movable Phantoms are phantom objects that have no affect on pathfinding-enabled characters.
|}
 
In addition to linkset use attributes, builders can achieve additional effects by modifying the walkability coefficients for linksets. The walkability coefficients are values, ranging from 0% to 100%, that affect a characters speed. A walkability coefficient of 50% will reduce a character's speed by half while the character is traversing across the linkset.
 

=== Pathfinding Characters Floater ===

==== Overview ====
The intent of Pathfinding Characters floater is primarily for users to locate characters moving throughout a region and to identify the CPU cost of characters affecting the performance of a region.

The floater displays information for all characters within the current region for which the user has the ability to manipulate. The table reports useful information including
* Character Name
* Description
* Owner
* CPU Time
* Altitude

[[File:Characters-floater-1.png|alt=Pathfinding Characters floater|Pathfinding Characters]]
 
==== Controls ====

{{:Viewerhelp:Pathfinding characters}}

==== Example use ====
# If a region owner has created a pathfinding-enabled character but is unable to find the character within the region, the Characters floater can be used to locate and select the character.
# Additionally, the Pathfinding Characters floater reports the CPU time cost for each character within the region. This functionality can be used by advanced users to identify which characters are impacting performance the most.

=== Pathfinding View/Test Floater ===

==== Overview ====

The intent of the Pathfinding View/Test floater is for advanced users who are building pathfinding-enabled objects and characters.

This floater consists of 3 basic areas.

# Status area (illustrating both the Viewer and Simulator status of the region's navmesh)
# View tab Controls
# Test Path tab Controls

The following image is a screenshot of the Pathfinding View/Test floater with the navmesh displayed.

[[File:View-nav-mesh-1.png|alt=Pathfinding View/Test floater with the navmesh displayed|Pathfinding View/Test with navmesh displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with the pathfinding object types displayed.

[[File:View-pf-types-1.png|alt=Pathfinding View/Test floater with the pathfinding object types displayed|Pathfinding View/Test with the pathfinding object types displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with a test path displayed.

[[File:View-test-path-1.png|alt=Pathfinding View/Test floater with a test path displayed|Pathfinding View/Test with a test path displayed]]

 
==== Controls ====

{{:Viewerhelp:Pathfinding edit and test}}

==== Example Use ====

# The advanced user will use the Visualization controls to visualize how the navmesh and related permanent objects have been generated. By seeing this visualization of how the physics engine interprets the navigation information, the advanced user can understand how to better customize the pathfinding-enabled objects to obtain the desired behaviors of characters.
# The advanced user will use the Test Tab to visualize how a test character would choose the path between selected start and end points.

 

== Known Issues ==

{| style="border-style:solid;border-width:2px 0 2px 0px;"
! style="border-style:solid;border-width:0 0 1px 0" width="130" | JIRA
! style="border-style:solid;border-width:0 0 1px 0" width="300" | Summary
! style="border-style:solid;border-width:0 0 1px 0" width="550" | Hardware
! style="border-style:solid;border-width:0 0 1px 0" width="100" | Fixed in Version
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1291 MAINT-1291]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Enable Debug GL crashes the viewer to the desktop
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac Pro running 10.7.4 with AMD Radeon HD5770 iMac running Mac OS X Lion 10.7.4 (11E53) with AMD Radeon HD 6770M (512 MB) PC Clone running XP Pro with GeForce2 Ultra
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1413 MAINT-1413] [https://jira.secondlife.com/browse/VWR-29491 VWR-29491]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>"Weights Of Selected" never gives any results after pathfinding tools were merged in.</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1414 MAINT-1414] [https://jira.secondlife.com/browse/VWR-29497 VWR-29497]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | User is not able to specify color of object with unchecked 'Apply now' chechbox
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1425 MAINT-1425]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | viewer spams the log with "LLViewerParcelMgr::requestParcelMediaURLFilter: can't get ParcelMediaURLFilterList cap" while editing an object
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1426 MAINT-1426]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Texture repeats/meter reset before you can click Apply button
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-572 PATH-572]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Underwater 'Walkables' shapes are reflected about the water plane
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-643 PATH-643] [https://jira.secondlife.com/browse/PATHBUG-174 PATHBUG-174]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Changes in Preferences dialog stops work of Pathfinding View/Test functionality
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-659 PATH-659]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | navmesh being drawn over worn flexi prims and under avatar
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-790 PATH-790]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Physics capsule rendering of character shapes is broken after zooming
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-812 PATH-812]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Show capsules option creates black capsule instead of blue
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | ATI Radeon X300 Video card ATI Radeon X600 Video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-814 PATH-814]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 laptop displays black environment</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 with AMD Radeon HD5650M Mobile graphics</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-821 PATH-821]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop displays black environment
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop with AMD Radeon HD 4200 Mobile graphics
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-822 PATH-822]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Configuration with ATI Radeon 7500 can launch Viewer, serious GFx issues
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | AMD Athlon64 3000+ with ATI Radeon 7500 video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-826 PATH-826]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Random crash while wearing a mesh avatar and dropping objects in-world</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-842 PATH-842] [https://jira.secondlife.com/browse/VWR-29431 VWR-29431] [https://jira.secondlife.com/browse/MAINT-1362 MAINT-1362]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | TargetOmega object's rotation resets if it changes color in 3.4.0 (262596) Beta
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-849 PATH-849]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Crash in the beta viewer relating to pathfinding
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-852 PATH-852]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Custom cursors fail on mac and linux
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-854 PATH-854]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Add support in the viewer to display the Scripted column on the linksets floater
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-856 PATH-856]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | As a user, I want to see a notification when I am toggling the phantom flag on a linkset through the Pathfinding Linkset floater
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|}

Pathfinding Tools in the Second Life Viewer

2012-08-16T20:44:58Z

Stinson Linden: /* Known Issues */

{{Pathfinding Nav}}
__TOC__
{{KBnote|The Viewer tools described here are available only in the '''Second Life Viewer Beta''' build. Look under the "Other Viewers" section on the [http://secondlife.com/support/downloads/ Second Life Viewer download page]}}
== Introduction ==
For pathfinding, each region has a navigation mesh, commonly referred to as a "'''navmesh'''". The '''navmesh''' is a representation of the region's geometry generated and used by the physics simulator to determine paths for the pathfinding characters. The navmesh may be in one of the following three states:

* Up-to-date
* Has pending changes
* Building ''(a.k.a. rebaking)''

The navmesh will transition through these states according to the following diagram:

[[File:Navmesh_transitions.png|alt=Second Life Pathfinding NavMesh Transitions|Second Life Pathfinding NavMesh Transitions]]

Six new elements have been added to the SL Viewer interface to communicate the navmesh state for the current region. These new elements are:

* icon representations of the pathfinding region state for the SLURL bar
* a "Rebake region" button that appears above the lower toolbar
* a right-click context menu option addition
* an additional field on the Build floater
* an additional field on the Object Profile floater
* additional simulator metrics on the Statistics floater

In addition to these new elements, three new floaters allow users to more efficiently create, visualize, test, and debug pathfinding-enabled characters. These tools are not required to create pathfinding behaviors but are particularly useful to builders and experienced creators in Second Life. These new floaters are:

* Pathfinding linksets
* Pathfinding characters
* Pathfinding view / test

== Pathfinding UI Elements ==

'''Note that other residents editing pathfinding objects on the same region may create pending changes to the navmesh.''' When this occurs, all residents on the same region and with build rights will see the appropriate SLURL bar icons and rebake region button.

=== Pathfinding Icons in SLURL Bar ===

The SLURL bar indicates the three pathfinding states of the current region.
# '''Navmesh is up-to-date''' The current region's navmesh is up-to-date. No icon is shown as this is the expected default state. [[File:Pathfinding-clean-region-1.png|alt=Second Life URL Bar with Up-to-Date NavMesh Icon|Second Life URL Bar with Up-to-Date NavMesh Icon]]
# '''Navmesh has pending changes''' The region has pending changes that have not yet been baked into the navmesh. A pathfinding icon with a construction symbol is shown. [[File:Pathfinding-dirty-region-1.png|alt=Second Life URL Bar with Pending Changes Icon|Second Life URL Bar with Pending Changes Icon]]
# '''Dynamic pathfinding is disabled''' The region has dynamic pathfinding disabled. Pathfinding characters will not work as expected. A pathfinding icon with a disabled symbol is shown. [[File:Pathfinding-disabled-region-1.png|alt=Second Life URL Bar with Pathfinding Disabled Icon|Second Life URL Bar with Pathfinding Disabled Icon]]

=== Rebake Region Button ===

When a region has pending changes, the appropriate icon will be shown in the SLURL bar, as described above. In addition, if the user has build rights for any parcel on the current region, the user will also be able to see a "Rebake region" button that displays above the lower toolbar.

[[File:Rebake-button-1.png|alt=Second Life Rebake Region button that allows permitted users to rebake pathfinding changes into the navmesh]]

When the user clicks this button, a request is sent to the region to rebake the navmesh for the current region. As rebaking a region may be a time intensive process, the button will change to indicate "Region is rebaking" during this server process. After the rebaking is complete, this button on the viewer will vanish.

[[File:Rebaking-button-1.png|alt=Second Life Region is Rebaking button that indicates that the current region is rebaking its navmesh]]

=== Right-click context menu behavior ===

When right-clicking on an object in-world, pathfinding-specific menu options may be included in the pop-up context menu.

If the user right-clicks on a '''linkset''' object in-world, a menu option "Show in linksets" will allow the user to open the Pathfinding Linksets floater with the current object selected.

[[File:Right-click-show-in-linksets-1.png|alt=Second Life Context Menu with Show in Linksets floater menu option]]

If the user right-clicks on a pathfinding '''character''' object in-world, a menu option "Show in characters" will allow the user to open the Pathfinding Characters floater with the current object selected.

[[File:Right-click-show-in-characters-1.png|alt=Second Life Context Menu with Show in Characters floater menu option]]

=== Additional field on the Build floater ===

The Build floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Build floater with a ''character'' object selected.

[[File:Build-floater-character-1.png|alt=Build floater with pathfinding attribute character|Build floater with pathfinding attribute character]]

The following image is a screenshot of the Build floater with an object that ''affects navmesh'' selected. This object could be a ''walkable'', ''static obstacle'', ''material volume'', or ''exclusion volume''.

[[File:Build-floater-affects-navmesh-1.png|alt=Build floater with pathfinding attribute affects navmesh|Build floater with pathfinding attribute affects navmesh]]

{{KBwarning|For linksets that do affect the navmesh, it will be impossible to modify the object across the region boundary. The user and the object affecting a navmesh must be in the same region to enable modification of the object. This will be indicated on the General tab of the Build floater as illustrated in the following screenshot.}}
[[File:Build-floater-region-boundary-1.png|alt=Build floater indicating that the user cannot modify object across a region boundary|Build floater indicating that the user cannot modify object across a region boundary]]

=== Additional field on the Object Profile floater ===

Similar to the afore-described Build floater, the Object Profile floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Object Profile floater with an ''affects navmesh'' object selected.

[[File:Object-profile-1.png|alt=Object Profile floater with pathfinding attribute affects navmesh|Object Profile floater with pathfinding attribute affects navmesh]]

=== Additional simulator metrics on the Statistics floater ===

For advanced users, additional simulator metrics have been added to the Statistics floater. The Statistics floater, available from the main menu Advanced > Performance Tools > Statistics Bar, has the following 3 additional fields reporting statistics from the simulator regarding pathfinding activity:

* '''AI Step Time''' - The average time spent during each frame computing character AI events.
* '''Skipped Silhouette Steps''' - The number of steps that are skipped per second in computing the influence of objects of type ''Movable Obstacles'' on the navmesh. A high value here means that objects on the region are marked as ''Movable Obstacles'' and could be contributing to improper pathfinding behavior on the region. To lower this value, set all objects that do not move to either type ''Walkable'' or ''Static Obstacle'', and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]].
* '''Characters Updated''' - The average percentage of characters updated during each frame. A low value here means that character AI computations are taking too long during each frame, and thus some character updates are skipped during subsequent frames. This could be contributing to improper pathfinding behavior on the region. To increase this value, decrease the number of characters on the region, and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]]. Note that the Pathfinding Characters floater (described below) may also be used to determine which characters on the region are contributing the most to the region's CPU time.

[[File:Pathfinding-stats-2.png|alt=Simulator Statistics floater with additional pathfinding statistics|Simulator Statistics floater with additional pathfinding statistics]]

== Pathfinding Floaters ==

These three pathfinding floaters may all be accessed through the Build->Pathfinding menu in the Project Viewer - Pathfinding.

[[File:Build-menu-pf-selected-1.png|alt=Second Life Build Menu with new Pathfinding menu items|SL Build -> Pathfinding Menu]]

 

=== Pathfinding Linksets Floater ===

==== Overview ====

The intent of the Pathfinding Linksets floater is to give advanced users and builders the ability to customize an area to achieve interesting effects with pathfinding-enabled characters.

The floater displays information for all linksets within the current region for which the user has the ability to alter. The table reports useful information including
* Linkset Name
* Description
* Owner
* Land Impact
* Distance from the resident's avatar
* Linkset Use
** Potential values
*** Walkable
*** Static Obstacle
*** Movable Obstacle
*** Material Volume
*** Exclusion Volume
*** Movable Phantom
* Walkability Coefficients
** Character Type A ''(example use: humanoid)''
** Character Type B ''(example use: creature)''
** Character Type C ''(example use: mechanical)''
** Character Type D ''(example use: other)''

Additionally, selecting any linksets within the floater will also select the object(s) within the Viewer.

[[File:Linksets-floater-2.png|alt=Pathfinding Linksets floater|Pathfinding Linksets]]

 

==== Controls ====

{{:Viewerhelp:Pathfinding linksets}}

==== Example use ====

The advanced users and builders will use the Pathfinding Linksets floater to customize areas to create interesting effects for pathfinding-enabled characters.

For instance, imagine the scenario of a builder constructing a single room in a pathfinding-enabled house. For the single room, the builder would use the following types as follows:

{|border="1"
! Linkset Use !! Description
|-
|width="200" align="center" | Walkable || align="left" | The floor linkset would be set to be Walkable to allow characters to move across the floor.
|-
|width="200" align="center" | Static Obstacle || align="left" | A desk linkset in the room would be set to be Static Obstacle to block characters from walking through or across the object.

NOTE Any object that should block character movement and that does not move should be marked as Static Obstacle to improve performance of pathfinding characters.
|-
|width="200" align="center" | Movable Obstacle || align="left" | A door linkset in the room would be set to be Movable Obstacle. This will still block characters but, in contrast to Static Obstacles, Movable Obstacles will allow the linkset itself to move. In the case of the door, this will allow the door to open and close, but will still prevent characters from walking through the door.
|-
|width="200" align="center" | Material Volume || align="left" | Material Volumes are phantom objects that can be used to affect the walkability coefficients of intersecting objects. Imagine that the builder applied a texture to the floor. Also, imagine that the floor texture includes small throw rug in the middle of the room. (The builder did not want to create a separate object for the rug, so is using a texture on the floor to give the appearance of a rug). The builder can then create a Material Volume object intersecting the floor at the location of the rug. Then, by setting a lower walkability coefficient for the Material Volume, the builder will create the affect of slowing down characters as the characters traverse across the painted rug area.
|-
|width="200" align="center" | Exclusion Volume || align="left" | Exclusion Volumes are phantom objects that can be used to create areas where characters are prevented from moving. For instance, the builder can use an Exclusion Volume to create a section of the room where avatars would be able to move, but characters would be blocked from following.
|-
|width="200" align="center" | Movable Phantom || align="left" | Movable Phantoms are phantom objects that have no affect on pathfinding-enabled characters.
|}
 
In addition to linkset use attributes, builders can achieve additional effects by modifying the walkability coefficients for linksets. The walkability coefficients are values, ranging from 0% to 100%, that affect a characters speed. A walkability coefficient of 50% will reduce a character's speed by half while the character is traversing across the linkset.
 

=== Pathfinding Characters Floater ===

==== Overview ====
The intent of Pathfinding Characters floater is primarily for users to locate characters moving throughout a region and to identify the CPU cost of characters affecting the performance of a region.

The floater displays information for all characters within the current region for which the user has the ability to manipulate. The table reports useful information including
* Character Name
* Description
* Owner
* CPU Time
* Altitude

[[File:Characters-floater-1.png|alt=Pathfinding Characters floater|Pathfinding Characters]]
 
==== Controls ====

{{:Viewerhelp:Pathfinding characters}}

==== Example use ====
# If a region owner has created a pathfinding-enabled character but is unable to find the character within the region, the Characters floater can be used to locate and select the character.
# Additionally, the Pathfinding Characters floater reports the CPU time cost for each character within the region. This functionality can be used by advanced users to identify which characters are impacting performance the most.

=== Pathfinding View/Test Floater ===

==== Overview ====

The intent of the Pathfinding View/Test floater is for advanced users who are building pathfinding-enabled objects and characters.

This floater consists of 3 basic areas.

# Status area (illustrating both the Viewer and Simulator status of the region's navmesh)
# View tab Controls
# Test Path tab Controls

The following image is a screenshot of the Pathfinding View/Test floater with the navmesh displayed.

[[File:View-nav-mesh-1.png|alt=Pathfinding View/Test floater with the navmesh displayed|Pathfinding View/Test with navmesh displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with the pathfinding object types displayed.

[[File:View-pf-types-1.png|alt=Pathfinding View/Test floater with the pathfinding object types displayed|Pathfinding View/Test with the pathfinding object types displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with a test path displayed.

[[File:View-test-path-1.png|alt=Pathfinding View/Test floater with a test path displayed|Pathfinding View/Test with a test path displayed]]

 
==== Controls ====

{{:Viewerhelp:Pathfinding edit and test}}

==== Example Use ====

# The advanced user will use the Visualization controls to visualize how the navmesh and related permanent objects have been generated. By seeing this visualization of how the physics engine interprets the navigation information, the advanced user can understand how to better customize the pathfinding-enabled objects to obtain the desired behaviors of characters.
# The advanced user will use the Test Tab to visualize how a test character would choose the path between selected start and end points.

 

== Known Issues ==

{| style="border-style:solid;border-width:2px 0 2px 0px;"
! style="border-style:solid;border-width:0 0 1px 0" width="130" | JIRA
! style="border-style:solid;border-width:0 0 1px 0" width="500" | Summary
! style="border-style:solid;border-width:0 0 1px 0" | Hardware
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1291 MAINT-1291]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Enable Debug GL crashes the viewer to the desktop
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac Pro running 10.7.4 with AMD Radeon HD5770 iMac running Mac OS X Lion 10.7.4 (11E53) with AMD Radeon HD 6770M (512 MB) PC Clone running XP Pro with GeForce2 Ultra
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1413 MAINT-1413] [https://jira.secondlife.com/browse/VWR-29491 VWR-29491]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | "Weights Of Selected" never gives any results after pathfinding tools were merged in.
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1414 MAINT-1414] [https://jira.secondlife.com/browse/VWR-29497 VWR-29497]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | User is not able to specify color of object with unchecked 'Apply now' chechbox
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1425 MAINT-1425]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | viewer spams the log with "LLViewerParcelMgr::requestParcelMediaURLFilter: can't get ParcelMediaURLFilterList cap" while editing an object
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1426 MAINT-1426]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Texture repeats/meter reset before you can click Apply button
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-572 PATH-572]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Underwater 'Walkables' shapes are reflected about the water plane
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-643 PATH-643] [https://jira.secondlife.com/browse/PATHBUG-174 PATHBUG-174]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Changes in Preferences dialog stops work of Pathfinding View/Test functionality
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-659 PATH-659]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | navmesh being drawn over worn flexi prims and under avatar
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-790 PATH-790]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Physics capsule rendering of character shapes is broken after zooming
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-812 PATH-812]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Show capsules option creates black capsule instead of blue
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | ATI Radeon X300 Video card ATI Radeon X600 Video card
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-814 PATH-814]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 laptop displays black environment</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 with AMD Radeon HD5650M Mobile graphics</del>
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-821 PATH-821]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop displays black environment
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop with AMD Radeon HD 4200 Mobile graphics
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-822 PATH-822]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Configuration with ATI Radeon 7500 can launch Viewer, serious GFx issues
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | AMD Athlon64 3000+ with ATI Radeon 7500 video card
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-826 PATH-826]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Random crash while wearing a mesh avatar and dropping objects in-world</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-842 PATH-842] [https://jira.secondlife.com/browse/VWR-29431 VWR-29431] [https://jira.secondlife.com/browse/MAINT-1362 MAINT-1362]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | TargetOmega object's rotation resets if it changes color in 3.4.0 (262596) Beta
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-849 PATH-849]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Crash in the beta viewer relating to pathfinding
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-852 PATH-852]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Custom cursors fail on mac and linux
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-854 PATH-854]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Add support in the viewer to display the Scripted column on the linksets floater
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-856 PATH-856]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | As a user, I want to see a notification when I am toggling the phantom flag on a linkset through the Pathfinding Linkset floater
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|}

Pathfinding Tools in the Second Life Viewer

2012-08-15T02:49:23Z

Stinson Linden: /* Known Issues */

{{Pathfinding Nav}}
__TOC__
{{KBnote|The Viewer tools described here are available only in the '''Second Life Viewer Beta''' build. Look under the "Other Viewers" section on the [http://secondlife.com/support/downloads/ Second Life Viewer download page]}}
== Introduction ==
For pathfinding, each region has a navigation mesh, commonly referred to as a "'''navmesh'''". The '''navmesh''' is a representation of the region's geometry generated and used by the physics simulator to determine paths for the pathfinding characters. The navmesh may be in one of the following three states:

* Up-to-date
* Has pending changes
* Building ''(a.k.a. rebaking)''

The navmesh will transition through these states according to the following diagram:

[[File:Navmesh_transitions.png|alt=Second Life Pathfinding NavMesh Transitions|Second Life Pathfinding NavMesh Transitions]]

Six new elements have been added to the SL Viewer interface to communicate the navmesh state for the current region. These new elements are:

* icon representations of the pathfinding region state for the SLURL bar
* a "Rebake region" button that appears above the lower toolbar
* a right-click context menu option addition
* an additional field on the Build floater
* an additional field on the Object Profile floater
* additional simulator metrics on the Statistics floater

In addition to these new elements, three new floaters allow users to more efficiently create, visualize, test, and debug pathfinding-enabled characters. These tools are not required to create pathfinding behaviors but are particularly useful to builders and experienced creators in Second Life. These new floaters are:

* Pathfinding linksets
* Pathfinding characters
* Pathfinding view / test

== Pathfinding UI Elements ==

'''Note that other residents editing pathfinding objects on the same region may create pending changes to the navmesh.''' When this occurs, all residents on the same region and with build rights will see the appropriate SLURL bar icons and rebake region button.

=== Pathfinding Icons in SLURL Bar ===

The SLURL bar indicates the three pathfinding states of the current region.
# '''Navmesh is up-to-date''' The current region's navmesh is up-to-date. No icon is shown as this is the expected default state. [[File:Pathfinding-clean-region-1.png|alt=Second Life URL Bar with Up-to-Date NavMesh Icon|Second Life URL Bar with Up-to-Date NavMesh Icon]]
# '''Navmesh has pending changes''' The region has pending changes that have not yet been baked into the navmesh. A pathfinding icon with a construction symbol is shown. [[File:Pathfinding-dirty-region-1.png|alt=Second Life URL Bar with Pending Changes Icon|Second Life URL Bar with Pending Changes Icon]]
# '''Dynamic pathfinding is disabled''' The region has dynamic pathfinding disabled. Pathfinding characters will not work as expected. A pathfinding icon with a disabled symbol is shown. [[File:Pathfinding-disabled-region-1.png|alt=Second Life URL Bar with Pathfinding Disabled Icon|Second Life URL Bar with Pathfinding Disabled Icon]]

=== Rebake Region Button ===

When a region has pending changes, the appropriate icon will be shown in the SLURL bar, as described above. In addition, if the user has build rights for any parcel on the current region, the user will also be able to see a "Rebake region" button that displays above the lower toolbar.

[[File:Rebake-button-1.png|alt=Second Life Rebake Region button that allows permitted users to rebake pathfinding changes into the navmesh]]

When the user clicks this button, a request is sent to the region to rebake the navmesh for the current region. As rebaking a region may be a time intensive process, the button will change to indicate "Region is rebaking" during this server process. After the rebaking is complete, this button on the viewer will vanish.

[[File:Rebaking-button-1.png|alt=Second Life Region is Rebaking button that indicates that the current region is rebaking its navmesh]]

=== Right-click context menu behavior ===

When right-clicking on an object in-world, pathfinding-specific menu options may be included in the pop-up context menu.

If the user right-clicks on a '''linkset''' object in-world, a menu option "Show in linksets" will allow the user to open the Pathfinding Linksets floater with the current object selected.

[[File:Right-click-show-in-linksets-1.png|alt=Second Life Context Menu with Show in Linksets floater menu option]]

If the user right-clicks on a pathfinding '''character''' object in-world, a menu option "Show in characters" will allow the user to open the Pathfinding Characters floater with the current object selected.

[[File:Right-click-show-in-characters-1.png|alt=Second Life Context Menu with Show in Characters floater menu option]]

=== Additional field on the Build floater ===

The Build floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Build floater with a ''character'' object selected.

[[File:Build-floater-character-1.png|alt=Build floater with pathfinding attribute character|Build floater with pathfinding attribute character]]

The following image is a screenshot of the Build floater with an object that ''affects navmesh'' selected. This object could be a ''walkable'', ''static obstacle'', ''material volume'', or ''exclusion volume''.

[[File:Build-floater-affects-navmesh-1.png|alt=Build floater with pathfinding attribute affects navmesh|Build floater with pathfinding attribute affects navmesh]]

{{KBwarning|For linksets that do affect the navmesh, it will be impossible to modify the object across the region boundary. The user and the object affecting a navmesh must be in the same region to enable modification of the object. This will be indicated on the General tab of the Build floater as illustrated in the following screenshot.}}
[[File:Build-floater-region-boundary-1.png|alt=Build floater indicating that the user cannot modify object across a region boundary|Build floater indicating that the user cannot modify object across a region boundary]]

=== Additional field on the Object Profile floater ===

Similar to the afore-described Build floater, the Object Profile floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Object Profile floater with an ''affects navmesh'' object selected.

[[File:Object-profile-1.png|alt=Object Profile floater with pathfinding attribute affects navmesh|Object Profile floater with pathfinding attribute affects navmesh]]

=== Additional simulator metrics on the Statistics floater ===

For advanced users, additional simulator metrics have been added to the Statistics floater. The Statistics floater, available from the main menu Advanced > Performance Tools > Statistics Bar, has the following 3 additional fields reporting statistics from the simulator regarding pathfinding activity:

* '''AI Step Time''' - The average time spent during each frame computing character AI events.
* '''Skipped Silhouette Steps''' - The number of steps that are skipped per second in computing the influence of objects of type ''Movable Obstacles'' on the navmesh. A high value here means that objects on the region are marked as ''Movable Obstacles'' and could be contributing to improper pathfinding behavior on the region. To lower this value, set all objects that do not move to either type ''Walkable'' or ''Static Obstacle'', and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]].
* '''Characters Updated''' - The average percentage of characters updated during each frame. A low value here means that character AI computations are taking too long during each frame, and thus some character updates are skipped during subsequent frames. This could be contributing to improper pathfinding behavior on the region. To increase this value, decrease the number of characters on the region, and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]]. Note that the Pathfinding Characters floater (described below) may also be used to determine which characters on the region are contributing the most to the region's CPU time.

[[File:Pathfinding-stats-2.png|alt=Simulator Statistics floater with additional pathfinding statistics|Simulator Statistics floater with additional pathfinding statistics]]

== Pathfinding Floaters ==

These three pathfinding floaters may all be accessed through the Build->Pathfinding menu in the Project Viewer - Pathfinding.

[[File:Build-menu-pf-selected-1.png|alt=Second Life Build Menu with new Pathfinding menu items|SL Build -> Pathfinding Menu]]

 

=== Pathfinding Linksets Floater ===

==== Overview ====

The intent of the Pathfinding Linksets floater is to give advanced users and builders the ability to customize an area to achieve interesting effects with pathfinding-enabled characters.

The floater displays information for all linksets within the current region for which the user has the ability to alter. The table reports useful information including
* Linkset Name
* Description
* Owner
* Land Impact
* Distance from the resident's avatar
* Linkset Use
** Potential values
*** Walkable
*** Static Obstacle
*** Movable Obstacle
*** Material Volume
*** Exclusion Volume
*** Movable Phantom
* Walkability Coefficients
** Character Type A ''(example use: humanoid)''
** Character Type B ''(example use: creature)''
** Character Type C ''(example use: mechanical)''
** Character Type D ''(example use: other)''

Additionally, selecting any linksets within the floater will also select the object(s) within the Viewer.

[[File:Linksets-floater-2.png|alt=Pathfinding Linksets floater|Pathfinding Linksets]]

 

==== Controls ====

{{:Viewerhelp:Pathfinding linksets}}

==== Example use ====

The advanced users and builders will use the Pathfinding Linksets floater to customize areas to create interesting effects for pathfinding-enabled characters.

For instance, imagine the scenario of a builder constructing a single room in a pathfinding-enabled house. For the single room, the builder would use the following types as follows:

{|border="1"
! Linkset Use !! Description
|-
|width="200" align="center" | Walkable || align="left" | The floor linkset would be set to be Walkable to allow characters to move across the floor.
|-
|width="200" align="center" | Static Obstacle || align="left" | A desk linkset in the room would be set to be Static Obstacle to block characters from walking through or across the object.

NOTE Any object that should block character movement and that does not move should be marked as Static Obstacle to improve performance of pathfinding characters.
|-
|width="200" align="center" | Movable Obstacle || align="left" | A door linkset in the room would be set to be Movable Obstacle. This will still block characters but, in contrast to Static Obstacles, Movable Obstacles will allow the linkset itself to move. In the case of the door, this will allow the door to open and close, but will still prevent characters from walking through the door.
|-
|width="200" align="center" | Material Volume || align="left" | Material Volumes are phantom objects that can be used to affect the walkability coefficients of intersecting objects. Imagine that the builder applied a texture to the floor. Also, imagine that the floor texture includes small throw rug in the middle of the room. (The builder did not want to create a separate object for the rug, so is using a texture on the floor to give the appearance of a rug). The builder can then create a Material Volume object intersecting the floor at the location of the rug. Then, by setting a lower walkability coefficient for the Material Volume, the builder will create the affect of slowing down characters as the characters traverse across the painted rug area.
|-
|width="200" align="center" | Exclusion Volume || align="left" | Exclusion Volumes are phantom objects that can be used to create areas where characters are prevented from moving. For instance, the builder can use an Exclusion Volume to create a section of the room where avatars would be able to move, but characters would be blocked from following.
|-
|width="200" align="center" | Movable Phantom || align="left" | Movable Phantoms are phantom objects that have no affect on pathfinding-enabled characters.
|}
 
In addition to linkset use attributes, builders can achieve additional effects by modifying the walkability coefficients for linksets. The walkability coefficients are values, ranging from 0% to 100%, that affect a characters speed. A walkability coefficient of 50% will reduce a character's speed by half while the character is traversing across the linkset.
 

=== Pathfinding Characters Floater ===

==== Overview ====
The intent of Pathfinding Characters floater is primarily for users to locate characters moving throughout a region and to identify the CPU cost of characters affecting the performance of a region.

The floater displays information for all characters within the current region for which the user has the ability to manipulate. The table reports useful information including
* Character Name
* Description
* Owner
* CPU Time
* Altitude

[[File:Characters-floater-1.png|alt=Pathfinding Characters floater|Pathfinding Characters]]
 
==== Controls ====

{{:Viewerhelp:Pathfinding characters}}

==== Example use ====
# If a region owner has created a pathfinding-enabled character but is unable to find the character within the region, the Characters floater can be used to locate and select the character.
# Additionally, the Pathfinding Characters floater reports the CPU time cost for each character within the region. This functionality can be used by advanced users to identify which characters are impacting performance the most.

=== Pathfinding View/Test Floater ===

==== Overview ====

The intent of the Pathfinding View/Test floater is for advanced users who are building pathfinding-enabled objects and characters.

This floater consists of 3 basic areas.

# Status area (illustrating both the Viewer and Simulator status of the region's navmesh)
# View tab Controls
# Test Path tab Controls

The following image is a screenshot of the Pathfinding View/Test floater with the navmesh displayed.

[[File:View-nav-mesh-1.png|alt=Pathfinding View/Test floater with the navmesh displayed|Pathfinding View/Test with navmesh displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with the pathfinding object types displayed.

[[File:View-pf-types-1.png|alt=Pathfinding View/Test floater with the pathfinding object types displayed|Pathfinding View/Test with the pathfinding object types displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with a test path displayed.

[[File:View-test-path-1.png|alt=Pathfinding View/Test floater with a test path displayed|Pathfinding View/Test with a test path displayed]]

 
==== Controls ====

{{:Viewerhelp:Pathfinding edit and test}}

==== Example Use ====

# The advanced user will use the Visualization controls to visualize how the navmesh and related permanent objects have been generated. By seeing this visualization of how the physics engine interprets the navigation information, the advanced user can understand how to better customize the pathfinding-enabled objects to obtain the desired behaviors of characters.
# The advanced user will use the Test Tab to visualize how a test character would choose the path between selected start and end points.

 

== Known Issues ==

{| style="border-style:solid;border-width:2px 0 2px 0px;"
! style="border-style:solid;border-width:0 0 1px 0" width="130" | JIRA
! style="border-style:solid;border-width:0 0 1px 0" width="500" | Summary
! style="border-style:solid;border-width:0 0 1px 0" | Hardware
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1413 MAINT-1413] [https://jira.secondlife.com/browse/VWR-29491 VWR-29491]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | "Weights Of Selected" never gives any results after pathfinding tools were merged in.
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1425 MAINT-1425]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | viewer spams the log with "LLViewerParcelMgr::requestParcelMediaURLFilter: can't get ParcelMediaURLFilterList cap" while editing an object
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1426 MAINT-1426]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Texture repeats/meter reset before you can click Apply button
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-572 PATH-572]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Underwater 'Walkables' shapes are reflected about the water plane
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-643 PATH-643] [https://jira.secondlife.com/browse/PATHBUG-174 PATHBUG-174]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Changes in Preferences dialog stops work of Pathfinding View/Test functionality
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-659 PATH-659]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | navmesh being drawn over worn flexi prims and under avatar
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-790 PATH-790]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Physics capsule rendering of character shapes is broken after zooming
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-812 PATH-812]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Show capsules option creates black capsule instead of blue
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | ATI Radeon X300 Video card ATI Radeon X600 Video card
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-814 PATH-814]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 laptop displays black environment</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 with AMD Radeon HD5650M Mobile graphics</del>
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-821 PATH-821]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop displays black environment
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop with AMD Radeon HD 4200 Mobile graphics
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-822 PATH-822]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Configuration with ATI Radeon 7500 can launch Viewer, serious GFx issues
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | AMD Athlon64 3000+ with ATI Radeon 7500 video card
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-826 PATH-826]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Random crash while wearing a mesh avatar and dropping objects in-world</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-842 PATH-842] [https://jira.secondlife.com/browse/VWR-29431 VWR-29431] [https://jira.secondlife.com/browse/MAINT-1362 MAINT-1362]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | TargetOmega object's rotation resets if it changes color in 3.4.0 (262596) Beta
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-849 PATH-849]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Crash in the beta viewer relating to pathfinding
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-852 PATH-852]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Custom cursors fail on mac and linux
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-854 PATH-854]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Add support in the viewer to display the Scripted column on the linksets floater
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-856 PATH-856]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | As a user, I want to see a notification when I am toggling the phantom flag on a linkset through the Pathfinding Linkset floater
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1291 MAINT-1291]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Enable Debug GL crashes the viewer to the desktop
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac Pro running 10.7.4 with AMD Radeon HD5770 iMac running Mac OS X Lion 10.7.4 (11E53) with AMD Radeon HD 6770M (512 MB) PC Clone running XP Pro with GeForce2 Ultra
|}

Pathfinding Tools in the Second Life Viewer

2012-08-15T01:18:20Z

Stinson Linden: /* Known Issues */

{{Pathfinding Nav}}
__TOC__
{{KBnote|The Viewer tools described here are available only in the '''Second Life Viewer Beta''' build. Look under the "Other Viewers" section on the [http://secondlife.com/support/downloads/ Second Life Viewer download page]}}
== Introduction ==
For pathfinding, each region has a navigation mesh, commonly referred to as a "'''navmesh'''". The '''navmesh''' is a representation of the region's geometry generated and used by the physics simulator to determine paths for the pathfinding characters. The navmesh may be in one of the following three states:

* Up-to-date
* Has pending changes
* Building ''(a.k.a. rebaking)''

The navmesh will transition through these states according to the following diagram:

[[File:Navmesh_transitions.png|alt=Second Life Pathfinding NavMesh Transitions|Second Life Pathfinding NavMesh Transitions]]

Six new elements have been added to the SL Viewer interface to communicate the navmesh state for the current region. These new elements are:

* icon representations of the pathfinding region state for the SLURL bar
* a "Rebake region" button that appears above the lower toolbar
* a right-click context menu option addition
* an additional field on the Build floater
* an additional field on the Object Profile floater
* additional simulator metrics on the Statistics floater

In addition to these new elements, three new floaters allow users to more efficiently create, visualize, test, and debug pathfinding-enabled characters. These tools are not required to create pathfinding behaviors but are particularly useful to builders and experienced creators in Second Life. These new floaters are:

* Pathfinding linksets
* Pathfinding characters
* Pathfinding view / test

== Pathfinding UI Elements ==

'''Note that other residents editing pathfinding objects on the same region may create pending changes to the navmesh.''' When this occurs, all residents on the same region and with build rights will see the appropriate SLURL bar icons and rebake region button.

=== Pathfinding Icons in SLURL Bar ===

The SLURL bar indicates the three pathfinding states of the current region.
# '''Navmesh is up-to-date''' The current region's navmesh is up-to-date. No icon is shown as this is the expected default state. [[File:Pathfinding-clean-region-1.png|alt=Second Life URL Bar with Up-to-Date NavMesh Icon|Second Life URL Bar with Up-to-Date NavMesh Icon]]
# '''Navmesh has pending changes''' The region has pending changes that have not yet been baked into the navmesh. A pathfinding icon with a construction symbol is shown. [[File:Pathfinding-dirty-region-1.png|alt=Second Life URL Bar with Pending Changes Icon|Second Life URL Bar with Pending Changes Icon]]
# '''Dynamic pathfinding is disabled''' The region has dynamic pathfinding disabled. Pathfinding characters will not work as expected. A pathfinding icon with a disabled symbol is shown. [[File:Pathfinding-disabled-region-1.png|alt=Second Life URL Bar with Pathfinding Disabled Icon|Second Life URL Bar with Pathfinding Disabled Icon]]

=== Rebake Region Button ===

When a region has pending changes, the appropriate icon will be shown in the SLURL bar, as described above. In addition, if the user has build rights for any parcel on the current region, the user will also be able to see a "Rebake region" button that displays above the lower toolbar.

[[File:Rebake-button-1.png|alt=Second Life Rebake Region button that allows permitted users to rebake pathfinding changes into the navmesh]]

When the user clicks this button, a request is sent to the region to rebake the navmesh for the current region. As rebaking a region may be a time intensive process, the button will change to indicate "Region is rebaking" during this server process. After the rebaking is complete, this button on the viewer will vanish.

[[File:Rebaking-button-1.png|alt=Second Life Region is Rebaking button that indicates that the current region is rebaking its navmesh]]

=== Right-click context menu behavior ===

When right-clicking on an object in-world, pathfinding-specific menu options may be included in the pop-up context menu.

If the user right-clicks on a '''linkset''' object in-world, a menu option "Show in linksets" will allow the user to open the Pathfinding Linksets floater with the current object selected.

[[File:Right-click-show-in-linksets-1.png|alt=Second Life Context Menu with Show in Linksets floater menu option]]

If the user right-clicks on a pathfinding '''character''' object in-world, a menu option "Show in characters" will allow the user to open the Pathfinding Characters floater with the current object selected.

[[File:Right-click-show-in-characters-1.png|alt=Second Life Context Menu with Show in Characters floater menu option]]

=== Additional field on the Build floater ===

The Build floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Build floater with a ''character'' object selected.

[[File:Build-floater-character-1.png|alt=Build floater with pathfinding attribute character|Build floater with pathfinding attribute character]]

The following image is a screenshot of the Build floater with an object that ''affects navmesh'' selected. This object could be a ''walkable'', ''static obstacle'', ''material volume'', or ''exclusion volume''.

[[File:Build-floater-affects-navmesh-1.png|alt=Build floater with pathfinding attribute affects navmesh|Build floater with pathfinding attribute affects navmesh]]

{{KBwarning|For linksets that do affect the navmesh, it will be impossible to modify the object across the region boundary. The user and the object affecting a navmesh must be in the same region to enable modification of the object. This will be indicated on the General tab of the Build floater as illustrated in the following screenshot.}}
[[File:Build-floater-region-boundary-1.png|alt=Build floater indicating that the user cannot modify object across a region boundary|Build floater indicating that the user cannot modify object across a region boundary]]

=== Additional field on the Object Profile floater ===

Similar to the afore-described Build floater, the Object Profile floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Object Profile floater with an ''affects navmesh'' object selected.

[[File:Object-profile-1.png|alt=Object Profile floater with pathfinding attribute affects navmesh|Object Profile floater with pathfinding attribute affects navmesh]]

=== Additional simulator metrics on the Statistics floater ===

For advanced users, additional simulator metrics have been added to the Statistics floater. The Statistics floater, available from the main menu Advanced > Performance Tools > Statistics Bar, has the following 3 additional fields reporting statistics from the simulator regarding pathfinding activity:

* '''AI Step Time''' - The average time spent during each frame computing character AI events.
* '''Skipped Silhouette Steps''' - The number of steps that are skipped per second in computing the influence of objects of type ''Movable Obstacles'' on the navmesh. A high value here means that objects on the region are marked as ''Movable Obstacles'' and could be contributing to improper pathfinding behavior on the region. To lower this value, set all objects that do not move to either type ''Walkable'' or ''Static Obstacle'', and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]].
* '''Characters Updated''' - The average percentage of characters updated during each frame. A low value here means that character AI computations are taking too long during each frame, and thus some character updates are skipped during subsequent frames. This could be contributing to improper pathfinding behavior on the region. To increase this value, decrease the number of characters on the region, and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]]. Note that the Pathfinding Characters floater (described below) may also be used to determine which characters on the region are contributing the most to the region's CPU time.

[[File:Pathfinding-stats-2.png|alt=Simulator Statistics floater with additional pathfinding statistics|Simulator Statistics floater with additional pathfinding statistics]]

== Pathfinding Floaters ==

These three pathfinding floaters may all be accessed through the Build->Pathfinding menu in the Project Viewer - Pathfinding.

[[File:Build-menu-pf-selected-1.png|alt=Second Life Build Menu with new Pathfinding menu items|SL Build -> Pathfinding Menu]]

 

=== Pathfinding Linksets Floater ===

==== Overview ====

The intent of the Pathfinding Linksets floater is to give advanced users and builders the ability to customize an area to achieve interesting effects with pathfinding-enabled characters.

The floater displays information for all linksets within the current region for which the user has the ability to alter. The table reports useful information including
* Linkset Name
* Description
* Owner
* Land Impact
* Distance from the resident's avatar
* Linkset Use
** Potential values
*** Walkable
*** Static Obstacle
*** Movable Obstacle
*** Material Volume
*** Exclusion Volume
*** Movable Phantom
* Walkability Coefficients
** Character Type A ''(example use: humanoid)''
** Character Type B ''(example use: creature)''
** Character Type C ''(example use: mechanical)''
** Character Type D ''(example use: other)''

Additionally, selecting any linksets within the floater will also select the object(s) within the Viewer.

[[File:Linksets-floater-2.png|alt=Pathfinding Linksets floater|Pathfinding Linksets]]

 

==== Controls ====

{{:Viewerhelp:Pathfinding linksets}}

==== Example use ====

The advanced users and builders will use the Pathfinding Linksets floater to customize areas to create interesting effects for pathfinding-enabled characters.

For instance, imagine the scenario of a builder constructing a single room in a pathfinding-enabled house. For the single room, the builder would use the following types as follows:

{|border="1"
! Linkset Use !! Description
|-
|width="200" align="center" | Walkable || align="left" | The floor linkset would be set to be Walkable to allow characters to move across the floor.
|-
|width="200" align="center" | Static Obstacle || align="left" | A desk linkset in the room would be set to be Static Obstacle to block characters from walking through or across the object.

NOTE Any object that should block character movement and that does not move should be marked as Static Obstacle to improve performance of pathfinding characters.
|-
|width="200" align="center" | Movable Obstacle || align="left" | A door linkset in the room would be set to be Movable Obstacle. This will still block characters but, in contrast to Static Obstacles, Movable Obstacles will allow the linkset itself to move. In the case of the door, this will allow the door to open and close, but will still prevent characters from walking through the door.
|-
|width="200" align="center" | Material Volume || align="left" | Material Volumes are phantom objects that can be used to affect the walkability coefficients of intersecting objects. Imagine that the builder applied a texture to the floor. Also, imagine that the floor texture includes small throw rug in the middle of the room. (The builder did not want to create a separate object for the rug, so is using a texture on the floor to give the appearance of a rug). The builder can then create a Material Volume object intersecting the floor at the location of the rug. Then, by setting a lower walkability coefficient for the Material Volume, the builder will create the affect of slowing down characters as the characters traverse across the painted rug area.
|-
|width="200" align="center" | Exclusion Volume || align="left" | Exclusion Volumes are phantom objects that can be used to create areas where characters are prevented from moving. For instance, the builder can use an Exclusion Volume to create a section of the room where avatars would be able to move, but characters would be blocked from following.
|-
|width="200" align="center" | Movable Phantom || align="left" | Movable Phantoms are phantom objects that have no affect on pathfinding-enabled characters.
|}
 
In addition to linkset use attributes, builders can achieve additional effects by modifying the walkability coefficients for linksets. The walkability coefficients are values, ranging from 0% to 100%, that affect a characters speed. A walkability coefficient of 50% will reduce a character's speed by half while the character is traversing across the linkset.
 

=== Pathfinding Characters Floater ===

==== Overview ====
The intent of Pathfinding Characters floater is primarily for users to locate characters moving throughout a region and to identify the CPU cost of characters affecting the performance of a region.

The floater displays information for all characters within the current region for which the user has the ability to manipulate. The table reports useful information including
* Character Name
* Description
* Owner
* CPU Time
* Altitude

[[File:Characters-floater-1.png|alt=Pathfinding Characters floater|Pathfinding Characters]]
 
==== Controls ====

{{:Viewerhelp:Pathfinding characters}}

==== Example use ====
# If a region owner has created a pathfinding-enabled character but is unable to find the character within the region, the Characters floater can be used to locate and select the character.
# Additionally, the Pathfinding Characters floater reports the CPU time cost for each character within the region. This functionality can be used by advanced users to identify which characters are impacting performance the most.

=== Pathfinding View/Test Floater ===

==== Overview ====

The intent of the Pathfinding View/Test floater is for advanced users who are building pathfinding-enabled objects and characters.

This floater consists of 3 basic areas.

# Status area (illustrating both the Viewer and Simulator status of the region's navmesh)
# View tab Controls
# Test Path tab Controls

The following image is a screenshot of the Pathfinding View/Test floater with the navmesh displayed.

[[File:View-nav-mesh-1.png|alt=Pathfinding View/Test floater with the navmesh displayed|Pathfinding View/Test with navmesh displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with the pathfinding object types displayed.

[[File:View-pf-types-1.png|alt=Pathfinding View/Test floater with the pathfinding object types displayed|Pathfinding View/Test with the pathfinding object types displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with a test path displayed.

[[File:View-test-path-1.png|alt=Pathfinding View/Test floater with a test path displayed|Pathfinding View/Test with a test path displayed]]

 
==== Controls ====

{{:Viewerhelp:Pathfinding edit and test}}

==== Example Use ====

# The advanced user will use the Visualization controls to visualize how the navmesh and related permanent objects have been generated. By seeing this visualization of how the physics engine interprets the navigation information, the advanced user can understand how to better customize the pathfinding-enabled objects to obtain the desired behaviors of characters.
# The advanced user will use the Test Tab to visualize how a test character would choose the path between selected start and end points.

 

== Known Issues ==

{| style="border-style:solid;border-width:2px 0 2px 0px;"
! style="border-style:solid;border-width:0 0 1px 0" width="130" | JIRA
! style="border-style:solid;border-width:0 0 1px 0" width="500" | Summary
! style="border-style:solid;border-width:0 0 1px 0" | Hardware
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-572 PATH-572]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Underwater 'Walkables' shapes are reflected about the water plane
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-643 PATH-643] [https://jira.secondlife.com/browse/PATHBUG-174 PATHBUG-174]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Changes in Preferences dialog stops work of Pathfinding View/Test functionality
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-659 PATH-659]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | navmesh being drawn over worn flexi prims and under avatar
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-790 PATH-790]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Physics capsule rendering of character shapes is broken after zooming
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-812 PATH-812]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Show capsules option creates black capsule instead of blue
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | ATI Radeon X300 Video card ATI Radeon X600 Video card
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-814 PATH-814]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 laptop displays black environment</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 with AMD Radeon HD5650M Mobile graphics</del>
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-821 PATH-821]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop displays black environment
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop with AMD Radeon HD 4200 Mobile graphics
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-822 PATH-822]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Configuration with ATI Radeon 7500 can launch Viewer, serious GFx issues
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | AMD Athlon64 3000+ with ATI Radeon 7500 video card
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-826 PATH-826]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Random crash while wearing a mesh avatar and dropping objects in-world</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-842 PATH-842] [https://jira.secondlife.com/browse/VWR-29431 VWR-29431] [https://jira.secondlife.com/browse/MAINT-1362 MAINT-1362]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | TargetOmega object's rotation resets if it changes color in 3.4.0 (262596) Beta
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-849 PATH-849]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Crash in the beta viewer relating to pathfinding
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-852 PATH-852]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Custom cursors fail on mac and linux
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-854 PATH-854]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Add support in the viewer to display the Scripted column on the linksets floater
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-856 PATH-856]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | As a user, I want to see a notification when I am toggling the phantom flag on a linkset through the Pathfinding Linkset floater
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1291 MAINT-1291]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Enable Debug GL crashes the viewer to the desktop
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac Pro running 10.7.4 with AMD Radeon HD5770 iMac running Mac OS X Lion 10.7.4 (11E53) with AMD Radeon HD 6770M (512 MB) PC Clone running XP Pro with GeForce2 Ultra
|}

Template:Pathfinding alpha

2012-08-10T20:43:33Z

Stinson Linden:

[[Category:Pathfinding]]{{#vardefine:moded|fr{{#var:moded}}}}

Viewerhelp:Pathfinding linksets

2012-08-07T02:18:11Z

Stinson Linden: /* Notes */

'''Filter by''':
{{UIgroup|
{{UIref| Filter by Name | Enter text by which to filter the linkset list based on Name attribute. }}
{{UIref| Filter by Description | Enter text by which to filter the linkset based on the Description attribute.}}
{{UIref| Filter by linkset use... | Click to display only the linksets that match selected use.}}
{{UIref| Apply | Click to apply the filters to the linkset list.}}
{{UIref| Clear | Click to clear the filters and return the linkset list back to the original un-filtered contents.}}
}}
{{UIref| Refresh list | Click to refresh the linkset list from the server. Use after you add or delete a linkset inworld.}}
{{UIref| Select all | Click to select all linksets in the list.}}
{{UIref| Select none | Click to deselect all selected linksets in the list.}}
{{UIref| Show Beacon | Select to display a beacon indicating the inworld location of each selected linkset. Use to locate hard-to-find or invisible linksets in the region. }}
{{UIref| Take | Click to take the selected linkset(s) into your inventory.}}
{{UIref| Take Copy | Click to take a copy of the selected linkset(s) into your inventory.}}
{{UIref| Teleport Me To It | Teleports you to the selected linkset. Useful to find faraway linksets. Note this button is only enabled when you have selected one linkset.}}
{{UIref| Return | Click to returns the selected linkset(s) to the owner's inventory.}}
{{UIref| Delete | Click to delete the selected linkset(s) from the region.}}
{{UIref| Choose Linkset Use | Change the linkset use attribute of the selected linkset(s).}}
{{UIref| Walkability Coefficients | Enter individual walkability coefficients for each character type (A, B, C, D).

Walkability coefficients range from 0% to 100% to determine the influence the effect the linkset has on a character's speed while the character is traversing across the linkset object.

For example, a linkset with Walkability Coefficient of 50% for character type A will cause characters of type A to reduce their speed by half while the character is traversing the object.}}
{{UIref| Apply Changes | Click to apply changes to the selected linkset(s) use type and/or walkability coefficients.}}

====Notes====
* For linksets with use fields marked as "[restricted]", only certain linkset use modes are available. This restriction is the result of the object not having modifiable permission enabled for the user.

* For linksets with use fields marked as "[concave]", the linkset use modes for Material Volume and Exclusion Volume are not available. This restriction is the result of the shape object not being convex. All pathfinding volumes '''must''' be convex.

* The "[Terrain]" linkset is available to be viewed and edited by the estate managers only. Additionally, while the walkability coefficients for the "[Terrain]" linkset are modifiable by estate managers, the Linkset Use field of "[Terrain]" linkset is not modifiable by anyone and will always be "Walkable".

Pathfinding Tools in the Second Life Viewer

2012-08-07T02:12:03Z

Stinson Linden: /* Introduction */

Pathfinding Tools in the Second Life Viewer

2012-08-07T02:11:08Z

Stinson Linden: /* Additional statics on the Statistics floater */

Pathfinding Tools in the Second Life Viewer

2012-08-07T02:10:31Z

Stinson Linden: /* Additional statics on the Simulator Statistics floater */

Pathfinding Tools in the Second Life Viewer

2012-08-07T02:09:50Z

Stinson Linden: /* Pathfinding UI Elements */

File:Pathfinding-stats-2.png

2012-08-07T02:06:21Z

Stinson Linden:

File:Pathfinding-stats-1.png

2012-08-07T01:38:37Z

Stinson Linden:

Pathfinding Tools in the Second Life Viewer

2012-08-07T01:00:30Z

Stinson Linden: /* Known Issues */

Linden Lab Official:Alternate Viewers

2012-08-01T23:19:40Z

Stinson Linden: /* Pathfinding */

{{OS License Nav}}

__TOC__
 

== What is an alternate viewer? ==
The primary viewer for Second Life is the official Second Life Viewer, available on the main [http://secondlife.com/support/downloads/ Second Life Downloads] page. That page also links to the latest beta, the version next in line to become the next released Viewer.

The viewers below provide alternate means of accessing Second Life.

{{KBnote|If you experience problems using any of the viewers below, you may be asked to try to replicate the problem using the officially supported SL Viewer release.}}

== Second Life Project Viewers ==
A Second Life [[Viewer_Types|Project Viewer]] is an early release from a Viewer development team that provides a preview of one or more new features. See the linked project pages for the status of the feature and instructions on how to provide feedback based on your use of the feature.
 

===HTTP===

{{ProjectViewer|NEW! July 27, 2012 - HTTP|The start of a unified approach to HTTP-based communications between the viewer and grid services with a goal of achieving reliability, consistency and a better overall experience on the grid.
|windows=http://download.cloud.secondlife.com/project-viewers/viewer-http/Second_Life_3-3-3-262585_ProjectViewer-viewer-http_Setup.exe
|macintosh=http://download.cloud.secondlife.com/project-viewers/viewer-http/SecondLife_3_3_3_262585_PROJECTVIEWER-VIEWER-HTTP.dmg
|linux=http://download.cloud.secondlife.com/project-viewers/viewer-http/SecondLife-i686-3.3.3.262585.tar.bz2
}}

----

===Pathfinding===

{{KBwarning | Pathfinding functionality has been included in version 3.4.0 (262596) or later versions of the '''Second Life Beta Viewer''' available through the [http://secondlife.com/support/downloads/ Downloads page]. The Beta Viewer contains the most recent pathfinding functionality. }}
 
{{KBnote|width=90%|Use of the Pathfinding feature may currently be restricted to specific regions and may not be accessible via most regions. More information will be here soon!}}
{{ProjectViewer|UPDATED! June 26th, 2012 - Pathfinding|
Pathfinding is awesome. Go have fun! For more information, please read these FAQ pages. [http://wiki.secondlife.com/wiki/Pathfinding_in_Second_Life General Info] and [http://wiki.secondlife.com/wiki/Pathfinding_Tools_in_the_Second_Life_Viewer Viewer Info].
|windows=http://download.cloud.secondlife.com/project-viewers/pathfinding/Second_Life_3-3-3-260597_ProjectViewer-Pathfinding_Setup.exe
|macintosh=http://download.cloud.secondlife.com/project-viewers/pathfinding/SecondLife_3_3_3_260597_PROJECTVIEWER-PATHFINDING.dmg
|linux=http://download.cloud.secondlife.com/project-viewers/pathfinding/SecondLife-i686-3.3.3.260597.tar.bz2
}}

----

===Simple Inventory===

{{ProjectViewer|NEW! January 20, 2012 - Simple Inventory|
Simple Inventory provides a cleaner, less cluttered user interface for the most common Inventory management operations, such as wear, unwear, move, rename, delete, and create new folders. It is also designed to use less memory and fetch fewer items, making it faster to perform those simple operations. For more information, please see the [http://wiki.secondlife.com/wiki/Simple_Inventory Simple Inventory wiki page].
|windows=http://download.cloud.secondlife.com/project-viewers/simple-inventory/Second_Life_3-2-8-248008_ProjectViewer-SimpleInventory_Setup.exe
|macintosh=http://download.cloud.secondlife.com/project-viewers/simple-inventory/SecondLife_3_2_8_248008_PROJECTVIEWER-SIMPLEINVENTORY.dmg
|linux=http://download.cloud.secondlife.com/project-viewers/simple-inventory/SecondLife-i686-3.2.8.248008.tar.bz2
}}

== Second Life Development Viewer ==
The Second Life Development Viewer is the very latest build of features and fixes that are on the way to being in the next Beta release. Every build of the [http://hg.secondlife.com/viewer-development main development tree] is made available for you to try as soon as it's built. The [[Snowstorm Project]] page has information on the process of creating these builds and how you can contribute to them as either a developer or a tester.

{{ViewerDevelopmentInstallers|showdetails=0}}

== Third-Party Viewers ==
Many Second Life developers, outside of Linden Lab, offer customized Second Life viewers. Please note that Linden Lab does not support third-party viewers.

See [[Third Party Viewer Directory]] for a listing of third-party viewers created by developers who have certified that they comply with the [http://secondlife.com/corporate/tpv.php Policy on Third Party Viewers].

Detailed information about many viewers in the Third Party Viewer Directory may be found in the Resident-maintained [[Downloads#non-linden|Downloads]] article.

Pathfinding Public Beta

2012-08-01T23:11:39Z

Stinson Linden: /* Pathfinding Project Viewer */

== Overview ==
We are opening up the Pathfinding project to the public on the main grid AGNI. You can get involved and help us make this project better.

== What is Pathfinding ==
Pathfinding provides tools and functions to enable smoother and smarter movement behavior for non-avatar entities in Second Life (for example, monsters in a game, rats in a haunted house, wisps in a fantasy forest). We refer to these entities as characters; in gaming terminology, they are sometimes called NPCs (non-player characters) or mobs (mobile objects).
* [[Pathfinding_in_Second_Life]]

== Where can I test Pathfinding ==
We have 4 public sandbox testing regions on the main grid. You are welcome to use them to test the pathfinding features. The Snack regions are available to members of the group "Second Life Beta". Please join this group: http://world.secondlife.com/group/19657888-576f-83e9-2580-7c3da7c0e4ca . The other regions are open access.

# Snack Sandbox 1
#* http://slurl.com/secondlife/Snack%20Sandbox%201/128/128/25
# Snack Sandbox 2
#* http://slurl.com/secondlife/Snack%20Sandbox%202/128/128/25
# Snack Sandbox 3
#* http://slurl.com/secondlife/Snack%20Sandbox%203/128/128/25
# Snack Sandbox 4
#* http://slurl.com/secondlife/Snack%20Sandbox%204/128/128/25
#Limia
#* http://slurl.com/secondlife/Limia/128/128/25
#Arowana
#* http://slurl.com/secondlife/Arowana/128/128/25
#Sandbox Astutula
#* http://slurl.com/secondlife/Sandbox%20Astutula/128/128/25
#Sandbox Exemplar
#* http://slurl.com/secondlife/Sandbox%20Exemplar/128/128/25
#Sandbox Pristina
#* http://slurl.com/secondlife/Sandbox%20Pristina/128/128/25
#Sandbox Verenda
#* http://slurl.com/secondlife/Sandbox%20Verenda/128/128/25
#Fuchsia
#* http://slurl.com/secondlife/Fuchsia/128/128/25
#Pepin
#* http://slurl.com/secondlife/Pepin/128/128/25
#Lime
#* http://slurl.com/secondlife/Lime/128/128/25
#Plum
#* http://slurl.com/secondlife/Plum/128/128/25
#Harvey
#* http://slurl.com/secondlife/Harvey/128/128/25

== Viewer with Pathfinding Functionality ==
* Pathfinding functionality has been included in the '''Second Life Viewer Beta''' available under the "Other Viewers" section on [http://secondlife.com/support/downloads/ Downloads page].

== How to report bugs and suggest features ==
Use JIRA to report bugs and suggest features in the PATHBUG JIRA project: https://jira.secondlife.com/browse/PATHBUG

== Additional Info ==
* [[Pathfinding_Tools_in_the_Second_Life_Viewer]]
* [[Pathfinding_LSL_functions]]
* [[Pathfinding/Alpha_release_notes]]
* [[Pathfinding_in_Second_Life#User_group|Pathfinding User Group Details]]

== Can I get my own region on Pathfinding? ==
More than likely you can!
* If you have a full region that you own you can apply to have the region added to the public beta
* email pathfinding-beta@lindenlab.com
* Include your account name and region you want added to the beta.
* Please email from the email address on your account
* We will follow up with you in email.

Release Notes/Second Life RC Magnum/12

2012-08-01T22:55:42Z

Stinson Linden: /* 12.07.31.262785 */

{{TOCright}}
=== 12.07.31.262785 ===
* This is the Pathfinding Project.
** Scheduled 2012-07-31
** Details are here: http://wiki.secondlife.com/wiki/Pathfinding
** Pathfinding viewer here: [http://secondlife.com/support/downloads/ SL Viewer Downloads] with beta viewer version 3.4.0 (262596) or later.
* '''Features and Changes'''
** Havok's AI library has been added so that navigation meta data for an entire region can be computed. This data is called the "navmesh".
** SL objects can be turned into "characters" which use the navmesh to navigate the world and avoid obstacles.
*** New LSL calls have been added to create/update/delete character behavior.
*** Characters cannot be used as attachments.
*** Characters are incompatible with some features, such as keyframed motion, being used as attachments, phantom, size changes, and others.
** Not all objects in the world contribute to the navmesh calculations.
*** The terrain always contributes
*** By default objects are ignored for the navmesh calculations.
*** Objects may be flagged to modify the navmesh calculations in one of 4 ways:
**** "Walkable" objects add navigable zones to the navmesh.
**** "Static Obstacle" objects cannot be navigated, and create a hole in the nav mesh
**** "Exclusion Volume" objects are like static obstacles, except that they are phantom (meaning that pathfinding characters cannot move through them but other physical objects and avatars can)
**** "Material Volume" objects are phantom objects that can be set to change the walkability coefficients of an area of the navmesh
**** Material volumes and walkable objects have 4 walkability coefficients to determine how expensive they are for each category of character
*** Objects that contribute to the navmesh have special restrictions:
**** Objects that contribute to the navmesh cannot change their physical shape via LSL script (changing object position, shape parameters, scale, rotation, physics shape type, and linking/unlinking is generally blocked)
**** Objects that contribute to the navmesh can be physically changed via the build tool by avatars who have modify permission and if the avatar is in the same region as the object.
**** In other words: objects that contribute to the navmesh cannot be physically changed by avatars who are located in a different region than the object, and therefore such objects cannot be moved across region boundaries.
*** When the navmesh has been modified, either because the terrain has been edited or because an object contributing to the nav mesh was rezzed/modified/deleted, it must be manually regenerated.
*** The beta viewer [version 3.4.0 (262596) or later] can be used to modify the pathfinding settings in a region: [http://secondlife.com/support/downloads/ SL Viewer Downloads]
*** Parcels that are set No-Entry for objects will cut the navmesh at their borders -- characters will not be able to navigate across it.
** The collision pipeline has been reorganized. This may affect avatar collisions/control, vehicle movement, and collision callbacks in LSL scripts.
** The terrain collision shape has been changed from a "heightfield" to a "mesh" to provide more efficient collisions, ray-trace, and navmesh computations.
*** This may change some collision details. In particular see the "Known Issues" list below.
*** When changing the terrain its visible appearance will update immediately, but its collision shape will not.
*** The server will wait at least 10 seconds since the last change before computing the new shape, and the computation time may take several seconds.
*** Where there is a discrepancy between visible and colliding terrain shapes object and avatar collisions may appear incorrect.
** Fix for {{jira|PATHBUG-77}} "[[llCastRay]] returns RCERR_CAST_TIME_EXCEEDED until the sim is rebooted"
** Avatars which are sitting on an object can no longer freeze it by selecting it, if they don't have permission to freeze it while standing.
** More details about pathfinding can be found at http://wiki.secondlife.com/wiki/Pathfinding and its linked pages
* Changed prim accounting for legacy prims which use the new accounting system
** All legacy-style prims have their streaming cost capped at 1.0 (except for sculpts, which will be capped at 2.0). This provides the benefit of not penalizing prim-based creators for optimizing their content by opting into the new system and will make the streaming cost more reflective of the true network cost of the objects.
** Server cost will be adjusted to MIN{ (0.5*num_prims) + (0.25 * num_scripts), num_prims }. This preserves the current value for unscripted linksets and reduce the cost for linksets containing fewer than 2*num_prims scripts. It provides the benefit of rewarding creators for reducing the number of scripts in their objects.
* Fixed the following bugs since the [[Release_Notes/Second_Life_RC_Magnum/12#12.06.23.260473|12.06.23.260473 Pathfinding RC]]
** {{jira|PATHBUG-122}} Ground Sit in a pathfinding region causes appearance to not match real location
** {{jira|SVC-8023}} Sim crossings by objects is broken
** Other internal bugfixes
* Fixed the following bugs since the [[Release_Notes/Second_Life_RC_Magnum/12#12.07.06.261281|12.07.06.261281 Pathfinding RC]]
** {{jira|PATHBUG-165}} Avatars become phantom after sitting on phantom objects
** {{jira|PATHBUG-164}} Physics shape updates are slow sometimes
* Fixed the following bugs since the [[Release_Notes/Second_Life_RC_Magnum/12#12.07.18.262060|12.07.18.262060 Pathfinding RC]]
** {{jira|PATHBUG-163}} On attachments, [[PRIM_SIZE]] causes [[PRIM_POS_LOCAL]] and [[PRIM_POSITION]] to be ignored
** Other internal bugfixes
* Fixed the following bugs since the [[Release_Notes/Second_Life_RC_Magnum/12#12.07.24.262484|12.07.24.262484 Pathfinding RC]]
** {{jira|PATHBUG-166}} Avatar Physics Broken - Magnum Version 262484 (Done today)
** {{jira|PATHBUG-167}} llApplyImpulse and llPushObject does not work properly on Magnum servers, when pushing avatars rapidly
** {{jira|PATH-835}} copying an object with shift drag does not copy the custom physics
** {{jira|PATH-809}} User is not able to change phantom concave prim's attribute to "Walkable" or "Static obstacle" value
** {{jira|PATHBUG-175}} Viewer looses track of adjacent region on high altitudes
* Merged with Server Trunk: https://wiki.secondlife.com/wiki/Release_Notes/Second_Life_Server/12#12.07.24.262437

* '''Known Issues'''
** Mesh objects (such as vehicles) cannot physically cross from a pathfinding region into a non-pathfinding region, due to the upgrade to a newer version of the Havok physics engine
** Fast vehicles can snag on the terrain (which now collides as a mesh shape instead of a heightfield)
** Certain small physical objects can fall through the terrain surface
** After the terrain is edited, the physics engine several needs to 'rebake' the terrain to reflect the new shape, due to the new physics modeling system.
** {{jira|SVC-8048}} vehicles being very iratic and jittery on magnum regions
** {{jira|PATHBUG-156}} Hacked mixed volumedetect linksets become non-phantom after the region is rolled back from pathfinding to a non-pathfinding version
** {{jira|PATH-796}} Linking a flexi prim as a child of a non-flexi causes the flexi prim to go non-phantom.
** {{jira|PATH-794}} some parcel operations can clear "no object entry" settings without flagging the navmesh for update
** {{jira|PATH-787}} navmesh can stitch up no-object-entry parcels across region boundaries
** {{jira|PATH-784}} Editing the shape parameters of [[PRIM_PHYSICS_SHAPE_NONE|PHYSICS_SHAPE_TYPE_NONE]] child prims in navmeshy linksets via build tool incorrectly cause the navmesh to be marked dirty
** {{jira|PATH-651}} Pathfinding characters silently fail when crossing into a region with dynamic_pathfinding disabled
** {{jira|PATH-630}} [[llSetLocalRot]]() fails in the root prims of characters
** {{jira|PATH-538}} Character [[llGetMass|mass]] as reported by LSL scripts is bogus
** {{jira|PATH-536}} The simulator allows navmesh-contributing objects to be worn as attachments, which causes navmesh properties on the object to be reset.
** {{jira|PATH-351}} Ugly avatar animations are triggered when terraforming terrain that an avatar is standing on
** {{jira|PATH-345}} path_update event is not triggered (with parameters 0, then 1) when object crosses region boundary into the north or east and [[FORCE_DIRECT_PATH]]=[[TRUE]]

=== 12.07.24.262484 ===
* This is the Pathfinding Project.
** Scheduled 2012-07-25
** Details are here: http://wiki.secondlife.com/wiki/Pathfinding
** Pathfinding viewer here: https://wiki.secondlife.com/wiki/Linden_Lab_Official:Alternate_Viewers#Pathfinding
* '''Features and Changes'''
** Havok's AI library has been added so that navigation meta data for an entire region can be computed. This data is called the "navmesh".
** SL objects can be turned into "characters" which use the navmesh to navigate the world and avoid obstacles.
*** New LSL calls have been added to create/update/delete character behavior.
*** Characters cannot be used as attachments.
*** Characters are incompatible with some features, such as keyframed motion, being used as attachments, phantom, size changes, and others.
** Not all objects in the world contribute to the navmesh calculations.
*** The terrain always contributes
*** By default objects are ignored for the navmesh calculations.
*** Objects may be flagged to modify the navmesh calculations in one of 4 ways:
**** "Walkable" objects add navigable zones to the navmesh.
**** "Static Obstacle" objects cannot be navigated, and create a hole in the nav mesh
**** "Exclusion Volume" objects are like static obstacles, except that they are phantom (meaning that pathfinding characters cannot move through them but other physical objects and avatars can)
**** "Material Volume" objects are phantom objects that can be set to change the walkability coefficients of an area of the navmesh
**** Material volumes and walkable objects have 4 walkability coefficients to determine how expensive they are for each category of character
*** Objects that contribute to the navmesh have special restrictions:
**** Objects that contribute to the navmesh cannot change their physical shape via LSL script (changing object position, shape parameters, scale, rotation, physics shape type, and linking/unlinking is generally blocked)
**** Objects that contribute to the navmesh can be physically changed via the build tool by avatars who have modify permission and if the avatar is in the same region as the object.
**** In other words: objects that contribute to the navmesh cannot be physically changed by avatars who are located in a different region than the object, and therefore such objects cannot be moved across region boundaries.
*** When the navmesh has been modified, either because the terrain has been edited or because an object contributing to the nav mesh was rezzed/modified/deleted, it must be manually regenerated.
*** The pathfinding project viewer can be used to modify the pathfinding settings in a region: http://wiki.secondlife.com/wiki/Linden_Lab_Official:Alternate_Viewers#Pathfinding
*** Parcels that are set No-Entry for objects will cut the navmesh at their borders -- characters will not be able to navigate across it.
** The collision pipeline has been reorganized. This may affect avatar collisions/control, vehicle movement, and collision callbacks in LSL scripts.
** The terrain collision shape has been changed from a "heightfield" to a "mesh" to provide more efficient collisions, ray-trace, and navmesh computations.
*** This may change some collision details. In particular see the "Known Issues" list below.
*** When changing the terrain its visible appearance will update immediately, but its collision shape will not.
*** The server will wait at least 10 seconds since the last change before computing the new shape, and the computation time may take several seconds.
*** Where there is a discrepancy between visible and colliding terrain shapes object and avatar collisions may appear incorrect.
** Fix for {{jira|PATHBUG-77}} "[[llCastRay]] returns RCERR_CAST_TIME_EXCEEDED until the sim is rebooted"
** Avatars which are sitting on an object can no longer freeze it by selecting it, if they don't have permission to freeze it while standing.
** More details about pathfinding can be found at http://wiki.secondlife.com/wiki/Pathfinding and its linked pages
* Changed prim accounting for legacy prims which use the new accounting system
** All legacy-style prims have their streaming cost capped at 1.0 (except for sculpts, which will be capped at 2.0). This provides the benefit of not penalizing prim-based creators for optimizing their content by opting into the new system and will make the streaming cost more reflective of the true network cost of the objects.
** Server cost will be adjusted to MIN{ (0.5*num_prims) + (0.25 * num_scripts), num_prims }. This preserves the current value for unscripted linksets and reduce the cost for linksets containing fewer than 2*num_prims scripts. It provides the benefit of rewarding creators for reducing the number of scripts in their objects.
* Fixed the following bugs since the [[Release_Notes/Second_Life_RC_Magnum/12#12.06.23.260473|12.06.23.260473 Pathfinding RC]]
** {{jira|PATHBUG-122}} Ground Sit in a pathfinding region causes appearance to not match real location
** {{jira|SVC-8023}} Sim crossings by objects is broken
** Other internal bugfixes
* Fixed the following bugs since the [[Release_Notes/Second_Life_RC_Magnum/12#12.07.06.261281|12.07.06.261281 Pathfinding RC]]
** {{jira|PATHBUG-165}} Avatars become phantom after sitting on phantom objects
** {{jira|PATHBUG-164}} Physics shape updates are slow sometimes
* Fixed the following bugs since the [[Release_Notes/Second_Life_RC_Magnum/12#12.07.18.262060|12.07.18.262060 Pathfinding RC]]
** {{jira|PATHBUG-163}} On attachments, [[PRIM_SIZE]] causes [[PRIM_POS_LOCAL]] and [[PRIM_POSITION]] to be ignored
** Other internal bugfixes

* '''Known Issues'''
** Mesh objects (such as vehicles) cannot physically cross from a pathfinding region into a non-pathfinding region, due to the upgrade to a newer version of the Havok physics engine
** Fast vehicles can snag on the terrain (which now collides as a mesh shape instead of a heightfield)
** Certain small physical objects can fall through the terrain surface
** After the terrain is edited, the physics engine several needs to 'rebake' the terrain to reflect the new shape, due to the new physics modeling system.
** {{jira|SVC-8048}} vehicles being very iratic and jittery on magnum regions
** {{jira|PATHBUG-156}} Hacked mixed volumedetect linksets become non-phantom after the region is rolled back from pathfinding to a non-pathfinding version
** {{jira|PATH-796}} Linking a flexi prim as a child of a non-flexi causes the flexi prim to go non-phantom.
** {{jira|PATH-794}} some parcel operations can clear "no object entry" settings without flagging the navmesh for update
** {{jira|PATH-787}} navmesh can stitch up no-object-entry parcels across region boundaries
** {{jira|PATH-784}} Editing the shape parameters of [[PRIM_PHYSICS_SHAPE_NONE|PHYSICS_SHAPE_TYPE_NONE]] child prims in navmeshy linksets via build tool incorrectly cause the navmesh to be marked dirty
** {{jira|PATH-651}} Pathfinding characters silently fail when crossing into a region with dynamic_pathfinding disabled
** {{jira|PATH-630}} [[llSetLocalRot]]() fails in the root prims of characters
** {{jira|PATH-538}} Character [[llGetMass|mass]] as reported by LSL scripts is bogus
** {{jira|PATH-536}} The simulator allows navmesh-contributing objects to be worn as attachments, which causes navmesh properties on the object to be reset.
** {{jira|PATH-351}} Ugly avatar animations are triggered when terraforming terrain that an avatar is standing on
** {{jira|PATH-345}} path_update event is not triggered (with parameters 0, then 1) when object crosses region boundary into the north or east and [[FORCE_DIRECT_PATH]]=[[TRUE]]
* Merged with Server Trunk: https://wiki.secondlife.com/wiki/Release_Notes/Second_Life_Server/12#12.07.18.262055

=== 12.07.18.262060 ===
* This is the Pathfinding Project.
** Scheduled 2012-07-18
** Details are here: http://wiki.secondlife.com/wiki/Pathfinding
** Pathfinding viewer here: https://wiki.secondlife.com/wiki/Linden_Lab_Official:Alternate_Viewers#Pathfinding
* '''Features and Changes'''
** Havok's AI library has been added so that navigation meta data for an entire region can be computed. This data is called the "navmesh".
** SL objects can be turned into "characters" which use the navmesh to navigate the world and avoid obstacles.
*** New LSL calls have been added to create/update/delete character behavior.
*** Characters cannot be used as attachments.
*** Characters are incompatible with some features, such as keyframed motion, being used as attachments, phantom, size changes, and others.
** Not all objects in the world contribute to the navmesh calculations.
*** The terrain always contributes
*** By default objects are ignored for the navmesh calculations.
*** Objects may be flagged to modify the navmesh calculations in one of 4 ways:
**** "Walkable" objects add navigable zones to the navmesh.
**** "Static Obstacle" objects cannot be navigated, and create a hole in the nav mesh
**** "Exclusion Volume" objects are like static obstacles, except that they are phantom (meaning that pathfinding characters cannot move through them but other physical objects and avatars can)
**** "Material Volume" objects are phantom objects that can be set to change the walkability coefficients of an area of the navmesh
**** Material volumes and walkable objects have 4 walkability coefficients to determine how expensive they are for each category of character
*** Objects that contribute to the navmesh have special restrictions:
**** Objects that contribute to the navmesh cannot change their physical shape via LSL script (changing object position, shape parameters, scale, rotation, physics shape type, and linking/unlinking is generally blocked)
**** Objects that contribute to the navmesh can be physically changed via the build tool by avatars who have modify permission and if the avatar is in the same region as the object.
**** In other words: objects that contribute to the navmesh cannot be physically changed by avatars who are located in a different region than the object, and therefore such objects cannot be moved across region boundaries.
*** When the navmesh has been modified, either because the terrain has been edited or because an object contributing to the nav mesh was rezzed/modified/deleted, it must be manually regenerated.
*** The pathfinding project viewer can be used to modify the pathfinding settings in a region: http://wiki.secondlife.com/wiki/Linden_Lab_Official:Alternate_Viewers#Pathfinding
*** Parcels that are set No-Entry for objects will cut the navmesh at their borders -- characters will not be able to navigate across it.
** The collision pipeline has been reorganized. This may affect avatar collisions/control, vehicle movement, and collision callbacks in LSL scripts.
** The terrain collision shape has been changed from a "heightfield" to a "mesh" to provide more efficient collisions, ray-trace, and navmesh computations.
*** This may change some collision details. In particular see the "Known Issues" list below.
*** When changing the terrain its visible appearance will update immediately, but its collision shape will not.
*** The server will wait at least 10 seconds since the last change before computing the new shape, and the computation time may take several seconds.
*** Where there is a discrepancy between visible and colliding terrain shapes object and avatar collisions may appear incorrect.
** Fix for {{jira|PATHBUG-77}} "[[llCastRay]] returns RCERR_CAST_TIME_EXCEEDED until the sim is rebooted"
** Avatars which are sitting on an object can no longer freeze it by selecting it, if they don't have permission to freeze it while standing.
** More details about pathfinding can be found at http://wiki.secondlife.com/wiki/Pathfinding and its linked pages
* Changed prim accounting for legacy prims which use the new accounting system
** All legacy-style prims have their streaming cost capped at 1.0 (except for sculpts, which will be capped at 2.0). This provides the benefit of not penalizing prim-based creators for optimizing their content by opting into the new system and will make the streaming cost more reflective of the true network cost of the objects.
** Server cost will be adjusted to MIN{ (0.5*num_prims) + (0.25 * num_scripts), num_prims }. This preserves the current value for unscripted linksets and reduce the cost for linksets containing fewer than 2*num_prims scripts. It provides the benefit of rewarding creators for reducing the number of scripts in their objects.
* Fixed the following bugs since the [[Release_Notes/Second_Life_RC_Magnum/12#12.06.23.260473|12.06.23.260473 Pathfinding RC]]
** {{jira|PATHBUG-122}} Ground Sit in a pathfinding region causes appearance to not match real location
** {{jira|SVC-8023}} Sim crossings by objects is broken
** Other internal bugfixes
* Fixed the following bugs since the [[Release_Notes/Second_Life_RC_Magnum/12#12.07.06.261281|12.07.06.261281 Pathfinding RC]]
** {{jira|PATHBUG-165}} Avatars become phantom after sitting on phantom objects
** {{jira|PATHBUG-164}} Physics shape updates are slow sometimes

* '''Known Issues'''
** Mesh objects (such as vehicles) cannot physically cross from a pathfinding region into a non-pathfinding region, due to the upgrade to a newer version of the Havok physics engine
** Fast vehicles can snag on the terrain (which now collides as a mesh shape instead of a heightfield)
** Certain small physical objects can fall through the terrain surface
** After the terrain is edited, the physics engine several needs to 'rebake' the terrain to reflect the new shape, due to the new physics modeling system.
** {{jira|SVC-8048}} vehicles being very iratic and jittery on magnum regions
** {{jira|PATHBUG-163}} On attachments, [[PRIM_SIZE]] causes [[PRIM_POS_LOCAL]] and [[PRIM_POSITION]] to be ignored
** {{jira|PATHBUG-156}} Hacked mixed volumedetect linksets become non-phantom after the region is rolled back from pathfinding to a non-pathfinding version
** {{jira|PATH-796}} Linking a flexi prim as a child of a non-flexi causes the flexi prim to go non-phantom.
** {{jira|PATH-794}} some parcel operations can clear "no object entry" settings without flagging the navmesh for update
** {{jira|PATH-787}} navmesh can stitch up no-object-entry parcels across region boundaries
** {{jira|PATH-784}} Editing the shape parameters of [[PRIM_PHYSICS_SHAPE_NONE|PHYSICS_SHAPE_TYPE_NONE]] child prims in navmeshy linksets via build tool incorrectly cause the navmesh to be marked dirty
** {{jira|PATH-651}} Pathfinding characters silently fail when crossing into a region with dynamic_pathfinding disabled
** {{jira|PATH-630}} [[llSetLocalRot]]() fails in the root prims of characters
** {{jira|PATH-538}} Character [[llGetMass|mass]] as reported by LSL scripts is bogus
** {{jira|PATH-536}} The simulator allows navmesh-contributing objects to be worn as attachments, which causes navmesh properties on the object to be reset.
** {{jira|PATH-351}} Ugly avatar animations are triggered when terraforming terrain that an avatar is standing on
** {{jira|PATH-345}} path_update event is not triggered (with parameters 0, then 1) when object crosses region boundary into the north or east and [[FORCE_DIRECT_PATH]]=[[TRUE]]
* Merged with Server Trunk: https://wiki.secondlife.com/wiki/Release_Notes/Second_Life_Server/12#12.07.03.261171

=== 12.07.06.261281 ===
* This is the Pathfinding Project.
** Scheduled 2012-07-11
** Details are here: http://wiki.secondlife.com/wiki/Pathfinding
** Pathfinding viewer here: https://wiki.secondlife.com/wiki/Linden_Lab_Official:Alternate_Viewers#Pathfinding
* '''Features and Changes'''
** Havok's AI library has been added so that navigation meta data for an entire region can be computed. This data is called the "navmesh".
** SL objects can be turned into "characters" which use the navmesh to navigate the world and avoid obstacles.
*** New LSL calls have been added to create/update/delete character behavior.
*** Characters cannot be used as attachments.
*** Characters are incompatible with some features, such as keyframed motion, being used as attachments, phantom, size changes, and others.
** Not all objects in the world contribute to the navmesh calculations.
*** The terrain always contributes
*** By default objects are ignored for the navmesh calculations.
*** Objects may be flagged to modify the navmesh calculations in one of 4 ways:
**** "Walkable" objects add navigable zones to the navmesh.
**** "Static Obstacle" objects cannot be navigated, and create a hole in the nav mesh
**** "Exclusion Volume" objects are like static obstacles, except that they are phantom (meaning that pathfinding characters cannot move through them but other physical objects and avatars can)
**** "Material Volume" objects are phantom objects that can be set to change the walkability coefficients of an area of the navmesh
**** Material volumes and walkable objects have 4 walkability coefficients to determine how expensive they are for each category of character
*** Objects that contribute to the navmesh have special restrictions:
**** Objects that contribute to the navmesh cannot change their physical shape via LSL script (changing object position, shape parameters, scale, rotation, physics shape type, and linking/unlinking is generally blocked)
**** Objects that contribute to the navmesh can be physically changed via the build tool by avatars who have modify permission and if the avatar is in the same region as the object.
**** In other words: objects that contribute to the navmesh cannot be physically changed by avatars who are located in a different region than the object, and therefore such objects cannot be moved across region boundaries.
*** When the navmesh has been modified, either because the terrain has been edited or because an object contributing to the nav mesh was rezzed/modified/deleted, it must be manually regenerated.
*** The pathfinding project viewer can be used to modify the pathfinding settings in a region: http://wiki.secondlife.com/wiki/Linden_Lab_Official:Alternate_Viewers#Pathfinding
*** Parcels that are set No-Entry for objects will cut the navmesh at their borders -- characters will not be able to navigate across it.
** The collision pipeline has been reorganized. This may affect avatar collisions/control, vehicle movement, and collision callbacks in LSL scripts.
** The terrain collision shape has been changed from a "heightfield" to a "mesh" to provide more efficient collisions, ray-trace, and navmesh computations.
*** This may change some collision details. In particular see the "Known Issues" list below.
*** When changing the terrain its visible appearance will update immediately, but its collision shape will not.
*** The server will wait at least 10 seconds since the last change before computing the new shape, and the computation time may take several seconds.
*** Where there is a discrepancy between visible and colliding terrain shapes object and avatar collisions may appear incorrect.
** Fix for {{jira|PATHBUG-77}} "[[llCastRay]] returns RCERR_CAST_TIME_EXCEEDED until the sim is rebooted"
** Avatars which are sitting on an object can no longer freeze it by selecting it, if they don't have permission to freeze it while standing.
** More details about pathfinding can be found at http://wiki.secondlife.com/wiki/Pathfinding and its linked pages
* Changed prim accounting for legacy prims which use the new accounting system
** All legacy-style prims have their streaming cost capped at 1.0 (except for sculpts, which will be capped at 2.0). This provides the benefit of not penalizing prim-based creators for optimizing their content by opting into the new system and will make the streaming cost more reflective of the true network cost of the objects.
** Server cost will be adjusted to MIN{ (0.5*num_prims) + (0.25 * num_scripts), num_prims }. This preserves the current value for unscripted linksets and reduce the cost for linksets containing fewer than 2*num_prims scripts. It provides the benefit of rewarding creators for reducing the number of scripts in their objects.
* Fixed the following bugs since the [[Release_Notes/Second_Life_RC_Magnum/12#12.06.23.260473|12.06.23.260473 Pathfinding RC]]
** {{jira|PATHBUG-122}} Ground Sit in a pathfinding region causes appearance to not match real location
** {{jira|SVC-8023}} Sim crossings by objects is broken
** Other internal bugfixes

* '''Known Issues'''
** Mesh objects (such as vehicles) cannot physically cross from a pathfinding region into a non-pathfinding region, due to the upgrade to a newer version of the Havok physics engine
** Fast vehicles can snag on the terrain (which now collides as a mesh shape instead of a heightfield)
** Certain small physical objects can fall through the terrain surface
** After the terrain is edited, the physics engine several needs to 'rebake' the terrain to reflect the new shape, due to the new physics modeling system.
** {{jira|PATHBUG-156}} Hacked mixed volumedetect linksets become non-phantom after the region is rolled back from pathfinding to a non-pathfinding version
** {{jira|PATH-796}} Linking a flexi prim as a child of a non-flexi causes the flexi prim to go non-phantom.
** {{jira|PATH-794}} some parcel operations can clear "no object entry" settings without flagging the navmesh for update
** {{jira|PATH-787}} navmesh can stitch up no-object-entry parcels across region boundaries
** {{jira|PATH-784}} Editing the shape parameters of [[PRIM_PHYSICS_SHAPE_NONE|PHYSICS_SHAPE_TYPE_NONE]] child prims in navmeshy linksets via build tool incorrectly cause the navmesh to be marked dirty
** {{jira|PATH-651}} Pathfinding characters silently fail when crossing into a region with dynamic_pathfinding disabled
** {{jira|PATH-630}} [[llSetLocalRot]]() fails in the root prims of characters
** {{jira|PATH-538}} Character [[llGetMass|mass]] as reported by LSL scripts is bogus
** {{jira|PATH-536}} The simulator allows navmesh-contributing objects to be worn as attachments, which causes navmesh properties on the object to be reset.
** {{jira|PATH-351}} Ugly avatar animations are triggered when terraforming terrain that an avatar is standing on
** {{jira|PATH-345}} path_update event is not triggered (with parameters 0, then 1) when object crosses region boundary into the north or east and [[FORCE_DIRECT_PATH]]=[[TRUE]]

=== 12.06.20.260188 ===
* Scheduled 2012-06-27
* Features
** Simulator changes to process prebaked avatar textures for library outfits.
* Merged with Server Trunk: https://wiki.secondlife.com/wiki/Release_Notes/Second_Life_Server/12#12.06.18.259948
* This project is also on LeTigre and BlueSteel:
** https://wiki.secondlife.com/wiki/Release_Notes/Second_Life_RC_LeTigre/12#12.06.20.260188
** https://wiki.secondlife.com/wiki/Release_Notes/Second_Life_RC_BlueSteel/12#12.06.20.260188

=== 12.06.23.260473 ===
* This is the Pathfinding Project.
** Scheduled 2012-06-27 '''''THIS PROJECT WAS ROLLED BACK'''''
** Details are here: http://wiki.secondlife.com/wiki/Pathfinding
** Pathfinding viewer here: https://wiki.secondlife.com/wiki/Linden_Lab_Official:Alternate_Viewers#Pathfinding
* '''Features and Changes'''
** Havok's AI library has been added so that navigation meta data for an entire region can be computed. This data is called the "navmesh".
** SL objects can be turned into "characters" which use the navmesh to navigate the world and avoid obstacles.
*** New LSL calls have been added to create/update/delete character behavior.
*** Characters cannot be used as attachments.
*** Characters are incompatible with some features, such as keyframed motion, being used as attachments, phantom, size changes, and others.
** Not all objects in the world contribute to the navmesh calculations.
*** The terrain always contributes
*** By default objects are ignored for the navmesh calculations.
*** Objects may be flagged to modify the navmesh calculations in one of 4 ways:
**** "Walkable" objects add navigable zones to the navmesh.
**** "Static Obstacle" objects cannot be navigated, and create a hole in the nav mesh
**** "Exclusion Volume" objects are like static obstacles, except that they are phantom (meaning that pathfinding characters cannot move through them but other physical objects and avatars can)
**** "Material Volume" objects are phantom objects that can be set to change the walkability coefficients of an area of the navmesh
**** Material volumes and walkable objects have 4 walkability coefficients to determine how expensive they are for each category of character
*** Objects that contribute to the navmesh have special restrictions:
**** Objects that contribute to the navmesh cannot change their physical shape via LSL script (changing object position, shape parameters, scale, rotation, physics shape type, and linking/unlinking is generally blocked)
**** Objects that contribute to the navmesh can be physically changed via the build tool by avatars who have modify permission and if the avatar is in the same region as the object.
**** In other words: objects that contribute to the navmesh cannot be physically changed by avatars who are located in a different region than the object, and therefore such objects cannot be moved across region boundaries.
*** When the navmesh has been modified, either because the terrain has been edited or because an object contributing to the nav mesh was rezzed/modified/deleted, it must be manually regenerated.
*** The pathfinding project viewer can be used to modify the pathfinding settings in a region: http://wiki.secondlife.com/wiki/Linden_Lab_Official:Alternate_Viewers#Pathfinding
*** Parcels that are set No-Entry for objects will cut the navmesh at their borders -- characters will not be able to navigate across it.
** The collision pipeline has been reorganized. This may affect avatar collisions/control, vehicle movement, and collision callbacks in LSL scripts.
** The terrain collision shape has been changed from a "heightfield" to a "mesh" to provide more efficient collisions, ray-trace, and navmesh computations.
*** This may change some collision details. In particular see the "Known Issues" list below.
*** When changing the terrain its visible appearance will update immediately, but its collision shape will not.
*** The server will wait at least 10 seconds since the last change before computing the new shape, and the computation time may take several seconds.
*** Where there is a discrepancy between visible and colliding terrain shapes object and avatar collisions may appear incorrect.
** Fix for {{jira|PATHBUG-77}} "[[llCastRay]] returns RCERR_CAST_TIME_EXCEEDED until the sim is rebooted"
** Avatars which are sitting on an object can no longer freeze it by selecting it, if they don't have permission to freeze it while standing.
** More details about pathfinding can be found at http://wiki.secondlife.com/wiki/Pathfinding and its linked pages

* '''Known Issues'''
** Fast vehicles can snag on the terrain (which now collides as a mesh shape instead of a heightfield)
** Certain small physical objects can fall through the terrain surface
** Mesh objects (such as vehicles) cannot physically cross from a pathfinding region into a non-pathfinding region, due to the upgrade to a newer version of the Havok physics engine
** After the terrain is edited, the physics engine several needs to 'rebake' the terrain to reflect the new shape, due to the new physics modeling system.
** {{jira|PATHBUG-122}} Ground Sit in a pathfinding region causes appearance to not match real location
** {{jira|PATH-784}} Editing the shape parameters of [[PRIM_PHYSICS_SHAPE_NONE|PHYSICS_SHAPE_TYPE_NONE]] child prims in navmeshy linksets via build tool incorrectly cause the navmesh to be marked dirty
** {{jira|PATH-651}} Pathfinding characters silently fail when crossing into a region with dynamic_pathfinding disabled
** {{jira|PATH-630}} [[llSetLocalRot]]() fails in the root prims of characters
** {{jira|PATH-538}} Character [[llGetMass|mass]] as reported by LSL scripts is bogus
** {{jira|PATH-536}} The simulator allows navmesh-contributing objects to be worn as attachments, which causes navmesh properties on the object to be reset.
** {{jira|PATH-351}} Ugly avatar animations are triggered when terraforming terrain that an avatar is standing on
** {{jira|PATH-345}} path_update event is not triggered (with parameters 0, then 1) when object crosses region boundary into the north or east and [[FORCE_DIRECT_PATH]]=[[TRUE]]

* This project is also on LeTigre:
** https://wiki.secondlife.com/wiki/Release_Notes/Second_Life_RC_LeTigre/12#12.06.23.260473
=== 12.06.18.259948 ===
* Scheduled 2012-06-20
* This channel contains new simulator changes to help with infrastructure projects.
* Bug Fixes:
** {{jira|SVC-8000}}: Noticed 06-14-12 on LeTigre server in Cleary. LSL function [[llGetWallclock]]() displays number of seconds since Zulu (GMT) midnite instead of Pacific midnite
** {{jira|SVC-8004}}: Region server names now include backslashes, apparently escaping the space that follows.
** {{jira|SVC-7598}}: Error fetching server release notes URL.
* This is also on LeTigre channel:
** https://wiki.secondlife.com/wiki/Release_Notes/Second_Life_RC_LeTigre/12#12.06.18.259948

=== 12.06.06.259024 ===
* This is a "maint-server" deploy. scheduled 2012-06-13
* Features
** No new features.
* Bug Fixes
** {{jira|SVC-7902}}: Problem of not being able to rez on my land continues
* Merged with Server Trunk: https://wiki.secondlife.com/wiki/Release_Notes/Second_Life_Server/12#12.06.04.258757

=== 12.06.04.258763 ===
* This is a "maint-server" deploy. scheduled 2012-06-05
* Features
** No new features.
* Bug Fixes
** {{jira|SVC-7902}}: Problem of not being able to rez on my land continues

=== 12.06.04.258754 ===
* This is an emergency deploy to fix a security issue. scheduled 2012-06-04
* Features
** No new features.
* Bug Fixes
** Fixes a griefing vector.

=== 12.05.25.258071 ===
* This is the "Experience Tools" project. scheduled 2012-05-30
* Three new LSL functions:
** [https://wiki.secondlife.com/wiki/LlAttachToAvatarTemp llAttachToAvatarTemp]
** [https://wiki.secondlife.com/wiki/LlTeleportAgent llTeleportAgent]
** [https://wiki.secondlife.com/wiki/LlTeleportAgentGlobalCoords llTeleportAgentGlobalCoords]
* '''NOTE:''' the new LSL functions work with the current runtime permissions system and are precursor to future work with experience permissions. More information about the runtime permission is here: [https://wiki.secondlife.com/wiki/PERMISSION_TELEPORT PERMISSION_TELEPORT].
* These functions only work only on Magnum RC regions and not grid wide.

* This channel will have Region Idling enabled.
* Features
** Prototype threaded region cross for agents. Uses the new threaded RPC/thread state machine mechanism.
* Bug Fixes
** Fixed a crashing bug.
* Also on LeTigre: http://wiki.secondlife.com/wiki/Release_Notes/Second_Life_RC_LeTigre/12#12.05.11.256527

=== 12.05.11.256527 ===
* This is the "Threaded Region Crossing" project. scheduled 2012-05-23
* This channel will have Region Idling enabled.
* Features
** Prototype threaded region cross for agents. Uses the new threaded RPC/thread state machine mechanism.
* Bug Fixes
** Fixed a crashing bug.
* Also on LeTigre: http://wiki.secondlife.com/wiki/Release_Notes/Second_Life_RC_LeTigre/12#12.05.11.256527

=== 12.05.11.256527 ===
* This is the "Threaded Region Crossing" project. scheduled 2012-05-16
* Features
** Prototype threaded region cross for agents. Uses the new threaded RPC/thread state machine mechanism.
* Bug Fixes
** Fixed a crashing bug.
* Also on LeTigre: http://wiki.secondlife.com/wiki/Release_Notes/Second_Life_RC_LeTigre/12#12.05.11.256527

=== 12.05.07.255857 ===
* This is the "Threaded Region Crossing" project. scheduled 2012-05-09
* Features
** Prototype threaded region cross for agents. Uses the new threaded RPC/thread state machine mechanism.
* Also on BlueSteel: http://wiki.secondlife.com/wiki/Release_Notes/Second_Life_RC_BlueSteel/12#12.05.07.255857
* Also on LeTigre: http://wiki.secondlife.com/wiki/Release_Notes/Second_Life_RC_BlueSteel/12#12.05.07.255857

=== 12.04.30.255166 ===
* This is a maint-server deploy.
** Scheduled 2012-05-02
* Features
** New [[PRIM_SLICE]] value can be used in [[llGetLinkPrimitiveParams]]() and similar functions to set the slice value for prims that support slice values.
** [[HTTP_BODY_MAXLENGTH]] has been added to [[llHTTPRequest]]() allowing return body sizes up to 4k for LSO and 16k for Mono scripts
** New LSL [[llGetAgentList|llGetRegionAgents]]() function returns a list of all agent keys on the region
* Bug Fixes
** {{jira|SCR-15}}: Add flag parameter [vector slice] to [[llSetPrimitiveParams]] [[PRIM_TYPE]] flags [[PRIM_TYPE_BOX]], [[PRIM_TYPE_CYLINDER]], and [[PRIM_TYPE_PRISM]]
** {{jira|SVC-680}}: Increase HTTP Response body size from 2048 to 4096 or larger
** {{jira|SVC-5488}}: [[llGetAgentList|llGetRegionAgents]]() -- returns list of agent keys in the current region
** {{jira|SVC-6894}}: Excessive EnableSimulator message spamming to viewers
** {{jira|SVC-7307}}: creation of scripts gets a nice error
** {{jira|SVC-7845}}: Group Notices not working on Magnum 12.04.13.253827
* New Bug Fixes
** Fixed an issue with attachments.
* Also on BlueSteel: http://wiki.secondlife.com/wiki/Release_Notes/Second_Life_RC_BlueSteel/12#12.04.30.255166
* Also on LeTigre: http://wiki.secondlife.com/wiki/Release_Notes/Second_Life_RC_BlueSteel/12#12.04.30.255166

=== 12.04.20.254297 ===
* This is a maint-server deploy.
** Scheduled 2012-04-25
* Features
** New [[PRIM_SLICE]] value can be used in [[llGetLinkPrimitiveParams]]() and similar functions to set the slice value for prims that support slice values.
** [[HTTP_BODY_MAXLENGTH]] has been added to [[llHTTPRequest]]() allowing return body sizes up to 4k for LSO and 16k for Mono scripts
** New LSL [[llGetAgentList|llGetRegionAgents]]() function returns a list of all agent keys on the region
* Bug Fixes
** {{jira|SCR-15}}: Add flag parameter [vector slice] to [[llSetPrimitiveParams]] [[PRIM_TYPE]] flags [[PRIM_TYPE_BOX]], [[PRIM_TYPE_CYLINDER]], and [[PRIM_TYPE_PRISM]]
** {{jira|SVC-680}}: Increase HTTP Response body size from 2048 to 4096 or larger
** {{jira|SVC-5488}}: [[llGetAgentList|llGetRegionAgents]]() -- returns list of agent keys in the current region
** {{jira|SVC-6894}}: Excessive EnableSimulator message spamming to viewers
** {{jira|SVC-7307}}: creation of scripts gets a nice error
* '''Avatar Fly Height Restriction is being raised to 5,000m.'''
* New Bug Fixes
** {{jira|SVC-7845}}: Group Notices not working on Magnum 12.04.13.253827
* Merged with Server Trunk: https://wiki.secondlife.com/wiki/Release_Notes/Second_Life_Server/12#12.04.12.253726

=== 12.04.13.253827 ===
* This is a maint-server deploy.
** Scheduled 2012-04-18
* Features
** New [[PRIM_SLICE]] value can be used in [[llGetLinkPrimitiveParams]]() and similar functions to set the slice value for prims that support slice values.
** [[HTTP_BODY_MAXLENGTH]] has been added to [[llHTTPRequest]]() allowing return body sizes up to 4k for LSO and 16k for Mono scripts
** New LSL [[llGetAgentList|llGetRegionAgents]]() function returns a list of all agent keys on the region
* Bug Fixes
** {{jira|SCR-15}}: Add flag parameter [vector slice] to [[llSetPrimitiveParams]] [[PRIM_TYPE]] flags [[PRIM_TYPE_BOX]], [[PRIM_TYPE_CYLINDER]], and [[PRIM_TYPE_PRISM]]
** {{jira|SVC-680}}: Increase HTTP Response body size from 2048 to 4096 or larger
** {{jira|SVC-5488}}: [[llGetAgentList|llGetRegionAgents]]() -- returns list of agent keys in the current region
** {{jira|SVC-6894}}: Excessive EnableSimulator message spamming to viewers
** {{jira|SVC-7307}}: creation of scripts gets a nice error
* '''Avatar Fly Height Restriction is being raised to 5,000m.'''

=== 12.03.30.252593 ===
* This is the same code that is on the main channel.
** Scheduled 2012-04-11
* '''The explicit ban height for parcels is being raised to 5000m.''' This means that avatars that are explicitly banned from a parcel can not enter them unless they are at least 5000m above ground. This allows high-altitude fly-overs as before, but they must be done at a much higher altitude.
* This is on all RC channels.
** https://wiki.secondlife.com/wiki/Release_Notes/Second_Life_RC_LeTigre/12#12.03.30.252593
** https://wiki.secondlife.com/wiki/Release_Notes/Second_Life_RC_BlueSteel/12#12.03.30.252593

=== 12.03.30.252637 ===
* This is again the "threaded region crossing" project. scheduled 2012-04-04
* Features
** Prototype threaded region cross for agents. Uses the new threaded RPC/thread state machine mechanism.
* Bug Fixes
** Fixed some crash modes that were discovered in the previous iteration of this project
** Fixed new crash modes.
* Merged with Server Trunk: https://wiki.secondlife.com/wiki/Release_Notes/Second_Life_Server/12#12.03.26.252149

=== 12.03.25.252046 ===
* This is again the "threaded region crossing" project. scheduled 2012-03-28
* Features
** Prototype threaded region cross for agents. Uses the new threaded RPC/thread state machine mechanism.
* Bug Fixes
** Fixed some crash modes that were discovered in the previous iteration of this project
** Fixed new crash modes.

=== 12.03.20.251556 ===
* This is again the "threaded region crossing" project. scheduled 2012-03-21
* Features
** Prototype threaded region cross for agents. Uses the new threaded RPC/thread state machine mechanism.
* Bug Fixes
** Fixed some crash modes that were discovered in the previous iteration of this project
* Merged with Server Trunk: https://wiki.secondlife.com/wiki/Release_Notes/Second_Life_Server/12#12.02.24.249991
* This version is on all 3 RC channels, this week

===12.02.24.249991===
* This was rolled back to this code on 2012-03-08
* This is a server maintenance project
* Bug Fixes
** {{jira|SVC-7631}} New rate throttle on [[llGiveInventory]]. The throttle was loosened to 2.5k events per 15 minutes, double the previous value.
** {{jira|SVC-7660}} [[http_request]]() fails to trigger on RC Magnum 12.01.27.248571
** Fixed some other miscellaneous bugs, including a few crashers
* This channel is set to match the main channel trunk code: https://wiki.secondlife.com/wiki/Release_Notes/Second_Life_Server/12#12.02.24.249991

===12.03.02.250419===
* This is again the "threaded region crossing" project scheduled 2012-03-07
* Features
** Prototype threaded region cross for agents. Uses the new threaded RPC/thread state machine mechanism.
* Bug Fixes
** The ghosting issue has been patched.
** Fixed some cases in which avatars got 'stuck' and couldn't TP
* Merged with Server Trunk: https://wiki.secondlife.com/wiki/Release_Notes/Second_Life_Server/12#12.02.24.249991

===12.02.28.250112===
* This "threaded region crossing" project scheduled 2012-02-29
* Features
** Prototype threaded region cross for agents. Uses the new threaded RPC/thread state machine mechanism.
* Bug Fixes
** The ghosting issue has been patched.
** Fixed some cases in which avatars got 'stuck' and couldn't TP

===12.02.21.249728===
* This "threaded region crossing" project scheduled 2012-02-22
* Features
** Prototype threaded region cross for agents. Uses the new threaded RPC/thread state machine mechanism.
* Bug Fixes
** The ghosting issue has been patched.

===12.02.02.248748===
* This "threaded region crossing" project scheduled 2012-02-15
* Features
** Prototype threaded region cross for agents. Uses the new threaded RPC/thread state machine mechanism.
* Bug Fixes
** The ghosting issue has been patched.

===12.02.06.248938===
* This "maint-server" project scheduled 2012-02-08
* Improved performance for the following functions in LSL scripts compiled to Mono:
** [[llList2List]]
** [[llDeleteSubList]]
** [[llGetListEntryType]]
** [[llListInsertList]]
** [[llListFindList]]
** [[llListReplaceList]]
** [[llDeleteSubString]]
** [[llStringLength]]
** [[llInsertString]]
** [[llSubStringIndex]]
* Bug Fixes
** {{jira|SCR-121}} Entire sim (65,536sq.m.) owned by group, [[llGetParcelMaxPrims]]([[llGetPos]](), TRUE) Returning odd number.
** {{jira|SVC-7348}} [[moving_end]]() [[event]] executes on moving, script-rezzed physical objects
** {{jira|SVC-7443}} Telehubs overridden if teleporting a friend/avatar to a region where telehub exists outside of the telehub area
** Fixed 1 simulator crash related to the physics engine
* Made improvements in code for starting and stopping regions
* Internal code improvements with better memory management and more efficient object updates
* Fixed data in CoarseLocationUpdate messages for avatars above 1020m. These are now sent with a value of 255, which was previously sent as 0 in error. This fixes numerous mini-map issues with avatar relative altitude indicators.
* Fixed a script crasher in [[llList2List]].
** {{jira|SVC-7650}} Color change not applied correctly on cylinder when number of faces is change by altering prim properties.
** Fixed another problem that broke some sims.
* This code is also on BlueSteel and LeTigre.
* https://wiki.secondlife.com/wiki/Release_Notes/Second_Life_RC_BlueSteel/12#12.02.06.248938
* https://wiki.secondlife.com/wiki/Release_Notes/Second_Life_RC_LeTigre/12#12.02.06.248938

===12.01.27.248571===
* This "maint-server" project scheduled 2012-02-01
* Improved performance for the following functions in LSL scripts compiled to Mono:
** [[llList2List]]
** [[llDeleteSubList]]
** [[llGetListEntryType]]
** [[llListInsertList]]
** [[llListFindList]]
** [[llListReplaceList]]
** [[llDeleteSubString]]
** [[llStringLength]]
** [[llInsertString]]
** [[llSubStringIndex]]
* Bug Fixes
** {{jira|SCR-121}} Entire sim (65,536sq.m.) owned by group, [[llGetParcelMaxPrims]]([[llGetPos]](), TRUE) Returning odd number.
** {{jira|SVC-7348}} [[moving_end]]() [[event]] executes on moving, script-rezzed physical objects
** {{jira|SVC-7443}} Telehubs overridden if teleporting a friend/avatar to a region where telehub exists outside of the telehub area
** Fixed 1 simulator crash related to the physics engine
* Made improvements in code for starting and stopping regions
* Internal code improvements with better memory management and more efficient object updates
* Fixed data in CoarseLocationUpdate messages for avatars above 1020m. These are now sent with a value of 255, which was previously sent as 0 in error. This fixes numerous mini-map issues with avatar relative altitude indicators.
* Fixed a script crasher in [[llList2List]].
* This code is also on BlueSteel and LeTigre.
* https://wiki.secondlife.com/wiki/Release_Notes/Second_Life_RC_BlueSteel/12#12.01.27.248571
* https://wiki.secondlife.com/wiki/Release_Notes/Second_Life_RC_LeTigre/12#12.01.27.248571

===12.01.24.248357===
* This "maint-server" project scheduled 2012-01-25
*Features
* New LSL function integer [[llSetRegionPos]](vector position)
*: The object with the script will move the root prim position to the given location. The position is any position within the region. If the position is below ground, it will be set to the ground level at that X,Y spot. The function has no delay or throttle.
*:* Returns 1 if the object is successfully placed within 0.1 m of position.
*:* Returns 0 and does not move the object if position is more than 10m off region or above 4096m.
*:* Returns 0 and does not move the object if the object is dynamic (has physics enabled).
*:* Returns 0 and does not move the object if the object can not move to position due to object entry rules, prim limits, bans, etc.
* "frame_number" option added to [[llGetEnv]]()
*: Returns an integer that represents the current 'frame' of the simulator. Generally only useful for specific debugging cases.
* Bug Fixes
** {{jira|SVC-7466}} A notecard holds more data than a script can read
** {{jira|SVC-7520}} Keyframe motion doesn't move towards the correct position when specified time is not an exact multiple of 1/45 seconds
** {{jira|SVC-7485}} [[llSetKeyframedMotion]] cannot stop animation if none is running ... sounds less important than it is ...
** {{jira|SVC-7493}} Weird mesh land impact issue
** Fixed several simulator crash bugs and potential memory leaks.
** Fixed a notecard crashing bug.
** {{jira|SVC-7613}} Greatly increased network activity since the 1/18/12 RC channel rolling restart
** {{jira|SVC-7608}} Sims are not visible when diagonally opposed. (this was not a simulator-side fix, but the bug was originally visible only in the previous iteration of this project)

===12.01.13.247734===
* This "maint-server" project scheduled 2012-01-18
* The project originally here had a script crashing issue and was rolled to the same RC code on the other channels.
*Features
* New LSL function integer [[llSetRegionPos]](vector position)
*: The object with the script will move the root prim position to the given location. The position is any position within the region. If the position is below ground, it will be set to the ground level at that X,Y spot. The function has no delay or throttle.
*:* Returns 1 if the object is successfully placed within 0.1 m of position.
*:* Returns 0 and does not move the object if position is more than 10m off region or above 4096m.
*:* Returns 0 and does not move the object if the object is dynamic (has physics enabled).
*:* Returns 0 and does not move the object if the object can not move to position due to object entry rules, prim limits, bans, etc.
* "frame_number" option added to [[llGetEnv]]()
*: Returns an integer that represents the current 'frame' of the simulator. Generally only useful for specific debugging cases.
* Bug Fixes
** {{jira|SVC-7466}} A notecard holds more data than a script can read
** {{jira|SVC-7520}} Keyframe motion doesn't move towards the correct position when specified time is not an exact multiple of 1/45 seconds
** {{jira|SVC-7485}} [[llSetKeyframedMotion]] cannot stop animation if none is running ... sounds less important than it is ...
** {{jira|SVC-7493}} Weird mesh land impact issue
** Fixed several simulator crash bugs and potential memory leaks.
** Fixed a notecard crashing bug.

===12.01.06.247303===
* This "maint-server" project scheduled 2012-01-11
* Bug Fixes
** {{jira|SVC-7540}} Offline email notifications received but never delivered on login.

[[Category:Server Release Notes]]

Template:Pathfinding alpha

2012-08-01T22:06:21Z

Stinson Linden:

{{KBwarning | This documentation is for the server candidate release of LSL pathfinding. These LSL functions are available only on selected regions on the main grid. For more information, see the [[Beta/Magnum|Magnum channel release notes]]. }}
 
[[Category:Pathfinding]]{{#vardefine:moded|fr{{#var:moded}}}}

Pathfinding Tools in the Second Life Viewer

2012-08-01T21:57:56Z

Stinson Linden:

Pathfinding Tools in the Second Life Viewer

2012-08-01T18:14:51Z

Stinson Linden: /* Known Issues */

{{Pathfinding Nav}}
__TOC__
{{KBnote|The Viewer tools described here are not yet available in a public Second Life Viewer build, but will be soon. }}
== Introduction ==
For pathfinding, each region has a navigation mesh, commonly referred to as a "'''navmesh'''". The '''navmesh''' is a representation of the region's geometry generated and used by the physics simulator to determine paths for the pathfinding characters. The navmesh may be in one of the following three states:

* Up-to-date
* Has pending changes
* Building ''(a.k.a. rebaking)''

The navmesh will transition through these states according to the following diagram:

[[File:Navmesh_transitions.png|alt=Second Life Pathfinding NavMesh Transitions|Second Life Pathfinding NavMesh Transitions]]

Five new elements have been added to the SL Viewer interface to communicate the navmesh state for the current region. These new elements are:

* icon representations of the pathfinding region state for the SLURL bar
* a "Rebake region" button that appears above the lower toolbar
* a right-click context menu option addition
* an additional field on the Build floater
* an additional field on the Object Profile floater

In addition to these new elements, three new floaters allow users to more efficiently create, visualize, test, and debug pathfinding-enabled characters. These tools are not required to create pathfinding behaviors but are particularly useful to builders and experienced creators in Second Life. These new floaters are:

* Pathfinding linksets
* Pathfinding characters
* Pathfinding view / test

== Pathfinding UI Elements ==

'''Note that other residents editing pathfinding objects on the same region may create pending changes to the navmesh.''' When this occurs, all residents on the same region and with build rights will see the appropriate SLURL bar icons and rebake region button.

=== Pathfinding Icons in SLURL Bar ===

The SLURL bar indicates the three pathfinding states of the current region.
# '''Navmesh is up-to-date''' The current region's navmesh is up-to-date. No icon is shown as this is the expected default state. [[File:Pathfinding-clean-region-1.png|alt=Second Life URL Bar with Up-to-Date NavMesh Icon|Second Life URL Bar with Up-to-Date NavMesh Icon]]
# '''Navmesh has pending changes''' The region has pending changes that have not yet been baked into the navmesh. A pathfinding icon with a construction symbol is shown. [[File:Pathfinding-dirty-region-1.png|alt=Second Life URL Bar with Pending Changes Icon|Second Life URL Bar with Pending Changes Icon]]
# '''Dynamic pathfinding is disabled''' The region has dynamic pathfinding disabled. Pathfinding characters will not work as expected. A pathfinding icon with a disabled symbol is shown. [[File:Pathfinding-disabled-region-1.png|alt=Second Life URL Bar with Pathfinding Disabled Icon|Second Life URL Bar with Pathfinding Disabled Icon]]

=== Rebake Region Button ===

When a region has pending changes, the appropriate icon will be shown in the SLURL bar, as described above. In addition, if the user has build rights for any parcel on the current region, the user will also be able to see a "Rebake region" button that displays above the lower toolbar.

[[File:Rebake-button-1.png|alt=Second Life Rebake Region button that allows permitted users to rebake pathfinding changes into the navmesh]]

When the user clicks this button, a request is sent to the region to rebake the navmesh for the current region. As rebaking a region may be a time intensive process, the button will change to indicate "Region is rebaking" during this server process. After the rebaking is complete, this button on the viewer will vanish.

[[File:Rebaking-button-1.png|alt=Second Life Region is Rebaking button that indicates that the current region is rebaking its navmesh]]

=== Right-click context menu behavior ===

When right-clicking on an object in-world, pathfinding-specific menu options may be included in the pop-up context menu.

If the user right-clicks on a '''linkset''' object in-world, a menu option "Show in linksets" will allow the user to open the Pathfinding Linksets floater with the current object selected.

[[File:Right-click-show-in-linksets-1.png|alt=Second Life Context Menu with Show in Linksets floater menu option]]

If the user right-clicks on a pathfinding '''character''' object in-world, a menu option "Show in characters" will allow the user to open the Pathfinding Characters floater with the current object selected.

[[File:Right-click-show-in-characters-1.png|alt=Second Life Context Menu with Show in Characters floater menu option]]

=== Additional field on the Build floater ===

The Build floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Build floater with a ''character'' object selected.

[[File:Build-floater-character-1.png|alt=Build floater with pathfinding attribute character|Build floater with pathfinding attribute character]]

The following image is a screenshot of the Build floater with an object that ''affects navmesh'' selected. This object could be a ''walkable'', ''static obstacle'', ''material volume'', or ''exclusion volume''.

[[File:Build-floater-affects-navmesh-1.png|alt=Build floater with pathfinding attribute affects navmesh|Build floater with pathfinding attribute affects navmesh]]

{{KBwarning|For linksets that do affect the navmesh, it will be impossible to modify the object across the region boundary. The user and the object affecting a navmesh must be in the same region to enable modification of the object. This will be indicated on the General tab of the Build floater as illustrated in the following screenshot.}}
[[File:Build-floater-region-boundary-1.png|alt=Build floater indicating that the user cannot modify object across a region boundary|Build floater indicating that the user cannot modify object across a region boundary]]

=== Additional field on the Object Profile floater ===

Similar to the afore-described Build floater, the Object Profile floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Object Profile floater with an ''affects navmesh'' object selected.

[[File:Object-profile-1.png|alt=Object Profile floater with pathfinding attribute affects navmesh|Object Profile floater with pathfinding attribute affects navmesh]]

== Pathfinding Floaters ==

These three pathfinding floaters may all be accessed through the Build->Pathfinding menu in the Project Viewer - Pathfinding.

[[File:Build-menu-pf-selected-1.png|alt=Second Life Build Menu with new Pathfinding menu items|SL Build -> Pathfinding Menu]]

 

=== Pathfinding Linksets Floater ===

==== Overview ====

The intent of the Pathfinding Linksets floater is to give advanced users and builders the ability to customize an area to achieve interesting effects with pathfinding-enabled characters.

The floater displays information for all linksets within the current region for which the user has the ability to alter. The table reports useful information including
* Linkset Name
* Description
* Owner
* Land Impact
* Distance from the resident's avatar
* Linkset Use
** Potential values
*** Walkable
*** Static Obstacle
*** Movable Obstacle
*** Material Volume
*** Exclusion Volume
*** Movable Phantom
* Walkability Coefficients
** Character Type A ''(example use: humanoid)''
** Character Type B ''(example use: creature)''
** Character Type C ''(example use: mechanical)''
** Character Type D ''(example use: other)''

Additionally, selecting any linksets within the floater will also select the object(s) within the Viewer.

[[File:Linksets-floater-2.png|alt=Pathfinding Linksets floater|Pathfinding Linksets]]

 

==== Controls ====

{{:Viewerhelp:Pathfinding linksets}}

==== Example use ====

The advanced users and builders will use the Pathfinding Linksets floater to customize areas to create interesting effects for pathfinding-enabled characters.

For instance, imagine the scenario of a builder constructing a single room in a pathfinding-enabled house. For the single room, the builder would use the following types as follows:

{|border="1"
! Linkset Use !! Description
|-
|width="200" align="center" | Walkable || align="left" | The floor linkset would be set to be Walkable to allow characters to move across the floor.
|-
|width="200" align="center" | Static Obstacle || align="left" | A desk linkset in the room would be set to be Static Obstacle to block characters from walking through or across the object.

NOTE Any object that should block character movement and that does not move should be marked as Static Obstacle to improve performance of pathfinding characters.
|-
|width="200" align="center" | Movable Obstacle || align="left" | A door linkset in the room would be set to be Movable Obstacle. This will still block characters but, in contrast to Static Obstacles, Movable Obstacles will allow the linkset itself to move. In the case of the door, this will allow the door to open and close, but will still prevent characters from walking through the door.
|-
|width="200" align="center" | Material Volume || align="left" | Material Volumes are phantom objects that can be used to affect the walkability coefficients of intersecting objects. Imagine that the builder applied a texture to the floor. Also, imagine that the floor texture includes small throw rug in the middle of the room. (The builder did not want to create a separate object for the rug, so is using a texture on the floor to give the appearance of a rug). The builder can then create a Material Volume object intersecting the floor at the location of the rug. Then, by setting a lower walkability coefficient for the Material Volume, the builder will create the affect of slowing down characters as the characters traverse across the painted rug area.
|-
|width="200" align="center" | Exclusion Volume || align="left" | Exclusion Volumes are phantom objects that can be used to create areas where characters are prevented from moving. For instance, the builder can use an Exclusion Volume to create a section of the room where avatars would be able to move, but characters would be blocked from following.
|-
|width="200" align="center" | Movable Phantom || align="left" | Movable Phantoms are phantom objects that have no affect on pathfinding-enabled characters.
|}
 
In addition to linkset use attributes, builders can achieve additional effects by modifying the walkability coefficients for linksets. The walkability coefficients are values, ranging from 0% to 100%, that affect a characters speed. A walkability coefficient of 50% will reduce a character's speed by half while the character is traversing across the linkset.
 

=== Pathfinding Characters Floater ===

==== Overview ====
The intent of Pathfinding Characters floater is primarily for users to locate characters moving throughout a region and to identify the CPU cost of characters affecting the performance of a region.

The floater displays information for all characters within the current region for which the user has the ability to manipulate. The table reports useful information including
* Character Name
* Description
* Owner
* CPU Time
* Altitude

[[File:Characters-floater-1.png|alt=Pathfinding Characters floater|Pathfinding Characters]]
 
==== Controls ====

{{:Viewerhelp:Pathfinding characters}}

==== Example use ====
# If a region owner has created a pathfinding-enabled character but is unable to find the character within the region, the Characters floater can be used to locate and select the character.
# Additionally, the Pathfinding Characters floater reports the CPU time cost for each character within the region. This functionality can be used by advanced users to identify which characters are impacting performance the most.

=== Pathfinding View/Test Floater ===

==== Overview ====

The intent of the Pathfinding View/Test floater is for advanced users who are building pathfinding-enabled objects and characters.

This floater consists of 3 basic areas.

# Status area (illustrating both the Viewer and Simulator status of the region's navmesh)
# View tab Controls
# Test Path tab Controls

The following image is a screenshot of the Pathfinding View/Test floater with the navmesh displayed.

[[File:View-nav-mesh-1.png|alt=Pathfinding View/Test floater with the navmesh displayed|Pathfinding View/Test with navmesh displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with the pathfinding object types displayed.

[[File:View-pf-types-1.png|alt=Pathfinding View/Test floater with the pathfinding object types displayed|Pathfinding View/Test with the pathfinding object types displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with a test path displayed.

[[File:View-test-path-1.png|alt=Pathfinding View/Test floater with a test path displayed|Pathfinding View/Test with a test path displayed]]

 
==== Controls ====

{{:Viewerhelp:Pathfinding edit and test}}

==== Example Use ====

# The advanced user will use the Visualization controls to visualize how the navmesh and related permanent objects have been generated. By seeing this visualization of how the physics engine interprets the navigation information, the advanced user can understand how to better customize the pathfinding-enabled objects to obtain the desired behaviors of characters.
# The advanced user will use the Test Tab to visualize how a test character would choose the path between selected start and end points.

 

== Known Issues ==

{| style="border-style:solid;border-width:2px 0 2px 0px;"
! style="border-style:solid;border-width:0 0 1px 0" width="120" | JIRA
! style="border-style:solid;border-width:0 0 1px 0" width="500" | Summary
! style="border-style:solid;border-width:0 0 1px 0" | Hardware
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-572 PATH-572]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Underwater 'Walkables' shapes are reflected about the water plane
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-643 PATH-643]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Changes in Preferences dialog stops work of Pathfinding View/Test functionality
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-659 PATH-659]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | navmesh being drawn over worn flexi prims and under avatar
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-790 PATH-790]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Physics capsule rendering of character shapes is broken after zooming
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-812 PATH-812]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Show capsules option creates black capsule instead of blue
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | ATI Radeon X300 Video card ATI Radeon X600 Video card
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-814 PATH-814]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 laptop displays black environment</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 with AMD Radeon HD5650M Mobile graphics</del>
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-821 PATH-821]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop displays black environment
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop with AMD Radeon HD 4200 Mobile graphics
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-822 PATH-822]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Configuration with ATI Radeon 7500 can launch Viewer, serious GFx issues
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | AMD Athlon64 3000+ with ATI Radeon 7500 video card
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-826 PATH-826]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Random crash while wearing a mesh avatar and dropping objects in-world</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1291 MAINT-1291]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Enable Debug GL crashes the viewer to the desktop
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac Pro running 10.7.4 with AMD Radeon HD5770 iMac running Mac OS X Lion 10.7.4 (11E53) with AMD Radeon HD 6770M (512 MB) PC Clone running XP Pro with GeForce2 Ultra
|}

Pathfinding Tools in the Second Life Viewer

2012-07-26T01:23:17Z

Stinson Linden: /* Known Issues */

{{Pathfinding Nav}}
__TOC__
{{KBnote|The Viewer tools described here are not yet available in a public Second Life Viewer build, but will be soon. }}
== Introduction ==
For pathfinding, each region has a navigation mesh, commonly referred to as a "'''navmesh'''". The '''navmesh''' is a representation of the region's geometry generated and used by the physics simulator to determine paths for the pathfinding characters. The navmesh may be in one of the following three states:

* Up-to-date
* Has pending changes
* Building ''(a.k.a. rebaking)''

The navmesh will transition through these states according to the following diagram:

[[File:Navmesh_transitions.png|alt=Second Life Pathfinding NavMesh Transitions|Second Life Pathfinding NavMesh Transitions]]

Five new elements have been added to the SL Viewer interface to communicate the navmesh state for the current region. These new elements are:

* icon representations of the pathfinding region state for the SLURL bar
* a "Rebake region" button that appears above the lower toolbar
* a right-click context menu option addition
* an additional field on the Build floater
* an additional field on the Object Profile floater

In addition to these new elements, three new floaters allow users to more efficiently create, visualize, test, and debug pathfinding-enabled characters. These tools are not required to create pathfinding behaviors but are particularly useful to builders and experienced creators in Second Life. These new floaters are:

* Pathfinding linksets
* Pathfinding characters
* Pathfinding view / test

== Pathfinding UI Elements ==

'''Note that other residents editing pathfinding objects on the same region may create pending changes to the navmesh.''' When this occurs, all residents on the same region and with build rights will see the appropriate SLURL bar icons and rebake region button.

=== Pathfinding Icons in SLURL Bar ===

The SLURL bar indicates the three pathfinding states of the current region.
# '''Navmesh is up-to-date''' The current region's navmesh is up-to-date. No icon is shown as this is the expected default state. [[File:Pathfinding-clean-region-1.png|alt=Second Life URL Bar with Up-to-Date NavMesh Icon|Second Life URL Bar with Up-to-Date NavMesh Icon]]
# '''Navmesh has pending changes''' The region has pending changes that have not yet been baked into the navmesh. A pathfinding icon with a construction symbol is shown. [[File:Pathfinding-dirty-region-1.png|alt=Second Life URL Bar with Pending Changes Icon|Second Life URL Bar with Pending Changes Icon]]
# '''Dynamic pathfinding is disabled''' The region has dynamic pathfinding disabled. Pathfinding characters will not work as expected. A pathfinding icon with a disabled symbol is shown. [[File:Pathfinding-disabled-region-1.png|alt=Second Life URL Bar with Pathfinding Disabled Icon|Second Life URL Bar with Pathfinding Disabled Icon]]

=== Rebake Region Button ===

When a region has pending changes, the appropriate icon will be shown in the SLURL bar, as described above. In addition, if the user has build rights for any parcel on the current region, the user will also be able to see a "Rebake region" button that displays above the lower toolbar.

[[File:Rebake-button-1.png|alt=Second Life Rebake Region button that allows permitted users to rebake pathfinding changes into the navmesh]]

When the user clicks this button, a request is sent to the region to rebake the navmesh for the current region. As rebaking a region may be a time intensive process, the button will change to indicate "Region is rebaking" during this server process. After the rebaking is complete, this button on the viewer will vanish.

[[File:Rebaking-button-1.png|alt=Second Life Region is Rebaking button that indicates that the current region is rebaking its navmesh]]

=== Right-click context menu behavior ===

When right-clicking on an object in-world, pathfinding-specific menu options may be included in the pop-up context menu.

If the user right-clicks on a '''linkset''' object in-world, a menu option "Show in linksets" will allow the user to open the Pathfinding Linksets floater with the current object selected.

[[File:Right-click-show-in-linksets-1.png|alt=Second Life Context Menu with Show in Linksets floater menu option]]

If the user right-clicks on a pathfinding '''character''' object in-world, a menu option "Show in characters" will allow the user to open the Pathfinding Characters floater with the current object selected.

[[File:Right-click-show-in-characters-1.png|alt=Second Life Context Menu with Show in Characters floater menu option]]

=== Additional field on the Build floater ===

The Build floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Build floater with a ''character'' object selected.

[[File:Build-floater-character-1.png|alt=Build floater with pathfinding attribute character|Build floater with pathfinding attribute character]]

The following image is a screenshot of the Build floater with an object that ''affects navmesh'' selected. This object could be a ''walkable'', ''static obstacle'', ''material volume'', or ''exclusion volume''.

[[File:Build-floater-affects-navmesh-1.png|alt=Build floater with pathfinding attribute affects navmesh|Build floater with pathfinding attribute affects navmesh]]

{{KBwarning|For linksets that do affect the navmesh, it will be impossible to modify the object across the region boundary. The user and the object affecting a navmesh must be in the same region to enable modification of the object. This will be indicated on the General tab of the Build floater as illustrated in the following screenshot.}}
[[File:Build-floater-region-boundary-1.png|alt=Build floater indicating that the user cannot modify object across a region boundary|Build floater indicating that the user cannot modify object across a region boundary]]

=== Additional field on the Object Profile floater ===

Similar to the afore-described Build floater, the Object Profile floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Object Profile floater with an ''affects navmesh'' object selected.

[[File:Object-profile-1.png|alt=Object Profile floater with pathfinding attribute affects navmesh|Object Profile floater with pathfinding attribute affects navmesh]]

== Pathfinding Floaters ==

These three pathfinding floaters may all be accessed through the Build->Pathfinding menu in the Project Viewer - Pathfinding.

[[File:Build-menu-pf-selected-1.png|alt=Second Life Build Menu with new Pathfinding menu items|SL Build -> Pathfinding Menu]]

 

=== Pathfinding Linksets Floater ===

==== Overview ====

The intent of the Pathfinding Linksets floater is to give advanced users and builders the ability to customize an area to achieve interesting effects with pathfinding-enabled characters.

The floater displays information for all linksets within the current region for which the user has the ability to alter. The table reports useful information including
* Linkset Name
* Description
* Owner
* Land Impact
* Distance from the resident's avatar
* Linkset Use
** Potential values
*** Walkable
*** Static Obstacle
*** Movable Obstacle
*** Material Volume
*** Exclusion Volume
*** Movable Phantom
* Walkability Coefficients
** Character Type A ''(example use: humanoid)''
** Character Type B ''(example use: creature)''
** Character Type C ''(example use: mechanical)''
** Character Type D ''(example use: other)''

Additionally, selecting any linksets within the floater will also select the object(s) within the Viewer.

[[File:Linksets-floater-2.png|alt=Pathfinding Linksets floater|Pathfinding Linksets]]

 

==== Controls ====

{{:Viewerhelp:Pathfinding linksets}}

==== Example use ====

The advanced users and builders will use the Pathfinding Linksets floater to customize areas to create interesting effects for pathfinding-enabled characters.

For instance, imagine the scenario of a builder constructing a single room in a pathfinding-enabled house. For the single room, the builder would use the following types as follows:

{|border="1"
! Linkset Use !! Description
|-
|width="200" align="center" | Walkable || align="left" | The floor linkset would be set to be Walkable to allow characters to move across the floor.
|-
|width="200" align="center" | Static Obstacle || align="left" | A desk linkset in the room would be set to be Static Obstacle to block characters from walking through or across the object.

NOTE Any object that should block character movement and that does not move should be marked as Static Obstacle to improve performance of pathfinding characters.
|-
|width="200" align="center" | Movable Obstacle || align="left" | A door linkset in the room would be set to be Movable Obstacle. This will still block characters but, in contrast to Static Obstacles, Movable Obstacles will allow the linkset itself to move. In the case of the door, this will allow the door to open and close, but will still prevent characters from walking through the door.
|-
|width="200" align="center" | Material Volume || align="left" | Material Volumes are phantom objects that can be used to affect the walkability coefficients of intersecting objects. Imagine that the builder applied a texture to the floor. Also, imagine that the floor texture includes small throw rug in the middle of the room. (The builder did not want to create a separate object for the rug, so is using a texture on the floor to give the appearance of a rug). The builder can then create a Material Volume object intersecting the floor at the location of the rug. Then, by setting a lower walkability coefficient for the Material Volume, the builder will create the affect of slowing down characters as the characters traverse across the painted rug area.
|-
|width="200" align="center" | Exclusion Volume || align="left" | Exclusion Volumes are phantom objects that can be used to create areas where characters are prevented from moving. For instance, the builder can use an Exclusion Volume to create a section of the room where avatars would be able to move, but characters would be blocked from following.
|-
|width="200" align="center" | Movable Phantom || align="left" | Movable Phantoms are phantom objects that have no affect on pathfinding-enabled characters.
|}
 
In addition to linkset use attributes, builders can achieve additional effects by modifying the walkability coefficients for linksets. The walkability coefficients are values, ranging from 0% to 100%, that affect a characters speed. A walkability coefficient of 50% will reduce a character's speed by half while the character is traversing across the linkset.
 

=== Pathfinding Characters Floater ===

==== Overview ====
The intent of Pathfinding Characters floater is primarily for users to locate characters moving throughout a region and to identify the CPU cost of characters affecting the performance of a region.

The floater displays information for all characters within the current region for which the user has the ability to manipulate. The table reports useful information including
* Character Name
* Description
* Owner
* CPU Time
* Altitude

[[File:Characters-floater-1.png|alt=Pathfinding Characters floater|Pathfinding Characters]]
 
==== Controls ====

{{:Viewerhelp:Pathfinding characters}}

==== Example use ====
# If a region owner has created a pathfinding-enabled character but is unable to find the character within the region, the Characters floater can be used to locate and select the character.
# Additionally, the Pathfinding Characters floater reports the CPU time cost for each character within the region. This functionality can be used by advanced users to identify which characters are impacting performance the most.

=== Pathfinding View/Test Floater ===

==== Overview ====

The intent of the Pathfinding View/Test floater is for advanced users who are building pathfinding-enabled objects and characters.

This floater consists of 3 basic areas.

# Status area (illustrating both the Viewer and Simulator status of the region's navmesh)
# View tab Controls
# Test Path tab Controls

The following image is a screenshot of the Pathfinding View/Test floater with the navmesh displayed.

[[File:View-nav-mesh-1.png|alt=Pathfinding View/Test floater with the navmesh displayed|Pathfinding View/Test with navmesh displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with the pathfinding object types displayed.

[[File:View-pf-types-1.png|alt=Pathfinding View/Test floater with the pathfinding object types displayed|Pathfinding View/Test with the pathfinding object types displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with a test path displayed.

[[File:View-test-path-1.png|alt=Pathfinding View/Test floater with a test path displayed|Pathfinding View/Test with a test path displayed]]

 
==== Controls ====

{{:Viewerhelp:Pathfinding edit and test}}

==== Example Use ====

# The advanced user will use the Visualization controls to visualize how the navmesh and related permanent objects have been generated. By seeing this visualization of how the physics engine interprets the navigation information, the advanced user can understand how to better customize the pathfinding-enabled objects to obtain the desired behaviors of characters.
# The advanced user will use the Test Tab to visualize how a test character would choose the path between selected start and end points.

 

== Known Issues ==

{| style="border-style:solid;border-width:2px 0 2px 0px;"
! style="border-style:solid;border-width:0 0 1px 0" width="120" | JIRA
! style="border-style:solid;border-width:0 0 1px 0" width="500" | Summary
! style="border-style:solid;border-width:0 0 1px 0" | Hardware
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-572 PATH-572]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Underwater 'Walkables' shapes are reflected about the water plane
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-643 PATH-643]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Changes in Preferences dialog stops work of Pathfinding View/Test functionality
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-659 PATH-659]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | navmesh being drawn over worn flexi prims and under avatar
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-790 PATH-790]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Physics capsule rendering of character shapes is broken after zooming
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-812 PATH-812]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Show capsules option creates black capsule instead of blue
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | ATI Radeon X300 Video card ATI Radeon X600 Video card
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-814 PATH-814]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 laptop displays black environment</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 with AMD Radeon HD5650M Mobile graphics</del>
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-821 PATH-821]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop displays black environment
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop with AMD Radeon HD 4200 Mobile graphics
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-822 PATH-822]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Configuration with ATI Radeon 7500 can launch Viewer, serious GFx issues
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | AMD Athlon64 3000+ with ATI Radeon 7500 video card
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-826 PATH-826]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Random crash while wearing a mesh avatar and dropping objects in-world
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1291 MAINT-1291]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Enable Debug GL crashes the viewer to the desktop
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac Pro running 10.7.4 with AMD Radeon HD5770 iMac running Mac OS X Lion 10.7.4 (11E53) with AMD Radeon HD 6770M (512 MB) PC Clone running XP Pro with GeForce2 Ultra
|}

Pathfinding Tools in the Second Life Viewer

2012-07-26T01:17:51Z

Stinson Linden: /* Known Issues */

{{Pathfinding Nav}}
__TOC__
{{KBnote|The Viewer tools described here are not yet available in a public Second Life Viewer build, but will be soon. }}
== Introduction ==
For pathfinding, each region has a navigation mesh, commonly referred to as a "'''navmesh'''". The '''navmesh''' is a representation of the region's geometry generated and used by the physics simulator to determine paths for the pathfinding characters. The navmesh may be in one of the following three states:

* Up-to-date
* Has pending changes
* Building ''(a.k.a. rebaking)''

The navmesh will transition through these states according to the following diagram:

[[File:Navmesh_transitions.png|alt=Second Life Pathfinding NavMesh Transitions|Second Life Pathfinding NavMesh Transitions]]

Five new elements have been added to the SL Viewer interface to communicate the navmesh state for the current region. These new elements are:

* icon representations of the pathfinding region state for the SLURL bar
* a "Rebake region" button that appears above the lower toolbar
* a right-click context menu option addition
* an additional field on the Build floater
* an additional field on the Object Profile floater

In addition to these new elements, three new floaters allow users to more efficiently create, visualize, test, and debug pathfinding-enabled characters. These tools are not required to create pathfinding behaviors but are particularly useful to builders and experienced creators in Second Life. These new floaters are:

* Pathfinding linksets
* Pathfinding characters
* Pathfinding view / test

== Pathfinding UI Elements ==

'''Note that other residents editing pathfinding objects on the same region may create pending changes to the navmesh.''' When this occurs, all residents on the same region and with build rights will see the appropriate SLURL bar icons and rebake region button.

=== Pathfinding Icons in SLURL Bar ===

The SLURL bar indicates the three pathfinding states of the current region.
# '''Navmesh is up-to-date''' The current region's navmesh is up-to-date. No icon is shown as this is the expected default state. [[File:Pathfinding-clean-region-1.png|alt=Second Life URL Bar with Up-to-Date NavMesh Icon|Second Life URL Bar with Up-to-Date NavMesh Icon]]
# '''Navmesh has pending changes''' The region has pending changes that have not yet been baked into the navmesh. A pathfinding icon with a construction symbol is shown. [[File:Pathfinding-dirty-region-1.png|alt=Second Life URL Bar with Pending Changes Icon|Second Life URL Bar with Pending Changes Icon]]
# '''Dynamic pathfinding is disabled''' The region has dynamic pathfinding disabled. Pathfinding characters will not work as expected. A pathfinding icon with a disabled symbol is shown. [[File:Pathfinding-disabled-region-1.png|alt=Second Life URL Bar with Pathfinding Disabled Icon|Second Life URL Bar with Pathfinding Disabled Icon]]

=== Rebake Region Button ===

When a region has pending changes, the appropriate icon will be shown in the SLURL bar, as described above. In addition, if the user has build rights for any parcel on the current region, the user will also be able to see a "Rebake region" button that displays above the lower toolbar.

[[File:Rebake-button-1.png|alt=Second Life Rebake Region button that allows permitted users to rebake pathfinding changes into the navmesh]]

When the user clicks this button, a request is sent to the region to rebake the navmesh for the current region. As rebaking a region may be a time intensive process, the button will change to indicate "Region is rebaking" during this server process. After the rebaking is complete, this button on the viewer will vanish.

[[File:Rebaking-button-1.png|alt=Second Life Region is Rebaking button that indicates that the current region is rebaking its navmesh]]

=== Right-click context menu behavior ===

When right-clicking on an object in-world, pathfinding-specific menu options may be included in the pop-up context menu.

If the user right-clicks on a '''linkset''' object in-world, a menu option "Show in linksets" will allow the user to open the Pathfinding Linksets floater with the current object selected.

[[File:Right-click-show-in-linksets-1.png|alt=Second Life Context Menu with Show in Linksets floater menu option]]

If the user right-clicks on a pathfinding '''character''' object in-world, a menu option "Show in characters" will allow the user to open the Pathfinding Characters floater with the current object selected.

[[File:Right-click-show-in-characters-1.png|alt=Second Life Context Menu with Show in Characters floater menu option]]

=== Additional field on the Build floater ===

The Build floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Build floater with a ''character'' object selected.

[[File:Build-floater-character-1.png|alt=Build floater with pathfinding attribute character|Build floater with pathfinding attribute character]]

The following image is a screenshot of the Build floater with an object that ''affects navmesh'' selected. This object could be a ''walkable'', ''static obstacle'', ''material volume'', or ''exclusion volume''.

[[File:Build-floater-affects-navmesh-1.png|alt=Build floater with pathfinding attribute affects navmesh|Build floater with pathfinding attribute affects navmesh]]

{{KBwarning|For linksets that do affect the navmesh, it will be impossible to modify the object across the region boundary. The user and the object affecting a navmesh must be in the same region to enable modification of the object. This will be indicated on the General tab of the Build floater as illustrated in the following screenshot.}}
[[File:Build-floater-region-boundary-1.png|alt=Build floater indicating that the user cannot modify object across a region boundary|Build floater indicating that the user cannot modify object across a region boundary]]

=== Additional field on the Object Profile floater ===

Similar to the afore-described Build floater, the Object Profile floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Object Profile floater with an ''affects navmesh'' object selected.

[[File:Object-profile-1.png|alt=Object Profile floater with pathfinding attribute affects navmesh|Object Profile floater with pathfinding attribute affects navmesh]]

== Pathfinding Floaters ==

These three pathfinding floaters may all be accessed through the Build->Pathfinding menu in the Project Viewer - Pathfinding.

[[File:Build-menu-pf-selected-1.png|alt=Second Life Build Menu with new Pathfinding menu items|SL Build -> Pathfinding Menu]]

 

=== Pathfinding Linksets Floater ===

==== Overview ====

The intent of the Pathfinding Linksets floater is to give advanced users and builders the ability to customize an area to achieve interesting effects with pathfinding-enabled characters.

The floater displays information for all linksets within the current region for which the user has the ability to alter. The table reports useful information including
* Linkset Name
* Description
* Owner
* Land Impact
* Distance from the resident's avatar
* Linkset Use
** Potential values
*** Walkable
*** Static Obstacle
*** Movable Obstacle
*** Material Volume
*** Exclusion Volume
*** Movable Phantom
* Walkability Coefficients
** Character Type A ''(example use: humanoid)''
** Character Type B ''(example use: creature)''
** Character Type C ''(example use: mechanical)''
** Character Type D ''(example use: other)''

Additionally, selecting any linksets within the floater will also select the object(s) within the Viewer.

[[File:Linksets-floater-2.png|alt=Pathfinding Linksets floater|Pathfinding Linksets]]

 

==== Controls ====

{{:Viewerhelp:Pathfinding linksets}}

==== Example use ====

The advanced users and builders will use the Pathfinding Linksets floater to customize areas to create interesting effects for pathfinding-enabled characters.

For instance, imagine the scenario of a builder constructing a single room in a pathfinding-enabled house. For the single room, the builder would use the following types as follows:

{|border="1"
! Linkset Use !! Description
|-
|width="200" align="center" | Walkable || align="left" | The floor linkset would be set to be Walkable to allow characters to move across the floor.
|-
|width="200" align="center" | Static Obstacle || align="left" | A desk linkset in the room would be set to be Static Obstacle to block characters from walking through or across the object.

NOTE Any object that should block character movement and that does not move should be marked as Static Obstacle to improve performance of pathfinding characters.
|-
|width="200" align="center" | Movable Obstacle || align="left" | A door linkset in the room would be set to be Movable Obstacle. This will still block characters but, in contrast to Static Obstacles, Movable Obstacles will allow the linkset itself to move. In the case of the door, this will allow the door to open and close, but will still prevent characters from walking through the door.
|-
|width="200" align="center" | Material Volume || align="left" | Material Volumes are phantom objects that can be used to affect the walkability coefficients of intersecting objects. Imagine that the builder applied a texture to the floor. Also, imagine that the floor texture includes small throw rug in the middle of the room. (The builder did not want to create a separate object for the rug, so is using a texture on the floor to give the appearance of a rug). The builder can then create a Material Volume object intersecting the floor at the location of the rug. Then, by setting a lower walkability coefficient for the Material Volume, the builder will create the affect of slowing down characters as the characters traverse across the painted rug area.
|-
|width="200" align="center" | Exclusion Volume || align="left" | Exclusion Volumes are phantom objects that can be used to create areas where characters are prevented from moving. For instance, the builder can use an Exclusion Volume to create a section of the room where avatars would be able to move, but characters would be blocked from following.
|-
|width="200" align="center" | Movable Phantom || align="left" | Movable Phantoms are phantom objects that have no affect on pathfinding-enabled characters.
|}
 
In addition to linkset use attributes, builders can achieve additional effects by modifying the walkability coefficients for linksets. The walkability coefficients are values, ranging from 0% to 100%, that affect a characters speed. A walkability coefficient of 50% will reduce a character's speed by half while the character is traversing across the linkset.
 

=== Pathfinding Characters Floater ===

==== Overview ====
The intent of Pathfinding Characters floater is primarily for users to locate characters moving throughout a region and to identify the CPU cost of characters affecting the performance of a region.

The floater displays information for all characters within the current region for which the user has the ability to manipulate. The table reports useful information including
* Character Name
* Description
* Owner
* CPU Time
* Altitude

[[File:Characters-floater-1.png|alt=Pathfinding Characters floater|Pathfinding Characters]]
 
==== Controls ====

{{:Viewerhelp:Pathfinding characters}}

==== Example use ====
# If a region owner has created a pathfinding-enabled character but is unable to find the character within the region, the Characters floater can be used to locate and select the character.
# Additionally, the Pathfinding Characters floater reports the CPU time cost for each character within the region. This functionality can be used by advanced users to identify which characters are impacting performance the most.

=== Pathfinding View/Test Floater ===

==== Overview ====

The intent of the Pathfinding View/Test floater is for advanced users who are building pathfinding-enabled objects and characters.

This floater consists of 3 basic areas.

# Status area (illustrating both the Viewer and Simulator status of the region's navmesh)
# View tab Controls
# Test Path tab Controls

The following image is a screenshot of the Pathfinding View/Test floater with the navmesh displayed.

[[File:View-nav-mesh-1.png|alt=Pathfinding View/Test floater with the navmesh displayed|Pathfinding View/Test with navmesh displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with the pathfinding object types displayed.

[[File:View-pf-types-1.png|alt=Pathfinding View/Test floater with the pathfinding object types displayed|Pathfinding View/Test with the pathfinding object types displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with a test path displayed.

[[File:View-test-path-1.png|alt=Pathfinding View/Test floater with a test path displayed|Pathfinding View/Test with a test path displayed]]

 
==== Controls ====

{{:Viewerhelp:Pathfinding edit and test}}

==== Example Use ====

# The advanced user will use the Visualization controls to visualize how the navmesh and related permanent objects have been generated. By seeing this visualization of how the physics engine interprets the navigation information, the advanced user can understand how to better customize the pathfinding-enabled objects to obtain the desired behaviors of characters.
# The advanced user will use the Test Tab to visualize how a test character would choose the path between selected start and end points.

 

== Known Issues ==

{| style="border-style:solid;border-width:2px 0 2px 0px;"
! style="border-style:solid;border-width:0 0 1px 0" width="120" | JIRA
! style="border-style:solid;border-width:0 0 1px 0" width="500" | Summary
! style="border-style:solid;border-width:0 0 1px 0" | Hardware
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-572 PATH-572]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Underwater 'Walkables' shapes are reflected about the water plane
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-643 PATH-643]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Changes in Preferences dialog stops work of Pathfinding View/Test functionality
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-659 PATH-659]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | navmesh being drawn over worn flexi prims and under avatar
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-790 PATH-790]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Physics capsule rendering of character shapes is broken after zooming
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-812 PATH-812]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Show capsules option creates black capsule instead of blue
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | ATI Radeon X300 Video card ATI Radeon X600 Video card
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-814 PATH-814]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 laptop displays black environment</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 with AMD Radeon HD5650M Mobile graphics</del>
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-821 PATH-821]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop displays black environment
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop with AMD Radeon HD 4200 Mobile graphics
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-822 PATH-822]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Configuration with ATI Radeon 7500 can launch Viewer, serious GFx issues
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | AMD Athlon64 3000+ with ATI Radeon 7500 video card
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-826 PATH-826]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Random crash while wearing a mesh avatar and dropping objects in-world
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1291 MAINT-1291]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Enable Debug GL crashes the viewer to the desktop
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac Pro running 10.7.4 with AMD Radeon HD5770 PC Clone running XP Pro with GeForce2 Ultra
|}

Pathfinding Tools in the Second Life Viewer

2012-07-26T01:13:54Z

Stinson Linden: /* Example Use */

{{Pathfinding Nav}}
__TOC__
{{KBnote|The Viewer tools described here are not yet available in a public Second Life Viewer build, but will be soon. }}
== Introduction ==
For pathfinding, each region has a navigation mesh, commonly referred to as a "'''navmesh'''". The '''navmesh''' is a representation of the region's geometry generated and used by the physics simulator to determine paths for the pathfinding characters. The navmesh may be in one of the following three states:

* Up-to-date
* Has pending changes
* Building ''(a.k.a. rebaking)''

The navmesh will transition through these states according to the following diagram:

[[File:Navmesh_transitions.png|alt=Second Life Pathfinding NavMesh Transitions|Second Life Pathfinding NavMesh Transitions]]

Five new elements have been added to the SL Viewer interface to communicate the navmesh state for the current region. These new elements are:

* icon representations of the pathfinding region state for the SLURL bar
* a "Rebake region" button that appears above the lower toolbar
* a right-click context menu option addition
* an additional field on the Build floater
* an additional field on the Object Profile floater

In addition to these new elements, three new floaters allow users to more efficiently create, visualize, test, and debug pathfinding-enabled characters. These tools are not required to create pathfinding behaviors but are particularly useful to builders and experienced creators in Second Life. These new floaters are:

* Pathfinding linksets
* Pathfinding characters
* Pathfinding view / test

== Pathfinding UI Elements ==

'''Note that other residents editing pathfinding objects on the same region may create pending changes to the navmesh.''' When this occurs, all residents on the same region and with build rights will see the appropriate SLURL bar icons and rebake region button.

=== Pathfinding Icons in SLURL Bar ===

The SLURL bar indicates the three pathfinding states of the current region.
# '''Navmesh is up-to-date''' The current region's navmesh is up-to-date. No icon is shown as this is the expected default state. [[File:Pathfinding-clean-region-1.png|alt=Second Life URL Bar with Up-to-Date NavMesh Icon|Second Life URL Bar with Up-to-Date NavMesh Icon]]
# '''Navmesh has pending changes''' The region has pending changes that have not yet been baked into the navmesh. A pathfinding icon with a construction symbol is shown. [[File:Pathfinding-dirty-region-1.png|alt=Second Life URL Bar with Pending Changes Icon|Second Life URL Bar with Pending Changes Icon]]
# '''Dynamic pathfinding is disabled''' The region has dynamic pathfinding disabled. Pathfinding characters will not work as expected. A pathfinding icon with a disabled symbol is shown. [[File:Pathfinding-disabled-region-1.png|alt=Second Life URL Bar with Pathfinding Disabled Icon|Second Life URL Bar with Pathfinding Disabled Icon]]

=== Rebake Region Button ===

When a region has pending changes, the appropriate icon will be shown in the SLURL bar, as described above. In addition, if the user has build rights for any parcel on the current region, the user will also be able to see a "Rebake region" button that displays above the lower toolbar.

[[File:Rebake-button-1.png|alt=Second Life Rebake Region button that allows permitted users to rebake pathfinding changes into the navmesh]]

When the user clicks this button, a request is sent to the region to rebake the navmesh for the current region. As rebaking a region may be a time intensive process, the button will change to indicate "Region is rebaking" during this server process. After the rebaking is complete, this button on the viewer will vanish.

[[File:Rebaking-button-1.png|alt=Second Life Region is Rebaking button that indicates that the current region is rebaking its navmesh]]

=== Right-click context menu behavior ===

When right-clicking on an object in-world, pathfinding-specific menu options may be included in the pop-up context menu.

If the user right-clicks on a '''linkset''' object in-world, a menu option "Show in linksets" will allow the user to open the Pathfinding Linksets floater with the current object selected.

[[File:Right-click-show-in-linksets-1.png|alt=Second Life Context Menu with Show in Linksets floater menu option]]

If the user right-clicks on a pathfinding '''character''' object in-world, a menu option "Show in characters" will allow the user to open the Pathfinding Characters floater with the current object selected.

[[File:Right-click-show-in-characters-1.png|alt=Second Life Context Menu with Show in Characters floater menu option]]

=== Additional field on the Build floater ===

The Build floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Build floater with a ''character'' object selected.

[[File:Build-floater-character-1.png|alt=Build floater with pathfinding attribute character|Build floater with pathfinding attribute character]]

The following image is a screenshot of the Build floater with an object that ''affects navmesh'' selected. This object could be a ''walkable'', ''static obstacle'', ''material volume'', or ''exclusion volume''.

[[File:Build-floater-affects-navmesh-1.png|alt=Build floater with pathfinding attribute affects navmesh|Build floater with pathfinding attribute affects navmesh]]

{{KBwarning|For linksets that do affect the navmesh, it will be impossible to modify the object across the region boundary. The user and the object affecting a navmesh must be in the same region to enable modification of the object. This will be indicated on the General tab of the Build floater as illustrated in the following screenshot.}}
[[File:Build-floater-region-boundary-1.png|alt=Build floater indicating that the user cannot modify object across a region boundary|Build floater indicating that the user cannot modify object across a region boundary]]

=== Additional field on the Object Profile floater ===

Similar to the afore-described Build floater, the Object Profile floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Object Profile floater with an ''affects navmesh'' object selected.

[[File:Object-profile-1.png|alt=Object Profile floater with pathfinding attribute affects navmesh|Object Profile floater with pathfinding attribute affects navmesh]]

== Pathfinding Floaters ==

These three pathfinding floaters may all be accessed through the Build->Pathfinding menu in the Project Viewer - Pathfinding.

[[File:Build-menu-pf-selected-1.png|alt=Second Life Build Menu with new Pathfinding menu items|SL Build -> Pathfinding Menu]]

 

=== Pathfinding Linksets Floater ===

==== Overview ====

The intent of the Pathfinding Linksets floater is to give advanced users and builders the ability to customize an area to achieve interesting effects with pathfinding-enabled characters.

The floater displays information for all linksets within the current region for which the user has the ability to alter. The table reports useful information including
* Linkset Name
* Description
* Owner
* Land Impact
* Distance from the resident's avatar
* Linkset Use
** Potential values
*** Walkable
*** Static Obstacle
*** Movable Obstacle
*** Material Volume
*** Exclusion Volume
*** Movable Phantom
* Walkability Coefficients
** Character Type A ''(example use: humanoid)''
** Character Type B ''(example use: creature)''
** Character Type C ''(example use: mechanical)''
** Character Type D ''(example use: other)''

Additionally, selecting any linksets within the floater will also select the object(s) within the Viewer.

[[File:Linksets-floater-2.png|alt=Pathfinding Linksets floater|Pathfinding Linksets]]

 

==== Controls ====

{{:Viewerhelp:Pathfinding linksets}}

==== Example use ====

The advanced users and builders will use the Pathfinding Linksets floater to customize areas to create interesting effects for pathfinding-enabled characters.

For instance, imagine the scenario of a builder constructing a single room in a pathfinding-enabled house. For the single room, the builder would use the following types as follows:

{|border="1"
! Linkset Use !! Description
|-
|width="200" align="center" | Walkable || align="left" | The floor linkset would be set to be Walkable to allow characters to move across the floor.
|-
|width="200" align="center" | Static Obstacle || align="left" | A desk linkset in the room would be set to be Static Obstacle to block characters from walking through or across the object.

NOTE Any object that should block character movement and that does not move should be marked as Static Obstacle to improve performance of pathfinding characters.
|-
|width="200" align="center" | Movable Obstacle || align="left" | A door linkset in the room would be set to be Movable Obstacle. This will still block characters but, in contrast to Static Obstacles, Movable Obstacles will allow the linkset itself to move. In the case of the door, this will allow the door to open and close, but will still prevent characters from walking through the door.
|-
|width="200" align="center" | Material Volume || align="left" | Material Volumes are phantom objects that can be used to affect the walkability coefficients of intersecting objects. Imagine that the builder applied a texture to the floor. Also, imagine that the floor texture includes small throw rug in the middle of the room. (The builder did not want to create a separate object for the rug, so is using a texture on the floor to give the appearance of a rug). The builder can then create a Material Volume object intersecting the floor at the location of the rug. Then, by setting a lower walkability coefficient for the Material Volume, the builder will create the affect of slowing down characters as the characters traverse across the painted rug area.
|-
|width="200" align="center" | Exclusion Volume || align="left" | Exclusion Volumes are phantom objects that can be used to create areas where characters are prevented from moving. For instance, the builder can use an Exclusion Volume to create a section of the room where avatars would be able to move, but characters would be blocked from following.
|-
|width="200" align="center" | Movable Phantom || align="left" | Movable Phantoms are phantom objects that have no affect on pathfinding-enabled characters.
|}
 
In addition to linkset use attributes, builders can achieve additional effects by modifying the walkability coefficients for linksets. The walkability coefficients are values, ranging from 0% to 100%, that affect a characters speed. A walkability coefficient of 50% will reduce a character's speed by half while the character is traversing across the linkset.
 

=== Pathfinding Characters Floater ===

==== Overview ====
The intent of Pathfinding Characters floater is primarily for users to locate characters moving throughout a region and to identify the CPU cost of characters affecting the performance of a region.

The floater displays information for all characters within the current region for which the user has the ability to manipulate. The table reports useful information including
* Character Name
* Description
* Owner
* CPU Time
* Altitude

[[File:Characters-floater-1.png|alt=Pathfinding Characters floater|Pathfinding Characters]]
 
==== Controls ====

{{:Viewerhelp:Pathfinding characters}}

==== Example use ====
# If a region owner has created a pathfinding-enabled character but is unable to find the character within the region, the Characters floater can be used to locate and select the character.
# Additionally, the Pathfinding Characters floater reports the CPU time cost for each character within the region. This functionality can be used by advanced users to identify which characters are impacting performance the most.

=== Pathfinding View/Test Floater ===

==== Overview ====

The intent of the Pathfinding View/Test floater is for advanced users who are building pathfinding-enabled objects and characters.

This floater consists of 3 basic areas.

# Status area (illustrating both the Viewer and Simulator status of the region's navmesh)
# View tab Controls
# Test Path tab Controls

The following image is a screenshot of the Pathfinding View/Test floater with the navmesh displayed.

[[File:View-nav-mesh-1.png|alt=Pathfinding View/Test floater with the navmesh displayed|Pathfinding View/Test with navmesh displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with the pathfinding object types displayed.

[[File:View-pf-types-1.png|alt=Pathfinding View/Test floater with the pathfinding object types displayed|Pathfinding View/Test with the pathfinding object types displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with a test path displayed.

[[File:View-test-path-1.png|alt=Pathfinding View/Test floater with a test path displayed|Pathfinding View/Test with a test path displayed]]

 
==== Controls ====

{{:Viewerhelp:Pathfinding edit and test}}

==== Example Use ====

# The advanced user will use the Visualization controls to visualize how the navmesh and related permanent objects have been generated. By seeing this visualization of how the physics engine interprets the navigation information, the advanced user can understand how to better customize the pathfinding-enabled objects to obtain the desired behaviors of characters.
# The advanced user will use the Test Tab to visualize how a test character would choose the path between selected start and end points.

 

== Known Issues ==

{| style="border-style:solid;border-width:2px 0 2px 0px;"
! style="border-style:solid;border-width:0 0 1px 0" width="100" | JIRA
! style="border-style:solid;border-width:0 0 1px 0" width="500" | Summary
! style="border-style:solid;border-width:0 0 1px 0" | Hardware
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-572 PATH-572]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Underwater 'Walkables' shapes are reflected about the water plane
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-643 PATH-643]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Changes in Preferences dialog stops work of Pathfinding View/Test functionality
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-659 PATH-659]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | navmesh being drawn over worn flexi prims and under avatar
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-781 PATH-781]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Group-owned objects appear to be owned by 'Unknown' in pathfinding linksets floater
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-790 PATH-790]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Physics capsule rendering of character shapes is broken after zooming
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-812 PATH-812]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Show capsules option creates black capsule instead of blue
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | ATI Radeon X300 Video card ATI Radeon X600 Video card
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-813 PATH-813]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Enable Debug GL crashes the viewer to the desktop
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac Pro running 10.7.4 with AMD Radeon HD5770 PC Clone running XP Pro with GeForce2 Ultra
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-814 PATH-814]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Sony VAIO PCG-71211 laptop displays black environment
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Sony VAIO PCG-71211 with AMD Radeon HD5650M Mobile graphics
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-821 PATH-821]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop displays black environment
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop with AMD Radeon HD 4200 Mobile graphics
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-822 PATH-822]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Configuration with ATI Radeon 7500 can launch Viewer, serious GFx issues
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | AMD Athlon64 3000+ with ATI Radeon 7500 video card
|}

Pathfinding Tools in the Second Life Viewer

2012-07-16T23:04:07Z

Stinson Linden:

{{Pathfinding Nav}}
__TOC__
{{KBnote|The Viewer tools described here are not yet available in a public Second Life Viewer build, but will be soon. }}
== Introduction ==
For pathfinding, each region has a navigation mesh, commonly referred to as a "'''navmesh'''". The '''navmesh''' is a representation of the region's geometry generated and used by the physics simulator to determine paths for the pathfinding characters. The navmesh may be in one of the following three states:

* Up-to-date
* Has pending changes
* Building ''(a.k.a. rebaking)''

The navmesh will transition through these states according to the following diagram:

[[File:Navmesh_transitions.png|alt=Second Life Pathfinding NavMesh Transitions|Second Life Pathfinding NavMesh Transitions]]

Five new elements have been added to the SL Viewer interface to communicate the navmesh state for the current region. These new elements are:

* icon representations of the pathfinding region state for the SLURL bar
* a "Rebake region" button that appears above the lower toolbar
* a right-click context menu option addition
* an additional field on the Build floater
* an additional field on the Object Profile floater

In addition to these new elements, three new floaters allow users to more efficiently create, visualize, test, and debug pathfinding-enabled characters. These tools are not required to create pathfinding behaviors but are particularly useful to builders and experienced creators in Second Life. These new floaters are:

* Pathfinding linksets
* Pathfinding characters
* Pathfinding view / test

== Pathfinding UI Elements ==

'''Note that other residents editing pathfinding objects on the same region may create pending changes to the navmesh.''' When this occurs, all residents on the same region and with build rights will see the appropriate SLURL bar icons and rebake region button.

=== Pathfinding Icons in SLURL Bar ===

The SLURL bar indicates the three pathfinding states of the current region.
# '''Navmesh is up-to-date''' The current region's navmesh is up-to-date. No icon is shown as this is the expected default state. [[File:Pathfinding-clean-region-1.png|alt=Second Life URL Bar with Up-to-Date NavMesh Icon|Second Life URL Bar with Up-to-Date NavMesh Icon]]
# '''Navmesh has pending changes''' The region has pending changes that have not yet been baked into the navmesh. A pathfinding icon with a construction symbol is shown. [[File:Pathfinding-dirty-region-1.png|alt=Second Life URL Bar with Pending Changes Icon|Second Life URL Bar with Pending Changes Icon]]
# '''Dynamic pathfinding is disabled''' The region has dynamic pathfinding disabled. Pathfinding characters will not work as expected. A pathfinding icon with a disabled symbol is shown. [[File:Pathfinding-disabled-region-1.png|alt=Second Life URL Bar with Pathfinding Disabled Icon|Second Life URL Bar with Pathfinding Disabled Icon]]

=== Rebake Region Button ===

When a region has pending changes, the appropriate icon will be shown in the SLURL bar, as described above. In addition, if the user has build rights for any parcel on the current region, the user will also be able to see a "Rebake region" button that displays above the lower toolbar.

[[File:Rebake-button-1.png|alt=Second Life Rebake Region button that allows permitted users to rebake pathfinding changes into the navmesh]]

When the user clicks this button, a request is sent to the region to rebake the navmesh for the current region. As rebaking a region may be a time intensive process, the button will change to indicate "Region is rebaking" during this server process. After the rebaking is complete, this button on the viewer will vanish.

[[File:Rebaking-button-1.png|alt=Second Life Region is Rebaking button that indicates that the current region is rebaking its navmesh]]

=== Right-click context menu behavior ===

When right-clicking on an object in-world, pathfinding-specific menu options may be included in the pop-up context menu.

If the user right-clicks on a '''linkset''' object in-world, a menu option "Show in linksets" will allow the user to open the Pathfinding Linksets floater with the current object selected.

[[File:Right-click-show-in-linksets-1.png|alt=Second Life Context Menu with Show in Linksets floater menu option]]

If the user right-clicks on a pathfinding '''character''' object in-world, a menu option "Show in characters" will allow the user to open the Pathfinding Characters floater with the current object selected.

[[File:Right-click-show-in-characters-1.png|alt=Second Life Context Menu with Show in Characters floater menu option]]

=== Additional field on the Build floater ===

The Build floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Build floater with a ''character'' object selected.

[[File:Build-floater-character-1.png|alt=Build floater with pathfinding attribute character|Build floater with pathfinding attribute character]]

The following image is a screenshot of the Build floater with an object that ''affects navmesh'' selected. This object could be a ''walkable'', ''static obstacle'', ''material volume'', or ''exclusion volume''.

[[File:Build-floater-affects-navmesh-1.png|alt=Build floater with pathfinding attribute affects navmesh|Build floater with pathfinding attribute affects navmesh]]

{{KBwarning|For linksets that do affect the navmesh, it will be impossible to modify the object across the region boundary. The user and the object affecting a navmesh must be in the same region to enable modification of the object. This will be indicated on the General tab of the Build floater as illustrated in the following screenshot.}}
[[File:Build-floater-region-boundary-1.png|alt=Build floater indicating that the user cannot modify object across a region boundary|Build floater indicating that the user cannot modify object across a region boundary]]

=== Additional field on the Object Profile floater ===

Similar to the afore-described Build floater, the Object Profile floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Object Profile floater with an ''affects navmesh'' object selected.

[[File:Object-profile-1.png|alt=Object Profile floater with pathfinding attribute affects navmesh|Object Profile floater with pathfinding attribute affects navmesh]]

== Pathfinding Floaters ==

These three pathfinding floaters may all be accessed through the Build->Pathfinding menu in the Project Viewer - Pathfinding.

[[File:Build-menu-pf-selected-1.png|alt=Second Life Build Menu with new Pathfinding menu items|SL Build -> Pathfinding Menu]]

 

=== Pathfinding Linksets Floater ===

==== Overview ====

The intent of the Pathfinding Linksets floater is to give advanced users and builders the ability to customize an area to achieve interesting effects with pathfinding-enabled characters.

The floater displays information for all linksets within the current region for which the user has the ability to alter. The table reports useful information including
* Linkset Name
* Description
* Owner
* Land Impact
* Distance from the resident's avatar
* Linkset Use
** Potential values
*** Walkable
*** Static Obstacle
*** Movable Obstacle
*** Material Volume
*** Exclusion Volume
*** Movable Phantom
* Walkability Coefficients
** Character Type A ''(example use: humanoid)''
** Character Type B ''(example use: creature)''
** Character Type C ''(example use: mechanical)''
** Character Type D ''(example use: other)''

Additionally, selecting any linksets within the floater will also select the object(s) within the Viewer.

[[File:Linksets-floater-2.png|alt=Pathfinding Linksets floater|Pathfinding Linksets]]

 

==== Controls ====

{{:Viewerhelp:Pathfinding linksets}}

==== Example use ====

The advanced users and builders will use the Pathfinding Linksets floater to customize areas to create interesting effects for pathfinding-enabled characters.

For instance, imagine the scenario of a builder constructing a single room in a pathfinding-enabled house. For the single room, the builder would use the following types as follows:

{|border="1"
! Linkset Use !! Description
|-
|width="200" align="center" | Walkable || align="left" | The floor linkset would be set to be Walkable to allow characters to move across the floor.
|-
|width="200" align="center" | Static Obstacle || align="left" | A desk linkset in the room would be set to be Static Obstacle to block characters from walking through or across the object.

NOTE Any object that should block character movement and that does not move should be marked as Static Obstacle to improve performance of pathfinding characters.
|-
|width="200" align="center" | Movable Obstacle || align="left" | A door linkset in the room would be set to be Movable Obstacle. This will still block characters but, in contrast to Static Obstacles, Movable Obstacles will allow the linkset itself to move. In the case of the door, this will allow the door to open and close, but will still prevent characters from walking through the door.
|-
|width="200" align="center" | Material Volume || align="left" | Material Volumes are phantom objects that can be used to affect the walkability coefficients of intersecting objects. Imagine that the builder applied a texture to the floor. Also, imagine that the floor texture includes small throw rug in the middle of the room. (The builder did not want to create a separate object for the rug, so is using a texture on the floor to give the appearance of a rug). The builder can then create a Material Volume object intersecting the floor at the location of the rug. Then, by setting a lower walkability coefficient for the Material Volume, the builder will create the affect of slowing down characters as the characters traverse across the painted rug area.
|-
|width="200" align="center" | Exclusion Volume || align="left" | Exclusion Volumes are phantom objects that can be used to create areas where characters are prevented from moving. For instance, the builder can use an Exclusion Volume to create a section of the room where avatars would be able to move, but characters would be blocked from following.
|-
|width="200" align="center" | Movable Phantom || align="left" | Movable Phantoms are phantom objects that have no affect on pathfinding-enabled characters.
|}
 
In addition to linkset use attributes, builders can achieve additional effects by modifying the walkability coefficients for linksets. The walkability coefficients are values, ranging from 0% to 100%, that affect a characters speed. A walkability coefficient of 50% will reduce a character's speed by half while the character is traversing across the linkset.
 

=== Pathfinding Characters Floater ===

==== Overview ====
The intent of Pathfinding Characters floater is primarily for users to locate characters moving throughout a region and to identify the CPU cost of characters affecting the performance of a region.

The floater displays information for all characters within the current region for which the user has the ability to manipulate. The table reports useful information including
* Character Name
* Description
* Owner
* CPU Time
* Altitude

[[File:Characters-floater-1.png|alt=Pathfinding Characters floater|Pathfinding Characters]]
 
==== Controls ====

{{:Viewerhelp:Pathfinding characters}}

==== Example use ====
# If a region owner has created a pathfinding-enabled character but is unable to find the character within the region, the Characters floater can be used to locate and select the character.
# Additionally, the Pathfinding Characters floater reports the CPU time cost for each character within the region. This functionality can be used by advanced users to identify which characters are impacting performance the most.

=== Pathfinding View/Test Floater ===

==== Overview ====

The intent of the Pathfinding View/Test floater is for advanced users who are building pathfinding-enabled objects and characters.

This floater consists of 3 basic areas.

# Status area (illustrating both the Viewer and Simulator status of the region's navmesh)
# View tab Controls
# Test Path tab Controls

The following image is a screenshot of the Pathfinding View/Test floater with the navmesh displayed.

[[File:View-nav-mesh-1.png|alt=Pathfinding View/Test floater with the navmesh displayed|Pathfinding View/Test with navmesh displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with the pathfinding object types displayed.

[[File:View-pf-types-1.png|alt=Pathfinding View/Test floater with the pathfinding object types displayed|Pathfinding View/Test with the pathfinding object types displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with a test path displayed.

[[File:View-test-path-1.png|alt=Pathfinding View/Test floater with a test path displayed|Pathfinding View/Test with a test path displayed]]

 
==== Controls ====

{{:Viewerhelp:Pathfinding edit and test}}

==== Example Use ====

# The advanced user will use the Visualization controls to visualize how the navmesh and related permanent objects have been generated. By seeing this visualization of how the physics engine interprets the navigation information, the advanced user can understand how to better custom the pathfinding-enabled objects to obtain the desired behaviors of characters.
# The advanced user will use the Test Tab to visualize how a test character would choose the path between selected start and end points.

 

== Known Issues ==

{| style="border-style:solid;border-width:2px 0 2px 0px;"
! style="border-style:solid;border-width:0 0 1px 0" width="100" | JIRA
! style="border-style:solid;border-width:0 0 1px 0" width="500" | Summary
! style="border-style:solid;border-width:0 0 1px 0" | Hardware
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-572 PATH-572]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Underwater 'Walkables' shapes are reflected about the water plane
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-643 PATH-643]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Changes in Preferences dialog stops work of Pathfinding View/Test functionality
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-659 PATH-659]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | navmesh being drawn over worn flexi prims and under avatar
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-781 PATH-781]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Group-owned objects appear to be owned by 'Unknown' in pathfinding linksets floater
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-790 PATH-790]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Physics capsule rendering of character shapes is broken after zooming
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-812 PATH-812]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Show capsules option creates black capsule instead of blue
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | ATI Radeon X300 Video card ATI Radeon X600 Video card
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-813 PATH-813]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Enable Debug GL crashes the viewer to the desktop
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac Pro running 10.7.4 with AMD Radeon HD5770 PC Clone running XP Pro with GeForce2 Ultra
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-814 PATH-814]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Sony VAIO PCG-71211 laptop displays black environment
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Sony VAIO PCG-71211 with AMD Radeon HD5650M Mobile graphics
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-821 PATH-821]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop displays black environment
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop with AMD Radeon HD 4200 Mobile graphics
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-822 PATH-822]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Configuration with ATI Radeon 7500 can launch Viewer, serious GFx issues
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | AMD Athlon64 3000+ with ATI Radeon 7500 video card
|}

Pathfinding Tools in the Second Life Viewer

2012-07-13T21:45:23Z

Stinson Linden:

{{Pathfinding Nav}}
__TOC__
{{KBnote|The Viewer tools described here are not yet available in a public Second Life Viewer build, but will be soon. }}
== Introduction ==
For pathfinding, each region has a navigation mesh, commonly referred to as a "'''navmesh'''". The '''navmesh''' is a representation of the region's geometry generated and used by the physics simulator to determine paths for the pathfinding characters. The navmesh may be in one of the following three states:

* Up-to-date
* Has pending changes
* Building ''(a.k.a. rebaking)''

The navmesh will transition through these states according to the following diagram:

[[File:Navmesh_transitions.png|alt=Second Life Pathfinding NavMesh Transitions|Second Life Pathfinding NavMesh Transitions]]

Five new elements have been added to the SL Viewer interface to communicate the navmesh state for the current region. These new elements are:

* icon representations of the pathfinding region state for the SLURL bar
* a "Rebake region" button that appears above the lower toolbar
* a right-click context menu option addition
* an additional field on the Build floater
* an additional field on the Object Profile floater

In addition to these new elements, three new floaters allow users to more efficiently create, visualize, test, and debug pathfinding-enabled characters. These tools are not required to create pathfinding behaviors but are particularly useful to builders and experienced creators in Second Life. These new floaters are:

* Pathfinding linksets
* Pathfinding characters
* Pathfinding view / test

== Pathfinding UI Elements ==

'''Note that other residents editing pathfinding objects on the same region may create pending changes to the navmesh.''' When this occurs, all residents on the same region and with build rights will see the appropriate SLURL bar icons and rebake region button.

=== Pathfinding Icons in SLURL Bar ===

The SLURL bar indicates the three pathfinding states of the current region.
# '''Navmesh is up-to-date''' The current region's navmesh is up-to-date. No icon is shown as this is the expected default state. [[File:Pathfinding-clean-region-1.png|alt=Second Life URL Bar with Up-to-Date NavMesh Icon|Second Life URL Bar with Up-to-Date NavMesh Icon]]
# '''Navmesh has pending changes''' The region has pending changes that have not yet been baked into the navmesh. A pathfinding icon with a construction symbol is shown. [[File:Pathfinding-dirty-region-1.png|alt=Second Life URL Bar with Pending Changes Icon|Second Life URL Bar with Pending Changes Icon]]
# '''Dynamic pathfinding is disabled''' The region has dynamic pathfinding disabled. Pathfinding characters will not work as expected. A pathfinding icon with a disabled symbol is shown. [[File:Pathfinding-disabled-region-1.png|alt=Second Life URL Bar with Pathfinding Disabled Icon|Second Life URL Bar with Pathfinding Disabled Icon]]

=== Rebake Region Button ===

When a region has pending changes, the appropriate icon will be shown in the SLURL bar, as described above. In addition, if the user has build rights for any parcel on the current region, the user will also be able to see a "Rebake region" button that displays above the lower toolbar.

[[File:Rebake-button-1.png|alt=Second Life Rebake Region button that allows permitted users to rebake pathfinding changes into the navmesh]]

When the user clicks this button, a request is sent to the region to rebake the navmesh for the current region. As rebaking a region may be a time intensive process, the button will change to indicate "Region is rebaking" during this server process. After the rebaking is complete, this button on the viewer will vanish.

[[File:Rebaking-button-1.png|alt=Second Life Region is Rebaking button that indicates that the current region is rebaking its navmesh]]

=== Right-click context menu behavior ===

When right-clicking on an object in-world, pathfinding-specific menu options may be included in the pop-up context menu.

If the user right-clicks on a '''linkset''' object in-world, a menu option "Show in linksets" will allow the user to open the Pathfinding Linksets floater with the current object selected.

[[File:Right-click-show-in-linksets-1.png|alt=Second Life Context Menu with Show in Linksets floater menu option]]

If the user right-clicks on a pathfinding '''character''' object in-world, a menu option "Show in characters" will allow the user to open the Pathfinding Characters floater with the current object selected.

[[File:Right-click-show-in-characters-1.png|alt=Second Life Context Menu with Show in Characters floater menu option]]

=== Additional field on the Build floater ===

The Build floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Build floater with a ''character'' object selected.

[[File:Build-floater-character-1.png|alt=Build floater with pathfinding attribute character|Build floater with pathfinding attribute character]]

The following image is a screenshot of the Build floater with an object that ''affects navmesh'' selected. This object could be a ''walkable'', ''static obstacle'', ''material volume'', or ''exclusion volume''.

[[File:Build-floater-affects-navmesh-1.png|alt=Build floater with pathfinding attribute affects navmesh|Build floater with pathfinding attribute affects navmesh]]

{{KBwarning|For linksets that do affect the navmesh, it will be impossible to modify the object across the region boundary. The user and the object affecting a navmesh must be in the same region to enable modification of the object. This will be indicated on the General tab of the Build floater as illustrated in the following screenshot.}}
[[File:Build-floater-region-boundary-1.png|alt=Build floater indicating that the user cannot modify object across a region boundary|Build floater indicating that the user cannot modify object across a region boundary]]

=== Additional field on the Object Profile floater ===

Similar to the afore-described Build floater, the Object Profile floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Object Profile floater with an ''affects navmesh'' object selected.

[[File:Object-profile-1.png|alt=Object Profile floater with pathfinding attribute affects navmesh|Object Profile floater with pathfinding attribute affects navmesh]]

== Pathfinding Floaters ==

These three pathfinding floaters may all be accessed through the Build->Pathfinding menu in the Project Viewer - Pathfinding.

[[File:Build-menu-pf-selected-1.png|alt=Second Life Build Menu with new Pathfinding menu items|SL Build -> Pathfinding Menu]]

 

=== Pathfinding Linksets Floater ===

==== Overview ====

The intent of the Pathfinding Linksets floater is to give advanced users and builders the ability to customize an area to achieve interesting effects with pathfinding-enabled characters.

The floater displays information for all linksets within the current region for which the user has the ability to alter. The table reports useful information including
* Linkset Name
* Description
* Owner
* Land Impact
* Distance from the resident's avatar
* Linkset Use
** Potential values
*** Walkable
*** Static Obstacle
*** Movable Obstacle
*** Material Volume
*** Exclusion Volume
*** Movable Phantom
* Walkability Coefficients
** Character Type A ''(example use: humanoid)''
** Character Type B ''(example use: creature)''
** Character Type C ''(example use: mechanical)''
** Character Type D ''(example use: other)''

Additionally, selecting any linksets within the floater will also select the object(s) within the Viewer.

[[File:Linksets-floater-2.png|alt=Pathfinding Linksets floater|Pathfinding Linksets]]

 

==== Controls ====

{{:Viewerhelp:Pathfinding linksets}}

==== Example use ====

The advanced users and builders will use the Pathfinding Linksets floater to customize areas to create interesting effects for pathfinding-enabled characters.

For instance, imagine the scenario of a builder constructing a single room in a pathfinding-enabled house. For the single room, the builder would use the following types as follows:

{|border="1"
! Linkset Use !! Description
|-
|width="200" align="center" | Walkable || align="left" | The floor linkset would be set to be Walkable to allow characters to move across the floor.
|-
|width="200" align="center" | Static Obstacle || align="left" | A desk linkset in the room would be set to be Static Obstacle to block characters from walking through or across the object.

NOTE Any object that should block character movement and that does not move should be marked as Static Obstacle to improve performance of pathfinding characters.
|-
|width="200" align="center" | Movable Obstacle || align="left" | A door linkset in the room would be set to be Movable Obstacle. This will still block characters but, in contrast to Static Obstacles, Movable Obstacles will allow the linkset itself to move. In the case of the door, this will allow the door to open and close, but will still prevent characters from walking through the door.
|-
|width="200" align="center" | Material Volume || align="left" | Material Volumes are phantom objects that can be used to affect the walkability coefficients of intersecting objects. Imagine that the builder applied a texture to the floor. Also, imagine that the floor texture includes small throw rug in the middle of the room. (The builder did not want to create a separate object for the rug, so is using a texture on the floor to give the appearance of a rug). The builder can then create a Material Volume object intersecting the floor at the location of the rug. Then, by setting a lower walkability coefficient for the Material Volume, the builder will create the affect of slowing down characters as the characters traverse across the painted rug area.
|-
|width="200" align="center" | Exclusion Volume || align="left" | Exclusion Volumes are phantom objects that can be used to create areas where characters are prevented from moving. For instance, the builder can use an Exclusion Volume to create a section of the room where avatars would be able to move, but characters would be blocked from following.
|-
|width="200" align="center" | Movable Phantom || align="left" | Movable Phantoms are phantom objects that have no affect on pathfinding-enabled characters.
|}
 
In addition to linkset use attributes, builders can achieve additional effects by modifying the walkability coefficients for linksets. The walkability coefficients are values, ranging from 0% to 100%, that affect a characters speed. A walkability coefficient of 50% will reduce a character's speed by half while the character is traversing across the linkset.
 

=== Pathfinding Characters Floater ===

==== Overview ====
The intent of Pathfinding Characters floater is primarily for users to locate characters moving throughout a region and to identify the CPU cost of characters affecting the performance of a region.

The floater displays information for all characters within the current region for which the user has the ability to manipulate. The table reports useful information including
* Character Name
* Description
* Owner
* CPU Time
* Altitude

[[File:Characters-floater-1.png|alt=Pathfinding Characters floater|Pathfinding Characters]]
 
==== Controls ====

{{:Viewerhelp:Pathfinding characters}}

==== Example use ====
# If a region owner has created a pathfinding-enabled character but is unable to find the character within the region, the Characters floater can be used to locate and select the character.
# Additionally, the Pathfinding Characters floater reports the CPU time cost for each character within the region. This functionality can be used by advanced users to identify which characters are impacting performance the most.

=== Pathfinding View/Test Floater ===

==== Overview ====

The intent of the Pathfinding View/Test floater is for advanced users who are building pathfinding-enabled objects and characters.

This floater consists of 3 basic areas.

# Status area (illustrating both the Viewer and Simulator status of the region's navmesh)
# View tab Controls
# Test Path tab Controls

The following image is a screenshot of the Pathfinding View/Test floater with the navmesh displayed.

[[File:View-nav-mesh-1.png|alt=Pathfinding View/Test floater with the navmesh displayed|Pathfinding View/Test with navmesh displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with the pathfinding object types displayed.

[[File:View-pf-types-1.png|alt=Pathfinding View/Test floater with the pathfinding object types displayed|Pathfinding View/Test with the pathfinding object types displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with a test path displayed.

[[File:View-test-path-1.png|alt=Pathfinding View/Test floater with a test path displayed|Pathfinding View/Test with a test path displayed]]

 
==== Controls ====

{{:Viewerhelp:Pathfinding edit and test}}

==== Example Use ====

# The advanced user will use the Visualization controls to visualize how the navmesh and related permanent objects have been generated. By seeing this visualization of how the physics engine interprets the navigation information, the advanced user can understand how to better custom the pathfinding-enabled objects to obtain the desired behaviors of characters.
# The advanced user will use the Test Tab to visualize how a test character would choose the path between selected start and end points.

 

== Known Issues ==

{| style="border-style:solid;border-width:2px 0 2px 0px;"
! style="border-style:solid;border-width:0 0 1px 0" width="100" | JIRA
! style="border-style:solid;border-width:0 0 1px 0" width="500" | Summary
! style="border-style:solid;border-width:0 0 1px 0" | Hardware
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-572 PATH-572]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Underwater 'Walkables' shapes are reflected about the water plane
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-643 PATH-643]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Changes in Preferences dialog stops work of Pathfinding View/Test functionality
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-659 PATH-659]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | navmesh being drawn over worn flexi prims and under avatar
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-781 PATH-781]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Group-owned objects appear to be owned by 'Unknown' in pathfinding linksets floater
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-790 PATH-790]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Physics capsule rendering of character shapes is broken after zooming
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-812 PATH-812]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Show capsules option creates black capsule instead of blue
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | ATI Radeon X300 Video card ATI Radeon X600 Video card
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-813 PATH-813]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Enable Debug GL crashes the viewer to the desktop
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac Pro running 10.7.4 with AMD Radeon HD5770 PC Clone running XP Pro with GeForce2 Ultra
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-814 PATH-814]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Sony VAIO PCG-71211 laptop displays black environment
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Sony VAIO PCG-71211 with AMD Radeon HD5650M Mobile graphics
|}

Pathfinding Tools in the Second Life Viewer

2012-07-13T21:27:08Z

Stinson Linden:

{{Pathfinding Nav}}
__TOC__
{{KBnote|The Viewer tools described here are not yet available in a public Second Life Viewer build, but will be soon. }}
== Introduction ==
For pathfinding, each region has a navigation mesh, commonly referred to as a "'''navmesh'''". The '''navmesh''' is a representation of the region's geometry generated and used by the physics simulator to determine paths for the pathfinding characters. The navmesh may be in one of the following three states:

* Up-to-date
* Has pending changes
* Building ''(a.k.a. rebaking)''

The navmesh will transition through these states according to the following diagram:

[[File:Navmesh_transitions.png|alt=Second Life Pathfinding NavMesh Transitions|Second Life Pathfinding NavMesh Transitions]]

Five new elements have been added to the SL Viewer interface to communicate the navmesh state for the current region. These new elements are:

* icon representations of the pathfinding region state for the SLURL bar
* a "Rebake region" button that appears above the lower toolbar
* a right-click context menu option addition
* an additional field on the Build floater
* an additional field on the Object Profile floater

In addition to these new elements, three new floaters allow users to more efficiently create, visualize, test, and debug pathfinding-enabled characters. These tools are not required to create pathfinding behaviors but are particularly useful to builders and experienced creators in Second Life. These new floaters are:

* Pathfinding linksets
* Pathfinding characters
* Pathfinding view / edit

== Pathfinding UI Elements ==

'''Note that other residents editing pathfinding objects on the same region may create pending changes to the navmesh.''' When this occurs, all residents on the same region and with build rights will see the appropriate SLURL bar icons and rebake region button.

=== Pathfinding Icons in SLURL Bar ===

The SLURL bar indicates the three pathfinding states of the current region.
# '''Navmesh is up-to-date''' The current region's navmesh is up-to-date. No icon is shown as this is the expected default state. [[File:Pathfinding-clean-region-1.png|alt=Second Life URL Bar with Up-to-Date NavMesh Icon|Second Life URL Bar with Up-to-Date NavMesh Icon]]
# '''Navmesh has pending changes''' The region has pending changes that have not yet been baked into the navmesh. A pathfinding icon with a construction symbol is shown. [[File:Pathfinding-dirty-region-1.png|alt=Second Life URL Bar with Pending Changes Icon|Second Life URL Bar with Pending Changes Icon]]
# '''Dynamic pathfinding is disabled''' The region has dynamic pathfinding disabled. Pathfinding characters will not work as expected. A pathfinding icon with a disabled symbol is shown. [[File:Pathfinding-disabled-region-1.png|alt=Second Life URL Bar with Pathfinding Disabled Icon|Second Life URL Bar with Pathfinding Disabled Icon]]

=== Rebake Region Button ===

When a region has pending changes, the appropriate icon will be shown in the SLURL bar, as described above. In addition, if the user has build rights for any parcel on the current region, the user will also be able to see a "Rebake region" button that displays above the lower toolbar.

[[File:Rebake-button-1.png|alt=Second Life Rebake Region button that allows permitted users to rebake pathfinding changes into the navmesh]]

When the user clicks this button, a request is sent to the region to rebake the navmesh for the current region. As rebaking a region may be a time intensive process, the button will change to indicate "Region is rebaking" during this server process. After the rebaking is complete, this button on the viewer will vanish.

[[File:Rebaking-button-1.png|alt=Second Life Region is Rebaking button that indicates that the current region is rebaking its navmesh]]

=== Right-click context menu behavior ===

When right-clicking on an object in-world, pathfinding-specific menu options may be included in the pop-up context menu.

If the user right-clicks on a '''linkset''' object in-world, a menu option "Show in linksets" will allow the user to open the Pathfinding Linksets floater with the current object selected.

[[File:Right-click-show-in-linksets-1.png|alt=Second Life Context Menu with Show in Linksets floater menu option]]

If the user right-clicks on a pathfinding '''character''' object in-world, a menu option "Show in characters" will allow the user to open the Pathfinding Characters floater with the current object selected.

[[File:Right-click-show-in-characters-1.png|alt=Second Life Context Menu with Show in Characters floater menu option]]

=== Additional field on the Build floater ===

The Build floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Build floater with a ''character'' object selected.

[[File:Build-floater-character-1.png|alt=Build floater with pathfinding attribute character|Build floater with pathfinding attribute character]]

The following image is a screenshot of the Build floater with an object that ''affects navmesh'' selected. This object could be a ''walkable'', ''static obstacle'', ''material volume'', or ''exclusion volume''.

[[File:Build-floater-affects-navmesh-1.png|alt=Build floater with pathfinding attribute affects navmesh|Build floater with pathfinding attribute affects navmesh]]

{{KBwarning|For linksets that do affect the navmesh, it will be impossible to modify the object across the region boundary. The user and the object affecting a navmesh must be in the same region to enable modification of the object. This will be indicated on the General tab of the Build floater as illustrated in the following screenshot.}}
[[File:Build-floater-region-boundary-1.png|alt=Build floater indicating that the user cannot modify object across a region boundary|Build floater indicating that the user cannot modify object across a region boundary]]

=== Additional field on the Object Profile floater ===

Similar to the afore-described Build floater, the Object Profile floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Object Profile floater with an ''affects navmesh'' object selected.

[[File:Object-profile-1.png|alt=Object Profile floater with pathfinding attribute affects navmesh|Object Profile floater with pathfinding attribute affects navmesh]]

== Pathfinding Floaters ==

These three pathfinding floaters may all be accessed through the Build->Pathfinding menu in the Project Viewer - Pathfinding.

[[File:Build-menu-pf-selected-1.png|alt=Second Life Build Menu with new Pathfinding menu items|SL Build -> Pathfinding Menu]]

 

=== Pathfinding Linksets Floater ===

==== Overview ====

The intent of the Pathfinding Linksets floater is to give advanced users and builders the ability to customize an area to achieve interesting effects with pathfinding-enabled characters.

The floater displays information for all linksets within the current region for which the user has the ability to alter. The table reports useful information including
* Linkset Name
* Description
* Owner
* Land Impact
* Distance from the resident's avatar
* Linkset Use
** Potential values
*** Walkable
*** Static Obstacle
*** Movable Obstacle
*** Material Volume
*** Exclusion Volume
*** Movable Phantom
* Walkability Coefficients
** Character Type A ''(example use: humanoid)''
** Character Type B ''(example use: creature)''
** Character Type C ''(example use: mechanical)''
** Character Type D ''(example use: other)''

Additionally, selecting any linksets within the floater will also select the object(s) within the Viewer.

[[File:Linksets-floater-2.png|alt=Pathfinding Linksets floater|Pathfinding Linksets]]

 

==== Controls ====

{{:Viewerhelp:Pathfinding linksets}}

==== Example use ====

The advanced users and builders will use the Pathfinding Linksets floater to customize areas to create interesting effects for pathfinding-enabled characters.

For instance, imagine the scenario of a builder constructing a single room in a pathfinding-enabled house. For the single room, the builder would use the following types as follows:

{|border="1"
! Linkset Use !! Description
|-
|width="200" align="center" | Walkable || align="left" | The floor linkset would be set to be Walkable to allow characters to move across the floor.
|-
|width="200" align="center" | Static Obstacle || align="left" | A desk linkset in the room would be set to be Static Obstacle to block characters from walking through or across the object.

NOTE Any object that should block character movement and that does not move should be marked as Static Obstacle to improve performance of pathfinding characters.
|-
|width="200" align="center" | Movable Obstacle || align="left" | A door linkset in the room would be set to be Movable Obstacle. This will still block characters but, in contrast to Static Obstacles, Movable Obstacles will allow the linkset itself to move. In the case of the door, this will allow the door to open and close, but will still prevent characters from walking through the door.
|-
|width="200" align="center" | Material Volume || align="left" | Material Volumes are phantom objects that can be used to affect the walkability coefficients of intersecting objects. Imagine that the builder applied a texture to the floor. Also, imagine that the floor texture includes small throw rug in the middle of the room. (The builder did not want to create a separate object for the rug, so is using a texture on the floor to give the appearance of a rug). The builder can then create a Material Volume object intersecting the floor at the location of the rug. Then, by setting a lower walkability coefficient for the Material Volume, the builder will create the affect of slowing down characters as the characters traverse across the painted rug area.
|-
|width="200" align="center" | Exclusion Volume || align="left" | Exclusion Volumes are phantom objects that can be used to create areas where characters are prevented from moving. For instance, the builder can use an Exclusion Volume to create a section of the room where avatars would be able to move, but characters would be blocked from following.
|-
|width="200" align="center" | Movable Phantom || align="left" | Movable Phantoms are phantom objects that have no affect on pathfinding-enabled characters.
|}
 
In addition to linkset use attributes, builders can achieve additional effects by modifying the walkability coefficients for linksets. The walkability coefficients are values, ranging from 0% to 100%, that affect a characters speed. A walkability coefficient of 50% will reduce a character's speed by half while the character is traversing across the linkset.
 

=== Pathfinding Characters Floater ===

==== Overview ====
The intent of Pathfinding Characters floater is primarily for users to locate characters moving throughout a region and to identify the CPU cost of characters affecting the performance of a region.

The floater displays information for all characters within the current region for which the user has the ability to manipulate. The table reports useful information including
* Character Name
* Description
* Owner
* CPU Time
* Altitude

[[File:Characters-floater-1.png|alt=Pathfinding Characters floater|Pathfinding Characters]]
 
==== Controls ====

{{:Viewerhelp:Pathfinding characters}}

==== Example use ====
# If a region owner has created a pathfinding-enabled character but is unable to find the character within the region, the Characters floater can be used to locate and select the character.
# Additionally, the Pathfinding Characters floater reports the CPU time cost for each character within the region. This functionality can be used by advanced users to identify which characters are impacting performance the most.

=== Pathfinding View/Test Floater ===

==== Overview ====

The intent of the Pathfinding View/Test floater is for advanced users who are building pathfinding-enabled objects and characters.

This floater consists of 3 basic areas.

# Status area (illustrating both the Viewer and Simulator status of the region's navmesh)
# View tab Controls
# Test Path tab Controls

The following image is a screenshot of the Pathfinding View/Test floater with the navmesh displayed.

[[File:View-nav-mesh-1.png|alt=Pathfinding View/Test floater with the navmesh displayed|Pathfinding View/Test with navmesh displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with the pathfinding object types displayed.

[[File:View-pf-types-1.png|alt=Pathfinding View/Test floater with the pathfinding object types displayed|Pathfinding View/Test with the pathfinding object types displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with a test path displayed.

[[File:View-test-path-1.png|alt=Pathfinding View/Test floater with a test path displayed|Pathfinding View/Test with a test path displayed]]

 
==== Controls ====

{{:Viewerhelp:Pathfinding edit and test}}

==== Example Use ====

# The advanced user will use the Visualization controls to visualize how the navmesh and related permanent objects have been generated. By seeing this visualization of how the physics engine interprets the navigation information, the advanced user can understand how to better custom the pathfinding-enabled objects to obtain the desired behaviors of characters.
# The advanced user will use the Test Tab to visualize how a test character would choose the path between selected start and end points.

 

== Known Issues ==

{| style="border-style:solid;border-width:2px 0 2px 0px;"
! style="border-style:solid;border-width:0 0 1px 0" width="100" | JIRA
! style="border-style:solid;border-width:0 0 1px 0" width="500" | Summary
! style="border-style:solid;border-width:0 0 1px 0" | Hardware
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-572 PATH-572]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Underwater 'Walkables' shapes are reflected about the water plane
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-643 PATH-643]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Changes in Preferences dialog stops work of Pathfinding View/Test functionality
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-659 PATH-659]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | navmesh being drawn over worn flexi prims and under avatar
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-781 PATH-781]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Group-owned objects appear to be owned by 'Unknown' in pathfinding linksets floater
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-790 PATH-790]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Physics capsule rendering of character shapes is broken after zooming
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-812 PATH-812]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Show capsules option creates black capsule instead of blue
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | ATI Radeon X300 Video card ATI Radeon X600 Video card
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-813 PATH-813]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Enable Debug GL crashes the viewer to the desktop
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac Pro running 10.7.4 with AMD Radeon HD5770 PC Clone running XP Pro with GeForce2 Ultra
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-814 PATH-814]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Sony VAIO PCG-71211 laptop displays black environment
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Sony VAIO PCG-71211 with AMD Radeon HD5650M Mobile graphics
|}

Pathfinding Tools in the Second Life Viewer

2012-07-13T19:04:13Z

Stinson Linden:

{{Pathfinding Nav}}
__TOC__
{{KBnote|The Viewer tools described here are not yet available in a public Second Life Viewer build, but will be soon. }}
== Introduction ==
For pathfinding, each region has a navigation mesh, commonly referred to as a "'''navmesh'''". The '''navmesh''' is a representation of the region's geometry generated and used by the physics simulator to determine paths for the pathfinding characters. The navmesh may be in one of the following three states:

* Up-to-date
* Has pending changes
* Building ''(a.k.a. rebaking)''

The navmesh will transition through these states according to the following diagram:

[[File:Navmesh_transitions.png|alt=Second Life Pathfinding NavMesh Transitions|Second Life Pathfinding NavMesh Transitions]]

Five new elements have been added to the SL Viewer interface to communicate the navmesh state for the current region. These new elements are:

* icon representations of the pathfinding region state for the SLURL bar
* a "Rebake region" button that appears above the lower toolbar
* a right-click context menu option addition
* an additional field on the Build floater
* an additional field on the Object Profile floater

In addition to these new elements, three new floaters allow users to more efficiently create, visualize, test, and debug pathfinding-enabled characters. These tools are not required to create pathfinding behaviors but are particularly useful to builders and experienced creators in Second Life. These new floaters are:

* Pathfinding linksets
* Pathfinding characters
* Pathfinding view / edit

== Pathfinding UI Elements ==

'''Note that other residents editing pathfinding objects on the same region may create pending changes to the navmesh.''' When this occurs, all residents on the same region and with build rights will see the appropriate SLURL bar icons and rebake region button.

=== Pathfinding Icons in SLURL Bar ===

The SLURL bar indicates the three pathfinding states of the current region.
# '''Navmesh is up-to-date''' The current region's navmesh is up-to-date. No icon is shown as this is the expected default state. [[File:Pathfinding-clean-region-1.png|alt=Second Life URL Bar with Up-to-Date NavMesh Icon|Second Life URL Bar with Up-to-Date NavMesh Icon]]
# '''Navmesh has pending changes''' The region has pending changes that have not yet been baked into the navmesh. A pathfinding icon with a construction symbol is shown. [[File:Pathfinding-dirty-region-1.png|alt=Second Life URL Bar with Pending Changes Icon|Second Life URL Bar with Pending Changes Icon]]
# '''Dynamic pathfinding is disabled''' The region has dynamic pathfinding disabled. Pathfinding characters will not work as expected. A pathfinding icon with a disabled symbol is shown. [[File:Pathfinding-disabled-region-1.png|alt=Second Life URL Bar with Pathfinding Disabled Icon|Second Life URL Bar with Pathfinding Disabled Icon]]

=== Rebake Region Button ===

When a region has pending changes, the appropriate icon will be shown in the SLURL bar, as described above. In addition, if the user has build rights for any parcel on the current region, the user will also be able to see a "Rebake region" button that displays above the lower toolbar.

[[File:Rebake-button-1.png|alt=Second Life Rebake Region button that allows permitted users to rebake pathfinding changes into the navmesh]]

When the user clicks this button, a request is sent to the region to rebake the navmesh for the current region. As rebaking a region may be a time intensive process, the button will change to indicate "Region is rebaking" during this server process. After the rebaking is complete, this button on the viewer will vanish.

[[File:Rebaking-button-1.png|alt=Second Life Region is Rebaking button that indicates that the current region is rebaking its navmesh]]

=== Right-click context menu behavior ===

When right-clicking on an object in-world, pathfinding-specific menu options may be included in the pop-up context menu.

If the user right-clicks on a '''linkset''' object in-world, a menu option "Show in linksets" will allow the user to open the Pathfinding Linksets floater with the current object selected.

[[File:Right-click-show-in-linksets-1.png|alt=Second Life Context Menu with Show in Linksets floater menu option]]

If the user right-clicks on a pathfinding '''character''' object in-world, a menu option "Show in characters" will allow the user to open the Pathfinding Characters floater with the current object selected.

[[File:Right-click-show-in-characters-1.png|alt=Second Life Context Menu with Show in Characters floater menu option]]

=== Additional field on the Build floater ===

The Build floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Build floater with a ''character'' object selected.

[[File:Build-floater-character-1.png|alt=Build floater with pathfinding attribute character|Build floater with pathfinding attribute character]]

The following image is a screenshot of the Build floater with an object that ''affects navmesh'' selected. This object could be a ''walkable'', ''static obstacle'', ''material volume'', or ''exclusion volume''.

[[File:Build-floater-affects-navmesh-1.png|alt=Build floater with pathfinding attribute affects navmesh|Build floater with pathfinding attribute affects navmesh]]

{{KBwarning|For linksets that do affect the navmesh, it will be impossible to modify the object across the region boundary. The user and the object affecting a navmesh must be in the same region to enable modification of the object. This will be indicated on the General tab of the Build floater as illustrated in the following screenshot.}}
[[File:Build-floater-region-boundary-1.png|alt=Build floater indicating that the user cannot modify object across a region boundary|Build floater indicating that the user cannot modify object across a region boundary]]

=== Additional field on the Object Profile floater ===

Similar to the afore-described Build floater, the Object Profile floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Object Profile floater with an ''affects navmesh'' object selected.

[[File:Object-profile-1.png|alt=Object Profile floater with pathfinding attribute affects navmesh|Object Profile floater with pathfinding attribute affects navmesh]]

== Pathfinding Floaters ==

These three pathfinding floaters may all be accessed through the Build->Pathfinding menu in the Project Viewer - Pathfinding.

[[File:Build-menu-pf-selected-1.png|alt=Second Life Build Menu with new Pathfinding menu items|SL Build -> Pathfinding Menu]]

 

=== Pathfinding Linksets Floater ===

==== Overview ====

The intent of the Pathfinding Linksets floater is to give advanced users and builders the ability to customize an area to achieve interesting effects with pathfinding-enabled characters.

The floater displays information for all linksets within the current region for which the user has the ability to alter. The table reports useful information including
* Linkset Name
* Description
* Owner
* Land Impact
* Distance from the resident's avatar
* Linkset Use
** Potential values
*** Walkable
*** Static Obstacle
*** Movable Obstacle
*** Material Volume
*** Exclusion Volume
*** Movable Phantom
* Walkability Coefficients
** Character Type A ''(example use: humanoid)''
** Character Type B ''(example use: creature)''
** Character Type C ''(example use: mechanical)''
** Character Type D ''(example use: other)''

Additionally, selecting any linksets within the floater will also select the object(s) within the Viewer.

[[File:Linksets-floater-2.png|alt=Pathfinding Linksets floater|Pathfinding Linksets]]

 

==== Controls ====

{{:Viewerhelp:Pathfinding linksets}}

==== Example use ====

The advanced users and builders will use the Pathfinding Linksets floater to customize areas to create interesting effects for pathfinding-enabled characters.

For instance, imagine the scenario of a builder constructing a single room in a pathfinding-enabled house. For the single room, the builder would use the following types as follows:

{|border="1"
! Linkset Use !! Description
|-
|width="200" align="center" | Walkable || align="left" | The floor linkset would be set to be Walkable to allow characters to move across the floor.
|-
|width="200" align="center" | Static Obstacle || align="left" | A desk linkset in the room would be set to be Static Obstacle to block characters from walking through or across the object.

NOTE Any object that should block character movement and that does not move should be marked as Static Obstacle to improve performance of pathfinding characters.
|-
|width="200" align="center" | Movable Obstacle || align="left" | A door linkset in the room would be set to be Movable Obstacle. This will still block characters but, in contrast to Static Obstacles, Movable Obstacles will allow the linkset itself to move. In the case of the door, this will allow the door to open and close, but will still prevent characters from walking through the door.
|-
|width="200" align="center" | Material Volume || align="left" | Material Volumes are phantom objects that can be used to affect the walkability coefficients of intersecting objects. Imagine that the builder applied a texture to the floor. Also, imagine that the floor texture includes small throw rug in the middle of the room. (The builder did not want to create a separate object for the rug, so is using a texture on the floor to give the appearance of a rug). The builder can then create a Material Volume object intersecting the floor at the location of the rug. Then, by setting a lower walkability coefficient for the Material Volume, the builder will create the affect of slowing down characters as the characters traverse across the painted rug area.
|-
|width="200" align="center" | Exclusion Volume || align="left" | Exclusion Volumes are phantom objects that can be used to create areas where characters are prevented from moving. For instance, the builder can use an Exclusion Volume to create a section of the room where avatars would be able to move, but characters would be blocked from following.
|-
|width="200" align="center" | Movable Phantom || align="left" | Movable Phantoms are phantom objects that have no affect on pathfinding-enabled characters.
|}
 
In addition to linkset use attributes, builders can achieve additional effects by modifying the walkability coefficients for linksets. The walkability coefficients are values, ranging from 0% to 100%, that affect a characters speed. A walkability coefficient of 50% will reduce a character's speed by half while the character is traversing across the linkset.
 

=== Pathfinding Characters Floater ===

==== Overview ====
The intent of Pathfinding Characters floater is primarily for users to locate characters moving throughout a region and to identify the CPU cost of characters affecting the performance of a region.

The floater displays information for all characters within the current region for which the user has the ability to manipulate. The table reports useful information including
* Character Name
* Description
* Owner
* CPU Time
* Altitude

[[File:Characters-floater-1.png|alt=Pathfinding Characters floater|Pathfinding Characters]]
 
==== Controls ====

{{:Viewerhelp:Pathfinding characters}}

==== Example use ====
# If a region owner has created a pathfinding-enabled character but is unable to find the character within the region, the Characters floater can be used to locate and select the character.
# Additionally, the Pathfinding Characters floater reports the CPU time cost for each character within the region. This functionality can be used by advanced users to identify which characters are impacting performance the most.

=== Pathfinding View/Test Floater ===

==== Overview ====

The intent of the Pathfinding View/Test floater is for advanced users who are building pathfinding-enabled objects and characters.

This floater consists of 3 basic areas.

# Status area (illustrating both the Viewer and Simulator status of the region's navmesh)
# View tab Controls
# Test Path tab Controls

The following image is a screenshot of the Pathfinding View/Test floater with the navmesh displayed.

[[File:View-nav-mesh-1.png|alt=Pathfinding View/Test floater with the navmesh displayed|Pathfinding View/Test with navmesh displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with the pathfinding object types displayed.

[[File:View-pf-types-1.png|alt=Pathfinding View/Test floater with the pathfinding object types displayed|Pathfinding View/Test with the pathfinding object types displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with a test path displayed.

[[File:View-test-path-1.png|alt=Pathfinding View/Test floater with a test path displayed|Pathfinding View/Test with a test path displayed]]

 
==== Controls ====

{{:Viewerhelp:Pathfinding edit and test}}

==== Example Use ====

# The advanced user will use the Visualization controls to visualize how the navmesh and related permanent objects have been generated. By seeing this visualization of how the physics engine interprets the navigation information, the advanced user can understand how to better custom the pathfinding-enabled objects to obtain the desired behaviors of characters.
# The advanced user will use the Test Tab to visualize how a test character would choose the path between selected start and end points.

 

== Known Issues ==

{|
!| JIRA
! Summary
! Hardware
|-
| [https://jira.secondlife.com/browse/PATH-572 PATH-572]
| Underwater 'Walkables' shapes are reflected about the water plane
|
|-
| [https://jira.secondlife.com/browse/PATH-643 PATH-643]
| Changes in Preferences dialog stops work of Pathfinding View/Test functionality
|
|-
| [https://jira.secondlife.com/browse/PATH-659 PATH-659]
| navmesh being drawn over worn flexi prims and under avatar
|
|-
| [https://jira.secondlife.com/browse/PATH-781 PATH-781]
| Group-owned objects appear to be owned by 'Unknown' in pathfinding linksets floater
|
|-
| [https://jira.secondlife.com/browse/PATH-790 PATH-790]
| Physics capsule rendering of character shapes is broken after zooming
|
|-
| [https://jira.secondlife.com/browse/PATH-812 PATH-812]
| Show capsules option creates black capsule instead of blue
| ATI Radeon X300 Video card ATI Radeon X600 Video card
|-
| [https://jira.secondlife.com/browse/PATH-813 PATH-813]
| Enable Debug GL crashes the viewer to the desktop
| Mac Pro running 10.7.4 with AMD Radeon HD5770 PC Clone running XP Pro with GeForce2 Ultra
|-
| [https://jira.secondlife.com/browse/PATH-814 PATH-814]
| Sony VAIO PCG-71211 laptop displays black environment
| Sony VAIO PCG-71211 with AMD Radeon HD5650M Mobile graphics
|}

Pathfinding Tools in the Second Life Viewer

2012-07-11T18:07:42Z

Stinson Linden:

{{Pathfinding Nav}}
__TOC__
{{KBnote|The Viewer tools described here are not yet available in a public Second Life Viewer build, but will be soon. }}
== Introduction ==
For pathfinding, each region has a navigation mesh, commonly referred to as a "'''navmesh'''". The '''navmesh''' is a representation of the region's geometry generated and used by the physics simulator to determine paths for the pathfinding characters. The navmesh may be in one of the following three states:

* Up-to-date
* Has pending changes
* Building ''(a.k.a. rebaking)''

The navmesh will transition through these states according to the following diagram:

[[File:Navmesh_transitions.png|alt=Second Life Pathfinding NavMesh Transitions|Second Life Pathfinding NavMesh Transitions]]

Five new elements have been added to the SL Viewer interface to communicate the navmesh state for the current region. These new elements are:

* icon representations of the pathfinding region state for the SLURL bar
* a "Rebake region" button that appears above the lower toolbar
* a right-click context menu option addition
* an additional field on the Build floater
* an additional field on the Object Profile floater

In addition to these new elements, three new floaters allow users to more efficiently create, visualize, test, and debug pathfinding-enabled characters. These tools are not required to create pathfinding behaviors but are particularly useful to builders and experienced creators in Second Life. These new floaters are:

* Pathfinding linksets
* Pathfinding characters
* Pathfinding view / edit

== Pathfinding UI Elements ==

'''Note that other residents editing pathfinding objects on the same region may create pending changes to the navmesh.''' When this occurs, all residents on the same region and with build rights will see the appropriate SLURL bar icons and rebake region button.

=== Pathfinding Icons in SLURL Bar ===

The SLURL bar indicates the three pathfinding states of the current region.
# '''Navmesh is up-to-date''' The current region's navmesh is up-to-date. No icon is shown as this is the expected default state. [[File:Pathfinding-clean-region-1.png|alt=Second Life URL Bar with Up-to-Date NavMesh Icon|Second Life URL Bar with Up-to-Date NavMesh Icon]]
# '''Navmesh has pending changes''' The region has pending changes that have not yet been baked into the navmesh. A pathfinding icon with a construction symbol is shown. [[File:Pathfinding-dirty-region-1.png|alt=Second Life URL Bar with Pending Changes Icon|Second Life URL Bar with Pending Changes Icon]]
# '''Dynamic pathfinding is disabled''' The region has dynamic pathfinding disabled. Pathfinding characters will not work as expected. A pathfinding icon with a disabled symbol is shown. [[File:Pathfinding-disabled-region-1.png|alt=Second Life URL Bar with Pathfinding Disabled Icon|Second Life URL Bar with Pathfinding Disabled Icon]]

=== Rebake Region Button ===

When a region has pending changes, the appropriate icon will be shown in the SLURL bar, as described above. In addition, if the user has build rights for any parcel on the current region, the user will also be able to see a "Rebake region" button that displays above the lower toolbar.

[[File:Rebake-button-1.png|alt=Second Life Rebake Region button that allows permitted users to rebake pathfinding changes into the navmesh]]

When the user clicks this button, a request is sent to the region to rebake the navmesh for the current region. As rebaking a region may be a time intensive process, the button will change to indicate "Region is rebaking" during this server process. After the rebaking is complete, this button on the viewer will vanish.

[[File:Rebaking-button-1.png|alt=Second Life Region is Rebaking button that indicates that the current region is rebaking its navmesh]]

=== Right-click context menu behavior ===

When right-clicking on an object in-world, pathfinding-specific menu options may be included in the pop-up context menu.

If the user right-clicks on a '''linkset''' object in-world, a menu option "Show in linksets" will allow the user to open the Pathfinding Linksets floater with the current object selected.

[[File:Right-click-show-in-linksets-1.png|alt=Second Life Context Menu with Show in Linksets floater menu option]]

If the user right-clicks on a pathfinding '''character''' object in-world, a menu option "Show in characters" will allow the user to open the Pathfinding Characters floater with the current object selected.

[[File:Right-click-show-in-characters-1.png|alt=Second Life Context Menu with Show in Characters floater menu option]]

=== Additional field on the Build floater ===

The Build floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Build floater with a ''character'' object selected.

[[File:Build-floater-character-1.png|alt=Build floater with pathfinding attribute character|Build floater with pathfinding attribute character]]

The following image is a screenshot of the Build floater with an object that ''affects navmesh'' selected. This object could be a ''walkable'', ''static obstacle'', ''material volume'', or ''exclusion volume''.

[[File:Build-floater-affects-navmesh-1.png|alt=Build floater with pathfinding attribute affects navmesh|Build floater with pathfinding attribute affects navmesh]]

{{KBwarning|For linksets that do affect the navmesh, it will be impossible to modify the object across the region boundary. The user and the object affecting a navmesh must be in the same region to enable modification of the object. This will be indicated on the General tab of the Build floater as illustrated in the following screenshot.}}
[[File:Build-floater-region-boundary-1.png|alt=Build floater indicating that the user cannot modify object across a region boundary|Build floater indicating that the user cannot modify object across a region boundary]]

=== Additional field on the Object Profile floater ===

Similar to the afore-described Build floater, the Object Profile floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Object Profile floater with an ''affects navmesh'' object selected.

[[File:Object-profile-1.png|alt=Object Profile floater with pathfinding attribute affects navmesh|Object Profile floater with pathfinding attribute affects navmesh]]

== Pathfinding Floaters ==

These three pathfinding floaters may all be accessed through the Build->Pathfinding menu in the Project Viewer - Pathfinding.

[[File:Build-menu-pf-selected-1.png|alt=Second Life Build Menu with new Pathfinding menu items|SL Build -> Pathfinding Menu]]

 

=== Pathfinding Linksets Floater ===

==== Overview ====

The intent of the Pathfinding Linksets floater is to give advanced users and builders the ability to customize an area to achieve interesting effects with pathfinding-enabled characters.

The floater displays information for all linksets within the current region for which the user has the ability to alter. The table reports useful information including
* Linkset Name
* Description
* Owner
* Land Impact
* Distance from the resident's avatar
* Linkset Use
** Potential values
*** Walkable
*** Static Obstacle
*** Movable Obstacle
*** Material Volume
*** Exclusion Volume
*** Movable Phantom
* Walkability Coefficients
** Character Type A ''(example use: humanoid)''
** Character Type B ''(example use: creature)''
** Character Type C ''(example use: mechanical)''
** Character Type D ''(example use: other)''

Additionally, selecting any linksets within the floater will also select the object(s) within the Viewer.

[[File:Linksets-floater-2.png|alt=Pathfinding Linksets floater|Pathfinding Linksets]]

 

==== Controls ====

{{:Viewerhelp:Pathfinding linksets}}

==== Example use ====

The advanced users and builders will use the Pathfinding Linksets floater to customize areas to create interesting effects for pathfinding-enabled characters.

For instance, imagine the scenario of a builder constructing a single room in a pathfinding-enabled house. For the single room, the builder would use the following types as follows:

{|border="1"
! Linkset Use !! Description
|-
|width="200" align="center" | Walkable || align="left" | The floor linkset would be set to be Walkable to allow characters to move across the floor.
|-
|width="200" align="center" | Static Obstacle || align="left" | A desk linkset in the room would be set to be Static Obstacle to block characters from walking through or across the object.

NOTE Any object that should block character movement and that does not move should be marked as Static Obstacle to improve performance of pathfinding characters.
|-
|width="200" align="center" | Movable Obstacle || align="left" | A door linkset in the room would be set to be Movable Obstacle. This will still block characters but, in contrast to Static Obstacles, Movable Obstacles will allow the linkset itself to move. In the case of the door, this will allow the door to open and close, but will still prevent characters from walking through the door.
|-
|width="200" align="center" | Material Volume || align="left" | Material Volumes are phantom objects that can be used to affect the walkability coefficients of intersecting objects. Imagine that the builder applied a texture to the floor. Also, imagine that the floor texture includes small throw rug in the middle of the room. (The builder did not want to create a separate object for the rug, so is using a texture on the floor to give the appearance of a rug). The builder can then create a Material Volume object intersecting the floor at the location of the rug. Then, by setting a lower walkability coefficient for the Material Volume, the builder will create the affect of slowing down characters as the characters traverse across the painted rug area.
|-
|width="200" align="center" | Exclusion Volume || align="left" | Exclusion Volumes are phantom objects that can be used to create areas where characters are prevented from moving. For instance, the builder can use an Exclusion Volume to create a section of the room where avatars would be able to move, but characters would be blocked from following.
|-
|width="200" align="center" | Movable Phantom || align="left" | Movable Phantoms are phantom objects that have no affect on pathfinding-enabled characters.
|}
 
In addition to linkset use attributes, builders can achieve additional effects by modifying the walkability coefficients for linksets. The walkability coefficients are values, ranging from 0% to 100%, that affect a characters speed. A walkability coefficient of 50% will reduce a character's speed by half while the character is traversing across the linkset.
 

=== Pathfinding Characters Floater ===

==== Overview ====
The intent of Pathfinding Characters floater is primarily for users to locate characters moving throughout a region and to identify the CPU cost of characters affecting the performance of a region.

The floater displays information for all characters within the current region for which the user has the ability to manipulate. The table reports useful information including
* Character Name
* Description
* Owner
* CPU Time
* Altitude

[[File:Characters-floater-1.png|alt=Pathfinding Characters floater|Pathfinding Characters]]
 
==== Controls ====

{{:Viewerhelp:Pathfinding characters}}

==== Example use ====
# If a region owner has created a pathfinding-enabled character but is unable to find the character within the region, the Characters floater can be used to locate and select the character.
# Additionally, the Pathfinding Characters floater reports the CPU time cost for each character within the region. This functionality can be used by advanced users to identify which characters are impacting performance the most.

=== Pathfinding View/Test Floater ===

==== Overview ====

The intent of the Pathfinding View/Test floater is for advanced users who are building pathfinding-enabled objects and characters.

This floater consists of 3 basic areas.

# Status area (illustrating both the Viewer and Simulator status of the region's navmesh)
# View tab Controls
# Test Path tab Controls

The following image is a screenshot of the Pathfinding View/Test floater with the navmesh displayed.

[[File:View-nav-mesh-1.png|alt=Pathfinding View/Test floater with the navmesh displayed|Pathfinding View/Test with navmesh displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with the pathfinding object types displayed.

[[File:View-pf-types-1.png|alt=Pathfinding View/Test floater with the pathfinding object types displayed|Pathfinding View/Test with the pathfinding object types displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with a test path displayed.

[[File:View-test-path-1.png|alt=Pathfinding View/Test floater with a test path displayed|Pathfinding View/Test with a test path displayed]]

 
==== Controls ====

{{:Viewerhelp:Pathfinding edit and test}}

==== Example Use ====

# The advanced user will use the Visualization controls to visualize how the navmesh and related permanent objects have been generated. By seeing this visualization of how the physics engine interprets the navigation information, the advanced user can understand how to better custom the pathfinding-enabled objects to obtain the desired behaviors of characters.
# The advanced user will use the Test Tab to visualize how a test character would choose the path between selected start and end points.

 

== Known Issues ==

Pathfinding Tools in the Second Life Viewer

2012-07-11T17:41:49Z

Stinson Linden:

{{Pathfinding Nav}}
__TOC__
{{KBnote|The Viewer tools described here are not yet available in a public Second Life Viewer build, but will be soon. }}
== Introduction ==
For pathfinding, each region has a navigation mesh, commonly referred to as a "'''navmesh'''". The '''navmesh''' is a representation of the region's geometry generated and used by the physics simulator to determine paths for the pathfinding characters. The navmesh may be in one of the following three states:

* Up-to-date
* Has pending changes
* Building ''(a.k.a. rebaking)''

The navmesh will transition through these states according to the following diagram:

[[File:Navmesh_transitions.png|alt=Second Life Pathfinding NavMesh Transitions|Second Life Pathfinding NavMesh Transitions]]

Five new elements have been added to the SL Viewer interface to communicate the navmesh state for the current region. These new elements are:

* icon representations of the pathfinding region state for the SLURL bar
* a "Rebake region" button that appears above the lower toolbar
* a right-click context menu option addition
* an additional field on the Build floater
* an additional field on the Object Profile floater

In addition to these new elements, three new floaters allow users to more efficiently create, visualize, test, and debug pathfinding-enabled characters. These tools are not required to create pathfinding behaviors but are particularly useful to builders and experienced creators in Second Life. These new floaters are:

* Pathfinding linksets
* Pathfinding characters
* Pathfinding view / edit

== Pathfinding UI Elements ==

'''Note that other residents editing pathfinding objects on the same region may create pending changes to the navmesh.''' When this occurs, all residents on the same region and with build rights will see the appropriate SLURL bar icons and rebake region button.

=== Pathfinding Icons in SLURL Bar ===

The SLURL bar indicates the three pathfinding states of the current region.
# '''Navmesh is up-to-date''' The current region's navmesh is up-to-date. No icon is shown as this is the expected default state. [[File:Pathfinding-clean-region-1.png|alt=Second Life URL Bar with Up-to-Date NavMesh Icon|Second Life URL Bar with Up-to-Date NavMesh Icon]]
# '''Navmesh has pending changes''' The region has pending changes that have not yet been baked into the navmesh. A pathfinding icon with a construction symbol is shown. [[File:Pathfinding-dirty-region-1.png|alt=Second Life URL Bar with Pending Changes Icon|Second Life URL Bar with Pending Changes Icon]]
# '''Dynamic pathfinding is disabled''' The region has dynamic pathfinding disabled. Pathfinding characters will not work as expected. A pathfinding icon with a disabled symbol is shown. [[File:Pathfinding-disabled-region-1.png|alt=Second Life URL Bar with Pathfinding Disabled Icon|Second Life URL Bar with Pathfinding Disabled Icon]]

=== Rebake Region Button ===

When a region has pending changes, the appropriate icon will be shown in the SLURL bar, as described above. In addition, if the user has build rights for any parcel on the current region, the user will also be able to see a "Rebake region" button that displays above the lower toolbar.

[[File:Rebake-button-1.png|alt=Second Life Rebake Region button that allows permitted users to rebake pathfinding changes into the navmesh]]

When the user clicks this button, a request is sent to the region to rebake the navmesh for the current region. As rebaking a region may be a time intensive process, the button will change to indicate "Region is rebaking".

[[File:Rebaking-button-1.png|alt=Second Life Region is Rebaking button that indicates that the current region is rebaking its navmesh]]

=== Right-click context menu behavior ===

When right-clicking on an object in-world, pathfinding-specific menu options may be included in the pop-up context menu.

If the user right-clicks on a '''linkset''' object in-world, a menu option "Show in linksets" will allow the user to open the Pathfinding Linksets floater with the current object selected.

[[File:Right-click-show-in-linksets-1.png|alt=Second Life Context Menu with Show in Linksets floater menu option]]

If the user right-clicks on a pathfinding '''character''' object in-world, a menu option "Show in characters" will allow the user to open the Pathfinding Characters floater with the current object selected.

[[File:Right-click-show-in-characters-1.png|alt=Second Life Context Menu with Show in Characters floater menu option]]

=== Additional field on the Build floater ===

The Build floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Build floater with a ''character'' object selected.

[[File:Build-floater-character-1.png|alt=Build floater with pathfinding attribute character|Build floater with pathfinding attribute character]]

The following image is a screenshot of the Build floater with an object that ''affects navmesh'' selected. This object could be a ''walkable'', ''static obstacle'', ''material volume'', or ''exclusion volume''.

[[File:Build-floater-affects-navmesh-1.png|alt=Build floater with pathfinding attribute affects navmesh|Build floater with pathfinding attribute affects navmesh]]

{{KBwarning|For linksets that do affect the navmesh, it will be impossible to modify the object across the region boundary. The user and the object affecting a navmesh must be in the same region to enable modification of the object. This will be indicated on the General tab of the Build floater as illustrated in the following screenshot.}}
[[File:Build-floater-region-boundary-1.png|alt=Build floater indicating that the user cannot modify object across a region boundary|Build floater indicating that the user cannot modify object across a region boundary]]

=== Additional field on the Object Profile floater ===

Similar to the afore-described Build floater, the Object Profile floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Object Profile floater with an ''affects navmesh'' object selected.

[[File:Object-profile-1.png|alt=Object Profile floater with pathfinding attribute affects navmesh|Object Profile floater with pathfinding attribute affects navmesh]]

== Pathfinding Floaters ==

These three pathfinding floaters may all be accessed through the Build->Pathfinding menu in the Project Viewer - Pathfinding.

[[File:Build-menu-pf-selected-1.png|alt=Second Life Build Menu with new Pathfinding menu items|SL Build -> Pathfinding Menu]]

 

=== Pathfinding Linksets Floater ===

==== Overview ====

The intent of the Pathfinding Linksets floater is to give advanced users and builders the ability to customize an area to achieve interesting effects with pathfinding-enabled characters.

The floater displays information for all linksets within the current region for which the user has the ability to alter. The table reports useful information including
* Linkset Name
* Description
* Owner
* Land Impact
* Distance from the resident's avatar
* Linkset Use
** Potential values
*** Walkable
*** Static Obstacle
*** Movable Obstacle
*** Material Volume
*** Exclusion Volume
*** Movable Phantom
* Walkability Coefficients
** Character Type A
** Character Type B
** Character Type C
** Character Type D

Additionally, selecting any linksets within the floater will also select the object(s) within the Viewer.

[[File:Linksets-floater-2.png|alt=Pathfinding Linksets floater|Pathfinding Linksets]]

 

==== Controls ====

{{:Viewerhelp:Pathfinding linksets}}

==== Example use ====

The advanced users and builders will use the Pathfinding Linksets floater to customize areas to create interesting effects for pathfinding-enabled characters.

For instance, imagine the scenario of a builder constructing a single room in a pathfinding-enabled house. For the single room, the builder would use the following types as follows:

{|border="1"
! Linkset Use !! Description
|-
|width="200" align="center" | Walkable || align="left" | The floor linkset would be set to be Walkable to allow characters to move across the floor.
|-
|width="200" align="center" | Static Obstacle || align="left" | A desk linkset in the room would be set to be Static Obstacle to block characters from walking through or across the object.

NOTE Any object that should block character movement and that does not move should be marked as Static Obstacle to improve performance of pathfinding characters.
|-
|width="200" align="center" | Movable Obstacle || align="left" | A door linkset in the room would be set to be Movable Obstacle. This will still block characters but, in contrast to Static Obstacles, Movable Obstacles will allow the linkset itself to move. In the case of the door, this will allow the door to open and close, but will still prevent characters from walking through the door.
|-
|width="200" align="center" | Material Volume || align="left" | Material Volumes are phantom objects that can be used to affect the walkability coefficients of intersecting objects. Imagine that the builder applied a texture to the floor. Also, imagine that the floor texture includes small throw rug in the middle of the room. (The builder did not want to create a separate object for the rug, so is using a texture on the floor to give the appearance of a rug). The builder can then create a Material Volume object intersecting the floor at the location of the rug. Then, by setting a lower walkability coefficient for the Material Volume, the builder will create the affect of slowing down characters as the characters traverse across the painted rug area.
|-
|width="200" align="center" | Exclusion Volume || align="left" | Exclusion Volumes are phantom objects that can be used to create areas where characters are prevented from moving. For instance, the builder can use an Exclusion Volume to create a section of the room where avatars would be able to move, but characters would be blocked from following.
|-
|width="200" align="center" | Movable Phantom || align="left" | Movable Phantoms are phantom objects that have no affect on pathfinding-enabled characters.
|}
 
In addition to linkset use attributes, builders can achieve additional effects by modifying the walkability coefficients for linksets. The walkability coefficients are values, ranging from 0% to 100%, that affect a characters speed. A walkability coefficient of 50% will reduce a characters by half while the character is traversing across the linkset.
 

=== Pathfinding Characters Floater ===

==== Overview ====
The intent of Pathfinding Characters floater is primarily for users to locate characters moving throughout a region and to identify the CPU cost of characters affecting the performance of a region.

The floater displays information for all characters within the current region for which the user has the ability to manipulate. The table reports useful information including
* Character Name
* Description
* Owner
* CPU Time
* Altitude

[[File:Characters-floater-1.png|alt=Pathfinding Characters floater|Pathfinding Characters]]
 
==== Controls ====

{{:Viewerhelp:Pathfinding characters}}

==== Example use ====
# If a region owner has created a pathfinding-enabled character but is unable to find the character within the region, the Characters floater can be used to locate and select the character.
# Additionally, the Pathfinding Characters floater reports the CPU time cost for each character within the region. This functionality can be used by advanced users to identify which characters are impacting performance the most.

=== Pathfinding View/Test Floater ===

==== Overview ====

The intent of the Pathfinding View/Test floater is for advanced users who are building pathfinding-enabled objects and characters.

This floater consists of 3 basic areas.

# Status area (illustrating both the Viewer and Simulator status of the region's navmesh)
# View tab Controls
# Test Path tab Controls

The following image is a screenshot of the Pathfinding View/Test floater with the navmesh displayed.

[[File:View-nav-mesh-1.png|alt=Pathfinding View/Test floater with the navmesh displayed|Pathfinding View/Test with navmesh displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with the pathfinding object types displayed.

[[File:View-pf-types-1.png|alt=Pathfinding View/Test floater with the pathfinding object types displayed|Pathfinding View/Test with the pathfinding object types displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with a test path displayed.

[[File:View-test-path-1.png|alt=Pathfinding View/Test floater with a test path displayed|Pathfinding View/Test with a test path displayed]]

 
==== Controls ====

{{:Viewerhelp:Pathfinding edit and test}}

==== Example Use ====

# The advanced user will use the Visualization controls to visualize how the navmesh and related permanent objects have been generated. By seeing this visualization of how the physics engine interprets the navigation information, the advanced user can understand how to better custom the pathfinding-enabled objects to obtain the desired behaviors of characters.
# The advanced user will use the Test Tab to visualize how a test character would choose the path between selected start and end points.

 

== Known Issues ==

File:Linksets-floater-2.png

2012-07-11T17:39:07Z

Stinson Linden:

Pathfinding Tools in the Second Life Viewer

2012-07-10T00:03:05Z

Stinson Linden: /* Additional field on the Object Profile floater */

{{Pathfinding Nav}}
__TOC__
{{KBnote|The Viewer tools described here are not yet available in a public Second Life Viewer build, but will be soon. }}
== Introduction ==
For pathfinding, each region has a navigation mesh, commonly referred to as a "'''navmesh'''". The '''navmesh''' is a representation of the region's geometry generated and used by the physics simulator to determine paths for the pathfinding characters. The navmesh may be in one of the following three states:

* Up-to-date
* Has pending changes
* Building ''(a.k.a. rebaking)''

The navmesh will transition through these states according to the following diagram:

[[File:Navmesh_transitions.png|alt=Second Life Pathfinding NavMesh Transitions|Second Life Pathfinding NavMesh Transitions]]

Five new elements have been added to the SL Viewer interface to communicate the navmesh state for the current region. These new elements are:

* icon representations of the pathfinding region state for the SLURL bar
* a "Rebake region" button that appears above the lower toolbar
* a right-click context menu option addition
* an additional field on the Build floater
* an additional field on the Object Profile floater

In addition to these new elements, three new floaters allow users to more efficiently create, visualize, test, and debug pathfinding-enabled characters. These tools are not required to create pathfinding behaviors but are particularly useful to builders and experienced creators in Second Life. These new floaters are:

* Pathfinding linksets
* Pathfinding characters
* Pathfinding view / edit

== Pathfinding UI Elements ==

'''Note that other residents editing pathfinding objects on the same region may create pending changes to the navmesh.''' When this occurs, all residents on the same region and with build rights will see the appropriate SLURL bar icons and rebake region button.

=== Pathfinding Icons in SLURL Bar ===

The SLURL bar indicates the three pathfinding states of the current region.
# '''Navmesh is up-to-date''' The current region's navmesh is up-to-date. No icon is shown as this is the expected default state. [[File:Pathfinding-clean-region-1.png|alt=Second Life URL Bar with Up-to-Date NavMesh Icon|Second Life URL Bar with Up-to-Date NavMesh Icon]]
# '''Navmesh has pending changes''' The region has pending changes that have not yet been baked into the navmesh. A pathfinding icon with a construction symbol is shown. [[File:Pathfinding-dirty-region-1.png|alt=Second Life URL Bar with Pending Changes Icon|Second Life URL Bar with Pending Changes Icon]]
# '''Dynamic pathfinding is disabled''' The region has dynamic pathfinding disabled. Pathfinding characters will not work as expected. A pathfinding icon with a disabled symbol is shown. [[File:Pathfinding-disabled-region-1.png|alt=Second Life URL Bar with Pathfinding Disabled Icon|Second Life URL Bar with Pathfinding Disabled Icon]]

=== Rebake Region Button ===

When a region has pending changes, the appropriate icon will be shown in the SLURL bar, as described above. In addition, if the user has build rights for any parcel on the current region, the user will also be able to see a "Rebake region" button that displays above the lower toolbar.

[[File:Rebake-button-1.png|alt=Second Life Rebake Region button that allows permitted users to rebake pathfinding changes into the navmesh]]

When the user clicks this button, a request is sent to the region to rebake the navmesh for the current region. As rebaking a region may be a time intensive process, the button will change to indicate "Region is rebaking".

[[File:Rebaking-button-1.png|alt=Second Life Region is Rebaking button that indicates that the current region is rebaking its navmesh]]

=== Right-click context menu behavior ===

When right-clicking on an object in-world, pathfinding-specific menu options may be included in the pop-up context menu.

If the user right-clicks on a '''linkset''' object in-world, a menu option "Show in linksets" will allow the user to open the Pathfinding Linksets floater with the current object selected.

[[File:Right-click-show-in-linksets-1.png|alt=Second Life Context Menu with Show in Linksets floater menu option]]

If the user right-clicks on a pathfinding '''character''' object in-world, a menu option "Show in characters" will allow the user to open the Pathfinding Characters floater with the current object selected.

[[File:Right-click-show-in-characters-1.png|alt=Second Life Context Menu with Show in Characters floater menu option]]

=== Additional field on the Build floater ===

The Build floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Build floater with a ''character'' object selected.

[[File:Build-floater-character-1.png|alt=Build floater with pathfinding attribute character|Build floater with pathfinding attribute character]]

The following image is a screenshot of the Build floater with an object that ''affects navmesh'' selected. This object could be a ''walkable'', ''static obstacle'', ''material volume'', or ''exclusion volume''.

[[File:Build-floater-affects-navmesh-1.png|alt=Build floater with pathfinding attribute affects navmesh|Build floater with pathfinding attribute affects navmesh]]

{{KBwarning|For linksets that do affect the navmesh, it will be impossible to modify the object across the region boundary. The user and the object affecting a navmesh must be in the same region to enable modification of the object. This will be indicated on the General tab of the Build floater as illustrated in the following screenshot.}}
[[File:Build-floater-region-boundary-1.png|alt=Build floater indicating that the user cannot modify object across a region boundary|Build floater indicating that the user cannot modify object across a region boundary]]

=== Additional field on the Object Profile floater ===

Similar to the afore-described Build floater, the Object Profile floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Object Profile floater with an ''affects navmesh'' object selected.

[[File:Object-profile-1.png|alt=Object Profile floater with pathfinding attribute affects navmesh|Object Profile floater with pathfinding attribute affects navmesh]]

== Pathfinding Floaters ==

These three pathfinding floaters may all be accessed through the Build->Pathfinding menu in the Project Viewer - Pathfinding.

[[File:Build-menu-pf-selected-1.png|alt=Second Life Build Menu with new Pathfinding menu items|SL Build -> Pathfinding Menu]]

 

=== Pathfinding Linksets Floater ===

==== Overview ====

The intent of the Pathfinding Linksets floater is to give advanced users and builders the ability to customize an area to achieve interesting effects with pathfinding-enabled characters.

The floater displays information for all linksets within the current region for which the user has the ability to alter. The table reports useful information including
* Linkset Name
* Description
* Owner
* Land Impact
* Distance from the resident's avatar
* Linkset Use
** Potential values
*** Walkable
*** Static Obstacle
*** Movable Obstacle
*** Material Volume
*** Exclusion Volume
*** Movable Phantom
* Walkability Coefficients
** Character Type A
** Character Type B
** Character Type C
** Character Type D

Additionally, selecting any linksets within the floater will also select the object(s) within the Viewer.

[[File:Linksets-floater-1.png|alt=Pathfinding Linksets floater|Pathfinding Linksets]]

 

==== Controls ====

{{:Viewerhelp:Pathfinding linksets}}

==== Example use ====

The advanced users and builders will use the Pathfinding Linksets floater to customize areas to create interesting effects for pathfinding-enabled characters.

For instance, imagine the scenario of a builder constructing a single room in a pathfinding-enabled house. For the single room, the builder would use the following types as follows:

{|border="1"
! Linkset Use !! Description
|-
|width="200" align="center" | Walkable || align="left" | The floor linkset would be set to be Walkable to allow characters to move across the floor.
|-
|width="200" align="center" | Static Obstacle || align="left" | A desk linkset in the room would be set to be Static Obstacle to block characters from walking through or across the object.

NOTE Any object that should block character movement and that does not move should be marked as Static Obstacle to improve performance of pathfinding characters.
|-
|width="200" align="center" | Movable Obstacle || align="left" | A door linkset in the room would be set to be Movable Obstacle. This will still block characters but, in contrast to Static Obstacles, Movable Obstacles will allow the linkset itself to move. In the case of the door, this will allow the door to open and close, but will still prevent characters from walking through the door.
|-
|width="200" align="center" | Material Volume || align="left" | Material Volumes are phantom objects that can be used to affect the walkability coefficients of intersecting objects. Imagine that the builder applied a texture to the floor. Also, imagine that the floor texture includes small throw rug in the middle of the room. (The builder did not want to create a separate object for the rug, so is using a texture on the floor to give the appearance of a rug). The builder can then create a Material Volume object intersecting the floor at the location of the rug. Then, by setting a lower walkability coefficient for the Material Volume, the builder will create the affect of slowing down characters as the characters traverse across the painted rug area.
|-
|width="200" align="center" | Exclusion Volume || align="left" | Exclusion Volumes are phantom objects that can be used to create areas where characters are prevented from moving. For instance, the builder can use an Exclusion Volume to create a section of the room where avatars would be able to move, but characters would be blocked from following.
|-
|width="200" align="center" | Movable Phantom || align="left" | Movable Phantoms are phantom objects that have no affect on pathfinding-enabled characters.
|}
 
In addition to linkset use attributes, builders can achieve additional effects by modifying the walkability coefficients for linksets. The walkability coefficients are values, ranging from 0% to 100%, that affect a characters speed. A walkability coefficient of 50% will reduce a characters by half while the character is traversing across the linkset.
 

=== Pathfinding Characters Floater ===

==== Overview ====
The intent of Pathfinding Characters floater is primarily for users to locate characters moving throughout a region and to identify the CPU cost of characters affecting the performance of a region.

The floater displays information for all characters within the current region for which the user has the ability to manipulate. The table reports useful information including
* Character Name
* Description
* Owner
* CPU Time
* Altitude

[[File:Characters-floater-1.png|alt=Pathfinding Characters floater|Pathfinding Characters]]
 
==== Controls ====

{{:Viewerhelp:Pathfinding characters}}

==== Example use ====
# If a region owner has created a pathfinding-enabled character but is unable to find the character within the region, the Characters floater can be used to locate and select the character.
# Additionally, the Pathfinding Characters floater reports the CPU time cost for each character within the region. This functionality can be used by advanced users to identify which characters are impacting performance the most.

=== Pathfinding View/Test Floater ===

==== Overview ====

The intent of the Pathfinding View/Test floater is for advanced users who are building pathfinding-enabled objects and characters.

This floater consists of 3 basic areas.

# Status area (illustrating both the Viewer and Simulator status of the region's navmesh)
# View tab Controls
# Test Path tab Controls

The following image is a screenshot of the Pathfinding View/Test floater with the navmesh displayed.

[[File:View-nav-mesh-1.png|alt=Pathfinding View/Test floater with the navmesh displayed|Pathfinding View/Test with navmesh displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with the pathfinding object types displayed.

[[File:View-pf-types-1.png|alt=Pathfinding View/Test floater with the pathfinding object types displayed|Pathfinding View/Test with the pathfinding object types displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with a test path displayed.

[[File:View-test-path-1.png|alt=Pathfinding View/Test floater with a test path displayed|Pathfinding View/Test with a test path displayed]]

 
==== Controls ====

{{:Viewerhelp:Pathfinding edit and test}}

==== Example Use ====

# The advanced user will use the Visualization controls to visualize how the navmesh and related permanent objects have been generated. By seeing this visualization of how the physics engine interprets the navigation information, the advanced user can understand how to better custom the pathfinding-enabled objects to obtain the desired behaviors of characters.
# The advanced user will use the Test Tab to visualize how a test character would choose the path between selected start and end points.

 

== Known Issues ==