|
Script Manager
The Script Manager provides file management
for scripts and a means for executing scripts. These tasks are also
available from
Script Editor window toolbar and drop-down menu of
commands for script type documents.
Note: The Script Manager is a legacy feature
that is more complicated to use and less flexible than using the
Script Editor Window.
The Script Manager is useful for organizing
your scripts into a single location. Using the Script Editor to
open a .lua file or create a new one
loads its menu at the top of the Mira frame. Using this method you
can work with scripts saved in any folder on the computer. The
Script Manager, however, uses the Documents/Scripts tree of folders that were created
when Mira was installed. The active script is the one selected into
the text box above the list. .
The Script manager is opened using the Script Manager command in the drop menu below the
 button on
the Main Toolbar. The button itself a script when an Image or Plot
window is top-most. The down arrow access other script
functions.
Script Groups
If your scripts refer to other script files, Mira
provides a shortcut to long path names by keeping anything used by
the Script Manager inside the
folder named
C:\Documents and Settings\All Users\Application
Data\Mirametrics\Mira Pro 8 x64\Scripts.
A script can access files inside this folder by
calling the script Include() method with
only a subfolder and a file name. The folders below the level of
...\Mira Pro 8
x64\Scripts are as follows:
Mira can load script files from these 3 subfolders
using a function call like
Include("Classes\\CImage.lua").
This works for scripts located in any particular folder, since Mira
appends the argument of theInclude() method to the
path to the [folder]\Scripts
folder, where folder is C:\Documents
and Settings\All Users\Application Data\Mirametrics\Mira Pro 8
x64\Scripts (see
Mira's Special Folders). Keeping your actual
scripts inside [folder]\Scripts is
simply a way to organize them and be able to access them from the
Script Manager.
In general, you can open, use, and save scripts to
any folder on your computer and not even use the Script Manager.
However, the script Include() function always refers
to C:\Documents and Settings\All
Users\Application Data\Mirametrics\Mira Pro 8
x64\Scripts.
|
Tip
|
Notice that the Include() statement
above uses a double backslash inside the quoted string. In a
literal string between quotes "", Windows assumes that
a single backslash precedes a special character, such as a newline
\n or a tab \t. In all of your scripts,
you need to use a double backslash \\ in literal
strings when you want the string interpreted as using a single
backslash character \.
|
The special folders used by scripts are described
in the following table.
|
Script Groups
|
|
Scripts
|
This group contains the script files that you
execute. Depending upon the script content, it may be global or it
may operate on the view class that is active when the Script
Manager is open. For example, if an Image Window is on top when you
open the Script Manager, then executing a class script (one that
uses a Mira class as input), would use that image window and have
access to the images displayed in it.
|
|
Include
|
This group contains "helper" script files that
include functions or definitions used by other script files. These
files cannot be executed on their own but must be inserted into
scripts using the Include function. For example, LoadImages.lua is an include script; it does
nothing by itself but, when included into a script, the function
call V = LoadImages(n) opens and displays up to n
images from files and returns them to the script as a reference to
a newCImageView object V.
|
|
Classes
|
This group contains Lua classes that form an
object-oriented interface between Mira and the script engine.
|
|
Samples
|
This group contains the sample scripts that come
with the Mira Pro Script module.
|
|
|
|
Tip
|
Script files may be located anywhere in the file
system. However, the Script Manager can access them only if they
are located in one of these 4 folders.
|
Script Manager Buttons
The buttons on the right side of the Script
Manager have functions described in the following table. They
work with the script that is selected (highlighted) in the central
list box in the dialog.
|
Button:
|
Function:
|
|
[Run]
|
Executes the script.
|
|
[Open]
|
Opens the script into a Script Editor.
|
|
[New]
|
Creates a new, empty script in a Script
Editor.
|
|
[Rename]
|
Renames the selected script. This changes the name
of the file where the script is saved.
|
|
[Delete]
|
Deletes the file containing the selected
script.
|
|
[Close]
|
Closes the Script Manager.
|
|
|
Related Topics
Working with Scripts
Script Editor
File Event Scripting
Mira's Special Folders
Mira Pro x64 User's Guide, Copyright Ⓒ 2023 Mirametrics, Inc. All
Rights Reserved.
| 
