Configuration

After the installation you will find a new menu item pdir Apps in the main menu of the back end. It contains three entries: Panoramas, Hotspots and Configuration. The three entries are largely self-explanatory.

under »Panoramas« you manage all panoramas registered in the system
under »Hotspots« you manage all hotspots. Hotspots are always assigned to one or more panoramas.
under »Configuration« you manage a krpano configuration.

List

This menu item gives access to the available panoramas. They are shown in a customized list. Each record is shown with a heading and in two columns. The heading shows the ID of the panorama and its name. The left column contains data about the hotspots and a preview image (krpano preview.jpg, if one was generated). The right column (currently) contains the description text, as it can be very long.

Edit

As usual in Contao, click the yellow pencil to edit a record. The detail view looks like this: Each panorama record gives access to the following data:

Panorama name and alias

You can set a name and an alias for each panorama.

The field of view (also called »view«)

A view consists of three parameters: the horizontal viewing direction, the vertical viewing direction and the field of view angle (sometimes called the zoom value). The view is initialized with start values when it loads. You enter them under Field of view and viewing direction:

the start viewing direction, horizontal (krpano pov = point of view) is a decimal number with two decimal places. The range is from -180.00° (left) to +180° (right). This setting may differ from older krpano versions. Strictly speaking, -180° = +180°, i.e. a vector on the horizon plane pointing »backwards«. If you want to know more about the structure and configuration of a view, we recommend the krpano documentation on the view.
the start viewing direction, vertical (krpano poh = point of heading) is also a decimal number with two decimal places. The range is from +90.00° (zenith) to -90° (nadir).
the start field of view angle (fov = field of view) is a decimal number with two decimal places. The range is (theoretically) 0.00°, (in practice) 27.54° to (theoretically) 180.00°, (in practice) 120.00°.

Preview

The preview window is below the view parameters and shows the current panorama. It is initialized with the values of the view. The preview also shows all hotspots associated with the panorama and several overlays. It looks like this:

Overlay »View«

At the top left there is an overlay with the three parameters (pov, poh and fov) of the view. It shows the parameters of the current view. If you click into the preview and »drag« the panorama with the mouse button held down, you can move the view (pan and zoom). The parameters are updated continuously. Once you have changed the view, you can save the parameters with one click. This makes working with a panorama easier, because you don’t have to enter all three parameters separately every time.

Info

To set the view again, click into the preview and not on a hotspot! The view overlay cannot be hidden.

Overlay »Debug mode«

This overlay can be shown and hidden. It shows important parameters of the panorama and helps with troubleshooting.

Overlay »Hotspots«

On the right edge of the preview there is an overlay with all hotspots of the panorama.

Info

Unfortunately, not all hotspot types have the correct icons yet.

The following icons are available:

Icon	Meaning
	Error This hotspot is faulty or cannot be jumped to (not a GoTo hotspot).
	GoTo Click this hotspot to jump to it. There is a target panorama available at the marked position.
	Image This is an image hotspot. A photo or hover information is shown at this position.