|PanGazer – getting started|
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) 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 as a full-sphere panorama for use in social media
applications, etc. For details, see the Saving images page and the Sharing images page.
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 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):
To change the zoom (the magnification of the image):
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.
To make 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 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 default zoom. For spherical images you can also select View → Set viewpoint to nadir (or press ‘n’) to centre the image at the nadir (−90°) view, or select View → Set viewpoint to zenith (or press ‘z’) for the zenith (+90°) view, as possible.
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 (or is not being viewed as 360°), you can fit the window aspect ratio to match that of the source 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.
To set a specific window aspect ratio, select Window → Set 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 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 Copyright © Mike Cowlishaw,
2014–2020, except where marked otherwise. All rights reserved.
The pages here, and the PanGazer program, are for non-commercial
This page was last updated on 2020-06-09 by mfc.