ImgView
Draw photo measurements, image residuals, and missing measurements
This program displays image measurements, image residuals, point IDs, numbers of photo rays, and skipped or missing photo measurements. It can display a single image, a group of images, or all images in one frame.
Getting started
After starting ImgView, a file-selection window opens.
To view image residuals, select the following files:
- ITERA file containing BINGO adjustment results, such as photo orientations, point coordinates, and camera data. The default filename is
itera.dat. When this file is selected, the program can identify and display missing measurements for each image. - Image-residual file containing image-measurement residuals and skipped points. The default filename is
imresi.dat.
To view only image coordinates, select this file:
- Image coordinate file containing the image measurements. The default filename is
image.dat.
While the file-selection window is open, changing the project directory in BINGO Manager affects this application.
To reset all filenames, select Settings > Set File Defaults.
To reset all graphics parameters, select Settings > Set Drawing Defaults.
Click Draw to open the graphics window and close the file-selection window. To return to the file-selection window, select File > File Selection.
After you click Draw, the program checks whether all selected files exist. If they do, the program reads them as follows:
- From the ITERA file: all adjusted
ORIT,ORIA,CORD, andCAPAdata. - From the image-residual file: all residuals and information about skipped points and control points.
Alternatively:
- From the image coordinate file: all photo data. The program finds the points closest to the four image corners and uses them to create true footprints.
If a file is missing or an error occurs while reading it, the ImgView window remains open so that you can select other files. Click Draw to create the graphics window. The graphics display parameters are explained below.
Only one of the two windows—the file-selection window or the graphics window—can be open. To open a second graphics window, start another ImgView task.
The files itera.dat and imresi.dat are created by BINGO. Enable Write to ITERA file to create or update these files.
Properties of the graphics window
Adjust the settings in the graphics window as needed. Drag any edge or corner to resize the window.
To specify the drawing size, select Settings > Set Drawing Size and enter the preferred value.
For the graphical presentation, select one image number from the list, select several individual images using Ctrl, select a group using Shift, or select all images using All img.
When you move the cursor over an image point, its ID appears in the lower-left corner of the window.
Right-click a point to copy its photo and point IDs to the BINGO Manager message window. You can then select them with the mouse and press Ctrl+C to copy them to the clipboard.
If only the image coordinate file has been selected, the check boxes for vectors, missing points and number of rays will be unavailable.
The Vector scale control changes the lengths of the residual vectors. It uses a logarithmic scale.
To view several images at once, start multiple instances of ImgView and arrange them on the screen—for example, with three images from one flight line below one another. Select the first image number in the first window, the second image number in the second window, and so on. Enable All, then click +1 or -1 to make every window display the next or previous image. Rotating the images may make points easier to recognize across the sequence.
Settings are saved to ImgView.ini in the \Bingo\bin\ directory.
Press Esc to close the graphics window.
Save and print graphics
The GIF File button opens a window for copying the current screen graphics to the clipboard or saving them to a file in the project directory. The output format can be GIF (Graphics Interchange Format) or PNG (Portable Network Graphics). GIF files have the smallest size; PNG files are larger but provide better colors. The selected format is saved in the INI file.
Without opening this window, press Ctrl+C to copy the graphics to the clipboard or Ctrl+S to save them to a file.
If the last two characters of the filename are digits (for example, ImgView_Graph_00), the number is incremented automatically. This prevents existing files from being overwritten. Other filenames have no protection against overwriting.
Press Ctrl+V to paste the graphics from the clipboard into Windows applications such as Microsoft Photo Editor, Word, PowerPoint, Outlook, Paint, Adobe Photoshop, or IrfanView.
The free IrfanView application provides a convenient printing interface for creating paper copies of the drawings. Printouts from large screens provide acceptable resolution up to DIN A2.
Symbols and colors
The background color can be blue or white. Select Bold to draw bold lines and enlarged symbols.
Measured control points are displayed as triangles and all other points as blue circles. Vector color depends on the number of asterisks for each observation, as follows:
Color explanation for symbols, point numbers, and residual vectors
| Data type | Blue background color | White background color |
|---|---|---|
| Point symbols and numbers | ||
| Control and check points | Magenta | Magenta |
| Other measured points | White | Blue |
| Skipped points | Red | Red |
| Missing points | Mint | Mint |
| Residual vectors | ||
| Data with 0, 1, or 2 asterisks | White | Blue |
| Data with 3 asterisks | Magenta | Magenta |
| Data with 4 asterisks | Red | Red |
| Skipped data | Gray | Gray |
Missing points should be visible within the photo frame but have not been measured. They are displayed in mint.
The window can be resized and moved. When ImgView is started again, it restores the position, size, and settings used when the previous window was closed.
Press Esc to close the graphics window.
Output to pipe
When ImgView starts, it checks for an open pipe named picked_points. If the pipe is open, photo and point IDs are sent to it instead of the BINGO Manager message window. BingoATM opens this pipe and can immediately display the related point.
REPLO, ImgView, GpsView, and 3dView can send data to the pipe. The pipe must be open before the graphics program starts.
The pipe test program ReadPipe_picked_points.exe is available in \Bingo\bin\. Only one program can connect to the pipe at a time. A second graphics task waits for access to the pipe and does not open the file-selection window.