PanGazer logo PanGazer – getting started


Download PanGazer

Getting started

General settings

Setting North

Saving views

Saving images

Sharing images

Image geography

Show image location



Aspect ratio

Making panoramic images

Keyboard shortcuts

Command line options

The gnomonic projection


Working with images

When you first start PanGazer a ‘starter’ panorama should be displayed; if you see a blank view, try one of the following options.

To show a different image, you can:

  • 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
  • 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)
  • press the ‘PageDown’ or ‘PageUp’ key to show the next or prior image in the same directory as the current image, or press ‘Ctrl-PageDown’ or ‘Ctrl-PageUp’ to show the last or first image in that directory; the order in which images are shown is determined by Windows
  • select the Image → Open image in new window menu item to open an image without replacing the current image.

PanGazer will automatically detect if an image is a 360 or spherical panorama 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 right-click pop-up menu. In all cases the image will be centred and adjusted (and zoomed as necessary) to fill the window.

To save an image (e.g., after changing its geographical data) either select the Image → Save image as ... menu item or select the Image → Resize image and save as ... menu item; the latter adds a dialog that lets you change the size of the image before saving.  Saving will preserve metadata as possible, and also, if the image is spherical, will also save the current view parameters (bearing, tilt, etc.) in the saved file.

You can also save a part-spherical panorama (such as the starter image) as a full-sphere panorama for use in social media applications, etc. For details, see the Saving images page and the Sharing images page.  Alternatively you can fill a part-spherical panorama to a full-sphere without saving it, to see how it looks, using the Image → Extend image to full sphere menu selection.

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. Setting North is especially useful for spherical images. If bearing or tilt are known, compass points and/or 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.

Viewing images

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 (the magnification of the image):

  • 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; zooming out gives an increasingly wide-angle view but will also distort the view, especially in the corners
  • select Zoom to 100% ratio from the View or pop-up menu; this will set the zoom so that a pel (pixel) of the image is sized to match a pel in the window (if possible; if the image is smaller than the window then it will be enlarged to fill the window).

To overlay compass points on a view to give a sense of direction, select Set North from the pop-up menu or use the Image Geography dialog – see the Setting North page for more details; for some images North might be set automatically.  Similarly, you can overlay tilt angles on a view once Set horizon has been used (or if the image is spherical).  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.

You can toggle the overlays on and off (along with any status information shown) with the space bar.

To create an image from the current view, select the Snapshot current view ... menu item from the View menu or from the pop-up menu (or press the ‘s’ key). 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.

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 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.

To reset and centre the displayed image, select the Reset viewpoint menu item from the View menu or from the pop-up menu, or use the ‘r’ key. This will position the centre of the image in the centre of the window at default zoom, or if the image is spherical and has a saved initial viewpoint, it will reset the viewpoint to that. 

For spherical images you can also select View → Set viewpoint to nadir (or press ‘n’) to centre the image at the nadir (−90°) view, select View → Set viewpoint to horizon (or press ‘h’) for a ‘level’ horizon (0°) view, or select View → Set viewpoint to zenith (or press ‘z’) for the zenith (+90°) view, as possible.

Windows and window options

A PanGazer 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 an 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 to the image aspect ratio by selecting the Window → Fit window to aspect ratio menu item (or press ‘Ctrl-f’); 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 window to aspect ratio is also available on the pop-up menu.

You can also fit the image to the window (that is, make the image fill the height or width of the window, if possible) using Window → Fit height to window (‘Ctrl-h’) or Window → Fit width to window (‘Ctrl-w’), respectively. These are also available on the pop-up menu.

To set a specific window aspect ratio, select Window → Set window aspect ratio (or press ‘a’); for more details, see the Aspect Ratio page.

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 ‘toggle’ a view window between Full screen and the view in a window by simply pressing the Esc (Escape) key. As usual, 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).

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 (without using the Internet) 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 Copyright © Mike Cowlishaw, 2014–2020, 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 2020-11-19 by mfc.