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. Changing
this setting resets all views to match the new setting.
Use the Space Bar or pop-up menu to temporarily toggle between ‘hide
all’ and ‘show selected items and overlays’ for the current view.
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
- 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
- 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
- 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
- Show image time and date – shows the original time and date
of image capture (usually in local time) and also the UTC timestamp
- 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 and images):
- Show compass points – if the bearing of the image is known
setting North), this adds points of the compass across the top
of the view to indicate the direction of view.
- Show tilt angles – if the horizon of the image is known, this
adds tilt angle values at the left of the view.
- Show North line – if the bearing of the image is known (see
setting North) and North is in view, the North point (N)
is shown along with the line along which all points are due North.
This setting is off by default.
- Show Horizon line – if the horizon of the image is known and
is in view, this adds a ‘zero tilt’ line; this will always be horizontal.
This setting is off by default.
- Show grid – overlays a grid at 15° intervals on spherical
images; this will be aligned to the horizon and also to North (if
known, otherwise aligned with the centre of the image). This setting
is off by default and does not apply if the image is being viewed
as a flat rectangle.
The Show compass points and Show North line overlays will
be set if you use the Set North pop-up menu option, and similarly
Show tilt angles and Show horizon line 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)
- decimal degrees with 5 or 6 fractional digits
- UTM (Universal Tranverse Mercator).
Please see the Coordinate formats page for for details and examples.
Image load and save – these settings change defaults
when an image is loaded or saved:
- Always prompt with last-used folder:
If this is checked (the default) then folder selection always starts
with the folder last used for a load or save. If not checked then
the load and save selections will start with the folder last used
for a load or save, respectively.
- Save 360° images rotated to view
If this is checked (the default) then when a 360° image (whether
spherical or not) is saved its image centre (left-to-right) will
be rotated (yawed) to match the view at the time of the save. This
helps when viewing the image with other viewers and also improves
the initial view or performance of some viewing platforms.
- 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.
- Always apply ICC sRGB profile on load:
If a JPEG image being loaded has an ICC (International Color Consortium)
profile then the colours in that image will usually be adjusted,
using Windows APIs, according to the ICC profile.
However, some applications add an ICC constant sRGB profile to
images that have already had the sRGB profile applied, resulting
in over-saturated results (especially in greens); PanGazer, therefore,
ignores these ICC sRGB profiles by default. Checking this setting
indicates that PanGazer must always apply sRGB profiles.
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