Copyright: Microsystems, Software, Inc.


Index Menu
MagniPORT® for Windows  HELP INDEX	1 of 1

Getting Started

Installing MagniPORT for Windows

Overview of MagniPORT for Windows

DDE Support

MagniPORT Magnification Controls

Keyboard   	Mouse

Setup & Configuration Controls

Options

Help

About

MagniPORT Dialog Box

Demo & Registration Limitations


Overview of MAGic
Overview of MagniPORT for Windows 3.1

MagniPORT is a ($19) ShareWARE magnification product for use with any Windows 3.1 Video Adaptor presenting a dynamic dialog box containing a magnified image of the area surrounding the mouse cursor.  You may re-position and re-size this box.  It is extremely useful with all presentation applications and saves significant time over "built-in" magnifiers.  An option to dispay a cursor within the MagniPORT Dialog box gives you exact positioning during paint operations.  MagniPORT is available as a separate ($19) ShareWARE product or bundled in MSI's MAGic Magnification Software.  MAGic ($79) & MAGic Deluxe ($295) features the following:

2,  4,  6,  &  8 x  Magnifications for MAGic Deluxe

2 x  Magnification for Magic Regular

Screen Locator Display

MSI's Exclusive MagniPORT Dialog Box

Auto-Track of Cursor, Mouse, Objects, & Carats

Ability to Reverse Black-on-White to White-on-Black Images

Ability to Reverse the Cursor Color

Object Tracking On / Off Control

"Silky-Smooth" Panning in ALL Magnifications within Dialog Box boundaries.

Variable Panning Speeds ( 3 steps )

Very Responsive Screen Movement ( < 1% system overhead )

Very LOW Resource usage ( < 1% )

Very LOW Memory usage ( < 30 KBytes )

Hot-Keys for Changing Magnifications

User-Definable short-cut Keys to turn Magnification On / Off

Comprehensive On-Line Help


Installing MAGic
Installing MagniPORT for Windows

MagniPORT for Windows is very easy to install and load.  The installation is actually a two part process.  First MagniPORT is installed on your hard disk, then the user that wants access to MagniPORT for Windows installs the MPORT program into the desired Windows group.

To install MagniPORT on your hard disk, copy the MPORT.EXE program to your \WINDOWS directory then:

1	Under the Windows program manager, double click on the group which will contain MagniPORT for Windows.  If you continuously need MagniPORT for Windows, we recommend that you place it in the Startup group.  This will assure that the on-line notification and access will automatically be run each time Windows is loaded.

2	Click on File, New; Program Item and OK.

3	In the Description field type MagniPORT .

4	Input MPORT.EXE in the Command line field.

5	If you like, you may specify a short-cut key sequence that will turn MagniPORT On / Off.

In addition, any of the following options can be placed on the Command Line after WINMAGNIPORT.EXE:

/M Magnification

The default is 2.  This determines the magnification factor.  Valid values are 2, 3, 4, 5, 6, 7, 8, 9, 0.

/U Start Un-magnified

The default is magnified.  This allows you to specify a magnification with the /M switch, but initially after loading WINMAGNIPORT, the screen will be un-magnified.

/SC Show Cursor

The default is Off.  This causes the dispay of a Cross within the MagniPORT Dialog Box to allow exact positioning during paint operations.

6.	Click the OK button to save your selection.  You should now double-click the MagniPORT icon to enable MagniPORT.  Please note that the configuration & use of this icon is contained in Demo & Registration Limitations section.

7.	The MPCLIENT.EXE porgram is supplied to test & demonstate the DDE Server Capabilities.


Demo
Demo & Registration Limitations

If MagniPORT for Windows is not Registered, MagniPORT will time out after 15 minutes of operation.  You must exit Windows and re-start to get a fresh demo.  You may call MSI at (800)828-2600 at any time with a credit card (M/C, VISA, or AMEX) and charge the $19 registration fee.  We will give you an unlock code over the telephone.

Single clicking this icon will present you with the Options Menu.  Double clicking this icon will Enable / Disable Magnification.  This icon will remain "On-Top" of any and all applications to provide you with instant access to its functionality.


Option Control

Single Clicking the MagniPORT icon will cause MagniPORT

to present you with a list of Options.  Double-clicking will turn magnification On / Off.


MagniPort
MagniPORT Command

Selecting this MSI exclusive option will open a Dialog Box which shows the area of the screen that surrounds the mouse cursor.  The MagniPORT Dialog Box can be moved and sized just as your other Windows dialog boxes.  The area depicted within the MagniPORT box can be magnified at 2-10x using the standard MagniPORT hot-keys.  The content of the MagniPORT box is continuously updated as you move you mouse around the display.  The Location & Size of the MagniPORT box are stored in your WIN.INI file automatically upon exiting and restored each time this option is selected.


About MAGic Command
About MagniPORT Command

Display the Registration / Revision / Sales Information

regarding your MagniPORT installation.


Help Commands

Help - Index

Accesses the Help System for MagniPORT at the Main Index.

Help - Search

Accesses the Help System for MagniPORT at the Keyword Search.


MAGic Information
MagniPORT for Windows Information

MagniPORT for Windows  is copyright 1993 by:

Pricing:

1-4	$19

5-9	$15

10-49	$12

50+	$10

Microsystems Software, Inc.

600 Worcester Road

Framingham, MA 01701

(508) 879-9000	Support

(508) 626-8511	Fax

(508) 875-8009	BBS for upgrades

(800) 828-2600	Toll-Free (Sales & Unlock Only)

Author:    Borko D. Stosic


Mouse Support

Generally, all functions normally associated with the Mouse under Windows are supported.  Panning will start at the location of the mouse pointer head.  The magnified area will automatically track the mouse.  After you disable magnification, upon re-enabling, the magnified area will center around the mouse pointer.


Keyboard Support

Holding the < ALT > key an hitting various other keys will control MagniPORT under Windows.

Note that the Number Keys defined below are the keys on the top row of the keyboard, NOT those on the numeric keypad.

< Alt - 1 >	Set magnification to 1x  (Off)

< Alt - 2 >	Set magnification to 2x

< Alt - 3 >	Set magnification to 3x

< Alt - 4 >	Set magnification to 4x

< Alt - 5 >	Set magnification to 5x

< Alt - 6 >	Set magnification to 6x

< Alt - 7 >	Set magnification to 7x

< Alt - 8 >	Set magnification to 8x

< Alt - 9 >	Set magnification to 9x

< Alt - 0 >	Set magnification to 10x

< Alt - Insert >	Cursor On / Off

Note: You may also specify a short-cut key sequence that will turn MagniPORT On / Off in the Properties of the MagniPORT Icon under you Windows Program Manager.


DDE Support
DDE Support in MagniPORT

MPORT is also a DDE (Dynamic Data Exchange) server for Windows 3.1 as follows:

Registration:	 DDEML

          Topic: 	"MagniPORT"

       Service: 	"Magnified State"

The callback functions respond to DDEML (DDE Management Library) transactions XTYP_EXECUTE by processing the received command string and returning the DDE_FACK transaction flag to the DDEML.

The Command string is processed by searching for particular string expressions (case insensitive, optionally followed by string representation of numbers) and then performing corresponding the operation.

The following commands are recognized:

STRING	NUMBER	ACTION

/M	1-10	choose magnification

/XC	0-639	choose x coordinate for magnification

/YC	0-479	choose y coordinate for magnification

/XMP	0-639	choose x coordinate of Mport Dialog box.

/YMP	0-479	choose y coordinate of Mport Dialog box

/XEXT	0-639	choose x width of Mport Dialog box

/YEXT	0-479	choose y height of Mport Dialog box.

/SC	0-1	Cursor Off or On

/MSG	display message box

Numbers received for /XC or /YC coordinates are truncated to the nearest permitted values. If only one coordinate is received, the other is by default chosen at half of the screen size.

The MPCLIENT.EXE program demonstrates a client DDE application.   On startup, if no server responds to XTYP_CONNECT transaction, the application tries to load MPORT.EXE and then again tries to establish connection. If it doesn't succeed, it displays a message box and exits.

Once the connection is established, MPCLIENT.EXE displays a dialog box with options for different services supplied by MPORT.EXE. Messages are sent by pressing the SEND MESSAGE button in the dialog box.

If the connection is broken (received transaction XTYP_UNREGISTER), MPCLIENT.EXE displays a message box. If the connection is re-established (transaction XTYP_REGISTER received), and an appropriate message box is displayed.  A key for loading MPORT.EXE server is also supplied in the dialog box (pressing it has no effect if the server is already loaded and connection established).