Saturday, May 17, 2025

The "HCGS Best Of" 32 MB Disk Image for Apple IIGS

HCGS Best Of Home stack

HyperCard was first released for the Macintosh in 1987 and through its final release v2.4.1 in 1998 the product provided an assortment of Apple developed stacks; some for personal productivity and others to assist in stack development. HyperCard IIGS was first released in 1990 and updated to v1.1 in 1992 and also included some Apple stacks, but not as many as were included with the Macintosh releases.

HyperCard 1.2.5, released in 1989 and the version of HyperCard that HyperCard IIGS is based upon, included the personal productivity stacks for managing addresses, phone contacts, To Do lists, and weekly and monthly event calendars. There was also a Phone stack to facilitate using the computer with a modem to make calls from an office environment. For stack developers, many resources were provided via the Art, Button, Card, and Stack "Ideas" stacks. There was also a "Plots" stack for creating simple pie, bar, and coin charts for use in presentations. At the time Apple was using HyperCard internally for product documentation, training, and presentations, and the "Plots" stack was intended to be an aid to Apple's own employees as well as customers. Another stack "Quotations" was included that could be used to keep track of favorite short quotations.


HyperCard v1.2.5 Home card

HyperCard IIGS which was released in 1990 and updated to v1.1 in 1992 included the personal productivity stacks: Addresses and Calendar, and development stacks: ScriptersTools, ArtIdeas, ButtonIdeas, IconEditor, and TuneBuilder. No graphing stack was provided, probably because Apple did not intend HCGS to be used for internal presentations at Apple. The IconEditor stack was provided because, unlike Macintosh HyperCard, HCGS did not include a built-in icon creation mechanism. In keeping with Apple's view of the IIGS as a computer primarily for children, a jigsaw puzzle stack was included and two educational stacks were included: Birds and StoryBoard. The What's New and StoryBoard stacks included with the v.1.1 release demonstrated the use of two floating palettes (HyperCard calls them "windows"), similar to those made available in Macintosh HyperCard v2, but Apple released little documentation explaining how to use those palettes in your own HCGS stacks and no utility for creating them.

HyperCard IIGS v1.1 Home stack Welcome card

HyperCard IIGS What's New stack

As Apple continued to develop HyperCard for the Macintosh they changed the stacks that were released with the product, reducing the number of personal productivity stacks included.  The stack "Stack Templates" was created which combined several of the formerly released stacks into one stack which could be used to generate the individual stacks if desired.

Stack Templates stack from HyperCard 2.4.1

The stacks that could be generated from the Stack Templates stack were not identical to the earlier stacks that had been provided, but were comparable in their features.

HyperCard 1.2.5 To Do stack


To Do template from Stack Templates

HyperCard 1.2.5 Address stack


Names & Addresses template from Stack Templates



HyperCard 1.2.5 Weekly Calendar stack


Appointments template from Stack Templates

The HyperCard 1.2.5 Phone stack was replaced by the Phone Dialer stack.

HyperCard 1.2.5 Phone stack


HyperCard 2.4.1 Phone Dialer stack

The Plots stack was replaced by the Graph Maker stack.

HyperCard 1.2.5 Plots stack

HyperCard 2.4.1 Graph Maker stack

Several additional stacks were provided to aid in stack development. The Power Tools stack included several utilities, including "Super Grouper", which was based on an earlier stack called Groupies, and a Resource Mover stack to facilitate moving sounds, externals, icons, and other resources between stacks.

Super Grouper from HyperCard's Power Tools stack


Resource Mover from HyperCard's Power Tools stack


A pair of stacks, Readymade Buttons and Readymade Fields, provided a number of pre-scripted buttons and fields that could be dropped into any stack.

HyperCard Readymade Buttons stack


HyperCard Readymade Fields stack


HCGS had only the Addresses and Calendar stacks but no equivalents to the Macintosh Stack Templates stack, Phone Dialer stack, Graph Maker stack, Power Tools stack, or ReadyMade Buttons and Fields stacks.

HCGS Addresses stack


HCGS Calendar stack

The HCGS Best Of image seeks to address these gaps. It presents a version of HyperCard IIGS that might have existed had Apple continued developing HCGS beyond 1992 and chosen to provide solutions to the HCGS community that were comparable to those provided to the Macintosh HyperCard community.

Many of the stacks included on the HCGS Best Of image have been released previously by Brendan Bellina on issues of Script-Central Special Edition from 2019-2024. The HCGS Best Of image also includes the unofficial HyperCard GS 1.2 update developed by Antoine Vignau that addresses a bug in HCGS Y2K date handling.

The image includes several stacks for adding additional functionality to HCGS - such as HyperText links and talking - and several stacks that provide additional documentation - HCGS Bug Tracker, HCGS Xtras (a documented collection of HCGS externals), HCGS Palettes (explains how to use the palettes introduced with HCGS 1.1), and Apple II Technical Notes. There are also HyperCard courses, resource handling stacks, icons, utility stacks, some useful fonts, games, the four HyperHack stacks released by Apple, applications such as HC.Word.2023, HyperTuneMaker, MyPics, and HyperMover v1.2 (a developer utility for migrating stacks between Mac and IIGS), and much more.


HCGS Stack.Templates stack


HCGS More.Templates stack


HCGS To Do template from Stack.Templates


HCGS Appointments template from Stack.Templates

HCGS Phone.Dialer stack


HCGS Graph.Maker.GS stack

HCGS Groupies 3.2 GS stack

IIGS Resource Mover (by Apple)

HCGS Readymade.Btns stack

HCGS Readymade.Flds stack

The 32 MB HCGS BestOf disk image can be downloaded from the Apple II section of the Silverwand Software site at https://sites.google.com/view/silverwandsoftware/apple-ii-forever

Instructions for running this within a web browser

It is possible to run IIGS applications like HyperCard IIGS within the IIGS emulator "Bernie ][ the Rescue 3.0" on classic MacOS 8 and 9. It is possible to run classic MacOS 8 and 9 within a web browser from the site infinitemac.org. Note that I am not affiliated in any way with infinitemac.org or the developers of Bernie and it is possible that in the future these instructions may not work perfectly.

What you will need:

From the Apple II section of the Silverwand Software site download without unzipping and move to your desktop:

Customized Bernie ][ The Rescue 3 image with HCGSBest Of


If your web browser is configured to automatically unzip downloads and moves the zip file Bernie ][ The Rescue 3.0.zip to your trash you will need to recover the zip file from your trash, because the zip file is what the MacOS emulator at infinitemac.org requires.

Initiating a MacOS Virtual Machine (VM)

1. Using Chrome or another modern web browser go to infinitemac.org
2. Scroll down to the Mac OS 8.5 emulator and click the Run button to create the Mac Virtual Machine (VM)
3. Drag the downloaded file "Bernie ][ The Rescue 3.0.zip" from your desktop onto the VM desktop. It should very quickly copy the file to the VM Downloads folder. During this process you will get a few errors stating that "This disk is unreadable by this Computer" with the options to Eject or Initialize. Choose the Eject option each time.
4. Open the ":The OutsideWorld:Downloads" folder and drag the "Bernie ][ The Rescue 3.0" folder onto the "Saved HD" desktop icon (position the mouse pointer over the icon's ring, not the empty center of the ring). This will create persistent copies of the files that are stored in your web browser, allowing you to update them as your wish without altering the original downloaded image and they will be retained across web browser sessions.

Initiating Bernie ][ The Rescue within the VM

Open the "Saved HD" volume displayed on the VM desktop.
Double-click the "Bernie ][ The Rescue 3.0" folder within it to open it.
Double-click the "Launch HCGSBestOf" icon near the bottom of the window. This is an executable script that will first copy the Bernie preferences file from the "HCGSBestOf Prefs" folder to the "Macintosh HD: System Folder: Preferences" folder and then launch the Bernie ][ The Rescue 3.0 application. (Using this script prevents you from having to setup the Bernie preferences each time you launch the VM. If however you decide to change the Bernie preferences then you should copy the Bernie Prefs file from the "Macintosh HD: System Folder: Preferences" folder to the "Saved HD: Bernie ][ The Rescue 3.0: HCGSBest Of Prefs" folder so that your new preferences settings are retained.)

The first time you do this you may get an error from Bernie that the startup disk cannot be found.  In that case do the following:
1. Open Bernie's settings by using the "Setup > Preferences..." menu option.
2. Click on the "Storage" icon and then click the button "Select Startup Disk or Folder..."
3. In the displayed file dialog navigate to ":Saved HD: Bernie ][ The Rescue 3.0"
4. Highlight "DiskImages" by clicking on it once, and then click the "Choose" button.
5. Close Bernie Preferences by clicking the close box in the upper left corner of the window.
6. Quit Bernie by using the "File > Quit" menu option. If prompted choose "Shut Down".
7. Open the folder "Macintosh HD: System Folder: Preferences"
8. Drag the file "Bernie Prefs" from the Preferences folder into the folder ":Saved HD: Bernie ][ The Rescue 3.0: HCGSBestOf Prefs". If prompted, choose to replace the existing file.
9. Double-click the "Launch HCGSBestOf" icon to launch Bernie.

During IIGS booting an error message may be displayed that Battery RAM settings have changed. If this occurs just press the return key and the boot process should continue.

When the boot of the IIGS has completed you should be in the IIGS Finder desktop.

IIGS System 6 Finder desktop


There are a number of applications preinstalled on the GSHD1 and GSHD2 images. To quickly launch applications the colorful TransProg III menu in the menubar can be used. Click on its icon and use the customizable hierarchical menu to select an application.  HyperCard IIGS is in the Hypermedia category along with HyperStudio.

Accessing the TransProg III menu


Once the Home stack is displayed you can click on the buttons at the bottom to navigate to the different cards in the stack and launch the stacks that you want to look at.  Since you are running an emulator within a VM within a web browser you should not expect great performance, so some stacks (like Fangborne for example) will be painfully slow. If you really want to use such stacks then you should download a IIGS emulator that will work on your platform rather than running a VM in a web browser. You can also experiment with Bernie's preferences to set the IIGS emulator speed.

HCGS Best Of Home stack Welcome card

Click on "My Name ..." to customize HyperCard with your name.
Click the balloon button above "Home Stack" to read about some of the enhancements made to the Home stack.

WARNING: While the infinitemac.org site claims that a backup of the Saved HD volume can be made by dragging contents to the ":The Outside World:Uploads" folder, I have found this to not work reliably and the created Zip file is often missing content. I do not recommend counting on the Saved HD volume for anything you truly care about, like stack development. If you care about your content then you should use a real emulator.

When you are finished:
- Quit HyperCard IIGS
- From the IIGS Special menu select Shut Down and choose Shut Down in the dialog.
- In the VM menu for Bernie select File > Quit and then choose Shut Down in the dialog.
- Shut down the VM



Saturday, November 30, 2024

Script-Central Special Edition v9n4, Winter 2024

Silverwand Software has released the ninth and final issue of Script-Central Special Edition. This issue includes many new stacks, many updated stacks, fonts, many utilities and tools, and even Macintosh versions of several stacks.

SCSE v9n4 floor plan
Highlights of this issue include:

HyperMover GS v1.2 - a new version of HyperMover by Brendan Bellina that includes the improvements from HyperMover v1.1u and additional support for the properties sharedHilite, sharedText, dontSearch, and button families. The Macintosh version of HyperMover v1.2 is also included in the Extras folder.

Apple HCGS Course - the Apple HCGS course stack provided to Apple dealers for HCGS training. This is a converted version of the Macintosh stack.

Background Art GS - a converted and enhanced version of the Macintosh HyperCard 2.3 Background Art stack.

One Arm Bandit GS - a 3-reel slot machine by Brendan Bellina. Also available for Macintosh HyperCard.

Adventure Construction Kit v2024 - Build your own text adventure using this stack by Brendan Bellina. Also available for Macintosh HyperCard.

ESC from LALALAND  - a comic text adventure by Brendan Bellina built using the Adventure Construction Kit v2024. Also available for Macintosh HyperCard.

MultiFont - a MacUser font based on Times.14 that combines plain text and italic text in a single font; created originally for Macintosh, converted for the IIGS by Brendan Bellina and expanded to include 10, 12, and 14 point sizes.

Brendan Bellina modified versions of the Bayview and Smallville fonts suitable for use with HCGS stacks and as substitute System Finder fonts for use with the SysFont NDA.

IIGS Finder using BB modified Smallville 8 font with SysFont NDA

There are many more stacks, tips and tricks for converting stacks and adding CASE statements to HyperTalk, and much more.

Make HyperCard IIGS everything it can be wth Script-Central and Script-Central Special Edition. Download all issues of Script-Central Special Edition from the Apple II section of:

sites.google.com/view/silverwandsoftware

Monday, July 29, 2024

Script-Central Special Edition v9n3, Fall 2024

 Script-Central Special Edition v9n3, Fall 2024


The eighth issue of Script-Central Special Edition is now available for free download in the Apple II section of the Silverwand Software site at sites.google.com/view/silverwandsoftware. The 32 MB disk image includes several updates as well as several new HCGS stacks. For convenience the HCGS 1.1 and the 1.2 update are included on the disk image so the HyperCard IIGS application can be installed onto your own large storage device (note that while Script-Central stacks can be run from the disk image, the HCGS application must be installed onto your own storage).


The author has researched decades of materials related to HyperCard and HyperCard IIGS in order to complete this issue. One gem included is a HCGS conversion of a Find Command stack originally developed for Macintosh HyperCard for the AOL HyperCard Scripting Conference in 1995.



This issue also includes an important update to the MyPics graphics manager by Brendan Bellina, adding musical slideshow capability to any PicList. There are also updates to the Stack.Templates stack and the ReadyMade.Flds stacks, both of which are Apple stacks that were converted from Macintosh HyperCard by Brendan Bellina and released on previous issues of SC Special Edition.

All issues of Script-Central Special Edition can be downloaded for free from the Silverwand Software site.

Apple II Infinitum!

Saturday, June 1, 2024

Script-Central Special Edition v9n2, Summer 2024

Script-Central Special Edition v9n2, Summer 2024 was released June 1, 2024.  This 32 MB Disk Image for the Apple IIGS contains several new HyperCard IIGS stacks by author Brendan Bellina.

Script-Central SE v9n2 Floorplan

The issue includes all of the regular departments: Q+A, Tips & Trix, Scripter's Workshop and the Lounge.  The Lounge has been updated to include a musical slideshow inspired by the upcoming Olympic Games in Paris, France.

Updated versions of the HCGS.BugTracker stack and the HCGS.Xtras stack are included. HCGS.Xtras is the single source for all IIGS XCMDs and XFCNs.

Some of the feature stacks by Brendan Bellina include:

Light Board - a fun stack to create Lite Brite style artwork. Create pictures from templates or free-form and create a slideshow of your favorites.

Light Board - Apple template

Visisort.GS - an educational stack that demonstrates sort algorithms visually.

Visisort.GS

The Doctor Is In - an educational and interactive stack that provides historical information on one of the first applications of artificial intelligence - ELIZA - and provides a HyperTalk version of the BASIC program by Dr. Jeffrey Shrager. There is also a Macintosh HyperTalk version of this stack also by Brendan Bellina.

The Doctor Is In - Session Screen

Notable - a unique ideation stack inspired by the Medley NoteCards application (a precursor to HyperCard) that uses hypertext links to link notes to each other, documents, stacks, and applications. There is also a Macintosh HyperCard version of this stack also by Brendan Bellina.


Notable

All Script-Central Special Edition issues can be downloaded at no cost from https://sites.google.com/view/silverwandsoftware/apple-ii-forever

Wednesday, February 21, 2024

Script-Central Special Edition v9n1, Feb/March 2024

 Script-Central Special Edition v9n1 was released February 21, 2024.

The contents of the issue are:

Regular Departments

In this issue the Tips & Trix rabbits explain how to make best use of the very important idle handler and also explain how to use Poly-buttons in HCGS. A stack is included so that you can experiment with your own poly-buttons as well.

The Q+A classroom has answers to all the questions you never asked.

The Lounge has an updated Script-Central Database Complete stack. This is HangTime's stack updated from Issue #6 that now includes all information on all of the features, tips, tricks, sounds, scripts, XCMDs, etc. released in all 22 issues of Script-Central as well as all issues of Script-Central Special Edition. Use this to quickly find what issue of Script-Central or Script-Central Special Edition has the resource you are looking for.

Stop by the bathroom to read the latest news and rumors collected from various online sources.

The Scripter's Workshop includes the HyperSonic sound deck, useful functions in Scripter's Corner, and more. This issue includes an updated version of the HCGS.BugTracker stack and a new command called findFont which can be used to determine where a font is being used in a stack by either font name or ID.(One of this issue's feature stacks: HCGSBtnFldProbe can also be used to find a font by name.)


Features

This issue's feature stacks included some unique to HCGS and some converted from or inspired by Macintosh HyperCard stacks.

The Apple Guidelines stack is a Macintosh conversion by Brendan Bellina. The source stack was developed by Apple for internal use to provide guidance for using HyperCard for internal presentations.The converted stack has been enhanced to include HCGS related content.

The Missing Icons stack by Brendan Bellina provides a collection of standard Mac HyperCard icons that are not included in the HCGS application. Many of these icons can be found in other Apple HCGS stacks. HyperMover does its best to replace standard Mac icons with standard HCGS icons, but still fails on many. This icon stack allows searching by Mac icon ID and name which can be useful when converting Mac stacks to HCGS using HyperMover.

The SC Clip Art stack by Brendan Bellina combines all of the clip art that was released on Script-Central issues #1-22 into a single stack.

HC.Word.2023 is a multi-document word processor stack by Brendan Bellina based on the HC.Word stack.

Stormy Night is one of the HyperHack stacks released by Apple. This version has been slightly enhanced by Brendan Bellina.  The original version can be found in this issue's Extras folder along with all of the other HyperHack stacks that were released.

MyPics is an image management stack developed by Brendan Bellina that allows the display of image thumbnails, custom tagging, searching, and list generation so that regardless of where your AFP and SHR images are located or how poorly they are named you can easily categorize and find the images you are searching for.  This stack is processing intensive and works best on a highly accelerated IIGS or IIGS emulator.

The HCGS Button Field Probe stack is a tool developed by Brendan Bellina that can be used to identify buttons and fields in a stack by their properties. A Macintosh version of this stack is available in the Extras folder to aid in the conversion of Macintosh stacks to HCGS since there as some object properties (like family) that HyperMover does not handle.

FreeSource v4.01 is a resource management stack with features similar to HyperUtility.

XCMDMaker 1.0 is a stack that aids to the development of HCGS XCMDs and XFCNs. This is a shareware stack developed by David Empson in 1991.


GraphMaker GS is an enhanced conversion by Brendan Bellina of Apple's GraphMaker stack. Apple's stack facilitates creating graphs that could be copied and pasted into presentations.GraphMaker GS adds color support, the ability to import and export table data, and the ability to create full screen graphs and export them as images.

HCGS.Xtras is a stack by Brendan Bellina that collects over 100 HCGS XCMDs and XFCNs from a variety of sources including Script-Central, Hyper-Quarterly, Apple released stacks, 3rd party HCGS stacks, and HCGS extensions that were released online on the AOL, Delphi, and GEnie services. All extensions are described and many include example code and demonstrations.


Also included with Script-Central Special Edition

DIYScriptCentrl - This Do It Yourself Script-Central text file documents everything I learned while dissecting Script-Central #22 and creating the Script-Central Special Editions.

The Extras folder contains utilities and tools that I have found useful in HCGS development and many are mentioned in Script-Central SE issues.

The Fonts folder contains all of the fonts used by stacks from this issue (installation of these fonts is not required for the stacks unless otherwise mentioned thanks to the use of the FontZ XCmd by Richard Bennett).

The Sounds folder includes the sounds from the Macintosh OS Platinum theme converted to rSounds for use with the System 6 Sound Control Panel.  These sounds are also included in this issue's HyperSonic stack so they can be used within HyperCard stacks as well.

The Applications subfolder includes a program shipped with the ByteWorks Talking Tools that can be used to read text out loud.

Stacks folders contains Mac HyperCard versions of the HC Button Field Probe tool and the original version of the Apple Guidelines stack as well as all of the HyperHack stacks that were released by Apple.

The issue can be downloaded for free from the Silverwand Software site at:

https://sites.google.com/view/silverwandsoftware/apple-ii-forever