|
Image Windows
An Image Window is the type of view window
Mira uses to display 2-dimensional images. The Image Window also
provides numerous features through optional
toolbars and
docking panes. Several of these extra command bars
are shown in the Image Window below. The largest optional component
of the Image Window is the
Image Bar that appears between the window caption and
the displayed image. This
docking pane provides quick access to image
coordinates and basic image information. It may be hidden or
tabified to conserve screen space. Use the
Docking Panes Toolbar button to save its
current state for future Image Windows.
See the topic
FITS Format Overview to learn how Mira handles
FITS Format data, particularly a FITS Extension file containing
multiple Header-Data Units or an image with multiple "planes"
(NAXIS keyword > 2).
The figure below shows a typical image window with
the
Image Bar at top and
Animation Bar at bottom. A FITS Extension file
containing 8 images represents 8 of the 9 images opened as an
Image Set. with the "Flame"
Palette.
Setting Window Properties and Image Properties
Several properties can be defined for the Image
Window and images opened into it, including the
window properties,
image cursor properties,
transfer
function properties, and others. Many of these can be changed
the Image Window is opened. A few other properties, such as
the default image zoom, cannot be set
after the window is opened. See the Related
Topics at the bottom of this page.
Script Interface
The Mira Pro x64 Script language provides an
extensive collection of script classes and functions that work with
Image Windows. There are two ways a script can be attached
to Image Window data:
-
Scripts may be executed "globally" and then
attached to an Image Window, or
-
Scripts may be executed directly from the
Image Window using the
Script Manager Pane or the Execute Script menu command.
When a direct script is executed, it is
automatically provided both a CImageView script object attached to the Image
Window and a CImage script object
attached to the currently displayed image. Scripts executed
globally or from outside an Image Window, must use a script
command to attach the target window and their data.
-
The installed folder <Documents>/Mira Pro x64
Data/Scripts/Samples/ImageView Execution contains examples
to be run directly from an Image Window using the
Script Manager Pane or using the Execute Script command in the popup context
menu.
-
The installed folder <Documents>/Mira Pro x64
Data/Scripts/Samples/Images contains examples to be run from
the top-level
Script Editor Window.
When a script is executed directly from an
Image Window, it must connect to the current window and
data. To do this, the script calls attach_imageviewinternal() which returns script
objects attached to the current image and current image window, as
follows:
I, V = attach_imageviewinternal()
where the two returned objects are as follows:
I is a CImage script object attached to the current
image.
V is a CImageView script object attached to the current
image window.
When you create a new script directly from the
Script Manager Pane in an Image Window, Mira
automatically inserts the following line:
ParentImage, ParentImageView =
attach_imageviewinternal()
In some of the sample scripts designed for direct
execution from an Image Window, you may see two variables:
PARENTIMAGE and PARENTIMAGEVIEW. This
means Mira already processed the attach_imageviewinternal function. In your own
scripts, call attach_imageviewinternal().
|
TIP
|
For organizational purposes, it is advantageous to
keep direct Image Window scripts in folders with easily
recognizeable names, like Images,
ImageView, or ImageView_Execute.
|
Shortcuts and Accelerator Keys
The Image Window contains numerous keyboard
shortcuts and accelerator keys to perform common commands for
measurements, plots, and other operations on the image or
Image Set. These are several groups of keystroke
commands as described below.
In addition, the
Image Keys Pane describes all keystroke commands for
the Image Window.
Window
Accelerators using Ctrl and Shift Modifiers
|
Image Window Accelerators
|
|
Ctrl+A
|
Toggles the
Image Cursor between Cursor mode and Roam mode. Also
the the top/left button on the
Image Cursor Toolbar.
|
|
Ctrl+C
|
Copy the current image to the Windows
clipboard.
|
|
Ctrl+Shift+C
|
Copy the marker set (apertures, lines, etc.) from the
current image to the Windows clipboard.
|
|
Ctrl+D
|
Duplicate the current image to a new Image
Window.
|
|
Ctrl+Shift+D
|
Duplicate the
Image Set to a new Image Window.
|
|
Ctrl+E
|
Execute the
Edit Pixel Values command to view a table of pixels
as text values.
|
|
Ctrl+F
|
Save the image set to a new folder.
|
|
Ctrl+G
|
Open the
Go To Coordinates window for transferring the cursor
coordinates between images.
|
|
Ctrl+I
|
Open the
Image Set Properties toolbar for examining or
reordering the image set by image properties.
|
|
Ctrl+L
|
Open the vertical
Palette Pane.
|
|
Ctrl+P
|
Print the image.
|
|
Ctrl+Q
|
Show or hide the
Image Set Toolbar (Image Set Pane)
|
|
Ctrl+S
|
Execute the File >
Save command.
|
|
Ctrl+T
|
Open the horizontal
Transfer Function Pane dialog.
|
|
Ctrl+V
|
Paste the current image on the Windows clipboard to
the current Image Window. An image set is created if the current
window contains only one image. This command works only in
conjunction with the
Copy (Ctrl+C) command in Mira.
|
|
Ctrl+Shift+V
|
Paste the marker set from the Window clipboard into
the window.
|
|
Ctrl+W
|
Copy the image area as a bitmap to the Windows
clipboard. From there it may be pasted into other software, such as
MS Word. The copied area includes the displayed image and all
markers.
|
|
Ctrl+X
|
Cut the region outlined by the
image cursor by executing the
Crop at Cursor command.
|
|
Ctrl+Z
|
Execute the
Undo command for the image or image set, as
controlled by the Process
Image Set option.
|
|
|
Single Keystroke Commands
The
Image Window provides numerous keystrokes for
creating plots, making measurements, and performing other commands.
These are described in
Image Window Keystroke Commands. Most of these
commands work with the
Image Cursor (not the window pointer) and are not
case sensitive. These single keystrokes do not use the
Ctrl, Alt, and Shift
modifiers. The Image Window is activated for keystroke input when
it is top-most and has the keyboard focus.
Keystroke Commands for the Image Cursor and Image Sets
Several additional keystrokes that are not command
accelerators are recognized by image windows. These require the
window to have the keyboard focus.
|
[Shift] + Mouse
click
|
Move the image cursor to the target point,
regardless of the current
command mode.
|
|
[Tab]
|
Step forward to the next member of the
image set.
|
|
[Shift] + [Tab]
|
Step backward to the previous member of the
image set.
|
|
Arrow Keys
|
Move the image cursor precisely on the image,
regardless of the current
command mode. See
Image Window Keystroke Commands.
|
Image Size Limits
Practically speaking, Mira Pro x64 has no realistic
limit to the maximum size of an image or image set. The dimensional
limits are 2 billion pixels on each axis. In the Mira Pro Script
Language, class methods that work with image data have the same
limits. The screenshot below shows a scanned photographic plate of
Schmidt telescope objective prism spectra. This image file is just
under 4 GB in size and required 3 seconds to open and display from
an an SSD drive. A Mira user has reported processing 26GB images.
Note that the 32-bit version of Mira Pro x64 (that is, Mira Pro
x32) has the standard 32-bit limit of 4GB maximum image
size.
Related Topics
Image Cursor
Image Keys Pane
Image Palettes
Transfer Functions
Image Bar
Animation Bar
Docking Panes
Image Sets
Image Coordinates
Image Window Properties
Select Image Properties
Select Comment Properties
Image Window Keystroke Commands
Image Keys Pane
FITS Format Overview
Script Manager Pane
Mira Pro x64 8.83 User's Guide, Copyright Ⓒ 2026 Mirametrics, Inc.
All Rights Reserved.
|