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.