PanGazer logo PanGazer – getting started


Download PanGazer

Getting started

General settings

Saving views

Show location

Image geography



Making panoramic images

Command line options

The gnomonic projection


Working with images

PanGazer should first start with a default panorama displayed; if not, select the Image → Open image menu item (or press the ‘p’ or Ctrl-O key). This will open a dialog which will allow you to choose a panorama or other image file.

To save an image (e.g., after changing its geographical data) select the Image → Save image as ... menu item.

If the image is geotagged you can show its location on a map using Show location on satellite map (from the Image main menu or the right-click pop-up menu). From the Image menu you can also show the location on a regular map, show it using an application such as MapGazer or Google Earth, or save it. For details, see the Show location page.

To set or edit image geography (location, elevation, bearing, and tilt), select the Image → Image geography menu item (or press the ‘g’ key); see the Image geography page for details. If bearing or tilt are known, compass points and tilt angles can be overlaid on the image (see Overlays).

To make your own panorama image, see the Making panoramic images page for a couple of suggestions; there are also many other options.

Working with views

When an image is opened it is shown as a view of the image in a window.

To change the viewpoint (when the image does not fill the window):

  • left click on the image (the cursor will change to a ‘hand’) and drag the image (dragging also works if you have a touch screen)
  • use the keyboard arrow keys.

To change the zoom from ×1 (default magnification):

  • move the cursor over the image and spin the mouse scroll wheel forward (to zoom in) or back (to zoom out); this will keep the point under the cursor at the same position in the window
  • if you have a touch screen, the ‘pinch’ and ‘expand’ gestures should also zoom in or zoom out, centred on a point between your fingertips
  • right-click on the image and choose Zoom in or Zoom out on the pop-up menu, which will keep the clicked-on point static while zooming
  • use the ‘i’ or ‘o’ keys to zoom in or out while keeping the centre of the view fixed, or use the View → Zoom in or View → Zoom out menu items, which have the same effect.

To overlay compass points on a view to give a sense of direction, select Set North from the pop-up menu. Similarly, you can overlay tilt angles on a view once Set horizon has been used.  See the Overlays page for details of both these overlays. Once you have set North or the horizon for an image, you may wish to use Image → Save image as ... (or press the Ctrl-S key) to save the image so that next time it is loaded you will not need to re-do the settings.

To save the current view, select the Save current view as... menu item from the View menu or from the pop-up menu. This will display a save dialog which lets you select the folder and enter the name for the new image. Unlike a screenshot, the new image will include the location, tilt, bearing, and focal length of the view, if available, as well as other data. For more details, see Saving views.

To enhance the view of the image (change brightness, contrast, etc.), select the Enhance view menu item from the View or pop-up menus, or press the ‘e’ key; this will open the enhancements dialog. For more details, see the Enhancements page.

Saved views do not include overlaid status information or overlays (they will be shown as appropriate if the saved image is opened later using PanGazer), and are saved in JPEG format.  After the image is saved it will be opened (using the current viewer for JPEG images) so you can check it, save it in a different format, print it, etc.

To view a different image, drag one or more new images from File Explorer to a PanGazer window or icon (each new image will be opened in a new view window). Alternatively, select the Image → Open image menu item (or press the ‘p’ or Ctrl-O key); this will open a dialog which will allow you to choose a panorama or other image file to be shown instead of the one currently in view. Similarly, select the Image → Open image in new window menu item to open an image while keeping the current image view.

PanGazer will automatically detect if an image is a 360 panorama or is (hemi)spherical and will display it appropriately; you can override these assumptions by unchecking the View image as 360 or View image spherically menu items from the View menu or from the pop-up menu. In all cases the image will be centred and adjusted (and zoomed as necessary) to fill the window.

PanGazer can load many types of images (JPEG, PNG, GIF, BMP, TIFF, etc.); however, in general, JPEG images are faster and often have metadata such as the image location.

To centre the displayed image, select the Centre viewpoint menu item from the View menu or from the pop-up menu, or use the ‘c’ key. This will position the centre of the image in the centre of the window at zoom ×1.

Windows and window options

A image view is a window on the screen which displays an image. You can have more than one window open and each window can display a different (or the same) image with a independent viewpoint and/or zoom.

To add a new view window, select the View → Open new view or Window → Open new window menu item, or press the ‘v’ key. This shows the same view initially; in the new window you can then change the viewpoint or image (as described above). You can add multiple windows and close (delete) them in any order; PanGazer will keep running until you close all open windows.

If an image is not a 360 panorama, you can fit the window shape to match that of the image by selecting the Window → Fit aspect ratio menu item; PanGazer will attempt to change the window shape (keeping the same window area and staying within the bounds of the screen) to match the aspect ratio of the image. Fit aspect ratio is also available on the pop-up menu.

The window options (also under the Window menu item) let you change the appearance of the window. For example, to increase the amount of the window used for the image you can choose not to show the menu bar and/or title bar (the menu bar can be turned back on by right-clicking on the image to get a pop-up menu).

You can also maximize or minimize the window from the menu, or request that it be made full-screen. When full-screen, only the image is shown (to then restore it to a normal window press the Esc (Escape) key or right-click on the image for the pop-up menu and choose Restore). Similarly, you can choose Full Screen from that pop-up menu at other times, or just press the ‘Esc’ key (that is, the ‘Esc’ key toggles between full-screen and a window).

Settings, help, etc.

The Settings main menu lets you change settings that apply to all windows, including the status information to be displayed, compass point and tilt overlays, measurement units, coordinate formats, and the options for using a console window.  For details, please see the General settings page.

The Help main menu item lets you view these help pages locally or browse the PanGazer web pages (these are the same as the local pages if you are using the latest release).  In addition, the About PanGazer menu item confirms the version, origin, and .exe type of the application.

PanGazer may be started from the command line, or a script, with options to load one or more specified image files, etc.  It can also be started by clicking on an image type that has been associated with PanGazer. For more details, please see the Command line help page.

PanGazer and these web pages were written by Mike Cowlishaw; Please send me any corrections, suggestions, etc.
All content © Mike Cowlishaw, 2014–2018, except where marked otherwise. All rights reserved. The pages here, and the PanGazer program, are for non-commercial use only.
Privacy policy: the Speleotrove website records no personal information and sets no ‘cookies’. However, statistics, etc. might be recorded by the web hosting service.

This page was last updated on 2018-12-12 by mfc.