Visaj for the Macintosh
Welcome to the Macintosh distribution of Visaj. Though packaged specifially for the Macintosh, Visaj uses the same visaj.jar as all other platforms. There is some Macintosh special behavior:

Ä Option-drag to set up event bindings

On most platforms you hold the Control key down whilst dragging between components
to set up an event binding. On the Macintosh the Control key is used to bring up Contextual
Menus, so to bring up the event binding editor hold down the Option key as you drag.

Ä .vcl, .vpj and .vrb files can be double clicked to open the respective editors

Visaj has three top level editors: the class editor, the project editor and the resource
bundle editor. Each of these has its own file type, and double clicking on the appropriate
save file will bring up the correct editor for that file.

Ä .java generated files can be double clicked to invoke Metrowerks' CodeWarrior IDE


Recommended environment
Ä
Macintosh PowerPC with at least 64Mb of memory.
Ä System 8.5.1 or later
Ä MRJ 2.1.2 (Apple's JDK 1.1.7) or later

Visaj will run on older Macintosh's, so long as there is good support for Java. The recommended environment, however, has been found to be preferable for most Java applications.


What is installed where
Visaj is provided as a self-extracting archive. Double-clicking on this will install Visaj in a folder 'Visaj 2_4_4'. All files are installed in this folder. No extensions or other files are installed elsewhere on the system. To remove Visaj from your system, simply drag the folder to the trash can.

Swing
Visaj is compatible with both Swing 1.0.3 and Swing 1.1.

For more information or a copy of the Swing software, see the Sun Microsystems web site at http://java.sun.com/. To run Visaj with the Swing components, place the "swingall.jar" file in the MRJClasses folder, in the MRJ Libraries folder in the Extensions folder (inside the System Folder). Double-clicking the Visaj-Swing icon will then launch Visaj with the Swing components pre-loaded onto the palette.


Documentation
The documentation for the User's Guide, Installation, Release Notes etc. is available both from within Visaj, and as browsable HTML files. Simply point your favorite browser at Documentation.html.


Image Editor
There is an image editor available with Visaj that can read and write JPEG and other image files. This requires Swing to be present on your system. See above.


Authentication

There are two versions of Visaj.

Visaj Personal Edition is a, fully functional, version of Visaj that allows you to generate code only for a restricted number of components (up to 50). In addition it is only for personal use or for evaluation purposes, and any generated code must not be used for commercial purposes. It does not require authentication.

Visaj Professional is the full product with no restrictions on the size of design or on the use of the generated code. This version requires authentication.


Visaj professional will run in demo mode (code generation disabled) when initially run. When evaluationg the software you will be given a key which will allow the software to be run using web authentication. For this, you will need to establish a web connection before launching Visaj. Once running, the web connection does not have to be maintained.

When you purchase the software, or are unable to evaluate the software using web authentication, you will be issued a personal certificate to validate the product. See separate file for information on setting up your personal certificate.

Customization
There are several properties that can be used to tailor the look or behavior of Visaj. These can be set, along with the CLASSPATH using JBindery.

Resources
Apple's main Java site http://www.apple.com/java will contain the latest information on MRJ, Java and the Software Developer's Kit (SDK).

IST's web site http://www.ist-inc.com/visaj/ will contain the latest information on releases, and links to support pages for Visaj.

Known Issues

Ä
Apple's MRJ 2.1 does not always refresh a window.

In Visaj you may not see the dynamic display update immediately after setting properties of a component. To see the changes, simply resize the dynamic display's window.

Ä
The Properties window and Event Bindings window do not pick up the vj.windowFont property.

This is a Mac specific problem. On UNIX and Windows, these dialogs pick up the appropriate font specified for vj.windowFont.

Ä
The use of transparency may cause problems in the Image Editor.

The image is correct, but the displayed image gets corrupted. This problem will be fixed in a future version.

Imperial Software Technology Imperial Software Technology
120 Hawthorne Avenue, Suite 101 252 Kings Road
Palo Alto, CA 94301 Reading RG1 4HP
USA UK

(650) 688-0200 +44 (118) 958-7055
(650) 688-1054 [Fax] +44 (118) 958-9005 [Fax]

www.ist-inc.com
support@ist-inc.com
sales@ist-inc.com




© 2000 Pacific Imperial Inc. All rights reserved.
Visaj and the Visaj logo are trademarks of Pacific Imperial Inc.
X-Designer is a trademark and the X-Designer logo is a registered trademark of Imperial Software Technology Limited.
Apple, the Apple logo, Mac, and Macintosh, are trademarks of Apple Computer, Inc., registered in the U.S. and other countries.
Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries.
Other product and company names mentioned herein may be trademarks of their respective companies.

Revised 10 August 2000