HyperMover 1.1

Copyright 1994 Apple Computer, Inc.

Name:              HyperMover
Version:           1.1
Date Released:     February 10, 1992
Description:       See below

The software posted here is available in two formats:

1.)  A Macintosh self-extracting archive (.sea).  To use, download, and double-click the
downloaded file (this decompresses it).

2.)  An Apple IIGS ShrinkIt archive in Binary II format.  To use, download and use ShrinkIt
to decompress and create a disk.

Shrinkit can be found in the Apple II Supplemental folder posted here.


HyperMover	

HyperMover is a powerful tool facilitating the conversion of HyperCard stacks between
Macintosh 'HyperCard' and Apple IIGS 'HyperCard IIGS.'  HyperMover should greatly ease the
effort and accelerate the time needed to convert stacks between the Mac and the IIGS.  


Important!!!

Please note that the functionality of HyperMover does not imply authorization to use
HyperMover to dismantle commercial stacks from one hardware platform and turn them into
salable stacks for the other platform.  Copyrights must be respected.  


HyperMover Background

Because of the differences between the Macintosh and the Apple IIGS,  stacks created on
one computer will not run directly on the other.  HyperMover consists of two stacks.  One
HyperMover stack runs on HyperCard 1.2.5 or later.  This stack will be referred to as
"Macintosh HyperMover."  The other stack runs on HyperCard IIGS and will be referred to as
"HyperMover IIGS."  Both HyperMover stacks are capable of dismantling HyperCard stacks,
creating a folder containing information which the other HyperMover stack can use to
rebuild an equivalent stack for use on the other computer.

Using HyperMover typically consists of these steps:

(1)  Decide on a stack to convert.

(2)  Launch HyperCard and open the HyperMover stack.

(3)  Select options for picture, icon, sound and cursor conversions.

(4)  Begin the dismantling process.

(5)  Transfer the intermediate folder HyperMover created to the other computer via Apple
File Exchange or an AppleTalk network.

(6)  Launch HyperCard on the destination computer and open the HyperMover stack.

(7)  Rebuild the stack.


Macintosh Hardware Requirements

• CPU Requirements
HyperMover will work with all Macintosh models capable of running HyperCard.

• Memory requirements
HyperMover may require up to two megabytes of RAM to dismantle or rebuild stacks.  If you
are running HyperCard under MultiFinder, allocate at least1600K to HyperCard.  Large stacks
with many objects or sounds may require more memory.  

• Disk Space Requirements
 HyperMover creates the folder containing the parts of the dismantled stack in the same
 directory as the original stack.  This means that you must have approximately one-and-a-half
 times the size of the original stack free on your disk to successfully dismantle it.


Macintosh Software Requirements

• HyperCard Requirements
HyperMover Macintosh will work with HyperCard 1.2.5 or with HyperCard 2.0v2 or later.

• System Software Requirements
HyperMover will work with all system software supported by these HyperCard versions.


IIGS Hardware Requirements

• CPU Requirements
HyperMover IIGS works with all IIGS models.

• Memory requirements
HyperMover IIGS may be able to dismantle small stacks with 1.5 megabytes of memory.
However, two megabytes of memory are highly recommended. 

• Disk Space Requirements
HyperMover IIGS creates the folder containing the parts of the dismantled stack in the same
directory as the original stack.  You must have approximately one-and-a-half times the size
of the original stack free on your disk to successfully dismantle it.

In general, Macintosh stacks rebuilt on the IIGS will be slightly larger than the original
stack, because HyperCard IIGS supports color paint which takes up more disk space.


IIGS Software Requirements

• HyperCard IIGS Requirements
HyperMover IIGS will work with HyperCard IIGS 1.0 or later. 

• System Software Requirements
HyperMover IIGS works with all system software supported by HyperCard IIGS. (5.0.4. or
later)


Getting Started with HyperMover

HyperMover contains options which can help you convert stacks.  These options control:

a) how graphics and objects are scaled and

b) whether graphics and sounds will be converted.


HyperMover Macintosh has additional options for the conversion of cursors and icons.  


Dismantling Your First Stack

For your first try at converting a stack, choose a relatively simple stack.  

Before starting, make sure you have approximately one-and-a-half times the size of the
stack to be converted free on the drive that contains that stack.  


• Launch HyperCard and Open HyperMover.

• Click Dismantle Stack
You will go to the Dismantle Options card.  Leave the options in their default positions
for now and click the Dismantle a Stack button.  Choose the stack to be dismantled from the
resulting dialog box.  HyperMover will now go to that stack and begin the dismantling
process.  You will see HyperMover visit each card of the stack in succession, then return
to the HyperMover options card.  A dialog box appears and a sound plays, announcing that
the stack has been dismantled.  

NOTE >>	If HyperMover does not return to the options card or an error dialog box is
displayed, see the trouble-shooting section of this document.  Dismantling a stack can take
quite a while on large stacks, expect approximately one minute per card depending on the
complexity of the card and the speed of your computer.

• Transfer the Files
After dismantling the stack, you must transfer the files HyperMover created.

This can be done either with Apple File Exchange or an AppleTalk network.  If you use a
network, both the Macintosh and the IIGS must be physically connected and logged on to a
common server.  Simply drag the folder that HyperMover created on one computer to a
location on the server that you can also access from the other computer.

If you use Apple File Exchange, you must format as many disks as needed to contain the
converted files.  After formatting the necessary number of disks, use Apple File Exchange
to transfer the folder containing the converted files.  The files can be 
transferred in two or more groups if the contents of the folder total more than 800K and
are combined into one folder.  (When converting from Macintosh to IIGS, the text file with
the same name as the dismantled stack may not be a legal ProDOS 
filename.  If this is the case, simply rename the file to a legal filename.  Do not rename
any of the other files in the folder.)

• Launch HyperCard on the second computer and open HyperMover.
(When using HyperMover IIGS, make sure you have slightly more space free on your hard disk
than the size of the original Macintosh stack before launching HyperCard IIGS.)

• Click Rebuild Stack.
You will go to the Rebuild Options card.  Leave the options in their default positions for
now and click the Rebuild a Stack button.

Select the text file within the folder HyperMover created with the name of the dismantled
stack with ".t" appended.

HyperMover will next display a dialog box prompting you for a file name and location for
the rebuilt stack.  Choose a location that has enough space for the rebuilt stack.  The
default file name should be renamed if it is not a valid file name for the file system you
are storing the rebuilt stack on.

HyperMover will now create the new stack and begin rebuilding buttons, fields, pictures,
scripts, cursors, icons, text and sounds in the new stack.  This process can take some
time, usually several minutes per card depending on the complexity of the original stack.

After rebuilding the stack, HyperMover will return to the options card, display a dialog
box, and play a sound indicating the stack was rebuilt successfully.  See the
troubleshooting section of this document for help if this didn't happen for your stack.


Differences between Converted Stacks	

Because the Apple IIGS and Macintosh differ significantly in hardware, some aspects of a
converted stack will not be identical to the original.  HyperMover will pre-scan the
original stack and warn the user of features that will not be converted, such as XCMDs and
XFCNs.


• Graphics
The most noticeable difference between the original and the rebuilt stack will be in the
graphics.  The IIGS and the Macintosh have different screen sizes (320x200, 4-bits per
pixel and 512x342, 1-bit per pixel).  Therefore, graphics moved between the two machines
need to be modified to fit and display properly.  This is handled by HyperMover in several
ways.  

1) Macintosh graphics to the IIGS.  HyperMover contains two algorithms for scaling graphics
from Macintosh to IIGS screen resolution.  The first routine is best used for line-art
types of graphics.  The second is preferable for heavily dithered graphics such as those
created with HyperScan.

2) IIGS graphics to the Macintosh.  Moving graphics this direction involves reducing the
number of colors available per pixel from sixteen (IIGS) to black-and-white (Macintosh).
At the same time, however, the picture must be scaled up from 320x200 to 512x342.  This
results in more pixels being available to simulate the colors lost during dithering.

• Screen Coordinates
Just as pictures must be scaled to fit the destination card size, buttons and fields must
also be scaled so that they appear in the correct locations on the destination card.
However, buttons and fields are objects and they may be scaled with no distortion.

• Scripts
Scripts converted from one machine to another will require modification to function
properly if they rely on specific screen coordinates.  Because of the differing screen
sizes, these scripts will need to be modified by the user.

Scripts that rely on features specific to one machine, such as the color properties of
HyperCard IIGS or specific commands in HyperCard 2.0, will also need to be modified by the
user to work correctly.

• Animation Sequences
Animation sequences that use system icons and refer to them by ID will need to be modified
after the stack is converted.


• Machine Specific Properties

Properties specific to HyperCard IIGS, such as button families and sharedText on the IIGS
will not be preserved in stacks converted to HyperCard 1.2.5.  Conversion of HyperCard IIGS
to HyperCard 2.0 with retain those properties that are common to 
HyperCard 2.0 and HyperCard IIGS.

Similarly varying card sizes in HyperCard 2.0 will not be preserved in stacks converted to
HyperCard IIGS.	


HyperMover Features	

HyperMover contains several features designed to make the rebuilt stack as useful and as
close to the original stack as possible.  Because HyperMover is a stack, there are a few
limitations as to what it can accomplish.


What HyperMover Can Do:

• Create scaled representations of pictures.

• Convert Macintosh sounds to IIGS sounds and vice-versa.

• Transfer all HyperCard objects including backgrounds, cards, buttons, and fields and
their attributes.

• Convert and scale Macintosh icons and cursors to IIGS icons and cursors.
	

What HyperMover Cannot Do:

• Convert XCMD/XFCNs.

• Fix scripts that depend on specific screen coordinates to function.

• Alter scripts that rely on features specific to one machine.

• Maintain the ordering of buttons in relation to fields.
_________________________________


Troubleshooting HyperMover 

If problems occur during the dismantling of a stack, one of the following conditions may
exist:


• HyperCard ran out of memory.  
The single most likely problem encountered is the lack of RAM available to HyperCard.
Keeping the HyperMover stack in memory at the same time as the rebuilt/dismantled stack
requires more memory than normal usage of HyperCard.  Low memory conditions can make
HyperCard perform erratically.


• The disk is full.
Make sure you have enough room for the rebuilt stack or the temporary files HyperMover
creates when dismantling a stack.  Keep in mind that HyperCard IIGS stacks are generally
larger than their Macintosh counterparts because of color support.




Apple, the Apple Logo are registered trademarks of Apple Computer, Inc.


HyperCard, HyperCard IIGS, Macintosh, MultiFinder, and Apple IIGS are trademarks of Apple
Computer, Inc.