PanGazer logo PanGazer – general settings

Introduction

Download PanGazer


Getting started

General settings

Setting North

Saving views

Saving images

Sharing images

Image geography

Show image location

Overlays

Spherical fills

Enhancements

Aspect ratio


Making panoramic images

The gnomonic projection

Coordinate formats

Keyboard shortcuts

Command line options

Saved metadata

Thanks

The Settings menu lets you change settings that apply to all windows.  These are:

Hide all status and overlays – this overrides the individual Status and Overlays settings described below for all views.  If checked neither status nor overlays are displayed in any view.  Use the Space Bar or pop-up menu to temporarily toggle between ‘hide all’ and ‘show selected items and overlays’ for the current view.  Changing this setting resets all views to match the new setting.

Status display – lets you customize the status shown in the window (‘dynamic’ status, which might alter as you change the view or move the mouse, is shown at top right and ‘static’ status, referring to the loaded image, is shown at bottom right); scroll down to see a sample screenshot with both kinds of status.

Note that the status information is only shown if there is room for it in the current window or image display (that is, the status information is not shown if it would be wider than half the width available or would be taller than half the height available).

The dynamic status options refer to the current view; only the first three are shown by default.  The options are:

  • Show view coverage – this indicates the extent of the view.  The first number shown is the current pel (pixel) ratio; for example, if the pel ratio is 200% then each pel in the original image has been extrapolated to 2×2 pels on-screen.

    If the image is 360 or has a known 35mm-equivalent focal length then the equivalent focal length of the view is shown next (e.g., if ‘100mm equivalent’ is shown then the view appears as though taken with a 100mm lens on a 35mm film or full-frame digital camera).

    The final part of the view coverage line comprises the apparent angles of view in X and Y (horizontal and vertical) of the displayed image.

  • Show view yaw and pitch – this shows the yaw (left-to-right angle from the image centre) and pitch (bottom-to-top angle from the image centre) of the current view; that is, where the ‘camera’ is pointing relative to the centre of the image.

    If the bearing of the centre of the image is known (see the Setting North page) then the compass point and bearing of the view is shown instead of the yaw, and similarly if the position of the horizon is known (as in a spherical panorama or an image created from one) then the pitch is shown as the tilt from the horizon (positive is up).

  • Show cursor yaw and pitch – if the mouse position (cursor arrow) is over the displayed image this shows its yaw (left-to-right angle from the image centre) and pitch (bottom-to-top angle from the image centre).

    If the bearing of the centre of the image is known (see the Setting North page) then the compass point and bearing of the mouse position is shown instead of the yaw, and similarly if the position of the horizon is known (as in a spherical panorama or an image created from one) then the pitch is shown as the tilt from the horizon (positive is up).

  • Show enhancement values – this shows values of all the view enhancements if any enhancement is in use (is non-zero).

  • Show performance statistics – this shows the amount of memory explicitly allocated by PanGazer and also (if 1 ms or more) the time taken (in seconds) to render the last image along with the corresponding frame rate (frames per second).

The static status options describe the source image and are only shown if the requested information is available, that is, is in the Exchangeable image file (Exif) or other image metadata. The default for all these status settings is to show the status. The options are:

  • Show exposure settings – shows the settings used to capture the image (shutter speed, aperture, ISO sensitivity, and EV [Exposure Value] bias if available and non-zero), and also indicates if the flash fired.

  • Show lens data – shows the lens focal length (if available). Also, if the 35mm equivalent is available this shows that value together with the diagonal angle of view of the image and the visual magnification factor.  The latter is the human angle of attention (assumed to be 54) divided by the diagonal angle of view of the lens.

  • Show camera geolocation and attitude – shows the latitude, longitude, and GPS altitude of the device used when the image was captured, and the bearing and tilt of the centre of the image (camera attitude).

  • Show image time and date – shows the original time and date of image capture (usually in local time) and also the UTC timestamp (if known).

  • Show image size and angles – shows the X and Y dimensions of the image in pels, its horizontal and vertical Angles Of View, and its file size.

  • Show camera data – shows the lens crop factor (focal length multiplier), if it can be calculated, and the camera make and model.

  • Show image description – shows the image description, if any (note that the window’s title bar shows the image’s file name, with underscores treated as blanks).

  • Show image Copyright – shows the image’s Copyright text.

Overlays – lets you turn on or off information that augments the view (see the Overlays page for details):

  • Show compass points – if the direction of view is known (that is, North has been set – see the Setting North page) then compass points (N, E, SW, etc.) will be overlaid at the top of the view.  This setting is on by default.

  • Show North line – if the direction of view is known and the North (N) compass point is shown at the top of the view then the North line is overlaid on the view.  All points on the line are due North of the camera.  This setting is off by default but will be set on if you Set North to simplify checking.

  • Show tilt angles – if the tilt of the view is known the tilt angles will be shown overlaid at the left edge of the view.  This setting is off by default.

  • Show grid – overlays a grid on spherical images at 15° intervals.  This setting is off by default.

If the Image Geography dialog is open then all three overlays will be shown (if valid values are available/have been applied), independent of these settings.  In addition, Show compass points and Show North line will be set if you use the Set North pop-up menu option and similarly Show tilt angles will be set if you choose Set horizon for a ‘flat’ image.

Measurement units – selects the units used when elevations are displayed.  Here you can choose any or all of Metric, Statute (customary), or Nautical units.  By default, Metric will be used.

This sub-menu self-orders; when you uncheck an item it is moved to the bottom of the list and when you check an item it is moved above any unchecked items.  This lets you control the order in which units are displayed (also, the top item is always selected so elevations can always have units).

Statute and Nautical units both use feet for elevations; both units are offered to keep the selection consistent with MapGazer.

Coordinate formats – changes the format used for displaying Latitude and Longitude; the formats available are:

  • degrees°minutes′seconds″ (this is the default)
  • degrees°minutes
  • decimal degrees with 5 or 6 fractional digits
  • UTM (Universal Tranverse Mercator).

Please see the Coordinate formats page for for details and examples.

Initial load settings – these settings change the defaults when a new image is loaded:
Currently there is only one setting:

Initial zoom on load:
This sets the preferred zoom when a new image is loaded:
  • Minimum zoom – sets the zoom to the minimum available.
  • Default zoom – sets the zoom to the default for the image, which will be derived from image metadata if possible.
  • 100% zoom – sets the zoom so that the pel (pixel) ratio will be 100% (that is, each pel in the original image is represented by one pel on-screen).
  • Maximum zoom – sets the zoom so that the pel (pixel) ratio will be 200%.

For more details, see the zoom level page.

Note that the initial zoom is only used when an image is first loaded; if you close PanGazer then reopen it without specifying an image then the view (including the zoom) last seen will be presented.

Note also that the requested initial zoom might not be possible (especially for low-resolution or small images). In this case the best zoom match available will be used.

Diagnostics – changes the console and diagnostic settings:

  • Show console – displays a console window; this is primarily used for viewing error messages and diagnostics – if some action does not work as expected it may be helpful to show the console and then check it for messages on retrying the action.

  • Show extra diagnostics – displays more detailed diagnostics on the console.

  • Show received messages – displays each Windows message as it is received by PanGazer.  Note that this setting is quite verbose and will slow the normal operation of PanGazer.

  • Log extra diagnostics – writes progress reports to the file ‘PanGazer-log.txt’ in the PanGazer log directory (see below).  Any existing log file is erased when logging is first started by using this setting, Log received messages, or a command line option that starts logging.

  • Log received messages – writes Windows message reports to the file ‘PanGazer-log.txt’ in the PanGazer log directory (see below). Any existing log file is erased when logging is first started by using this setting, Log extra diagnostics, or a command line option that starts logging.
    Note that this setting will slow the normal operation of PanGazer.

  • Open log directory – open the directory used to save logs and persistent data.  This will either be the folder containing PanGazer.exe if that folder is writable, or otherwise the Windows default User folder.  The location of the latter depends on the version of Windows in use, so this option opens that folder as a convenience (it is not a ‘setting’).

All the above settings (except log-related) are saved in a file (PanGazer.ini) in the log directory (see above, under Open log directory). Settings saved also include details of the image and viewpoint last viewed, the current enhancement values, the last-loaded image file folder, and the screen position of the last-viewed window, etc. Settings are only saved for the last-viewed window (view).


Screenshot showing some status displays

Screenshot showing some status displays

PanGazer and these web pages were written by Mike Cowlishaw; Please send me any corrections, suggestions, etc.
All content Copyright © Mike Cowlishaw, 2014–2022, 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 2022-08-31 by mfc.