Walk Navigation

How it works.

Scene lists and thumbnails tell visitors what exists, not where it is. Walk Navigation draws an arrow on the floor toward every neighbouring scene, so the way through the building is part of the panorama. A click walks there in 3D and arrives facing the direction the visitor walked. The arrows are built from the positions you already have — the spots of our Floor Plan, or the same three numbers in your own XML element — and every setting is an attribute of one XML element.

Installation.

1
Copy one folder

Put the encrypted plugin folder into your tour and add one layer element to your tour XML.
2
Say where the scenes are

Use the spots of our Floor Plan, or write one spot element per scene with its position on the plan and its heading.
3
Correct only what is wrong

Optional link elements hide a way, aim it by hand, move an arrow closer or give it a name.

Why it makes a difference.

The way is in the panorama

Arrows lie on the floor where the door or the corridor is, so visitors walk the building instead of picking scenes from a list.

Arrive facing ahead

The new scene faces exactly the direction the visitor walked, so nobody has to find their bearings again after every step.

No second data entry

The arrows are computed from the plan positions of our Floor Plan, or from three numbers per scene in your own XML.

Screenshots.

Try the demo

**Desktop** Arrows on the floor of the lounge show the way to the neighbouring rooms.

**Phone** On a phone the arrows are larger and the arrow in the middle of the view shows its label.

**Detail** The arrow under the mouse lights up and shows the room name and the distance.

Settings.

Set as attributes in your tour XML.

Setting	Type	Default	Description
`active`	Yes / No	`true`	Switches the arrows on or off at runtime (default true).
`spot_scale`	Number	`0`	Centimetres per unit of your spot positions, for example 2 for a plan image at 2 cm per pixel (0–1000, default 0). Without it there are no distances in the labels and no link_radius.
`link_max`	Number	`4`	Largest number of arrows in one scene (1–8, default 4).
`link_radius`	Number	`0`	Largest distance of an automatic link in centimetres (0–100000, default 0 = no limit); needs spot_scale.
`link_angle`	Number	`25`	Smallest angle between two arrows in degrees; a scene behind a nearer one is dropped (0–90, default 25).
`arrow_distance`	Number	`250`	Distance of the arrows from the camera on the floor in centimetres (120–600, default 250). A single arrow can be moved with the distance of its link element.
`arrow_size`	Number	`60`	Size of an arrow on the floor in centimetres (20–200, default 60); ×1.3 on touch devices and in VR.
`eye_height`	Number	`160`	Height of the camera above the floor in centimetres (50–400, default 160).
`arrow_color`	Color	`#FFFFFF`	Colour of the arrows (default #FFFFFF); ignored with your own arrow_url image.
`accent_color`	Color	`#3D8BFF`	Colour of the arrow under the mouse or the gaze (default #3D8BFF).
`arrow_url`	Text	—	Your own arrow image (PNG, JPG or WebP) with the tip pointing up; empty uses the built-in chevron.
`labels`	List	`auto`	auto (default) shows the label under the mouse, and on touch and in VR the label of the arrow nearest the middle of the view; always shows every label; off shows none. `autoalwaysoff`
`walk`	List	`turn`	turn (default) turns toward the arrow and then walks through the room in 3D; blend cross-fades into the new scene facing the walking direction. `turnblend`
`walk_time`	Number	`1`	Length of the walk or of the cross-fade in seconds (0.3–3, default 1).
`turn_time`	Number	`0.4`	Length of the turn toward the arrow before the walk in seconds (0–1.5, default 0.4); 0 walks at once.
`motion_blur`	Number	`0.4`	Motion blur of the 3D walk (0–0.9, default 0.4).
`vr_walk`	List	`turn`	Walk mode in VR: turn (default) is the same 3D walk as on screen; blend cross-fades instead. `turnblend`
`vr_dwell`	Yes / No	`true`	Looking at an arrow in VR activates it after about two seconds, through the krpano WebVR plugin (default true); false leaves the controller or the screen tap.
`walk_other`	Yes / No	`true`	Also walk when another z360 plugin — for example Floor Plan or Tour Navigator — opens a scene an arrow leads to (default true).
`transition`	Yes / No	`true`	Fades and scales the arrows and labels; false changes them at once. Visitors who turned on reduced motion never get the motion, and their scene change is always a cross-fade.
`transition_duration`	Number	`250`	Length of these transitions in milliseconds (100–1000, default 250).
`calibrate`	Yes / No	`false`	Creator mode: a bar with the links of the current scene that measures an aimed direction and prints the finished link line; never leave it on in a published tour (default false).
`debug`	Yes / No	`false`	Prints the number of spots and links and the direction, arrival and distance of every link to the browser console (default false).
`text_label`	Text	`{title} · {distance}`	The label text (default “{title} · {distance}”); {title} is the scene name, {distance} the distance in metres, shown only with spot_scale. A <languages> key or literal text.

Example

<include url="walknav.xml" />

<layer name="z360_walk_navigation"
       url="plugins/z360_walk_navigation/z360_walk_navigation.js"
       keep="true"
       spot_scale="2" />

<!-- walknav.xml: one spot per scene, plus corrections where you need them -->
<z360_walk_navigation_spot name="scene_lounge" floor="ground" x="560" y="250" heading="-121" />
<z360_walk_navigation_spot name="scene_pool" floor="ground" x="640" y="700" heading="-147.3" />
<z360_walk_navigation_link name="lounge_pool" from="scene_lounge" to="scene_pool" distance="140" />

Features

An arrow on the floor toward every neighbouring scene, built from the scene positions
Built-in chevron in any colour, or your own arrow image
Labels with the scene name and the real distance in metres
Walk transition that turns toward the arrow and then walks in 3D, or a cross-fade
Arrival direction exactly along the way walked
Also walks when our Floor Plan or Tour Navigator opens a neighbouring scene
Automatic links between the nearest scenes, with limits for number, angle and distance
Link elements to hide, aim, rename or move single arrows, and for cross-floor stairs
Walls hide arrows in tours with a depthmap or a 3D model
Larger arrows on phones and in VR, with the label of the arrow in the middle of the view
VR: arrows in both eyes, gaze activation through the krpano WebVR plugin and the same 3D walk as on screen
Calibration mode that prints the finished link line
Smooth transitions, off with reduced motion
Encrypted plugin file, every setting as an XML attribute