NAME
HGR macro
SYNOPSIS
Revive the past! Use Apple II High Resolution Graphics (HGR) as assets on
your WebGUI system. No conversion needed!
DESCRIPTION
The HGR macro displays Apple II High Resolution Graphics image files stored
on ProDOS formatted disk images as PNG files on your WebGUI system.
No image conversion is required. No disk images need to be unpacked or
otherwise harmed. Safe for children under 3.
Bring your classic art collection into the future!
EXAMPLE
Toss the following macro wherever you feel the need to awe your visitors:
^HGR(/url/to/diskImage,FILENAME);
The first parameter is the URL you assigned to the ProDOS formatted disk
image in your asset manager.
The second parameter is the Apple II ProDOS filename of the image file to
display. HGR files are 8192 bytes in length. It does not matter if the
image was saved on page 1 ($2000) or 2 ($4000). HGR is smart like that.
The sample disk image has a fantastic out-the-window view of Megs Field in
Chicago from the cockpit of a Piper single-engine aircraft. To gaze upon
it in amazement, use the following:
^HGR(/url/of/Graphics.po,FLIGHT);
You can almost feel the wind in your hair, can't you? Just check out the
majestic Sear's Tower off to the left of the runway!
INSTALLATION
- Place HGR.pm in /data/WebGUI/lib/WebGUI/Macro.
- Add HGR to your site's configuration file.
- Give it the old /data/wre/sbin/rc.webgui restart
- Put all your ProDOS por^H^Hhoto disks in the asset manager.
- Go wild!
CREDITS
First, I'd like to thank my brain. It's responsible for most of this macro.
A lot of very important Apple II technical information is still kept there.
You can find more of my brain at http://www.jaegertech.com and at
http://www.duensing.com
Christopher J. Madsen for the LibA2 module. I really didn't want to have
to write the disk reading code myself! http://www.cjmweb.net/perl/
David M. Cotter for assistance with my broken color decoding routine. His
Apple II image tool, a2pix, can be found on his web site at
http://www.lazilong.com/apple_II/a2pix/
Bob Bishop for detailed information on how the Apple II maps RAM to the
display. Not all of this information stayed in my head over the last 25
years. http://rich12345.tripod.com/aiivideo/softalk.html
I can't forget all the people I pestered in #WebGUI on FreeNode while trying
to learn the API calls I needed to make this work. Thanks again!