Customizing the panorama style

In order to personalise the style of your panoramas, you can edit the CSS file located inside the plugin's css folder.

Creating panoramic images

I will not explain here how to create panoramic images as there are a number of tutorials available on the net. However, you will have to make note of a few numbers when you create your image: the position of the horizon in the image (number of pixels from the top of the image), the horizontal field of view (an angle in degrees) and the image's dimensions in pixels.

Inserting panoramas inside your posts

To insert a panorama in your post or page, use the following special HTML-style tag:

[ptviewer parameters]The title of your panorama[/ptviewer]
[ptviewer parameters /]

The parameters you must specify are:

  • imagewidth (required): the width of the image file you want to visualise.
  • imageheight (required): the height of the image file you want to visualise.
  • horizon (required): the horizon position in the image relative to the top of the image. You can find this out using your favorite image edition software.
  • hfov (required): the horizontal field of view in degrees covered by the image. You should write it down when you assemble your images using your panorama stiching software. For instance, a full panorama will have an horizontal field of view of 360 degrees.

The parameters you can additionally specify are:

  • image (optional): the image you want to visualise. This is the path relative to the default image path you specify in the previous options.
  • href (optional): the image you want to visualise. This is the full URL of the image. If the image parameter is specified, this parameter will be ignored.
  • width (optional): the width of the applet as it will appear in your post.
    If not specified, it uses the value specified in the options above.
  • height (optional): the height of the applet as it will appear in your post.
    If not specified, it uses the value specified in the options above.
  • cssclass (optional): the CSS class to apply to the div container around the applet.
    If not specified, it uses the value specified in the options above.
  • debug (optional): if set to a value other than 0, some additional debug information will be outputed below the panorama.